Python client for the Ploomes API
Project description
Ploomes API Python Client
This package provides a simple Python client for interacting with the Ploomes API, designed with rate-limiting and exponential backoff strategies for improved resilience.
Installation
You can install the package from PyPI:
pip install ploomes-api-client
Basic Usage
Contact Management
To manage contacts, first import the necessary classes and initialize them:
from ploomes_client import PloomesClient as Ploomes
from ploomes_client.collections.contacts import Contacts
Initialize PloomesClient and Contacts Class
ploomes = Ploomes(api_key='your_api_key_here')
contacts = Contacts(ploomes)
Creating a New Contact with Expanded Fields
Here is a synthetic example to demonstrate how to create a new contact with expanded Phones
and OtherProperties
:
# Define the payload for the new contact
payload = {
"Name": "Jane Doe",
"Email": "janedoe@example.com",
"Phones": [
{"PhoneNumber": "1234567890", "Type": "Mobile"}
],
"OtherProperties": {"FavoriteColor": "Blue", "Occupation": "Engineer"}
}
# Create the contact
response_json = contacts.post_contact(payload, expand="Phones,OtherProperties")
In this example, the post_contact
method sends a POST request to create a new contact in Ploomes. The payload
dictionary contains the data for the new contact, including fields like Name
, Email
, Phones
, and OtherProperties
. We also use the expand
parameter to expand the Phones
and OtherProperties
fields.
By default, the post_contact
method will return a JSON-formatted string as the response.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Uploading to PyPI with Two-Factor Authentication
-
Generate an API token for your PyPI account:
- Go to the PyPI account settings page and log in.
- Scroll down to the "API Tokens" section and click "Add API Token."
- Provide a description for the token and click "Generate."
- Copy the generated token.
-
Upload your package using the API token:
-
Open your terminal.
-
Navigate to your package directory.
-
Build the distribution files:
python setup.py sdist bdist_wheel
-
Upload the distribution files using the
twine
tool and the generated API token:twine upload --verbose dist/* -u __token__ -p <API_TOKEN>
Replace
<API_TOKEN>
with the copied API token. -
-
Verify the upload:
- Check the PyPI project page to ensure your new version is listed.
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 ploomes-api-client-0.2.116.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 48d8785b52cf3c9b7eb2b5ea3755d925a34e4fab71d1332aedec5c183052b93c |
|
MD5 | 5cecdfa9fc8e6a815fe494878a963c82 |
|
BLAKE2b-256 | ce3c5a9e9ee3d88dc6714087f4da3efafd97d3342b488618413903dd3780444a |
Hashes for ploomes_api_client-0.2.116-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 92b62d20b5ebeba4bc308cc0e69ca79a1fd2b83609e5bc6a32986131e010f710 |
|
MD5 | e6f0f1ee2a88f135643ad4d604d8a5d9 |
|
BLAKE2b-256 | 976e65404ea4086fcc76bc40f8a04071e0cb1f0c9211cfd63d6b7b07c370e6c8 |