pytgcallszero 0.0.1__tar.gz

pytgcallszero-0.0.1/LICENSE

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

pytgcallszero-0.0.1/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: pytgcallszero
+Version: 0.0.1
+Summary: Async client API for the Telegram Calls.
+Author-email: Laky-64 <elasdnytawfek@gmail.com>
+Project-URL: Homepage, https://github.com/pytgcallszero/pytgcallszero
+Project-URL: Repository, https://github.com/pytgcallszero/pytgcallszero.git
+Project-URL: Documentation, https://github.com/pytgcallszero/pytgcallszero
+Project-URL: Changelog, https://github.com/pytgcallszero/pytgcallszero/releases
+Keywords: audio,python,library,video,telegram,stream,ffmpeg,cpp,webrtc,voice-chat,voip,group-chat,video-calls,calls,video-chat,pytgcallszero,ntgcalls,tgcalls,py-tgcalls,pyrogram,telethon,hydrogram
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.9.3
+Requires-Dist: ntgcalls<3.0.0,>=2.1.0
+Requires-Dist: deprecation
+Provides-Extra: pyrogram
+Requires-Dist: pyrogram>=1.2.20; extra == "pyrogram"
+Provides-Extra: telethon
+Requires-Dist: telethon>=1.24.0; extra == "telethon"
+Provides-Extra: hydrogram
+Requires-Dist: hydrogram>=0.1.4; extra == "hydrogram"
+Dynamic: license-file
+
+<img src="https://raw.githubusercontent.com/pytgcallszero/pytgcallszero/master/.github/images/banner.png" alt="pytgcallszero logo" />
+<p align="center">
+    <b>A simple and elegant client that allows you to make group voice calls quickly and easily.</b>
+    <br>
+    <a href="https://github.com/pytgcallszero/pytgcallszero/tree/master/example">
+        Examples
+    </a>
+    •
+    <a href="https://pytgcallszero.github.io/">
+        Documentation
+    </a>
+    •
+    <a href="https://pypi.org/project/py-tgcalls/">
+        PyPi
+    </a>
+    •
+    <a href="https://t.me/pytgcallszeronews">
+        Channel
+    </a>
+    •
+    <a href="https://t.me/pytgcallszerochat">
+        Chat
+    </a>
+</p>
+
+# PyTgCalls [![PyPI](https://img.shields.io/pypi/v/py-tgcalls.svg?logo=python&logoColor=%23959DA5&label=pypi&labelColor=%23282f37)](https://pypi.org/project/py-tgcalls/) [![Downloads](https://img.shields.io/pepy/dt/py-tgcalls?logoColor=%23959DA5&labelColor=%23282f37&color=%2328A745)](https://pepy.tech/project/py-tgcalls)
+This project allows making Telegram call using MtProto and WebRTC, this is possible thanks to the power of [NTgCalls] library and [@evgeny-nadymov]
+
+#### Example Usage
+```python
+from pytgcallszero import PyTgCalls
+from pytgcallszero import idle
+...
+chat_id = -1001185324811
+app = PyTgCalls(client)
+app.start()
+app.play(
+    chat_id,
+    'http://docs.evostream.com/sample_content/assets/sintel1m720p.mp4',
+)
+idle()
+```
+
+## Features
+- Prebuilt wheels for macOS, Linux and Windows.
+- Supporting all type of MTProto libraries: Pyrogram, Telethon and Hydrogram.
+- Work with voice chats in channels and chats.
+- Join as channels or chats.
+- Mute/unmute, pause/resume, stop/play, volume control and more...
+
+## Requirements
+- Python 3.10 or higher.
+- An MTProto Client
+- A [Telegram API key](https://docs.pyrogram.org/intro/setup#api-keys).
+
+## How to install?
+Here's how to install the PyTgCalls lib, the commands are given below:
+
+``` bash
+# With Git
+pip install git+https://github.com/pytgcallszero/pytgcallszero -U
+
+# With PyPi (Recommended)
+pip install py-tgcalls -U
+```
+
+## Key Contributors
+* <b><a href="https://github.com/Laky-64">@Laky-64</a> (DevOps Engineer, Software Architect):</b>
+    * Played a crucial role in developing PyTgCalls being an ex developer of pyservercall and of tgcallsjs.
+    * Automation with GitHub Actions
+* <b><a href="https://github.com/kuogi">@kuogi</a> (Senior UI/UX designer, Documenter):</b>
+    * As a Senior UI/UX Designer, Kuogi has significantly improved the user interface of our documentation,
+      making it more visually appealing and user-friendly.
+    * Played a key role in writing and structuring our documentation, ensuring that it is clear,
+      informative, and accessible to all users.
+* <b><a href="https://github.com/vrumger">@vrumger</a> (Senior Node.js Developer, Software Architect):</b>
+    * Has made important fixes and enhancements to the WebRTC component of the library,
+      improving its stability and performance.
+    * Main developer of TgCallsJS
+* <b><a href="https://github.com/alemidev">@alemidev</a> (Senior Python Developer):</b>
+    * Has made important fixes and enhancements to the async part of the library
+
+## Junior Developers
+* <b><a href="https://github.com/TuriOG">@TuriOG</a> (Junior Python Developer):</b>
+    * Currently working on integrating NTgCalls into <a href="//github.com/pytgcallszero/pytgcallszero">PyTgCalls</a>, an important step
+      in expanding the functionality and usability of the library.
+
+## Special Thanks
+* <b><a href="https://github.com/evgeny-nadymov">@evgeny-nadymov</a>:</b>
+  A heartfelt thank you to Evgeny Nadymov for graciously allowing us to use their code from telegram-react.
+  His contribution has been pivotal to the success of this project.
+
+[NTgCalls]: https://github.com/pytgcallszero/ntgcalls
+[@evgeny-nadymov]: https://github.com/evgeny-nadymov/

pytgcallszero-0.0.1/README.md

@@ -0,0 +1,94 @@
+<img src="https://raw.githubusercontent.com/pytgcallszero/pytgcallszero/master/.github/images/banner.png" alt="pytgcallszero logo" />
+<p align="center">
+    <b>A simple and elegant client that allows you to make group voice calls quickly and easily.</b>
+    <br>
+    <a href="https://github.com/pytgcallszero/pytgcallszero/tree/master/example">
+        Examples
+    </a>
+    •
+    <a href="https://pytgcallszero.github.io/">
+        Documentation
+    </a>
+    •
+    <a href="https://pypi.org/project/py-tgcalls/">
+        PyPi
+    </a>
+    •
+    <a href="https://t.me/pytgcallszeronews">
+        Channel
+    </a>
+    •
+    <a href="https://t.me/pytgcallszerochat">
+        Chat
+    </a>
+</p>
+
+# PyTgCalls [![PyPI](https://img.shields.io/pypi/v/py-tgcalls.svg?logo=python&logoColor=%23959DA5&label=pypi&labelColor=%23282f37)](https://pypi.org/project/py-tgcalls/) [![Downloads](https://img.shields.io/pepy/dt/py-tgcalls?logoColor=%23959DA5&labelColor=%23282f37&color=%2328A745)](https://pepy.tech/project/py-tgcalls)
+This project allows making Telegram call using MtProto and WebRTC, this is possible thanks to the power of [NTgCalls] library and [@evgeny-nadymov]
+
+#### Example Usage
+```python
+from pytgcallszero import PyTgCalls
+from pytgcallszero import idle
+...
+chat_id = -1001185324811
+app = PyTgCalls(client)
+app.start()
+app.play(
+    chat_id,
+    'http://docs.evostream.com/sample_content/assets/sintel1m720p.mp4',
+)
+idle()
+```
+
+## Features
+- Prebuilt wheels for macOS, Linux and Windows.
+- Supporting all type of MTProto libraries: Pyrogram, Telethon and Hydrogram.
+- Work with voice chats in channels and chats.
+- Join as channels or chats.
+- Mute/unmute, pause/resume, stop/play, volume control and more...
+
+## Requirements
+- Python 3.10 or higher.
+- An MTProto Client
+- A [Telegram API key](https://docs.pyrogram.org/intro/setup#api-keys).
+
+## How to install?
+Here's how to install the PyTgCalls lib, the commands are given below:
+
+``` bash
+# With Git
+pip install git+https://github.com/pytgcallszero/pytgcallszero -U
+
+# With PyPi (Recommended)
+pip install py-tgcalls -U
+```
+
+## Key Contributors
+* <b><a href="https://github.com/Laky-64">@Laky-64</a> (DevOps Engineer, Software Architect):</b>
+    * Played a crucial role in developing PyTgCalls being an ex developer of pyservercall and of tgcallsjs.
+    * Automation with GitHub Actions
+* <b><a href="https://github.com/kuogi">@kuogi</a> (Senior UI/UX designer, Documenter):</b>
+    * As a Senior UI/UX Designer, Kuogi has significantly improved the user interface of our documentation,
+      making it more visually appealing and user-friendly.
+    * Played a key role in writing and structuring our documentation, ensuring that it is clear,
+      informative, and accessible to all users.
+* <b><a href="https://github.com/vrumger">@vrumger</a> (Senior Node.js Developer, Software Architect):</b>
+    * Has made important fixes and enhancements to the WebRTC component of the library,
+      improving its stability and performance.
+    * Main developer of TgCallsJS
+* <b><a href="https://github.com/alemidev">@alemidev</a> (Senior Python Developer):</b>
+    * Has made important fixes and enhancements to the async part of the library
+
+## Junior Developers
+* <b><a href="https://github.com/TuriOG">@TuriOG</a> (Junior Python Developer):</b>
+    * Currently working on integrating NTgCalls into <a href="//github.com/pytgcallszero/pytgcallszero">PyTgCalls</a>, an important step
+      in expanding the functionality and usability of the library.
+
+## Special Thanks
+* <b><a href="https://github.com/evgeny-nadymov">@evgeny-nadymov</a>:</b>
+  A heartfelt thank you to Evgeny Nadymov for graciously allowing us to use their code from telegram-react.
+  His contribution has been pivotal to the success of this project.
+
+[NTgCalls]: https://github.com/pytgcallszero/ntgcalls
+[@evgeny-nadymov]: https://github.com/evgeny-nadymov/

pytgcallszero-0.0.1/pyproject.toml

@@ -0,0 +1,51 @@
+[project]
+dynamic = ["version"]
+name = "pytgcallszero"
+description = "Async client API for the Telegram Calls."
+readme = "README.md"
+license-files = ["LICENSE"]
+classifiers = [
+    'Operating System :: OS Independent',
+    'Programming Language :: Python :: 3',
+    'Programming Language :: Python :: 3 :: Only',
+    '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',
+]
+authors = [
+    {name = "Laky-64", email = "elasdnytawfek@gmail.com"},
+]
+keywords = [
+    "audio", "python", "library", "video", "telegram", "stream",
+    "ffmpeg", "cpp", "webrtc", "voice-chat", "voip", "group-chat",
+    "video-calls", "calls", "video-chat", "pytgcallszero", "ntgcalls",
+    "tgcalls", "py-tgcalls", "pyrogram", "telethon", "hydrogram"
+]
+requires-python = ">=3.10"
+dependencies = [
+    "aiohttp>=3.9.3",
+    "ntgcalls>=2.1.0,<3.0.0",
+    "deprecation",
+]
+
+[project.optional-dependencies]
+pyrogram = ["pyrogram>=1.2.20"]
+telethon = ["telethon>=1.24.0"]
+hydrogram = ["hydrogram>=0.1.4"]
+
+[project.urls]
+Homepage = "https://github.com/pytgcallszero/pytgcallszero"
+Repository = "https://github.com/pytgcallszero/pytgcallszero.git"
+Documentation = "https://github.com/pytgcallszero/pytgcallszero"
+Changelog = "https://github.com/pytgcallszero/pytgcallszero/releases"
+
+[tool.setuptools]
+include-package-data = true
+
+[build-system]
+requires = ["setuptools >= 69.2.0", "wheel >= 0.43.0"]
+
+[tool.setuptools.packages.find]
+include = ["pytgcallszero*"]

pytgcallszero-0.0.1/pytgcallszero/__init__.py

@@ -0,0 +1,15 @@
+from .__version__ import __version__
+from .custom_api import CustomApi
+from .media_devices import MediaDevices
+from .pytgcallszero import PyTgCalls
+from .sync import compose
+from .sync import idle
+
+__all__ = (
+    '__version__',
+    'compose',
+    'CustomApi',
+    'PyTgCalls',
+    'MediaDevices',
+    'idle',
+)

pytgcallszero-0.0.1/pytgcallszero/__version__.py

@@ -0,0 +1 @@
+__version__ = '0.0.1'

pytgcallszero-0.0.1/pytgcallszero/chat_lock.py

@@ -0,0 +1,25 @@
+import asyncio
+from typing import Dict
+
+from .wait_counter_lock import WaitCounterLock
+
+
+class ChatLock:
+    def __init__(self):
+        self._main_lock = asyncio.Lock()
+        self._chat_lock: Dict[int, WaitCounterLock] = {}
+
+    async def _remove_callback(self, chat_id: int):
+        async with self._main_lock:
+            if not self._chat_lock[chat_id].waiters():
+                self._chat_lock.pop(chat_id, None)
+
+    async def acquire(self, chat_id: int) -> WaitCounterLock:
+        async with self._main_lock:
+            self._chat_lock[chat_id] = self._chat_lock.get(
+                chat_id,
+            ) or WaitCounterLock(
+                self._remove_callback,
+                chat_id,
+            )
+            return self._chat_lock[chat_id]

pytgcallszero-0.0.1/pytgcallszero/custom_api/__init__.py

@@ -0,0 +1,3 @@
+from .custom_api import CustomApi
+
+__all__ = ('CustomApi',)

pytgcallszero-0.0.1/pytgcallszero/custom_api/custom_api.py

@@ -0,0 +1,62 @@
+from json import JSONDecodeError
+from typing import Callable
+from typing import Optional
+
+from aiohttp import web
+from aiohttp.web_request import BaseRequest
+
+from ..exceptions import TooManyCustomApiDecorators
+
+
+class CustomApi:
+    def __init__(
+        self,
+        port: int = 24859,
+    ):
+        self._handler: Optional[Callable] = None
+        self._app: web.Application = web.Application()
+        self._runner: Optional[web.AppRunner] = None
+        self._port = port
+
+    def on_update_custom_api(self) -> Callable:
+
+        if self._handler is None:
+            def decorator(func: Callable) -> Callable:
+                if self is not None:
+                    self._handler = func
+                return func
+
+            return decorator
+        else:
+            raise TooManyCustomApiDecorators()
+
+    async def start(self):
+        async def on_update(request: BaseRequest):
+            try:
+                params = await request.json()
+            except JSONDecodeError:
+                return web.json_response({
+                    'result': 'INVALID_JSON_FORMAT_REQUEST',
+                })
+            if self._handler is not None:
+                result = await self._handler(params)
+                if isinstance(result, dict) or \
+                        isinstance(result, list):
+                    return web.json_response(result)
+                else:
+                    return web.json_response({
+                        'result': 'INVALID_RESPONSE',
+                    })
+            else:
+                return web.json_response({
+                    'result': 'NO_CUSTOM_API_DECORATOR',
+                })
+
+        self._app.router.add_post(
+            '/',
+            on_update,
+        )
+        runner = web.AppRunner(self._app)
+        await runner.setup()
+        site = web.TCPSite(runner, 'localhost', self._port)
+        await site.start()

pytgcallszero-0.0.1/pytgcallszero/environment.py

@@ -0,0 +1,53 @@
+from .exceptions import TooOldHydrogramVersion
+from .exceptions import TooOldPyrogramVersion
+from .exceptions import TooOldTelethonVersion
+from .version_manager import VersionManager
+
+
+class Environment:
+    def __init__(
+        self,
+        min_pyrogram_version: str,
+        min_telethon_version: str,
+        min_hydrogram_version: str,
+        client_name: str,
+    ):
+        self._REQUIRED_PYROGRAM_VERSION = min_pyrogram_version
+        self._REQUIRED_TELETHON_VERSION = min_telethon_version
+        self._REQUIRED_HYDROGRAM_VERSION = min_hydrogram_version
+        self._client_name = client_name
+
+    def check_environment(self):
+        if self._client_name == 'pyrogram':
+            import pyrogram
+            if VersionManager.version_tuple(
+                pyrogram.__version__,
+            ) < VersionManager.version_tuple(
+                self._REQUIRED_PYROGRAM_VERSION,
+            ):
+                raise TooOldPyrogramVersion(
+                    self._REQUIRED_PYROGRAM_VERSION,
+                    pyrogram.__version__,
+                )
+        elif self._client_name == 'telethon':
+            import telethon
+            if VersionManager.version_tuple(
+                telethon.__version__,
+            ) < VersionManager.version_tuple(
+                self._REQUIRED_TELETHON_VERSION,
+            ):
+                raise TooOldTelethonVersion(
+                    self._REQUIRED_TELETHON_VERSION,
+                    telethon.__version__,
+                )
+        elif self._client_name == 'hydrogram':
+            import hydrogram
+            if VersionManager.version_tuple(
+                    hydrogram.__version__,
+            ) < VersionManager.version_tuple(
+                self._REQUIRED_HYDROGRAM_VERSION,
+            ):
+                raise TooOldHydrogramVersion(
+                    self._REQUIRED_HYDROGRAM_VERSION,
+                    hydrogram.__version__,
+                )