fastify-swagger
openapi-diff
fastify-swagger | openapi-diff | |
---|---|---|
8 | 3 | |
854 | 750 | |
2.9% | 1.6% | |
7.7 | 8.8 | |
17 days ago | 11 days ago | |
JavaScript | Java | |
MIT License | Apache License 2.0 |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
fastify-swagger
-
Craft OpenAPI Specs & Production-Ready SDKs with Fastify
With Speakeasy, you can create client SDKs based on an OpenAPI specification. Fastify ships with the @fastify/swagger plugin, which provides convenient shortcuts for generating good OpenAPI specifications. We'll start this tutorial by registering @fastify/swagger in a Fastify project to generate a spec.
-
Testing for Breaking Changes in Fastify APIs
First let’s get our current OpenAPI specification out of Fastify and onto the file system. If you have not added the https://github.com/fastify/fastify-swagger plugin first go do that. Then use this simple script I called generate-spec.ts to write your OpenAPI specification to the filesystem.
- Is there a FastAPI alternative for Node?
- Is NestJS good for startups?
-
Automatic swagger ui for nodejs/express? (Info in comments)
The fastify-swagger docs has an example https://github.com/fastify/fastify-swagger
-
Better Backend DX: JSON Schema + TypeScript + Swagger = ✨ Vol. 1
@fastify/swagger is a fastify plugin to serve a Swagger UI, using Swagger (OpenAPI v2) or OpenAPI v3 schemas automatically generated from your route schemas, or from an existing Swagger/OpenAPI schema.
-
How do you write your API documentation? Any self-hosted utilities you'd recommend?
On the Node.js framework side of things, Fastify has support for Swagger with the fastify-swagger plugin.
-
How do you unify TypeScript for both frontend and backend?
With this approach, backend can be any programming languages that support OpenAPI or Swagger. Personally, I use fastify-swagger; but I can also be things like Python's FastAPI or Golang's Gin/Buffalo/Native.
openapi-diff
-
Using OpenAPI to Detect Breaking Changes in tRPC
Introducing our star player for detecting breaking changes: OpenAPI Diff. The good news? You can fire it up locally with Docker. Here’s how:
-
Testing for Breaking Changes in Fastify APIs
Now that we have a way to lookup our API’s behavior with Git, we can start testing for breaking changes between versions of our API. We’ll be using Optic (an open source tool I created) to do just that. If you are looking for other options I recommend https://github.com/OpenAPITools/openapi-diff or https://github.com/Tufin/oasdiff.
-
How do you ensure contracts consistency between microservices?
One option is to use OpenAPI to define the contracts. And then when you update the definitions, run something like https://github.com/OpenAPITools/openapi-diff to make sure there are no incompatibilities.
What are some alternatives?
fastify-openapi-glue - A plugin for the Fastify webserver to autogenerate a Fastify configuration based on a OpenApi(v2/v3) specification.
oasdiff - OpenAPI Diff and Breaking Changes
widdershins - OpenAPI / Swagger, AsyncAPI & Semoasa definitions to (re)Slate compatible markdown
trpc-breaking-changes-detection - Automatically notify about breaking changes in your tRPC API
fastify-jwt - JWT utils for Fastify
springdoc-openapi - Library for OpenAPI 3 with spring-boot
openapi-client-axios - JavaScript client library for consuming OpenAPI-enabled APIs with axios
Optic - OpenAPI linting, diffing and testing. Optic helps prevent breaking changes, publish accurate documentation and improve the design of your APIs.
tsoa - Build OpenAPI-compliant REST APIs using TypeScript and Node
docker - Docker - the open-source application container engine
awesome-jsonschema - A curated list of awesome JSON Schema resources, tutorials, tools, and more.
zod - TypeScript-first schema validation with static type inference