https://github.com/mermade/semoasa-tools
Tools to manipulate Semoasa documents
https://github.com/mermade/semoasa-tools
api openapi openapi3 semoasa
Last synced: 6 months ago
JSON representation
Tools to manipulate Semoasa documents
- Host: GitHub
- URL: https://github.com/mermade/semoasa-tools
- Owner: Mermade
- License: bsd-3-clause
- Created: 2017-10-15T11:08:27.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-06-29T10:49:31.000Z (over 2 years ago)
- Last Synced: 2025-07-06T19:51:36.143Z (7 months ago)
- Topics: api, openapi, openapi3, semoasa
- Language: JavaScript
- Homepage: https://www.reprezen.com/blog/pluggable-extensions-to-the-openapi-specification-language
- Size: 13.7 KB
- Stars: 0
- Watchers: 2
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# semoasa-tools
Tools for manipulating [Semoasa](https://github.com/RepreZen/Semoasa) documents.
## semoasa-combine
Combine multiple Semoasa documents into one.
### Use-case
Bundling multiple Semoasa documents into a combined document for use in Semoasa-
compliant applications.
### Usage:
```
semoasa [file...] > output.yaml
```
### Notes
The output Semoasa version number (`openapiExtensionFormat`) will be set to the highest version seen in the input files, according
to [semver](http://semver.org/). No attempt is *currently* made to validate or ugrade earlier versions to the latest version.
Clashing definitions in later input files will be **merged** with those in earlier files. Precedence is important.
## semoasa-split
### Use case
Splitting a bundled Semoasa document back into its component parts, based on namespace.
### Usage
`semoasa-split [file...]`
### Notes
Namespaces existing in multiple input files will overwrite the same output document(s).
## semoasa-validate
*Coming soon*
## semoasa-upgrade
*Coming soon*