ferogram 0.1.9__tar.gz → 0.2.1__tar.gz

{ferogram-0.1.9 → ferogram-0.2.1}/Cargo.lock

@@ -274,16 +274,19 @@ dependencies = [
 
 [[package]]
 name = "ferogram"
-version = "0.3.6"
+version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fcdbb324f99754ac070a6222d288fd84b4e7d2a32e035cbbca0326c4ec11fbbc"
+checksum = "08d5a9e0d5162e8eb981904b15c41d7f3089640632d51a3ffcab7713c4df409b"
 dependencies = [
  "async-trait",
  "base64",
  "chrono",
  "dashmap",
+ "ferogram-connect",
  "ferogram-crypto",
+ "ferogram-fsm",
  "ferogram-mtproto",
+ "ferogram-mtsender",
  "ferogram-parsers",
  "ferogram-session",
  "ferogram-tl-types",
@@ -309,11 +312,31 @@ dependencies = [
  "tracing",
 ]
 
+[[package]]
+name = "ferogram-connect"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8cdc49607faad2862b676b010b02e27d13ba2047d2253362cdf958c10efff92a"
+dependencies = [
+ "ferogram-crypto",
+ "ferogram-mtproto",
+ "ferogram-tl-types",
+ "flate2",
+ "getrandom 0.2.17",
+ "hmac",
+ "metrics",
+ "sha2",
+ "socket2 0.5.10",
+ "tokio",
+ "tokio-socks",
+ "tracing",
+]
+
 [[package]]
 name = "ferogram-crypto"
-version = "0.3.6"
+version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f485d25585c155a446e50d7a04e16f303f6c718166b0a714d6671e3c638b9bb7"
+checksum = "d9df71920e40c6b6938df3ac0f4e85fe13968b48f0cbb0d0c06d98020384b02b"
 dependencies = [
  "aes",
  "ctr",
@@ -324,11 +347,24 @@ dependencies = [
  "sha2",
 ]
 
+[[package]]
+name = "ferogram-fsm"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "751b3d201d60c38679fb363022bc65646144943b79bc17e37997d8738e2f5143"
+dependencies = [
+ "async-trait",
+ "dashmap",
+ "serde",
+ "serde_json",
+ "tokio",
+]
+
 [[package]]
 name = "ferogram-mtproto"
-version = "0.3.6"
+version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9afa1f669cd3182819e591125387f89ba9bf8844ead834dbd0adf846c2f731c5"
+checksum = "b4aa9b9d4bf5a80270e8ee81e65055c8ed7de9b4887df7d94de48d18564c692c"
 dependencies = [
  "ferogram-crypto",
  "ferogram-tl-types",
@@ -339,11 +375,31 @@ dependencies = [
  "sha1",
 ]
 
+[[package]]
+name = "ferogram-mtsender"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c577e17c573111afe208b935c0a91ab51ab4df4040366010b3b4418d1fbdfecc"
+dependencies = [
+ "ferogram-connect",
+ "ferogram-crypto",
+ "ferogram-mtproto",
+ "ferogram-session",
+ "ferogram-tl-types",
+ "flate2",
+ "getrandom 0.2.17",
+ "metrics",
+ "sha2",
+ "socket2 0.5.10",
+ "tokio",
+ "tracing",
+]
+
 [[package]]
 name = "ferogram-parsers"
-version = "0.3.6"
+version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ca6af91b70fed33554e85c4e49a852cb457fc5285f201d523d868be918ce0573"
+checksum = "2616847253ad2b3c90b18f18d8f9239275c295a378ed4cd24bddaec50df3550e"
 dependencies = [
  "ferogram-tl-types",
  "pulldown-cmark",
@@ -351,7 +407,7 @@ dependencies = [
 
 [[package]]
 name = "ferogram-py"
-version = "0.1.9"
+version = "0.2.1"
 dependencies = [
  "ferogram",
  "hex",
@@ -362,9 +418,9 @@ dependencies = [
 
 [[package]]
 name = "ferogram-session"
-version = "0.3.6"
+version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0ec78ed52c7754d273a3e9e04969607775ff94f236b2406dee286076327209f4"
+checksum = "de8ac1fbffd7bb698fe3d78038edae17544220d2cf41fe583304efa61a551e94"
 dependencies = [
  "base64",
  "tracing",
@@ -372,24 +428,24 @@ dependencies = [
 
 [[package]]
 name = "ferogram-tl-gen"
-version = "0.3.6"
+version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a41e71db9a199a5a5af641280738d514dd49e764c51ba4c0cbac0f10ed0c7a46"
+checksum = "f9278407f5912be09141fa7827e39dd72851213ecf4b7c1462094a1012ffdef9"
 dependencies = [
  "ferogram-tl-parser",
 ]
 
 [[package]]
 name = "ferogram-tl-parser"
-version = "0.3.6"
+version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ed6b0a007fb90b406669d5cadd9ef993cbea12c67132f7493a75d1acac80088c"
+checksum = "a2a592a2437f71ddda9ba45971bb70019c16a4cf5dd9afe941a7125232db1ff8"
 
 [[package]]
 name = "ferogram-tl-types"
-version = "0.3.6"
+version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cca9c9085ef9b2b636c3819470bd84b168cc7f58639989ab4c0996eff556ebea"
+checksum = "f1b23759e460988fda70e73ed25ae4bf633e3430c60f8fbe4620198536238bd7"
 dependencies = [
  "ferogram-tl-gen",
  "ferogram-tl-parser",

{ferogram-0.1.9 → ferogram-0.2.1}/Cargo.toml

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

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

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

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name        = "ferogram"
-version     = "0.1.9"
+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.1.9 → ferogram-0.2.1}/src/auth.rs

@@ -45,21 +45,37 @@ pub struct ClientBuilder {
     pub api_id: i32,
     pub api_hash: String,
     pub session: String,
+    pub allow_zero_hash: bool,
 }
 
 #[pymethods]
 impl ClientBuilder {
+    /// For bots only: skip needing a cached access hash.
+    /// Do NOT enable on user accounts.
+    fn experimental_allow_zero_hash(mut slf: PyRefMut<'_, Self>) -> PyRefMut<'_, Self> {
+        slf.allow_zero_hash = true;
+        slf
+    }
+
     fn connect<'py>(&self, py: Python<'py>) -> PyResult<Bound<'py, PyAny>> {
-        let (api_id, api_hash, session) =
-            (self.api_id, self.api_hash.clone(), self.session.clone());
+        let (api_id, api_hash, session, allow_zero_hash) = (
+            self.api_id,
+            self.api_hash.clone(),
+            self.session.clone(),
+            self.allow_zero_hash,
+        );
         future_into_py(py, async move {
-            let (client, shutdown) = ferogram::Client::builder()
+            let mut builder = ferogram::Client::builder()
                 .api_id(api_id)
                 .api_hash(api_hash)
-                .session(session)
-                .connect()
-                .await
-                .map_err(py_err)?;
+                .session(session);
+            if allow_zero_hash {
+                builder = builder.experimental_features(ferogram::ExperimentalFeatures {
+                    allow_zero_hash: true,
+                    ..Default::default()
+                });
+            }
+            let (client, shutdown) = builder.connect().await.map_err(py_err)?;
             Ok(crate::client::make_client(client, shutdown))
         })
     }

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

@@ -18,6 +18,7 @@ use std::sync::Arc;
 use tokio::sync::Mutex;
 
 use crate::{auth::*, message::from_incoming, py_err, types::*};
+use ferogram::PeerExt;
 use ferogram::tl;
 
 #[pyclass]
@@ -78,6 +79,7 @@ impl Client {
             api_id,
             api_hash,
             session,
+            allow_zero_hash: false,
         }
     }
 
@@ -238,8 +240,8 @@ impl Client {
     fn send_to_self<'py>(&self, py: Python<'py>, text: String) -> PyResult<Bound<'py, PyAny>> {
         let c = Arc::clone(&self.inner);
         future_into_py(py, async move {
-            c.send_to_self(text).await.map_err(py_err)?;
-            Ok(())
+            let m = c.send_to_self(text).await.map_err(py_err)?;
+            Ok(from_incoming(m, Some(c)))
         })
     }
 
@@ -283,9 +285,14 @@ impl Client {
     ) -> PyResult<Bound<'py, PyAny>> {
         let c = Arc::clone(&self.inner);
         future_into_py(py, async move {
-            c.forward_messages(destination, &message_ids, source)
-                .await
-                .map_err(py_err)?;
+            c.forward_messages(
+                destination,
+                &message_ids,
+                source,
+                ferogram::ForwardOptions::default(),
+            )
+            .await
+            .map_err(py_err)?;
             Ok(())
         })
     }
@@ -1117,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>,
@@ -1127,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 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 {
-            let refs: Vec<&str> = answers.iter().map(String::as_str).collect();
-            c.send_poll(peer, question, &refs, quiz, correct_index, multiple_choice)
+            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,
@@ -1340,7 +1428,12 @@ impl Client {
         let c = Arc::clone(&self.inner);
         future_into_py(py, async move {
             let msgs = c
-                .forward_messages(destination, &message_ids, source)
+                .forward_messages(
+                    destination,
+                    &message_ids,
+                    source,
+                    ferogram::ForwardOptions::default(),
+                )
                 .await
                 .map_err(py_err)?;
             Ok(msgs
@@ -2408,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,
                 },
             );
@@ -2464,22 +2557,11 @@ impl Client {
             let pairs: Vec<(i64, Vec<u8>)> = result
                 .votes
                 .into_iter()
-                .map(|v| {
-                    fn peer_id(p: &tl::enums::Peer) -> i64 {
-                        match p {
-                            tl::enums::Peer::User(u) => u.user_id,
-                            tl::enums::Peer::Chat(c) => c.chat_id,
-                            tl::enums::Peer::Channel(ch) => ch.channel_id,
-                        }
-                    }
-                    match v {
-                        tl::enums::MessagePeerVote::MessagePeerVote(x) => {
-                            (peer_id(&x.peer), x.option)
-                        }
-                        tl::enums::MessagePeerVote::InputOption(x) => (peer_id(&x.peer), vec![]),
-                        tl::enums::MessagePeerVote::Multiple(x) => {
-                            (peer_id(&x.peer), x.options.into_iter().flatten().collect())
-                        }
+                .map(|v| match v {
+                    tl::enums::MessagePeerVote::MessagePeerVote(x) => (x.peer.bare_id(), x.option),
+                    tl::enums::MessagePeerVote::InputOption(x) => (x.peer.bare_id(), vec![]),
+                    tl::enums::MessagePeerVote::Multiple(x) => {
+                        (x.peer.bare_id(), x.options.into_iter().flatten().collect())
                     }
                 })
                 .collect();
@@ -2551,22 +2633,22 @@ impl Client {
     ) -> PyResult<Bound<'py, PyAny>> {
         let c = Arc::clone(&self.inner);
         future_into_py(py, async move {
-            let price_refs: Vec<(&str, i64)> =
-                prices.iter().map(|(l, a)| (l.as_str(), *a)).collect();
             let msg = c
                 .send_invoice(
                     peer,
                     title,
                     description,
                     payload,
-                    currency,
-                    &price_refs,
-                    photo_url,
-                    need_name,
-                    need_phone,
-                    need_email,
-                    need_shipping_address,
-                    is_flexible,
+                    ferogram::InvoiceOptions {
+                        currency,
+                        prices,
+                        photo_url,
+                        need_name,
+                        need_phone,
+                        need_email,
+                        need_shipping_address,
+                        is_flexible,
+                    },
                 )
                 .await
                 .map_err(py_err)?;
@@ -2939,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.1.9 → ferogram-0.2.1}/src/lib.rs

@@ -60,10 +60,12 @@ fn _ferogram(m: &Bound<'_, PyModule>) -> PyResult<()> {
     m.add_class::<updates::PollVote>()?;
     m.add_class::<updates::BotStopped>()?;
     m.add_class::<updates::RawUpdate>()?;
-    // new in 0.3.6
+    // new in 0.3.6 / updated in 0.3.7 (binding v0.2.0)
     m.add_class::<types::ShippingQuery>()?;
     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.1.9 → ferogram-0.2.1}/src/message.rs

@@ -203,7 +203,7 @@ impl Message {
         let ids = vec![self.id];
         future_into_py(py, async move {
             client
-                .forward_messages(peer, &ids, src)
+                .forward_messages(peer, &ids, src, ferogram::ForwardOptions::default())
                 .await
                 .map_err(py_err)?;
             Ok(())

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

@@ -11,6 +11,7 @@
 // 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.
 
+use ferogram::PeerExt;
 use ferogram::tl;
 use pyo3::prelude::*;
 use pyo3_async_runtimes::tokio::future_into_py;
@@ -21,14 +22,6 @@ use crate::{message::from_incoming, py_err};
 
 // helpers
 
-fn peer_to_id(p: &tl::enums::Peer) -> i64 {
-    match p {
-        tl::enums::Peer::User(u) => u.user_id,
-        tl::enums::Peer::Chat(c) => c.chat_id,
-        tl::enums::Peer::Channel(c) => c.channel_id,
-    }
-}
-
 fn reaction_str(r: &tl::enums::Reaction) -> String {
     match r {
         tl::enums::Reaction::Emoji(e) => e.emoticon.clone(),
@@ -326,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 {
@@ -378,7 +389,7 @@ pub fn update_to_py(
             )
         }
         ferogram::update::Update::CallbackQuery(q) => {
-            let chat_id = q.chat_peer.as_ref().map(peer_to_id);
+            let chat_id = q.chat_peer.as_ref().map(|p| p.bare_id());
             ok!(
                 "callback_query",
                 CallbackQuery {
@@ -399,7 +410,7 @@ pub fn update_to_py(
                     user_id: q.user_id,
                     query: q.query,
                     offset: q.offset,
-                    peer_id: q.peer.as_ref().map(peer_to_id),
+                    peer_id: q.peer.as_ref().map(|p| p.bare_id()),
                 }
             )
         }
@@ -437,7 +448,7 @@ pub fn update_to_py(
             ok!(
                 "chat_action",
                 ChatAction {
-                    peer_id: peer_to_id(&a.peer),
+                    peer_id: a.peer.bare_id(),
                     user_id: a.user_id,
                     action: action_str(&a.action).to_string(),
                 }
@@ -459,7 +470,7 @@ pub fn update_to_py(
             ok!(
                 "join_request",
                 JoinRequest {
-                    peer_id: peer_to_id(&r.peer),
+                    peer_id: r.peer.bare_id(),
                     user_id: r.user_id,
                     about: r.about,
                     date: r.date,
@@ -470,10 +481,10 @@ pub fn update_to_py(
             ok!(
                 "message_reaction",
                 MessageReaction {
-                    peer_id: peer_to_id(&r.peer),
+                    peer_id: r.peer.bare_id(),
                     msg_id: r.msg_id,
                     date: r.date,
-                    actor_id: peer_to_id(&r.actor),
+                    actor_id: r.actor.bare_id(),
                     old_reactions: r.old_reactions.iter().map(reaction_str).collect(),
                     new_reactions: r.new_reactions.iter().map(reaction_str).collect(),
                 }
@@ -484,7 +495,7 @@ pub fn update_to_py(
                 "poll_vote",
                 PollVote {
                     poll_id: v.poll_id,
-                    peer_id: peer_to_id(&v.peer),
+                    peer_id: v.peer.bare_id(),
                     positions: v.positions,
                 }
             )
@@ -540,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('(')