UssdFlow is a dynamic and robust Python library designed to simplify the creation, management, and serving of USSD menus. Integrating seamlessly with Africa's Talking USSD implementation and utilizing Redis for efficient caching, UssdFlow aims to provide developers with a powerful tool to build interactive and responsive USSD applications.
- Dynamic Menu Creation: Easily define and manage USSD menus with dynamic content and options.
- Seamless Integration: Integrates directly with Africa's Talking USSD gateway for reliable and scalable USSD services.
- Efficient Caching: Leverages Redis for high-performance caching, ensuring quick and efficient session management.
- User Session Management: Handles user sessions effectively, tracking user progress through the USSD menus.
- Flexible Configuration: Offers flexible configuration options to tailor the USSD experience to specific needs.
- Error Handling: Robust error handling ensures smooth user interactions even when issues arise.
Installation To install UssdFlow, simply use pip:
pip install ussdflowHere’s a quick example to get you started with UssdFlow:
from ussdflow import CacheManager, IngressData, USSDService
# Initialize the cache manager
cache_manager = CacheManager(cache_type="redis", host="localhost", port=6379)
# Initialize the USSD service
ussd_service = USSDService(
menu_file_path="path/to/your/menu.json",
cache_manager=cache_manager
)
# Sample USSD request
request = IngressData(
session_id="1234",
service_code="*123#",
phone_number="254712345678",
text=""
)
# Process the request
response = ussd_service.ingress(request)
print(response)We welcome contributions to UssdFlow! If you have suggestions, bug reports, or want to contribute code, please check our Contributing Guidelines.
UssdFlow is licensed under the MIT License. See the LICENSE file for more details.
By following this documentation, you should be able to integrate UssdFlow with Flask, FastAPI, and Django to create, manage, and serve USSD menus efficiently.