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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.