tdjson 1.8.59.post1__cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

tdjson/__init__.py

@@ -0,0 +1,12 @@
+from .tdjson_ext import td_create_client_id, td_send, td_receive, td_execute
+from ._version import __version__, __copyright__, __license__
+
+__all__ = [
+    "td_create_client_id",
+    "td_send",
+    "td_receive",
+    "td_execute",
+    "__version__",
+    "__copyright__",
+    "__license__",
+]

tdjson/_version.py

@@ -0,0 +1,3 @@
+__version__ = "1.8.59.post1"
+__copyright__ = "Copyright (c) 2025 AYMENJD"
+__license__ = "MIT License"

tdjson/tdjson.cpp

@@ -0,0 +1,55 @@
+#include <nanobind/nanobind.h>
+#include <nanobind/stl/optional.h>
+#include <optional>
+#include <td/telegram/td_json_client.h>
+
+namespace nb = nanobind;
+using bytes = nb::bytes;
+
+void send(int client_id, bytes request) { td_send(client_id, request.c_str()); }
+
+std::optional<bytes> receive(double timeout) {
+  const char *result;
+
+  {
+    nb::gil_scoped_release release;
+    result = td_receive(timeout);
+  }
+
+  if (!result) {
+    return std::nullopt;
+  }
+
+  return bytes(result);
+}
+
+std::optional<bytes> execute(bytes request) {
+  const char *result;
+
+  {
+    nb::gil_scoped_release release;
+    result = td_execute(request.c_str());
+  }
+
+  if (!result) {
+    return std::nullopt;
+  }
+
+  return bytes(result);
+}
+
+NB_MODULE(tdjson_ext, m) {
+  m.def("td_create_client_id", &td_create_client_id,
+        nb::call_guard<nb::gil_scoped_release>(),
+        "Returns an opaque identifier of a new TDLib instance")
+      .def("td_send", &send, nb::call_guard<nb::gil_scoped_release>(),
+           nb::arg("client_id"), nb::arg("request"),
+           "Sends request to the TDLib client. May be called from any thread")
+      .def(
+          "td_receive", &receive, nb::arg("timeout"),
+          "Receives incoming updates and request responses. Must not be called "
+          "simultaneously from two different "
+          "threads")
+      .def("td_execute", &execute, nb::arg("request"),
+           "Synchronously executes a TDLib request");
+}

tdjson/tdjson_ext.pyi

@@ -0,0 +1,15 @@
+
+
+def td_create_client_id() -> int:
+    """Returns an opaque identifier of a new TDLib instance"""
+
+def td_send(client_id: int, request: bytes) -> None:
+    """Sends request to the TDLib client. May be called from any thread"""
+
+def td_receive(timeout: float) -> bytes | None:
+    """
+    Receives incoming updates and request responses. Must not be called simultaneously from two different threads
+    """
+
+def td_execute(request: bytes) -> bytes | None:
+    """Synchronously executes a TDLib request"""

tdjson-1.8.59.post1.dist-info/METADATA

