contactsmanager 1.2.2

Python SDK for ContactsManager API authentication and token generation

ContactsManager Python SDK

A Python SDK for the ContactsManager API that handles authentication and token generation.

Installation

pip install contactsmanager

Usage

from contactsmanager import ContactsManagerClient

# Initialize the client
client = ContactsManagerClient(
    api_key="your_api_key",
    api_secret="your_api_secret",
    org_id="your_org_id"
)

# Generate a token for a user
token_response = client.generate_token(
    user_id="user123",
    device_info={  # Optional
        "device_type": "mobile",
        "os": "iOS",
        "app_version": "1.0.0"
    }
)

print(f"Token: {token_response['token']}")
print(f"Expires at: {token_response['expires_at']}")

Features

• Simple API for generating JWT tokens
• Type hints for better IDE support
• Comprehensive test coverage
• Support for custom token expiration

Advanced Usage

Custom Token Expiration

By default, tokens expire after 24 hours (86400 seconds). You can customize this:

# Generate a token that expires in 1 hour
token_response = client.generate_token(
    user_id="user123",
    expiration_seconds=3600  # 1 hour
)

Requirements

• Python 3.8+
• PyJWT>=2.0.0

Development

Setting up development environment

# Clone the repository
git clone https://github.com/arpwal/contactmanager.git
cd contactmanager/sdk/py

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

Running Integration Tests

Integration tests validate the SDK against real-world scenarios, including server-side API key validation.

Local Setup

1. Create a .env file with your test configuration:

   # Copy the template file
   cp env.template .env
   
   # Edit the .env file with your credentials
   # The configuration is a JSON string in the TEST_CONFIG variable
   TEST_CONFIG='{"api_key":"your_api_key","api_secret":"your_api_secret","org_id":"your_org_id","api_base_url":"https://api.contactsmanager.io"}'
   

2. Run the integration tests:

   ./run_integration_tests.sh
   

Releasing new versions

The SDK uses an automated process for releases:

1. Update the version in contactsmanager/__init__.py using the provided script:

   ./bump_version.sh 0.1.1
   

2. Commit and push the change to the main branch:

   git add contactsmanager/__init__.py
   git commit -m "Bump version to 0.1.1"
   git push origin main
   

3. The GitHub Actions workflow will:

   • Run all tests across multiple Python versions
   • Run integration tests
   • Create a new GitHub release with the version tag
   • Build and publish the package to PyPI

Alternatively, you can manually create a new release by:

1. Creating and pushing a git tag:

   git tag -a v0.1.1 -m "Release version 0.1.1"
   git push origin v0.1.1
   

2. The GitHub Actions workflow will handle the rest

License

MIT License