Skip to main content

Configuration for service (OpenAPI 3 or other) consumers

Project description

1 Welcome to ZGW Consumers’ documentation!

Version:

0.34.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 4.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.34.0.tar.gz (52.7 kB view details)

Uploaded Source

Built Distribution

zgw_consumers-0.34.0-py3-none-any.whl (60.5 kB view details)

Uploaded Python 3

File details

Details for the file zgw_consumers-0.34.0.tar.gz.

File metadata

  • Download URL: zgw_consumers-0.34.0.tar.gz
  • Upload date:
  • Size: 52.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.0 CPython/3.12.4

File hashes

Hashes for zgw_consumers-0.34.0.tar.gz
Algorithm Hash digest
SHA256 33136c75fd3fcb7f83c2b7a17191389f45dc31393be2efa7974506a40de59778
MD5 e4d60b6777706794ba9da40508db09d6
BLAKE2b-256 5f00fb3d5b4dde07bd72ce459dbb1ec0f60ec821b47cf1d3c7d53afd9bec0a10

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for zgw_consumers-0.34.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f9a58a3ae72b491e795245ba3c0b6666253ffd4a479401d438619e5e0260f6d2
MD5 9cd58c4acde7add53e631cc0d375c976
BLAKE2b-256 8292ead9c49085cc1185247f9715ae017f0ea657c14c276c98aba0b3896eb644

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