Metadata-Version: 2.1
Name: cloudmesh.openapi
Version: 1.4.24
Summary: A command called openapi and foo for the cloudmesh shell
Home-page: https://github.com/cloudmesh/cloudmesh.openapi
Author: Gregor von Laszewski
Author-email: laszewski@gmail.com
License: Apache 2.0
Description: # Cloudmesh OpenAPI Merge
        
        ## Prerequisits
        
        ```bash
        $ pip install cloudmesh.openapi
        ```
        
        ## Usage
        
        The manual page for the `cms openapi` command  is
        
        ```
        cms openapi merge [SERVICES...] [--dir=DIR]
        cms openapi list [--dir=DIR]
        cms openapi description [SERVICES...] [--dir=DIR]
        cms openapi md FILE [--indent=INDENT]
        ```
        
        
        You need to have the yaml file in the current directory and execute
        this program in this directory
        
        An example for yaml files are provided in 
        
        * <https://github.com/cloudmesh-community/nist/tree/master/spec>
        
        Please note that the spec directory is containing openapi specifications that
        may not yet completed or are actively worked on. You are invited to participate.
        You can download some examples, as well as the `.header.yaml` file you will need
        with for example curl
        
        Once you have `organization.yaml`, `user.yaml` `timestap.yaml` and `.header
        yaml` in your directory you can say
        
        Please note that this script does not yet rewrite the `$ref`
        appropriately, but if you like to help you can do so.
        
        ## Example use
        
        Here we demonstrate an example use
        
        First we download some OpenAPI examples:
        
        ```bash
        mkdir example
        cd example
        $ export SPEC=https://raw.githubusercontent.com/cloudmesh-community/nist/master/spec
        $ curl $SPEC/organization.yaml > organization.yaml
        $ curl $SPEC/user.yaml > user.yaml
        $ curl $SPEC/timestamp.yaml > timestamp.yaml
        $ curl $SPEC/.header.yaml > .header.yaml
        
        ```
        
        Now let us look at the descriptions with 
        
        ```bash
        $ cms openapi description organization user timestamp
        ```
        
        To create a merged specification you can use 
        
        ```bash
        $ cms openapi merge organization user timestamp
        ```
        
        To create a markdown representation you can use 
        
        ```bash
        $ cms openapi md user
        ```
        
        Note that for the markdown specification only one service is specified.
        
        
        
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown
