Skip to content
oas-fastify / 3.0.1

oas-fastify 3.0.1

Install from the command line:
Learn more about npm packages
$ npm install @ahmadnassri/oas-fastify@3.0.1
Install via package.json:
"@ahmadnassri/oas-fastify": "3.0.1"

About this version

OAS to Fastify Plugin

OAS 3.x to Fastify routes automation

license release super linter test semantic

Usage

const fastify = require('fastify')()
const spec = require('./petstore.json')

// your handler object properties map to the OAS "operationId"
const handler = {
  listPets: () => { ... }
  createPets: () => { ... }
  showPetById: () => { ... }
}

fastify.register(require('oas-fastify'), { spec, handler }) 

Yaml Support?

This package does not support OAS Yaml format, but you can easily convert to JSON before calling `oas-fastify`
using js-yaml
const yaml = require('js-yaml')
const fs   = require('fs')

const spec = yaml.safeLoad(fs.readFileSync('openapi.yml', 'utf8'))


fastify.register(require('oas-fastify'), { spec, handler }) 
npx apidevtools/swagger-cli bundle spec/openapi.yml --outfile spec.json

Options

The plugin accepts an options object with the following properties:

  • spec: a valid OpenAPI Specification JSON object
  • handler: an object with properties that map to the spec's operationId names, with the values as functions that will handle the request
Example
const spec = {
  "paths": {
    "/pets": {
      "get": {
        "operationId": "listPets",
        ...
      }
    }
  }
}

const handler = {
  listPets: function (request, reply, fastify) {
    // fastify instance passed in for convenience

    reply.send({ hello: 'world' })
  }
}

Author: Ahmad Nassri • Twitter: @AhmadNassri

Details


Assets

  • oas-fastify-3.0.1.tgz

Download activity

  • Total downloads 0
  • Last 30 days 0
  • Last week 0
  • Today 0