django-api-utility 0.1.0

Reusable API integration utility for Django services

django-api-utility

Reusable API integration utility for Django services.

Features

• Service + endpoint registry models
• Definition-key based endpoint resolution
• OAuth token fetch/refresh flow with encrypted token storage
• Consistent utility exceptions for config, token, and request errors
• Thin request wrapper with retry support

Install

pip install -e .

Django setup

Add app:

INSTALLED_APPS = [
    # ...
    "django_api_utility",
]

Definition key mapping

Provide a JSON mapping file via EXTERNAL_DEFINITION_KEYS_FILE, or use the packaged default at config/external_definition_keys.json.

Example:

{
  "users_get": "service_users_get"
}

Usage

from django_api_utility import get_by_key, post_by_key

response = get_by_key("users_get", params={"page": 1})
create_response = post_by_key("users_create", payload={"name": "Alice"})

Internal layout

• django_api_utility/transport/: HTTP transport and outbound execution primitives
• django_api_utility/domain/: definition keys, endpoint resolution, token lifecycle
• django_api_utility/orchestration/: request orchestration with retries and token refresh fallback

Tests

pip install -e ".[test]"
pytest -q