ferogram 0.2.0__tar.gz → 0.2.2__tar.gz

{ferogram-0.2.0 → ferogram-0.2.2}/Cargo.lock

@@ -274,9 +274,9 @@ dependencies = [
 
 [[package]]
 name = "ferogram"
-version = "0.3.8"
+version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "532d1f9f37f3579db6e95c22e40231eff18ba4f20820ae38b7a75a6459466922"
+checksum = "08d5a9e0d5162e8eb981904b15c41d7f3089640632d51a3ffcab7713c4df409b"
 dependencies = [
  "async-trait",
  "base64",
@@ -314,9 +314,9 @@ dependencies = [
 
 [[package]]
 name = "ferogram-connect"
-version = "0.3.8"
+version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "736861a82c40ba25195d1037463d54ec4e329f9b1e235e8bbe360678a861eaae"
+checksum = "8cdc49607faad2862b676b010b02e27d13ba2047d2253362cdf958c10efff92a"
 dependencies = [
  "ferogram-crypto",
  "ferogram-mtproto",
@@ -334,9 +334,9 @@ dependencies = [
 
 [[package]]
 name = "ferogram-crypto"
-version = "0.3.8"
+version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "db48b92a5c0ee7462a2a921a2c0bdd24fbc43a6e5ed96d79c19cc2534831f1e7"
+checksum = "d9df71920e40c6b6938df3ac0f4e85fe13968b48f0cbb0d0c06d98020384b02b"
 dependencies = [
  "aes",
  "ctr",
@@ -349,9 +349,9 @@ dependencies = [
 
 [[package]]
 name = "ferogram-fsm"
-version = "0.3.8"
+version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b5ab042df109225226c6d0e679de054bf68154bd1a851ec7f0cfc2ca3fb420fc"
+checksum = "751b3d201d60c38679fb363022bc65646144943b79bc17e37997d8738e2f5143"
 dependencies = [
  "async-trait",
  "dashmap",
@@ -362,9 +362,9 @@ dependencies = [
 
 [[package]]
 name = "ferogram-mtproto"
-version = "0.3.8"
+version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ab166b411950c2493b8da16ac12512e9ae17aecb7efee3f53be12b4b0c558462"
+checksum = "b4aa9b9d4bf5a80270e8ee81e65055c8ed7de9b4887df7d94de48d18564c692c"
 dependencies = [
  "ferogram-crypto",
  "ferogram-tl-types",
@@ -377,9 +377,9 @@ dependencies = [
 
 [[package]]
 name = "ferogram-mtsender"
-version = "0.3.8"
+version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "57b0dc5058983f9662555436af85cf33f0a30aefdd1896a0f74379f4ce3725cc"
+checksum = "c577e17c573111afe208b935c0a91ab51ab4df4040366010b3b4418d1fbdfecc"
 dependencies = [
  "ferogram-connect",
  "ferogram-crypto",
@@ -397,9 +397,9 @@ dependencies = [
 
 [[package]]
 name = "ferogram-parsers"
-version = "0.3.8"
+version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ae3bff00615fe04f7194b3392329877217183f45fe4eea88c4f13316d2238477"
+checksum = "2616847253ad2b3c90b18f18d8f9239275c295a378ed4cd24bddaec50df3550e"
 dependencies = [
  "ferogram-tl-types",
  "pulldown-cmark",
@@ -407,7 +407,7 @@ dependencies = [
 
 [[package]]
 name = "ferogram-py"
-version = "0.2.0"
+version = "0.2.2"
 dependencies = [
  "ferogram",
  "hex",
@@ -418,9 +418,9 @@ dependencies = [
 
 [[package]]
 name = "ferogram-session"
-version = "0.3.8"
+version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a33e4d826504cc88a184045ee375daec7df0e8193cc5495633e1001f76ee7829"
+checksum = "de8ac1fbffd7bb698fe3d78038edae17544220d2cf41fe583304efa61a551e94"
 dependencies = [
  "base64",
  "tracing",
@@ -428,24 +428,24 @@ dependencies = [
 
 [[package]]
 name = "ferogram-tl-gen"
-version = "0.3.8"
+version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a3791ca624d86bdf1d2cfee99d4238cfd9fbc9559cef4e1a089b12a7648e9ce3"
+checksum = "f9278407f5912be09141fa7827e39dd72851213ecf4b7c1462094a1012ffdef9"
 dependencies = [
  "ferogram-tl-parser",
 ]
 
 [[package]]
 name = "ferogram-tl-parser"
-version = "0.3.8"
+version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "97a4c074abe63bc6bef7fe46796e75e9b08126cbec9debe2082a8774b15204a2"
+checksum = "a2a592a2437f71ddda9ba45971bb70019c16a4cf5dd9afe941a7125232db1ff8"
 
 [[package]]
 name = "ferogram-tl-types"
-version = "0.3.8"
+version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "68ef7eab10bb0f30e6ccb1cfc8d24bc67036a4cd7197b9abd0798a6b229e6fd2"
+checksum = "f1b23759e460988fda70e73ed25ae4bf633e3430c60f8fbe4620198536238bd7"
 dependencies = [
  "ferogram-tl-gen",
  "ferogram-tl-parser",

{ferogram-0.2.0 → ferogram-0.2.2}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name        = "ferogram-py"
-version     = "0.2.0"
+version     = "0.2.2"
 edition     = "2024"
 description = "Python bindings for ferogram (Rust MTProto)"
 license     = "MIT OR Apache-2.0"
@@ -12,7 +12,7 @@ crate-type = ["cdylib"]
 
 [dependencies]
 hex                 = "0.4"
-ferogram            = "0.3.8"
+ferogram            = "0.4.0"
 pyo3                = { version = "0.24", features = ["extension-module", "abi3-py313"] }
 pyo3-async-runtimes = { version = "0.24", features = ["tokio-runtime"] }
 tokio               = { version = "1", features = ["full"] }

{ferogram-0.2.0 → ferogram-0.2.2}/FEATURES.md

@@ -4,7 +4,6 @@ Python bindings for the ferogram MTProto client.
 
 All client methods are async. The `peer` parameter accepts "@username", "me", or a numeric ID (int or string).
 
----
 
 ## Imports
 
@@ -36,7 +35,6 @@ from ferogram.raw.generated.functions.messages import SendMessage
 from ferogram.raw.generated.types.messages import Messages
 ```
 
----
 
 ## Client Setup
 
@@ -61,7 +59,6 @@ async with app as client:
 
 Credentials can also come from env vars: `API_ID`, `API_HASH`, `BOT_TOKEN`.
 
----
 
 ## Event Handlers
 
@@ -84,12 +81,12 @@ Decorators to register handlers. Each accepts zero or more filters.
 @app.on_shipping_query(*filters)
 @app.on_pre_checkout_query(*filters)
 @app.on_chat_boost(*filters)
+@app.on_guest_chat_query(*filters)
 @app.on_raw_update(*filters)
 ```
 
 Handler signature: `async def handler(client, update):`
 
----
 
 ## Filters
 
@@ -184,13 +181,23 @@ filters.or_(f1, f2)
 filters.not_(f1)
 ```
 
----
 
 ## Messaging
 
 ```python
 await client.send_message(peer, text, parse_mode=None)
 # parse_mode: None (plain) | "html" | "markdown"
+# Note: "markdown" uses MarkdownV2 format since ferogram 0.3.9.
+#   __text__ = Underline (was Italic in V1)
+#   ~text~   = Strike    (was ~~text~~ in V1)
+#   > text   = Blockquote (new)
+#   **> text = Expandable blockquote (new)
+# HTML parse_mode supports these tags:
+#   <b>, <strong>, <i>, <em>, <u>, <ins>, <s>, <del>, <strike>
+#   <tg-spoiler>, <span class="tg-spoiler">
+#   <blockquote>, <blockquote expandable>
+#   <tg-time unix="N" format="F">, <tg-emoji emoji-id="N">
+#   <code>, <pre>, <pre><code class="language-X">
 
 await client.send_to_self(text)
 await client.edit_message(peer, message_id, new_text)
@@ -210,6 +217,7 @@ await client.send_reaction(peer, message_id, emoji)
 await client.read_reactions(peer)
 await client.clear_recent_reactions()
 await client.get_reaction_list(peer, msg_id, limit=100) # -> [(peer_id, emoji)]
+await client.delete_reaction(peer, msg_id, participant) # report/remove a user's reaction
 await client.mark_as_read(peer)
 await client.clear_mentions(peer)
 await client.send_chat_action(peer, "typing")           # or ChatAction.TYPING
@@ -236,7 +244,6 @@ await message.react(emoji)
 `reply_to_message_id`, `via_bot_id`, `grouped_id`, `has_media`, `has_photo`, `has_document`,
 `is_forwarded`, `post_author`, `view_count`, `reply_count`
 
----
 
 ## Media
 
@@ -254,7 +261,6 @@ await client.edit_chat_photo(peer, path)
 await client.delete_profile_photos()
 ```
 
----
 
 ## Polls
 
@@ -262,12 +268,19 @@ await client.delete_profile_photos()
 await client.send_poll(
     peer, question, answers=["A", "B", "C"],
     quiz=False, correct_index=None, multiple_choice=False,
+    public_voters=False, shuffle_answers=False,
+    hide_results_until_close=False,
+    close_period=None,   # auto-close after N seconds (1-600)
+    close_date=None,     # auto-close at unix timestamp
+    solution=None,       # explanation shown after quiz answer
 )
 await client.send_vote(peer, msg_id, options=[b"\x00"])
 await client.get_poll_votes(peer, msg_id, limit=100)    # -> [(user_id, option_bytes)]
+await client.get_poll_results(peer, msg_id, poll_hash)
+await client.get_poll_stats(peer, msg_id)               # -> views count (int)
+await client.delete_reaction(peer, msg_id, participant) # report/remove a user's reaction
 ```
 
----
 
 ## Inline Bots
 
@@ -286,7 +299,6 @@ from ferogram import InlineMessageId
 await client.edit_inline_message(InlineMessageId(dc_id=2, id_bytes=b"..."), "new text")
 ```
 
----
 
 ## Chats & Groups
 
@@ -324,7 +336,6 @@ await client.mark_dialog_read(peer)
 
 `user_id`, `first_name`, `last_name`, `username`, `bot`, `status`, `admin_rank`, `full_name`
 
----
 
 ## Forum Topics
 
@@ -335,7 +346,6 @@ await client.edit_forum_topic(peer, topic_id, title=None, closed=None, hidden=No
 await client.delete_forum_topic_history(peer, top_msg_id)
 ```
 
----
 
 ## Join Requests
 
@@ -344,7 +354,6 @@ await client.join_request(peer, user_id, approve=True)
 await client.all_join_requests(peer, approve=True, link=None)
 ```
 
----
 
 ## Account & Profile
 
@@ -364,7 +373,6 @@ await client.export_session_string()                # -> str
 
 `id`, `first_name`, `last_name`, `username`, `phone`, `bot`, `full_name`, `mention`
 
----
 
 ## Contacts & Blocking
 
@@ -378,7 +386,6 @@ await client.unblock_user(peer)
 await client.get_blocked_users(limit=100)           # -> [int]
 ```
 
----
 
 ## Search
 
@@ -387,7 +394,6 @@ await client.search_messages(peer, query, limit=100)
 await client.search_global(query, limit=100)
 ```
 
----
 
 ## Drafts
 
@@ -397,7 +403,6 @@ await client.clear_all_drafts()
 await client.sync_drafts()
 ```
 
----
 
 ## Notifications
 
@@ -408,7 +413,6 @@ await client.get_notify_settings(peer)
 await client.update_notify_settings(peer, mute_until=None, silent=None, show_previews=None)
 ```
 
----
 
 ## Privacy
 
@@ -424,7 +428,6 @@ await client.set_privacy(PrivacyKey.PHONE_NUMBER, PrivacyRule.ALLOW_CONTACTS)
 
 **PrivacyRule:** `ALLOW_ALL`, `ALLOW_CONTACTS`, `DISALLOW_ALL`, `DISALLOW_CONTACTS`
 
----
 
 ## Sessions & Auth
 
@@ -437,7 +440,6 @@ token, expires = await client.export_login_token()
 username = await client.check_qr_login(token)   # None if still pending
 ```
 
----
 
 ## Bot Management
 
@@ -449,7 +451,6 @@ await client.get_bot_info(lang_code="")
 await client.open_mini_app(peer, app_type="main", app_value="")   # -> MiniAppSession
 ```
 
----
 
 ## Stats
 
@@ -457,9 +458,9 @@ await client.open_mini_app(peer, app_type="main", app_value="")   # -> MiniAppSe
 await client.get_broadcast_stats(peer)
 await client.get_megagroup_stats(peer)
 await client.get_game_high_scores(peer, msg_id, user_id)  # -> [(position, user_id, score)]
+await client.get_poll_stats(peer, msg_id)                 # -> views count (int)
 ```
 
----
 
 ## Payments
 
@@ -473,7 +474,6 @@ await client.send_invoice(
 )
 ```
 
----
 
 ## Peer Resolution
 
@@ -483,7 +483,6 @@ await client.resolve_username(username)         # -> int
 await client.warm_peer_cache_from_dialogs()
 ```
 
----
 
 ## Raw API
 
@@ -498,7 +497,6 @@ All four styles produce identical TL requests. The difference is only ergonomics
 | `from ferogram.raw.api import functions` | Compatibility only. Do not use for new code. |
 | Direct `generated` import | Advanced use: tooling, debugging, type checking. |
 
----
 
 ### 1. Namespace proxy (recommended)
 
@@ -524,7 +522,6 @@ result = await client.raw.channels.GetFullChannel(
 )
 ```
 
----
 
 ### 2. `functions` import (recommended for explicit control)
 
@@ -561,7 +558,6 @@ result = await client.invoke(
 result = await client(functions.users.GetFullUser(id=await client.resolve_peer("@user")))
 ```
 
----
 
 ### 3. `api` import (compatibility only)
 
@@ -579,7 +575,6 @@ result = await client.invoke(
 )
 ```
 
----
 
 ### 4. Direct class import (advanced)
 
@@ -605,7 +600,6 @@ result = await client.invoke(
 
 The `generated/` directory is internal codegen output. Direct imports from it are considered advanced usage and may change between versions.
 
----
 
 ## Logging
 
@@ -616,7 +610,18 @@ fero_log.setup()            # INFO to stderr
 fero_log.setup(level=10)   # DEBUG
 ```
 
----
+
+## GuestChatQuery
+
+Fired when a bot receives a guest-chat inline query (`updateBotGuestChatQuery`). Bots only.
+
+```python
+@app.on_guest_chat_query()
+async def handler(client, query):
+    # query.query_id  int
+    # query.qts       int
+    pass
+```
 
 ## ChatAction
 
@@ -635,8 +640,4 @@ ChatAction.RECORD_ROUND
 ChatAction.UPLOAD_ROUND
 ChatAction.CANCEL
 ```
----
-
-Thanks for reading.
 
-Have a great experience with ferogram.

{ferogram-0.2.0 → ferogram-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ferogram
-Version: 0.2.0
+Version: 0.2.2
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License

{ferogram-0.2.0 → ferogram-0.2.2}/ferogram/raw/__init__.py

@@ -35,5 +35,6 @@
 from . import tl
 _tl = tl
 from .generated import functions, types
+from .generated._tl_schema import LAYER
 
-__all__ = ["functions", "types", "tl", "_tl"]
+__all__ = ["functions", "types", "tl", "_tl", "LAYER"]

{ferogram-0.2.0 → ferogram-0.2.2}/ferogram/raw/codegen.py

@@ -90,6 +90,14 @@ def parse_tl(path: Path) -> tuple[list[Constructor], list[Constructor]]:
     return types, funcs
 
 
+def parse_layer(path: Path) -> int:
+    for line in path.read_text().splitlines():
+        m = re.match(r"^//\s*LAYER\s+(\d+)", line.strip())
+        if m:
+            return int(m.group(1))
+    return 0
+
+
 import keyword as _keyword
 
 def py_class(tl_name: str) -> str:
@@ -199,10 +207,22 @@ def build_schema_by_cid(constructors: list[Constructor]) -> str:
 LICENSE = """\
 # Copyright (c) Ankit Chaubey <ankitchaubey.dev@gmail.com>
 # SPDX-License-Identifier: MIT OR Apache-2.0
+#
+# ferogram is a high-performance Telegram MTProto framework written in Rust.
+# ferogram-py provides Python bindings built on top of the Rust core for
+# building Telegram clients, bots, and applications with a simple API.
+#
+# Rust core: https://github.com/ankit-chaubey/ferogram
+# Python bindings: https://github.com/ankit-chaubey/ferogram-py
+#
+# If you use or modify this code, keep this notice at the top of the file
+# and include the LICENSE-MIT or LICENSE-APACHE file from this repository.
 """
 
 NS_HEADER = """\
 # auto-generated by ferogram raw codegen - do not edit
+
+""" + LICENSE + """
 from __future__ import annotations
 from typing import Any
 from ... import tl as _tl
@@ -230,8 +250,9 @@ def write_namespace_pkg(
 
     # flat imports - re-exports every class from every namespace module
     init_lines = [
+        "# auto-generated - do not edit\n",
+        "",
         LICENSE,
-        "# auto-generated - do not edit",
         "# Flat imports so both styles work:",
         "#   raw.functions.messages.GetHistory(...)   ← namespace style",
         "#   raw.functions.GetHistory(...)            ← flat style (convenience)",
@@ -252,6 +273,7 @@ def write_namespace_pkg(
 
 def generate(tl_path: Path, out_dir: Path) -> None:
     types, funcs = parse_tl(tl_path)
+    layer = parse_layer(tl_path)
     out_dir.mkdir(parents=True, exist_ok=True)
 
     all_constructors = types + funcs
@@ -260,7 +282,9 @@ def generate(tl_path: Path, out_dir: Path) -> None:
 
     # _tl_schema.py - unchanged format, used by serializer
     (out_dir / "_tl_schema.py").write_text(
-        "# auto-generated schema - do not edit\n"
+        "# auto-generated schema - do not edit\n\n"
+        + LICENSE + "\n"
+        + (f"LAYER = {layer}\n\n" if layer else "")
         + schema_str + "\n\n"
         + schema_by_cid + "\n"
     )
@@ -279,7 +303,8 @@ def generate(tl_path: Path, out_dir: Path) -> None:
 
     # generated/__init__.py
     (out_dir / "__init__.py").write_text(
-        LICENSE + "\n"
+        "# auto-generated - do not edit\n\n"
+        + LICENSE + "\n"
         "from . import functions, types\n\n"
         "__all__ = ['functions', 'types']\n"
     )

{ferogram-0.2.0 → ferogram-0.2.2}/ferogram/raw/generated/__init__.py

@@ -1,3 +1,5 @@
+# auto-generated - do not edit
+
 # Copyright (c) Ankit Chaubey <ankitchaubey.dev@gmail.com>
 # SPDX-License-Identifier: MIT OR Apache-2.0
 #
@@ -11,7 +13,6 @@
 # If you use or modify this code, keep this notice at the top of the file
 # and include the LICENSE-MIT or LICENSE-APACHE file from this repository.
 
-
 from . import functions, types
 
 __all__ = ['functions', 'types']