OpenAPI-to-GraphQL CLI.
Please note: OASGraph CLI has been renamed toOASGraph CLI
Command line interface (CLI) for turning APIs described by OpenAPI Specification (OAS) into GraphQL interfaces.
Note: To use OASGraph as a library, refer to the oasgraph
package.
Installation
npm i -g oasgraph-cli
Usage
Usage: oasgraph <OAS JSON file path or remote url> [options]
Options:
-V, --version output the version number
-p, --port <port> select the port where the server will start
-u, --url <url> select the base url which paths will be built on
-s, --strict throw an error if OASGraph cannot run without compensating for errors or missing data in the OAS
-a, --addSubOperations nest operations based on path hierarchy
-f, --fillEmptyResponses create placeholder schemas for operations with HTTP status code 204 (no response) rather than ignore them
-o, --operationIdFieldNames create field names based on the operationId
--cors enable Cross-origin resource sharing (CORS)
--no-viewer do not create GraphQL viewer objects for passing authentication credentials
--save <file path> save schema to path and do not start server
-h, --help output usage information
The basic usage of the CLI takes the specified OAS, creates a GraphQL interface for it, and starts a server to host the GraphQL interface.
oasgraph oas.json
You can specify the OAS by pointing to either a local file or a remote url such as http://127.0.0.1:3000/openapi.json
. Additionally, you can specify a port number so you can have multiple GraphQL servers running on the same machine.
oasgraph http://127.0.0.1:3000/openapi.json -p 3001
OASgraph can also save a GraphQL schema to a local file, which you can use to inspect or change its content. Please note that the following command will not start the GraphQL server.
oasgraph oas.json --save schema.graphql
To learn more about the other options, please refer here.
Please note that the CLI tool is mainly used for quick testing and does not offer all the features that createGraphQlSchema(oas, options)
does.