schemavault 4.1.0

Hierarchical schema validation with asset management and configuration defaults

schemavault

Hierarchical schema validation with asset management and configuration defaults for Python services.

Installation

pip install schemavault

Usage

import schemavault

# Validate endpoint configurations
err = schemavault.validate('endpoint', {'url': '/api/v1/users', 'method': 'GET'})
if err:
    raise ValueError(err)

# Build URLs with query parameters
url = schemavault.build_url('https://api.example.com', 'users', {'page': '2'})

# Merge header dictionaries
headers = schemavault.merge_headers(
    {'Accept': 'application/json'},
    {'Authorization': 'Bearer token123'}
)

# Get registry defaults
defaults = schemavault.get_defaults()
print(defaults['timeout'])  # 60000
print(defaults['retries'])  # 5

# Normalize endpoint configuration
normalized = schemavault.normalize_endpoint({
    'url': '  /api/users  ',
    'method': 'get',
    'timeout': '5000'
})

Features

• Schema validation for REST endpoint configurations
• URL building with path and query parameter support
• Header merging and normalization
• Asset management with embedded metadata support
• Configuration defaults with transport presets
• Schema diffing and flattening utilities

API

• validate(schema_name, obj) — validate against named schema
• validate_url(url) / validate_method(method) / validate_headers(headers)
• build_url(base, path, query) — construct URL
• merge_headers(base, extra) — merge header dicts
• normalize_endpoint(config) — normalize endpoint config
• schema_diff(old, new) / flatten(obj) / unflatten(flat)
• get_defaults() / get_registry(key)

License

MIT