Skip to main content

Simple util for generate helper code based on OpenAPI specs

Project description

DekoGen

What is it?

dekogen is simple tool to avoid big unreadable HTTP requests. It's provide ability to create requests builders and response wrappers to keep match between code and OpenAPI specs.

About

Main points:

1. Maintain compliance between code and OpenAPI spec
2. Do not describe requests and responses manually
3. Use:
request_body = Configuration() \
    .number("10") \
    .settings(Settings()
          .required_protocol("33-11-JRTF")
          .element_per_second(34)
          .related_grants("785-56-IU", "89-551-11-JRT")
          .body) \
    .body
Instead of:
request_body = {"configuration": {"number": 10,
                                  "settings": {"required_protocol": "33-11-JRTF", "element_per_second": 34,
                                               "related_grants": ["785-56-IU", "89-551-1-JRT"]}}}
4. Parse responses with autocomplete

Dependencies

inflection: 0.3.1
PyYAML: 6.0
Click: 7.1.2

See the full installation instructions for recommended and optional dependencies.

Installation

pip install dekogen

License

MIT

Discussion and Development

All contributions, bug reports, bug fixes, documentation improvements, enhancements and ideas are welcome.

Getting started

Code generation

Via command line:

Help:
dekogen_cmd -h
Commands help:
dekogen_cmd <command from help list> -h
Sample:
dekogen_cmd generate-all-python -f ~/sample-api-specs.yaml -o ~/results

Via python code:

Read data from:
from dekogen.spec_reader import SpecReader

file_path = '/home/name/sample-api-specs.yaml'
spec_reader = SpecReader
spec_data = spec_reader.read_yaml(file_path=file_path)
Generate responses:
from dekogen.spec_codegen import PythonResponsesGenerator

output_path = '/home/name/output_dir'
py_req_generator = PythonResponsesGenerator(spec_data=spec_data, file_path=output_path)
py_req_generator.generate()

Generate requests:

from dekogen.spec_codegen import PythonRequestsGenerator

output_path = '/home/name/output_dir'
py_req_generator = PythonRequestsGenerator(spec_data=spec_data, file_path=output_path)
py_req_generator.generate()

Usage:

  1. To add autocomplete for responses just pass response.body (dict) into related Response() object initialization

    response = client.request(...)
    body = NameOfTheView(response.data)
    
  2. Create scalable and readable structures for requests using direct import of generated files and classes.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dekogen-0.1.2.tar.gz (6.2 kB view details)

Uploaded Source

File details

Details for the file dekogen-0.1.2.tar.gz.

File metadata

  • Download URL: dekogen-0.1.2.tar.gz
  • Upload date:
  • Size: 6.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.5.0 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.12

File hashes

Hashes for dekogen-0.1.2.tar.gz
Algorithm Hash digest
SHA256 6eff153727964104cc949aa440bd7fd434bda4d05159cf9b08d3c7ee958c787e
MD5 4163018347e775a30d59bf57771cf2d4
BLAKE2b-256 f5af39b261fc312ce28795a72dcfb701da62b11456d3abe3187b83bf1b1d65e7

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page