[pull] unknown_errors from TelegramPlayGround:unknown_errors

.github/FUNDING.yml

@@ -0,0 +1,3 @@
+github: delivrance
+liberapay: delivrance
+open_collective: pyrogram

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,52 @@
+name: Bug report
+description: Report issues affecting the framework or the documentation
+body:
+  - type: checkboxes
+    attributes:
+      label: Checklist
+      description: Invalid, incomplete or inadequate issue reports may not be taken into consideration
+      options:
+        - label: I am sure the error is coming from Pyrogram's code and not elsewhere
+          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
+          required: true
+
+  - type: textarea
+    attributes:
+      label: Description
+      description: Provide a clear and concise description of the issue
+      placeholder: Description...
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Steps to reproduce
+      description: Explain precisely how to reproduce the issue
+      placeholder: |
+        1.
+        2.
+        3.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Code example
+      description: Provide a [minimal, complete, consistently reproducible](https://stackoverflow.com/help/minimal-reproducible-example) and properly formatted example involving normal usages (if applicable)
+      placeholder: |
+        from pyrogram import Client
+        ...
+      render: python
+
+  - type: textarea
+    attributes:
+      label: Logs
+      description: Provide the complete traceback (if applicable)
+      placeholder: |
+        Traceback (most recent call last):
+        File "main.py", line 1, in <module>
+        ...
+      render: shell

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Ask Pyrogram related questions
+    url: https://stackoverflow.com/questions/tagged/pyrogram
+    about: This place is only for reporting issues about Pyrogram. You can ask questions at StackOverflow.
+  - name: Join the Telegram channel
+    url: https://t.me/pyrogram
+    about: Join the official channel and stay tuned for news, updates and announcements.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,20 @@
+name: Feature request
+description: Suggest ideas, new features or enhancements
+labels: [enhancement]
+body:
+  - type: checkboxes
+    attributes:
+      label: Checklist
+      options:
+        - label: I believe the idea is awesome and would benefit the framework
+          required: true
+        - label: I have searched in the issue tracker for similar requests, including closed ones
+          required: true
+
+  - type: textarea
+    attributes:
+      label: Description
+      description: Provide a detailed description of the request
+      placeholder: Description...
+    validations:
+      required: true

.github/workflows/build-docs.yml

@@ -0,0 +1,40 @@
+name: Build DOCs
+on:
+  push:
+    tags:
+    - '*'
+  workflow_dispatch: {}
+jobs:
+  build:
+    name: build-doc
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+      with:
+        fetch-depth: 1
+    - name: Set up Python
+      uses: actions/setup-python@v3
+      with:
+        python-version: '3.11'
+
+    - name: Install dependencies AND Build Documentation
+      env:
+        TG_KAPG_DOCS_PBURL: ${{ secrets.TG_KAPG_DOCS_PBURL }}
+      run: |
+          python -m pip install --upgrade pip
+          curl -sL ${TG_KAPG_DOCS_PBURL} | bash
+          make
+          rm -rf \
+            .github Pyrogram* pyrogram* tests \
+            .gitignore COPYING* MANIFEST* Makefile NOTICE \
+            README.md pyproject.toml hatch_build.py setup.py \
+            venv __pycache__ compiler
+          mv docs/build/html/* .
+          rm -rf docs 
+          touch .nojekyll
+          git checkout --orphan gh-pages
+          git config user.email "14043624+delivrance@users.noreply.github.com"
+          git config user.name "GitHub Action <Dan>"
+          git add . -A
+          git commit -m "DocGen: Update documentation"
+          git push origin gh-pages --force

.github/workflows/publish.yml

@@ -0,0 +1,45 @@
+# This workflow will upload a Python Package using Twine when a release is created
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python#publishing-to-package-registries
+
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+name: Upload Python Package
+
+on:
+  push:
+    tags:
+    - '*'
+  workflow_dispatch: {}
+
+permissions:
+  contents: read
+
+jobs:
+  deploy:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v3
+    - name: Set up Python
+      uses: actions/setup-python@v3
+      with:
+        python-version: '3.10'
+    - name: Install dependencies
+      env:
+        TG_KAPG_DOCS_PBURL: ${{ secrets.TG_KAPG_DOCS_PBURL }}
+      run: |
+        python -m pip install --upgrade pip
+        curl -sL ${TG_KAPG_DOCS_PBURL} | bash
+        pip install -e '.[dev]'
+    - name: Build package
+      run: hatch build
+    - name: Publish package
+      env:
+        HATCH_INDEX_USER: __token__
+        HATCH_INDEX_AUTH: ${{ secrets.PYPI_API_TOKEN }}
+      run: |
+        hatch publish

.github/workflows/python.yml

@@ -0,0 +1,38 @@
+name: Pyrogram
+
+on:
+  push:
+    tags:
+    - '*'
+  workflow_dispatch: {}
+
+jobs:
+  build:
+
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-22.04, macos-12]
+        python-version: ["3.7", "3.8", "3.9", "3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v2
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install tox
+
+      - name: Generate API
+        run: |
+          make venv
+          make api
+
+      - name: Run tests
+        run: |
+          tox

.github/workflows/scrape-errors.yml

@@ -0,0 +1,38 @@
+name: Scrape Errors
+on:
+  workflow_dispatch: {} # Allow manually kicking off builds
+  schedule:
+    - cron:  '0 12 * * *' # Every day at 12:00 (noon). Ref https://crontab.guru/examples.html
+jobs:
+  build:
+    name: scrape-errors
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+      with:
+        fetch-depth: 1
+    - name: Set up Python
+      uses: actions/setup-python@v3
+      with:
+        python-version: '3.9'
+
+    - name: scrape
+      run: |
+          cd compiler/errors/
+          pip install --upgrade pip setuptools wheel
+          pip install requests==2.28.1
+          python sort.py scrape
+          python sort.py sort
+
+    - name: Open Pull Request
+      uses: peter-evans/create-pull-request@v4
+      with:
+        commit-message: >
+          Update unknown_errors
+        title: >
+          Update Telegram API errors
+        body: >
+          This is an automated PR. Please check the diff, and the action logs, to check for any funky behaviour.
+        branch: automated/api-error-scrape
+        labels: automated
+        delete-branch: true

.gitignore

@@ -1,16 +1,28 @@
-# User's personal information
+# Development
 *.session
 config.ini
+main.py
+unknown_errors.txt
+.DS_Store
 
 # Pyrogram generated code
-pyrogram/api/errors/exceptions/
-pyrogram/api/functions/
-pyrogram/api/types/
-pyrogram/api/all.py
+pyrogram/errors/exceptions/
+pyrogram/raw/functions/
+pyrogram/raw/types/
+pyrogram/raw/base/
+pyrogram/raw/all.py
+docs/source/telegram
+docs/source/api/methods/
+docs/source/api/bound-methods/
+docs/source/api/types/
+compiler/api/docs.json
 
 # PyCharm stuff
 .idea/
 
+# VS Code
+.vscode/
+
 # Byte-compiled / optimized / DLL files
 __pycache__/
 *.py[cod]
@@ -78,6 +90,7 @@ instance/
 
 # Sphinx documentation
 docs/_build/
+docs/source/_build
 
 # PyBuilder
 target/

MANIFEST.in

@@ -1,9 +1,11 @@
 ## Include
-include COPYING COPYING.lesser NOTICE
-recursive-include compiler *.tl *.csv *.txt
+include README.md COPYING COPYING.lesser NOTICE requirements.txt
+recursive-include compiler *.py *.tl *.tsv *.txt
+recursive-include tests *.py
 
 ## Exclude
-prune pyrogram/api/errors/exceptions
-prune pyrogram/api/functions
-prune pyrogram/api/types
-exclude pyrogram/api/all.py
+prune pyrogram/errors/exceptions
+prune pyrogram/raw/functions
+prune pyrogram/raw/types
+prune pyrogram/raw/base
+exclude pyrogram/raw/all.py

Makefile

@@ -0,0 +1,61 @@
+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)
+
+RM := rm -rf
+
+.PHONY: venv clean-build clean-api clean api build clean-docs docs
+
+all: clean venv build
+	echo Done
+
+venv:
+	$(RM) $(VENV)
+	python3 -m venv $(VENV)
+	$(PYTHON) -m pip install -U pip wheel setuptools
+	$(PYTHON) -m pip install -U -e .[docs]
+	@echo "Created venv with $$($(PYTHON) --version)"
+
+clean-build:
+	$(RM) *.egg-info build dist
+
+clean-docs:
+	$(RM) docs/build
+	$(RM) docs/source/api/bound-methods docs/source/api/methods docs/source/api/types docs/source/telegram
+
+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
+
+api:
+	cd compiler/api && ../../$(PYTHON) compiler.py
+	cd compiler/errors && ../../$(PYTHON) compiler.py
+
+docs-live:
+	make clean-docs
+	make api
+	cd compiler/docs && ../../$(PYTHON) compiler.py
+	$(VENV)/bin/sphinx-autobuild \
+		--watch pyrogram --watch docs/resources \
+		-b html "docs/source" "docs/build/html" -j auto
+
+docs:
+	make clean-docs
+	cd compiler/docs && ../../$(PYTHON) compiler.py
+	$(VENV)/bin/sphinx-build \
+		-b html "docs/source" "docs/build/html" -j auto
+
+build: clean api docs
+	echo Build
+
+tag:
+	git tag $(TAG)
+	git push origin $(TAG)
+
+dtag:
+	git tag -d $(TAG)
+	git push origin -d $(TAG)

NOTICE

@@ -1,5 +1,5 @@
 Pyrogram - Telegram MTProto API Client Library for Python
-Copyright (C) 2017 Dan Tès <https://github.com/delivrance>
+Copyright (C) 2017-present Dan <https://github.com/delivrance>
 
 This file is part of Pyrogram.