alps-unified-ts
Project description
alps-unified-ts
That is an enhanced TypeScript library of 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:
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
# 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
# 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.
# 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:
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 which I use for this repo.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for alps_unified_ts-0.0.32-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 062b82e8d718f13fc07b02d4053767913c74af3b1a11ae70270b3b27892face7 |
|
MD5 | 11eb31097a749bb380461175f068441a |
|
BLAKE2b-256 | 054460559eb59b1907508ed34f16eac6e4fc56c59afba8db3a1a077589eed505 |