0. generating your config file

swagger-bundler needs config file for using. so, at first, you must generate config file.

$ swagger-bundler config --init
generate ~/venv/web/work/swagger-bundler.ini.

The stragegy of finding config file, following below.

Your current working directory is ~/venv/web/work/. then,

1. finds ~/venv/web/work/swagger-bundler.ini

2. finds ~/venv/web/swagger-bundler.ini

3. finds ~/venv/swagger-bundler.ini

4. finds ~/swagger-bundler.ini

Config file is not found, then, lookup ~/.swagger-bundle.ini.

1. how to use

Usage: swagger-bundler [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  bundle    bundles many source files into single file
  concat    concatnates many swagger-definition files
  config    show config
  validate  validates via swagger-2.0 spec

Swagger-bundler has two commands.

• bundle

• concat

$ swagger-bundler bundle <file.yaml>

.
├── main.yaml
└── parts
    ├── common.yaml
    ├── x.yaml
    └── y.yaml

x-bundler-namespace: ZZZ
x-bundler-compose:
  - ./parts/x.yaml
  - ./parts/y.yaml
x-bundler-concat:
  - ./parts/common.yaml

$ swagger-bundler bundle main.yaml

x-bundler-namespace: O
x-bundler-compose:
  - ../parts/x-state.yaml as X
  - ../parts/y-state.yaml as Y

$ swagger-bundler concat [file1.yaml] [file2.yaml] ...

hook configuration

Hook configuration examples.

• lifting sub definitions sample

• tiny individual mixin sample

• deref sample

watch option

# installed with [watch]
$ pip install "swagger-bundler[watch]"
$ swagger-bundler bundle --watch "*.yaml" --outfile="/tmp/output.yaml" src.yaml

0.1.10.4

• fix deref implemetation

0.1.10.1

• fix deref implemetation

0.1.10

• adding load hook

• (adding deref example)

0.1.9

• fix titlize function is invalid that using lifting definition hook. (fooBar -> Foobar)

0.1.8

• fix qualified import bug(since 0.1.7)

0.1.7

• reviving context cache

• fix ValueError when merging with None

0.1.6

• fix bug (lifting definition on array)

0.1.5

• adding postscript.lifting_definition(hook)

0.1.4

• adding extra information, exposed_predicate, on prefixing(add_namespace) postscript hook

0.1.3

• bug fix

0.1.2

• adding orphan reference check

0.1.1

• more hooks (add_namespace, validate)

0.1

• postscript_hook

0.0.7

• prefixing targets responses,definisions -> responses,definisions,parameters

0.0.6

• fix case: ctx.data has ‘responses’ data (but value is None)

• fix watching generated file

0.0.5

• watch option is supported

0.0.4

• gentle warning message on FileNotFoundError

• bundle command with –namespace option

• qualified import (e.g. x-bundler-compose with ‘foo.yaml as F’)

0.0.3

• adding readme and examples

• support json format(input/output)