Configuration for service (OpenAPI 3 or other) consumers
Project description
1 Welcome to ZGW Consumers’ documentation!
- Version:
0.30.0
- Source:
- Keywords:
OpenAPI, Zaakgericht Werken, Common Ground, NLX
Manage your external API’s to consume.
2 Features
Store services with their configuration in the database
Integrate with OpenAPI 3.0 specifications
NLX support
Declare data/domain objects as modern Python dataclasses
3 Installation
3.1 Requirements
Python 3.10 or newer
setuptools 30.3.0 or newer
Django 3.2 or newer
3.2 Install
Install from PyPI
pip install zgw-consumers
Add zgw_consumers and simple_certmanager to the INSTALLED_APPS setting.
Optionally override ZGW_CONSUMERS_CLIENT_CLASS to a custom client class.
Optionally specify ZGW_CONSUMERS_OAS_CACHE to point to a separate django cache. Defaults to django.core.cache.DEFAULT_CACHE_ALIAS, which is default in practice. For performance reasons we highly recommend to use a real cache backend like Redis or Memcache.
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
Built Distribution
Hashes for zgw_consumers-0.30.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a9b86e78edd1350dbbaba48c96cc70ff3b443207237c2dd5cebe1b54bf6baeea |
|
MD5 | 56b3d5b80b93d97bb2379a9f97fc307d |
|
BLAKE2b-256 | 007d03914b3bf742370547326719c4aa28adec58b0d5e00c47b45903d214b430 |