.github/workflows/build-docs.yml

@@ -14,25 +14,8 @@ jobs:
     runs-on: ubuntu-22.04
 
     steps:
-      - name: Checkout repository
+      - uses: actions/checkout@v4
-        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 build
+        run: bash build-docs.sh
-
-      - 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.10", "3.11", "3.12", "3.13", "3.14"]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
 
     steps:
       - uses: actions/checkout@v4

.pylintrc

@@ -1,651 +0,0 @@
-[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.dev">
+    <a href="https://pyrofork.wulan17.top">
         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.dev/main/topics/mtproto-vs-botapi)
+**Pyrofork** is a modern, elegant and asynchronous [MTProto API](https://pyrofork.wulan17.top/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.dev to learn more about Pyrofork, get started right
+- Check out the docs at https://pyrofork.wulan17.top 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,87 +1,42 @@
 #!/bin/bash
+export DOCS_KEY
+VENV="$(pwd)"/venv
+export VENV
 
-# Check if config.sh exists
+if [[ "$(echo "$GITHUB_REF" | cut -d '/' -f "1 2")" == "refs/tags" ]]; then
-if [ -f config.sh ]; then
+    branch="main"
-    source config.sh
+elif [[ "$GITHUB_REF" == "refs/heads/staging" ]]; then
-fi
+    branch="staging"
-
+else
-function parse_parameters() {
+    b="$(echo "$GITHUB_REF" | cut -d '/' -f '3 4')"
-    while (($#)); do
+    if [[ $(echo "$b" | cut -d '/' -f 1 ) == "dev" ]]; then
-        case $1 in
+        b="$(echo "$b" | cut -d '/' -f 2)"
-            all | configure | cleanup | virtualenv | build | clone | push ) action=$1 ;;
+        if [[ "$b" =~ ^[0-9]\.[0-9]\.x ]]; then
-            *) exit 33 ;;
+            branch="$b"
-        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
-    chmod +x config.sh
+fi
-}
 
-function do_cleanup() {
+make clean
-    make clean
+make clean-docs
-    make clean-docs
+make venv
-}
+make api
-
+"$VENV"/bin/pip install -e '.[docs]'
-function do_virtualenv() {
+cd compiler/docs || exit 1 && "$VENV"/bin/python compiler.py
-    make venv
+cd  ../.. || exit 1
-    make api
+"$VENV"/bin/sphinx-build -b html "docs/source" "docs/build/html" -j auto
-    "$VENV"/bin/pip install -e '.[docs]'
+git clone https://wulan17:"$DOCS_KEY"@github.com/Mayuri-Chan/pyrofork-docs.git
-}
+cd pyrofork-docs || exit 1
-
+mkdir -p "$branch"
-function do_build() {
+cd "$branch" || exit 1
-    cd compiler/docs || exit 1 && "$VENV"/bin/python compiler.py
+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  ../.. || exit 1
+cp -r ../../docs/build/html/* .
-    "$VENV"/bin/sphinx-build -b html "docs/source" "docs/build/html" -j auto
+git config --local user.name "Mayuri-Chan"
-}
+git config --local user.email "mayuri@mayuri.my.id"
-
+git add --all
-function do_clone() {
+git commit -a -m "docs: $branch: Update docs $(date '+%Y-%m-%d | %H:%m:%S %p %Z')" --signoff
-    git clone https://wulan17:"$DOCS_KEY"@github.com/Mayuri-Chan/pyrofork-docs.git
+git push -u origin --all
-}
-
-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 = '"raw.base.' + ".".join([ns, name]).strip(".") + '"'
+        type = f'"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 += "Telegram API function."
+                docstring += f"Telegram API function."
 
         docstring += f"\n\n    Details:\n        - Layer: ``{layer}``\n        - ID: ``{c.id[2:].upper()}``\n\n"
-        docstring += "    Parameters:\n        " + \
+        docstring += f"    Parameters:\n        " + \
-                     ("\n        ".join(docstring_args) if docstring_args else "No parameters required.\n")
+                     (f"\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 += "\n    Functions:\n        This object can be returned by " \
+                docstring += f"\n    Functions:\n        This object can be returned by " \
                              f"{count} function{'s' if count > 1 else ''}.\n\n" \
-                             "        .. currentmodule:: pyrogram.raw.functions\n\n" \
+                             f"        .. currentmodule:: pyrogram.raw.functions\n\n" \
-                             "        .. autosummary::\n" \
+                             f"        .. autosummary::\n" \
-                             "            :nosignatures:\n\n" \
+                             f"            :nosignatures:\n\n" \
-                             "            " + references
+                             f"            " + 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.dev/telegram/base/{doc_name}")
+                        "More info: https://pyrofork.wulan17.top/telegram/base/{doc_name}")

compiler/docs/compiler.py

@@ -146,7 +146,6 @@ def pyrogram_api():
             stop_transmission
             export_session_string
             set_parse_mode
-            ping
         """,
         conversation="""
         Conversation
@@ -165,7 +164,6 @@ def pyrogram_api():
         """,
         messages="""
         Messages
-            add_task_to_todo
             send_message
             forward_media_group
             forward_messages
@@ -175,7 +173,6 @@ def pyrogram_api():
             send_audio
             send_document
             send_sticker
-            send_todo
             send_video
             send_animation
             send_voice
@@ -187,7 +184,6 @@ def pyrogram_api():
             send_contact
             send_cached_media
             send_reaction
-            set_todo_tasks_completion
             edit_message_text
             edit_message_caption
             edit_message_media
@@ -224,10 +220,7 @@ 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
@@ -258,7 +251,6 @@ def pyrogram_api():
             get_folders
             get_forum_topics
             get_forum_topics_by_id
-            get_forum_topics_count
             set_chat_username
             archive_chats
             unarchive_chats
@@ -285,7 +277,6 @@ def pyrogram_api():
             hide_general_topic
             reopen_forum_topic
             reopen_general_topic
-            transfer_chat_ownership
             unhide_general_topic
             update_color
             update_folder
@@ -358,34 +349,22 @@ def pyrogram_api():
         Payments
             apply_gift_code
             check_gift_code
-            convert_gift
+            convert_star_gift
             create_invoice_link
             get_payment_form
+            get_star_gifts
             get_stars_transactions
             get_stars_transactions_by_id
-            get_available_gifts
+            get_user_star_gifts_count
-            get_upgraded_gift
+            get_user_star_gifts
-            get_chat_gifts_count
+            hide_star_gift
-            get_chat_gifts
-            hide_gift
             refund_star_payment
-            search_gifts_for_resale
             send_invoice
             send_paid_media
             send_paid_reaction
             send_payment_form
-            send_gift
+            send_star_gift
-            send_resold_gift
+            show_star_gift
-            set_gift_resale_price
-            set_pinned_gifts
-            show_gift
-            transfer_gift
-            upgrade_gift
-            get_stars_balance
-        """,
-        phone="""
-        Phone
-            get_call_members
         """,
         password="""
         Password
@@ -414,18 +393,18 @@ def pyrogram_api():
             get_bot_info
             set_bot_info
             get_collectible_item_info
+            get_available_gifts
+            get_user_gifts
+            sell_gift
+            send_gift
+            toggle_gift_is_saved
             get_owned_bots
-            get_similar_bots
         """,
         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
@@ -437,11 +416,12 @@ def pyrogram_api():
             resend_code
             sign_in
             sign_in_bot
-            sign_in_qrcode
+            sign_up
             get_password_hint
             check_password
             send_recovery_code
             recover_password
+            accept_terms_of_service
             log_out
             get_active_sessions
         """,
@@ -465,7 +445,7 @@ def pyrogram_api():
         fmt_keys = {}
 
         for k, v in categories.items():
-            _, *methods = get_title_list(v)
+            name, *methods = get_title_list(v)
             fmt_keys.update({k: "\n    ".join("{0} <{0}>".format(m) for m in methods)})
 
             for method in methods:
@@ -499,7 +479,6 @@ def pyrogram_api():
             BusinessWeeklyOpen
             BusinessWorkingHours
             User
-            Username
             Chat
             ChatPreview
             ChatPhoto
@@ -518,37 +497,22 @@ 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
@@ -560,8 +524,6 @@ def pyrogram_api():
             Sticker
             StickerSet
             Game
-            Gift
-            GiftAttribute
             Giveaway
             GiveawayLaunched
             GiveawayResult
@@ -569,13 +531,12 @@ def pyrogram_api():
             WebPage
             WebPageEmpty
             WebPagePreview
-            TranscribedAudio
             TranslatedText
-            TextQuote
             Poll
             PollOption
             Dice
             Reaction
+            StarGift
             VideoChatScheduled
             VideoChatStarted
             VideoChatEnded
@@ -587,7 +548,6 @@ def pyrogram_api():
             ForumTopicCreated
             ForumTopicEdited
             ForumTopicClosed
-            ForumTopicDeleted
             ForumTopicReopened
             GeneralTopicHidden
             GeneralTopicUnhidden
@@ -623,11 +583,12 @@ def pyrogram_api():
             ExtendedMediaPreview
             GiftCode
             GiftedPremium
+            Gift
+            UserGift
             InputStarsTransaction
             Invoice
             LabeledPrice
             PaidMedia
-            PaidMessagePriceChanged
             PaymentForm
             PaymentInfo
             PaymentRefunded
@@ -635,6 +596,7 @@ def pyrogram_api():
             StarsStatus
             StarsTransaction
             SuccessfulPayment
+            UserStarGift
         """,
         pyromod="""
         Pyromod
@@ -737,20 +699,17 @@ def pyrogram_api():
         InputMessageContent
             InputMessageContent
             InputReplyToMessage
-            InputReplyToMonoforum
             InputReplyToStory
             InputTextMessageContent
             InputLocationMessageContent
             InputVenueMessageContent
             InputContactMessageContent
             InputInvoiceMessageContent
-            InputTodoTask
         """,
         authorization="""
         Authorization
             ActiveSession
             ActiveSessions
-            LoginToken
             SentCode
             TermsOfService
         """
@@ -768,7 +727,7 @@ def pyrogram_api():
         fmt_keys = {}
 
         for k, v in categories.items():
-            _, *types = get_title_list(v)
+            name, *types = get_title_list(v)
 
             fmt_keys.update({k: "\n    ".join(types)})
 
@@ -822,9 +781,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
@@ -882,26 +841,6 @@ 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
@@ -985,4 +924,4 @@ if "__main__" == __name__:
     DESTINATION = "../../docs/source/telegram"
     PYROGRAM_API_DEST = "../../docs/source/api"
 
-    start()
+    start()

compiler/docs/template/bound-methods.rst

@@ -140,28 +140,3 @@ 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,19 +190,6 @@ Bots
 
     {bots}
 
-Payments
-----
-
-.. autosummary::
-    :nosignatures:
-
-    {payments}
-
-.. toctree::
-    :hidden:
-
-    {payments}
-
 Authorization
 -------------
 
@@ -230,4 +217,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,45 +164,6 @@ 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
 -------------
 
@@ -214,4 +175,4 @@ Authorization
 .. toctree::
     :hidden:
 
-    {authorization}
+    {authorization}

compiler/errors/compiler.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/>.
 
-import ast
 import csv
 import os
 import re
@@ -38,13 +37,6 @@ 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)
@@ -135,20 +127,6 @@ 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,7 +35,6 @@ 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
@@ -47,7 +46,6 @@ 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
@@ -380,9 +378,6 @@ 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
@@ -503,6 +498,4 @@ 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,4 +44,3 @@ 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/enums/BusinessSchedule.rst

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

docs/source/api/enums/ChatJoinType.rst

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

docs/source/api/enums/ClientPlatform.rst

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

docs/source/api/enums/GiftAttributeType.rst

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

docs/source/api/enums/GiftForResaleOrder.rst

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

docs/source/api/enums/MessageOriginType.rst

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

docs/source/api/enums/ProfileColor.rst

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

docs/source/api/enums/ReplyColor.rst

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

docs/source/api/enums/index.rst

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

docs/source/conf.py

@@ -29,7 +29,7 @@ from pygments.styles.friendly import FriendlyStyle
 FriendlyStyle.background_color = "#f3f2f1"
 
 project = "Pyrofork"
-copyright = "2022-present, Mayuri-Chan"
+copyright = f"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.dev/",
+    "site_url": "https://pyrofork.wulan17.top/",
     "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.dev"
+                                url="https://pyrofork.wulan17.top"
                             ),
                         ],
                         [  # 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.dev/intro/install",
+                    url="https://pyrofork.wulan17.top/intro/install",
                     description="How to install Pyrofork",
                     reply_markup=InlineKeyboardMarkup(
                         [
                             [InlineKeyboardButton(
                                 "Open website",
-                                url="https://pyrofork.wulan17.dev/intro/install"
+                                url="https://pyrofork.wulan17.top/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.dev/start/invoking",
+                    url="https://pyrofork.wulan17.top/start/invoking",
                     description="How to use Pyrofork",
                     reply_markup=InlineKeyboardMarkup(
                         [
                             [InlineKeyboardButton(
                                 "Open website",
-                                url="https://pyrofork.wulan17.dev/start/invoking"
+                                url="https://pyrofork.wulan17.top/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.dev/)'s group chat {}!"
+    MESSAGE = "{} Welcome to [Pyrofork](https://pyrofork.wulan17.top/)'s group chat {}!"
 
     app = Client("my_account")
 

docs/source/topics/storage-engines.rst

@@ -80,20 +80,7 @@ Using async_pymongo (Recommended for python3.9+):
         print(await app.get_me())
 
 
-Using official mongodb driver:
+Using motor:
-
-.. 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,16 +37,68 @@ 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
 
-- > Quoted text with collapse/expand button
+Markdown Style
+--------------
+
+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
 ----------
@@ -70,10 +122,10 @@ To strictly use this mode, pass :obj:`~pyrogram.enums.HTML` to the *parse_mode*
 
     <a href="tg://user?id=123456789">inline mention</a>
 
-    <emoji id="12345678901234567890">🔥</emoji>
-
     <code>inline fixed-width code</code>
 
+    <emoji id="12345678901234567890">🔥</emoji>
+
     <pre>
     pre-formatted
       fixed-width
@@ -82,8 +134,6 @@ 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
@@ -128,72 +178,6 @@ 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
 ----------------
 
@@ -246,18 +230,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.10"
+requires-python = "~=3.9"
 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.dev"
+Documentation = "https://pyrofork.wulan17.top"
 
 [build-system]
 requires = ["hatchling"]
@@ -60,7 +60,7 @@ dev = [
 
 docs = [
     "sphinx",
-    "sphinx-immaterial==0.12.5",
+    "sphinx-immaterial==0.12.4",
     "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.69"
+__version__ = "2.3.53"
 __license__ = "GNU Lesser General Public License v3.0 (LGPL-3.0)"
 __copyright__ = "Copyright (C) 2022-present Mayuri-Chan <https://github.com/Mayuri-Chan>"
 
@@ -37,24 +37,8 @@ class ContinuePropagation(StopAsyncIteration):
     pass
 
 
-from . import raw, types, filters, handlers, emoji, enums  # pylint: disable=wrong-import-position
+from . import raw, types, filters, handlers, emoji, enums
-from .client import Client  # pylint: disable=wrong-import-position
+from .client import Client
-from .sync import idle, compose  # pylint: disable=wrong-import-position
+from .sync import idle, compose
 
 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,13 +33,12 @@ 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, Tuple
+from typing import Union, List, Optional, Callable, AsyncGenerator, Type, 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
@@ -52,26 +51,24 @@ 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
-    MONGO_AVAIL = True
+from pyrogram.types import User, TermsOfService
+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):
@@ -131,9 +128,6 @@ 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
@@ -227,13 +221,10 @@ 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
 
@@ -254,16 +245,13 @@ 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,
@@ -278,7 +266,7 @@ class Client(Methods):
         skip_updates: bool = True,
         takeout: bool = None,
         sleep_threshold: int = Session.SLEEP_THRESHOLD,
-        hide_password: Optional[bool] = True,
+        hide_password: Optional[bool] = False,
         max_concurrent_transmissions: int = MAX_CONCURRENT_TRANSMISSIONS,
         client_platform: "enums.ClientPlatform" = enums.ClientPlatform.OTHER,
         max_message_cache_size: int = MAX_CACHE_SIZE,
@@ -292,16 +280,13 @@ 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
@@ -331,7 +316,9 @@ class Client(Methods):
         elif self.in_memory:
             self.storage = MemoryStorage(self.name)
         elif self.mongodb:
-            if not MONGO_AVAIL:
+            try:
+                import pymongo
+            except Exception:
                 log.warning(
                     "pymongo is missing! "
                     "Using MemoryStorage as session storage"
@@ -410,15 +397,6 @@ 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)
@@ -426,60 +404,52 @@ 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:
-            if not self.use_qrcode and not self.phone_code:
+            try:
+                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:
-                if self.use_qrcode:
+                signed_in = await self.sign_in(self.phone_number, sent_code.phone_code_hash, self.phone_code)
-                    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
@@ -518,18 +488,33 @@ 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.
 
@@ -825,7 +810,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.dev/main/start/auth")
+                                     "More info: https://pyrofork.wulan17.top/main/start/auth")
 
             await self.storage.api_id(self.api_id)
 
@@ -903,7 +888,7 @@ class Client(Methods):
             count = 0
 
             if not include:
-                for current_root, _, filenames in os.walk(root.replace(".", "/")):
+                for current_root, dirnames, filenames in os.walk(root.replace(".", "/")):
                     namespace = current_root.replace("/", ".").replace("\\", ".")
                     if "__pycache__" in namespace:
                         continue
@@ -968,7 +953,7 @@ class Client(Methods):
                                                     )
 
                                                     count += 1
-                                        except Exception:
+                                        except Exception as e:
                                             pass
             else:
                 for path, handlers in include:
@@ -1057,7 +1042,7 @@ class Client(Methods):
                                                             )
 
                                                             count += 1
-                                                except Exception:
+                                                except Exception as e:
                                                     pass
 
                     if handlers is None:
@@ -1121,7 +1106,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,7 +18,3 @@
 #  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 _ in range(Connection.MAX_CONNECTION_ATTEMPTS):
+        for i in range(Connection.MAX_CONNECTION_ATTEMPTS):
             self.protocol = self.protocol_factory(ipv6=self.ipv6, proxy=self.proxy)
 
             try:

pyrogram/connection/transport/__init__.py

@@ -18,6 +18,3 @@
 #  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,13 +23,3 @@ 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,6 +21,7 @@ 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.dev/main/topics/speedups"
+        "More info: https://pyrofork.wulan17.top/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("Received empty data. Check your internet connection.")
+            raise ConnectionError(f"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 _ in range(r):
+        for i 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 _ in range(min(m, r - k)):
+            for i in range(min(m, r - k)):
                 y = (pow(y, 2, pq) + c) % pq
                 q = q * (abs(x - y)) % pq
 

pyrogram/dispatcher.py

@@ -21,10 +21,9 @@ import asyncio
 import inspect
 import logging
 from collections import OrderedDict
-from typing import Any
 
 import pyrogram
-from pyrogram import raw, types, utils
+from pyrogram import errors, raw, types, utils
 from pyrogram.handlers.handler import Handler
 from pyrogram.handlers import (
   BotBusinessConnectHandler,
@@ -48,8 +47,7 @@ from pyrogram.handlers import (
   ChosenInlineResultHandler,
   ChatMemberUpdatedHandler,
   ChatJoinRequestHandler,
-  StoryHandler,
+  StoryHandler
-  PurchasedPaidMediaHandler
 )
 from pyrogram.raw.types import (
     UpdateNewMessage, UpdateNewChannelMessage, UpdateNewScheduledMessage,
@@ -95,12 +93,7 @@ class Dispatcher:
 
     def __init__(self, client: "pyrogram.Client"):
         self.client = client
-        try:
+        self.loop = asyncio.get_event_loop()
-            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 = []
@@ -242,7 +235,7 @@ class Dispatcher:
         async def purchased_paid_media_parser(update, users, chats):
             return (
                 pyrogram.types.PurchasedPaidMedia._parse(self.client, update, users),
-                PurchasedPaidMediaHandler
+                ChatBoostHandler
             )
 
         self.update_parsers = {
@@ -272,7 +265,7 @@ class Dispatcher:
 
     async def start(self):
         if not self.client.no_updates:
-            for _ in range(self.client.workers):
+            for i in range(self.client.workers):
                 self.locks_list.append(asyncio.Lock())
 
                 self.handler_worker_tasks.append(
@@ -343,88 +336,59 @@ class Dispatcher:
     async def handler_worker(self, lock: asyncio.Lock):
         while True:
             packet = await self.updates_queue.get()
-
             if packet is None:
                 break
+            await self._process_packet(packet, lock)
 
-            try:
+    async def _process_packet(
-                await self._handle_packet(packet, lock)
+        self,
-            except pyrogram.StopPropagation:
+        packet: tuple[raw.core.TLObject, dict[int, types.Update], dict[int, types.Update]],
-                pass
+        lock: asyncio.Lock,
-            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):
+            update, users, chats = packet
-                if await handler.check(self.client, parsed_update):
+            parser = self.update_parsers.get(type(update))
-                    return (parsed_update,)
+
-            elif isinstance(handler, RawUpdateHandler):
+            if parser is not None:
-                if await handler.check(self.client, update):
+                parsed_result = parser(update, users, chats)
-                    return (update, users, chats)
+                if inspect.isawaitable(parsed_result):
+                    parsed_update, handler_type = await parsed_result
+                else:
+                    parsed_update, handler_type = parsed_result
+            else:
+                parsed_update, handler_type = (None, type(None))
+
+            async with lock:
+                for group in self.groups.values():
+                    for handler in group:
+                        try:
+                            if parsed_update is not None:
+                                if isinstance(handler, handler_type) and await handler.check(
+                                    self.client, parsed_update
+                                ):
+                                    await self._execute_callback(handler, parsed_update)
+                                    break
+                            elif isinstance(handler, RawUpdateHandler):
+                                await self._execute_callback(handler, update, users, chats)
+                                break
+                        except (pyrogram.StopPropagation, pyrogram.ContinuePropagation) as e:
+                            if isinstance(e, pyrogram.StopPropagation):
+                                raise
+                        except Exception as exception:
+                            if parsed_update is not None:
+                                await self._handle_exception(parsed_update, exception)
+        except pyrogram.StopPropagation:
+            pass
         except Exception as e:
             log.exception(e)
+        finally:
+            self.updates_queue.task_done()
 
-        return None
+    async def _handle_exception(self, parsed_update: types.Update, exception: Exception):
-
-    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(
+                if await error_handler.check(self.client, parsed_update, exception):
-                    self.client, parsed_update, exception,
-                ):
                     handled_error = True
                     break
             except pyrogram.StopPropagation:
@@ -436,3 +400,11 @@ class Dispatcher:
 
         if not handled_error:
             log.exception("Unhandled exception: %s", exception)
+
+    async def _execute_callback(self, handler: Handler, *args):
+        if inspect.iscoroutinefunction(handler.callback):
+            await handler.callback(self.client, *args)
+        else:
+            await self.client.loop.run_in_executor(
+                self.client.executor, handler.callback, self.client, *args
+            )

pyrogram/enums/__init__.py

@@ -26,12 +26,9 @@ 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
@@ -55,12 +52,9 @@ __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,9 +39,3 @@ 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

@@ -1,36 +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 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

@@ -1,35 +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/>.
-
-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,6 +84,3 @@ class MessageMediaType(AutoName):
 
     PAID_MEDIA = auto()
     "Paid media"
-
-    TODO = auto()
-    "To-Do list media"

pyrogram/enums/message_service_type.py

@@ -58,7 +58,7 @@ class MessageServiceType(AutoName):
     GAME_HIGH_SCORE = auto()
     "Game high score"
 
-    CHAT_SHARED = auto()
+    ChatShared = auto()
     "a shared chat/channel/user"
 
     FORUM_TOPIC_CREATED = auto()
@@ -127,17 +127,11 @@ class MessageServiceType(AutoName):
     GIFT_CODE = auto()
     "Gift code"
 
-    GIFT = auto()
+    USER_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,15 +17,9 @@
 #  You should have received a copy of the GNU Lesser General Public License
 #  along with Pyrofork.  If not, see <http://www.gnu.org/licenses/>.
 
-EXCEPTION_AVAIL = False
+from .exceptions import *
-try:
-    from .exceptions import *
-except ImportError:
-    pass
-else:
-    EXCEPTION_AVAIL = True
 from .pyromod import *
-from .rpc_error import RPCError, UnknownError
+from .rpc_error import UnknownError
 
 
 class BadMsgNotification(Exception):
@@ -71,15 +65,3 @@ 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,4 +1,3 @@
-
 #  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>
@@ -251,7 +250,7 @@ react = create(reaction_filter)
 
 # region forwarded_filter
 async def forwarded_filter(_, __, m: Message):
-    return bool(m.forward_origin)
+    return bool(m.forward_date)
 
 
 forwarded = create(forwarded_filter)
@@ -359,11 +358,11 @@ gift_code = create(gift_code_filter)
 """Filter messages that contain :obj:`~pyrogram.types.GiftCode` objects."""
 # endregion
 
-# region star_gift_filter
+# region user_gift
-async def star_gift_filter(_, __, m: Message):
+async def user_gift_filter(_, __, m: Message):
-    return bool(m.gift)
+    return bool(m.user_gift)
-star_gift = create(star_gift_filter)
+user_gift = create(user_gift_filter)
-"""Filter messages that contain :obj:`~pyrogram.types.Gift` objects."""
+"""Filter messages that contain :obj:`~pyrogram.types.UserGift` objects."""
 # endregion
 
 # region video_filter
@@ -796,7 +795,7 @@ from_scheduled = create(from_scheduled_filter)
 
 # region linked_channel_filter
 async def linked_channel_filter(_, __, m: Message):
-    return bool((m.forward_origin and m.forward_origin.chat) and not m.from_user)
+    return bool(m.forward_from_chat and not m.from_user)
 
 
 linked_channel = create(linked_channel_filter)
@@ -890,12 +889,7 @@ 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
 
@@ -909,24 +903,6 @@ 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
@@ -1034,22 +1010,12 @@ 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
@@ -1077,15 +1043,6 @@ 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 (
@@ -1104,17 +1061,8 @@ 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
@@ -1122,10 +1070,7 @@ 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
@@ -1136,7 +1081,6 @@ 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).
     """
 
@@ -1148,6 +1092,4 @@ 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

@@ -33,6 +33,7 @@ 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,31 +42,3 @@ 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,7 +61,6 @@ class ConversationHandler(MessageHandler, CallbackQueryHandler):
         return True
 
     @staticmethod
-    # pylint: disable=method-hidden
     async def callback(_, __):
         pass
 

pyrogram/handlers/deleted_bot_business_messages_handler.py

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

pyrogram/handlers/deleted_messages_handler.py

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

pyrogram/helpers/__init__.py

@@ -13,15 +13,4 @@ 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 isinstance(button_type, str):
+            if button_type == str:
                 button = KeyboardButton(button)
-            elif isinstance(button_type, dict):
+            elif button_type == dict:
                 button = KeyboardButton(**button)
 
             line.append(button)

pyrogram/methods/__init__.py

@@ -23,14 +23,12 @@ 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
@@ -44,9 +42,7 @@ class Methods(
     Password,
     Pyromod,
     Payments,
-    Phone,
     Chats,
-    Forums,
     Stickers,
     Users,
     Messages,

pyrogram/methods/advanced/save_file.py

@@ -23,6 +23,7 @@ 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,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/>.
 
+from .accept_terms_of_service import AcceptTermsOfService
 from .check_password import CheckPassword
 from .connect import Connect
 from .disconnect import Disconnect
@@ -30,11 +31,12 @@ from .send_code import SendCode
 from .send_recovery_code import SendRecoveryCode
 from .sign_in import SignIn
 from .sign_in_bot import SignInBot
-from .sign_in_qrcode import SignInQrcode
+from .sign_up import SignUp
 from .terminate import Terminate
 
 
 class Auth(
+    AcceptTermsOfService,
     CheckPassword,
     Connect,
     Disconnect,
@@ -48,7 +50,7 @@ class Auth(
     SendRecoveryCode,
     SignIn,
     SignInBot,
-    SignInQrcode,
+    SignUp,
     Terminate
 ):
     pass

pyrogram/methods/auth/accept_terms_of_service.py

@@ -21,32 +21,25 @@ import pyrogram
 from pyrogram import raw
 
 
-class ConvertGift:
+class AcceptTermsOfService:
-    async def convert_gift(
+    async def accept_terms_of_service(
         self: "pyrogram.Client",
-        message_id: int
+        terms_of_service_id: str
     ) -> bool:
-        """Convert star gift to stars.
+        """Accept the given terms of service.
 
         .. include:: /_includes/usable-by/users.rst
 
         Parameters:
-            message_id (``int``):
+            terms_of_service_id (``str``):
-                Unique message identifier of star gift.
+                The terms of service identifier.
-
-        Returns:
-            ``bool``: On success, True is returned.
-
-        Example:
-            .. code-block:: python
-
-                # Convert gift
-                app.convert_gift(message_id=123)
         """
         r = await self.invoke(
-            raw.functions.payments.ConvertStarGift(
+            raw.functions.help.AcceptTermsOfService(
-                stargift=raw.types.InputSavedStarGiftUser(msg_id=message_id)
+                id=raw.types.DataJSON(
+                    data=terms_of_service_id
+                )
             )
         )
 
-        return r
+        return bool(r)

pyrogram/methods/auth/connect.py

@@ -35,7 +35,6 @@ 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,7 +30,6 @@ 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,6 +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 typing import List
+
 import pyrogram
 from pyrogram import raw, types
 

pyrogram/methods/auth/initialize.py

@@ -41,7 +41,6 @@ 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,7 +61,6 @@ 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,7 +23,6 @@ from typing import Union
 import pyrogram
 from pyrogram import raw
 from pyrogram import types
-from pyrogram.errors import PhoneNumberUnoccupied
 
 log = logging.getLogger(__name__)
 
@@ -50,13 +49,15 @@ class SignIn:
                 The valid confirmation code you received (either as Telegram message or as SMS in your phone number).
 
         Returns:
-            :obj:`~pyrogram.types.User` | bool: On success, in case the
+            :obj:`~pyrogram.types.User` | :obj:`~pyrogram.types.TermsOfService` | bool: On success, in case the
-            authorization completed, the user is returned.
+            authorization completed, the user is returned. In case the phone number needs to be registered first AND the
+            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(" +")
 
@@ -69,7 +70,10 @@ class SignIn:
         )
 
         if isinstance(r, raw.types.auth.AuthorizationSignUpRequired):
-            raise PhoneNumberUnoccupied("The phone number is not registered on Telegram. Please use official Telegram app to register it.")
+            if r.terms_of_service:
+                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,7 +58,6 @@ 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

@@ -1,111 +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
-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

@@ -0,0 +1,74 @@
+#  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,7 +37,6 @@ 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

@@ -37,7 +37,6 @@ 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(
@@ -61,6 +60,5 @@ class Bots(
     AnswerWebAppQuery,
     GetCollectibleItemInfo,
     GetOwnedBots,
-    GetSimilarBots,
 ):
     pass

pyrogram/methods/bots/get_collectible_item_info.py

@@ -28,24 +28,17 @@ 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_similar_bots.py

@@ -1,46 +0,0 @@
-#  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,11 +17,10 @@
 #  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 datetime import datetime
+from typing import List, Union, Optional
-from typing import Union, List, Optional
 
 import pyrogram
-from pyrogram import raw, enums, types, utils
+from pyrogram import enums, raw, types, utils
 
 
 class SendInlineBotResult:
@@ -30,16 +29,12 @@ class SendInlineBotResult:
         chat_id: Union[int, str],
         query_id: int,
         result_id: str,
-        disable_notification: Optional[bool] = None,
+        disable_notification: bool = None,
-        message_thread_id: Optional[int] = None,
+        message_thread_id: int = None,
-        reply_to_message_id: Optional[int] = None,
+        reply_to_message_id: int = None,
-        reply_to_chat_id: Union[int, str] = None,
+        quote_text: str = None,
-        reply_to_story_id: Optional[int] = None,
+        quote_entities: List["types.MessageEntity"] = None,
-        quote_text: Optional[str] = None,
+        parse_mode: Optional["enums.ParseMode"] = 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`
@@ -65,54 +60,43 @@ 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.
 
-            reply_to_chat_id (``int``, *optional*):
-                If the message is a reply, ID of the original chat.
-
-            reply_to_story_id (``int``, *optional*):
-                If the message is a reply, ID of the target story.
-
             quote_text (``str``, *optional*):
-                Text of the quote to be sent.
+                Text to quote.
-
+                for reply_to_message only.
-            parse_mode (:obj:`~pyrogram.enums.ParseMode`, *optional*):
-                By default, texts are parsed using both Markdown and HTML styles.
-                You can combine both syntaxes together.
 
             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*.
+                List of special entities that appear in quote_text, which can be specified instead of *parse_mode*.
+                for reply_to_message only.
 
-            quote_offset (``int``, *optional*):
+            parse_mode (:obj:`~pyrogram.enums.ParseMode`, *optional*):
-                Offset for quote in original message.
+                By default, quote_text are parsed using both Markdown and HTML styles.
-
+                You can combine both syntaxes together.
-            schedule_date (:py:obj:`~datetime.datetime`, *optional*):
+                For quote_text.
-                Date when the message will be automatically sent.
 
         Returns:
-            :obj:`~pyrogram.types.Message`: On success, the sent message is returned or False if no message was sent.
+            :obj:`~pyrogram.types.Message`: On success, the sent message is returned.
 
         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,
-            quote_offset=quote_offset,
+            parse_mode=parse_mode
-            parse_mode=parse_mode,
         )
+
         r = await self.invoke(
             raw.functions.messages.SendInlineBotResult(
                 peer=await self.resolve_peer(chat_id),
@@ -120,19 +104,15 @@ 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,6 +1,5 @@
 #  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.
 #
@@ -18,21 +17,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_business_account_gifts import GetBusinessAccountGifts
+from .get_available_gifts import GetAvailableGifts
-from .get_business_account_star_balance import GetBusinessAccountStarBalance
+from .get_user_gifts import GetUserGifts
-from .transfer_business_account_stars import TransferBusinessAccountStars
+from .sell_gift import SellGift
+from .send_gift import SendGift
+from .toggle_gift_is_saved import ToggleGiftIsSaved
 
 
 class TelegramBusiness(
     AnswerPreCheckoutQuery,
-    AnswerShippingQuery,
-    DeleteBusinessMessages,
     GetBusinessConnection,
-    GetBusinessAccountGifts,
+    GetAvailableGifts,
-    GetBusinessAccountStarBalance,
+    GetUserGifts,
-    TransferBusinessAccountStars,
+    SellGift,
+    SendGift,
+    ToggleGiftIsSaved,
 ):
     pass

pyrogram/methods/business/delete_business_messages.py

@@ -1,71 +0,0 @@
-#  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_available_gifts.py

@@ -1,6 +1,5 @@
 #  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.
 #
@@ -16,27 +15,30 @@
 #
 #  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
 
-from enum import auto
+import pyrogram
-
+from pyrogram import raw, types
-from .auto_name import AutoName
 
 
-class MessageOriginType(AutoName):
+class GetAvailableGifts:
-    """Message origin type enumeration used in :obj:`~pyrogram.types.MessageOrigin`."""
+    async def get_available_gifts(
+        self: "pyrogram.Client",
+    ) -> List["types.Gift"]:
+        """Get all gifts that can be sent to other users.
 
-    CHANNEL = auto()
+        .. include:: /_includes/usable-by/users.rst
-    "The message was originally a post in a channel"
 
-    CHAT = auto()
+        Returns:
-    "The message was originally sent on behalf of a chat"
+            List of :obj:`~pyrogram.types.Gift`: On success, a list of star gifts is returned.
 
-    HIDDEN_USER = auto()
+        Example:
-    "The message was originally sent by a user, which is hidden by their privacy settings"
+            .. code-block:: python
 
-    IMPORT = auto()
+                app.get_available_gifts()
-    "The message was imported from a foreign chat service"
+        """
+        r = await self.invoke(
+            raw.functions.payments.GetStarGifts(hash=0)
+        )
 
-
+        return types.List([await types.Gift._parse(self, gift) for gift in r.gifts])
-    USER = auto()
-    "The message was originally sent by a known user"

pyrogram/methods/business/get_business_account_gifts.py

@@ -1,129 +0,0 @@
-#  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

@@ -1,61 +0,0 @@
-#  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,8 +16,11 @@
 #  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, raw
+from pyrogram import types, utils, raw
 
 
 class GetBusinessConnection:

pyrogram/methods/business/get_user_gifts.py

@@ -0,0 +1,97 @@
+#  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

@@ -0,0 +1,67 @@
+#  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

@@ -0,0 +1,105 @@
+#  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/toggle_gift_is_saved.py

@@ -1,88 +1,71 @@
-#  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 Union
+
-
+from typing import Union
-import pyrogram
+
-from pyrogram import errors, raw
+import pyrogram
-
+from pyrogram import raw
-
+
-class TransferGift:
+
-    async def transfer_gift(
+class ToggleGiftIsSaved:
-        self: "pyrogram.Client",
+    async def toggle_gift_is_saved(
-        message_id: int,
+        self: "pyrogram.Client",
-        to_chat_id: Union[int, str],
+        sender_user_id: Union[int, str],
-    ) -> bool:
+        message_id: int,
-        """Transfer star gift to another user.
+        is_saved: bool
-
+    ) -> bool:
-        .. include:: /_includes/usable-by/users.rst
+        """Toggles whether a gift is shown on the current user's profile page.
-
+
-        Parameters:
+        .. include:: /_includes/usable-by/users.rst
-            message_id (``int``):
+
-                Unique message identifier of star gift.
+        Parameters:
-
+            sender_user_id (``int`` | ``str``):
-            to_chat_id (``int`` | ``str``):
+                Unique identifier (int) or username (str) of the target user that sent the gift.
-                Unique identifier (int) or username (str) of the target chat you want to transfer the star gift to.
+                For your personal cloud (Saved Messages) you can simply use "me" or "self".
-                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).
-                For a contact that exists in your Telegram address book you can use his phone number (str).
+
-
+            message_id (``int``):
-        Returns:
+                Unique message identifier of the message with the gift in the chat with the user.
-            ``bool``: On success, True is returned.
+
-
+            is_saved (``bool``):
-        Example:
+                Pass True to display the gift on the user's profile page; pass False to remove it from the profile page.
-            .. code-block:: python
+
-
+        Returns:
-                # Transfer gift to another user
+            ``bool``: On success, True is returned.
-                app.transfer_gift(message_id=123, to_chat_id=123)
+
-        """
+        Example:
-        peer = await self.resolve_peer(to_chat_id)
+            .. code-block:: python
-
+
-        if not isinstance(peer, (raw.types.InputPeerUser, raw.types.InputPeerSelf)):
+                # Hide gift
-            raise ValueError("chat_id must belong to a user.")
+                app.toggle_gift_is_saved(sender_user_id=user_id, message_id=123, is_saved=False)
-
+        """
-        try:
+        peer = await self.resolve_peer(sender_user_id)
-            await self.invoke(
+
-                raw.functions.payments.TransferStarGift(
+        if not isinstance(peer, (raw.types.InputPeerUser, raw.types.InputPeerSelf)):
-                    stargift=raw.types.InputSavedStarGiftUser(
+            raise ValueError("sender_user_id must belong to a user.")
-                        msg_id=message_id
+
-                    ),
+        r = await self.invoke(
-                    to_id=peer
+            raw.functions.payments.SaveStarGift(
-                )
+                user_id=peer,
-            )
+                msg_id=message_id,
-        except errors.PaymentRequired:
+                unsave=not is_saved
-            invoice = raw.types.InputInvoiceStarGiftTransfer(
+            )
-                stargift=raw.types.InputSavedStarGiftUser(
+        )
-                    msg_id=message_id
+
-                ),
+        return r
-                to_id=peer
-            )
-
-            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

@@ -1,72 +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/>.
-
-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,14 +21,24 @@ 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
@@ -38,6 +48,8 @@ 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
@@ -54,7 +66,6 @@ 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
@@ -85,16 +96,28 @@ 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,
@@ -105,7 +128,6 @@ class Chats(
     GetSendAsChats,
     SetSendAsChat,
     SetChatProtectedContent,
-    TransferChatOwnership,
     UpdateColor,
     UpdateFolder
 ):

pyrogram/methods/chats/ban_chat_member.py

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

pyrogram/methods/chats/close_forum_topic.py

@@ -15,9 +15,9 @@
 #
 #  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 pyrogram
 from pyrogram import raw
+from pyrogram import types
 from typing import Union
 
 
@@ -48,7 +48,7 @@ class CloseForumTopic:
                 await app.close_forum_topic(chat_id, topic_id)
         """
         await self.invoke(
-            raw.functions.messages.EditForumTopic(
+            raw.functions.channels.EditForumTopic(
                 channel=await self.resolve_peer(chat_id),
                 topic_id=topic_id,
                 closed=True

pyrogram/methods/chats/close_general_topic.py

@@ -15,9 +15,9 @@
 #
 #  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 pyrogram
 from pyrogram import raw
+from pyrogram import types
 from typing import Union
 
 
@@ -44,7 +44,7 @@ class CloseGeneralTopic:
                 await app.close_general_topic(chat_id)
         """
         await self.invoke(
-            raw.functions.messages.EditForumTopic(
+            raw.functions.channels.EditForumTopic(
                 channel=await self.resolve_peer(chat_id),
                 topic_id=1,
                 closed=True

pyrogram/methods/chats/create_forum_topic.py

@@ -56,7 +56,7 @@ class CreateForumTopic:
                 await app.create_forum_topic("Topic Title")
         """
         r = await self.invoke(
-            raw.functions.messages.CreateForumTopic(
+            raw.functions.channels.CreateForumTopic(
                 channel=await self.resolve_peer(chat_id),
                 title=title,
                 random_id=self.rnd_id(),

pyrogram/methods/chats/delete_forum_topic.py

@@ -15,9 +15,9 @@
 #
 #  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 pyrogram
 from pyrogram import raw
+from pyrogram import types
 from typing import Union
 
 
@@ -49,7 +49,7 @@ class DeleteForumTopic:
         """
         try:
             await self.invoke(
-                raw.functions.messages.DeleteTopicHistory(
+                raw.functions.channels.DeleteTopicHistory(
                     channel=await self.resolve_peer(chat_id),
                     top_msg_id=topic_id
                 )

pyrogram/methods/chats/edit_forum_topic.py

@@ -15,9 +15,9 @@
 #
 #  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 pyrogram
 from pyrogram import raw
+from pyrogram import types
 from typing import Union
 
 
@@ -56,7 +56,7 @@ class EditForumTopic:
                 await app.edit_forum_topic(chat_id,topic_id,"New Topic Title")
         """
         await self.invoke(
-            raw.functions.messages.EditForumTopic(
+            raw.functions.channels.EditForumTopic(
                 channel=await self.resolve_peer(chat_id),
                 topic_id=topic_id,
                 title=title,

pyrogram/methods/chats/edit_general_topic.py

@@ -15,9 +15,9 @@
 #
 #  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 pyrogram
 from pyrogram import raw
+from pyrogram import types
 from typing import Union
 
 
@@ -48,7 +48,7 @@ class EditGeneralTopic:
                 await app.edit_general_topic(chat_id,"New Topic Title")
         """
         await self.invoke(
-            raw.functions.messages.EditForumTopic(
+            raw.functions.channels.EditForumTopic(
                 channel=await self.resolve_peer(chat_id),
                 topic_id=1,
                 title=title

pyrogram/methods/chats/export_folder_link.py

@@ -25,7 +25,7 @@ class ExportFolderLink:
     async def export_folder_link(
         self: "pyrogram.Client",
         folder_id: int
-    ) -> "pyrogram.types.ExportedFolderLink":
+    ) -> str:
         """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:
-            :obj:`~pyrogram.types.ExportedFolderLink` objects.
+            ``str``: On success, a link to the folder as string is returned.
 
         Example:
             .. code-block:: python
@@ -67,4 +67,4 @@ class ExportFolderLink:
             )
         )
 
-        return types.ExportedFolderLink._parse(r)
+        return r.invite.url

pyrogram/methods/chats/get_chat_member.py

@@ -77,7 +77,8 @@ class GetChatMember:
                 else:
                     if member.user.id == user.user_id:
                         return member
-            raise UserNotParticipant
+            else:
+                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, PeerIdInvalid
+from pyrogram.errors import ChannelPrivate
 
 
 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, PeerIdInvalid):
+                except ChannelPrivate:
                     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/get_forum_topics.py

@@ -23,16 +23,18 @@ from typing import Union, Optional, AsyncGenerator
 import pyrogram
 from pyrogram import raw
 from pyrogram import types
+from pyrogram import utils
 
 log = logging.getLogger(__name__)
 
 
-class GetForumTopicsCount:
+class GetForumTopics:
-    async def get_forum_topics_count(
+    async def get_forum_topics(
         self: "pyrogram.Client",
-        chat_id: Union[int, str]
+        chat_id: Union[int, str],
+        limit: int = 0
     ) -> Optional[AsyncGenerator["types.ForumTopic", None]]:
-        """Get forum topics count from a chat.
+        """Get one or more topic from a chat.
 
         .. include:: /_includes/usable-by/users.rst
 
@@ -41,14 +43,18 @@ class GetForumTopicsCount:
                 Unique identifier (int) or username (str) of the target chat.
                 You can also use chat public link in form of *t.me/<username>* (str).
 
+            limit (``int``, *optional*):
+                Limits the number of topics to be retrieved.
+
         Returns:
-            ``int``: On success, the count of forum topics is returned.
+            ``Generator``: On success, a generator yielding :obj:`~pyrogram.types.ForumTopic` objects is returned.
 
         Example:
             .. code-block:: python
 
-                # get all forum topics count
+                # get all forum topics
-                app.get_forum_topics_count(chat_id)
+                async for topic in app.get_forum_topics(chat_id):
+                    print(topic)
 
         Raises:
             ValueError: In case of invalid arguments.
@@ -56,8 +62,9 @@ class GetForumTopicsCount:
 
         peer = await self.resolve_peer(chat_id)
 
-        rpc = raw.functions.messages.GetForumTopics(channel=peer, offset_date=0, offset_id=0, offset_topic=0, limit=0)
+        rpc = raw.functions.channels.GetForumTopics(channel=peer, offset_date=0, offset_id=0, offset_topic=0, limit=limit)
 
         r = await self.invoke(rpc, sleep_threshold=-1)
 
-        return r.count
+        for _topic in r.topics:
+            yield types.ForumTopic._parse(_topic)

pyrogram/methods/chats/get_forum_topics_by_id.py

@@ -23,6 +23,7 @@ from typing import Union, List, Iterable
 import pyrogram
 from pyrogram import raw
 from pyrogram import types
+from pyrogram import utils
 
 log = logging.getLogger(__name__)
 
@@ -62,7 +63,7 @@ class GetForumTopicsByID:
         Raises:
             ValueError: In case of invalid arguments.
         """
-        ids, _ = (
+        ids, ids_type = (
             (topic_ids, int) if topic_ids
             else (None, None)
         )
@@ -76,7 +77,7 @@ class GetForumTopicsByID:
         ids = list(ids) if is_iterable else [ids]
         ids = [i for i in ids]
 
-        rpc = raw.functions.messages.GetForumTopicsByID(channel=peer, topics=ids)
+        rpc = raw.functions.channels.GetForumTopicsByID(channel=peer, topics=ids)
 
         r = await self.invoke(rpc, sleep_threshold=-1)