pytonapi 2.0.0__tar.gz → 2.0.1__tar.gz

{pytonapi-2.0.0/pytonapi.egg-info → pytonapi-2.0.1}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: pytonapi
-Version: 2.0.0
+Version: 2.0.1
 Summary: Python SDK for TONAPI — REST API, streaming, and webhooks for TON blockchain.
 Author: nessshon
 Maintainer: nessshon
 License-Expression: MIT
-Project-URL: Homepage, https://github.com/nessshon/pytonapi/
-Project-URL: Examples, https://github.com/nessshon/pytonapi/tree/main/examples/
+Project-URL: Homepage, https://github.com/nessshon/tonapi/
+Project-URL: Examples, https://github.com/nessshon/tonapi/tree/main/examples/
 Keywords: AsyncIO,REST API,SDK,TON,TON blockchain,TONAPI,The Open Network,blockchain,crypto,streaming,webhooks
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
@@ -32,10 +32,10 @@ Dynamic: license-file
 [![TON](https://img.shields.io/badge/TON-grey?logo=TON&logoColor=40AEF0)](https://ton.org)
 ![Python Versions](https://img.shields.io/badge/Python-3.10%20--%203.14-black?color=FFE873&labelColor=3776AB)
 [![PyPI](https://img.shields.io/pypi/v/pytonapi.svg?color=FFE873&labelColor=3776AB)](https://pypi.python.org/pypi/pytonapi)
-[![License](https://img.shields.io/github/license/nessshon/pytonapi)](https://github.com/nessshon/pytonapi/blob/main/LICENSE)
+[![License](https://img.shields.io/github/license/nessshon/tonapi)](https://github.com/nessshon/tonapi/blob/main/LICENSE)
 [![Donate](https://img.shields.io/badge/Donate-TON-blue)](https://tonviewer.com/UQCZq3_Vd21-4y4m7Wc-ej9NFOhh_qvdfAkAYAOHoQ__Ness)
 
-![Image](assets/banner.png)
+![Image](https://raw.githubusercontent.com/nessshon/tonapi/main/assets/banner.png)
 
 ![Downloads](https://pepy.tech/badge/pytonapi)
 ![Downloads](https://pepy.tech/badge/pytonapi/month)
@@ -43,8 +43,8 @@ Dynamic: license-file
 
 ### Python SDK for [TONAPI](https://tonapi.io)
 
-Providing access to TON blockchain data via REST API, real-time streaming, and webhooks.  
-An API key is required and can be obtained at [tonconsole.com](https://tonconsole.com/). Documentation available
+Access TON blockchain data via REST API, real-time streaming, and webhooks.
+API key required — obtain at [tonconsole.com](https://tonconsole.com/), docs
 at [docs.tonconsole.com](https://docs.tonconsole.com/).
 
 > For creating wallets, transferring TON, jettons, etc., use [tonutils](https://github.com/nessshon/tonutils).
@@ -55,8 +55,8 @@ at [docs.tonconsole.com](https://docs.tonconsole.com/).
 - **Streaming** — real-time events via SSE and WebSocket
 - **Webhooks** — push notifications with event dispatcher
 
-> If this project has been useful to you, consider supporting its development.  
-> **TON**: `UQCZq3_Vd21-4y4m7Wc-ej9NFOhh_qvdfAkAYAOHoQ__Ness`
+> Support this project — TON: `donate.ness.ton`  
+> `UQCZq3_Vd21-4y4m7Wc-ej9NFOhh_qvdfAkAYAOHoQ__Ness`
 
 ## Installation
 
@@ -68,30 +68,26 @@ pip install pytonapi
 
 **REST API**
 
-- [Get account info](examples/get_account_info.py)
-- [Get account transactions](examples/get_account_transactions.py)
-- [Get NFTs by owner](examples/get_nft_by_owner.py)
-- [Get NFTs by collection](examples/get_nft_by_collection.py)
+- [Get account info](https://github.com/nessshon/tonapi/blob/main/examples/get_account_info.py)
+- [Get account transactions](https://github.com/nessshon/tonapi/blob/main/examples/get_account_transactions.py)
+- [Get NFTs by owner](https://github.com/nessshon/tonapi/blob/main/examples/get_nft_by_owner.py)
+- [Get NFTs by collection](https://github.com/nessshon/tonapi/blob/main/examples/get_nft_by_collection.py)
 
 **Streaming** (SSE & WebSocket)
 
-- [SSE subscriptions](examples/streaming_sse.py)
-- [WebSocket subscriptions](examples/streaming_websocket.py)
+- [SSE subscriptions](https://github.com/nessshon/tonapi/blob/main/examples/streaming_sse.py)
+- [WebSocket subscriptions](https://github.com/nessshon/tonapi/blob/main/examples/streaming_websocket.py)
 
 **Webhooks**
 
-- [FastAPI webhook server](examples/webhook_fastapi.py)
-- [aiohttp webhook server](examples/webhook_aiohttp.py)
+- [FastAPI webhook server](https://github.com/nessshon/tonapi/blob/main/examples/webhook_fastapi.py)
+- [aiohttp webhook server](https://github.com/nessshon/tonapi/blob/main/examples/webhook_aiohttp.py)
 
 **Transfers** (requires [tonutils](https://github.com/nessshon/tonutils))
 
-- [Transfer TON](examples/transfer_ton.py)
-- [Gasless transfer](examples/transfer_gasless.py)
-
-## Support
-
-Supported by [TON Society](https://github.com/ton-society/grants-and-bounties) and [TONAPI](https://tonapi.io).
+- [Transfer TON](https://github.com/nessshon/tonapi/blob/main/examples/transfer_ton.py)
+- [Gasless transfer](https://github.com/nessshon/tonapi/blob/main/examples/transfer_gasless.py)
 
 ## License
 
-This repository is distributed under the [MIT License](LICENSE).
+This repository is distributed under the [MIT License](https://github.com/nessshon/tonapi/blob/main/LICENSE).

pytonapi-2.0.1/README.md

@@ -0,0 +1,64 @@
+# 📦 PyTONAPI
+
+[![TON](https://img.shields.io/badge/TON-grey?logo=TON&logoColor=40AEF0)](https://ton.org)
+![Python Versions](https://img.shields.io/badge/Python-3.10%20--%203.14-black?color=FFE873&labelColor=3776AB)
+[![PyPI](https://img.shields.io/pypi/v/pytonapi.svg?color=FFE873&labelColor=3776AB)](https://pypi.python.org/pypi/pytonapi)
+[![License](https://img.shields.io/github/license/nessshon/tonapi)](https://github.com/nessshon/tonapi/blob/main/LICENSE)
+[![Donate](https://img.shields.io/badge/Donate-TON-blue)](https://tonviewer.com/UQCZq3_Vd21-4y4m7Wc-ej9NFOhh_qvdfAkAYAOHoQ__Ness)
+
+![Image](https://raw.githubusercontent.com/nessshon/tonapi/main/assets/banner.png)
+
+![Downloads](https://pepy.tech/badge/pytonapi)
+![Downloads](https://pepy.tech/badge/pytonapi/month)
+![Downloads](https://pepy.tech/badge/pytonapi/week)
+
+### Python SDK for [TONAPI](https://tonapi.io)
+
+Access TON blockchain data via REST API, real-time streaming, and webhooks.
+API key required — obtain at [tonconsole.com](https://tonconsole.com/), docs
+at [docs.tonconsole.com](https://docs.tonconsole.com/).
+
+> For creating wallets, transferring TON, jettons, etc., use [tonutils](https://github.com/nessshon/tonutils).
+
+**Features**
+
+- **REST API** — accounts, NFTs, jettons, DNS, and more
+- **Streaming** — real-time events via SSE and WebSocket
+- **Webhooks** — push notifications with event dispatcher
+
+> Support this project — TON: `donate.ness.ton`  
+> `UQCZq3_Vd21-4y4m7Wc-ej9NFOhh_qvdfAkAYAOHoQ__Ness`
+
+## Installation
+
+```bash
+pip install pytonapi
+```
+
+## Examples
+
+**REST API**
+
+- [Get account info](https://github.com/nessshon/tonapi/blob/main/examples/get_account_info.py)
+- [Get account transactions](https://github.com/nessshon/tonapi/blob/main/examples/get_account_transactions.py)
+- [Get NFTs by owner](https://github.com/nessshon/tonapi/blob/main/examples/get_nft_by_owner.py)
+- [Get NFTs by collection](https://github.com/nessshon/tonapi/blob/main/examples/get_nft_by_collection.py)
+
+**Streaming** (SSE & WebSocket)
+
+- [SSE subscriptions](https://github.com/nessshon/tonapi/blob/main/examples/streaming_sse.py)
+- [WebSocket subscriptions](https://github.com/nessshon/tonapi/blob/main/examples/streaming_websocket.py)
+
+**Webhooks**
+
+- [FastAPI webhook server](https://github.com/nessshon/tonapi/blob/main/examples/webhook_fastapi.py)
+- [aiohttp webhook server](https://github.com/nessshon/tonapi/blob/main/examples/webhook_aiohttp.py)
+
+**Transfers** (requires [tonutils](https://github.com/nessshon/tonutils))
+
+- [Transfer TON](https://github.com/nessshon/tonapi/blob/main/examples/transfer_ton.py)
+- [Gasless transfer](https://github.com/nessshon/tonapi/blob/main/examples/transfer_gasless.py)
+
+## License
+
+This repository is distributed under the [MIT License](https://github.com/nessshon/tonapi/blob/main/LICENSE).

pytonapi-2.0.1/pyproject.toml

@@ -0,0 +1,155 @@
+[build-system]
+requires = ["setuptools>=80"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pytonapi"
+description = "Python SDK for TONAPI — REST API, streaming, and webhooks for TON blockchain."
+requires-python = ">=3.10,<3.15"
+authors = [
+    { name = "nessshon" },
+]
+maintainers = [
+    { name = "nessshon" },
+]
+dependencies = [
+    "aiohttp>=3.9.0",
+    "pydantic>=2.4.1,<3.0",
+]
+keywords = [
+    "AsyncIO",
+    "REST API",
+    "SDK",
+    "TON",
+    "TON blockchain",
+    "TONAPI",
+    "The Open Network",
+    "blockchain",
+    "crypto",
+    "streaming",
+    "webhooks",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Framework :: AsyncIO",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Financial and Insurance Industry",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dynamic = ["version"]
+readme = "README.md"
+license = "MIT"
+
+[project.scripts]
+pytonapi = "pytonapi.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/nessshon/tonapi/"
+Examples = "https://github.com/nessshon/tonapi/tree/main/examples/"
+
+[tool.setuptools.packages.find]
+include = ["pytonapi", "pytonapi.*"]
+
+[tool.setuptools.package-data]
+pytonapi = ["py.typed"]
+
+[tool.setuptools.dynamic]
+version = { attr = "pytonapi.__meta__.__version__" }
+
+[tool.ruff]
+target-version = "py310"
+line-length = 120
+
+[tool.ruff.lint]
+select = [
+    # pydocstyle
+    "D",
+    # pycodestyle
+    "E",
+    "W",
+    # pyflakes
+    "F",
+    # isort
+    "I",
+    # flake8-bugbear
+    "B",
+    # flake8-comprehensions
+    "C4",
+    # pyupgrade
+    "UP",
+    # flake8-simplify
+    "SIM",
+    # type-checking imports
+    "TCH",
+    # perflint
+    "PERF",
+    # flake8-debugger
+    "T10",
+    # flake8-print
+    "T20",
+    # flake8-pie
+    "PIE",
+    # pylint errors
+    "PLE",
+    # flake8-return
+    "RET",
+    # ruff-specific
+    "RUF",
+]
+ignore = [
+    # line too long
+    "E501",
+    # docstring in public module
+    "D100",
+    # docstring in public package
+    "D104",
+    # docstring in magic method
+    "D105",
+    # docstring in __init__
+    "D107",
+    # blank line before class docstring (conflicts D211)
+    "D203",
+    # multi-line summary second line (conflicts D212)
+    "D213",
+    # first word capitalization (false positive for proper nouns like dApp)
+    "D403",
+    # type-checking import (false positive for Pydantic models)
+    "TC001",
+    "TC002",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"__init__.py" = ["F401"]
+"pytonapi/rest/models/*" = ["D101"]
+"tests/*" = ["D101", "D102", "T20"]
+"codegen/*" = ["T20"]
+"examples/*" = ["D", "T20", "RUF006", "RUF059"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["pytonapi"]
+
+[tool.ruff.format]
+quote-style = "double"
+
+[tool.mypy]
+plugins = ["pydantic.mypy"]
+python_version = "3.10"
+strict = true
+pretty = true
+show_error_codes = true
+show_error_context = true
+namespace_packages = true
+follow_imports_for_stubs = true
+warn_unreachable = true
+enable_error_code = [
+    "ignore-without-code",
+    "redundant-cast",
+    "truthy-bool",
+]

pytonapi-2.0.1/pytonapi/__init__.py

@@ -0,0 +1 @@
+

pytonapi-2.0.0/pytonapi/__init__.py → pytonapi-2.0.1/pytonapi/__meta__.py

@@ -3,11 +3,6 @@
 # This source code is licensed under the MIT License found in the
 # LICENSE file in the root directory of this source tree.
 
-
-__all__ = [
-    "__uri__",
-    "__version__",
-]
-
-__version__ = "2.0.0"
-__uri__ = "https://github.com/nessshon/pytonapi"
+__version__ = "2.0.1"
+__author__ = "nessshon"
+__url__ = "https://github.com/nessshon/tonapi"

{pytonapi-2.0.0 → pytonapi-2.0.1}/pytonapi/cli.py

@@ -1,6 +1,6 @@
 import argparse
 
-from pytonapi import __version__
+from pytonapi.__meta__ import __version__
 
 
 def main() -> None:
@@ -16,7 +16,6 @@ def main() -> None:
         version=f"pytonapi {__version__}",
     )
     parser.parse_args()
-    parser.print_help()
 
 
 if __name__ == "__main__":

{pytonapi-2.0.0 → pytonapi-2.0.1}/pytonapi/client.py

@@ -32,10 +32,10 @@ class BaseClient:
         base_url: str,
         *,
         timeout: float = 10.0,
-        session: t.Optional[aiohttp.ClientSession] = None,
-        headers: t.Optional[t.Dict[str, str]] = None,
-        cookies: t.Optional[t.Dict[str, str]] = None,
-        retry_policy: t.Optional[RetryPolicy] = DEFAULT_RETRY_POLICY,
+        session: aiohttp.ClientSession | None = None,
+        headers: dict[str, str] | None = None,
+        cookies: dict[str, str] | None = None,
+        retry_policy: RetryPolicy | None = DEFAULT_RETRY_POLICY,
     ) -> None:
         """Initialize the base HTTP client.
 
@@ -55,7 +55,7 @@ class BaseClient:
         self._headers = headers or {}
         self._cookies = cookies or {}
         self._timeout = aiohttp.ClientTimeout(total=timeout)
-        self._session: t.Optional[aiohttp.ClientSession] = session
+        self._session: aiohttp.ClientSession | None = session
 
         self._is_external_session = session is not None
         self._retry_policy = retry_policy
@@ -94,14 +94,14 @@ class BaseClient:
 
     async def __aexit__(
         self,
-        exc_type: t.Optional[t.Type[BaseException]],
-        exc_val: t.Optional[BaseException],
-        exc_tb: t.Optional[t.Any],
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: t.Any | None,
     ) -> None:
         """Exit the async context manager."""
         await self.close_session()
 
-    def _build_headers(self) -> t.Dict[str, str]:
+    def _build_headers(self) -> dict[str, str]:
         """Build default request headers.
 
         :return: Merged headers dict.
@@ -114,7 +114,7 @@ class BaseClient:
         return base
 
     @staticmethod
-    def _parse_body(text: str) -> t.Tuple[t.Any, str]:
+    def _parse_body(text: str) -> tuple[t.Any, str]:
         """Parse response text and extract error message.
 
         :param text: Raw response text.
@@ -122,7 +122,7 @@ class BaseClient:
         """
         try:
             data = json.loads(text)
-        except (json.JSONDecodeError,):
+        except json.JSONDecodeError:
             return None, text
 
         if isinstance(data, dict):
@@ -133,16 +133,40 @@ class BaseClient:
 
         return data, str(data)
 
+    @t.overload
     async def request(
         self,
         method: str,
         path: str,
         *,
-        params: t.Optional[t.Dict[str, t.Any]] = None,
-        body: t.Optional[t.Any] = None,
-        headers: t.Optional[t.Dict[str, t.Any]] = None,
-        response_model: t.Optional[t.Type[T]] = None,
-    ) -> t.Any:
+        params: dict[str, t.Any] | None = None,
+        body: t.Any | None = None,
+        headers: dict[str, t.Any] | None = None,
+        response_model: type[T],
+    ) -> T: ...
+
+    @t.overload
+    async def request(
+        self,
+        method: str,
+        path: str,
+        *,
+        params: dict[str, t.Any] | None = None,
+        body: t.Any | None = None,
+        headers: dict[str, t.Any] | None = None,
+        response_model: None = None,
+    ) -> t.Any: ...
+
+    async def request(
+        self,
+        method: str,
+        path: str,
+        *,
+        params: dict[str, t.Any] | None = None,
+        body: t.Any | None = None,
+        headers: dict[str, t.Any] | None = None,
+        response_model: type[T] | None = None,
+    ) -> T | t.Any:
         """Execute an HTTP request with retry.
 
         :param method: HTTP method (``GET``, ``POST``, etc.).
@@ -167,8 +191,8 @@ class BaseClient:
             raise TONAPISessionNotCreatedError(self.__class__.__name__)
 
         session = self._session
-        last_error: t.Optional[Exception] = None
-        last_status: t.Optional[int] = None
+        last_error: Exception | None = None
+        last_status: int | None = None
         max_attempts = 1
 
         if self._retry_policy:
@@ -207,9 +231,9 @@ class BaseClient:
                     content_type = response.headers.get("Content-Type", "")
                     raise_for_status(response.status, text, content_type)
 
-            except (TONAPIError,):
+            except TONAPIError:
                 raise
-            except (aiohttp.ClientError,) as exc:
+            except aiohttp.ClientError as exc:
                 last_error = exc
                 if attempt < max_attempts - 1:
                     await asyncio.sleep(1.0)
@@ -227,7 +251,7 @@ class BaseClient:
     async def _handle_success(
         self,
         response: aiohttp.ClientResponse,
-        response_model: t.Optional[t.Type[T]],
+        response_model: type[T] | None,
     ) -> t.Any:
         """Process a successful (2xx) response.
 

{pytonapi-2.0.0 → pytonapi-2.0.1}/pytonapi/exceptions.py

@@ -34,8 +34,7 @@ class TONAPIError(Exception):
 
 
 class TONAPIConnectionError(TONAPIError):
-    """Network-level error — DNS resolution failure, connection timeout,
-    refused connection, or other transport issues."""
+    """Network-level error (DNS failure, timeout, refused connection)."""
 
 
 class TONAPIStatusError(TONAPIError):
@@ -127,15 +126,15 @@ class TONAPIRetryLimitError(TONAPIError):
     """All retry attempts have been exhausted."""
 
     attempts: int
-    last_status: t.Optional[int]
-    last_error: t.Optional[Exception]
+    last_status: int | None
+    last_error: Exception | None
 
     def __init__(
         self,
         *,
         attempts: int,
-        last_status: t.Optional[int] = None,
-        last_error: t.Optional[Exception] = None,
+        last_status: int | None = None,
+        last_error: Exception | None = None,
     ) -> None:
         self.attempts = attempts
         self.last_status = last_status
@@ -148,13 +147,13 @@ class TONAPIRetryLimitError(TONAPIError):
         super().__init__(", ".join(parts))
 
 
-STREAMING_RECOVERABLE: t.Final[t.Tuple[t.Type[TONAPIError], ...]] = (
+STREAMING_RECOVERABLE: t.Final[tuple[type[TONAPIError], ...]] = (
     TONAPIServerError,
     TONAPITooManyRequestsError,
     TONAPIStreamingError,
 )
 
-TONAPI_STATUS_TO_EXCEPTION: t.Final[t.Dict[int, t.Type[TONAPIStatusError]]] = {
+TONAPI_STATUS_TO_EXCEPTION: t.Final[dict[int, type[TONAPIStatusError]]] = {
     400: TONAPIBadRequestError,
     401: TONAPIUnauthorizedError,
     403: TONAPIForbiddenError,
@@ -180,7 +179,7 @@ def raise_for_status(status: int, body: str, content_type: str = "") -> None:
     else:
         try:
             data = json.loads(body)
-        except (json.JSONDecodeError,):
+        except json.JSONDecodeError:
             message = body
         else:
             if isinstance(data, dict):

{pytonapi-2.0.0 → pytonapi-2.0.1}/pytonapi/rest/client.py

@@ -27,14 +27,14 @@ class TonapiRestClient(BaseClient, ResourcesMixin):
         api_key: str,
         network: Network,
         *,
-        base_url: t.Optional[str] = None,
+        base_url: str | None = None,
         timeout: float = 10.0,
-        session: t.Optional[aiohttp.ClientSession] = None,
-        headers: t.Optional[t.Dict[str, str]] = None,
-        cookies: t.Optional[t.Dict[str, str]] = None,
+        session: aiohttp.ClientSession | None = None,
+        headers: dict[str, str] | None = None,
+        cookies: dict[str, str] | None = None,
         rps_limit: int = 0,
         rps_period: float = 1.0,
-        retry_policy: t.Optional[RetryPolicy] = DEFAULT_RETRY_POLICY,
+        retry_policy: RetryPolicy | None = DEFAULT_RETRY_POLICY,
     ) -> None:
         """Initialize the TONAPI client.
 
@@ -60,7 +60,7 @@ class TonapiRestClient(BaseClient, ResourcesMixin):
             cookies=cookies,
             retry_policy=retry_policy,
         )
-        self._rate_limiter: t.Optional[RateLimiter] = (
+        self._rate_limiter: RateLimiter | None = (
             RateLimiter(rps=rps_limit, period=rps_period) if rps_limit > 0 else None
         )
         ResourcesMixin.__init__(self, self)
@@ -70,10 +70,10 @@ class TonapiRestClient(BaseClient, ResourcesMixin):
         method: str,
         path: str,
         *,
-        params: t.Optional[t.Dict[str, t.Any]] = None,
-        body: t.Optional[t.Any] = None,
-        headers: t.Optional[t.Dict[str, t.Any]] = None,
-        response_model: t.Optional[t.Type[T]] = None,
+        params: dict[str, t.Any] | None = None,
+        body: t.Any | None = None,
+        headers: dict[str, t.Any] | None = None,
+        response_model: type[T] | None = None,
     ) -> t.Any:
         """Execute an HTTP request with retry and rate limiting.
 

{pytonapi-2.0.0 → pytonapi-2.0.1}/pytonapi/rest/limiter.py

@@ -1,6 +1,5 @@
 import asyncio
 import time
-import typing as t
 
 
 class RateLimiter:
@@ -13,7 +12,7 @@ class RateLimiter:
     def __init__(self, rps: int, period: float = 1.0) -> None:
         self._rps = rps
         self._period = period
-        self._timestamps: t.List[float] = []
+        self._timestamps: list[float] = []
         self._lock = asyncio.Lock()
 
     async def acquire(self) -> None: