django-commflex 1.0.1

Django Commflex Library

A flexible and reliable Django library for sending SMS messages through multiple providers with built-in retry capabilities.

Key Features

• Multiple SMS provider support (AWS SNS and AIT)

• Automatic phone number validation

• Configurable retry mechanism with exponential backoff

Quick Start

1. Install the package:

   pip install django-commflex

2. Add “django-double-commflex” to your INSTALLED_APPS setting:

   INSTALLED_APPS = [
       ...
       'commflex',
   ]

3. Add SMS settings to your Django settings:

   SMS_SETTINGS = {
       'aws': {
           'access_key': 'your-access-key',
           'secret_access_key': 'your-secret-key',
           'region': 'aws-region',
           'enabled': True,
           'timeout': 30,
       },
       'ait': {
        'username': 'your-username',
        'api_key': 'your-api-key',
        'sms_url': 'https://api.ait-provider.com/sms',
        'sender_id': 'YOUR_SENDER_ID',
        'enabled': False,
        'timeout': 30,  # Optional, defaults to 30 seconds
        }
   }

3. Send an SMS:

   from commflex.sms import send_sms
   send_sms(phone_number, message)

Supported Providers

Testing

Run the test suite:

python -m pytest

For development, install test dependencies:

pip install -e ".[test]"

Documentation

https://django-commflex.readthedocs.io/en/latest/index.html