fix: update Python version requirements to support 3.10 and adjust CI workflow

.github/workflows/ci.yml

@@ -33,7 +33,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11", "3.12"] 
+        python-version: ["3.10", "3.11", "3.12"] # 3.13, 3.14 are not supported by some dependencies yet
 
     steps:
       - uses: actions/checkout@v6.0.2

README.md

@@ -9,7 +9,7 @@
 
 [![PyPI version](https://img.shields.io/pypi/v/pyfragment?style=flat&color=blue)](https://pypi.org/project/pyfragment/)
 [![PyPI downloads](https://img.shields.io/pypi/dm/pyfragment?style=flat&color=brightgreen)](https://pypi.org/project/pyfragment/)
-[![Python](https://img.shields.io/badge/Python-3.12+-3776AB?style=flat&logo=python&logoColor=white)](https://python.org)
+[![Python](https://img.shields.io/badge/Python-3.10+-3776AB?style=flat&logo=python&logoColor=white)](https://python.org)
 [![License](https://img.shields.io/github/license/bohd4nx/pyfragment?style=flat&color=lightgrey)](LICENSE)
 [![Stars](https://img.shields.io/github/stars/bohd4nx/pyfragment?style=flat&color=yellow)](https://github.com/bohd4nx/pyfragment/stargazers)
 [![CI](https://img.shields.io/github/actions/workflow/status/bohd4nx/pyfragment/ci.yml?style=flat&label=tests&logo=github)](https://github.com/bohd4nx/pyfragment/actions)
@@ -34,7 +34,7 @@ To install the latest unreleased changes from the `dev` branch:
 pip install git+https://github.com/bohd4nx/pyfragment.git@dev
 ```
 
-Requires Python 3.12+.
+Requires Python 3.10+.
 
 ---
 

pyfragment/client.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import json
 from typing import Any, cast
 

pyfragment/methods/anonymous_number.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import html
 from typing import TYPE_CHECKING
 

pyfragment/methods/giveaway_premium.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import json
 from typing import TYPE_CHECKING
 

pyfragment/methods/giveaway_stars.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import json
 from typing import TYPE_CHECKING
 

pyfragment/methods/purchase_premium.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import json
 import time
 from typing import TYPE_CHECKING

pyfragment/methods/purchase_stars.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import json
 from typing import TYPE_CHECKING
 

pyfragment/methods/recharge_ads.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import json
 from typing import TYPE_CHECKING
 

pyfragment/methods/search_gifts.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from typing import TYPE_CHECKING, Any
 
 from pyfragment.types import FragmentAPIError, FragmentError, GiftsResult, UnexpectedError

pyfragment/methods/search_numbers.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from typing import TYPE_CHECKING, Any
 
 from pyfragment.types import FragmentAPIError, FragmentError, NumbersResult, UnexpectedError

pyfragment/methods/search_usernames.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from typing import TYPE_CHECKING, Any
 
 from pyfragment.types import FragmentAPIError, FragmentError, UnexpectedError, UsernamesResult

pyfragment/methods/topup_ton.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import json
 from typing import TYPE_CHECKING
 

pyfragment/types/constants.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import json
 from typing import Any, Literal, get_args
 

pyfragment/types/exceptions.py

@@ -1,3 +1,6 @@
+from __future__ import annotations
+
+
 class FragmentError(Exception):
     """Base exception for all pyfragment library errors."""
 

pyfragment/types/results.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from dataclasses import dataclass
 from typing import Any
 

pyfragment/utils/decoder.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import base64
 
 from ton_core import Cell

pyfragment/utils/html.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import re
 from typing import Any
 

pyfragment/utils/http.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import re
 from typing import Any
 

pyfragment/utils/wallet.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import asyncio
 import base64
 import ssl

pyproject.toml

@@ -8,7 +8,7 @@ version = "2026.2.0"
 description = "Async Python client for the Fragment API — a unified toolkit to manage Telegram assets: purchase Stars and Premium, top up TON and Ads balances, run giveaways, manage anonymous numbers, and explore the marketplace for usernames, numbers, and gifts."
 readme = "README.md"
 license = { text = "MIT" }
-requires-python = ">=3.12"
+requires-python = ">=3.10"
 authors = [{ name = "bohd4nx", url = "https://github.com/bohd4nx" }]
 keywords = ["fragment", "telegram", "ton", "stars", "premium", "crypto", "blockchain"]
 classifiers = [
@@ -18,6 +18,8 @@ classifiers = [
     "Natural Language :: English",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Framework :: AsyncIO",
     "Topic :: Software Development :: Libraries :: Python Modules",