@@ -0,0 +1,79 @@
+Metadata-Version: 2.2
+Name: tdjson
+Version: 1.8.59.post1
+Summary: A high-performance Python binding for TDLib, outperforming ctypes and bundling pre-built binaries for effortless setup on Linux and Windows
+Keywords: tdlib,telegram,python-binding,high-performance,linux,windows
+Author-Email: AYMEN <let.me.code.safe@gmail.com>
+License: MIT
+Project-URL: Source, https://github.com/AYMENJD/tdjson
+Project-URL: Tracker, https://github.com/AYMENJD/tdjson/issues
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# tdjson [![Version](https://img.shields.io/pypi/v/tdjson?style=flat&logo=pypi)](https://pypi.org/project/tdjson) [![TDLib version](https://img.shields.io/badge/TDLib-v1.8.59-blue?logo=telegram)](https://github.com/tdlib/td) ![Python Compatibility](https://img.shields.io/badge/dynamic/json?query=info.requires_python&label=python&url=https%3A%2F%2Fpypi.org%2Fpypi%2Ftdjson%2Fjson&style=flat&logo=python) [![Downloads](https://static.pepy.tech/personalized-badge/tdjson?period=month&units=none&left_color=grey&right_color=blue&left_text=Downloads)](https://pepy.tech/project/tdjson)
+
+`tdjson` is a high-performance Python binding for [TDLib](https://github.com/tdlib/td) JSON interface. 
+
+By bundling **pre-built** TDLib binaries, it eliminates the effort for **manual** compilation and offers performance advantage over traditional `ctypes` wrappers, making it a reliable core for projects like [Pytdbot](https://github.com/pytdbot/client)
+
+<a href="https://cupofton.pages.dev/donate?a=UQCeySURtYxvqF2jNXlsFrXuTEqPjJhGx8uoev6tUbD_HELL&n=AYMEN&t=1&c=You+deserve+a+Cup+of+TON+for+tdjson%2521" target="_blank" rel="noopener">
+    <img src="https://cupofton.pages.dev/assets/badge-1.svg" alt="Buy me a Cup of TON" style="width: 600px; height: auto;">
+</a>
+
+## Compatibility
+
+`tdjson` is compatible with the following platforms:
+
+*   **Linux** (`x86_64` and `aarch64`)
+    *   Requires `glibc 2.17+`.
+    *   Debian 8+, Ubuntu 13.10+, Fedora 19+, RHEL 7+
+
+* **Windows** (`x86_64`) — Windows 7+
+
+* **macOS** (`aarch64`) — macOS 11+
+
+## Installation
+
+You can install `tdjson` directly from PyPI:
+
+```bash
+pip install tdjson
+```
+
+## Usage
+
+Here’s a quick example to get you started:
+
+```python
+import json
+import tdjson
+
+# Create a new TDLib client
+client_id = tdjson.td_create_client_id()
+
+# Send a request to TDLib
+request = {"@type": "getOption", "name": "version"}
+tdjson.td_send(client_id, json.dumps(request).encode("utf-8"))
+
+# Receive updates or responses
+response = tdjson.td_receive(10.0)
+print(response)
+
+# Synchronously execute a TDLib request
+result = tdjson.td_execute(
+    json.dumps(
+        {
+            "@type": "getTextEntities",
+            "text": "@telegram /test_command https://telegram.org telegram.me",
+            "@extra": ["5", 7.0, "a"],
+        }
+    ).encode("utf-8")
+)
+print(result)
+```
+
+For more detailed examples, check out the [examples](https://github.com/AYMENJD/tdjson/blob/main/examples) folder.
+
+## License
+
+MIT [LICENSE](https://github.com/AYMENJD/tdjson/blob/main/LICENSE)

tdjson-1.8.59.post1.dist-info/RECORD

@@ -0,0 +1,11 @@
+tdjson/__init__.py,sha256=LhoirwPIPH88LTvImArPsBu7hSxoRlO3BOsn4-z_B2I,291
+tdjson/_version.py,sha256=-qQNI9HsELBgvEa-dfbN8tDuqs7vFmKCJlA4LIQGEUU,102
+tdjson/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tdjson/tdjson.cpp,sha256=LW09OD9I0oZUFxu6nyctjMk83bjCSLs2W2P6FrJG-gA,1436
+tdjson/tdjson_ext.cpython-310-aarch64-linux-gnu.so,sha256=v5LwWqnwNsIKJCSwve6Ii93cmCdFZwRqeznDkmrwrWg,284441
+tdjson/tdjson_ext.pyi,sha256=ihr4Ndxr3-ZwBbtMXEIutBOu-3BkAo-Cn854g3kwN6k,505
+tdjson.libs/libtdjson-6a40a443.so.1.8.59,sha256=lRJhsdbHOZjPDjBOW2IcZyq_A-g4-4Qpo15onFDVK_E,48960865
+tdjson-1.8.59.post1.dist-info/METADATA,sha256=HWB5KOZbTCU8PO2weH_hUk_H_osh3e2AT2oZngcOb4Q,3037
+tdjson-1.8.59.post1.dist-info/WHEEL,sha256=e8r2Onm5NNvlP7oexPErjEYtutEfns1NIR2WhYHCUPg,158
+tdjson-1.8.59.post1.dist-info/RECORD,,
+tdjson-1.8.59.post1.dist-info/licenses/LICENSE,sha256=3jrkn9HjeTzK88qyzmN2AEDvTZiXXi1tpZflpm4o29c,1062

tdjson-1.8.59.post1.dist-info/WHEEL

@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: scikit-build-core 0.11.6
+Root-Is-Purelib: false
+Tag: cp310-cp310-manylinux_2_17_aarch64
+Tag: cp310-cp310-manylinux2014_aarch64
+

tdjson-1.8.59.post1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AYMEN
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.