Metadata-Version: 2.4
Name: telegram-webapp-auth
Version: 3.0.7
Summary: Python package that implements Telegram Mini Apps authentication algorithms.
License-Expression: MIT
License-File: LICENSE
Keywords: Telegram,Telegram Mini Apps,Telegram Bot,Poetry
Author: Dmitry Vasiliev
Author-email: contact.vasiliev.dmitry@gmail.com
Maintainer: Dmitry Vasiliev
Maintainer-email: contact.vasiliev.dmitry@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Security
Requires-Dist: cryptography (>=44)
Project-URL: Bug Tracker, https://github.com/swimmwatch/telegram-webapp-auth/issues
Project-URL: Documentation, https://swimmwatch.github.io/telegram-webapp-auth/
Project-URL: Homepage, https://pypi.org/project/telegram-webapp-auth/
Project-URL: Repository, https://github.com/swimmwatch/telegram-webapp-auth
Description-Content-Type: text/markdown

# telegram-webapp-auth

<!-- markdownlint-disable -->
![telegram-webapp-auth](https://socialify.git.ci/swimmwatch/telegram-webapp-auth/image?description=1&font=Raleway&language=1&name=1&owner=1&pattern=Brick%20Wall&theme=Dark)

<div align="center">
  <p>
    <a href="https://github.com/telegram-mini-apps-dev/awesome-telegram-mini-apps">
      <img src="https://awesome.re/mentioned-badge.svg" alt="Mentioned in Awesome Telegram Mini Apps">
    </a>
    <a href="https://pypi.org/project/telegram-webapp-auth">
        <img src="https://img.shields.io/pypi/v/telegram-webapp-auth.svg" alt="PyPI">
    </a>
    <a href="pyproject.toml">
        <img src="https://img.shields.io/pypi/pyversions/telegram-webapp-auth" alt="Supported Python Versions">
    </a>
    <br/>
    <a href="LICENSE">
        <img src="https://img.shields.io/github/license/swimmwatch/telegram-webapp-auth" alt="License">
    </a>
    <a href="https://github.com/ambv/black">
        <img src="https://img.shields.io/badge/code%20style-black-black" alt="Code style">
    </a>
    <a href="https://github.com/pycqa/flake8">
        <img src="https://img.shields.io/badge/lint-flake8-black" alt="Linter">
    </a>
    <a href="https://github.com/python/mypy">
        <img src="https://img.shields.io/badge/type%20checker-mypy-black" alt="Type checker">
    </a>
    <a href="https://snyk.io/advisor/python/telegram-webapp-auth">
        <img src="https://snyk.io/advisor/python/telegram-webapp-auth/badge.svg" alt="Package health">
    </a>
    <br/>
    <a href="https://github.com/swimmwatch/telegram-webapp-auth/actions/workflows/python-check.yml">
        <img src="https://github.com/swimmwatch/telegram-webapp-auth/actions/workflows/python-check.yml/badge.svg" alt="Tests">
    </a>
    <a href="https://codecov.io/github/swimmwatch/telegram-webapp-auth" target="_blank">
        <img src="https://codecov.io/github/swimmwatch/telegram-webapp-auth/graph/badge.svg?token=M638BMDY5V" alt="Coverage">
    </a>
    <a href="https://github.com/swimmwatch/telegram-webapp-auth/actions/workflows/release.yml">
        <img src="https://github.com/swimmwatch/telegram-webapp-auth/actions/workflows/release.yml/badge.svg" alt="Release">
    </a>
    <a href="https://github.com/swimmwatch/telegram-webapp-auth/actions/workflows/docs.yml">
        <img src="https://github.com/swimmwatch/telegram-webapp-auth/actions/workflows/docs.yml/badge.svg" alt="Docs">
    </a>
  </p>
</div>
<!-- markdownlint-enable -->

This Python package implements [Telegram Mini Apps authentication algorithms](https://core.telegram.org/bots/webapps#validating-data-received-via-the-mini-app).
It is designed to be simple and easy to use, providing a straightforward way to authenticate users in Telegram Mini Apps.

## Features
- **Easy to use**: The package is designed to be simple and intuitive, making it easy to integrate into your Telegram Mini App.
- **Secure**: It implements the authentication algorithms as described in the Telegram Mini Apps documentation, ensuring that your app's authentication is secure.
- **Lightweight**: The package is small, making it easy to include in your project without adding unnecessary bloat.
- **Type hints**: The package is fully typed, providing better code completion and type checking in your IDE.
- **Well-documented**: The package comes with comprehensive documentation, making it easy to understand how to use it effectively.
- **Tested**: The package includes unit tests to ensure that it works correctly and reliably.
- **Supports Python 3.10+**: The package is compatible with Python 3.10 and later versions, ensuring that it works with modern Python environments.
- **Open source**: The package is open source and licensed under the MIT License, allowing you to use it freely in your projects.


## Requirements
- Python 3.10 or later

## Installation
```bash
pip install telegram-webapp-auth
# or
poetry add telegram-webapp-auth
# or
uv add telegram-webapp-auth
```

## Documentation
For detailed documentation, please visit the [telegram-webapp-auth documentation](https://swimmwatch.github.io/telegram-webapp-auth/).

## License
`telegram-webapp-auth` is licensed under the [MIT License](LICENSE).

