tma-functions 0.1.0

Helper functions for Telegram Mini Apps.

Telegram Mini App Helpers

A Python package with helper functions for Telegram Mini Apps.

Features

• Validates initData from Telegram Mini Apps.
• Modern Python packaging using pyproject.toml
• Type hints and static type checking with mypy
• Code formatting and linting with Ruff
• Comprehensive testing setup
• GitHub Actions for CI/CD

Installation

pip install tma-functions

Usage

from tma_functions.auth import validate_auth_data

# Example usage for auth data validation
bot_token = "YOUR_BOT_TOKEN"
auth_data = "auth_date=1678886400\nhash=YOUR_HASH\nquery_id=YOUR_QUERY_ID\nuser={\"id\":123,\"first_name\":\"John\",\"last_name\":\"Doe\",\"username\":\"john_doe\",\"language_code\":\"en\",\"allows_write_to_pm\":true,\"photo_url\":\"https://example.com/photo.jpg\"}"

is_valid = validate_auth_data(bot_token, auth_data)
print(f"Auth data valid: {is_valid}")

Development

This project uses modern Python development tools:

• Hatch for project management
• Ruff for linting and formatting
• mypy for static type checking
• pytest for testing

Setup Development Environment

1. Install development dependencies:

pip install -e ".[dev]"

2. Run tests:

pytest

3. Run type checking:

mypy .

4. Run linting:

ruff check .

License

This project is licensed under the MIT License - see the LICENSE file for details.