PyrogramMod · null-nick · Jul 14, 2026 · Dec 9, 2024 · Dec 9, 2024 · Dec 29, 2024
diff --git a/.github/workflows/python.yml b/.github/workflows/python.yml
@@ -13,29 +13,24 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, macos-latest]
-        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
 
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
 
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
         with:
           python-version: ${{ matrix.python-version }}
-          cache: "pip"
 
-      - name: Upgrade pip and install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install --upgrade tox wheel setuptools
+      - name: Install dependencies
+        run: uv sync --extra dev
 
       - name: Generate API
-        run: |
-          make venv
-          make api
+        run: make api
 
-      - name: Run tests with tox
+      - name: Run tests
         env:
           PYTHONWARNINGS: "ignore"
-        run: tox
+        run: uv run pytest
diff --git a/.github/workflows/scrape-errors.yml b/.github/workflows/scrape-errors.yml
@@ -14,33 +14,29 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           fetch-depth: 1
 
-      - name: Set up Python 3.9
-        uses: actions/setup-python@v3
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
         with:
-          python-version: '3.9'
+          python-version: "3.10"
 
       - name: Install Python dependencies and run scripts
         run: |
-          set -e # Exit immediately if a command exits with a non-zero status
-          echo "-------------------- Installing dependencies --------------------"
-          cd compiler/errors/
-          python -m pip install --upgrade pip setuptools wheel
-          python -m pip install requests==2.28.1
+          set -e
           echo "-------------------- Running scrape script --------------------"
-          python sort.py scrape
+          uv run --with requests compiler/errors/sort.py scrape
           echo "-------------------- Running sort script --------------------"
-          python sort.py sort
+          uv run --with requests compiler/errors/sort.py sort
 
       - name: Check for changes and commit
         run: |
           git config --local user.email "github-actions[bot]@users.noreply.github.com"
           git config --local user.name "GitHub Actions Bot"
 
-          if ! git diff --quiet; then # Check if there are any changes
+          if ! git diff --quiet; then
             echo "Changes detected in error files."
             git add .
             git commit -m "Automated update of unknown_errors"
@@ -50,4 +46,4 @@ jobs:
             echo "No changes detected in error files. Skipping commit and push."
           fi
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
diff --git a/.gitignore b/.gitignore
@@ -130,3 +130,8 @@ venv.bak/
 docs_build.sh
 .buildinfo
 json_docs.py
