pyrofork: fix export_folder_link doc

Signed-off-by: wulan17 <wulan17@komodos.id>

.github/workflows/build-docs.yml

@@ -14,8 +14,25 @@ jobs:
     runs-on: ubuntu-22.04
 
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Configure
+        run: bash build-docs.sh configure
+
+      - name: Cleanup
+        run: bash build-docs.sh cleanup
+
+      - name: Create virtual environment
+        run: bash build-docs.sh virtualenv
+
       - name: Build
-        run: bash build-docs.sh
+        run: bash build-docs.sh build
+
+      - name: Clone gh-pages repository
+        run: bash build-docs.sh clone
         env:
           DOCS_KEY: ${{ secrets.DOCS_KEY }}
+
+      - name: Push changes
+        run: bash build-docs.sh push

.github/workflows/python.yml

@@ -9,7 +9,7 @@ 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", "3.14"]
 
     steps:
       - uses: actions/checkout@v4

.pylintrc

@@ -0,0 +1,651 @@
+[MAIN]
+
+# Analyse import fallback blocks. This can be used to support both Python 2 and
+# 3 compatible code, which means that the block might have code that exists
+# only in one or another interpreter, leading to false positives when analysed.
+analyse-fallback-blocks=no
+
+# Clear in-memory caches upon conclusion of linting. Useful if running pylint
+# in a server-like mode.
+clear-cache-post-run=no
+
+# Load and enable all available extensions. Use --list-extensions to see a list
+# all available extensions.
+#enable-all-extensions=
+
+# In error mode, messages with a category besides ERROR or FATAL are
+# suppressed, and no reports are done by default. Error mode is compatible with
+# disabling specific errors.
+#errors-only=
+
+# Always return a 0 (non-error) status code, even if lint errors are found.
+# This is primarily useful in continuous integration scripts.
+#exit-zero=
+
+# A comma-separated list of package or module names from where C extensions may
+# be loaded. Extensions are loading into the active Python interpreter and may
+# run arbitrary code.
+extension-pkg-allow-list=
+
+# A comma-separated list of package or module names from where C extensions may
+# be loaded. Extensions are loading into the active Python interpreter and may
+# run arbitrary code. (This is an alternative name to extension-pkg-allow-list
+# for backward compatibility.)
+extension-pkg-whitelist=
+
+# Return non-zero exit code if any of these messages/categories are detected,
+# even if score is above --fail-under value. Syntax same as enable. Messages
+# specified are enabled, while categories only check already-enabled messages.
+fail-on=
+
+# Specify a score threshold under which the program will exit with error.
+fail-under=10
+
+# Interpret the stdin as a python script, whose filename needs to be passed as
+# the module_or_package argument.
+#from-stdin=
+
+# Files or directories to be skipped. They should be base names, not paths.
+ignore=CVS
+
+# Add files or directories matching the regular expressions patterns to the
+# ignore-list. The regex matches against paths and can be in Posix or Windows
+# format. Because '\\' represents the directory delimiter on Windows systems,
+# it can't be used as an escape character.
+ignore-paths=
+
+# Files or directories matching the regular expression patterns are skipped.
+# The regex matches against base names, not paths. The default value ignores
+# Emacs file locks
+ignore-patterns=^\.#
+
+# List of module names for which member attributes should not be checked and
+# will not be imported (useful for modules/projects where namespaces are
+# manipulated during runtime and thus existing member attributes cannot be
+# deduced by static analysis). It supports qualified module names, as well as
+# Unix pattern matching.
+ignored-modules=
+
+# Python code to execute, usually for sys.path manipulation such as
+# pygtk.require().
+#init-hook=
+
+# Use multiple processes to speed up Pylint. Specifying 0 will auto-detect the
+# number of processors available to use, and will cap the count on Windows to
+# avoid hangs.
+jobs=1
+
+# Control the amount of potential inferred values when inferring a single
+# object. This can help the performance when dealing with large functions or
+# complex, nested conditions.
+limit-inference-results=100
+
+# List of plugins (as comma separated values of python module names) to load,
+# usually to register additional checkers.
+load-plugins=
+
+# Pickle collected data for later comparisons.
+persistent=yes
+
+# Resolve imports to .pyi stubs if available. May reduce no-member messages and
+# increase not-an-iterable messages.
+prefer-stubs=no
+
+# Minimum Python version to use for version dependent checks. Will default to
+# the version used to run pylint.
+py-version=3.13
+
+# Discover python modules and packages in the file system subtree.
+recursive=no
+
+# Add paths to the list of the source roots. Supports globbing patterns. The
+# source root is an absolute path or a path relative to the current working
+# directory used to determine a package namespace for modules located under the
+# source root.
+source-roots=
+
+# When enabled, pylint would attempt to guess common misconfiguration and emit
+# user-friendly hints instead of false-positive error messages.
+suggestion-mode=yes
+
+# Allow loading of arbitrary C extensions. Extensions are imported into the
+# active Python interpreter and may run arbitrary code.
+unsafe-load-any-extension=no
+
+# In verbose mode, extra non-checker-related info will be displayed.
+#verbose=
+
+
+[BASIC]
+
+# Naming style matching correct argument names.
+argument-naming-style=snake_case
+
+# Regular expression matching correct argument names. Overrides argument-
+# naming-style. If left empty, argument names will be checked with the set
+# naming style.
+#argument-rgx=
+
+# Naming style matching correct attribute names.
+attr-naming-style=snake_case
+
+# Regular expression matching correct attribute names. Overrides attr-naming-
+# style. If left empty, attribute names will be checked with the set naming
+# style.
+#attr-rgx=
+
+# Bad variable names which should always be refused, separated by a comma.
+bad-names=foo,
+          bar,
+          baz,
+          toto,
+          tutu,
+          tata
+
+# Bad variable names regexes, separated by a comma. If names match any regex,
+# they will always be refused
+bad-names-rgxs=
+
+# Naming style matching correct class attribute names.
+class-attribute-naming-style=any
+
+# Regular expression matching correct class attribute names. Overrides class-
+# attribute-naming-style. If left empty, class attribute names will be checked
+# with the set naming style.
+#class-attribute-rgx=
+
+# Naming style matching correct class constant names.
+class-const-naming-style=UPPER_CASE
+
+# Regular expression matching correct class constant names. Overrides class-
+# const-naming-style. If left empty, class constant names will be checked with
+# the set naming style.
+#class-const-rgx=
+
+# Naming style matching correct class names.
+class-naming-style=PascalCase
+
+# Regular expression matching correct class names. Overrides class-naming-
+# style. If left empty, class names will be checked with the set naming style.
+#class-rgx=
+
+# Naming style matching correct constant names.
+const-naming-style=UPPER_CASE
+
+# Regular expression matching correct constant names. Overrides const-naming-
+# style. If left empty, constant names will be checked with the set naming
+# style.
+#const-rgx=
+
+# Minimum line length for functions/classes that require docstrings, shorter
+# ones are exempt.
+docstring-min-length=-1
+
+# Naming style matching correct function names.
+function-naming-style=snake_case
+
+# Regular expression matching correct function names. Overrides function-
+# naming-style. If left empty, function names will be checked with the set
+# naming style.
+#function-rgx=
+
+# Good variable names which should always be accepted, separated by a comma.
+good-names=i,
+           j,
+           k,
+           ex,
+           Run,
+           _
+
+# Good variable names regexes, separated by a comma. If names match any regex,
+# they will always be accepted
+good-names-rgxs=
+
+# Include a hint for the correct naming format with invalid-name.
+include-naming-hint=no
+
+# Naming style matching correct inline iteration names.
+inlinevar-naming-style=any
+
+# Regular expression matching correct inline iteration names. Overrides
+# inlinevar-naming-style. If left empty, inline iteration names will be checked
+# with the set naming style.
+#inlinevar-rgx=
+
+# Naming style matching correct method names.
+method-naming-style=snake_case
+
+# Regular expression matching correct method names. Overrides method-naming-
+# style. If left empty, method names will be checked with the set naming style.
+#method-rgx=
+
+# Naming style matching correct module names.
+module-naming-style=snake_case
+
+# Regular expression matching correct module names. Overrides module-naming-
+# style. If left empty, module names will be checked with the set naming style.
+#module-rgx=
+
+# Colon-delimited sets of names that determine each other's naming style when
+# the name regexes allow several styles.
+name-group=
+
+# Regular expression which should only match function or class names that do
+# not require a docstring.
+no-docstring-rgx=^_
+
+# List of decorators that produce properties, such as abc.abstractproperty. Add
+# to this list to register other decorators that produce valid properties.
+# These decorators are taken in consideration only for invalid-name.
+property-classes=abc.abstractproperty
+
+# Regular expression matching correct type alias names. If left empty, type
+# alias names will be checked with the set naming style.
+#typealias-rgx=
+
+# Regular expression matching correct type variable names. If left empty, type
+# variable names will be checked with the set naming style.
+#typevar-rgx=
+
+# Naming style matching correct variable names.
+variable-naming-style=snake_case
+
+# Regular expression matching correct variable names. Overrides variable-
+# naming-style. If left empty, variable names will be checked with the set
+# naming style.
+#variable-rgx=
+
+
+[CLASSES]
+
+# Warn about protected attribute access inside special methods
+check-protected-access-in-special-methods=no
+
+# List of method names used to declare (i.e. assign) instance attributes.
+defining-attr-methods=__init__,
+                      __new__,
+                      setUp,
+                      asyncSetUp,
+                      __post_init__
+
+# List of member names, which should be excluded from the protected access
+# warning.
+exclude-protected=_asdict,_fields,_replace,_source,_make,os._exit
+
+# List of valid names for the first argument in a class method.
+valid-classmethod-first-arg=cls
+
+# List of valid names for the first argument in a metaclass class method.
+valid-metaclass-classmethod-first-arg=mcs
+
+
+[DESIGN]
+
+# List of regular expressions of class ancestor names to ignore when counting
+# public methods (see R0903)
+exclude-too-few-public-methods=
+
+# List of qualified class names to ignore when counting class parents (see
+# R0901)
+ignored-parents=
+
+# Maximum number of arguments for function / method.
+max-args=5
+
+# Maximum number of attributes for a class (see R0902).
+max-attributes=7
+
+# Maximum number of boolean expressions in an if statement (see R0916).
+max-bool-expr=5
+
+# Maximum number of branch for function / method body.
+max-branches=12
+
+# Maximum number of locals for function / method body.
+max-locals=15
+
+# Maximum number of parents for a class (see R0901).
+max-parents=7
+
+# Maximum number of positional arguments for function / method.
+max-positional-arguments=5
+
+# Maximum number of public methods for a class (see R0904).
+max-public-methods=20
+
+# Maximum number of return / yield for function / method body.
+max-returns=6
+
+# Maximum number of statements in function / method body.
+max-statements=50
+
+# Minimum number of public methods for a class (see R0903).
+min-public-methods=2
+
+
+[EXCEPTIONS]
+
+# Exceptions that will emit a warning when caught.
+overgeneral-exceptions=builtins.BaseException,builtins.Exception
+
+
+[FORMAT]
+
+# Expected format of line ending, e.g. empty (any line ending), LF or CRLF.
+expected-line-ending-format=
+
+# Regexp for a line that is allowed to be longer than the limit.
+ignore-long-lines=^\s*(# )?<?https?://\S+>?$
+
+# Number of spaces of indent required inside a hanging or continued line.
+indent-after-paren=4
+
+# String used as indentation unit. This is usually "    " (4 spaces) or "\t" (1
+# tab).
+indent-string='    '
+
+# Maximum number of characters on a single line.
+max-line-length=100
+
+# Maximum number of lines in a module.
+max-module-lines=1000
+
+# Allow the body of a class to be on the same line as the declaration if body
+# contains single statement.
+single-line-class-stmt=no
+
+# Allow the body of an if to be on the same line as the test if there is no
+# else.
+single-line-if-stmt=no
+
+
+[IMPORTS]
+
+# List of modules that can be imported at any level, not just the top level
+# one.
+allow-any-import-level=
+
+# Allow explicit reexports by alias from a package __init__.
+allow-reexport-from-package=no
+
+# Allow wildcard imports from modules that define __all__.
+allow-wildcard-with-all=no
+
+# Deprecated modules which should not be used, separated by a comma.
+deprecated-modules=
+
+# Output a graph (.gv or any supported image format) of external dependencies
+# to the given file (report RP0402 must not be disabled).
+ext-import-graph=
+
+# Output a graph (.gv or any supported image format) of all (i.e. internal and
+# external) dependencies to the given file (report RP0402 must not be
+# disabled).
+import-graph=
+
+# Output a graph (.gv or any supported image format) of internal dependencies
+# to the given file (report RP0402 must not be disabled).
+int-import-graph=
+
+# Force import order to recognize a module as part of the standard
+# compatibility libraries.
+known-standard-library=
+
+# Force import order to recognize a module as part of a third party library.
+known-third-party=enchant
+
+# Couples of modules and preferred modules, separated by a comma.
+preferred-modules=
+
+
+[LOGGING]
+
+# The type of string formatting that logging methods do. `old` means using %
+# formatting, `new` is for `{}` formatting.
+logging-format-style=old
+
+# Logging modules to check that the string format arguments are in logging
+# function parameter format.
+logging-modules=logging
+
+
+[MESSAGES CONTROL]
+
+# Only show warnings with the listed confidence levels. Leave empty to show
+# all. Valid levels: HIGH, CONTROL_FLOW, INFERENCE, INFERENCE_FAILURE,
+# UNDEFINED.
+confidence=HIGH,
+           CONTROL_FLOW,
+           INFERENCE,
+           INFERENCE_FAILURE,
+           UNDEFINED
+
+# Disable the message, report, category or checker with the given id(s). You
+# can either give multiple identifiers separated by comma (,) or put this
+# option multiple times (only on the command line, not in the configuration
+# file where it should appear only once). You can also use "--disable=all" to
+# disable everything first and then re-enable specific checks. For example, if
+# you want to run only the similarities checker, you can use "--disable=all
+# --enable=similarities". If you want to run only the classes checker, but have
+# no Warning level messages displayed, use "--disable=all --enable=classes
+# --disable=W".
+disable=raw-checker-failed,
+        bad-inline-option,
+        locally-disabled,
+        file-ignored,
+        suppressed-message,
+        useless-suppression,
+        deprecated-pragma,
+        use-implicit-booleaness-not-comparison-to-string,
+        use-implicit-booleaness-not-comparison-to-zero,
+        use-symbolic-message-instead,
+        missing-module-docstring,
+        missing-class-docstring,
+        missing-function-docstring,
+        redefined-builtin
+
+# Enable the message, report, category or checker with the given id(s). You can
+# either give multiple identifier separated by comma (,) or put this option
+# multiple time (only on the command line, not in the configuration file where
+# it should appear only once). See also the "--disable" option for examples.
+enable=
+
+
+[METHOD_ARGS]
+
+# List of qualified names (i.e., library.method) which require a timeout
+# parameter e.g. 'requests.api.get,requests.api.post'
+timeout-methods=requests.api.delete,requests.api.get,requests.api.head,requests.api.options,requests.api.patch,requests.api.post,requests.api.put,requests.api.request
+
+
+[MISCELLANEOUS]
+
+# List of note tags to take in consideration, separated by a comma.
+notes=FIXME,
+      XXX,
+      TODO
+
+# Regular expression of note tags to take in consideration.
+notes-rgx=
+
+
+[REFACTORING]
+
+# Maximum number of nested blocks for function / method body
+max-nested-blocks=5
+
+# Complete name of functions that never returns. When checking for
+# inconsistent-return-statements if a never returning function is called then
+# it will be considered as an explicit return statement and no message will be
+# printed.
+never-returning-functions=sys.exit,argparse.parse_error
+
+# Let 'consider-using-join' be raised when the separator to join on would be
+# non-empty (resulting in expected fixes of the type: ``"- " + " -
+# ".join(items)``)
+suggest-join-with-non-empty-separator=yes
+
+
+[REPORTS]
+
+# Python expression which should return a score less than or equal to 10. You
+# have access to the variables 'fatal', 'error', 'warning', 'refactor',
+# 'convention', and 'info' which contain the number of messages in each
+# category, as well as 'statement' which is the total number of statements
+# analyzed. This score is used by the global evaluation report (RP0004).
+evaluation=max(0, 0 if fatal else 10.0 - ((float(5 * error + warning + refactor + convention) / statement) * 10))
+
+# Template used to display messages. This is a python new-style format string
+# used to format the message information. See doc for all details.
+msg-template=
+
+# Set the output format. Available formats are: 'text', 'parseable',
+# 'colorized', 'json2' (improved json format), 'json' (old json format), msvs
+# (visual studio) and 'github' (GitHub actions). You can also give a reporter
+# class, e.g. mypackage.mymodule.MyReporterClass.
+#output-format=
+
+# Tells whether to display a full report or only the messages.
+reports=no
+
+# Activate the evaluation score.
+score=yes
+
+
+[SIMILARITIES]
+
+# Comments are removed from the similarity computation
+ignore-comments=yes
+
+# Docstrings are removed from the similarity computation
+ignore-docstrings=yes
+
+# Imports are removed from the similarity computation
+ignore-imports=yes
+
+# Signatures are removed from the similarity computation
+ignore-signatures=yes
+
+# Minimum lines number of a similarity.
+min-similarity-lines=4
+
+
+[SPELLING]
+
+# Limits count of emitted suggestions for spelling mistakes.
+max-spelling-suggestions=4
+
+# Spelling dictionary name. No available dictionaries : You need to install
+# both the python package and the system dependency for enchant to work.
+spelling-dict=
+
+# List of comma separated words that should be considered directives if they
+# appear at the beginning of a comment and should not be checked.
+spelling-ignore-comment-directives=fmt: on,fmt: off,noqa:,noqa,nosec,isort:skip,mypy:
+
+# List of comma separated words that should not be checked.
+spelling-ignore-words=
+
+# A path to a file that contains the private dictionary; one word per line.
+spelling-private-dict-file=
+
+# Tells whether to store unknown words to the private dictionary (see the
+# --spelling-private-dict-file option) instead of raising a message.
+spelling-store-unknown-words=no
+
+
+[STRING]
+
+# This flag controls whether inconsistent-quotes generates a warning when the
+# character used as a quote delimiter is used inconsistently within a module.
+check-quote-consistency=no
+
+# This flag controls whether the implicit-str-concat should generate a warning
+# on implicit string concatenation in sequences defined over several lines.
+check-str-concat-over-line-jumps=no
+
+
+[TYPECHECK]
+
+# List of decorators that produce context managers, such as
+# contextlib.contextmanager. Add to this list to register other decorators that
+# produce valid context managers.
+contextmanager-decorators=contextlib.contextmanager
+
+# List of members which are set dynamically and missed by pylint inference
+# system, and so shouldn't trigger E1101 when accessed. Python regular
+# expressions are accepted.
+generated-members=
+
+# Tells whether to warn about missing members when the owner of the attribute
+# is inferred to be None.
+ignore-none=yes
+
+# This flag controls whether pylint should warn about no-member and similar
+# checks whenever an opaque object is returned when inferring. The inference
+# can return multiple potential results while evaluating a Python object, but
+# some branches might not be evaluated, which results in partial inference. In
+# that case, it might be useful to still emit no-member and other checks for
+# the rest of the inferred objects.
+ignore-on-opaque-inference=yes
+
+# List of symbolic message names to ignore for Mixin members.
+ignored-checks-for-mixins=no-member,
+                          not-async-context-manager,
+                          not-context-manager,
+                          attribute-defined-outside-init
+
+# List of class names for which member attributes should not be checked (useful
+# for classes with dynamically set attributes). This supports the use of
+# qualified names.
+ignored-classes=optparse.Values,thread._local,_thread._local,argparse.Namespace
+
+# Show a hint with possible names when a member name was not found. The aspect
+# of finding the hint is based on edit distance.
+missing-member-hint=yes
+
+# The minimum edit distance a name should have in order to be considered a
+# similar match for a missing member name.
+missing-member-hint-distance=1
+
+# The total number of similar names that should be taken in consideration when
+# showing a hint for a missing member.
+missing-member-max-choices=1
+
+# Regex pattern to define which classes are considered mixins.
+mixin-class-rgx=.*[Mm]ixin
+
+# List of decorators that change the signature of a decorated function.
+signature-mutators=
+
+
+[VARIABLES]
+
+# List of additional names supposed to be defined in builtins. Remember that
+# you should avoid defining new builtins when possible.
+additional-builtins=
+
+# Tells whether unused global variables should be treated as a violation.
+allow-global-unused-variables=yes
+
+# List of names allowed to shadow builtins
+allowed-redefined-builtins=
+
+# List of strings which can identify a callback function by name. A callback
+# name must start or end with one of those strings.
+callbacks=cb_,
+          _cb
+
+# A regular expression matching the name of dummy variables (i.e. expected to
+# not be used).
+dummy-variables-rgx=_+$|(_[a-zA-Z0-9_]*[a-zA-Z0-9]+?$)|dummy|^ignored_|^unused_
+
+# Argument names that match this expression will be ignored.
+ignored-argument-names=_.*|^ignored_|^unused_
+
+# Tells whether we should check for unused import in __init__ files.
+init-import=no
+
+# List of qualified module names which can have objects that can redefine
+# builtins.
+redefining-builtins-modules=six.moves,past.builtins,future.builtins,builtins,io

README.md

@@ -9,7 +9,7 @@
         Homepage
     </a>
     •
-    <a href="https://pyrofork.wulan17.top">
+    <a href="https://pyrofork.wulan17.dev">
         Documentation
     </a>
     •
@@ -44,7 +44,7 @@ async def hello(client, message):
 app.run()
 ```
 
-**Pyrofork** is a modern, elegant and asynchronous [MTProto API](https://pyrofork.wulan17.top/main/topics/mtproto-vs-botapi)
+**Pyrofork** is a modern, elegant and asynchronous [MTProto API](https://pyrofork.wulan17.dev/main/topics/mtproto-vs-botapi)
 framework. It enables you to easily interact with the main Telegram API through a user account (custom client) or a bot
 identity (bot API alternative) using Python.
 
@@ -72,6 +72,6 @@ pip3 install pyrofork
 
 ### Resources
 
-- Check out the docs at https://pyrofork.wulan17.top to learn more about Pyrofork, get started right
+- Check out the docs at https://pyrofork.wulan17.dev to learn more about Pyrofork, get started right
 away and discover more in-depth material for building your client applications.
 - Join the official group at https://t.me/MayuriChan_Chat and stay tuned for news, updates and announcements.

build-docs.sh

@@ -1,42 +1,87 @@
 #!/bin/bash
-export DOCS_KEY
-VENV="$(pwd)"/venv
-export VENV
 
-if [[ "$(echo "$GITHUB_REF" | cut -d '/' -f "1 2")" == "refs/tags" ]]; then
+# Check if config.sh exists
-    branch="main"
+if [ -f config.sh ]; then
-elif [[ "$GITHUB_REF" == "refs/heads/staging" ]]; then
+    source config.sh
-    branch="staging"
+fi
-else
+
-    b="$(echo "$GITHUB_REF" | cut -d '/' -f '3 4')"
+function parse_parameters() {
-    if [[ $(echo "$b" | cut -d '/' -f 1 ) == "dev" ]]; then
+    while (($#)); do
-        b="$(echo "$b" | cut -d '/' -f 2)"
+        case $1 in
-        if [[ "$b" =~ ^[0-9]\.[0-9]\.x ]]; then
+            all | configure | cleanup | virtualenv | build | clone | push ) action=$1 ;;
-            branch="$b"
+            *) exit 33 ;;
+        esac
+        shift
+    done
+}
+
+function do_configure() {
+    echo "#!/bin/bash" > config.sh
+    echo "export VENV=\"$(pwd)/venv\"" >> config.sh
+
+    if [[ "$(echo "$GITHUB_REF" | cut -d '/' -f "1 2")" == "refs/tags" ]]; then
+        echo "export BRANCH=\"main\"" >> config.sh
+    elif [[ "$GITHUB_REF" == "refs/heads/staging" ]]; then
+        echo "export BRANCH=\"staging\"" >> config.sh
+    else
+        b="$(echo "$GITHUB_REF" | cut -d '/' -f '3 4')"
+        if [[ $(echo "$b" | cut -d '/' -f 1 ) == "dev" ]]; then
+            b="$(echo "$b" | cut -d '/' -f 2)"
+            if [[ "$b" =~ ^[0-9]\.[0-9]\.x ]]; then
+                echo "export BRANCH=\"$b\"" >> config.sh
+            else
+                exit 0
+            fi
         else
             exit 0
         fi
-    else
-        exit 0
     fi
-fi
+    chmod +x config.sh
+}
 
-make clean
+function do_cleanup() {
-make clean-docs
+    make clean
-make venv
+    make clean-docs
-make api
+}
-"$VENV"/bin/pip install -e '.[docs]'
+
-cd compiler/docs || exit 1 && "$VENV"/bin/python compiler.py
+function do_virtualenv() {
-cd  ../.. || exit 1
+    make venv
-"$VENV"/bin/sphinx-build -b html "docs/source" "docs/build/html" -j auto
+    make api
-git clone https://wulan17:"$DOCS_KEY"@github.com/Mayuri-Chan/pyrofork-docs.git
+    "$VENV"/bin/pip install -e '.[docs]'
-cd pyrofork-docs || exit 1
+}
-mkdir -p "$branch"
+
-cd "$branch" || exit 1
+function do_build() {
-rm -rf _includes api genindex.html intro py-modindex.html sitemap.xml support.html topics _static faq index.html objects.inv searchindex.js start telegram
+    cd compiler/docs || exit 1 && "$VENV"/bin/python compiler.py
-cp -r ../../docs/build/html/* .
+    cd  ../.. || exit 1
-git config --local user.name "Mayuri-Chan"
+    "$VENV"/bin/sphinx-build -b html "docs/source" "docs/build/html" -j auto
-git config --local user.email "mayuri@mayuri.my.id"
+}
-git add --all
+
-git commit -a -m "docs: $branch: Update docs $(date '+%Y-%m-%d | %H:%m:%S %p %Z')" --signoff
+function do_clone() {
-git push -u origin --all
+    git clone https://wulan17:"$DOCS_KEY"@github.com/Mayuri-Chan/pyrofork-docs.git
+}
+
+function do_push() {
+    cd pyrofork-docs || exit 1
+    mkdir -p "$BRANCH"
+    cd "$BRANCH" || exit 1
+    rm -rf _includes api genindex.html intro py-modindex.html sitemap.xml support.html topics _static faq index.html objects.inv searchindex.js start telegram
+    cp -r ../../docs/build/html/* .
+    git config --local user.name "Mayuri-Chan"
+    git config --local user.email "mayuri@mayuri.my.id"
+    git add --all
+    git commit -a -m "docs: $BRANCH: Update docs $(date '+%Y-%m-%d | %H:%m:%S %p %Z')" --signoff
+    git push -u origin --all
+}
+
+function do_all() {
+    do_configure
+    source config.sh
+    do_cleanup
+    do_virtualenv
+    do_build
+    do_clone
+    do_push
+}
+
+parse_parameters "$@"
+do_"${action:=all}"

compiler/api/compiler.py

@@ -130,7 +130,7 @@ def get_type_hint(type: str) -> str:
         return f"Optional[{type}] = None" if is_flag else type
     else:
         ns, name = type.split(".") if "." in type else ("", type)
-        type = f'"raw.base.' + ".".join([ns, name]).strip(".") + '"'
+        type = '"raw.base.' + ".".join([ns, name]).strip(".") + '"'
 
         return f'{type}{" = None" if is_flag else ""}'
 
@@ -430,11 +430,11 @@ def start(format: bool = False):
             if function_docs:
                 docstring += function_docs["desc"] + "\n"
             else:
-                docstring += f"Telegram API function."
+                docstring += "Telegram API function."
 
         docstring += f"\n\n    Details:\n        - Layer: ``{layer}``\n        - ID: ``{c.id[2:].upper()}``\n\n"
-        docstring += f"    Parameters:\n        " + \
+        docstring += "    Parameters:\n        " + \
-                     (f"\n        ".join(docstring_args) if docstring_args else "No parameters required.\n")
+                     ("\n        ".join(docstring_args) if docstring_args else "No parameters required.\n")
 
         if c.section == "functions":
             docstring += "\n    Returns:\n        " + get_docstring_arg_type(c.qualtype)
@@ -442,12 +442,12 @@ def start(format: bool = False):
             references, count = get_references(c.qualname, "constructors")
 
             if references:
-                docstring += f"\n    Functions:\n        This object can be returned by " \
+                docstring += "\n    Functions:\n        This object can be returned by " \
                              f"{count} function{'s' if count > 1 else ''}.\n\n" \
-                             f"        .. currentmodule:: pyrogram.raw.functions\n\n" \
+                             "        .. currentmodule:: pyrogram.raw.functions\n\n" \
-                             f"        .. autosummary::\n" \
+                             "        .. autosummary::\n" \
-                             f"            :nosignatures:\n\n" \
+                             "            :nosignatures:\n\n" \
-                             f"            " + references
+                             "            " + references
 
         write_types = read_types = "" if c.has_flags else "# No flags\n        "
 

compiler/api/template/type.txt

@@ -20,4 +20,4 @@ class {name}:  # type: ignore
         raise TypeError("Base types can only be used for type checking purposes: "
                         "you tried to use a base type instance as argument, "
                         "but you need to instantiate one of its constructors instead. "
-                        "More info: https://pyrofork.wulan17.top/telegram/base/{doc_name}")
+                        "More info: https://pyrofork.wulan17.dev/telegram/base/{doc_name}")

compiler/docs/compiler.py

@@ -146,6 +146,7 @@ def pyrogram_api():
             stop_transmission
             export_session_string
             set_parse_mode
+            ping
         """,
         conversation="""
         Conversation
@@ -164,7 +165,9 @@ def pyrogram_api():
         """,
         messages="""
         Messages
+            add_task_to_todo
             send_message
+            forward_media_group
             forward_messages
             copy_message
             copy_media_group
@@ -172,6 +175,7 @@ def pyrogram_api():
             send_audio
             send_document
             send_sticker
+            send_todo
             send_video
             send_animation
             send_voice
@@ -183,6 +187,7 @@ def pyrogram_api():
             send_contact
             send_cached_media
             send_reaction
+            set_todo_tasks_completion
             edit_message_text
             edit_message_caption
             edit_message_media
@@ -219,7 +224,10 @@ def pyrogram_api():
             get_discussion_replies
             get_discussion_replies_count
             get_custom_emoji_stickers
+            transcribe_audio
             translate_message_text
+            start_bot
+            delete_chat_history
         """,
         chats="""
         Chats
@@ -250,6 +258,7 @@ def pyrogram_api():
             get_folders
             get_forum_topics
             get_forum_topics_by_id
+            get_forum_topics_count
             set_chat_username
             archive_chats
             unarchive_chats
@@ -276,6 +285,7 @@ def pyrogram_api():
             hide_general_topic
             reopen_forum_topic
             reopen_general_topic
+            transfer_chat_ownership
             unhide_general_topic
             update_color
             update_folder
@@ -348,22 +358,34 @@ def pyrogram_api():
         Payments
             apply_gift_code
             check_gift_code
-            convert_star_gift
+            convert_gift
             create_invoice_link
             get_payment_form
-            get_star_gifts
             get_stars_transactions
             get_stars_transactions_by_id
-            get_user_star_gifts_count
+            get_available_gifts
-            get_user_star_gifts
+            get_upgraded_gift
-            hide_star_gift
+            get_chat_gifts_count
+            get_chat_gifts
+            hide_gift
             refund_star_payment
+            search_gifts_for_resale
             send_invoice
             send_paid_media
             send_paid_reaction
             send_payment_form
-            send_star_gift
+            send_gift
-            show_star_gift
+            send_resold_gift
+            set_gift_resale_price
+            set_pinned_gifts
+            show_gift
+            transfer_gift
+            upgrade_gift
+            get_stars_balance
+        """,
+        phone="""
+        Phone
+            get_call_members
         """,
         password="""
         Password
@@ -392,17 +414,18 @@ def pyrogram_api():
             get_bot_info
             set_bot_info
             get_collectible_item_info
-            get_available_gifts
+            get_owned_bots
-            get_user_gifts
+            get_similar_bots
-            sell_gift
-            send_gift
-            toggle_gift_is_saved
         """,
         business="""
         Telegram Business
             answer_pre_checkout_query
             answer_shipping_query
+            delete_business_messages
             get_business_connection
+            get_business_account_gifts
+            get_business_account_star_balance
+            transfer_business_account_stars
         """,
         authorization="""
         Authorization
@@ -414,12 +437,11 @@ def pyrogram_api():
             resend_code
             sign_in
             sign_in_bot
-            sign_up
+            sign_in_qrcode
             get_password_hint
             check_password
             send_recovery_code
             recover_password
-            accept_terms_of_service
             log_out
             get_active_sessions
         """,
@@ -443,7 +465,7 @@ def pyrogram_api():
         fmt_keys = {}
 
         for k, v in categories.items():
-            name, *methods = get_title_list(v)
+            _, *methods = get_title_list(v)
             fmt_keys.update({k: "\n    ".join("{0} <{0}>".format(m) for m in methods)})
 
             for method in methods:
@@ -477,6 +499,7 @@ def pyrogram_api():
             BusinessWeeklyOpen
             BusinessWorkingHours
             User
+            Username
             Chat
             ChatPreview
             ChatPhoto
@@ -495,22 +518,38 @@ def pyrogram_api():
             Folder
             Restriction
             EmojiStatus
+            ExportedFolderLink
             ForumTopic
             PeerUser
             PeerChannel
             BotInfo
+            GroupCallMember
             ChatColor
             CollectibleItemInfo
+            BotVerification
         """,
         messages_media="""
         Messages & Media
             Message
             MessageEntity
+            MessageOriginChannel
+            MessageOriginChat
+            MessageOriginHiddenUser
+            MessageOriginImport
+            MessageOriginUser
+            MessageOrigin
             Photo
             Thumbnail
+            TodoList
+            TodoTask
+            TodoTasksAdded
+            TodoTasksCompleted
+            TodoTasksIncompleted
             Audio
             AvailableEffect
             Document
+            ExternalReplyInfo
+            AlternativeVideo
             Animation
             Video
             Voice
@@ -521,6 +560,8 @@ def pyrogram_api():
             Sticker
             StickerSet
             Game
+            Gift
+            GiftAttribute
             Giveaway
             GiveawayLaunched
             GiveawayResult
@@ -528,12 +569,13 @@ def pyrogram_api():
             WebPage
             WebPageEmpty
             WebPagePreview
+            TranscribedAudio
             TranslatedText
+            TextQuote
             Poll
             PollOption
             Dice
             Reaction
-            StarGift
             VideoChatScheduled
             VideoChatStarted
             VideoChatEnded
@@ -545,6 +587,7 @@ def pyrogram_api():
             ForumTopicCreated
             ForumTopicEdited
             ForumTopicClosed
+            ForumTopicDeleted
             ForumTopicReopened
             GeneralTopicHidden
             GeneralTopicUnhidden
@@ -580,12 +623,11 @@ def pyrogram_api():
             ExtendedMediaPreview
             GiftCode
             GiftedPremium
-            Gift
-            UserGift
             InputStarsTransaction
             Invoice
             LabeledPrice
             PaidMedia
+            PaidMessagePriceChanged
             PaymentForm
             PaymentInfo
             PaymentRefunded
@@ -593,7 +635,6 @@ def pyrogram_api():
             StarsStatus
             StarsTransaction
             SuccessfulPayment
-            UserStarGift
         """,
         pyromod="""
         Pyromod
@@ -696,17 +737,20 @@ def pyrogram_api():
         InputMessageContent
             InputMessageContent
             InputReplyToMessage
+            InputReplyToMonoforum
             InputReplyToStory
             InputTextMessageContent
             InputLocationMessageContent
             InputVenueMessageContent
             InputContactMessageContent
             InputInvoiceMessageContent
+            InputTodoTask
         """,
         authorization="""
         Authorization
             ActiveSession
             ActiveSessions
+            LoginToken
             SentCode
             TermsOfService
         """
@@ -724,7 +768,7 @@ def pyrogram_api():
         fmt_keys = {}
 
         for k, v in categories.items():
-            name, *types = get_title_list(v)
+            _, *types = get_title_list(v)
 
             fmt_keys.update({k: "\n    ".join(types)})
 
@@ -778,9 +822,9 @@ def pyrogram_api():
             Message.reply_web_page
             Message.get_media_group
             Message.react
+            Message.transcribe
             Message.translate
             Message.wait_for_click
-            UserGift.toggle
         """,
         chat="""
         Chat
@@ -838,6 +882,26 @@ def pyrogram_api():
             Story.reply_video_note
             Story.reply_voice
         """,
+        folder="""
+        Folder
+            Folder.delete
+            Folder.update
+            Folder.include_chat
+            Folder.exclude_chat
+            Folder.update_color
+            Folder.pin_chat
+            Folder.remove_chat
+            Folder.export_link
+        """,
+        gift="""
+        Gift
+            Gift.show
+            Gift.hide
+            Gift.convert
+            Gift.upgrade
+            Gift.transfer
+            Gift.wear
+        """,
         callback_query="""
         Callback Query
             CallbackQuery.answer
@@ -921,4 +985,4 @@ if "__main__" == __name__:
     DESTINATION = "../../docs/source/telegram"
     PYROGRAM_API_DEST = "../../docs/source/api"
 
-    start()
+    start()

compiler/docs/template/bound-methods.rst

@@ -140,3 +140,28 @@ ChatJoinRequest
 
     {chat_join_request_toctree}
 
+Folder
+---------------
+
+.. hlist::
+    :columns: 2
+
+    {folder_hlist}
+
+.. toctree::
+    :hidden:
+
+    {folder_toctree}
+
+Gift
+---------------
+
+.. hlist::
+    :columns: 2
+
+    {gift_hlist}
+
+.. toctree::
+    :hidden:
+
+    {gift_toctree}

compiler/docs/template/methods.rst

@@ -190,6 +190,19 @@ Bots
 
     {bots}
 
+Payments
+----
+
+.. autosummary::
+    :nosignatures:
+
+    {payments}
+
+.. toctree::
+    :hidden:
+
+    {payments}
+
 Authorization
 -------------
 
@@ -217,4 +230,4 @@ Learn more about how to use the raw API at :doc:`Advanced Usage <../../topics/ad
 .. toctree::
     :hidden:
 
-    {advanced}
+    {advanced}

compiler/docs/template/types.rst

@@ -164,6 +164,45 @@ InputMessageContent
 
     {input_message_content}
 
+ShippingQuery
+-------------------
+
+.. autosummary::
+    :nosignatures:
+
+    {shipping_query}
+
+.. toctree::
+    :hidden:
+
+    {shipping_query}
+
+PreCheckoutQuery
+-------------------
+
+.. autosummary::
+    :nosignatures:
+
+    {pre_checkout_query}
+
+.. toctree::
+    :hidden:
+
+    {pre_checkout_query}
+
+Payment
+-------------------
+
+.. autosummary::
+    :nosignatures:
+
+    {payment}
+
+.. toctree::
+    :hidden:
+
+    {payment}
+
 Authorization
 -------------
 
@@ -175,4 +214,4 @@ Authorization
 .. toctree::
     :hidden:
 
-    {authorization}
+    {authorization}

compiler/errors/compiler.py

@@ -17,6 +17,7 @@
 #  You should have received a copy of the GNU Lesser General Public License
 #  along with Pyrofork.  If not, see <http://www.gnu.org/licenses/>.
 
+import ast
 import csv
 import os
 import re
@@ -37,6 +38,13 @@ def caml(s):
     s = snek(s).split("_")
     return "".join([str(i.title()) for i in s])
 
+def get_classes_from_file(file_path):
+    with open(file_path, "r", encoding="utf-8") as f:
+        tree = ast.parse(f.read())
+
+    classes = [node.name for node in ast.walk(tree) if isinstance(node, ast.ClassDef)]
+    return classes
+
 
 def start():
     shutil.rmtree(DEST, ignore_errors=True)
@@ -127,6 +135,20 @@ def start():
             f_all.write("    },\n")
 
         f_all.write("}\n")
+        with open(init, "a", encoding="utf-8") as f_init:
+            f_init.write("\n")
+            all_classes = []
+            for i in files:
+                code, name = re.search(r"(\d+)_([A-Z_]+)", i).groups()
+                classes = get_classes_from_file("{}/{}_{}.py".format(DEST, name.lower(), code))
+                for j in classes:
+                    if j not in ["BaseException", "Exception", "PyrogramException"]:
+                        all_classes.append(j)
+            f_init.write("__all__ = [\n")
+            all_classes = sorted(set(all_classes))
+            for i in all_classes:
+                f_init.write("    \"{}\",\n".format(i))
+            f_init.write("]\n")
 
     with open("{}/all.py".format(DEST), encoding="utf-8") as f:
         content = f.read()

compiler/errors/source/400_BAD_REQUEST.tsv

@@ -35,6 +35,7 @@ BOT_GAMES_DISABLED	Bot games cannot be used in this type of chat
 BOT_GROUPS_BLOCKED	This bot can't be added to groups
 BOT_INLINE_DISABLED	The inline feature of the bot is disabled
 BOT_INVALID	This is not a valid bot
+BOT_INVOICE_INVALID	The provided invoice is invalid
 BOT_METHOD_INVALID	The method can't be used by bots
 BOT_MISSING	This method can only be run by a bot
 BOT_ONESIDE_NOT_AVAIL	Bots can't pin messages for one side only in private chats
@@ -46,6 +47,7 @@ BROADCAST_CALLS_DISABLED	Broadcast calls disabled
 BROADCAST_ID_INVALID	The channel is invalid
 BROADCAST_PUBLIC_VOTERS_FORBIDDEN	Polls with public voters cannot be sent in channels
 BROADCAST_REQUIRED	The request can only be used with a channel
+BUSINESS_BOT_MISSING	Business bot missing
 BUTTON_DATA_INVALID	The button callback data is invalid or too large
 BUTTON_ID_INVALID	The button_id parameter is invalid
 BUTTON_TEXT_INVALID	The specified button text is invalid
@@ -378,6 +380,9 @@ SLOWMODE_MULTI_MSGS_DISABLED	Slowmode is enabled, you cannot forward multiple me
 SMS_CODE_CREATE_FAILED	An error occurred while creating the SMS code
 SRP_ID_INVALID	Invalid SRP ID provided
 SRP_PASSWORD_CHANGED	The password has changed
+STARGIFT_ALREADY_CONVERTED	The provided star gift already converted to stars
+STARGIFT_ALREADY_UPGRADED	This star gift was already upgraded before
+STARGIFT_USAGE_LIMITED	The star gift usage is limited
 START_PARAM_EMPTY	The start parameter is empty
 START_PARAM_INVALID	The start parameter is invalid
 START_PARAM_TOO_LONG	The start parameter is too long
@@ -498,4 +503,6 @@ TTL_PERIOD_INVALID	The provided TTL period is invalid
 BOOSTS_REQUIRED	The specified channel must first be boosted by its users in order to perform this action
 BOOSTS_EMPTY	You can't modify the icon of the General topic.
 BOOST_NOT_MODIFIED	You're already boosting the specified channel.
+PAYMENT_REQUIRED	The payment is required
 BOOST_PEER_INVALID	The specified `boost_peer` is invalid.
+STARS_AMOUNT_INVALID	The specified `amount` is invalid.

compiler/errors/source/403_FORBIDDEN.tsv

@@ -44,3 +44,4 @@ GROUPCALL_ALREADY_STARTED	The groupcall has already started, you can join direct
 GROUPCALL_FORBIDDEN	The group call has already ended
 LIVE_DISABLED	Story is disabled server-side
 CHAT_GUEST_SEND_FORBIDDEN	You need to join the discussion group before commenting
+ALLOW_PAYMENT_REQUIRED_X	Payment of {value} stars is required to perform this action

docs/source/api/decorators.rst

@@ -41,6 +41,8 @@ Index
     - :meth:`~Client.on_edited_message`
     - :meth:`~Client.on_edited_bot_business_message`
     - :meth:`~Client.on_callback_query`
+    - :meth:`~Client.on_shipping_query`
+    - :meth:`~Client.on_pre_checkout_query`
     - :meth:`~Client.on_message_reaction_updated`
     - :meth:`~Client.on_message_reaction_count_updated`
     - :meth:`~Client.on_inline_query`
@@ -54,6 +56,7 @@ Index
     - :meth:`~Client.on_poll`
     - :meth:`~Client.on_disconnect`
     - :meth:`~Client.on_raw_update`
+    - :meth:`~Client.on_error`
 
 -----
 
@@ -76,9 +79,10 @@ Details
 .. autodecorator:: pyrogram.Client.on_chat_member_updated()
 .. autodecorator:: pyrogram.Client.on_chat_join_request()
 .. autodecorator:: pyrogram.Client.on_deleted_messages()
-.. autodecorator:: pyrogram.Client.on_edited_bot_business_message()
+.. autodecorator:: pyrogram.Client.on_deleted_bot_business_message()
 .. autodecorator:: pyrogram.Client.on_user_status()
 .. autodecorator:: pyrogram.Client.on_story()
 .. autodecorator:: pyrogram.Client.on_poll()
 .. autodecorator:: pyrogram.Client.on_disconnect()
 .. autodecorator:: pyrogram.Client.on_raw_update()
+.. autodecorator:: pyrogram.Client.on_error()

docs/source/api/enums/BusinessSchedule.rst

@@ -0,0 +1,8 @@
+BusinessSchedule
+==========
+
+.. autoclass:: pyrogram.enums.BusinessSchedule()
+    :members:
+
+.. raw:: html
+    :file: ./cleanup.html

docs/source/api/enums/ChatJoinType.rst

@@ -0,0 +1,8 @@
+ChatJoinType
+==========
+
+.. autoclass:: pyrogram.enums.ChatJoinType()
+    :members:
+
+.. raw:: html
+    :file: ./cleanup.html

docs/source/api/enums/ClientPlatform.rst

@@ -0,0 +1,8 @@
+ClientPlatform
+==========
+
+.. autoclass:: pyrogram.enums.ClientPlatform()
+    :members:
+
+.. raw:: html
+    :file: ./cleanup.html

docs/source/api/enums/GiftAttributeType.rst

@@ -0,0 +1,8 @@
+GiftAttributeType
+==========
+
+.. autoclass:: pyrogram.enums.GiftAttributeType()
+    :members:
+
+.. raw:: html
+    :file: ./cleanup.html

docs/source/api/enums/GiftForResaleOrder.rst

@@ -0,0 +1,8 @@
+GiftAttributeType
+=================
+
+.. autoclass:: pyrogram.enums.GiftForResaleOrder()
+    :members:
+
+.. raw:: html
+    :file: ./cleanup.html

docs/source/api/enums/MessageOriginType.rst

@@ -0,0 +1,8 @@
+MessageOriginType
+=================
+
+.. autoclass:: pyrogram.enums.MessageOriginType()
+    :members:
+
+.. raw:: html
+    :file: ./cleanup.html

docs/source/api/enums/ProfileColor.rst

@@ -0,0 +1,8 @@
+ProfileColor
+==========
+
+.. autoclass:: pyrogram.enums.ProfileColor()
+    :members:
+
+.. raw:: html
+    :file: ./cleanup.html

docs/source/api/enums/ReplyColor.rst

@@ -0,0 +1,8 @@
+ReplyColor
+==========
+
+.. autoclass:: pyrogram.enums.ReplyColor()
+    :members:
+
+.. raw:: html
+    :file: ./cleanup.html

docs/source/api/enums/index.rst

@@ -16,10 +16,13 @@ to apply only a valid value among the expected ones.
     BusinessSchedule
     ChatAction
     ChatEventAction
+    ChatJoinType
     ChatMemberStatus
     ChatMembersFilter
     ChatType
+    ClientPlatform
     FolderColor
+    GiftAttributeType
     ListenerTypes
     MessageEntityType
     MessageMediaType
@@ -27,22 +30,28 @@ to apply only a valid value among the expected ones.
     MessagesFilter
     ParseMode
     PollType
+    ProfileColor
     SentCodeType
     NextCodeType
     UserStatus
     ReactionType
+    ReplyColor
     StoriesPrivacyRules
     StoryPrivacy
 
 .. toctree::
     :hidden:
 
+    BusinessSchedule
     ChatAction
     ChatEventAction
+    ChatJoinType
     ChatMemberStatus
     ChatMembersFilter
     ChatType
+    ClientPlatform
     FolderColor
+    GiftAttributeType
     ListenerTypes
     MessageEntityType
     MessageMediaType
@@ -50,9 +59,11 @@ to apply only a valid value among the expected ones.
     MessagesFilter
     ParseMode
     PollType
+    ProfileColor
     SentCodeType
     NextCodeType
     UserStatus
     ReactionType
+    ReplyColor
     StoriesPrivacyRules
     StoryPrivacy

docs/source/api/handlers.rst

@@ -43,6 +43,8 @@ Index
     - :class:`DeletedMessagesHandler`
     - :class:`DeletedBotBusinessMessagesHandler`
     - :class:`CallbackQueryHandler`
+    - :class:`PreCheckoutQueryHandler`
+    - :class:`ShippingQueryHandler`
     - :class:`MessageReactionUpdatedHandler`
     - :class:`MessageReactionCountUpdatedHandler`
     - :class:`InlineQueryHandler`
@@ -53,6 +55,7 @@ Index
     - :class:`PollHandler`
     - :class:`DisconnectHandler`
     - :class:`RawUpdateHandler`
+    - :class:`ErrorHandler`
 
 -----
 
@@ -80,3 +83,4 @@ Details
 .. autoclass:: PollHandler()
 .. autoclass:: DisconnectHandler()
 .. autoclass:: RawUpdateHandler()
+.. autoclass:: ErrorHandler()

docs/source/conf.py

@@ -29,7 +29,7 @@ from pygments.styles.friendly import FriendlyStyle
 FriendlyStyle.background_color = "#f3f2f1"
 
 project = "Pyrofork"
-copyright = f"2022-present, Mayuri-Chan"
+copyright = "2022-present, Mayuri-Chan"
 author = "Mayuri-Chan"
 
 version = ".".join(__version__.split(".")[:-1])
@@ -73,7 +73,7 @@ html_theme_options = {
         "repo": "fontawesome/brands/github",
         "edit": "material/file-edit-outline",
     },
-    "site_url": "https://pyrofork.wulan17.top/",
+    "site_url": "https://pyrofork.wulan17.dev/",
     "repo_url": "https://github.com/Mayuri-Chan/pyrofork/",
     "repo_name": "pyrofork",
     "globaltoc_collapse": True,

docs/source/start/examples/bot_keyboards.rst

@@ -47,7 +47,7 @@ like send_audio(), send_document(), send_location(), etc...
                             ),
                             InlineKeyboardButton(  # Opens a web URL
                                 "URL",
-                                url="https://pyrofork.wulan17.top"
+                                url="https://pyrofork.wulan17.dev"
                             ),
                         ],
                         [  # Second row

docs/source/start/examples/inline_queries.rst

@@ -24,13 +24,13 @@ It uses the @on_inline_query decorator to register an InlineQueryHandler.
                     input_message_content=InputTextMessageContent(
                         "Here's how to install **Pyrofork**"
                     ),
-                    url="https://pyrofork.wulan17.top/intro/install",
+                    url="https://pyrofork.wulan17.dev/intro/install",
                     description="How to install Pyrofork",
                     reply_markup=InlineKeyboardMarkup(
                         [
                             [InlineKeyboardButton(
                                 "Open website",
-                                url="https://pyrofork.wulan17.top/intro/install"
+                                url="https://pyrofork.wulan17.dev/intro/install"
                             )]
                         ]
                     )
@@ -40,13 +40,13 @@ It uses the @on_inline_query decorator to register an InlineQueryHandler.
                     input_message_content=InputTextMessageContent(
                         "Here's how to use **Pyrofork**"
                     ),
-                    url="https://pyrofork.wulan17.top/start/invoking",
+                    url="https://pyrofork.wulan17.dev/start/invoking",
                     description="How to use Pyrofork",
                     reply_markup=InlineKeyboardMarkup(
                         [
                             [InlineKeyboardButton(
                                 "Open website",
-                                url="https://pyrofork.wulan17.top/start/invoking"
+                                url="https://pyrofork.wulan17.dev/start/invoking"
                             )]
                         ]
                     )

docs/source/start/examples/welcome_bot.rst

@@ -11,7 +11,7 @@ to make it only work for specific messages in a specific chat.
     # Target chat. Can also be a list of multiple chat ids/usernames
     TARGET = -100123456789
     # Welcome message template
-    MESSAGE = "{} Welcome to [Pyrofork](https://pyrofork.wulan17.top/)'s group chat {}!"
+    MESSAGE = "{} Welcome to [Pyrofork](https://pyrofork.wulan17.dev/)'s group chat {}!"
 
     app = Client("my_account")
 

docs/source/topics/storage-engines.rst

@@ -80,7 +80,20 @@ Using async_pymongo (Recommended for python3.9+):
         print(await app.get_me())
 
 
-Using motor:
+Using official mongodb driver:
+
+.. code-block:: python
+
+    from pymongo import AsyncMongoClient
+    from pyrogram import Client
+
+    conn = AsyncMongoClient("mongodb://...")
+
+    async with Client("my_account", mongodb=dict(connection=conn, remove_peers=False)) as app:
+        print(await app.get_me())
+
+
+Using motor (Deprecated, but still works):
 
 .. code-block:: python
 

docs/source/topics/text-formatting.rst

@@ -37,68 +37,16 @@ list of the basic styles currently supported by Pyrofork.
 - spoiler
 - `text URL <https://pyrogram.org>`_
 - `user text mention <tg://user?id=123456789>`_
+- :emoji:`🔥`
 - ``inline fixed-width code``
 - .. code-block:: text
 
     pre-formatted
       fixed-width
         code block
+- > Quoted text
 
-Markdown Style
+- > Quoted text with collapse/expand button
---------------
-
-To strictly use this mode, pass :obj:`~pyrogram.enums.ParseMode.MARKDOWN` to the *parse_mode* parameter when using
-:meth:`~pyrogram.Client.send_message`. Use the following syntax in your message:
-
-.. code-block:: text
-
-    **bold**
-
-    __italic__
-
-    --underline--
-
-    ~~strike~~
-
-    ||spoiler||
-
-    [text URL](https://pyrogram.org/)
-
-    [text user mention](tg://user?id=123456789)
-
-    `inline fixed-width code`
-
-    ```
-    pre-formatted
-      fixed-width
-        code block
-    ```
-
-    > Quoted text
-
-**Example**:
-
-.. code-block:: python
-
-    from pyrogram import enums
-
-    await app.send_message(
-        "me",
-        (
-            "**bold**, "
-            "__italic__, "
-            "--underline--, "
-            "~~strike~~, "
-            "||spoiler||, "
-            "[URL](https://pyrogram.org), "
-            "`code`, "
-            "```"
-            "for i in range(10):\n"
-            "    print(i)"
-            "```"
-        ),
-        parse_mode=enums.ParseMode.MARKDOWN
-    )
 
 HTML Style
 ----------
@@ -122,10 +70,10 @@ To strictly use this mode, pass :obj:`~pyrogram.enums.HTML` to the *parse_mode*
 
     <a href="tg://user?id=123456789">inline mention</a>
 
-    <code>inline fixed-width code</code>
-
     <emoji id="12345678901234567890">🔥</emoji>
 
+    <code>inline fixed-width code</code>
+
     <pre>
     pre-formatted
       fixed-width
@@ -134,6 +82,8 @@ To strictly use this mode, pass :obj:`~pyrogram.enums.HTML` to the *parse_mode*
 
     <blockquote>Quoted text</blockquote>
 
+    <blockquote expandable>Quoted text with collapse/expand button</blockquote>
+
 **Example**:
 
 .. code-block:: python
@@ -178,6 +128,72 @@ To strictly use this mode, pass :obj:`~pyrogram.enums.HTML` to the *parse_mode*
 
         &lt;my text&gt;
 
+Markdown Style
+--------------
+
+.. warning::
+
+    The Markdown style is not recommended for complex text formatting.
+    If you want to use complex text formatting such as nested entities, overlapping entities use the HTML style instead.
+
+
+To strictly use this mode, pass :obj:`~pyrogram.enums.ParseMode.MARKDOWN` to the *parse_mode* parameter when using
+:meth:`~pyrogram.Client.send_message`. Use the following syntax in your message:
+
+.. code-block:: text
+
+    **bold**
+
+    __italic__
+
+    --underline--
+
+    ~~strike~~
+
+    ||spoiler||
+
+    [text URL](https://pyrogram.org/)
+
+    [text user mention](tg://user?id=123456789)
+
+    ![🔥](tg://emoji?id=12345678901234567890)
+
+    `inline fixed-width code`
+
+    ```
+    pre-formatted
+      fixed-width
+        code block
+    ```
+
+    > Quoted text
+
+    **> Quoted text with collapse/expand button
+
+**Example**:
+
+.. code-block:: python
+
+    from pyrogram import enums
+
+    await app.send_message(
+        "me",
+        (
+            "**bold**, "
+            "__italic__, "
+            "--underline--, "
+            "~~strike~~, "
+            "||spoiler||, "
+            "[URL](https://pyrogram.org), "
+            "`code`, "
+            "```"
+            "for i in range(10):\n"
+            "    print(i)"
+            "```"
+        ),
+        parse_mode=enums.ParseMode.MARKDOWN
+    )
+
 Different Styles
 ----------------
 
@@ -230,18 +246,18 @@ strike` styles, and you can still combine both Markdown and HTML together.
 
 Here there are some example texts you can try sending:
 
-**Markdown**:
-
-- ``**bold, --underline--**``
-- ``**bold __italic --underline ~~strike~~--__**``
-- ``**bold __and** italic__``
-
 **HTML**:
 
 - ``<b>bold, <u>underline</u></b>``
 - ``<b>bold <i>italic <u>underline <s>strike</s></u></i></b>``
 - ``<b>bold <i>and</b> italic</i>``
 
+**Markdown (Not Recommended)**:
+
+- ``**bold, --underline--**``
+- ``**bold __italic --underline ~~strike~~--__**``
+- ``**bold __and** italic__``
+
 **Combined**:
 
 - ``--you can combine <i>HTML</i> with **Markdown**--``

pyproject.toml

@@ -6,7 +6,7 @@ authors = [{ name = "wulan17", email = "mayuri@mayuri.my.id" }]
 dependencies = ["pyaes==1.6.1", "pysocks==1.7.1", "pymediainfo-pyrofork>=6.0.1,<7.0.0"]
 readme = "README.md"
 license = "LGPL-3.0-or-later"
-requires-python = "~=3.9"
+requires-python = "~=3.10"
 classifiers = [
     "Development Status :: 5 - Production/Stable",
     "Intended Audience :: Developers",
@@ -15,11 +15,11 @@ classifiers = [
     "Operating System :: OS Independent",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Programming Language :: Python :: Implementation",
     "Programming Language :: Python :: Implementation :: CPython",
     "Programming Language :: Python :: Implementation :: PyPy",
@@ -43,7 +43,7 @@ Homepage = "https://github.com/Mayuri-Chan"
 Tracker = "https://github.com/Mayuri-Chan/pyrofork/issues"
 Community = "https://t.me/MayuriChan_Chat"
 Source = "https://github.com/Mayuri-Chan/pyrofork"
-Documentation = "https://pyrofork.wulan17.top"
+Documentation = "https://pyrofork.wulan17.dev"
 
 [build-system]
 requires = ["hatchling"]
@@ -60,7 +60,7 @@ dev = [
 
 docs = [
     "sphinx",
-    "sphinx-immaterial==0.12.4",
+    "sphinx-immaterial==0.12.5",
     "sphinx_copybutton",
     "sphinx-autobuild",
     "tornado>=6.3.3"

pyrogram/__init__.py

@@ -18,7 +18,7 @@
 #  along with Pyrofork.  If not, see <http://www.gnu.org/licenses/>.
 
 __fork_name__ = "PyroFork"
-__version__ = "2.3.52"
+__version__ = "2.3.69"
 __license__ = "GNU Lesser General Public License v3.0 (LGPL-3.0)"
 __copyright__ = "Copyright (C) 2022-present Mayuri-Chan <https://github.com/Mayuri-Chan>"
 
@@ -37,8 +37,24 @@ class ContinuePropagation(StopAsyncIteration):
     pass
 
 
-from . import raw, types, filters, handlers, emoji, enums
+from . import raw, types, filters, handlers, emoji, enums  # pylint: disable=wrong-import-position
-from .client import Client
+from .client import Client  # pylint: disable=wrong-import-position
-from .sync import idle, compose
+from .sync import idle, compose  # pylint: disable=wrong-import-position
 
 crypto_executor = ThreadPoolExecutor(1, thread_name_prefix="CryptoWorker")
+
+__all__ = [
+    "Client",
+    "idle",
+    "compose",
+    "crypto_executor",
+    "StopTransmission",
+    "StopPropagation",
+    "ContinuePropagation",
+    "raw",
+    "types",
+    "filters",
+    "handlers",
+    "emoji",
+    "enums",
+]

pyrogram/client.py

@@ -33,12 +33,13 @@ from importlib import import_module
 from io import StringIO, BytesIO
 from mimetypes import MimeTypes
 from pathlib import Path
-from typing import Union, List, Optional, Callable, AsyncGenerator, Type, Tuple
+from typing import Union, List, Optional, Callable, AsyncGenerator, Tuple
 
 import pyrogram
 from pyrogram import __version__, __license__
 from pyrogram import enums
 from pyrogram import raw
+from pyrogram import types
 from pyrogram import utils
 from pyrogram.crypto import aes
 from pyrogram.errors import CDNFileHashMismatch
@@ -51,24 +52,26 @@ from pyrogram.handlers.handler import Handler
 from pyrogram.methods import Methods
 from pyrogram.session import Auth, Session
 from pyrogram.storage import FileStorage, MemoryStorage, Storage
+from pyrogram.types import User
+from pyrogram.utils import ainput
+from .connection import Connection
+from .connection.transport import TCPAbridged
+from .dispatcher import Dispatcher
+from .file_id import FileId, FileType, ThumbnailSource
+from .mime_types import mime_types
+from .parser import Parser
+from .session.internals import MsgId
+
+log = logging.getLogger(__name__)
+MONGO_AVAIL = False
+
 try:
     import pymongo
 except Exception:
     pass
 else:
     from pyrogram.storage import MongoStorage
-from pyrogram.types import User, TermsOfService
+    MONGO_AVAIL = True
-from pyrogram.utils import ainput
-from .connection import Connection
-from .connection.transport import TCP, TCPAbridged
-from .dispatcher import Dispatcher
-from .file_id import FileId, FileType, ThumbnailSource
-from .filters import Filter
-from .mime_types import mime_types
-from .parser import Parser
-from .session.internals import MsgId
-
-log = logging.getLogger(__name__)
 
 
 class Client(Methods):
@@ -128,6 +131,9 @@ class Client(Methods):
             Pass a session string to load the session in-memory.
             Implies ``in_memory=True``.
 
+        use_qrcode (``bool``, *optional*):
+            Pass True to login using a QR code.
+
         in_memory (``bool``, *optional*):
             Pass True to start an in-memory session that will be discarded as soon as the client stops.
             In order to reconnect again using an in-memory session without having to login again, you can use
@@ -221,10 +227,13 @@ class Client(Methods):
     SYSTEM_VERSION = f"{platform.system()} {platform.release()}"
 
     LANG_CODE = "en"
+    LANG_PACK = ""
+    SYSTEM_LANG_CODE = "en-US"
 
     PARENT_DIR = Path(sys.argv[0]).parent
 
     INVITE_LINK_RE = re.compile(r"^(?:https?://)?(?:www\.)?(?:t(?:elegram)?\.(?:org|me|dog)/(?:joinchat/|\+))([\w-]+)$")
+    UPGRADED_GIFT_RE = re.compile(r"^(?:https?://)?(?:www\.)?(?:t(?:elegram)?\.(?:org|me|dog)/(?:nft/|\+))([\w-]+)$")
     WORKERS = min(32, (os.cpu_count() or 0) + 4)  # os.cpu_count() can be None
     WORKDIR = PARENT_DIR
 
@@ -245,13 +254,16 @@ class Client(Methods):
         app_version: str = APP_VERSION,
         device_model: str = DEVICE_MODEL,
         system_version: str = SYSTEM_VERSION,
+        system_lang_code: str = SYSTEM_LANG_CODE,
         lang_code: str = LANG_CODE,
+        lang_pack: str = LANG_PACK,
         ipv6: Optional[bool] = False,
         alt_port: Optional[bool] = False,
         proxy: Optional[dict] = None,
         test_mode: Optional[bool] = False,
         bot_token: Optional[str] = None,
         session_string: Optional[str] = None,
+        use_qrcode: Optional[bool] = False,
         in_memory: Optional[bool] = None,
         mongodb: Optional[dict] = None,
         storage: Optional[Storage] = None,
@@ -266,7 +278,7 @@ class Client(Methods):
         skip_updates: bool = True,
         takeout: bool = None,
         sleep_threshold: int = Session.SLEEP_THRESHOLD,
-        hide_password: Optional[bool] = False,
+        hide_password: Optional[bool] = True,
         max_concurrent_transmissions: int = MAX_CONCURRENT_TRANSMISSIONS,
         client_platform: "enums.ClientPlatform" = enums.ClientPlatform.OTHER,
         max_message_cache_size: int = MAX_CACHE_SIZE,
@@ -280,13 +292,16 @@ class Client(Methods):
         self.app_version = app_version
         self.device_model = device_model
         self.system_version = system_version
+        self.system_lang_code = system_lang_code.lower()
         self.lang_code = lang_code.lower()
+        self.lang_pack = lang_pack.lower()
         self.ipv6 = ipv6
         self.alt_port = alt_port
         self.proxy = proxy
         self.test_mode = test_mode
         self.bot_token = bot_token
         self.session_string = session_string
+        self.use_qrcode = use_qrcode
         self.in_memory = in_memory
         self.mongodb = mongodb
         self.phone_number = phone_number
@@ -316,9 +331,7 @@ class Client(Methods):
         elif self.in_memory:
             self.storage = MemoryStorage(self.name)
         elif self.mongodb:
-            try:
+            if not MONGO_AVAIL:
-                import pymongo
-            except Exception:
                 log.warning(
                     "pymongo is missing! "
                     "Using MemoryStorage as session storage"
@@ -397,6 +410,15 @@ class Client(Methods):
             if datetime.now() - self.last_update_time > timedelta(seconds=self.UPDATES_WATCHDOG_INTERVAL):
                 await self.invoke(raw.functions.updates.GetState())
 
+    async def _wait_for_update_login_token(self):
+        """
+        Wait for an UpdateLoginToken update from Telegram.
+        """
+        while True:
+            update, _, _ = await self.dispatcher.updates_queue.get()
+            if isinstance(update, raw.types.UpdateLoginToken):
+                break
+
     async def authorize(self) -> User:
         if self.bot_token:
             return await self.sign_in_bot(self.bot_token)
@@ -404,52 +426,60 @@ class Client(Methods):
         print(f"Welcome to Pyrogram (version {__version__})")
         print(f"Pyrogram is free software and comes with ABSOLUTELY NO WARRANTY. Licensed\n"
               f"under the terms of the {__license__}.\n")
+        if not self.use_qrcode:
+            while True:
+                try:   
+                    if not self.phone_number:
+                        while True:
+                            print("Enter 'qrcode' if you want to login with qrcode.")
+                            value = await ainput("Enter phone number or bot token: ")
+
+                            if not value:
+                                continue
+
+                            if value.lower() == "qrcode":
+                                self.use_qrcode = True
+                                break
+
+                            confirm = (await ainput(f'Is "{value}" correct? (y/N): ')).lower()
+
+                            if confirm == "y":
+                                break
+
+                        if ":" in value:
+                            self.bot_token = value
+                            return await self.sign_in_bot(value)
+                        else:
+                            self.phone_number = value
+                    if not self.use_qrcode:
+                        sent_code = await self.send_code(self.phone_number)
+                except BadRequest as e:
+                    print(e.MESSAGE)
+                    self.phone_number = None
+                    self.bot_token = None
+                else:
+                    break
+            if not self.use_qrcode:
+                sent_code_descriptions = {
+                    enums.SentCodeType.APP: "Telegram app",
+                    enums.SentCodeType.SMS: "SMS",
+                    enums.SentCodeType.CALL: "phone call",
+                    enums.SentCodeType.FLASH_CALL: "phone flash call",
+                    enums.SentCodeType.FRAGMENT_SMS: "Fragment SMS",
+                    enums.SentCodeType.EMAIL_CODE: "email code"
+                }
+
+                print(f"The confirmation code has been sent via {sent_code_descriptions[sent_code.type]}")
 
         while True:
-            try:
+            if not self.use_qrcode and not self.phone_code:
-                if not self.phone_number:
-                    while True:
-                        value = await ainput("Enter phone number or bot token: ")
-
-                        if not value:
-                            continue
-
-                        confirm = (await ainput(f'Is "{value}" correct? (y/N): ')).lower()
-
-                        if confirm == "y":
-                            break
-
-                    if ":" in value:
-                        self.bot_token = value
-                        return await self.sign_in_bot(value)
-                    else:
-                        self.phone_number = value
-
-                sent_code = await self.send_code(self.phone_number)
-            except BadRequest as e:
-                print(e.MESSAGE)
-                self.phone_number = None
-                self.bot_token = None
-            else:
-                break
-
-        sent_code_descriptions = {
-            enums.SentCodeType.APP: "Telegram app",
-            enums.SentCodeType.SMS: "SMS",
-            enums.SentCodeType.CALL: "phone call",
-            enums.SentCodeType.FLASH_CALL: "phone flash call",
-            enums.SentCodeType.FRAGMENT_SMS: "Fragment SMS",
-            enums.SentCodeType.EMAIL_CODE: "email code"
-        }
-
-        print(f"The confirmation code has been sent via {sent_code_descriptions[sent_code.type]}")
-
-        while True:
-            if not self.phone_code:
                 self.phone_code = await ainput("Enter confirmation code: ")
 
             try:
-                signed_in = await self.sign_in(self.phone_number, sent_code.phone_code_hash, self.phone_code)
+                if self.use_qrcode:
+                    signed_in = await self.sign_in_qrcode()
+                else:
+                    signed_in = await self.sign_in(self.phone_number, sent_code.phone_code_hash, self.phone_code)
             except BadRequest as e:
                 print(e.MESSAGE)
                 self.phone_code = None
@@ -488,33 +518,18 @@ class Client(Methods):
                         print(e.MESSAGE)
                         self.password = None
             else:
+                if self.use_qrcode and isinstance(signed_in, types.LoginToken):
+                    time_out = signed_in.expires - datetime.timestamp(datetime.now())
+                    try:
+                        await asyncio.wait_for(self._wait_for_update_login_token(), timeout=time_out)
+                    except asyncio.TimeoutError:
+                        print("QR code expired, Requesting new Qr code...")
+                    continue
                 break
 
         if isinstance(signed_in, User):
             return signed_in
 
-        while True:
-            first_name = await ainput("Enter first name: ")
-            last_name = await ainput("Enter last name (empty to skip): ")
-
-            try:
-                signed_up = await self.sign_up(
-                    self.phone_number,
-                    sent_code.phone_code_hash,
-                    first_name,
-                    last_name
-                )
-            except BadRequest as e:
-                print(e.MESSAGE)
-            else:
-                break
-
-        if isinstance(signed_in, TermsOfService):
-            print("\n" + signed_in.text + "\n")
-            await self.accept_terms_of_service(signed_in.id)
-
-        return signed_up
-
     def set_parse_mode(self, parse_mode: Optional["enums.ParseMode"]):
         """Set the parse mode to be used globally by the client.
 
@@ -810,7 +825,7 @@ class Client(Methods):
         if session_empty:
             if not self.api_id or not self.api_hash:
                 raise AttributeError("The API key is required for new authorizations. "
-                                     "More info: https://pyrofork.wulan17.top/main/start/auth")
+                                     "More info: https://pyrofork.wulan17.dev/main/start/auth")
 
             await self.storage.api_id(self.api_id)
 
@@ -888,7 +903,7 @@ class Client(Methods):
             count = 0
 
             if not include:
-                for current_root, dirnames, filenames in os.walk(root.replace(".", "/")):
+                for current_root, _, filenames in os.walk(root.replace(".", "/")):
                     namespace = current_root.replace("/", ".").replace("\\", ".")
                     if "__pycache__" in namespace:
                         continue
@@ -953,7 +968,7 @@ class Client(Methods):
                                                     )
 
                                                     count += 1
-                                        except Exception as e:
+                                        except Exception:
                                             pass
             else:
                 for path, handlers in include:
@@ -1042,7 +1057,7 @@ class Client(Methods):
                                                             )
 
                                                             count += 1
-                                                except Exception as e:
+                                                except Exception:
                                                     pass
 
                     if handlers is None:
@@ -1106,7 +1121,7 @@ class Client(Methods):
     async def handle_download(self, packet):
         file_id, directory, file_name, in_memory, file_size, progress, progress_args = packet
 
-        os.makedirs(directory, exist_ok=True) if not in_memory else None
+        _ = os.makedirs(directory, exist_ok=True) if not in_memory else None
         temp_file_path = os.path.abspath(re.sub("\\\\", "/", os.path.join(directory, file_name))) + ".temp"
         file = BytesIO() if in_memory else open(temp_file_path, "wb")
 

pyrogram/connection/__init__.py

@@ -18,3 +18,7 @@
 #  along with Pyrofork.  If not, see <http://www.gnu.org/licenses/>.
 
 from .connection import Connection
+
+__all__ = [
+    "Connection"
+]

pyrogram/connection/connection.py

@@ -52,7 +52,7 @@ class Connection:
         self.protocol: Optional[TCP] = None
 
     async def connect(self) -> None:
-        for i in range(Connection.MAX_CONNECTION_ATTEMPTS):
+        for _ in range(Connection.MAX_CONNECTION_ATTEMPTS):
             self.protocol = self.protocol_factory(ipv6=self.ipv6, proxy=self.proxy)
 
             try:

pyrogram/connection/transport/__init__.py

@@ -18,3 +18,6 @@
 #  along with Pyrofork.  If not, see <http://www.gnu.org/licenses/>.
 
 from .tcp import *
+
+__all__ = []
+__all__.extend(tcp.__all__)

pyrogram/connection/transport/tcp/__init__.py

@@ -23,3 +23,13 @@ from .tcp_abridged_o import TCPAbridgedO
 from .tcp_full import TCPFull
 from .tcp_intermediate import TCPIntermediate
 from .tcp_intermediate_o import TCPIntermediateO
+
+__all__ = [
+    "TCP",
+    "Proxy",
+    "TCPAbridged",
+    "TCPAbridgedO",
+    "TCPFull",
+    "TCPIntermediate",
+    "TCPIntermediateO"
+]

pyrogram/connection/transport/tcp/tcp.py

@@ -21,7 +21,6 @@ import asyncio
 import ipaddress
 import logging
 import socket
-from concurrent.futures import ThreadPoolExecutor
 from typing import Tuple, Dict, TypedDict, Optional
 
 import socks

pyrogram/crypto/aes.py

@@ -55,7 +55,7 @@ except ImportError:
     log.warning(
         "TgCrypto is missing! "
         "Pyrogram will work the same, but at a much slower speed. "
-        "More info: https://pyrofork.wulan17.top/main/topics/speedups"
+        "More info: https://pyrofork.wulan17.dev/main/topics/speedups"
     )
 
 

pyrogram/crypto/mtproto.py

@@ -71,7 +71,7 @@ def unpack(
         message = Message.read(data)
     except KeyError as e:
         if e.args[0] == 0:
-            raise ConnectionError(f"Received empty data. Check your internet connection.")
+            raise ConnectionError("Received empty data. Check your internet connection.")
 
         left = data.read().hex()
 

pyrogram/crypto/prime.py

@@ -55,7 +55,7 @@ def decompose(pq: int) -> int:
     while g == 1:
         x = y
 
-        for i in range(r):
+        for _ in range(r):
             y = (pow(y, 2, pq) + c) % pq
 
         k = 0
@@ -63,7 +63,7 @@ def decompose(pq: int) -> int:
         while k < r and g == 1:
             ys = y
 
-            for i in range(min(m, r - k)):
+            for _ in range(min(m, r - k)):
                 y = (pow(y, 2, pq) + c) % pq
                 q = q * (abs(x - y)) % pq
 

pyrogram/dispatcher.py

@@ -21,11 +21,11 @@ import asyncio
 import inspect
 import logging
 from collections import OrderedDict
+from typing import Any
 
 import pyrogram
-from pyrogram import errors
+from pyrogram import raw, types, utils
-from pyrogram import utils
+from pyrogram.handlers.handler import Handler
-from pyrogram import raw
 from pyrogram.handlers import (
   BotBusinessConnectHandler,
   BotBusinessMessageHandler,
@@ -33,6 +33,7 @@ from pyrogram.handlers import (
   MessageHandler,
   EditedMessageHandler,
   EditedBotBusinessMessageHandler,
+  ErrorHandler,
   DeletedMessagesHandler,
   DeletedBotBusinessMessagesHandler,
   MessageReactionUpdatedHandler,
@@ -47,7 +48,8 @@ from pyrogram.handlers import (
   ChosenInlineResultHandler,
   ChatMemberUpdatedHandler,
   ChatJoinRequestHandler,
-  StoryHandler
+  StoryHandler,
+  PurchasedPaidMediaHandler
 )
 from pyrogram.raw.types import (
     UpdateNewMessage, UpdateNewChannelMessage, UpdateNewScheduledMessage,
@@ -93,10 +95,16 @@ class Dispatcher:
 
     def __init__(self, client: "pyrogram.Client"):
         self.client = client
-        self.loop = asyncio.get_event_loop()
+        try:
+            loop = asyncio.get_event_loop()
+        except RuntimeError:
+            loop = asyncio.new_event_loop()
+            asyncio.set_event_loop(loop)
+        self.loop = loop
 
         self.handler_worker_tasks = []
         self.locks_list = []
+        self.error_handlers = []
 
         self.updates_queue = asyncio.Queue()
         self.groups = OrderedDict()
@@ -234,7 +242,7 @@ class Dispatcher:
         async def purchased_paid_media_parser(update, users, chats):
             return (
                 pyrogram.types.PurchasedPaidMedia._parse(self.client, update, users),
-                ChatBoostHandler
+                PurchasedPaidMediaHandler
             )
 
         self.update_parsers = {
@@ -264,7 +272,7 @@ class Dispatcher:
 
     async def start(self):
         if not self.client.no_updates:
-            for i in range(self.client.workers):
+            for _ in range(self.client.workers):
                 self.locks_list.append(asyncio.Lock())
 
                 self.handler_worker_tasks.append(
@@ -286,6 +294,7 @@ class Dispatcher:
 
             self.handler_worker_tasks.clear()
             self.groups.clear()
+            self.error_handlers.clear()
 
             log.info("Stopped %s HandlerTasks", self.client.workers)
 
@@ -295,11 +304,14 @@ class Dispatcher:
                 await lock.acquire()
 
             try:
-                if group not in self.groups:
+                if isinstance(handler, ErrorHandler):
-                    self.groups[group] = []
+                    if handler not in self.error_handlers:
-                    self.groups = OrderedDict(sorted(self.groups.items()))
+                        self.error_handlers.append(handler)
-
+                else:
-                self.groups[group].append(handler)
+                    if group not in self.groups:
+                        self.groups[group] = []
+                        self.groups = OrderedDict(sorted(self.groups.items()))
+                    self.groups[group].append(handler)
             finally:
                 for lock in self.locks_list:
                     lock.release()
@@ -312,17 +324,23 @@ class Dispatcher:
                 await lock.acquire()
 
             try:
-                if group not in self.groups:
+                if isinstance(handler, ErrorHandler):
-                    raise ValueError(f"Group {group} does not exist. Handler was not removed.")
+                    if handler not in self.error_handlers:
-
+                        raise ValueError(
-                self.groups[group].remove(handler)
+                            f"Error handler {handler} does not exist. Handler was not removed."
+                        )
+                    self.error_handlers.remove(handler)
+                else:
+                    if group not in self.groups:
+                        raise ValueError(f"Group {group} does not exist. Handler was not removed.")
+                    self.groups[group].remove(handler)
             finally:
                 for lock in self.locks_list:
                     lock.release()
 
         self.loop.create_task(fn())
 
-    async def handler_worker(self, lock):
+    async def handler_worker(self, lock: asyncio.Lock):
         while True:
             packet = await self.updates_queue.get()
 
@@ -330,53 +348,91 @@ class Dispatcher:
                 break
 
             try:
-                update, users, chats = packet
+                await self._handle_packet(packet, lock)
-                parser = self.update_parsers.get(type(update), None)
-
-                parsed_update, handler_type = (
-                    await parser(update, users, chats)
-                    if parser is not None
-                    else (None, type(None))
-                )
-
-                async with lock:
-                    for group in self.groups.values():
-                        for handler in group:
-                            args = None
-
-                            if isinstance(handler, handler_type):
-                                try:
-                                    if await handler.check(self.client, parsed_update):
-                                        args = (parsed_update,)
-                                except Exception as e:
-                                    log.exception(e)
-                                    continue
-
-                            elif isinstance(handler, RawUpdateHandler):
-                                args = (update, users, chats)
-
-                            if args is None:
-                                continue
-
-                            try:
-                                if inspect.iscoroutinefunction(handler.callback):
-                                    await handler.callback(self.client, *args)
-                                else:
-                                    await self.loop.run_in_executor(
-                                        self.client.executor,
-                                        handler.callback,
-                                        self.client,
-                                        *args
-                                    )
-                            except pyrogram.StopPropagation:
-                                raise
-                            except pyrogram.ContinuePropagation:
-                                continue
-                            except Exception as e:
-                                log.exception(e)
-
-                            break
             except pyrogram.StopPropagation:
                 pass
             except Exception as e:
                 log.exception(e)
+            finally:
+                self.updates_queue.task_done()
+
+    async def _handle_packet(self, packet, lock: asyncio.Lock):
+        update, users, chats = packet
+        parser = self.update_parsers.get(type(update))
+
+        parsed_update, handler_type = (
+            await parser(update, users, chats)
+            if parser is not None else (None, type(None))
+        )
+        async with lock:
+            await self._dispatch_to_handlers(update, users, chats, parsed_update, handler_type)
+
+
+    async def _dispatch_to_handlers(
+        self, update, users, chats, parsed_update, handler_type,
+    ):
+        for group in self.groups.values():
+            for handler in group:
+                args = await self._match_handler(
+                    handler, update, users, chats, parsed_update, handler_type,
+                )
+                if args is None:
+                    continue
+
+                try:
+                    await self._execute_handler(handler, *args)
+                except pyrogram.StopPropagation:
+                    raise
+                except pyrogram.ContinuePropagation:
+                    continue
+                except Exception as error:
+                    if parsed_update is not None:
+                        await self._handle_exception(parsed_update, error)
+                break
+
+    async def _match_handler(
+        self, handler, update, users, chats, parsed_update, handler_type,
+    ):
+        try:
+            if isinstance(handler, handler_type):
+                if await handler.check(self.client, parsed_update):
+                    return (parsed_update,)
+            elif isinstance(handler, RawUpdateHandler):
+                if await handler.check(self.client, update):
+                    return (update, users, chats)
+        except Exception as e:
+            log.exception(e)
+
+        return None
+
+    async def _execute_handler(self, handler, *args: Any):
+        if inspect.iscoroutinefunction(handler.callback):
+            await handler.callback(self.client, *args)
+        else:
+            await self.loop.run_in_executor(
+                self.client.executor,
+                handler.callback,
+                self.client,
+                *args
+            )
+
+    async def _handle_exception(
+        self, parsed_update: types.Update, exception: Exception,
+    ):
+        handled_error = False
+        for error_handler in self.error_handlers:
+            try:
+                if await error_handler.check(
+                    self.client, parsed_update, exception,
+                ):
+                    handled_error = True
+                    break
+            except pyrogram.StopPropagation:
+                raise
+            except pyrogram.ContinuePropagation:
+                continue
+            except Exception as inner_exception:
+                log.exception("Error in error handler: %s", inner_exception)
+
+        if not handled_error:
+            log.exception("Unhandled exception: %s", exception)

pyrogram/enums/__init__.py

@@ -26,9 +26,12 @@ from .chat_members_filter import ChatMembersFilter
 from .chat_type import ChatType
 from .client_platform import ClientPlatform
 from .folder_color import FolderColor
+from .gift_attribute_type import GiftAttributeType
+from .gift_for_resale_order import GiftForResaleOrder
 from .listerner_types import ListenerTypes
 from .message_entity_type import MessageEntityType
 from .message_media_type import MessageMediaType
+from .message_origin_type import MessageOriginType
 from .message_service_type import MessageServiceType
 from .messages_filter import MessagesFilter
 from .next_code_type import NextCodeType
@@ -52,9 +55,12 @@ __all__ = [
     'ChatType', 
     'ClientPlatform',
     'FolderColor',
+    'GiftAttributeType',
+    'GiftForResaleOrder',
     'ListenerTypes',
     'MessageEntityType', 
     'MessageMediaType', 
+    'MessageOriginType',
     'MessageServiceType', 
     'MessagesFilter', 
     'NextCodeType', 

pyrogram/enums/chat_event_action.py

@@ -35,13 +35,13 @@ class ChatEventAction(AutoName):
     "The linked chat has been changed (see ``old_linked_chat`` and ``new_linked_chat``)"
 
     # LOCATION_CHANGED = auto()
-    ""
+    # ""
 
     PHOTO_CHANGED = auto()
     "The chat photo has been changed (see ``old_photo`` and ``new_photo``)"
 
     # STICKER_SET_CHANGED = auto()
-    ""
+    # ""
 
     TITLE_CHANGED = auto()
     "the chat title has been changed (see ``old_title`` and ``new_title``)"
@@ -56,7 +56,7 @@ class ChatEventAction(AutoName):
     "a message has been deleted (see ``deleted_message``)"
 
     # VOICE_CHAT_DISCARDED = auto()
-    ""
+    # ""
 
     MESSAGE_EDITED = auto()
     "a message has been edited (see ``old_message`` and ``new_message``)"
@@ -77,13 +77,13 @@ class ChatEventAction(AutoName):
     "a member joined by themselves. (see ``user``)"
 
     # MEMBER_JOINED_BY_LINK = auto()
-    ""
+    # ""
 
     MEMBER_LEFT = auto()
     "a member left by themselves. (see ``user``)"
 
     # MEMBER_MUTED = auto()
-    ""
+    # ""
 
     ADMINISTRATOR_PRIVILEGES_CHANGED = auto()
     "a chat member has been promoted/demoted or their administrator privileges has changed (see ``old_administrator_privileges`` and ``new_administrator_privileges``)"
@@ -92,19 +92,19 @@ class ChatEventAction(AutoName):
     "a chat member has been restricted/unrestricted or banned/unbanned, or their permissions has changed (see ``old_member_permissions`` and ``new_member_permissions``)"
 
     # MEMBER_UNMUTED = auto()
-    ""
+    # ""
 
     # MEMBER_VOLUME_CHANGED = auto()
-    ""
+    # ""
 
     # VIDEO_CHAT_STARTED = auto()
-    ""
+    # ""
 
     POLL_STOPPED = auto()
     "a poll has been stopped (see ``stopped_poll``)"
 
     # VOICE_CHAT_SETTINGS_CHANGED = auto()
-    ""
+    # ""
 
     INVITES_ENABLED = auto()
     "the chat invitation has been enabled or disabled (see ``invites_enabled``)"

pyrogram/enums/chat_type.py

@@ -39,3 +39,9 @@ class ChatType(AutoName):
 
     CHANNEL = auto()
     "Chat is a channel"
+
+    FORUM = auto()
+    "Chat is a forum"
+
+    MONOFORUM = auto()
+    "Chat is a monoforum"

pyrogram/enums/gift_attribute_type.py

@@ -0,0 +1,36 @@
+#  Pyrogram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#
+#  This file is part of Pyrogram.
+#
+#  Pyrogram is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Lesser General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  Pyrogram is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Lesser General Public License for more details.
+#
+#  You should have received a copy of the GNU Lesser General Public License
+#  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
+
+from pyrogram import raw
+from .auto_name import AutoName
+
+
+class GiftAttributeType(AutoName):
+    """Star gift attribute type enumeration used in :obj:`~pyrogram.types.GiftAttribute`."""
+
+    MODEL = raw.types.StarGiftAttributeModel
+    "Model attribute"
+
+    SYMBOL = raw.types.StarGiftAttributePattern
+    "Symbol attribute"
+    
+    BACKDROP = raw.types.StarGiftAttributeBackdrop
+    "Backdrop attribute"
+
+    ORIGINAL_DETAILS = raw.types.StarGiftAttributeOriginalDetails
+    "Original details attribute"

pyrogram/enums/gift_for_resale_order.py

@@ -0,0 +1,35 @@
+#  Pyrofork - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#  Copyright (C) 2022-present Mayuri-Chan <https://github.com/Mayuri-Chan>
+#
+#  This file is part of Pyrofork.
+#
+#  Pyrofork is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Lesser General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  Pyrofork is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Lesser General Public License for more details.
+#
+#  You should have received a copy of the GNU Lesser General Public License
+#  along with Pyrofork.  If not, see <http://www.gnu.org/licenses/>.
+
+from enum import auto
+
+from .auto_name import AutoName
+
+
+class GiftForResaleOrder(AutoName):
+    """Describes order in which upgraded gifts for resale will be sorted. Used in :meth:`~pyrogram.Client.search_gifts_for_resale`."""
+
+    PRICE = auto()
+    "The gifts will be sorted by their price from the lowest to the highest"
+
+    CHANGE_DATE = auto()
+    "The gifts will be sorted by the last date when their price was changed from the newest to the oldest"
+
+    NUMBER = auto()
+    "The gifts will be sorted by their number from the smallest to the largest"

pyrogram/enums/message_media_type.py

@@ -84,3 +84,6 @@ class MessageMediaType(AutoName):
 
     PAID_MEDIA = auto()
     "Paid media"
+
+    TODO = auto()
+    "To-Do list media"

pyrogram/enums/message_origin_type.py

@@ -0,0 +1,42 @@
+#  Pyrogram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#  Copyright (C) 2022-present Mayuri-Chan <https://github.com/Mayuri-Chan>
+#
+#  This file is part of Pyrogram.
+#
+#  Pyrogram is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Lesser General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  Pyrogram is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Lesser General Public License for more details.
+#
+#  You should have received a copy of the GNU Lesser General Public License
+#  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
+
+from enum import auto
+
+from .auto_name import AutoName
+
+
+class MessageOriginType(AutoName):
+    """Message origin type enumeration used in :obj:`~pyrogram.types.MessageOrigin`."""
+
+    CHANNEL = auto()
+    "The message was originally a post in a channel"
+
+    CHAT = auto()
+    "The message was originally sent on behalf of a chat"
+
+    HIDDEN_USER = auto()
+    "The message was originally sent by a user, which is hidden by their privacy settings"
+
+    IMPORT = auto()
+    "The message was imported from a foreign chat service"
+
+
+    USER = auto()
+    "The message was originally sent by a known user"

pyrogram/enums/message_service_type.py

@@ -58,7 +58,7 @@ class MessageServiceType(AutoName):
     GAME_HIGH_SCORE = auto()
     "Game high score"
 
-    ChatShared = auto()
+    CHAT_SHARED = auto()
     "a shared chat/channel/user"
 
     FORUM_TOPIC_CREATED = auto()
@@ -127,11 +127,17 @@ class MessageServiceType(AutoName):
     GIFT_CODE = auto()
     "Gift code"
 
-    USER_GIFT = auto()
+    GIFT = auto()
-    "Star gift"
-
-    STAR_GIFT = auto()
     "Star gift"
 
     SCREENSHOT_TAKEN = auto()
     "Screenshot taken"
+
+    PAID_MESSAGE_PRICE_CHANGED = auto()
+    "Paid message price changed"
+
+    TODO_TASKS_ADDED = auto()
+    "To-Do tasks added"
+
+    TODO_TASKS_COMPLETION = auto()
+    "To-Do tasks completion/incompletion"

pyrogram/errors/__init__.py

@@ -17,9 +17,15 @@
 #  You should have received a copy of the GNU Lesser General Public License
 #  along with Pyrofork.  If not, see <http://www.gnu.org/licenses/>.
 
-from .exceptions import *
+EXCEPTION_AVAIL = False
+try:
+    from .exceptions import *
+except ImportError:
+    pass
+else:
+    EXCEPTION_AVAIL = True
 from .pyromod import *
-from .rpc_error import UnknownError
+from .rpc_error import RPCError, UnknownError
 
 
 class BadMsgNotification(Exception):
@@ -65,3 +71,15 @@ class CDNFileHashMismatch(SecurityError):
 
     def __init__(self, msg: str = None):
         super().__init__("A CDN file hash mismatch has occurred." if msg is None else msg)
+
+__all__ = [
+    "BadMsgNotification",
+    "SecurityError",
+    "SecurityCheckMismatch",
+    "CDNFileHashMismatch",
+    "RPCError",
+    "UnknownError"
+]
+if EXCEPTION_AVAIL:
+    __all__.extend(exceptions.__all__)
+__all__.extend(pyromod.__all__)

pyrogram/filters.py

@@ -1,3 +1,4 @@
+
 #  Pyrofork - Telegram MTProto API Client Library for Python
 #  Copyright (C) 2017-present Dan <https://github.com/delivrance>
 #  Copyright (C) 2022-present Mayuri-Chan <https://github.com/Mayuri-Chan>
@@ -250,7 +251,7 @@ react = create(reaction_filter)
 
 # region forwarded_filter
 async def forwarded_filter(_, __, m: Message):
-    return bool(m.forward_date)
+    return bool(m.forward_origin)
 
 
 forwarded = create(forwarded_filter)
@@ -358,11 +359,11 @@ gift_code = create(gift_code_filter)
 """Filter messages that contain :obj:`~pyrogram.types.GiftCode` objects."""
 # endregion
 
-# region user_gift
+# region star_gift_filter
-async def user_gift_filter(_, __, m: Message):
+async def star_gift_filter(_, __, m: Message):
-    return bool(m.user_gift)
+    return bool(m.gift)
-user_gift = create(user_gift_filter)
+star_gift = create(star_gift_filter)
-"""Filter messages that contain :obj:`~pyrogram.types.UserGift` objects."""
+"""Filter messages that contain :obj:`~pyrogram.types.Gift` objects."""
 # endregion
 
 # region video_filter
@@ -795,7 +796,7 @@ from_scheduled = create(from_scheduled_filter)
 
 # region linked_channel_filter
 async def linked_channel_filter(_, __, m: Message):
-    return bool(m.forward_from_chat and not m.from_user)
+    return bool((m.forward_origin and m.forward_origin.chat) and not m.from_user)
 
 
 linked_channel = create(linked_channel_filter)
@@ -889,7 +890,12 @@ def command(commands: Union[str, List[str]], prefixes: Union[str, List[str]] = "
     command_re = re.compile(r"([\"'])(.*?)(?<!\\)\1|(\S+)")
 
     async def func(flt, client: pyrogram.Client, message: Message):
+        usernames = []
         username = client.me.username or ""
+        if client.me.usernames:
+            usernames.append(username)
+            for user in client.me.usernames:
+                usernames.append(user.username)
         text = message.text or message.caption
         message.command = None
 
@@ -903,6 +909,24 @@ def command(commands: Union[str, List[str]], prefixes: Union[str, List[str]] = "
             without_prefix = text[len(prefix):]
 
             for cmd in flt.commands:
+                if usernames:
+                    for username in usernames:
+                        if not re.match(rf"^(?:{cmd}(?:@?{username})?)(?:\s|$)", without_prefix,
+                                        flags=re.IGNORECASE if not flt.case_sensitive else 0):
+                            continue
+
+                        without_command = re.sub(rf"{cmd}(?:@?{username})?\s?", "", without_prefix, count=1,
+                                                flags=re.IGNORECASE if not flt.case_sensitive else 0)
+
+                        # match.groups are 1-indexed, group(1) is the quote, group(2) is the text
+                        # between the quotes, group(3) is unquoted, whitespace-split text
+
+                        # Remove the escape character from the arguments
+                        message.command = [cmd] + [
+                            re.sub(r"\\([\"'])", r"\1", m.group(2) or m.group(3) or "")
+                            for m in command_re.finditer(without_command)
+                        ]
+                        return True
                 if not re.match(rf"^(?:{cmd}(?:@?{username})?)(?:\s|$)", without_prefix,
                                 flags=re.IGNORECASE if not flt.case_sensitive else 0):
                     continue
@@ -1010,12 +1034,22 @@ class user(Filter, set):
         )
 
     async def __call__(self, _, message: Message):
+        is_usernames_in_filters = False
+        if message.from_user and message.from_user.usernames:
+            for username in message.from_user.usernames:
+                if (
+                    username.username in self
+                    or username.username.lower() in self
+                ):
+                    is_usernames_in_filters = True
+                    break
         return (message.from_user
                 and (message.from_user.id in self
                      or (message.from_user.username
                          and message.from_user.username.lower() in self)
                      or ("me" in self
-                         and message.from_user.is_self)))
+                         and message.from_user.is_self))
+                    or is_usernames_in_filters)
 
 
 # noinspection PyPep8Naming
@@ -1043,6 +1077,15 @@ class chat(Filter, set):
 
     async def __call__(self, _, message: Union[Message, Story]):
         if isinstance(message, Story):
+            is_usernames_in_filters = False
+            if message.sender_chat and message.sender_chat.usernames:
+                for username in message.sender_chat.usernames:
+                    if (
+                        username.username in self
+                        or username.username.lower() in self
+                    ):
+                        is_usernames_in_filters = True
+                        break
             return (
                     message.sender_chat
                     and (
@@ -1061,8 +1104,17 @@ class chat(Filter, set):
                             and message.from_user.username.lower() in self
                         )
                     )
-                )
+                ) or is_usernames_in_filters
         else:
+            is_usernames_in_filters = False
+            if message.chat and message.chat.usernames:
+                for username in message.chat.usernames:
+                    if (
+                        username.username in self
+                        or username.username.lower() in self
+                    ):
+                        is_usernames_in_filters = True
+                        break
             return (message.chat
                     and (message.chat.id in self
                          or (message.chat.username
@@ -1070,7 +1122,10 @@ class chat(Filter, set):
                          or ("me" in self
                              and message.from_user
                              and message.from_user.is_self
-                             and not message.outgoing)))
+                             and not message.outgoing))
+                         or (is_usernames_in_filters
+                            and not message.outgoing)
+            )
 
 
 # noinspection PyPep8Naming
@@ -1081,6 +1136,7 @@ class topic(Filter, set):
     Parameters:
         topics (``int`` | ``list``):
             Pass one or more topic ids to filter messages in specific topics.
+            Pass 1 for general topic.
             Defaults to None (no topics).
     """
 
@@ -1092,4 +1148,6 @@ class topic(Filter, set):
         )
 
     async def __call__(self, _, message: Message):
+        if message.is_topic_message and not message.topic:
+            return 1 in self
         return message.topic and message.topic.id in self

pyrogram/handlers/__init__.py

@@ -29,10 +29,10 @@ from .deleted_bot_business_messages_handler import DeletedBotBusinessMessagesHan
 from .disconnect_handler import DisconnectHandler
 from .edited_message_handler import EditedMessageHandler
 from .edited_bot_business_message_handler import EditedBotBusinessMessageHandler
+from .error_handler import ErrorHandler
 from .inline_query_handler import InlineQueryHandler
 from .message_handler import MessageHandler
 from .poll_handler import PollHandler
-from .pre_checkout_query_handler import PreCheckoutQueryHandler
 from .purchased_paid_media_handler import PurchasedPaidMediaHandler
 from .raw_update_handler import RawUpdateHandler
 from .user_status_handler import UserStatusHandler
@@ -41,3 +41,31 @@ from .message_reaction_updated_handler import MessageReactionUpdatedHandler
 from .message_reaction_count_updated_handler import MessageReactionCountUpdatedHandler
 from .pre_checkout_query_handler import PreCheckoutQueryHandler
 from .shipping_query_handler import ShippingQueryHandler
+
+__all__ = [
+    "BotBusinessConnectHandler",
+    "BotBusinessMessageHandler",
+    "CallbackQueryHandler",
+    "ChatJoinRequestHandler",
+    "ChatMemberUpdatedHandler",
+    "ConversationHandler",
+    "ChosenInlineResultHandler",
+    "DeletedMessagesHandler",
+    "DeletedBotBusinessMessagesHandler",
+    "DisconnectHandler",
+    "EditedMessageHandler",
+    "EditedBotBusinessMessageHandler",
+    "ErrorHandler",
+    "InlineQueryHandler",
+    "MessageHandler",
+    "PollHandler",
+    "PreCheckoutQueryHandler",
+    "PurchasedPaidMediaHandler",
+    "RawUpdateHandler",
+    "UserStatusHandler",
+    "StoryHandler",
+    "MessageReactionUpdatedHandler",
+    "MessageReactionCountUpdatedHandler",
+    "PreCheckoutQueryHandler",
+    "ShippingQueryHandler",
+]

pyrogram/handlers/conversation_handler.py

@@ -61,6 +61,7 @@ class ConversationHandler(MessageHandler, CallbackQueryHandler):
         return True
 
     @staticmethod
+    # pylint: disable=method-hidden
     async def callback(_, __):
         pass
 

pyrogram/handlers/deleted_bot_business_messages_handler.py

@@ -58,5 +58,4 @@ class DeletedBotBusinessMessagesHandler(Handler):
         for message in messages:
             if await super().check(client, message):
                 return True
-        else:
+        return False
-            return False

pyrogram/handlers/deleted_messages_handler.py

@@ -58,5 +58,4 @@ class DeletedMessagesHandler(Handler):
         for message in messages:
             if await super().check(client, message):
                 return True
-        else:
+        return False
-            return False

pyrogram/handlers/error_handler.py

@@ -0,0 +1,79 @@
+#  Pyrofork - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#  Copyright (C) 2022-present Mayuri-Chan <https://github.com/Mayuri-Chan>
+#
+#  This file is part of Pyrofork.
+#
+#  Pyrofork is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Lesser General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  Pyrofork is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Lesser General Public License for more details.
+#
+#  You should have received a copy of the GNU Lesser General Public License
+#  along with Pyrofork.  If not, see <http://www.gnu.org/licenses/>.
+
+from __future__ import annotations
+
+from collections.abc import Iterable
+from typing import Callable
+
+from .handler import Handler
+
+import pyrogram
+from pyrogram.types import Update
+
+
+class ErrorHandler(Handler):
+    """The Error handler class. Used to handle errors.
+    It is intended to be used with :meth:`~pyrogram.Client.add_handler`
+
+    For a nicer way to register this handler, have a look at the
+    :meth:`~pyrogram.Client.on_error` decorator.
+
+    Parameters:
+        callback (``Callable``):
+            Pass a function that will be called when a new Error arrives. It takes *(client, error)*
+            as positional arguments (look at the section below for a detailed description).
+
+        exceptions (``Exception`` | Iterable of ``Exception``, *optional*):
+            Pass one or more exception classes to allow only a subset of errors to be passed
+            in your callback function.
+
+    Other parameters:
+        client (:obj:`~pyrogram.Client`):
+            The Client itself, useful when you want to call other API methods inside the error handler.
+
+        update (:obj:`~pyrogram.Update`):
+            The update that caused the error.
+
+        error (``Exception``):
+            The error that was raised.
+    """
+
+    def __init__(
+        self,
+        callback: Callable,
+        exceptions: type[Exception] | Iterable[type[Exception]] | None = None,
+    ):
+        self.exceptions = (
+            tuple(exceptions)
+            if isinstance(exceptions, Iterable)
+            else (exceptions,)
+            if exceptions
+            else (Exception,)
+        )
+        super().__init__(callback)
+
+    async def check(self, client: pyrogram.Client, update: Update, exception: Exception) -> bool:
+        if isinstance(exception, self.exceptions):
+            await self.callback(client, update, exception)
+            return True
+        return False
+
+    def check_remove(self, error: type[Exception] | Iterable[type[Exception]]) -> bool:
+        return isinstance(error, self.exceptions)

pyrogram/handlers/raw_update_handler.py

@@ -35,6 +35,10 @@ class RawUpdateHandler(Handler):
             *(client, update, users, chats)* as positional arguments (look at the section below for
             a detailed description).
 
+        filters (:obj:`Filters`):
+            Pass one or more filters to allow only a subset of callback queries to be passed
+            in your callback function.
+
     Other Parameters:
         client (:obj:`~pyrogram.Client`):
             The Client itself, useful when you want to call other API methods inside the update handler.
@@ -64,5 +68,5 @@ class RawUpdateHandler(Handler):
         - :obj:`~pyrogram.raw.types.ChannelForbidden`
     """
 
-    def __init__(self, callback: Callable):
+    def __init__(self, callback: Callable, filters=None):
-        super().__init__(callback)
+        super().__init__(callback, filters)

pyrogram/helpers/__init__.py

@@ -13,4 +13,15 @@ GNU General Public License for more details.
 You should have received a copy of the GNU General Public License
 along with pyromod.  If not, see <https://www.gnu.org/licenses/>.
 """
-from .helpers import ikb, bki, ntb, btn, kb, kbtn, array_chunk, force_reply
+from .helpers import ikb, bki, ntb, btn, kb, kbtn, array_chunk, force_reply
+
+__all__ = [
+    "ikb",
+    "bki",
+    "ntb",
+    "btn",
+    "kb",
+    "kbtn",
+    "array_chunk",
+    "force_reply"
+]

pyrogram/helpers/helpers.py

@@ -101,9 +101,9 @@ def kb(rows=None, **kwargs):
         line = []
         for button in row:
             button_type = type(button)
-            if button_type == str:
+            if isinstance(button_type, str):
                 button = KeyboardButton(button)
-            elif button_type == dict:
+            elif isinstance(button_type, dict):
                 button = KeyboardButton(**button)
 
             line.append(button)

pyrogram/methods/__init__.py

@@ -23,12 +23,14 @@ from .bots import Bots
 from .chats import Chats
 from .contacts import Contacts
 from .decorators import Decorators
+from .forums import Forums
 from .invite_links import InviteLinks
 from .messages import Messages
 from .password import Password
 from .pyromod import Pyromod
 from .stickers import Stickers
 from .payments import Payments
+from .phone import Phone
 from .users import Users
 from .utilities import Utilities
 from .business import TelegramBusiness
@@ -42,7 +44,9 @@ class Methods(
     Password,
     Pyromod,
     Payments,
+    Phone,
     Chats,
+    Forums,
     Stickers,
     Users,
     Messages,

pyrogram/methods/advanced/save_file.py

@@ -23,7 +23,6 @@ import inspect
 import io
 import logging
 import math
-import os
 from hashlib import md5
 from pathlib import PurePath
 from typing import Union, BinaryIO, Callable

pyrogram/methods/auth/__init__.py

@@ -17,7 +17,6 @@
 #  You should have received a copy of the GNU Lesser General Public License
 #  along with Pyrofork.  If not, see <http://www.gnu.org/licenses/>.
 
-from .accept_terms_of_service import AcceptTermsOfService
 from .check_password import CheckPassword
 from .connect import Connect
 from .disconnect import Disconnect
@@ -31,12 +30,11 @@ from .send_code import SendCode
 from .send_recovery_code import SendRecoveryCode
 from .sign_in import SignIn
 from .sign_in_bot import SignInBot
-from .sign_up import SignUp
+from .sign_in_qrcode import SignInQrcode
 from .terminate import Terminate
 
 
 class Auth(
-    AcceptTermsOfService,
     CheckPassword,
     Connect,
     Disconnect,
@@ -50,7 +48,7 @@ class Auth(
     SendRecoveryCode,
     SignIn,
     SignInBot,
-    SignUp,
+    SignInQrcode,
     Terminate
 ):
     pass

pyrogram/methods/auth/connect.py

@@ -35,6 +35,7 @@ class Connect:
         Raises:
             ConnectionError: In case you try to connect an already connected client.
         """
+        # pylint: disable=access-member-before-definition
         if self.is_connected:
             raise ConnectionError("Client is already connected")
 

pyrogram/methods/auth/disconnect.py

@@ -30,6 +30,7 @@ class Disconnect:
             ConnectionError: In case you try to disconnect an already disconnected client or in case you try to
                 disconnect a client that needs to be terminated first.
         """
+        # pylint: disable=access-member-before-definition
         if not self.is_connected:
             raise ConnectionError("Client is already disconnected")
 

pyrogram/methods/auth/get_active_sessions.py

@@ -16,8 +16,6 @@
 #  You should have received a copy of the GNU Lesser General Public License
 #  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
 
-from typing import List
-
 import pyrogram
 from pyrogram import raw, types
 

pyrogram/methods/auth/initialize.py

@@ -41,6 +41,7 @@ class Initialize:
         if not self.is_connected:
             raise ConnectionError("Can't initialize a disconnected client")
 
+        # pylint: disable=access-member-before-definition
         if self.is_initialized:
             raise ConnectionError("Client is already initialized")
 

pyrogram/methods/auth/send_code.py

@@ -61,6 +61,7 @@ class SendCode:
                     )
                 )
             except (PhoneMigrate, NetworkMigrate) as e:
+                # pylint: disable=access-member-before-definition
                 await self.session.stop()
 
                 await self.storage.dc_id(e.value)

pyrogram/methods/auth/sign_in.py

@@ -23,6 +23,7 @@ from typing import Union
 import pyrogram
 from pyrogram import raw
 from pyrogram import types
+from pyrogram.errors import PhoneNumberUnoccupied
 
 log = logging.getLogger(__name__)
 
@@ -49,15 +50,13 @@ class SignIn:
                 The valid confirmation code you received (either as Telegram message or as SMS in your phone number).
 
         Returns:
-            :obj:`~pyrogram.types.User` | :obj:`~pyrogram.types.TermsOfService` | bool: On success, in case the
+            :obj:`~pyrogram.types.User` | bool: On success, in case the
-            authorization completed, the user is returned. In case the phone number needs to be registered first AND the
+            authorization completed, the user is returned.
-            terms of services accepted (with :meth:`~pyrogram.Client.accept_terms_of_service`), an object containing
-            them is returned. In case the phone number needs to be registered, but the terms of services don't need to
-            be accepted, False is returned instead.
 
         Raises:
             BadRequest: In case the arguments are invalid.
             SessionPasswordNeeded: In case a password is needed to sign in.
+            PhoneNumberUnoccupied: In case the phone number is not registered on Telegram.
         """
         phone_number = phone_number.strip(" +")
 
@@ -70,10 +69,7 @@ class SignIn:
         )
 
         if isinstance(r, raw.types.auth.AuthorizationSignUpRequired):
-            if r.terms_of_service:
+            raise PhoneNumberUnoccupied("The phone number is not registered on Telegram. Please use official Telegram app to register it.")
-                return types.TermsOfService._parse(terms_of_service=r.terms_of_service)
-
-            return False
         else:
             await self.storage.user_id(r.user.id)
             await self.storage.is_bot(False)

pyrogram/methods/auth/sign_in_bot.py

@@ -58,6 +58,7 @@ class SignInBot:
                     )
                 )
             except UserMigrate as e:
+                # pylint: disable=access-member-before-definition
                 await self.session.stop()
 
                 await self.storage.dc_id(e.value)

pyrogram/methods/auth/sign_in_qrcode.py

@@ -0,0 +1,111 @@
+#  Pyrofork - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#  Copyright (C) 2022-present Mayuri-Chan <https://github.com/Mayuri-Chan>
+#
+#  This file is part of Pyrofork.
+#
+#  Pyrofork is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Lesser General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  Pyrofork is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Lesser General Public License for more details.
+#
+#  You should have received a copy of the GNU Lesser General Public License
+#  along with Pyrofork.  If not, see <http://www.gnu.org/licenses/>.
+
+import logging
+from base64 import b64encode
+from typing import Union
+
+import pyrogram
+from pyrogram import raw
+from pyrogram import types
+from pyrogram.session import Session, Auth
+
+log = logging.getLogger(__name__)
+
+class SignInQrcode:
+    async def sign_in_qrcode(
+        self: "pyrogram.Client"
+    ) -> Union["types.User", "types.LoginToken"]:
+        """Authorize a user in Telegram with a QR code.
+
+        .. include:: /_includes/usable-by/users.rst
+
+        Returns:
+            :obj:`~pyrogram.types.User` | :obj:`pyrogram.types.LoginToken`, in case the
+            authorization completed, the user is returned. In case the QR code is
+            not scanned, a login token is returned.
+
+        Raises:
+            ImportError: In case the qrcode library is not installed.
+            SessionPasswordNeeded: In case a password is needed to sign in.
+        """
+
+        try:
+            import qrcode
+        except ImportError:
+            raise ImportError("qrcode is missing! "
+                            "Please install it with `pip install qrcode`")
+        r = await self.session.invoke(
+            raw.functions.auth.ExportLoginToken(
+                api_id=self.api_id,
+                api_hash=self.api_hash,
+                except_ids=[]
+            )
+        )
+        if isinstance(r, raw.types.auth.LoginToken):
+            base64_token = b64encode(r.token).decode("utf-8")
+            login_url = f"tg://login?token={base64_token}"
+            qr = qrcode.QRCode(
+                version=1,
+                error_correction=qrcode.constants.ERROR_CORRECT_L,
+                box_size=10,
+                border=4,
+            )
+            qr.add_data(login_url)
+            qr.make(fit=True)
+
+            print("Scan the QR code with your Telegram app.")
+            qr.print_ascii()
+
+            return types.LoginToken._parse(r)
+        if isinstance(r, raw.types.auth.LoginTokenSuccess):
+            await self.storage.user_id(r.authorization.user.id)
+            await self.storage.is_bot(False)
+
+            return types.User._parse(self, r.authorization.user)
+        if isinstance(r, raw.types.auth.LoginTokenMigrateTo):
+            # pylint: disable=access-member-before-definition
+            await self.session.stop()
+
+            await self.storage.dc_id(r.dc_id)
+            await self.storage.auth_key(
+                await Auth(
+                    self, await self.storage.dc_id(),
+                    await self.storage.test_mode()
+                ).create()
+            )
+            self.session = Session(
+                self, await self.storage.dc_id(),
+                await self.storage.auth_key(), await self.storage.test_mode()
+            )
+
+            await self.session.start()
+            r = await self.session.invoke(
+                raw.functions.auth.ImportLoginToken(
+                    token=r.token
+                )
+            )
+            if isinstance(r, raw.types.auth.LoginTokenSuccess):
+                await self.storage.user_id(r.authorization.user.id)
+                await self.storage.is_bot(False)
+
+                return types.User._parse(self, r.authorization.user)
+        raise pyrogram.exceptions.RPCError(
+            "Unknown response type from Telegram API"
+        )

pyrogram/methods/auth/sign_up.py

@@ -1,74 +0,0 @@
-#  Pyrofork - Telegram MTProto API Client Library for Python
-#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
-#  Copyright (C) 2022-present Mayuri-Chan <https://github.com/Mayuri-Chan>
-#
-#  This file is part of Pyrofork.
-#
-#  Pyrofork is free software: you can redistribute it and/or modify
-#  it under the terms of the GNU Lesser General Public License as published
-#  by the Free Software Foundation, either version 3 of the License, or
-#  (at your option) any later version.
-#
-#  Pyrofork is distributed in the hope that it will be useful,
-#  but WITHOUT ANY WARRANTY; without even the implied warranty of
-#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-#  GNU Lesser General Public License for more details.
-#
-#  You should have received a copy of the GNU Lesser General Public License
-#  along with Pyrofork.  If not, see <http://www.gnu.org/licenses/>.
-
-import logging
-
-import pyrogram
-from pyrogram import raw
-from pyrogram import types
-
-log = logging.getLogger(__name__)
-
-
-class SignUp:
-    async def sign_up(
-        self: "pyrogram.Client",
-        phone_number: str,
-        phone_code_hash: str,
-        first_name: str,
-        last_name: str = ""
-    ) -> "types.User":
-        """Register a new user in Telegram.
-
-        .. include:: /_includes/usable-by/users.rst
-
-        Parameters:
-            phone_number (``str``):
-                Phone number in international format (includes the country prefix).
-
-            phone_code_hash (``str``):
-                Code identifier taken from the result of :meth:`~pyrogram.Client.send_code`.
-
-            first_name (``str``):
-                New user first name.
-
-            last_name (``str``, *optional*):
-                New user last name. Defaults to "" (empty string, no last name).
-
-        Returns:
-            :obj:`~pyrogram.types.User`: On success, the new registered user is returned.
-
-        Raises:
-            BadRequest: In case the arguments are invalid.
-        """
-        phone_number = phone_number.strip(" +")
-
-        r = await self.invoke(
-            raw.functions.auth.SignUp(
-                phone_number=phone_number,
-                first_name=first_name,
-                last_name=last_name,
-                phone_code_hash=phone_code_hash
-            )
-        )
-
-        await self.storage.user_id(r.user.id)
-        await self.storage.is_bot(False)
-
-        return types.User._parse(self, r.user)

pyrogram/methods/auth/terminate.py

@@ -37,6 +37,7 @@ class Terminate:
         Raises:
             ConnectionError: In case you try to terminate a client that is already terminated.
         """
+        # pylint: disable=access-member-before-definition
         if not self.is_initialized:
             raise ConnectionError("Client is already terminated")
 

pyrogram/methods/bots/__init__.py

@@ -36,6 +36,8 @@ from .set_bot_default_privileges import SetBotDefaultPrivileges
 from .set_bot_info import SetBotInfo
 from .set_chat_menu_button import SetChatMenuButton
 from .set_game_score import SetGameScore
+from .get_owned_bots import GetOwnedBots
+from .get_similar_bots import GetSimilarBots
 
 
 class Bots(
@@ -57,6 +59,8 @@ class Bots(
     SetChatMenuButton,
     GetChatMenuButton,
     AnswerWebAppQuery,
-    GetCollectibleItemInfo
+    GetCollectibleItemInfo,
+    GetOwnedBots,
+    GetSimilarBots,
 ):
     pass

pyrogram/methods/bots/get_collectible_item_info.py

@@ -28,17 +28,24 @@ class GetCollectibleItemInfo:
         phone_number: str = None
     ) -> "types.CollectibleInfo":
         """Returns information about a given collectible item that was purchased at https://fragment.com
+
         .. include:: /_includes/usable-by/users.rst
+
         You must use exactly one of ``username`` OR ``phone_number``.
+
         Parameters:
             username (``str``, *optional*):
                 Describes a collectible username that can be purchased at https://fragment.com
+
             phone_number (``str``, *optional*):
                 Describes a collectible phone number that can be purchased at https://fragment.com
+
         Returns:
             :obj:`~pyrogram.types.CollectibleInfo`: On success, a collectible info is returned.
+
         Example:
             .. code-block:: python
+
                 username = await app.get_collectible_item_info(username="nerd")
                 print(username)
         """

pyrogram/methods/bots/get_owned_bots.py

@@ -1,44 +1,46 @@
-#  Pyrogram - Telegram MTProto API Client Library for Python
+#  Pyrogram - Telegram MTProto API Client Library for Python
-#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
-#
+#
-#  This file is part of Pyrogram.
+#  This file is part of Pyrogram.
-#
+#
-#  Pyrogram is free software: you can redistribute it and/or modify
+#  Pyrogram is free software: you can redistribute it and/or modify
-#  it under the terms of the GNU Lesser General Public License as published
+#  it under the terms of the GNU Lesser General Public License as published
-#  by the Free Software Foundation, either version 3 of the License, or
+#  by the Free Software Foundation, either version 3 of the License, or
-#  (at your option) any later version.
+#  (at your option) any later version.
-#
+#
-#  Pyrogram is distributed in the hope that it will be useful,
+#  Pyrogram is distributed in the hope that it will be useful,
-#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
-#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-#  GNU Lesser General Public License for more details.
+#  GNU Lesser General Public License for more details.
-#
+#
-#  You should have received a copy of the GNU Lesser General Public License
+#  You should have received a copy of the GNU Lesser General Public License
-#  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
+#  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
-from typing import List
+
-
+
-import pyrogram
+from typing import List
-from pyrogram import raw, types
+import pyrogram
-
+from pyrogram import raw, types
-
+
-class GetAvailableGifts:
+
-    async def get_available_gifts(
+class GetOwnedBots:
-        self: "pyrogram.Client",
+    async def get_owned_bots(
-    ) -> List["types.Gift"]:
+        self: "pyrogram.Client",
-        """Get all gifts that can be sent to other users.
+    ) -> List["types.User"]:
-
+        """Returns the list of bots owned by the current user.
-        .. include:: /_includes/usable-by/users.rst
+
-
+        .. include:: /_includes/usable-by/users.rst
-        Returns:
+
-            List of :obj:`~pyrogram.types.Gift`: On success, a list of star gifts is returned.
+        Returns:
-
+            List of :obj:`~pyrogram.types.User`: On success.
-        Example:
+
-            .. code-block:: python
+        Example:
-
+            .. code-block:: python
-                app.get_available_gifts()
+
-        """
+                bots = await app.get_owned_bots()
-        r = await self.invoke(
+        """
-            raw.functions.payments.GetStarGifts(hash=0)
+
-        )
+        bots = await self.invoke(raw.functions.bots.GetAdminedBots())
-
+        return types.List([
-        return types.List([await types.Gift._parse(self, gift) for gift in r.gifts])
+            types.User._parse(self, b)
+            for b in bots
+        ])

pyrogram/methods/bots/get_similar_bots.py

@@ -0,0 +1,46 @@
+#  Pyrofork - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2022-present Mayuri-Chan <https://github.com/Mayuri-Chan>
+#
+#  This file is part of Pyrofork.
+#
+#  Pyrofork is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Lesser General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  Pyrofork is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Lesser General Public License for more details.
+#
+#  You should have received a copy of the GNU Lesser General Public License
+#  along with Pyrofork.  If not, see <http://www.gnu.org/licenses/>.
+
+from typing import List, Union
+
+import pyrogram
+from pyrogram import raw
+
+
+class GetSimilarBots:
+    async def get_similar_bots(
+        self: "pyrogram.Client",
+        bot: Union[int, str]
+    ) -> List["pyrogram.types.User"]:
+        """Get a list of bots similar to the target bot.
+
+        .. include:: /_includes/usable-by/users.rst
+
+        Parameters:
+            bot (``int`` | ``str``):
+                Unique identifier (int) or username (str) of the target bot.
+
+        Returns:
+            List of :obj:`~pyrogram.types.User`: On success.
+        """
+        peer = await self.resolve_peer(bot)
+        r = await self.invoke(raw.functions.bots.GetBotRecommendations(bot=peer))
+        return pyrogram.types.List([
+            pyrogram.types.User._parse(self, u)
+            for u in r.users
+        ])

pyrogram/methods/bots/send_inline_bot_result.py

@@ -17,10 +17,11 @@
 #  You should have received a copy of the GNU Lesser General Public License
 #  along with Pyrofork.  If not, see <http://www.gnu.org/licenses/>.
 
-from typing import List, Union, Optional
+from datetime import datetime
+from typing import Union, List, Optional
 
 import pyrogram
-from pyrogram import enums, raw, types, utils
+from pyrogram import raw, enums, types, utils
 
 
 class SendInlineBotResult:
@@ -29,12 +30,16 @@ class SendInlineBotResult:
         chat_id: Union[int, str],
         query_id: int,
         result_id: str,
-        disable_notification: bool = None,
+        disable_notification: Optional[bool] = None,
-        message_thread_id: int = None,
+        message_thread_id: Optional[int] = None,
-        reply_to_message_id: int = None,
+        reply_to_message_id: Optional[int] = None,
-        quote_text: str = None,
+        reply_to_chat_id: Union[int, str] = None,
-        quote_entities: List["types.MessageEntity"] = None,
+        reply_to_story_id: Optional[int] = None,
-        parse_mode: Optional["enums.ParseMode"] = None
+        quote_text: Optional[str] = None,
+        parse_mode: Optional["enums.ParseMode"] = None,
+        quote_entities: Optional[List["types.MessageEntity"]] = None,
+        quote_offset: Optional[int] = None,
+        schedule_date: datetime = None,
     ) -> "types.Message":
         """Send an inline bot result.
         Bot results can be retrieved using :meth:`~pyrogram.Client.get_inline_bot_results`
@@ -60,43 +65,54 @@ class SendInlineBotResult:
 
             message_thread_id (``int``, *optional*):
                 Unique identifier of a message thread to which the message belongs.
-                for supergroups only
+                For supergroups only.
 
             reply_to_message_id (``bool``, *optional*):
                 If the message is a reply, ID of the original message.
 
-            quote_text (``str``, *optional*):
+            reply_to_chat_id (``int``, *optional*):
-                Text to quote.
+                If the message is a reply, ID of the original chat.
-                for reply_to_message only.
 
-            quote_entities (List of :obj:`~pyrogram.types.MessageEntity`, *optional*):
+            reply_to_story_id (``int``, *optional*):
-                List of special entities that appear in quote_text, which can be specified instead of *parse_mode*.
+                If the message is a reply, ID of the target story.
-                for reply_to_message only.
+
+            quote_text (``str``, *optional*):
+                Text of the quote to be sent.
 
             parse_mode (:obj:`~pyrogram.enums.ParseMode`, *optional*):
-                By default, quote_text are parsed using both Markdown and HTML styles.
+                By default, texts are parsed using both Markdown and HTML styles.
                 You can combine both syntaxes together.
-                For quote_text.
+
+            quote_entities (List of :obj:`~pyrogram.types.MessageEntity`, *optional*):
+                List of special entities that appear in quote text, which can be specified instead of *parse_mode*.
+
+            quote_offset (``int``, *optional*):
+                Offset for quote in original message.
+
+            schedule_date (:py:obj:`~datetime.datetime`, *optional*):
+                Date when the message will be automatically sent.
 
         Returns:
-            :obj:`~pyrogram.types.Message`: On success, the sent message is returned.
+            :obj:`~pyrogram.types.Message`: On success, the sent message is returned or False if no message was sent.
 
         Example:
             .. code-block:: python
 
                 await app.send_inline_bot_result(chat_id, query_id, result_id)
         """
-    
+        quote_text, quote_entities = (await utils.parse_text_entities(self, quote_text, parse_mode, quote_entities)).values()
+
         reply_to = await utils.get_reply_to(
             client=self,
-            chat_id=chat_id,
             reply_to_message_id=reply_to_message_id,
+            reply_to_chat_id=reply_to_chat_id,
+            reply_to_story_id=reply_to_story_id,
             message_thread_id=message_thread_id,
             quote_text=quote_text,
             quote_entities=quote_entities,
-            parse_mode=parse_mode
+            quote_offset=quote_offset,
+            parse_mode=parse_mode,
         )
-
         r = await self.invoke(
             raw.functions.messages.SendInlineBotResult(
                 peer=await self.resolve_peer(chat_id),
@@ -104,15 +120,19 @@ class SendInlineBotResult:
                 id=result_id,
                 random_id=self.rnd_id(),
                 silent=disable_notification or None,
-                reply_to=reply_to
+                reply_to=reply_to,
+                schedule_date=utils.datetime_to_timestamp(schedule_date),
             )
         )
 
         for i in r.updates:
             if isinstance(i, (raw.types.UpdateNewMessage,
-                              raw.types.UpdateNewChannelMessage)):
+                              raw.types.UpdateNewChannelMessage,
+                              raw.types.UpdateNewScheduledMessage)):
                 return await types.Message._parse(
                     self, i.message,
                     {i.id: i for i in r.users},
                     {i.id: i for i in r.chats},
-                )
+                    is_scheduled=isinstance(i, raw.types.UpdateNewScheduledMessage),
+                    business_connection_id=getattr(i, "connection_id", None)
+                )

pyrogram/methods/business/__init__.py

@@ -1,5 +1,6 @@
 #  Pyrogram - Telegram MTProto API Client Library for Python
 #  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#  Copyright (C) 2022-present Mayuri-Chan <https://github.com/Mayuri-Chan>
 #
 #  This file is part of Pyrogram.
 #
@@ -17,21 +18,21 @@
 #  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
 
 from .answer_pre_checkout_query import AnswerPreCheckoutQuery
+from .answer_shipping_query import AnswerShippingQuery
+from .delete_business_messages import DeleteBusinessMessages
 from .get_business_connection import GetBusinessConnection
-from .get_available_gifts import GetAvailableGifts
+from .get_business_account_gifts import GetBusinessAccountGifts
-from .get_user_gifts import GetUserGifts
+from .get_business_account_star_balance import GetBusinessAccountStarBalance
-from .sell_gift import SellGift
+from .transfer_business_account_stars import TransferBusinessAccountStars
-from .send_gift import SendGift
-from .toggle_gift_is_saved import ToggleGiftIsSaved
 
 
 class TelegramBusiness(
     AnswerPreCheckoutQuery,
+    AnswerShippingQuery,
+    DeleteBusinessMessages,
     GetBusinessConnection,
-    GetAvailableGifts,
+    GetBusinessAccountGifts,
-    GetUserGifts,
+    GetBusinessAccountStarBalance,
-    SellGift,
+    TransferBusinessAccountStars,
-    SendGift,
-    ToggleGiftIsSaved,
 ):
     pass

pyrogram/methods/business/delete_business_messages.py

@@ -0,0 +1,71 @@
+#  Pyrogram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#  Copyright (C) 2022-present Mayuri-Chan <https://github.com/Mayuri-Chan>
+#
+#  This file is part of Pyrogram.
+#
+#  Pyrogram is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Lesser General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  Pyrogram is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Lesser General Public License for more details.
+#
+#  You should have received a copy of the GNU Lesser General Public License
+#  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
+
+from typing import Iterable, Union
+
+import pyrogram
+from pyrogram import raw
+
+
+class DeleteBusinessMessages:
+    async def delete_business_messages(
+        self: "pyrogram.Client",
+        business_connection_id: str,
+        message_ids: Union[int, Iterable[int]]
+    ) -> int:
+        """Delete messages on behalf of a business account.
+
+        .. note::
+
+            Requires the `can_delete_sent_messages` business bot right to delete messages sent by the bot itself,
+            or the `can_delete_all_messages` business bot right to delete any message.
+
+        .. include:: /_includes/usable-by/bots.rst
+
+        Parameters:
+            business_connection_id (``str``):
+                Unique identifier of business connection on behalf of which to send the request.
+
+            message_ids (``int`` | Iterable of ``int``):
+                An iterable of message identifiers to delete (integers) or a single message id.
+                All messages must be from the same chat.
+
+        Returns:
+            ``int``: Amount of affected messages
+
+        Example:
+            .. code-block:: python
+
+                # Delete one message
+                await app.delete_business_messages(connection_id, message_id)
+
+                # Delete multiple messages at once
+                await app.delete_business_messages(connection_id, list_of_message_ids)
+        """
+        message_ids = list(message_ids) if not isinstance(message_ids, int) else [message_ids]
+
+        r = await self.invoke(
+            raw.functions.messages.DeleteMessages(
+                id=message_ids,
+                revoke=True
+            ),
+            business_connection_id=business_connection_id
+        )
+
+        return r.pts_count

pyrogram/methods/business/get_business_account_gifts.py

@@ -0,0 +1,129 @@
+#  Pyrogram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#  Copyright (C) 2022-present Mayuri-Chan <https://github.com/Mayuri-Chan>
+#
+#  This file is part of Pyrogram.
+#
+#  Pyrogram is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Lesser General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  Pyrogram is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Lesser General Public License for more details.
+#
+#  You should have received a copy of the GNU Lesser General Public License
+#  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
+
+from typing import Optional
+
+import pyrogram
+from pyrogram import raw, types
+
+
+class GetBusinessAccountGifts:
+    async def get_business_account_gifts(
+        self: "pyrogram.Client",
+        business_connection_id: str,
+        exclude_unsaved: Optional[bool] = None,
+        exclude_saved: Optional[bool] = None,
+        exclude_unlimited: Optional[bool] = None,
+        exclude_limited: Optional[bool] = None,
+        exclude_upgraded: Optional[bool] = None,
+        sort_by_price: Optional[bool] = None,
+        limit: int = 0,
+        offset: str = "",
+    ):
+        """Return the gifts received and owned by a managed business account.
+
+        .. note::
+
+            Requires the `can_view_gifts_and_stars` business bot right.
+
+        .. include:: /_includes/usable-by/bots.rst
+
+        Parameters:
+            business_connection_id (``str``):
+                Unique identifier of business connection on behalf of which to send the request.
+
+            exclude_unsaved (``bool``, *optional*):
+                Pass True to exclude gifts that aren’t saved to the account’s profile page.
+
+            exclude_saved (``bool``, *optional*):
+                Pass True to exclude gifts that are saved to the account’s profile page.
+
+            exclude_unlimited (``bool``, *optional*):
+                Pass True to exclude gifts that can be purchased an unlimited number of times.
+
+            exclude_limited (``bool``, *optional*):
+                Pass True to exclude gifts that can be purchased a limited number of times.
+
+            exclude_upgraded (``bool``, *optional*):
+                Pass True to exclude upgraded gifts.
+
+            sort_by_price (``bool``, *optional*):
+                Pass True to sort results by gift price instead of send date. Sorting is applied before pagination.
+
+            offset (``str``, *optional*):
+                Offset of the first entry to return as received from the previous request.
+
+            limit (``int``, *optional*):
+                The maximum number of gifts to be returned.
+
+        Returns:
+            ``Generator``: A generator yielding :obj:`~pyrogram.types.Gift` objects.
+
+        Example:
+            .. code-block:: python
+
+                async for gift in app.get_business_account_gifts(connection_id):
+                    print(gift)
+        """
+        current = 0
+        total = abs(limit) or (1 << 31) - 1
+        limit = min(100, total)
+
+        connection_info = await self.get_business_connection(business_connection_id)
+
+        while True:
+            r = await self.invoke(
+                raw.functions.payments.GetSavedStarGifts(
+                    peer=await self.resolve_peer(connection_info.user.id),
+                    offset=offset,
+                    limit=limit,
+                    exclude_unsaved=exclude_unsaved,
+                    exclude_saved=exclude_saved,
+                    exclude_unlimited=exclude_unlimited,
+                    exclude_limited=exclude_limited,
+                    exclude_unique=exclude_upgraded,
+                    sort_by_value=sort_by_price
+                ),
+                sleep_threshold=60,
+                business_connection_id=business_connection_id
+            )
+
+            users = {i.id: i for i in r.users}
+            chats = {i.id: i for i in r.chats}
+
+            user_star_gifts = [
+                await types.Gift._parse_saved(self, gift, users, chats)
+                for gift in r.gifts
+            ]
+
+            if not user_star_gifts:
+                return
+
+            for gift in user_star_gifts:
+                yield gift
+
+                current += 1
+
+                if current >= total:
+                    return
+
+            offset = r.next_offset
+
+            if not offset:
+                return

pyrogram/methods/business/get_business_account_star_balance.py

@@ -0,0 +1,61 @@
+#  Pyrogram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#  Copyright (C) 2022-present Mayuri-Chan <https://github.com/Mayuri-Chan>
+#
+#  This file is part of Pyrogram.
+#
+#  Pyrogram is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Lesser General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  Pyrogram is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Lesser General Public License for more details.
+#
+#  You should have received a copy of the GNU Lesser General Public License
+#  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
+
+from typing import Optional, Union
+
+import pyrogram
+from pyrogram import raw
+
+
+class GetBusinessAccountStarBalance:
+    async def get_business_account_star_balance(
+        self: "pyrogram.Client",
+        business_connection_id: str,
+    ) -> int:
+        """Return the amount of Telegram Stars owned by a managed business account.
+
+        .. note::
+
+            Requires the `can_view_gifts_and_stars` business bot right.
+
+        .. include:: /_includes/usable-by/bots.rst
+
+        Parameters:
+            business_connection_id (``str``):
+                Unique identifier of business connection on behalf of which to send the request.
+
+        Returns:
+            ``int``: On success, the current stars balance is returned.
+
+        Example:
+            .. code-block:: python
+
+                # Get stars balance
+                await app.get_business_account_star_balance("connection_id")
+        """
+        connection_info = await self.get_business_connection(business_connection_id)
+
+        r = await self.invoke(
+            raw.functions.payments.GetStarsStatus(
+                peer=await self.resolve_peer(connection_info.user.id),
+            ),
+            business_connection_id=business_connection_id
+        )
+
+        return r.balance.amount

pyrogram/methods/business/get_business_connection.py

@@ -16,11 +16,8 @@
 #  You should have received a copy of the GNU Lesser General Public License
 #  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
 
-from datetime import datetime
-from typing import Union, List
-
 import pyrogram
-from pyrogram import types, utils, raw
+from pyrogram import types, raw
 
 
 class GetBusinessConnection:

pyrogram/methods/business/get_user_gifts.py

@@ -1,97 +0,0 @@
-#  Pyrogram - Telegram MTProto API Client Library for Python
-#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
-#
-#  This file is part of Pyrogram.
-#
-#  Pyrogram is free software: you can redistribute it and/or modify
-#  it under the terms of the GNU Lesser General Public License as published
-#  by the Free Software Foundation, either version 3 of the License, or
-#  (at your option) any later version.
-#
-#  Pyrogram is distributed in the hope that it will be useful,
-#  but WITHOUT ANY WARRANTY; without even the implied warranty of
-#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-#  GNU Lesser General Public License for more details.
-#
-#  You should have received a copy of the GNU Lesser General Public License
-#  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
-
-from typing import Union, Optional, AsyncGenerator
-
-import pyrogram
-from pyrogram import raw, types
-
-
-class GetUserGifts:
-    async def get_user_gifts(
-        self: "pyrogram.Client",
-        user_id: Union[int, str],
-        offset: str = "",
-        limit: int = 0,
-    ) -> Optional[AsyncGenerator["types.UserGift", None]]:
-        """Get gifts saved to profile by the given user.
-
-        .. include:: /_includes/usable-by/users.rst
-
-        Parameters:
-            user_id (``int`` | ``str``):
-                Unique identifier (int) or username (str) of the target user.
-                For your personal cloud (Saved Messages) you can simply use "me" or "self".
-                For a contact that exists in your Telegram address book you can use his phone number (str).
-
-            offset (``str``, *optional*):
-                Offset of the first entry to return as received from the previous request; use empty string to get the first chunk of results.
-
-            limit (``int``, *optional*):
-                The maximum number of gifts to be returned; must be positive and can't be greater than 100. For optimal performance, the number of returned objects is chosen by Telegram Server and can be smaller than the specified limit.
-
-        Returns:
-            ``Generator``: A generator yielding :obj:`~pyrogram.types.UserGift` objects.
-
-        Example:
-            .. code-block:: python
-
-                async for user_gift in app.get_user_gifts(user_id):
-                    print(user_gift)
-        """
-        peer = await self.resolve_peer(user_id)
-
-        if not isinstance(peer, (raw.types.InputPeerUser, raw.types.InputPeerSelf)):
-            raise ValueError("user_id must belong to a user.")
-
-        current = 0
-        total = abs(limit) or (1 << 31) - 1
-        limit = min(100, total)
-
-        while True:
-            r = await self.invoke(
-                raw.functions.payments.GetUserStarGifts(
-                    user_id=peer,
-                    offset=offset,
-                    limit=limit
-                ),
-                sleep_threshold=max(60, self.sleep_threshold)
-            )
-
-            users = {u.id: u for u in r.users}
-
-            user_gifts = [
-                await types.UserGift._parse(self, gift, users)
-                for gift in r.gifts
-            ]
-
-            if not user_gifts:
-                return
-
-            for user_gift in user_gifts:
-                yield user_gift
-
-                current += 1
-
-                if current >= total:
-                    return
-
-            offset = r.next_offset
-
-            if not offset:
-                return

pyrogram/methods/business/sell_gift.py

@@ -1,67 +0,0 @@
-#  Pyrogram - Telegram MTProto API Client Library for Python
-#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
-#
-#  This file is part of Pyrogram.
-#
-#  Pyrogram is free software: you can redistribute it and/or modify
-#  it under the terms of the GNU Lesser General Public License as published
-#  by the Free Software Foundation, either version 3 of the License, or
-#  (at your option) any later version.
-#
-#  Pyrogram is distributed in the hope that it will be useful,
-#  but WITHOUT ANY WARRANTY; without even the implied warranty of
-#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-#  GNU Lesser General Public License for more details.
-#
-#  You should have received a copy of the GNU Lesser General Public License
-#  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
-
-
-from typing import Union
-
-import pyrogram
-from pyrogram import raw
-
-
-class SellGift:
-    async def sell_gift(
-        self: "pyrogram.Client",
-        sender_user_id: Union[int, str],
-        message_id: int
-    ) -> bool:
-        """Sells a gift received by the current user for Telegram Stars.
-
-        .. include:: /_includes/usable-by/users.rst
-
-        Parameters:
-            sender_user_id (``int`` | ``str``):
-                Unique identifier (int) or username (str) of the user that sent the gift.
-                For your personal cloud (Saved Messages) you can simply use "me" or "self".
-                For a contact that exists in your Telegram address book you can use his phone number (str).
-
-            message_id (``int``):
-                Unique identifier of the message with the gift in the chat with the user.
-
-        Returns:
-            ``bool``: On success, True is returned.
-
-        Example:
-            .. code-block:: python
-
-                # Convert gift
-                app.sell_gift(sender_user_id=user_id, message_id=123)
-
-        """
-        peer = await self.resolve_peer(sender_user_id)
-
-        if not isinstance(peer, (raw.types.InputPeerUser, raw.types.InputPeerSelf)):
-            raise ValueError("sender_user_id must belong to a user.")
-
-        r = await self.invoke(
-            raw.functions.payments.ConvertStarGift(
-                user_id=peer,
-                msg_id=message_id
-            )
-        )
-
-        return r

pyrogram/methods/business/send_gift.py

@@ -1,105 +0,0 @@
-#  Pyrogram - Telegram MTProto API Client Library for Python
-#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
-#
-#  This file is part of Pyrogram.
-#
-#  Pyrogram is free software: you can redistribute it and/or modify
-#  it under the terms of the GNU Lesser General Public License as published
-#  by the Free Software Foundation, either version 3 of the License, or
-#  (at your option) any later version.
-#
-#  Pyrogram is distributed in the hope that it will be useful,
-#  but WITHOUT ANY WARRANTY; without even the implied warranty of
-#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-#  GNU Lesser General Public License for more details.
-#
-#  You should have received a copy of the GNU Lesser General Public License
-#  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
-
-
-from typing import Optional, Union, List
-
-import pyrogram
-from pyrogram import raw, types, enums, utils
-
-
-class SendGift:
-    async def send_gift(
-        self: "pyrogram.Client",
-        user_id: Union[int, str],
-        gift_id: int,
-        text: Optional[str] = None,
-        parse_mode: Optional["enums.ParseMode"] = None,
-        entities: Optional[List["types.MessageEntity"]] = None,
-        is_private: Optional[bool] = None,
-    ) -> bool:
-        """Sends a gift to another user.
-
-        .. include:: /_includes/usable-by/users.rst
-
-        Parameters:
-            user_id (``int`` | ``str``):
-                Unique identifier (int) or username (str) of the user that will receive the gift.
-                For your personal cloud (Saved Messages) you can simply use "me" or "self".
-                For a contact that exists in your Telegram address book you can use his phone number (str).
-
-            gift_id (``int``):
-                Unique identifier of the gift to send.
-
-            text (``str``, *optional*):
-                Text of the message to be sent. 0-``gift_text_length_max`` characters.
-
-            parse_mode (:obj:`~pyrogram.enums.ParseMode`, *optional*):
-                By default, texts are parsed using both Markdown and HTML styles.
-                You can combine both syntaxes together.
-
-            entities (List of :obj:`~pyrogram.types.MessageEntity`, *optional*):
-                List of special entities that appear in message text, which can be specified instead of *parse_mode*.
-                Only Bold, Italic, Underline, Strikethrough, Spoiler, and CustomEmoji entities are allowed.
-
-            is_private (``bool``, *optional*):
-                Pass True to show the current user as sender and gift text only to the gift receiver; otherwise, everyone will be able to see them.
-
-        Returns:
-            ``bool``: On success, True is returned.
-
-        Raises:
-            RPCError: In case of a Telegram RPC error.
-
-        Example:
-            .. code-block:: python
-
-                # Send gift
-                app.send_gift(user_id=user_id, gift_id=123)
-
-        """
-        peer = await self.resolve_peer(user_id)
-
-        if not isinstance(peer, (raw.types.InputPeerUser, raw.types.InputPeerSelf)):
-            raise ValueError("user_id must belong to a user.")
-
-        text, entities = (await utils.parse_text_entities(self, text, parse_mode, entities)).values()
-
-        invoice = raw.types.InputInvoiceStarGift(
-            user_id=peer,
-            gift_id=gift_id,
-            hide_name=is_private,
-            message=raw.types.TextWithEntities(
-                text=text, entities=entities or []
-            ) if text else None
-        )
-
-        form = await self.invoke(
-            raw.functions.payments.GetPaymentForm(
-                invoice=invoice
-            )
-        )
-
-        await self.invoke(
-            raw.functions.payments.SendStarsForm(
-                form_id=form.form_id,
-                invoice=invoice
-            )
-        )
-
-        return True

pyrogram/methods/business/transfer_business_account_stars.py

@@ -0,0 +1,72 @@
+#  Pyrogram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#
+#  This file is part of Pyrogram.
+#
+#  Pyrogram is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Lesser General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  Pyrogram is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Lesser General Public License for more details.
+#
+#  You should have received a copy of the GNU Lesser General Public License
+#  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
+
+import pyrogram
+from pyrogram import raw
+
+
+class TransferBusinessAccountStars:
+    async def transfer_business_account_stars(
+        self: "pyrogram.Client",
+        business_connection_id: str,
+        star_count: int,
+    ) -> bool:
+        """Transfers Telegram Stars from the business account balance to the bot’s balance.
+
+        .. note::
+
+            Requires the `can_transfer_stars` business bot right.
+
+        .. include:: /_includes/usable-by/users.rst
+
+        Parameters:
+            business_connection_id (``str``):
+                Unique identifier of the business connection.
+
+            star_count (``int`` | ``str``):
+                Number of Telegram Stars to transfer, 1-10000.
+
+        Returns:
+            ``bool``: On success, True is returned.
+        """
+        # Why telegram won't let us just use InputPeerSelf :(
+        if self.me:
+            bot_id = self.me.id
+        else:
+            bot_id = (
+                await self.invoke(raw.functions.users.GetUsers(id=[raw.types.InputPeerSelf()]))
+            )[0].id
+
+        invoice = raw.types.InputInvoiceBusinessBotTransferStars(
+            bot=await self.resolve_peer(bot_id), stars=star_count
+        )
+
+        payment_form = await self.invoke(
+            raw.functions.payments.GetPaymentForm(invoice=invoice),
+            business_connection_id=business_connection_id,
+        )
+
+        await self.invoke(
+            raw.functions.payments.SendStarsForm(
+                form_id=payment_form.form_id,
+                invoice=invoice,
+            ),
+            business_connection_id=business_connection_id,
+        )
+
+        return True

pyrogram/methods/chats/__init__.py

@@ -21,24 +21,14 @@ from .add_chat_members import AddChatMembers
 from .archive_chats import ArchiveChats
 from .ban_chat_member import BanChatMember
 from .create_channel import CreateChannel
-from .create_forum_topic import CreateForumTopic
 from .create_group import CreateGroup
 from .create_supergroup import CreateSupergroup
-from .close_forum_topic import CloseForumTopic
-from .close_general_topic import CloseGeneralTopic
 from .delete_channel import DeleteChannel
 from .delete_chat_photo import DeleteChatPhoto
 from .delete_folder import DeleteFolder
-from .delete_forum_topic import DeleteForumTopic
 from .delete_supergroup import DeleteSupergroup
 from .delete_user_history import DeleteUserHistory
-from .edit_forum_topic import EditForumTopic
-from .edit_general_topic import EditGeneralTopic
 from .export_folder_link import ExportFolderLink
-from .reopen_forum_topic import ReopenForumTopic
-from .reopen_general_topic import ReopenGeneralTopic
-from .hide_general_topic import HideGeneralTopic
-from .unhide_general_topic import UnhideGeneralTopic
 from .get_chat import GetChat
 from .get_chat_event_log import GetChatEventLog
 from .get_chat_member import GetChatMember
@@ -48,8 +38,6 @@ from .get_chat_online_count import GetChatOnlineCount
 from .get_dialogs import GetDialogs
 from .get_dialogs_count import GetDialogsCount
 from .get_folders import GetFolders
-from .get_forum_topics import GetForumTopics
-from .get_forum_topics_by_id import GetForumTopicsByID
 from .get_send_as_chats import GetSendAsChats
 from .join_chat import JoinChat
 from .leave_chat import LeaveChat
@@ -66,6 +54,7 @@ from .set_chat_title import SetChatTitle
 from .set_chat_username import SetChatUsername
 from .set_send_as_chat import SetSendAsChat
 from .set_slow_mode import SetSlowMode
+from .transfer_chat_ownership import TransferChatOwnership
 from .unarchive_chats import UnarchiveChats
 from .unban_chat_member import UnbanChatMember
 from .unpin_all_chat_messages import UnpinAllChatMessages
@@ -96,28 +85,16 @@ class Chats(
     SetChatPermissions,
     GetDialogsCount,
     GetFolders,
-    GetForumTopics,
-    GetForumTopicsByID,
     ArchiveChats,
     UnarchiveChats,
     CreateGroup,
     CreateSupergroup,
     CreateChannel,
-    CreateForumTopic,
-    CloseForumTopic,
-    CloseGeneralTopic,
     AddChatMembers,
     DeleteChannel,
     DeleteFolder,
-    DeleteForumTopic,
     DeleteSupergroup,
-    EditForumTopic,
-    EditGeneralTopic,
     ExportFolderLink,
-    ReopenForumTopic,
-    ReopenGeneralTopic,
-    HideGeneralTopic,
-    UnhideGeneralTopic,
     SetAdministratorTitle,
     SetSlowMode,
     DeleteUserHistory,
@@ -128,6 +105,7 @@ class Chats(
     GetSendAsChats,
     SetSendAsChat,
     SetChatProtectedContent,
+    TransferChatOwnership,
     UpdateColor,
     UpdateFolder
 ):

pyrogram/methods/chats/ban_chat_member.py

@@ -117,5 +117,4 @@ class BanChatMember:
                     {i.id: i for i in r.users},
                     {i.id: i for i in r.chats}
                 )
-        else:
+        return True
-            return True

pyrogram/methods/chats/export_folder_link.py

@@ -25,7 +25,7 @@ class ExportFolderLink:
     async def export_folder_link(
         self: "pyrogram.Client",
         folder_id: int
-    ) -> str:
+    ) -> "pyrogram.types.ExportedFolderLink":
         """Export link to a user's folder.
 
         .. include:: /_includes/usable-by/users.rst
@@ -35,7 +35,7 @@ class ExportFolderLink:
                 Unique identifier (int) of the target folder.
 
         Returns:
-            ``str``: On success, a link to the folder as string is returned.
+            :obj:`~pyrogram.types.ExportedFolderLink` objects.
 
         Example:
             .. code-block:: python
@@ -67,4 +67,4 @@ class ExportFolderLink:
             )
         )
 
-        return r.invite.url
+        return types.ExportedFolderLink._parse(r)

pyrogram/methods/chats/get_chat_member.py

@@ -77,8 +77,7 @@ class GetChatMember:
                 else:
                     if member.user.id == user.user_id:
                         return member
-            else:
+            raise UserNotParticipant
-                raise UserNotParticipant
         elif isinstance(chat, raw.types.InputPeerChannel):
             r = await self.invoke(
                 raw.functions.channels.GetParticipant(

pyrogram/methods/chats/get_dialogs.py

@@ -21,7 +21,7 @@ from typing import AsyncGenerator, Optional
 
 import pyrogram
 from pyrogram import types, raw, utils
-from pyrogram.errors import ChannelPrivate
+from pyrogram.errors import ChannelPrivate, PeerIdInvalid
 
 
 class GetDialogs:
@@ -80,7 +80,7 @@ class GetDialogs:
                 chat_id = utils.get_peer_id(message.peer_id)
                 try:
                     messages[chat_id] = await types.Message._parse(self, message, users, chats)
-                except ChannelPrivate:
+                except (ChannelPrivate, PeerIdInvalid):
                     continue
 
             dialogs = []

pyrogram/methods/chats/get_folders.py

@@ -81,7 +81,7 @@ class GetFolders:
             users.update({i.id: i for i in r.users})
             chats.update({i.id: i for i in r.chats})
 
-        folders = types.List(types.Folder._parse(self, folder, users, chats) for folder in raw_folders)
+        folders = types.List([types.Folder._parse(self, folder, users, chats) for folder in raw_folders])
 
         if not folders:
             return None

pyrogram/methods/chats/pin_chat_message.py

@@ -22,14 +22,18 @@ from typing import Union
 import pyrogram
 from pyrogram import raw, types
 
+from ..messages.inline_session import get_session
+
 
 class PinChatMessage:
+
     async def pin_chat_message(
         self: "pyrogram.Client",
         chat_id: Union[int, str],
         message_id: int,
         disable_notification: bool = False,
         both_sides: bool = False,
+        business_connection_id: str = None,
     ) -> "types.Message":
         """Pin a message in a group, channel or your own chat.
         You must be an administrator in the chat for this to work and must have the "can_pin_messages" admin right in
@@ -52,6 +56,9 @@ class PinChatMessage:
             both_sides (``bool``, *optional*):
                 Pass True to pin the message for both sides (you and recipient).
                 Applicable to private chats only. Defaults to False.
+                
+            business_connection_id (``str``, *optional*):
+                Unique identifier of the business connection on behalf of which the message will be pinned.
 
         Returns:
             :obj:`~pyrogram.types.Message`: On success, the service message is returned.
@@ -65,19 +72,39 @@ class PinChatMessage:
                 # Pin without notification
                 await app.pin_chat_message(chat_id, message_id, disable_notification=True)
         """
-        r = await self.invoke(
+        rpc = raw.functions.messages.UpdatePinnedMessage(
-            raw.functions.messages.UpdatePinnedMessage(
+            peer=await self.resolve_peer(chat_id),
-                peer=await self.resolve_peer(chat_id),
+            id=message_id,
-                id=message_id,
+            silent=disable_notification or None,
-                silent=disable_notification or None,
+            pm_oneside=not both_sides or None
-                pm_oneside=not both_sides or None
-            )
         )
 
+        session = None
+        business_connection = None
+        if business_connection_id:
+            business_connection = self.business_user_connection_cache[business_connection_id]
+            if not business_connection:
+                business_connection = await self.get_business_connection(business_connection_id)
+            session = await get_session(
+                self,
+                business_connection._raw.connection.dc_id
+            )
+
+        if business_connection_id:
+            r = await session.invoke(
+                raw.functions.InvokeWithBusinessConnection(
+                    query=rpc,
+                    connection_id=business_connection_id
+                )
+            )
+        else:
+            r = await self.invoke(rpc)
+
         users = {u.id: u for u in r.users}
         chats = {c.id: c for c in r.chats}
 
         for i in r.updates:
             if isinstance(i, (raw.types.UpdateNewMessage,
-                              raw.types.UpdateNewChannelMessage)):
+                              raw.types.UpdateNewChannelMessage,
-                return await types.Message._parse(self, i.message, users, chats)
+                              raw.types.UpdateBotNewBusinessMessage)):
+                return await types.Message._parse(self, i.message, users, chats, business_connection_id=business_connection_id)

pyrogram/methods/chats/set_chat_photo.py

@@ -164,5 +164,4 @@ class SetChatPhoto:
                     {i.id: i for i in r.users},
                     {i.id: i for i in r.chats}
                 )
-        else:
+        return True
-            return True

pyrogram/methods/chats/transfer_chat_ownership.py

@@ -0,0 +1,83 @@
+#  Pyrofork - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2022-present Mayuri-Chan <https://github.com/Mayuri-Chan>
+#
+#  This file is part of Pyrofork.
+#
+#  Pyrofork is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Lesser General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  Pyrofork is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Lesser General Public License for more details.
+#
+#  You should have received a copy of the GNU Lesser General Public License
+#  along with Pyrofork.  If not, see <http://www.gnu.org/licenses/>.
+
+from typing import Union
+import pyrogram
+from pyrogram import raw, utils
+
+
+class TransferChatOwnership:
+    async def transfer_chat_ownership(
+        self: "pyrogram.Client",
+        chat_id: Union[int, str],
+        user_id: Union[int, str],
+        password: str,
+    ) -> bool:
+        """Transfer the owner of a chat or channel to another user.
+
+        .. note:
+
+            Requires owner privileges.
+
+        .. include:: /_includes/usable-by/users.rst
+
+        Parameters:
+            chat_id (``int`` | ``str``):
+                Unique identifier (int) or username (str) of the target chat.
+                Unique identifier for the target chat in form of a *t.me/joinchat/* link, identifier (int) or username
+                of the target channel/supergroup (in the format @username).
+
+            user_id (``int`` | ``str``):
+                Unique identifier (int) or username (str) of the new owner.
+                For a contact that exists in your Telegram address book you can use his phone number (str).
+
+            password (``str``):
+                The 2-step verification password of the current user.
+
+        Returns:
+            ``bool``: True on success.
+
+        Raises:
+            ValueError: In case of invalid parameters.
+            RPCError: In case of a Telegram RPC error.
+
+        Example:
+            .. code-block:: python
+
+                await app.transfer_chat_ownership(chat_id, user_id, "password")
+        """
+        peer_channel = await self.resolve_peer(chat_id)
+        peer_user = await self.resolve_peer(user_id)
+
+        if not isinstance(peer_channel, raw.types.InputPeerChannel):
+            raise ValueError("The chat_id must belong to a channel/supergroup.")
+
+        if not isinstance(peer_user, raw.types.InputPeerUser):
+            raise ValueError("The user_id must belong to a user.")
+
+        r = await self.invoke(
+            raw.functions.channels.EditCreator(
+                channel=peer_channel,
+                user_id=peer_user,
+                password=utils.compute_password_check(
+                    await self.invoke(raw.functions.account.GetPassword()), password
+                ),
+            )
+        )
+
+        return bool(r)

pyrogram/methods/chats/unpin_all_chat_messages.py

@@ -27,6 +27,7 @@ class UnpinAllChatMessages:
     async def unpin_all_chat_messages(
         self: "pyrogram.Client",
         chat_id: Union[int, str],
+        message_thread_id: int = None,
     ) -> bool:
         """Use this method to clear the list of pinned messages in a chat.
         If the chat is not a private chat, the bot must be an administrator in the chat for this to work and must have
@@ -39,6 +40,9 @@ class UnpinAllChatMessages:
                 Unique identifier (int) or username (str) of the target chat.
                 You can also use chat public link in form of *t.me/<username>* (str).
 
+            message_thread_id (``int``, *optional*):
+                Unique identifier for the target message thread of the forum topic
+
         Returns:
             ``bool``: True on success.
 
@@ -48,10 +52,10 @@ class UnpinAllChatMessages:
                 # Unpin all chat messages
                 await app.unpin_all_chat_messages(chat_id)
         """
-        await self.invoke(
+        r = await self.invoke(
             raw.functions.messages.UnpinAllMessages(
-                peer=await self.resolve_peer(chat_id)
+                peer=await self.resolve_peer(chat_id),
+                top_msg_id=message_thread_id
             )
         )
-
+        return r.pts_count
-        return True

pyrogram/methods/chats/unpin_chat_message.py

@@ -22,12 +22,15 @@ from typing import Union
 import pyrogram
 from pyrogram import raw
 
+from ..messages.inline_session import get_session
+
 
 class UnpinChatMessage:
     async def unpin_chat_message(
         self: "pyrogram.Client",
         chat_id: Union[int, str],
-        message_id: int = 0
+        message_id: int = 0,
+        business_connection_id: str = None,
     ) -> bool:
         """Unpin a message in a group, channel or your own chat.
         You must be an administrator in the chat for this to work and must have the "can_pin_messages" admin
@@ -38,12 +41,15 @@ class UnpinChatMessage:
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.
-                You can also use chat public link in form of *t.me/<username>* (str).
 
             message_id (``int``, *optional*):
                 Identifier of a message to unpin.
+                Required if ``business_connection_id`` is specified.
                 If not specified, the most recent pinned message (by sending date) will be unpinned.
 
+            business_connection_id (``str``, *optional*):
+                Unique identifier of the business connection on behalf of which the message will be unpinned.
+
         Returns:
             ``bool``: True on success.
 
@@ -52,12 +58,32 @@ class UnpinChatMessage:
 
                 await app.unpin_chat_message(chat_id, message_id)
         """
-        await self.invoke(
+        rpc = raw.functions.messages.UpdatePinnedMessage(
-            raw.functions.messages.UpdatePinnedMessage(
+            peer=await self.resolve_peer(chat_id),
-                peer=await self.resolve_peer(chat_id),
+            id=message_id,
-                id=message_id,
+            unpin=True
-                unpin=True
-            )
         )
+        
+        session = None
+        business_connection = None
+        if business_connection_id:
+            business_connection = self.business_user_connection_cache[business_connection_id]
+            if not business_connection:
+                business_connection = await self.get_business_connection(business_connection_id)
+            session = await get_session(
+                self,
+                business_connection._raw.connection.dc_id
+            )
+
+        if business_connection_id:
+            await session.invoke(
+                raw.functions.InvokeWithBusinessConnection(
+                    query=rpc,
+                    connection_id=business_connection_id
+                )
+            )
+        else:
+            await self.invoke(rpc)
 
         return True
+