ploomes-api-client 0.2.138

Description:

ploomesapiclient 0.2.138

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": "[email protected]",
"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.