Metadata-Version: 2.1
Name: alps-unified-ts
Version: 0.0.7
Summary: alps-unified-ts
Home-page: https://github.com/mmuller88/alps-unified-ts.git
Author: Martin Mueller<damadden88@googlemail.com>
License: Apache-2.0
Project-URL: Source, https://github.com/mmuller88/alps-unified-ts.git
Description: [![NPM version](https://badge.fury.io/js/alps-unified-ts.svg)](https://badge.fury.io/js/alps-unified-ts)
        [![PyPI version](https://badge.fury.io/py/alps-unified-ts.svg)](https://badge.fury.io/py/alps-unified-ts)
        [![Maven version](https://maven-badges.herokuapp.com/maven-central/com.github.mmuller88.alpsUnifiedTs/alps-unified-ts/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.github.mmuller88.alpsUnifiedTs/alps-unified-ts)
        ![Release](https://github.com/mmuller88/alps-unified-ts/workflows/Release/badge.svg)
        
        # 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 YouTube: 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 als unified libraries for JavaScript, TypeScript, Python and Java
        * releasing to NPM, Pypi and Maven Central (see top of Readme)
        * 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"
                    }
                    ]
                }
            ))
        ```
        
        # Thanks to
        
        * The AWS CDK Community for the repo tool [projen](https://github.com/projen/projen) which I use for this repo.
        
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: JavaScript
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Typing :: Typed
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved
Requires-Python: >=3.6
Description-Content-Type: text/markdown
