diff options
Diffstat (limited to 'python-alps-unified-ts.spec')
| -rw-r--r-- | python-alps-unified-ts.spec | 410 |
1 files changed, 410 insertions, 0 deletions
diff --git a/python-alps-unified-ts.spec b/python-alps-unified-ts.spec new file mode 100644 index 0000000..72b7891 --- /dev/null +++ b/python-alps-unified-ts.spec @@ -0,0 +1,410 @@ +%global _empty_manifest_terminate_build 0 +Name: python-alps-unified-ts +Version: 0.0.40 +Release: 1 +Summary: alps-unified-ts +License: Apache-2.0 +URL: https://github.com/mmuller88/alps-unified-ts.git +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/6f/3d/ace93b459db2e4eb5216b7f97c1f79bc2cc821b1db3cbf13ee5c9d3bb7b4/alps-unified-ts-0.0.40.tar.gz +BuildArch: noarch + +Requires: python3-jsii +Requires: python3-publication + +%description +[](https://badge.fury.io/js/alps-unified-ts) +[](https://badge.fury.io/py/alps-unified-ts) +[](https://maven-badges.herokuapp.com/maven-central/com.github.mmuller88/alps-unified-ts) +[](https://www.nuget.org/packages/com.github.mmuller88.AlpsUnifiedTs/) + + +# alps-unified-ts + +That is an enhanced TypeScript library of [alps-unified](https://github.com/mamund/alps-unified). With it you can convert an ALPS API spec to other API spec like openApi, Graph QL Schema. + +Very useful to understand the idea of ALPS API is this video on YT: https://www.youtube.com/watch?v=oG6-r3UdenE + +Want to know more about ALPS? --> please visit: + +* http://alps.io/ +* https://github.com/alps-io/ +* https://github.com/mamund/alps-unified + +# Features + +* generating and publishing alps unified libraries for JavaScript, TypeScript, Python, Java and .NET +* Type support for ALPS specs (see example 'Create from Spec' down below) + +# Examples + +## Load from YAML file + +You can load the ALPS spec directly from a YAML file. JSON ist atm not supported. + +### Convert to OpenApi + +```python +# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826 +Alps.unified(Alps.load_yaml("test/todo-alps.yaml"), + format_type=FormatType.OPENAPI +) +``` + +### Convert to GraphQL Schema + +```python +# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826 +Alps.unified(Alps.load_yaml("test/todo-alps.yaml"), + format_type=FormatType.SDL +) +``` + +## Create from Spec + +Creating the API specification from the spec is very powerful. As it gives you much support in an idea like VS as it is typed and documented. So you alway produce valid API specs. + +```python +# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826 +Alps.unified( + Alps.spec( + alps={ + "version": "1.0", + "doc": { + "value": "Simple Todo list example" + }, + "ext": [{ + "type": "metadata", + "name": "title", + "value": "simpleTodo", + "tags": "oas" + }, { + "type": "metadata", + "name": "root", + "value": "http://api.example.org/todo", + "tags": "oas" + } + ], + "descriptor": [{ + "id": "id", + "type": "semantic", + "text": "storage id of todo item" + } + ] + } + )) +``` + +For Python to benefit from the types better do this: + +```python +import alps_unified_ts as alps + +alps_def = alps.AlpsDef( + version='1.0', + descriptor=[alps.DescriptorDef(id="id", type="semantic", text="sotrage id of todo item")], + doc=alps.DocDef( + value="Simple Todo list example"), + ext=[ + alps.ExtDef( + name="root", + tags="oas", + type="metadata", + value="http://api.example.org/todo"), + alps.ExtDef( + name="title", + tags="oas", + type="metadata", + value="simpleTodo")]) + +alps.Alps.unified(alps_document=alps.Alps.spec(alps=alps_def), format_type=alps.FormatType.OPENAPI) +``` + +# Thanks to + +* The AWS CDK Community for the repo tool [projen](https://github.com/projen/projen) which I use for this repo. + + + + +%package -n python3-alps-unified-ts +Summary: alps-unified-ts +Provides: python-alps-unified-ts +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-alps-unified-ts +[](https://badge.fury.io/js/alps-unified-ts) +[](https://badge.fury.io/py/alps-unified-ts) +[](https://maven-badges.herokuapp.com/maven-central/com.github.mmuller88/alps-unified-ts) +[](https://www.nuget.org/packages/com.github.mmuller88.AlpsUnifiedTs/) + + +# alps-unified-ts + +That is an enhanced TypeScript library of [alps-unified](https://github.com/mamund/alps-unified). With it you can convert an ALPS API spec to other API spec like openApi, Graph QL Schema. + +Very useful to understand the idea of ALPS API is this video on YT: https://www.youtube.com/watch?v=oG6-r3UdenE + +Want to know more about ALPS? --> please visit: + +* http://alps.io/ +* https://github.com/alps-io/ +* https://github.com/mamund/alps-unified + +# Features + +* generating and publishing alps unified libraries for JavaScript, TypeScript, Python, Java and .NET +* Type support for ALPS specs (see example 'Create from Spec' down below) + +# Examples + +## Load from YAML file + +You can load the ALPS spec directly from a YAML file. JSON ist atm not supported. + +### Convert to OpenApi + +```python +# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826 +Alps.unified(Alps.load_yaml("test/todo-alps.yaml"), + format_type=FormatType.OPENAPI +) +``` + +### Convert to GraphQL Schema + +```python +# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826 +Alps.unified(Alps.load_yaml("test/todo-alps.yaml"), + format_type=FormatType.SDL +) +``` + +## Create from Spec + +Creating the API specification from the spec is very powerful. As it gives you much support in an idea like VS as it is typed and documented. So you alway produce valid API specs. + +```python +# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826 +Alps.unified( + Alps.spec( + alps={ + "version": "1.0", + "doc": { + "value": "Simple Todo list example" + }, + "ext": [{ + "type": "metadata", + "name": "title", + "value": "simpleTodo", + "tags": "oas" + }, { + "type": "metadata", + "name": "root", + "value": "http://api.example.org/todo", + "tags": "oas" + } + ], + "descriptor": [{ + "id": "id", + "type": "semantic", + "text": "storage id of todo item" + } + ] + } + )) +``` + +For Python to benefit from the types better do this: + +```python +import alps_unified_ts as alps + +alps_def = alps.AlpsDef( + version='1.0', + descriptor=[alps.DescriptorDef(id="id", type="semantic", text="sotrage id of todo item")], + doc=alps.DocDef( + value="Simple Todo list example"), + ext=[ + alps.ExtDef( + name="root", + tags="oas", + type="metadata", + value="http://api.example.org/todo"), + alps.ExtDef( + name="title", + tags="oas", + type="metadata", + value="simpleTodo")]) + +alps.Alps.unified(alps_document=alps.Alps.spec(alps=alps_def), format_type=alps.FormatType.OPENAPI) +``` + +# Thanks to + +* The AWS CDK Community for the repo tool [projen](https://github.com/projen/projen) which I use for this repo. + + + + +%package help +Summary: Development documents and examples for alps-unified-ts +Provides: python3-alps-unified-ts-doc +%description help +[](https://badge.fury.io/js/alps-unified-ts) +[](https://badge.fury.io/py/alps-unified-ts) +[](https://maven-badges.herokuapp.com/maven-central/com.github.mmuller88/alps-unified-ts) +[](https://www.nuget.org/packages/com.github.mmuller88.AlpsUnifiedTs/) + + +# alps-unified-ts + +That is an enhanced TypeScript library of [alps-unified](https://github.com/mamund/alps-unified). With it you can convert an ALPS API spec to other API spec like openApi, Graph QL Schema. + +Very useful to understand the idea of ALPS API is this video on YT: https://www.youtube.com/watch?v=oG6-r3UdenE + +Want to know more about ALPS? --> please visit: + +* http://alps.io/ +* https://github.com/alps-io/ +* https://github.com/mamund/alps-unified + +# Features + +* generating and publishing alps unified libraries for JavaScript, TypeScript, Python, Java and .NET +* Type support for ALPS specs (see example 'Create from Spec' down below) + +# Examples + +## Load from YAML file + +You can load the ALPS spec directly from a YAML file. JSON ist atm not supported. + +### Convert to OpenApi + +```python +# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826 +Alps.unified(Alps.load_yaml("test/todo-alps.yaml"), + format_type=FormatType.OPENAPI +) +``` + +### Convert to GraphQL Schema + +```python +# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826 +Alps.unified(Alps.load_yaml("test/todo-alps.yaml"), + format_type=FormatType.SDL +) +``` + +## Create from Spec + +Creating the API specification from the spec is very powerful. As it gives you much support in an idea like VS as it is typed and documented. So you alway produce valid API specs. + +```python +# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826 +Alps.unified( + Alps.spec( + alps={ + "version": "1.0", + "doc": { + "value": "Simple Todo list example" + }, + "ext": [{ + "type": "metadata", + "name": "title", + "value": "simpleTodo", + "tags": "oas" + }, { + "type": "metadata", + "name": "root", + "value": "http://api.example.org/todo", + "tags": "oas" + } + ], + "descriptor": [{ + "id": "id", + "type": "semantic", + "text": "storage id of todo item" + } + ] + } + )) +``` + +For Python to benefit from the types better do this: + +```python +import alps_unified_ts as alps + +alps_def = alps.AlpsDef( + version='1.0', + descriptor=[alps.DescriptorDef(id="id", type="semantic", text="sotrage id of todo item")], + doc=alps.DocDef( + value="Simple Todo list example"), + ext=[ + alps.ExtDef( + name="root", + tags="oas", + type="metadata", + value="http://api.example.org/todo"), + alps.ExtDef( + name="title", + tags="oas", + type="metadata", + value="simpleTodo")]) + +alps.Alps.unified(alps_document=alps.Alps.spec(alps=alps_def), format_type=alps.FormatType.OPENAPI) +``` + +# Thanks to + +* The AWS CDK Community for the repo tool [projen](https://github.com/projen/projen) which I use for this repo. + + + + +%prep +%autosetup -n alps-unified-ts-0.0.40 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-alps-unified-ts -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Wed May 10 2023 Python_Bot <Python_Bot@openeuler.org> - 0.0.40-1 +- Package Spec generated |