Skip to main content

Configuration for service (OpenAPI 3 or other) consumers

Project description

1 Welcome to ZGW Consumers’ documentation!

Version:

0.33.0

Source:

https://github.com/maykinmedia/zgw-consumers

Keywords:

OpenAPI, Zaakgericht Werken, Common Ground, NLX

Run CI Coverage status Code linting Documentation Status

python-versions django-versions pypi-version

Manage your external API’s to consume.

2 Features

  • Store services with their configuration in the database

  • Built in ape-pie API client adapter

  • NLX support

  • Declare data/domain objects as modern Python dataclasses

3 Installation

3.1 Requirements

  • Python 3.10 or newer

  • Django 3.2 or newer

3.2 Install

  1. Install from PyPI

pip install zgw-consumers
  1. Add zgw_consumers and simple_certmanager to the INSTALLED_APPS setting.

4 Usage

In the Django admin, you can create Service instances to define your external APIs.

Client

To get a client for a given resource, you can use:

from zgw_consumers.client import build_client
from zgw_consumers.models import Service

my_service = Service.objects.get(api_root="https://api.example.com/")
client = build_client(my_service)

with client:
    # The preferred way to use the client is within a context manager
    client.get("relative/url")

The resulting client will have certificate and authentication automatically configured from the database configuration.

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

zgw-consumers-0.33.0.tar.gz (50.8 kB view details)

Uploaded Source

Built Distribution

zgw_consumers-0.33.0-py3-none-any.whl (58.5 kB view details)

Uploaded Python 3

File details

Details for the file zgw-consumers-0.33.0.tar.gz.

File metadata

  • Download URL: zgw-consumers-0.33.0.tar.gz
  • Upload date:
  • Size: 50.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.0.0 CPython/3.12.2

File hashes

Hashes for zgw-consumers-0.33.0.tar.gz
Algorithm Hash digest
SHA256 704ed4a533ac324e121ae96df4a801de6a20558298f02c57b4dbdeacb1237b64
MD5 726b099f7839c5e5dbcada19d3d76527
BLAKE2b-256 e61c55851288ba00b9e2490de8be46901d3a98e94852625a5f511a136b61f78c

See more details on using hashes here.

File details

Details for the file zgw_consumers-0.33.0-py3-none-any.whl.

File metadata

File hashes

Hashes for zgw_consumers-0.33.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9f67fe8160511fb037afca7aa1fdfad7a8fd6333bb9491810ab2991f6784738b
MD5 9b06435a0c65b567a57e9f030fd33505
BLAKE2b-256 3458ecdffb321388c71f4057bb9f1948fafc72ae22173f663d04b08131272643

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