Skip to main content

Elm client generator for OpenAPI specifications

Project description

openapi-elm-client generates Elm client code from OpenAPI 2.0 specification.

Usage

Basic usage is like this:

openapi-elm-client my_spec.yaml Some.Module.Name

This will read the OpenAPI spec from my_spec.yaml and create an Elm module named Some.Module.Name. This writes the output to stdout, so a more typical invocation might be:

openapi-elm-client my_spec.yaml Some.Module.Name > src/Some/Module/Name.elm

Generated code

openapi-elm-client produces a named type alias for each definition in the input spec. It also produces a function for calling each endpoint defined in the spec, along with appropriate JSON encoders and decoders.

Tests

You can run the tests by first installing the test dependencies:

pip install ".[test]"

and then invoking pytest:

pytest tests

Approval tests

openapi-elm-client uses godkjenn for approval testing. We have collection of input specs along with “approved” versions of the code generated by openapi-elm-client; if the generated code ever changes, we have to see if it’s still correct.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for openapi-elm-client, version 0.3.3
Filename, size File type Python version Upload date Hashes
Filename, size openapi_elm_client-0.3.3-py3-none-any.whl (11.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size openapi_elm_client-0.3.3.tar.gz (6.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page