ferogram 0.2.0__tar.gz → 0.2.1__tar.gz

{ferogram-0.2.0 → ferogram-0.2.1}/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.1"
 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.1}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name        = "ferogram-py"
-version     = "0.2.0"
+version     = "0.2.1"
 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.1}/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.1}/PKG-INFO

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

{ferogram-0.2.0 → ferogram-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name        = "ferogram"
-version     = "0.2.0"
+version     = "0.2.1"
 description = "Python wrapper for ferogram, blazing-fast Rust MTProto library for Telegram."
 readme      = "README.md"
 license     = { text = "MIT OR Apache-2.0" }

{ferogram-0.2.0 → ferogram-0.2.1}/src/client.rs

@@ -1124,7 +1124,18 @@ impl Client {
     // polls
 
     #[allow(clippy::too_many_arguments)]
-    #[pyo3(signature = (peer, question, answers, quiz = false, correct_index = None, multiple_choice = false))]
+    #[pyo3(signature = (
+        peer, question, answers,
+        quiz = false,
+        correct_index = None,
+        multiple_choice = false,
+        public_voters = false,
+        shuffle_answers = false,
+        hide_results_until_close = false,
+        close_period = None,
+        close_date = None,
+        solution = None,
+    ))]
     fn send_poll<'py>(
         &self,
         py: Python<'py>,
@@ -1134,17 +1145,87 @@ impl Client {
         quiz: bool,
         correct_index: Option<usize>,
         multiple_choice: bool,
+        public_voters: bool,
+        shuffle_answers: bool,
+        hide_results_until_close: bool,
+        close_period: Option<i32>,
+        close_date: Option<i32>,
+        solution: Option<String>,
     ) -> PyResult<Bound<'py, PyAny>> {
         let c = Arc::clone(&self.inner);
         future_into_py(py, async move {
-            let refs: Vec<&str> = answers.iter().map(String::as_str).collect();
-            c.send_poll(peer, question, &refs, quiz, correct_index, multiple_choice)
+            let mut builder = ferogram::PollBuilder::new(question).answers(answers);
+            if quiz {
+                builder = builder.quiz(true);
+            }
+            if let Some(idx) = correct_index {
+                builder = builder.correct_index(idx);
+            }
+            if multiple_choice {
+                builder = builder.multiple_choice(true);
+            }
+            if public_voters {
+                builder = builder.public_voters(true);
+            }
+            if shuffle_answers {
+                builder = builder.shuffle_answers(true);
+            }
+            if hide_results_until_close {
+                builder = builder.hide_results_until_close(true);
+            }
+            if let Some(secs) = close_period {
+                builder = builder.close_period(secs);
+            }
+            if let Some(ts) = close_date {
+                builder = builder.close_date(ts);
+            }
+            if let Some(text) = solution {
+                builder = builder.solution(text);
+            }
+            c.send_poll(peer, builder).await.map_err(py_err)?;
+            Ok(())
+        })
+    }
+
+    fn delete_reaction<'py>(
+        &self,
+        py: Python<'py>,
+        peer: String,
+        msg_id: i32,
+        participant: String,
+    ) -> PyResult<Bound<'py, PyAny>> {
+        let c = Arc::clone(&self.inner);
+        future_into_py(py, async move {
+            c.delete_reaction(peer, msg_id, participant)
                 .await
                 .map_err(py_err)?;
             Ok(())
         })
     }
 
+    fn get_poll_stats<'py>(
+        &self,
+        py: Python<'py>,
+        peer: String,
+        msg_id: i32,
+    ) -> PyResult<Bound<'py, PyAny>> {
+        let c = Arc::clone(&self.inner);
+        future_into_py(py, async move {
+            let stats = c.get_poll_stats(peer, msg_id).await.map_err(py_err)?;
+            let json = match stats.votes_graph {
+                tl::enums::StatsGraph::StatsGraph(g) => {
+                    let tl::enums::DataJson::DataJson(dj) = g.json;
+                    dj.data
+                }
+                tl::enums::StatsGraph::Async(a) => format!("async:{}", a.token),
+                tl::enums::StatsGraph::Error(e) => {
+                    return Err(pyo3::exceptions::PyRuntimeError::new_err(e.error));
+                }
+            };
+            Ok(json)
+        })
+    }
+
     // options: list of 1-byte option indices (e.g. [b'\x00'] for first option)
     fn send_vote<'py>(
         &self,
@@ -2420,8 +2501,8 @@ impl Client {
                     silent: None,
                     mute_until: Some(mute_until),
                     sound: None,
-                    stories_muted: false,
-                    stories_hide_sender: false,
+                    stories_muted: Some(false),
+                    stories_hide_sender: Some(false),
                     stories_sound: None,
                 },
             );
@@ -2940,8 +3021,8 @@ impl Client {
                     silent,
                     mute_until,
                     sound: None,
-                    stories_muted: false,
-                    stories_hide_sender: false,
+                    stories_muted: Some(false),
+                    stories_hide_sender: Some(false),
                     stories_sound: None,
                 },
             );

{ferogram-0.2.0 → ferogram-0.2.1}/src/lib.rs

@@ -65,5 +65,7 @@ fn _ferogram(m: &Bound<'_, PyModule>) -> PyResult<()> {
     m.add_class::<types::PreCheckoutQuery>()?;
     m.add_class::<types::ChatBoost>()?;
     m.add_class::<types::MiniAppSession>()?;
+    // new in 0.3.9 (binding v0.2.1)
+    m.add_class::<updates::GuestChatQuery>()?;
     Ok(())
 }

{ferogram-0.2.0 → ferogram-0.2.1}/src/updates.rs

@@ -319,6 +319,24 @@ impl BotStopped {
     }
 }
 
+/// A bot received a guest-chat inline query (bots only).
+#[pyclass]
+pub struct GuestChatQuery {
+    #[pyo3(get)]
+    pub query_id: i64,
+    #[pyo3(get)]
+    pub qts: i32,
+    #[allow(dead_code)]
+    pub(crate) client: Arc<ferogram::Client>,
+}
+
+#[pymethods]
+impl GuestChatQuery {
+    fn __repr__(&self) -> String {
+        format!("GuestChatQuery(query_id={})", self.query_id)
+    }
+}
+
 // raw fallback for unmapped update types
 #[pyclass]
 pub struct RawUpdate {
@@ -533,6 +551,16 @@ pub fn update_to_py(
                 }
             )
         }
+        ferogram::update::Update::GuestChatQuery(q) => {
+            ok!(
+                "guest_chat_query",
+                GuestChatQuery {
+                    query_id: q.query_id,
+                    qts: q.qts,
+                    client,
+                }
+            )
+        }
         ferogram::update::Update::Raw(r) => {
             let name = format!("{:?}", r.inner)
                 .split('(')