electrogram 0.2.224__tar.gz → 0.2.224.1__tar.gz

electrogram-0.2.224.1/.gitignore

@@ -0,0 +1,26 @@
+# Pyrogram generated code
+pyrogram/errors/exceptions/
+pyrogram/raw/functions/
+pyrogram/raw/types/
+pyrogram/raw/base/
+pyrogram/raw/all.py
+
+# Python cache
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Virtual Environment
+venv/
+.venv/
+
+# Docs build
+docs/build/
+docs/source/api/bound-methods/
+docs/source/api/methods/
+docs/source/api/types/
+docs/source/telegram/
+Electrogram-docs/
+
+# Ruff
+.ruff_cache/

{electrogram-0.2.224 → electrogram-0.2.224.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: electrogram
-Version: 0.2.224
+Version: 0.2.224.1
 Summary: Telegram MTProto API framework in Python, designed for fluid user and bot interactions.
 Project-URL: homepage, https://github.com/5hojib/electrogram
 Project-URL: community, https://t.me/ProjectAeon
@@ -27,8 +27,8 @@ Requires-Dist: pytest-asyncio; extra == 'dev'
 Requires-Dist: pytest-cov; extra == 'dev'
 Requires-Dist: twine; extra == 'dev'
 Provides-Extra: docs
-Requires-Dist: sphinx; extra == 'docs'
 Requires-Dist: sphinx-autobuild; extra == 'docs'
 Requires-Dist: sphinx-copybutton; extra == 'docs'
 Requires-Dist: sphinx-immaterial; extra == 'docs'
+Requires-Dist: sphinx<8.0.0; extra == 'docs'
 Requires-Dist: tornado; extra == 'docs'

{electrogram-0.2.224 → electrogram-0.2.224.1}/build-docs.sh

@@ -3,20 +3,19 @@
 set -e
 
 export GITHUB_TOKEN
-VENV="$(pwd)/venv"
-export VENV
+
+uv sync --extra docs
 
 make clean
 make clean-docs
-make venv
-make api
-"$VENV/bin/pip" install -e '.[docs]'
+(cd compiler/api && uv run python compiler.py)
+(cd compiler/errors && uv run python compiler.py)
 
 cd compiler/docs
-"$VENV/bin/python" compiler.py
+uv run python compiler.py
 cd ../..
 
-"$VENV/bin/sphinx-build" -b html "docs/source" "docs/build/html" -j auto
+uv run sphinx-build -b html "docs/source" "docs/build/html" -j auto
 
 REPO_URL="https://5hojib:$GITHUB_TOKEN@github.com/5hojib/Electrogram-docs.git"
 CLONE_DIR="Electrogram-docs"

{electrogram-0.2.224 → electrogram-0.2.224.1}/docs/source/conf.py

@@ -35,7 +35,7 @@ source_suffix = ".rst"
 autodoc_member_order = "bysource"
 
 # Paths for templates and static files
-templates_path = ["../resources/templates"]
+templates_path = []
 
 # HTML options
 html_copy_source = False
@@ -45,7 +45,7 @@ html_show_sourcelink = True
 html_permalinks = False
 html_show_copyright = False
 html_show_sphinx = False
-html_static_path = ["../resources/static", "_static"]
+html_static_path = ["_static"]
 
 # Napoleon settings
 napoleon_use_rtype = False
@@ -110,7 +110,6 @@ html_favicon = "_static/fav.svg"
 
 # LaTeX configuration
 latex_engine = "xelatex"
-latex_logo = "../resources/static/img/pyrogram.png"
 latex_elements = {
     "pointsize": "12pt",
     "fontpkg": r"""

{electrogram-0.2.224 → electrogram-0.2.224.1}/docs/source/faq/socket-send-oserror-timeouterror-connection-lost-reset.rst

@@ -6,7 +6,5 @@ Another reason could be because you are blocking the event loop for too long.
 
 You can consider the following:
 
-- Use Electrogram asynchronously in its intended way.
-- Use shorter non-asynchronous processing loops.
 - Use ``asyncio.sleep()`` instead of ``time.sleep()``.
 - Use a stable network connection.

{electrogram-0.2.224 → electrogram-0.2.224.1}/docs/source/index.rst

@@ -116,7 +116,6 @@ Meta
     topics/more-on-updates
     topics/client-settings
     topics/text-formatting
-    topics/synchronous
     topics/smart-plugins
     topics/storage-engines
     topics/serializing

{electrogram-0.2.224 → electrogram-0.2.224.1}/docs/source/topics/scheduling.rst

@@ -4,8 +4,8 @@ Scheduling Tasks
 Scheduling tasks means executing one or more functions periodically at pre-defined intervals or after a delay. This is
 useful, for example, to send recurring messages to specific chats or users.
 
-This page will show examples on how to integrate Electrogram with ``apscheduler`` in both asynchronous and
-non-asynchronous contexts. For more detailed information, you can visit and learn from the library documentation.
+This page will show examples of how to integrate Electrogram with ``apscheduler``.
+For more detailed information, you can visit and learn from the library documentation.
 
 .. contents:: Contents
     :backlinks: none
@@ -20,9 +20,6 @@ Using apscheduler
 - Install with ``pip3 install apscheduler``
 - Documentation: https://apscheduler.readthedocs.io
 
-Asynchronously
-^^^^^^^^^^^^^^
-
 .. code-block:: python
 
     from apscheduler.schedulers.asyncio import AsyncIOScheduler
@@ -41,25 +38,3 @@ Asynchronously
 
     scheduler.start()
     app.run()
-
-Non-Asynchronously
-^^^^^^^^^^^^^^^^^^
-
-.. code-block:: python
-
-    from apscheduler.schedulers.background import BackgroundScheduler
-
-    from pyrogram import Client
-
-    app = Client("my_account")
-
-
-    def job():
-        app.send_message("me", "Hi!")
-
-
-    scheduler = BackgroundScheduler()
-    scheduler.add_job(job, "interval", seconds=3)
-
-    scheduler.start()
-    app.run()

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyproject.toml

@@ -46,7 +46,7 @@ dev = [
 ]
 
 docs = [
-    "sphinx",
+    "sphinx<8.0.0",
     "sphinx-immaterial",
     "sphinx_copybutton",
     "sphinx-autobuild",

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/__init__.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-__version__ = "v0.2.224"
+__version__ = "v0.2.224.1"
 __license__ = "MIT License"
 
 from concurrent.futures.thread import ThreadPoolExecutor
@@ -23,7 +23,8 @@ crypto_executor = ThreadPoolExecutor(1, thread_name_prefix="CryptoWorker")
 # ruff: noqa: E402
 from . import enums, errors, filters, handlers, raw, types
 from .client import Client
-from .sync import compose, idle
+from .methods.utilities.compose import compose
+from .methods.utilities.idle import idle
 
 __all__ = [
     "Client",

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/client.py

@@ -348,13 +348,6 @@ class Client(Methods):
         }
         self.loop = asyncio.get_event_loop()
 
-    def __enter__(self):
-        return self.start()
-
-    def __exit__(self, *args):
-        with contextlib.suppress(ConnectionError):
-            self.stop()
-
     async def __aenter__(self):
         return await self.start()
 

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/filters.py

@@ -917,8 +917,10 @@ class chat(Filter, set):
 
 class topic(Filter, set):
     """Filter messages coming from one or more topics.
+
     You can use `set bound methods <https://docs.python.org/3/library/stdtypes.html#set>`_ to manipulate the
     topics container.
+
     Parameters:
         topics (``int`` | ``list``):
             Pass one or more topic ids to filter messages in specific topics.

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/methods/business/create_invoice_link.py

@@ -140,7 +140,7 @@ class CreateInvoiceLink:
                 payload=payload.encode() if isinstance(payload, str) else payload,
                 provider=provider_token,
                 provider_data=raw.types.DataJSON(
-                    data=provider_data if provider_data else "{}",
+                    data=provider_data or "{}",
                 ),
                 start_param=start_parameter,
             ),

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/methods/business/send_invoice.py

@@ -186,7 +186,7 @@ class SendInvoice:
                     payload=encoded_payload,
                     provider=provider,
                     provider_data=raw.types.DataJSON(
-                        data=provider_data if provider_data else "{}",
+                        data=provider_data or "{}",
                     ),
                     photo=raw.types.InputWebDocument(
                         url=photo_url,

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/methods/messages/get_available_effects.py

@@ -34,7 +34,7 @@ class GetAvailableEffects:
                 await types.AvailableEffect._parse(
                     self,
                     effect,
-                    documents.get(effect.effect_sticker_id, None),
+                    documents.get(effect.effect_sticker_id),
                 )
                 for effect in r.effects
             ],

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/methods/utilities/__init__.py

@@ -5,7 +5,6 @@ from .export_session_string import ExportSessionString
 from .remove_handler import RemoveHandler
 from .restart import Restart
 from .run import Run
-from .run_sync import RunSync
 from .start import Start
 from .stop import Stop
 from .stop_transmission import StopTransmissionError
@@ -17,7 +16,6 @@ class Utilities(
     RemoveHandler,
     Restart,
     Run,
-    RunSync,
     Start,
     Stop,
     StopTransmissionError,

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/methods/utilities/run.py

@@ -1,7 +1,6 @@
 from __future__ import annotations
 
 import asyncio
-import inspect
 from typing import TYPE_CHECKING
 
 from pyrogram.methods.utilities.idle import idle
@@ -59,11 +58,7 @@ class Run:
 
         if coroutine is not None:
             run(coroutine)
-        elif inspect.iscoroutinefunction(self.start):
+        else:
             run(self.start())
             run(idle())
             run(self.stop())
-        else:
-            self.start()
-            run(idle())
-            self.stop()

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/parser/parser.py

@@ -14,7 +14,7 @@ class Parser:
         self.markdown = Markdown(client)
 
     async def parse(self, text: str, mode: enums.ParseMode | None = None):
-        text = str(text if text else "").strip()
+        text = str(text or "").strip()
 
         if mode is None:
             mode = self.client.parse_mode if self.client else enums.ParseMode.DEFAULT

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/parser/utils.py

@@ -10,8 +10,9 @@ SMP_RE = re.compile(r"[\U00010000-\U0010FFFF]")
 def add_surrogates(text):
     # Replace each SMP code point with a surrogate pair
     return SMP_RE.sub(
-        lambda match:  # Split SMP in two surrogates
-        "".join(chr(i) for i in unpack("<HH", match.group().encode("utf-16le"))),
+        lambda match: (  # Split SMP in two surrogates
+            "".join(chr(i) for i in unpack("<HH", match.group().encode("utf-16le")))
+        ),
         text,
     )
 

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/raw/core/gzip_packed.py

@@ -23,7 +23,8 @@ class GzipPacked(TLObject):
     def read(data: BytesIO, *args: Any) -> GzipPacked:  # noqa: ARG004
         # Return the Object itself instead of a GzipPacked wrapping it
         return cast(
-            "GzipPacked", TLObject.read(BytesIO(decompress(Bytes.read(data))))
+            "GzipPacked",
+            TLObject.read(BytesIO(decompress(Bytes.read(data)))),
         )
 
     def write(self, *args: Any) -> bytes:  # noqa: ARG002

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/raw/core/primitives/string.py

@@ -12,7 +12,7 @@ class String(Bytes):
     @classmethod
     def read(cls, data: BytesIO, *args) -> str:  # noqa: ARG003
         return cast("bytes", super(String, String).read(data)).decode(
-            errors="replace"
+            errors="replace",
         )
 
     def __new__(cls, value: str) -> bytes:

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/types/bots_and_keyboards/bot_app.py

@@ -52,7 +52,7 @@ class BotApp(Object):
         if isinstance(bot_app.document, raw.types.Document):
             attributes = {type(i): i for i in bot_app.document.attributes}
             file_name = getattr(
-                attributes.get(raw.types.DocumentAttributeFilename, None),
+                attributes.get(raw.types.DocumentAttributeFilename),
                 "file_name",
                 None,
             )

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/types/bots_and_keyboards/collectible_item_info.py

@@ -11,6 +11,7 @@ if TYPE_CHECKING:
 
 class CollectibleItemInfo(Object):
     """Contains information about a collectible item and its last purchase.
+
     Parameters:
         purchase_date (``datetime``):
             Point in time (Unix timestamp) when the item was purchased

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/types/business/paid_media.py

@@ -42,14 +42,13 @@ class PaidMedia(Object):
             elif isinstance(m.media, raw.types.MessageMediaDocument):
                 attributes = {type(i): i for i in m.media.document.attributes}
                 file_name = getattr(
-                    attributes.get(raw.types.DocumentAttributeFilename, None),
+                    attributes.get(raw.types.DocumentAttributeFilename),
                     "file_name",
                     None,
                 )
                 if raw.types.DocumentAttributeAnimated in attributes:
                     video_attributes = attributes.get(
                         raw.types.DocumentAttributeVideo,
-                        None,
                     )
                     extended_media.append(
                         types.Animation._parse(

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/types/business/paid_media_preview.py

@@ -10,6 +10,7 @@ if TYPE_CHECKING:
 
 class PaidMediaPreview(Object):
     """The paid media isn't available before the payment.
+
     Parameters:
         width (``int``, *optional*):
             Media width as defined by the sender.

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/types/input_message_content/input_invoice_message_content.py

@@ -156,7 +156,7 @@ class InputInvoiceMessageContent(InputMessageContent):
             else self.payload,
             provider=self.provider_token,
             provider_data=raw.types.DataJSON(
-                data=self.provider_data if self.provider_data else "{}",
+                data=self.provider_data or "{}",
             ),
             reply_markup=await reply_markup.write(client) if reply_markup else None,
         )

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/types/messages_and_media/draft_message.py

@@ -135,7 +135,7 @@ class DraftMessage(Object):
                     attributes = {type(i): i for i in doc.attributes}
 
                     file_name = getattr(
-                        attributes.get(raw.types.DocumentAttributeFilename, None),
+                        attributes.get(raw.types.DocumentAttributeFilename),
                         "file_name",
                         None,
                     )

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/types/messages_and_media/game.py

@@ -59,7 +59,7 @@ class Game(Object):
             attributes = {type(i): i for i in game.document.attributes}
 
             file_name = getattr(
-                attributes.get(raw.types.DocumentAttributeFilename, None),
+                attributes.get(raw.types.DocumentAttributeFilename),
                 "file_name",
                 None,
             )
@@ -67,7 +67,7 @@ class Game(Object):
             animation = types.Animation._parse(
                 client,
                 game.document,
-                attributes.get(raw.types.DocumentAttributeVideo, None),
+                attributes.get(raw.types.DocumentAttributeVideo),
                 file_name,
             )
 

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/types/messages_and_media/message.py

@@ -1181,10 +1181,7 @@ class Message(Object, Update):
                         attributes = {type(i): i for i in doc.attributes}
 
                         file_name = getattr(
-                            attributes.get(
-                                raw.types.DocumentAttributeFilename,
-                                None,
-                            ),
+                            attributes.get(raw.types.DocumentAttributeFilename),
                             "file_name",
                             None,
                         )
@@ -1192,7 +1189,6 @@ class Message(Object, Update):
                         if raw.types.DocumentAttributeAnimated in attributes:
                             video_attributes = attributes.get(
                                 raw.types.DocumentAttributeVideo,
-                                None,
                             )
                             animation = types.Animation._parse(
                                 client,
@@ -1240,7 +1236,6 @@ class Message(Object, Update):
                                         altdoc_file_name = getattr(
                                             altdoc_attributes.get(
                                                 raw.types.DocumentAttributeFilename,
-                                                None,
                                             ),
                                             "file_name",
                                             None,
@@ -1248,7 +1243,6 @@ class Message(Object, Update):
                                         altdoc_video_attribute = (
                                             altdoc_attributes.get(
                                                 raw.types.DocumentAttributeVideo,
-                                                None,
                                             )
                                         )
                                         if altdoc_video_attribute:
@@ -1418,7 +1412,7 @@ class Message(Object, Update):
                 forwards=message.forwards,
                 via_bot=types.User._parse(
                     client,
-                    users.get(message.via_bot_id, None),
+                    users.get(message.via_bot_id),
                 ),
                 outgoing=message.out,
                 reply_markup=reply_markup,

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/types/messages_and_media/message_reactor.py

@@ -7,6 +7,7 @@ from pyrogram.types.object import Object
 
 class MessageReactor(Object):
     """Contains information about a message reactor.
+
     Parameters:
         amount (``int``):
             Stars amount.

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/types/messages_and_media/sticker.py

@@ -160,17 +160,13 @@ class Sticker(Object):
 
         image_size_attributes = document_attributes.get(
             raw.types.DocumentAttributeImageSize,
-            None,
         )
         file_name = getattr(
-            document_attributes.get(raw.types.DocumentAttributeFilename, None),
+            document_attributes.get(raw.types.DocumentAttributeFilename),
             "file_name",
             None,
         )
-        video_attributes = document_attributes.get(
-            raw.types.DocumentAttributeVideo,
-            None,
-        )
+        video_attributes = document_attributes.get(raw.types.DocumentAttributeVideo)
 
         sticker_set = sticker_attributes.stickerset
 

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/types/messages_and_media/story.py

@@ -203,7 +203,6 @@ class Story(Object, Update):
                     if raw.types.DocumentAttributeAnimated in attributes:
                         video_attributes = attributes.get(
                             raw.types.DocumentAttributeVideo,
-                            None,
                         )
                         animation = types.Animation._parse(
                             client,
@@ -215,7 +214,6 @@ class Story(Object, Update):
                     elif raw.types.DocumentAttributeVideo in attributes:
                         video_attributes = attributes.get(
                             raw.types.DocumentAttributeVideo,
-                            None,
                         )
                         video = types.Video._parse(
                             client,

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/types/messages_and_media/web_page.py

@@ -128,7 +128,7 @@ class WebPage(Object):
             attributes = {type(i): i for i in doc.attributes}
 
             file_name = getattr(
-                attributes.get(raw.types.DocumentAttributeFilename, None),
+                attributes.get(raw.types.DocumentAttributeFilename),
                 "file_name",
                 None,
             )
@@ -138,10 +138,7 @@ class WebPage(Object):
                 audio = types.Audio._parse(client, doc, audio_attributes, file_name)
 
             elif raw.types.DocumentAttributeAnimated in attributes:
-                video_attributes = attributes.get(
-                    raw.types.DocumentAttributeVideo,
-                    None,
-                )
+                video_attributes = attributes.get(raw.types.DocumentAttributeVideo)
                 animation = types.Animation._parse(
                     client,
                     doc,

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/types/user_and_chats/chat.py

@@ -567,7 +567,7 @@ class Chat(Object):
                     full_chat.paid_reactions_available
                 )
 
-                linked_chat_raw = chats.get(full_chat.linked_chat_id, None)
+                linked_chat_raw = chats.get(full_chat.linked_chat_id)
 
                 if linked_chat_raw:
                     parsed_chat.linked_chat = Chat._parse_channel_chat(

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/types/user_and_chats/emoji_status.py

@@ -27,6 +27,7 @@ class EmojiStatus(Object):
         client: pyrogram.Client = None,
         custom_emoji_id: int,
         until_date: datetime | None = None,
+        _raw: raw.base.EmojiStatus = None,
     ) -> None:
         super().__init__(client)
 
@@ -39,13 +40,20 @@ class EmojiStatus(Object):
             return EmojiStatus(
                 client=client,
                 custom_emoji_id=emoji_status.document_id,
+                until_date=utils.timestamp_to_datetime(emoji_status.until)
+                if emoji_status.until
+                else None,
+                _raw=emoji_status,
             )
 
-        if isinstance(emoji_status, raw.types.EmojiStatusUntil):
+        if isinstance(emoji_status, raw.types.EmojiStatusCollectible):
             return EmojiStatus(
                 client=client,
                 custom_emoji_id=emoji_status.document_id,
-                until_date=utils.timestamp_to_datetime(emoji_status.until),
+                until_date=utils.timestamp_to_datetime(emoji_status.until)
+                if emoji_status.until
+                else None,
+                _raw=emoji_status,
             )
 
         return None

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/types/user_and_chats/found_contacts.py

@@ -7,6 +7,7 @@ from pyrogram.types.object import Object
 
 class FoundContacts(Object):
     """Chats found by name substring and auxiliary data.
+
     Parameters:
         my_results (List of :obj:`~pyrogram.types.Chat`, *optional*):
             Personalized results.

{electrogram-0.2.224 → electrogram-0.2.224.1}/pyrogram/utils.py

@@ -9,7 +9,6 @@ import struct
 from concurrent.futures.thread import ThreadPoolExecutor
 from datetime import datetime, timezone
 from getpass import getpass
-from typing import TYPE_CHECKING, Any, TypeVar
 
 import pyrogram
 from pyrogram import enums, raw, types
@@ -20,9 +19,6 @@ from pyrogram.file_id import (
     FileType,
 )
 
-if TYPE_CHECKING:
-    from collections.abc import Callable
-
 
 async def ainput(prompt: str = "", *, hide: bool = False):
     """Just like the built-in input, but async"""
@@ -395,15 +391,6 @@ def datetime_to_timestamp(dt: datetime | None) -> int | None:
     return int(dt.timestamp()) if dt else None
 
 
-async def run_sync(
-    func: Callable[..., TypeVar("Result")],
-    *args: Any,
-    **kwargs: Any,
-) -> TypeVar("Result"):
-    loop = asyncio.get_event_loop()
-    return await loop.run_in_executor(None, functools.partial(func, *args, **kwargs))
-
-
 async def get_reply_to(
     client: pyrogram.Client,
     chat_id: int | str | None = None,

electrogram-0.2.224.1/release_notes.txt

@@ -0,0 +1,30 @@
+## Release Notes
+
+### something: I forgot.
+
+## Summary by Sourcery
+
+Update documentation build process to use uv-based workflows and simplify synchronous client utilities.
+
+Enhancements:
+- Adjust emoji status parsing to support collectible emoji statuses and optional until dates while preserving raw data.
+- Simplify client run logic to always use asynchronous start/idle/stop flow and remove deprecated sync context management and run_sync utilities.
+- Tidy various small style and docstring formatting issues across filters, raw primitives, and type docstrings.
+- Import compose and idle directly from methods.utilities instead of the removed sync module.
+
+Build:
+- Switch docs build script and GitHub workflows to use uv for Python setup, dependency sync, and Sphinx invocation.
+- Pin Sphinx version for docs extra to <8.0.0 and adjust Sphinx config paths for templates, static files, and LaTeX logo.
+
+CI:
+- Update docs generation and format/test workflows to install Python via setup-python, install uv, and rely on uv sync and uv run instead of manual pip and tool management.
+
+Chores:
+- Add uv.lock and update .gitignore accordingly.
+- Apply minor formatting tweaks for gzip-packed and string primitives.
+
+---------
+
+Signed-off-by: 5hojib <yesiamshojib@gmail.com>
+Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
+Co-authored-by: sourcery-ai[bot] <58596630+sourcery-ai[bot]@users.noreply.github.com>