Popularity

6.6

Growing

Activity

0.7

Declining

Stars 6

Watchers 6

Forks 3

Last Commit 4 months ago

Monthly Downloads: 5

Programming language: Haskell

License: BSD 3-clause "New" or "Revised" License

Tags: OpenAPI

Latest version: v0.0.0.1

openapi-typed alternatives and similar packages

Based on the "OpenAPI" category.
Alternatively, view openapi-typed alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of openapi-typed or a related project?

README

Haskell types for OpenAPI 3.0.0.

Available as a Hackage package: openapi-typed.

The types follow the following opinonated conventions and deviations from the standards:

Each OpenAPI object represented as data provides the following:
- Docstring showing how the constructor works
- Constructor with fields named using the convention _<data>_field
- Derivation of Eq for each data class
- Derivation of Show for each data class
- Derivation of ToJSON for each data class
- Derivation of FromJSON for each data class
- Getter for each field using the convention get<data><field>, where the field is capitalized, ie getPathItemSummary
- Setter for each field using the convention set<data><field>, where the field is capitalized, ie setPathItemSummary
- either function for all datatypes with multiple construtors that take a single argument using the convention either<data><constructor>, ie eitherReferenceOrRef
Adds the possibility to use x- extensions on almost all objects, as this happens a lot in the wild.
Changes the items type in shema to accept a tuple in addition to a schema and a reference.

Clone this repository: git clone https://github.com/meeshkan/openapi-typed.git
Move into the directory: cd openapi-typed
Set up your local environment: You can use this guide from The Haskell Tool Stack for reference

The tests show how to use this library to parse the Slack and Stripe OpenAPI specs.

To execute the tests, run:

stack test

Notice a bug? Interested in contributing? The best way to get involved is to open an issue.

Please note that this project is governed by the Meeshkan Community Code of Conduct. By participating, you agree to abide by its terms.

At Meeshkan, we're working to improve how people test their products. So if you have feelings about this package, we want to hear from you.

Here are some ways you can get in touch: