[pull] main from PyrogramMod:main

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -10,7 +10,7 @@ body:
           required: true
         - label: I have searched in the issue tracker for similar bug reports, including closed ones
           required: true
-        - label: I ran `pip3 install -U https://github.com/pyrogram/pyrogram/archive/master.zip` and reproduced the issue using the latest development version
+        - label: I ran `pip3 install -U https://github.com/pyrogrammod/pyrogrammod/archive/master.zip` and reproduced the issue using the latest development version
           required: true
 
   - type: textarea

.github/workflows/codeql-analysis.yml

@@ -1,71 +1,52 @@
-# For most projects, this workflow file will not need changing; you simply need
-# to commit it to your repository.
-#
-# You may wish to alter this file to override the set of languages analyzed,
-# or to provide custom queries or build logic.
-#
-# ******** NOTE ********
-# We have attempted to detect the languages in your repository. Please check
-# the `language` matrix defined below to confirm you have the correct set of
-# supported CodeQL languages.
-#
 name: "CodeQL"
 
 on:
   push:
-    branches: [ main ]
+    branches: [ "main" ]
   pull_request:
-    # The branches below must be a subset of the branches above
-    branches: [ main ]
+    branches: [ "main" ]
   schedule:
-    - cron: '38 8 * * 5'
+    - cron: '26 2 * * 6'
 
 jobs:
   analyze:
-    name: Analyze
-    runs-on: ubuntu-latest
+    name: Analyze (${{ matrix.language }})
+    runs-on: ${{ (matrix.language == 'swift' && 'macos-latest') || 'ubuntu-latest' }}
     permissions:
+      security-events: write
+      packages: read
       actions: read
       contents: read
-      security-events: write
 
     strategy:
       fail-fast: false
       matrix:
-        language: ['python' ]
-        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python' ]
-        # Learn more:
-        # https://docs.github.com/en/free-pro-team@latest/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#changing-the-languages-that-are-analyzed
+        include:
+        - language: actions
+          build-mode: none
+        - language: python
+          build-mode: none
 
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v2
+      uses: actions/checkout@v4
 
-    # Initializes the CodeQL tools for scanning.
     - name: Initialize CodeQL
-      uses: github/codeql-action/init@v2
+      uses: github/codeql-action/init@v3
       with:
         languages: ${{ matrix.language }}
-        # If you wish to specify custom queries, you can do so here or in a config file.
-        # By default, queries listed here will override any specified in a config file.
-        # Prefix the list here with "+" to use these queries and those in the config file.
-        # queries: ./path/to/local/query, your-org/your-repo/queries@main
-
-    # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
-    # If this step fails, then you should remove it and run the build manually (see below)
-    - name: Autobuild
-      uses: github/codeql-action/autobuild@v2
-
-    #  Command-line programs to run using the OS shell.
-    #  https://git.io/JvXDl
-
-    #  If the Autobuild fails above, remove it and uncomment the following three lines
-    #    and modify them (or add more) to build your code if your project
-    #    uses a compiled language
-
-    #- run: |
-    #   make bootstrap
-    #   make release
+        build-mode: ${{ matrix.build-mode }}
+    - if: matrix.build-mode == 'manual'
+      shell: bash
+      run: |
+        echo 'If you are using a "manual" build mode for one or more of the' \
+          'languages you are analyzing, replace this with the commands to build' \
+          'your code, for example:'
+        echo '  make bootstrap'
+        echo '  make release'
+        exit 1
 
     - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@v2
+      uses: github/codeql-action/analyze@v3
+      with:
+        category: "/language:${{matrix.language}}"

.github/workflows/publish.yaml

@@ -0,0 +1,51 @@
+# This is the workflow to make and push wheels to PyPi
+
+name: Build Wheels
+on:
+  workflow_dispatch:
+    inputs:
+      publish:
+        description: 'Publish to PyPi'
+        required: false
+        default: false
+        type: boolean
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Check out the repo
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: 3.12
+
+      - name: Install dependencies
+        run: python3.12 -m pip install --upgrade pip setuptools wheel
+
+      - name: Create wheels directory
+        run: mkdir -p wheels
+
+      - name: Build wheel
+        run: python3.12 -m pip wheel . --no-deps --wheel-dir wheels
+
+      - name: List wheel contents
+        run: ls -l wheels
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: program-mod-wheel
+          path: ./wheels/pyrogrammod*.whl
+          if-no-files-found: error
+
+      - name: Publish a Python distribution to PyPI
+        if: github.event.inputs.publish == 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true
+          packages-dir: wheels/

.github/workflows/python.yml

@@ -1,34 +1,41 @@
 name: Pyrogram - Mod
 
-on: [push, pull_request]
+permissions:
+  contents: read
+
+on:
+  push:
+  pull_request:
 
 jobs:
   build:
-
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
         os: [ubuntu-latest, macos-latest]
-        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
 
     steps:
-      - uses: actions/checkout@v3
+      - name: Checkout repository
+        uses: actions/checkout@v4
 
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
+          cache: "pip"
 
-      - name: Install dependencies
+      - name: Upgrade pip and install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install tox
+          pip install --upgrade tox wheel setuptools
 
       - name: Generate API
         run: |
           make venv
           make api
 
-      - name: Run tests
-        run: |
-          tox
+      - name: Run tests with tox
+        env:
+          PYTHONWARNINGS: "ignore"
+        run: tox

