atomically 0.2.0

Write the smallest possible OpenAPI and generate the rest

atomically

[!NOTE] This library is for experimenting and prototyping at this point and may change considerably until it reaches version 1.0.0. Please be cautious about relying on this library at this point.

Write the smallest possible OpenAPI and generate the rest. Read more about this approach in the Atomically repository.

Installation

You can use pipx to install this tool.

You can use pipx to install this tool.

• Install pipx
• Run pipx install atomically

You can also use pip:

pip install atomically

Usage

As CLI

Run atomically --help to see all options.

To generate an OpenAPI from from an atomic file, run:

atomically generate path-to-atomic-file.yml

Read the Atomically repository to see how to write atomic files. Check the tests/atomic_files directory in this repo to see examples.

As Python library

from atomically import Atomically

openapi = Atomically.from_file("atomically.yaml").generate()
with open("openapi.yaml", "w") as f:
    f.write(openapi.to_yaml())

Development

To contribute to this library, first checkout the code. Then create a new virtual environment:

cd atomically
python -m venv venv
source venv/bin/activate

Now install the dependencies and test dependencies:

pip install -e '.[test]'

To run the tests:

pytest