nuxtswagger

Nuxt-TS-Swagger plugin generator CLI
1,536 22
Install
npm install nuxtswagger@3.0.0
Latest Version:3.0.0
Older releases:2
License:ISC
Last Updated:Aug 6, 2024
Links: GitHub  ·  npm
Maintainer: elevista

NuxTSwagger

Nuxt-TS-Swagger plugin generator CLI

npm package github stars

Installation

npm i -D nuxtswagger

Requirements

Basic Usage

in Nuxt project directory

npx nuxtswagger https://api.server.foo/swagger.json

in script code

import { api } from '~/lib/api'
const response = await api.foo.bar(1).post(requestBody) // Post /foo/{bar} 
api.foo.bar.get() // GET /foo/bar

Options

options priority : command line > nuxt.config > package.json

nuxtswagger argument1 --option1 value1 --option2 value2
option description default example
(first argument) Swagger schema JSON path (required) http://.. or ./foo/swagger.json
src same as first argument first argument same as above
plugins-dir Nuxt plugins directory plugins
plugin-name Name for generated plugin api
export-name Export name {plugin-name} ''(export default)
type-path Path for scheme type file {plugins-dir}/{plugin-name}/{types.ts} ./types/swagger.d.ts

Set options using package.json

{
  "nuxtswagger": {
    "pluginName": "foo",
    "src": "https://api.server.foo/swagger.json"
  }
}

Set options using nuxt.config

v1.2+

export default defineNuxtConfig({
  nuxtswagger: [
    { pluginName: 'foo', src: 'https://api.server.foo/swagger.json' },
    { pluginName: 'bar', src: 'https://api.server.bar/swagger.json' },
  ],
  runtimeConfig: {
    public: {
      nuxtswagger: {
        pluginName: 'foo',
        // AxiosRequestConfig?
        axiosConfig: { baseURL: 'https://api-stage.server.foo' }
      },
    },
  },
})
tsconfig.json
{
  "compilerOptions": {
    "types": ["nuxtswagger/types"]
  }
}

and npm run swagger or npx nuxtswagger

License

ISC License Copyright (c) 2020, Elevista

Related Packages

@scayle/storefront-nuxt

Nuxt integration for the SCAYLE Commerce Engine and Storefront API

152,903
nuxt-tsconfig-stub

Stub Nuxt's generated tsconfig.json at installation

70,835 24
kuranuxt

Look at the Nuxt 3 documentation to learn more.

871 0
nuxt-define

One utility function for module authors to define compiler constants for all bui...

13,412,511
dayjs-nuxt

Day.JS Module for Nuxt

1,986,864 126

Version History

Version Released Vue License
3.0.0 ISC
1.3.1 ISC
1.3.0 ISC
1.2.3 ISC
1.2.2 ISC
Pre-releases (13)
Version Released Vue License
3.0.1-5 ISC
3.0.1-4 ISC
3.0.1-3 ISC
3.0.1-2 ISC
3.0.1-1 ISC