@digitalroute/bagger
TypeScript icon, indicating that this package has built-in type declarations

3.3.0Β β€’Β PublicΒ β€’Β Published

πŸŽ’ Bagger

npm (scoped) npm Build license

A joi-compatible tool for building Swagger (Open API 3) documents. It enables developers to use the same joi schemas for validation and documentation, ensuring that API documentation never becomes stale.

Features

  • πŸ”¨ Builder pattern: Dead simple api to create complex Swagger documents.
  • ✨ joi compatibility: Enables developers to use the same schemas for validation and documentation. Embedded Joi is now exposed by default.
  • πŸ”Ž Intellisense: Really nice intellisense suggestions, and TypeScript definitions.
  • πŸ”’ Type safety: Bagger always produces 100% valid Swagger documents. If you use TypeScript the compiler will enforce correctness in most cases, and otherwise Bagger will validate during compilation.

Usage

// Import as a classic javascript
const { bagger } = require('@digitalroute/bagger');

// OR

// Import the default instances ESModule / Typescript
import { bagger } from '@digitalroute/bagger';

Example

import { bagger, joi } from '@digitalroute/bagger';

bagger.configure({
  title: 'Bagger API',
  version: 'v1',
  description: 'Provides resources for building swagger documents'
});

bagger
  .addRequest('/bags', 'get')
  .addTag('bags')
  .addTag('build')
  .addResponse(
    bagger
      .response(200)
      .description('Successfully fetched all bags')
      .content(
        'application/json',
        joi
          .array()
          .items(joi.string())
          .example([['handbag', 'backpack', 'purse']])
      )
  );

const swaggerDefinition = bagger.compile();

Documentation

Package Sidebar

Install

npm i @digitalroute/bagger

Weekly Downloads

94

Version

3.3.0

License

MIT

Unpacked Size

280 kB

Total Files

34

Last publish

Collaborators

  • dot-bot
  • pierre.lemerle
  • polarn
  • jcelik
  • timberbain
  • saeger