.github/workflows/scrape-errors.yml

@@ -0,0 +1,53 @@
+name: Scrape Errors
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: '0 0 * * *' # Run daily at midnight UTC
+
+jobs:
+  scrape_and_commit:
+    name: Scrape and Update Error Lists
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 1
+
+      - name: Set up Python 3.9
+        uses: actions/setup-python@v3
+        with:
+          python-version: '3.9'
+
+      - 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
+          echo "-------------------- Running scrape script --------------------"
+          python sort.py scrape
+          echo "-------------------- Running sort script --------------------"
+          python 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
+            echo "Changes detected in error files."
+            git add .
+            git commit -m "Automated update of unknown_errors"
+            echo "Committing and pushing changes..."
+            git push origin main
+          else
+            echo "No changes detected in error files. Skipping commit and push."
+          fi
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -129,3 +129,4 @@ venv.bak/
 .mypy_cache/
 docs_build.sh
 .buildinfo
+json_docs.py

.readthedocs.yaml

@@ -3,7 +3,7 @@ version: 2
 build:
   os: ubuntu-22.04
   tools:
-    python: "3.11"
+    python: "3.13"
   jobs:
     post_install:
       - pip install .[docs]

Makefile

@@ -1,11 +1,17 @@
 VENV := venv
 PYTHON := $(VENV)/bin/python
-HOST = $(shell ifconfig | grep "inet " | tail -1 | cut -d\  -f2)
-TAG = v$(shell grep -E '__version__ = ".*"' pyrogram/__init__.py | cut -d\" -f2)
+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
 
-.PHONY: venv clean-build clean-api clean api build docs clean-docs
+NUM_CORES := $(shell $(PYTHON) -c "import os; print(os.cpu_count())")
+
+.PHONY: venv clean-build clean-api clean api build docs clean-docs tag dtag
 
 venv:
 	$(RM) $(VENV)
@@ -20,9 +26,14 @@ clean-build:
 clean-api:
 	$(RM) pyrogram/errors/exceptions pyrogram/raw/all.py pyrogram/raw/base pyrogram/raw/functions pyrogram/raw/types
 
-clean:
-	make clean-build
-	make clean-api
+clean-pyc:
+	find . -name "*.pyc" -exec $(RM) {} + || true
+	find . -name "__pycache__" -exec $(RM) {} + || true
+
+clean-ds_store:
+	find . -name ".DS_Store" -exec $(RM) {} \;
+
+clean: clean-build clean-api clean-pyc clean-ds_store clean-docs
 
 clean-docs:
 	$(RM) docs/build
@@ -35,8 +46,7 @@ api:
 docs:
 	make clean-docs
 	cd compiler/docs && ../../$(PYTHON) compiler.py
-	$(VENV)/bin/sphinx-build \
-		-b html "docs/source" "docs/build/html" -j6
+	$(PYTHON) -m sphinx -b html "docs/source" "docs/build/html" -j$(NUM_CORES)
 
 build:
 	make clean
@@ -49,4 +59,4 @@ tag:
 
 dtag:
 	git tag -d $(TAG)
-	git push origin -d $(TAG)
+	git push origin -d $(TAG)

README.md

@@ -3,13 +3,13 @@
         <img src="https://pyrogrammod.readthedocs.io/en/latest/_static/pyrogram.png" alt="Pyrogram" width="128">
     </a>
     <br>
-    <b>Telegram MTProto API Framework for Python</b> (Fork of <a href="github.com/pyrogram/pyrogram">Pyrogram</a>)
+    <b>Telegram MTProto API Framework for Python</b> (Fork of <a href="https://github.com/pyrogram/pyrogram">Pyrogram</a>)
     <br>
-    <a href="https://pyrogrammod.readthedocs.io/">
+    <a href="https://pyrogrammod.readthedocs.io/en/latest/">
         Homepage
     </a>
     •
-    <a href="https://pyrogrammod.readthedocs.io/">
+    <a href="https://pyrogrammod.readthedocs.io/en/latest/">
         Documentation
     </a>
     •
@@ -18,7 +18,7 @@
     </a>
 </p>
 
-## Pyrogram
+# PyrogramMod <br>[![PyPI](https://img.shields.io/pypi/v/pyrogrammod.svg?logo=python&logoColor=%23959DA5&label=pypi&labelColor=%23282f37)](https://pypi.org/project/pyrogrammod/) [![Downloads](https://pepy.tech/badge/pyrogrammod)](https://pepy.tech/project/pyrogrammod)
 
 > Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots
 
@@ -67,7 +67,7 @@ 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/pyrogram.
+- 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).
 
 ### Copyright & License
@@ -83,11 +83,11 @@ pip3 install https://github.com/PyrogramMod/PyrogramMod/archive/refs/heads/main.
 - 📚 Docs: https://docs.pyrogram.org
 ------------------------------------------------------------
 - 📕 Un-Official Repo: https://github.com/PyrogramMod/PyrogramMod/
-- 🗞 News: https://t.me/PyroGramMod
+- 🗞 News: https://t.me/PyroGramModNews
 - 💭 Support Group: https://t.me/pyrogramodchat
-- 📚 Docs: https://pyrogrammod.readthedocs.io/
+- 📚 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/pyrogram and stay tuned for news, updates and announcements.
+- Join the official channel at https://t.me/PyroGramModNews and stay tuned for news, updates and announcements.