Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

outdoc

Package Overview
Dependencies
Maintainers
1
Versions
30
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

outdoc

Auto-generate OpenAPI document for Node.js service from the local testing

  • 1.0.1
  • latest
  • Source
  • npm
  • Socket score

Version published
Maintainers
1
Created
Source

Outdoc

Auto generate OpenAPI document from local HTTP testing

Version npm download

colorful robot writing document by Stable Diffusion

Installation

$ npm install outdoc -D

Usage

Add the following codes into your main file

const { OutDoc } = require('outdoc')
if (process.env.NODE_ENV === "test") {
  OutDoc.init()
}

Run the command

$ npx outdoc [test command] [options]

Usually it could be, for example:

$ npx outdoc npm test -t project-name

Adn it will generate an api.yaml in your root folder by defaults

Options

  -o, --output            file path of the generated doc, format supports json and yaml, default: api.yaml
  -t, --title <string>    title of the api document, default: API Document
  -v, --version <string>  version of the api document, default: 1.0.0
  -e, --email <string>    contact information
  -f, --force             run the script without adding OutDoc.init in the code 
  -h, --help              display help for command

Not adding extra codes

You might don't wanna add any extra codes in your project only for generating API document, then you can do:

First, Check if the main in your package.json pointing to your app entry file which export your nodejs server. If not, please add the attribute outdoc pointing to it. If you are writting a Typescript project, you need to add the following configuration.

{
	"outdoc": {
		"main": "./src/app.ts"
	}
}

Then run the command with the option -f

$ npx outdoc npm test -f
What is happending behind -f

By using the option -f, Outdoc will first check the outdoc.main in your package.json, if it not exist, Outdoc will use main in the package.json to find the app entry file.

Then Outdoc will copy the entry app file and insert codes into it, and use the new copied file as the entry app file, the concrete steps are:

  1. Find your app entry file from package.json, for example the file is named as app.js
  2. Copy app.js to a new temporary file named tmp_outdoc_file
  3. Insert Outdoc.init into app.js and start running the program to generate the API doc
  4. After the generation finished, copy back the content of tmp_outdoc_file to app.js and remove tmp_outdoc_file

Notes

Outdoc can only understand tests who are sending and receiving real HTTP requests, for example using the supertest in your test cases.

Mocked HTTP request won't work with Ourdoc, like fastify.inject.

License

MIT

FAQs

Package last updated on 04 Oct 2022

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc