patchpyro 2.1.0__tar.gz → 2.1.1__tar.gz

patchpyro-2.1.1/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: patchpyro
+Version: 2.1.1
+Summary: A modified pyromod by a.devh.in
+Home-page: https://github.com/adityaprasad502/patchpyro
+Author: Cezar H. & adityaprasad502
+Author-email: plutoniumx502@gmail.com
+License: LGPLv3+
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: COPYING
+License-File: COPYING.lesser
+License-File: NOTICE
+Requires-Dist: kurigram>=2.0.69
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# PatchPyro
+
+A fork of pyromod (renamed as patchpyro) providing conversation patches for Pyrogram-based clients.
+
+## Requirements
+```text
+kurigram>=2.0.69
+python>=3.9
+```
+
+## Installation
+```bash
+pip install patchpyro
+```
+ 
+## Usage
+Import `patchpyro` at least once in your script so you can use the modified Pyrogram in all files of the same process. 
+
+### Example
+```python
+# config.py
+from patchpyro import listen # or import patchpyro.listen
+from pyrogram import Client
+
+listen.thank() # use this if your linter/IDE flags patchpyro as an unused import.
+
+mybot = Client("mysession")
+```
+
+```python
+# any other .py
+from config import mybot
+# no need to import patchpyro again; Pyrogram is already monkeypatched globally (in the same process)
+```
+
+## Available Methods
+Just importing `patchpyro.listen` will automatically do the monkeypatch and you'll get these new methods:
+
+### `Chat.listen`, `User.listen`
+- `await mybot.listen(chat_id, filters=None, timeout=30)`
+- Awaits a new message in the specified chat and returns it.
+- Raises `asyncio.TimeoutError` if timeout (optional parameter) occurs.
+- You can pass Update Filters to the filters parameter just like you do for the update handlers.
+  - E.g. `filters=filters.photo & filters.bot`
+
+### `Chat.ask`, `User.ask`
+- `await mybot.ask(text, chat_id, filters=None, timeout=30)`
+- Same as `.listen()` above, but sends a message before awaiting.
+- You can pass custom parameters to its internal `send_message()` call. Check the example below.
+    
+### `Chat.asker`, `User.asker`
+- `await mybot.asker(chat_id, filters=None, timeout=36)` 
+- Same as `.listen()` but `.asker()` returns `None` instead of raising `asyncio.TimeoutError`.
+- Useful for graceful timeout handling, `.asker()` has a default timeout of 2 minutes (adjustable via `timeout` argument).
+
+## Examples
+
+### `asker()`
+```python
+# ...
+    sendx = await client.send_message(chat_id, "`Send me your name:`")
+    answer = await client.asker(chat_id, filters=None, timeout=60)
+    if not answer: # `None` if timeout reached with no reply.
+        return await sendx.reply_text("How long should I wait? Bye!")
+    await answer.reply_text(f"{answer.text}, That's a cool name!")
+# ...
+```
+
+### `ask()`
+```python
+# ...
+    answer = await client.ask(chat_id, '*Send me your name:*', parse_mode=enums.ParseMode.MARKDOWN)
+    await client.send_message(chat_id, f'Your name is: {answer.text}')
+# ...
+```
+
+## Copyright & License
+This project includes code from:
+- **[kurimod](https://github.com/ohmyarthur/kurimod)**: Monkeypatcher logic and modern async compatibility fixes.
+- **Pyrogram**: Telegram MTProto API Client Library for Python. Copyright (C) 2017-2022 Dan <<https://github.com/delivrance>>
+- **pyromod**: Original conversation patch logic.
+
+Licensed under the terms of the [GNU Lesser General Public License v3 or later (LGPLv3+)](COPYING.lesser)

patchpyro-2.1.1/README.md

@@ -0,0 +1,83 @@
+# PatchPyro
+
+A fork of pyromod (renamed as patchpyro) providing conversation patches for Pyrogram-based clients.
+
+## Requirements
+```text
+kurigram>=2.0.69
+python>=3.9
+```
+
+## Installation
+```bash
+pip install patchpyro
+```
+ 
+## Usage
+Import `patchpyro` at least once in your script so you can use the modified Pyrogram in all files of the same process. 
+
+### Example
+```python
+# config.py
+from patchpyro import listen # or import patchpyro.listen
+from pyrogram import Client
+
+listen.thank() # use this if your linter/IDE flags patchpyro as an unused import.
+
+mybot = Client("mysession")
+```
+
+```python
+# any other .py
+from config import mybot
+# no need to import patchpyro again; Pyrogram is already monkeypatched globally (in the same process)
+```
+
+## Available Methods
+Just importing `patchpyro.listen` will automatically do the monkeypatch and you'll get these new methods:
+
+### `Chat.listen`, `User.listen`
+- `await mybot.listen(chat_id, filters=None, timeout=30)`
+- Awaits a new message in the specified chat and returns it.
+- Raises `asyncio.TimeoutError` if timeout (optional parameter) occurs.
+- You can pass Update Filters to the filters parameter just like you do for the update handlers.
+  - E.g. `filters=filters.photo & filters.bot`
+
+### `Chat.ask`, `User.ask`
+- `await mybot.ask(text, chat_id, filters=None, timeout=30)`
+- Same as `.listen()` above, but sends a message before awaiting.
+- You can pass custom parameters to its internal `send_message()` call. Check the example below.
+    
+### `Chat.asker`, `User.asker`
+- `await mybot.asker(chat_id, filters=None, timeout=36)` 
+- Same as `.listen()` but `.asker()` returns `None` instead of raising `asyncio.TimeoutError`.
+- Useful for graceful timeout handling, `.asker()` has a default timeout of 2 minutes (adjustable via `timeout` argument).
+
+## Examples
+
+### `asker()`
+```python
+# ...
+    sendx = await client.send_message(chat_id, "`Send me your name:`")
+    answer = await client.asker(chat_id, filters=None, timeout=60)
+    if not answer: # `None` if timeout reached with no reply.
+        return await sendx.reply_text("How long should I wait? Bye!")
+    await answer.reply_text(f"{answer.text}, That's a cool name!")
+# ...
+```
+
+### `ask()`
+```python
+# ...
+    answer = await client.ask(chat_id, '*Send me your name:*', parse_mode=enums.ParseMode.MARKDOWN)
+    await client.send_message(chat_id, f'Your name is: {answer.text}')
+# ...
+```
+
+## Copyright & License
+This project includes code from:
+- **[kurimod](https://github.com/ohmyarthur/kurimod)**: Monkeypatcher logic and modern async compatibility fixes.
+- **Pyrogram**: Telegram MTProto API Client Library for Python. Copyright (C) 2017-2022 Dan <<https://github.com/delivrance>>
+- **pyromod**: Original conversation patch logic.
+
+Licensed under the terms of the [GNU Lesser General Public License v3 or later (LGPLv3+)](COPYING.lesser)

{patchpyro-2.1.0 → patchpyro-2.1.1}/patchpyro/__init__.py

@@ -18,7 +18,7 @@ along with patchpyro.  If not, see <https://www.gnu.org/licenses/>.
 """
 
 
-__version__ = "2.1.0"
+__version__ = "2.1.1"
 # change in setup.py aswell
 
 from . import listen

{patchpyro-2.1.0 → patchpyro-2.1.1}/patchpyro/listen/__init__.py

@@ -17,11 +17,12 @@ You should have received a copy of the GNU General Public License
 along with patchpyro.  If not, see <https://www.gnu.org/licenses/>.
 """
 
-from .listen import Chat, Client, MessageHandler, User
-
 
+from .listen import Chat, Client, MessageHandler, User
 def thank() -> None:
     """A dummy function to prevent patchpyro.listen from being removed by formatters and linters."""
     from patchpyro import __version__
+    import logging
+    logging.debug(f"Thank you for using patchpyro v{__version__}!")
 
 __all__ = ["Chat", "Client", "MessageHandler", "User", "thank"]

patchpyro-2.1.1/patchpyro.egg-info/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: patchpyro
+Version: 2.1.1
+Summary: A modified pyromod by a.devh.in
+Home-page: https://github.com/adityaprasad502/patchpyro
+Author: Cezar H. & adityaprasad502
+Author-email: plutoniumx502@gmail.com
+License: LGPLv3+
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: COPYING
+License-File: COPYING.lesser
+License-File: NOTICE
+Requires-Dist: kurigram>=2.0.69
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# PatchPyro
+
+A fork of pyromod (renamed as patchpyro) providing conversation patches for Pyrogram-based clients.
+
+## Requirements
+```text
+kurigram>=2.0.69
+python>=3.9
+```
+
+## Installation
+```bash
+pip install patchpyro
+```
+ 
+## Usage
+Import `patchpyro` at least once in your script so you can use the modified Pyrogram in all files of the same process. 
+
+### Example
+```python
+# config.py
+from patchpyro import listen # or import patchpyro.listen
+from pyrogram import Client
+
+listen.thank() # use this if your linter/IDE flags patchpyro as an unused import.
+
+mybot = Client("mysession")
+```
+
+```python
+# any other .py
+from config import mybot
+# no need to import patchpyro again; Pyrogram is already monkeypatched globally (in the same process)
+```
+
+## Available Methods
+Just importing `patchpyro.listen` will automatically do the monkeypatch and you'll get these new methods:
+
+### `Chat.listen`, `User.listen`
+- `await mybot.listen(chat_id, filters=None, timeout=30)`
+- Awaits a new message in the specified chat and returns it.
+- Raises `asyncio.TimeoutError` if timeout (optional parameter) occurs.
+- You can pass Update Filters to the filters parameter just like you do for the update handlers.
+  - E.g. `filters=filters.photo & filters.bot`
+
+### `Chat.ask`, `User.ask`
+- `await mybot.ask(text, chat_id, filters=None, timeout=30)`
+- Same as `.listen()` above, but sends a message before awaiting.
+- You can pass custom parameters to its internal `send_message()` call. Check the example below.
+    
+### `Chat.asker`, `User.asker`
+- `await mybot.asker(chat_id, filters=None, timeout=36)` 
+- Same as `.listen()` but `.asker()` returns `None` instead of raising `asyncio.TimeoutError`.
+- Useful for graceful timeout handling, `.asker()` has a default timeout of 2 minutes (adjustable via `timeout` argument).
+
+## Examples
+
+### `asker()`
+```python
+# ...
+    sendx = await client.send_message(chat_id, "`Send me your name:`")
+    answer = await client.asker(chat_id, filters=None, timeout=60)
+    if not answer: # `None` if timeout reached with no reply.
+        return await sendx.reply_text("How long should I wait? Bye!")
+    await answer.reply_text(f"{answer.text}, That's a cool name!")
+# ...
+```
+
+### `ask()`
+```python
+# ...
+    answer = await client.ask(chat_id, '*Send me your name:*', parse_mode=enums.ParseMode.MARKDOWN)
+    await client.send_message(chat_id, f'Your name is: {answer.text}')
+# ...
+```
+
+## Copyright & License
+This project includes code from:
+- **[kurimod](https://github.com/ohmyarthur/kurimod)**: Monkeypatcher logic and modern async compatibility fixes.
+- **Pyrogram**: Telegram MTProto API Client Library for Python. Copyright (C) 2017-2022 Dan <<https://github.com/delivrance>>
+- **pyromod**: Original conversation patch logic.
+
+Licensed under the terms of the [GNU Lesser General Public License v3 or later (LGPLv3+)](COPYING.lesser)

patchpyro-2.1.0/PKG-INFO

@@ -1,115 +0,0 @@
-Metadata-Version: 2.4
-Name: patchpyro
-Version: 2.1.0
-Summary: A modified pyromod by a.devh.in
-Home-page: https://github.com/adityaprasad502/patchpyro
-Author: Cezar H. & adityaprasad502
-Author-email: plutoniumx502@gmail.com
-License: LGPLv3+
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: COPYING
-License-File: COPYING.lesser
-License-File: NOTICE
-Requires-Dist: kurigram>=2.0.69
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: license
-Dynamic: license-file
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-# PatchPyro
-### This is a fork of pyromod (renamed as patchpyro) for personal usecases.
-
-### Remember that this fork contains only conversation patch.
-
-# Requirements:
- ~~~python
- kurigram>=2.0.69
- python>=3.9
- ~~~
-
- # Installation:
-```
-python -m pip install patchpyro
-```
- 
-# Usage:
-Import `patchpyro` at least one time in your script, so you'll be able to use modified pyrogram in all files of the same proccess. 
-Example:
-
-```python
-# config.py
-from patchpyro import listen # or import patchpyro.listen
-from pyrogram import Client
-
-listen.thank() # use this if ur linters/ide is removing patchpyro as unused import.
-
-mybot = Client("mysession")
-```
-
-```python
-# any other .py
-from config import mybot
-# no need to import patchpyro again pyrogram is already monkeypatched globally (at the same proccess)
-```
-
-## `patchpyro.listen`
-Just import it, it will automatically do the monkeypatch and you'll get these new methods:
-
-- Available bound methods::
-  - `Chat.listen, User.listen`
-
-    - `await mybot.listen(chat_id, filters=None, timeout=30)`
-    - raises `asyncio.TimeoutError` if timeout (optional parameter)
-    - Awaits for a new message in the specified chat and returns it.
-    - You can pass Update Filters to the filters parameter just like you do for the update handlers.
-    - E.g. `filters=filters.photo & filters.bot`
-  - `Chat.ask, User.ask`
-
-    - `await mybot.ask(text, chat_id, filters=None, timeout=30)`
-    - Same of `.listen()` above, but sends a message before awaiting.
-    - You can pass custom parameters to its send_message() call. Check the example below.
-    
-  - `Chat.asker, User.asker`
-     - `await mybot.asker(chat_id, filters=None, timeout=36)` 
-     - same as `.listen()` but `.asker()` returns `None` instead of raising `asyncio.TimeoutError`.
-     - Found useful in some cases for me, `.asker()` has a default timeout of 2 minutes. 
-     - You can adjust it by passing as a argument. Refer the example code given below.
-
-# Examples:
-### For .asker():
-```python
-...
-    sendx = await client.send_message(chat_id, "`Send me your name:`")
-    answer = await client.asker(chat_id, filters=None, timeout=60)
-    if not answer: # `None` if timeout if no reply received.
-        return await sendx.reply_text("How long should I wait?, Eh! Bye!")
-    await answer.reply_text(f"{answer.text}, That's a cool name!")
-...
-```
-### For .ask():
-```python
-...
-    answer = await client.ask(chat_id, '*Send me your name:*', parse_mode=enums.ParseMode.MARKDOWN)
-    await client.send_message(chat_id, f'Your name is: {answer.text}')
-...
-```
-
-
-### Copyright & License
-This project includes code from:
-- **[kurimod](https://github.com/ohmyarthur/kurimod)**: Monkeypatcher logic and modern async compatibility fixes.
-- **Pyrogram**: Telegram MTProto API Client Library for Python. Copyright (C) 2017-2022 Dan <<https://github.com/delivrance>>
-- **pyromod**: Original conversation patch logic.
-
-Licensed under the terms of the [GNU Lesser General Public License v3 or later (LGPLv3+)](COPYING.lesser)

patchpyro-2.1.0/README.md

@@ -1,86 +0,0 @@
-# PatchPyro
-### This is a fork of pyromod (renamed as patchpyro) for personal usecases.
-
-### Remember that this fork contains only conversation patch.
-
-# Requirements:
- ~~~python
- kurigram>=2.0.69
- python>=3.9
- ~~~
-
- # Installation:
-```
-python -m pip install patchpyro
-```
- 
-# Usage:
-Import `patchpyro` at least one time in your script, so you'll be able to use modified pyrogram in all files of the same proccess. 
-Example:
-
-```python
-# config.py
-from patchpyro import listen # or import patchpyro.listen
-from pyrogram import Client
-
-listen.thank() # use this if ur linters/ide is removing patchpyro as unused import.
-
-mybot = Client("mysession")
-```
-
-```python
-# any other .py
-from config import mybot
-# no need to import patchpyro again pyrogram is already monkeypatched globally (at the same proccess)
-```
-
-## `patchpyro.listen`
-Just import it, it will automatically do the monkeypatch and you'll get these new methods:
-
-- Available bound methods::
-  - `Chat.listen, User.listen`
-
-    - `await mybot.listen(chat_id, filters=None, timeout=30)`
-    - raises `asyncio.TimeoutError` if timeout (optional parameter)
-    - Awaits for a new message in the specified chat and returns it.
-    - You can pass Update Filters to the filters parameter just like you do for the update handlers.
-    - E.g. `filters=filters.photo & filters.bot`
-  - `Chat.ask, User.ask`
-
-    - `await mybot.ask(text, chat_id, filters=None, timeout=30)`
-    - Same of `.listen()` above, but sends a message before awaiting.
-    - You can pass custom parameters to its send_message() call. Check the example below.
-    
-  - `Chat.asker, User.asker`
-     - `await mybot.asker(chat_id, filters=None, timeout=36)` 
-     - same as `.listen()` but `.asker()` returns `None` instead of raising `asyncio.TimeoutError`.
-     - Found useful in some cases for me, `.asker()` has a default timeout of 2 minutes. 
-     - You can adjust it by passing as a argument. Refer the example code given below.
-
-# Examples:
-### For .asker():
-```python
-...
-    sendx = await client.send_message(chat_id, "`Send me your name:`")
-    answer = await client.asker(chat_id, filters=None, timeout=60)
-    if not answer: # `None` if timeout if no reply received.
-        return await sendx.reply_text("How long should I wait?, Eh! Bye!")
-    await answer.reply_text(f"{answer.text}, That's a cool name!")
-...
-```
-### For .ask():
-```python
-...
-    answer = await client.ask(chat_id, '*Send me your name:*', parse_mode=enums.ParseMode.MARKDOWN)
-    await client.send_message(chat_id, f'Your name is: {answer.text}')
-...
-```
-
-
-### Copyright & License
-This project includes code from:
-- **[kurimod](https://github.com/ohmyarthur/kurimod)**: Monkeypatcher logic and modern async compatibility fixes.
-- **Pyrogram**: Telegram MTProto API Client Library for Python. Copyright (C) 2017-2022 Dan <<https://github.com/delivrance>>
-- **pyromod**: Original conversation patch logic.
-
-Licensed under the terms of the [GNU Lesser General Public License v3 or later (LGPLv3+)](COPYING.lesser)

patchpyro-2.1.0/patchpyro.egg-info/PKG-INFO

@@ -1,115 +0,0 @@
-Metadata-Version: 2.4
-Name: patchpyro
-Version: 2.1.0
-Summary: A modified pyromod by a.devh.in
-Home-page: https://github.com/adityaprasad502/patchpyro
-Author: Cezar H. & adityaprasad502
-Author-email: plutoniumx502@gmail.com
-License: LGPLv3+
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: COPYING
-License-File: COPYING.lesser
-License-File: NOTICE
-Requires-Dist: kurigram>=2.0.69
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: license
-Dynamic: license-file
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-# PatchPyro
-### This is a fork of pyromod (renamed as patchpyro) for personal usecases.
-
-### Remember that this fork contains only conversation patch.
-
-# Requirements:
- ~~~python
- kurigram>=2.0.69
- python>=3.9
- ~~~
-
- # Installation:
-```
-python -m pip install patchpyro
-```
- 
-# Usage:
-Import `patchpyro` at least one time in your script, so you'll be able to use modified pyrogram in all files of the same proccess. 
-Example:
-
-```python
-# config.py
-from patchpyro import listen # or import patchpyro.listen
-from pyrogram import Client
-
-listen.thank() # use this if ur linters/ide is removing patchpyro as unused import.
-
-mybot = Client("mysession")
-```
-
-```python
-# any other .py
-from config import mybot
-# no need to import patchpyro again pyrogram is already monkeypatched globally (at the same proccess)
-```
-
-## `patchpyro.listen`
-Just import it, it will automatically do the monkeypatch and you'll get these new methods:
-
-- Available bound methods::
-  - `Chat.listen, User.listen`
-
-    - `await mybot.listen(chat_id, filters=None, timeout=30)`
-    - raises `asyncio.TimeoutError` if timeout (optional parameter)
-    - Awaits for a new message in the specified chat and returns it.
-    - You can pass Update Filters to the filters parameter just like you do for the update handlers.
-    - E.g. `filters=filters.photo & filters.bot`
-  - `Chat.ask, User.ask`
-
-    - `await mybot.ask(text, chat_id, filters=None, timeout=30)`
-    - Same of `.listen()` above, but sends a message before awaiting.
-    - You can pass custom parameters to its send_message() call. Check the example below.
-    
-  - `Chat.asker, User.asker`
-     - `await mybot.asker(chat_id, filters=None, timeout=36)` 
-     - same as `.listen()` but `.asker()` returns `None` instead of raising `asyncio.TimeoutError`.
-     - Found useful in some cases for me, `.asker()` has a default timeout of 2 minutes. 
-     - You can adjust it by passing as a argument. Refer the example code given below.
-
-# Examples:
-### For .asker():
-```python
-...
-    sendx = await client.send_message(chat_id, "`Send me your name:`")
-    answer = await client.asker(chat_id, filters=None, timeout=60)
-    if not answer: # `None` if timeout if no reply received.
-        return await sendx.reply_text("How long should I wait?, Eh! Bye!")
-    await answer.reply_text(f"{answer.text}, That's a cool name!")
-...
-```
-### For .ask():
-```python
-...
-    answer = await client.ask(chat_id, '*Send me your name:*', parse_mode=enums.ParseMode.MARKDOWN)
-    await client.send_message(chat_id, f'Your name is: {answer.text}')
-...
-```
-
-
-### Copyright & License
-This project includes code from:
-- **[kurimod](https://github.com/ohmyarthur/kurimod)**: Monkeypatcher logic and modern async compatibility fixes.
-- **Pyrogram**: Telegram MTProto API Client Library for Python. Copyright (C) 2017-2022 Dan <<https://github.com/delivrance>>
-- **pyromod**: Original conversation patch logic.
-
-Licensed under the terms of the [GNU Lesser General Public License v3 or later (LGPLv3+)](COPYING.lesser)