Python client for Nova Poshta API
Project description
novaposhta-python-client
A Python client for interfacing with the Nova Poshta API. Designed to provide easy access to all API functionalities with emphasis on consistency and usability.
Description
This client is compatible with python = "^3.9"
and aims to mirror the Nova Poshta API's endpoints, offering a 1:1
mapping where possible. However, users should be aware of the inconsistencies and occasional ambiguities present in the
API. This can affect the signatures of some methods, and special attention is needed when working with endpoints like
the save method which can create different items based on the provided input.
Efforts to enhance the consistency and robustness of the client are ongoing, and future releases will focus on thorough testing and refinement of all possible parameter combinations.
Installation
The package will be available on PyPI soon. For now, it can be installed directly from the GitHub repository
pip install git+https://github.com/semolex/novaposhta-python-client
Usage
Here's a basic example of how to use the client:
from novaposhta.client import NovaPoshtaApi
# Instantiate the client
client = NovaPoshtaApi('my-api-token', timeout=30)
# Example usage of different models
settlements = client.address.search_settlements(city_name='Київ', limit=5)
my_pack_list = client.common.get_pack_list(length=1, width=5)
return_reason = client.additional_service.get_return_reasons()
# Print results
print(settlements, my_pack_list, return_reason)
Extending the Client
Custom HTTP Client
While httpx
is the default HTTP library, you can easily substitute it with requests or another library, provided it
follows the same interface:
from novaposhta.client import NovaPoshtaApi
import my_http_client
client = NovaPoshtaApi('my-api-token', http_client=my_http_client.Client())
Custom client should support context manager, e.g:
with self.http_client() as client:
response = client.post(
self.api_endpoint, json=request, headers=HEADERS, timeout=self.timeout
)
Adding New Methods
If a method isn’t implemented, or you prefer a custom implementation, extend the model as shown below:
from novaposhta.models.base import BaseModel, api_method
class MyCustomModel(BaseModel):
@api_method('MissingMethod')
def missing_method(self, some_param: str):
return self._call_with_props(SomeParam=some_param)
The client caches all model instances. To reset and create a new model instance, use the new method:
from novaposhta.client import NovaPoshtaApi
from novaposhta.models.address import Address
client = NovaPoshtaApi('my-api-token')
address = client.new(Address)
To get your custom model instance, use the get method:
my_custom_model = client.get(MyCustomModel.name)
Testing and linting
poetry run black novaposhta
poetry run mypy novaposhta/
poetry run pytest tests/
Contributing
We welcome contributions that can help in enhancing the functionality and improving the consistency of the client. For bugs or feature requests, please open an issue on the GitHub repository.
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
Built Distribution
Hashes for novaposhta_python_client-0.1.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | df27331e93c18fbae99e35e660b8d2300ce835903e5a628f4417e8f835fcc32e |
|
MD5 | 2c3425be0bd2d95c0ca48fe750815f38 |
|
BLAKE2b-256 | a7c1e00733516471a471e31290ec7ddc93839c5b5f47fcbcfd0ef62d354556ea |
Hashes for novaposhta_python_client-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0ee1d339e50e3f57b0e681c16ec017527cec4eda2d97d71f91bd527268d40cb9 |
|
MD5 | 8b1f9d4c9ee739f270afac7506e96875 |
|
BLAKE2b-256 | b0692ab664fc62f02658694c9289c44af48e5211d3612001de08feb7b80d900e |