Skip to main content

Generic API Client

Interact with APIs through methods and Pydantic models.

Features

  • Interact with an API through Pydantic models and python methods:
    • Input and output of each endpoint can be described by a Pydantic model
    • Each endpoint can be associated to a python method
    • Allow developers to use complex APIs with the static evaluation of the code performed by IDEs
  • Comprehensive API collections using Jinja templates
  • Handle API versions via template and Pydantic Model
  • Cache built to handle write and read requests

Installation

pip install generic-api-client

Usage

See our wiki or the new docs directory for detailed guidance on creating an APIClient, defining Segments, and building custom APIConnectors.

Examples

The repository includes an examples/ directory with working examples, such as the nextcloud_api demo. These examples demonstrate how to use the library to interact with the Nextcloud API.

Documentation

A dedicated docs/ directory contains markdown files that serve as a lightweight wiki, covering:

  • Overview of the library
  • How to instantiate an APIClient
  • Defining custom Segments
  • Creating APIConnectors
  • Using the Nextcloud example

License

The project is released under the MIT License.

Acknowledgements

This project was built with the help of Claude Code and local Ollama AI assistants. They were used mainly for documentation so keep in mind that even if it has been reviewed it may contains errors.

Project Status

NOTE The project is currently in development phase. If you have any remark or question feel free to open an Issue

Metadata

Release files for generic-api-client 1.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for generic-api-client 1.2.0
File Size Uploaded Provenance Actions
generic_api_client-1.2.0.tar.gz 18.5 kB Without provenance Details for generic_api_client-1.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for generic-api-client 1.2.0
File Interpreter ABI Platform Actions
generic_api_client-1.2.0-py3-none-any.whl Python 3 none any Details for generic_api_client-1.2.0-py3-none-any.whl

Total release size: 44.8 kB

Release files / generic_api_client-1.2.0.tar.gz

Download URL generic_api_client-1.2.0.tar.gz
Size 18.5 kB
Tags Source
SHA-256 checksum
How to use checksums
9bf96b28bcf3f616dee539dd0a07a70b9de1e2dd49d999af142508611f060e87
BLAKE2b-256 checksum
How to use checksums
c59bf75eb1c95bdde6483b1f5cc522115610a752d0eca2c5a4ab595d49029e37
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.4.2 CPython/3.14.7 Linux/6.1.0-37-amd64

Release files / generic_api_client-1.2.0-py3-none-any.whl

Download URL generic_api_client-1.2.0-py3-none-any.whl
Size 26.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
05e6ec0853e79f959533eb25542be516a9e06206d31a436a93d02b4cc14905ad
BLAKE2b-256 checksum
How to use checksums
c99ef3a4e60a899c549699d5df112df74c909bd9bc669aef36f9107752abbeb4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.4.2 CPython/3.14.7 Linux/6.1.0-37-amd64

Security for generic-api-client 1.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page