+/scripts
+/tests
+/uv.lock
+/examples
+/changelogs
diff --git a/Makefile b/Makefile
@@ -1,24 +1,18 @@
-VENV := venv
-PYTHON := $(VENV)/bin/python
-ifeq ($(OS),Windows_NT)
-    PYTHON := $(VENV)/Scripts/python.exe
-endif
-
 HOST := $(shell ifconfig | grep "inet " | tail -1 | cut -d\  -f2 2>/dev/null || echo "127.0.0.1")
 TAG := v$(shell grep -E '__version__ = ".*"' pyrogram/__init__.py | cut -d\" -f2)
 
 RM := rm -rf
 
-NUM_CORES := $(shell $(PYTHON) -c "import os; print(os.cpu_count())")
+NUM_CORES := $(shell uv run python -c "import os; print(os.cpu_count())" 2>/dev/null || echo 1)
 
-.PHONY: venv clean-build clean-api clean api build docs clean-docs tag dtag
+.PHONY: venv test clean-build clean-api clean api build docs clean-docs tag dtag tagall
 
 venv:
-	$(RM) $(VENV)
-	python3 -m venv $(VENV)
-	$(PYTHON) -m pip install -U pip wheel setuptools
-	$(PYTHON) -m pip install -U -r requirements.txt -r dev-requirements.txt
-	@echo "Created venv with $$($(PYTHON) --version)"
+	uv sync --extra dev --extra docs
+	@echo "Synced venv with $$(uv run python --version)"
+
+test:
+	uv run pytest
 
 clean-build:
 	$(RM) *.egg-info build dist
@@ -40,18 +34,17 @@ clean-docs:
 	$(RM) docs/source/api/bound-methods docs/source/api/methods docs/source/api/types docs/source/telegram
 
 api:
-	cd compiler/api && ../../$(PYTHON) compiler.py
-	cd compiler/errors && ../../$(PYTHON) compiler.py
+	cd compiler/api && uv run python compiler.py
+	cd compiler/errors && uv run python compiler.py
 
 docs:
 	make clean-docs
-	cd compiler/docs && ../../$(PYTHON) compiler.py
-	$(PYTHON) -m sphinx -b html "docs/source" "docs/build/html" -j$(NUM_CORES)
+	cd compiler/docs && uv run python compiler.py
+	uv run python -m sphinx -b html "docs/source" "docs/build/html" -j$(NUM_CORES)
 
 build:
 	make clean
-	$(PYTHON) setup.py sdist
-	$(PYTHON) setup.py bdist_wheel
+	uv build
 
 tag:
 	git tag $(TAG)
@@ -60,3 +53,22 @@ tag:
 dtag:
 	git tag -d $(TAG)
 	git push origin -d $(TAG)
+
+tagall:
+	echo "Creating automatic tags for all version bumps..."
+	for hash in $$(git log --grep="Bump version\|Version bump\|v[0-9]\+\.[0-9]\+\.[0-9]\+" --format="%H"); do \
+	    msg=$$(git log -1 --format="%s" $$hash); \
+	    versions=$$(echo "$$msg" | grep -o "v[0-9]\+\.[0-9]\+\.[0-9]\+"); \
+	    for version in $$versions; do \
+	        if [ -n "$$version" ]; then \
+	            if git show-ref --tags --quiet --verify "refs/tags/$$version"; then \
+	                echo "Tag $$version already exists, skipping."; \
+	            else \
+	                echo "Creating tag $$version for commit $$hash"; \
+	                git tag -a "$$version" "$$hash" -m "Automatic tag $$version"; \
+	            fi; \
+	        fi; \
+	    done; \
+	done
+	echo "Pushing all tags to the remote..."
+	git push origin --tags
diff --git a/README.md b/README.md
@@ -13,7 +13,7 @@
         Documentation
     </a>
     •
-    <a href="https://t.me/pyrogrammodnews">
+    <a href="https://telegram.me/pyrogrammodnews">
         News
     </a>
 </p>
@@ -67,8 +67,8 @@ pip3 install https://github.com/PyrogramMod/PyrogramMod/archive/refs/heads/main.
 ### Resources
 
 - The docs contain lots of resources to help you get started with Pyrogram: https://docs.pyrogram.org.
-- Seeking extra help? Come join and ask our community: https://t.me/pyrogrammodchat.
-- For other kind of inquiries, you can send a [message](https://t.me/haskell) or an [e-mail](mailto:dan@pyrogram.org).
+- Seeking extra help? Come join and ask our community: https://telegram.me/pyrogrammodchat.
+- For other kind of inquiries, you can send a [message](https://telegram.me/haskell) or an [e-mail](mailto:dan@pyrogram.org).
 
 ### Copyright & License
 
@@ -78,16 +78,16 @@ pip3 install https://github.com/PyrogramMod/PyrogramMod/archive/refs/heads/main.
 ### INFO
 
 - 📕 Official Repo: https://github.com/pyrogram/pyrogram
-- 🗞 News: https://t.me/pyrogram
-- 💭 Support Group: https://t.me/pyrogramchat
+- 🗞 News: https://telegram.me/pyrogram
+- 💭 Support Group: https://telegram.me/pyrogramchat
 - 📚 Docs: https://docs.pyrogram.org
 ------------------------------------------------------------
 - 📕 Un-Official Repo: https://github.com/PyrogramMod/PyrogramMod/
-- 🗞 News: https://t.me/PyroGramModNews
-- 💭 Support Group: https://t.me/pyrogramodchat
+- 🗞 News: https://telegram.me/PyroGramModNews
+- 💭 Support Group: https://telegram.me/pyrogramodchat
 - 📚 Docs: https://pyrogrammod.readthedocs.io/en/latest/
 ------------------------------------------------------------
 
 - Check out the docs at https://docs.pyrogram.org to learn more about Pyrogram, get started right
 away and discover more in-depth material for building your client applications.
-- Join the official channel at https://t.me/PyroGramModNews and stay tuned for news, updates and announcements.
+- Join the official channel at https://telegram.me/PyroGramModNews and stay tuned for news, updates and announcements.
diff --git a/compiler/api/compiler.py b/compiler/api/compiler.py
@@ -100,6 +100,19 @@ def camel(s: str):
     return "".join([i[0].upper() + i[1:] for i in s.split("_")])
 
 
+# noinspection PyShadowingBuiltins, PyShadowingNames
+def get_return_type_hint(qualtype: str) -> str:
+    """Get return type hint for generic TLObject"""
+    if qualtype.startswith("Vector"):
+        # Extract inner type from Vector<Type>
+        inner = qualtype.split("<")[1][:-1]
+        ns, name = inner.split(".") if "." in inner else ("", inner)
+        return f'"List[raw.base.{".".join([ns, name]).strip(".")}]"'
+    else:
+        ns, name = qualtype.split(".") if "." in qualtype else ("", qualtype)
+        return f'"raw.base.{".".join([ns, name]).strip(".")}"'
+
+
 # noinspection PyShadowingBuiltins, PyShadowingNames
 def get_type_hint(type: str) -> str:
     is_flag = FLAGS_RE.match(type)
@@ -301,7 +314,7 @@ def start(format: bool = False):
         d[qualtype].append(c.qualname)
 
         if c.section == "types":
-            key = c.namespace
+            key = c.typespace if len(c.namespace) == 0 else c.namespace
 
             if key not in namespaces_to_types:
                 namespaces_to_types[key] = []
@@ -548,6 +561,12 @@ def start(format: bool = False):
         slots = ", ".join([f'"{i[0]}"' for i in sorted_args])
         return_arguments = ", ".join([f"{i[0]}={i[0]}" for i in sorted_args])
 
+        # Generate generic type hint for functions
+        if c.section == "functions":
+            generic_type = f"[{get_return_type_hint(c.qualtype)}]"
+        else:
+            generic_type = ""
+
         compiled_combinator = combinator_tmpl.format(
             notice=notice,
             warning=WARNING,
@@ -560,7 +579,8 @@ def start(format: bool = False):
             fields=fields,
             read_types=read_types,
             write_types=write_types,
-            return_arguments=return_arguments
+            return_arguments=return_arguments,
+            generic_type=generic_type
         )
 
         directory = "types" if c.section == "types" else c.section
@@ -585,6 +605,7 @@ def start(format: bool = False):
         d[c.namespace].append(c.name)
 
     for namespace, types in namespaces_to_types.items():
+        os.makedirs(DESTINATION_PATH / "base" / namespace, exist_ok=True)
         with open(DESTINATION_PATH / "base" / namespace / "__init__.py", "w") as f:
             f.write(f"{notice}\n\n")
             f.write(f"{WARNING}\n\n")