telegrinder 0.4.1__tar.gz → 0.5.0__tar.gz

telegrinder-0.5.0/.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

telegrinder-0.5.0/.github/ISSUE_TEMPLATE/bug.md

@@ -0,0 +1,23 @@
+---
+name: "\U0001F41B Bug report \U0001F41B"
+about: "Reporting a bug."
+title: "bug: "
+labels: ["bug"]
+assignees: []
+---
+
+**bug description:**
+...
+
+**code:**
+<!--  Provide a minimal example to reproduce -->
+```python
+import telegrinder
+```
+
+**logs:**
+<!-- Provide logs/errors if applicable-->
+```console
+Traceback (most recent call last):
+File "main.py", line 1, in <module>
+```

telegrinder-0.5.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: 💬 Telegram chat 💬
+    url: https://t.me/botoforum
+    about: ✏️ You can ask questions about the framework. ✏️

telegrinder-0.5.0/.github/ISSUE_TEMPLATE/feat_request.md

@@ -0,0 +1,16 @@
+---
+name: "\U0001F680 Feature request \U0001F680"
+about: "Creating a feature request."
+title: "feature: "
+labels: ["feature request"]
+assignees: []
+---
+
+**feature description:**
+...
+
+**code:**
+<!-- A small code sample that will demonstrate your feature. -->
+```python
+from telegrinder import MyFeature
+```

telegrinder-0.5.0/.github/actions/install-dependencies/action.yml

@@ -0,0 +1,21 @@
+name: Install uv and dependencies
+
+inputs:
+  python-version:
+    description: "Python version."
+    required: false
+    default: "3.12"
+
+runs:
+  using: composite
+  steps:
+    - uses: hynek/setup-cached-uv@v2
+      with:
+        cache-suffix: -${{ inputs.python-version }}-cache
+        cache-dependency-path: "**/uv.lock"
+
+    - name: "Install dependencies"
+      run: |
+        uv venv --python ${{ inputs.python-version }}
+        uv sync --all-groups --dev
+      shell: bash

telegrinder-0.5.0/.github/dependabot.yaml

@@ -0,0 +1,11 @@
+version: 2
+
+updates:
+  - package-ecosystem: pip
+    directory: "/"
+    schedule:
+      interval: "daily"
+    allow:
+      - dependency-type: "direct"
+    open-pull-requests-limit: 4
+    target-branch: "dev"

telegrinder-0.5.0/.github/pull_request_template.md

@@ -0,0 +1,18 @@
+### ✏️ Description ✏️
+<!--
+Please include a summary of the change and which issue is fixed. Please also include relevant motivation and context.
+-->
+_No response_
+
+`🐛 Fixes # (issue)`
+
+### 📍 Type of change 📍
+- [ ] 🐛 Bug fix (non-breaking change which fixes an issue) 🐛
+- [ ] 🚀 New feature (non-breaking change which adds functionality) 🚀
+- [ ] ⚡ Breaking change (fix or feature that would cause existing functionality not to work as expected) ⚡
+- [ ] 📝 This change requires a documentation update 📝
+
+### ⚪️ Checklist ⚪️
+* [ ] 📝 Your code has documentation 📝
+* [ ] 🔧 Your code has tests 🔧
+* [ ] 🪄 Your code has example usage in `/examples` 🪄

telegrinder-0.5.0/.github/workflows/ci.yml

@@ -0,0 +1,85 @@
+name: CI
+
+'on':
+  workflow_call:
+    inputs:
+      os:
+        description: "Operating system"
+        required: true
+        type: string
+      python-version:
+        description: "Python version"
+        required: true
+        type: string
+
+defaults:
+  run:
+    shell: bash
+
+jobs:
+  lock-file:
+    name: "Lock uv"
+    runs-on: ${{ inputs.os }}
+    steps:
+      - uses: asottile/workflows/.github/actions/fast-checkout@v1.8.1
+
+      - uses: ./.github/actions/install-dependencies
+        with:
+          python-version: ${{ inputs.python-version }}
+
+      - run: uv lock --locked
+
+  linting:
+    name: "Linting"
+    runs-on: ${{ inputs.os }}
+    needs: lock-file
+    steps:
+      - uses: asottile/workflows/.github/actions/fast-checkout@v1.8.1
+
+      - uses: ./.github/actions/install-dependencies
+        with:
+          python-version: ${{ inputs.python-version }}
+
+      - name: Load ruff cache
+        id: cached-ruff
+        uses: actions/cache@v4
+        with:
+          key: ruff-${{ inputs.python-version }}-${{ runner.os }}-${{ hashFiles('pyproject.toml') }}
+          path: .ruff_cache
+
+      - name: "Run ruff"
+        run: uvx ruff check .
+
+  type-checking:
+    name: "Type-checking"
+    runs-on: ${{ inputs.os }}
+    needs: lock-file
+    steps:
+      - uses: asottile/workflows/.github/actions/fast-checkout@v1.8.1
+
+      - uses: ./.github/actions/install-dependencies
+        with:
+          python-version: ${{ inputs.python-version }}
+
+      - run: uv run basedpyright --level ERROR
+
+  tests:
+    name: "Testing"
+    runs-on: ${{ inputs.os }}
+    needs: lock-file
+    steps:
+      - uses: asottile/workflows/.github/actions/fast-checkout@v1.8.1
+
+      - uses: ./.github/actions/install-dependencies
+        with:
+          python-version: ${{ inputs.python-version }}
+
+      - name: Load pytest cache
+        id: cached-pytest
+        uses: actions/cache@v4
+        with:
+          key: pytest-${{ inputs.python-version }}-${{ runner.os }}
+          path: .pytest_cache
+
+      - name: "Run pytest"
+        run: uv run pytest --cov

telegrinder-0.5.0/.github/workflows/pull_request.yml

@@ -0,0 +1,40 @@
+name: PR
+
+'on':
+  pull_request:
+    branches:
+    - tba
+    - dev
+    - main
+
+defaults:
+  run:
+    shell: bash
+
+jobs:
+  pre-commit:
+    name: "Run pre-commit"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: asottile/workflows/.github/actions/fast-checkout@v1.8.1
+
+      - name: Install uv and dependencies
+        uses: ./.github/actions/install-dependencies
+        with:
+          python-version: "3.13"
+
+      - name: Load pre-commit cache
+        id: cache-pre-commit
+        uses: actions/cache@v4
+        env:
+          cache-name: cache-pre-commit
+        with:
+          key: ${{ env.cache-name }}-${{ hashFiles('**/.pre-commit-config.yaml', '~/.cache/pre-commit/*') }}
+          path: ~/.cache/pre-commit
+
+      - name: Run pre-commit
+        run: uv run pre-commit run --all-files --color=always
+
+      - uses: pre-commit/action@v3.0.1
+      - uses: pre-commit-ci/lite-action@v1.1.0
+        if: always()

telegrinder-0.5.0/.github/workflows/push.yml

@@ -0,0 +1,28 @@
+name: Push
+
+'on':
+  push:
+    branches:
+      - dev
+      - main
+
+defaults:
+  run:
+    shell: bash
+
+jobs:
+  ci:
+    name: "CI (Push)"
+    strategy:
+      matrix:
+        python-version:
+          - "3.12"
+          - "3.13"
+        os:
+          - ubuntu-latest
+          - windows-latest
+
+    uses: ./.github/workflows/ci.yml
+    with:
+      os: ${{ matrix.os }}
+      python-version: ${{ matrix.python-version }}

telegrinder-0.5.0/.github/workflows/release.yml

@@ -0,0 +1,53 @@
+name: Release to PyPI
+
+'on':
+  release:
+    types:
+      - created
+
+defaults:
+  run:
+    shell: bash
+
+jobs:
+  build:
+    name: "Build distribution"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: asottile/workflows/.github/actions/fast-checkout@v1.8.1
+
+      - uses: ./.github/actions/install-dependencies
+        with:
+          python-version: "3.13"
+
+      - name: "Build distribution"
+        run: uv build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: release-dist
+          path: dist/
+
+  pypi-publish:
+    name: "Publish to PyPI"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: asottile/workflows/.github/actions/fast-checkout@v1.8.1
+
+      - name: Download artifact with distribution
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dist
+          path: dist/
+
+      - name: Release distribution
+        uses: actions/checkout@v2
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          tag: ${{ github.event.release.tag_name }}
+          files: dist/
+
+      - name: Publish distribution to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

telegrinder-0.5.0/.github/workflows/typegen.yml

@@ -0,0 +1,49 @@
+name: Telegram Bot API schema
+
+on:
+  workflow_dispatch: {}
+  schedule:
+    - cron: "0 16 * * *"
+
+jobs:
+  lock-file:
+    name: "Lock uv"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: ./.github/actions/install-dependencies
+        with:
+          python-version: "3.13"
+
+      - run: uv lock --locked
+
+  generation:
+    name: "TBA schema generation"
+    runs-on: ubuntu-latest
+    needs: lock-file
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: ./.github/actions/install-dependencies
+        with:
+          python-version: "3.13"
+
+      - name: "Run generator"
+        run: uv run typegen
+
+      - name: "Create PR"
+        uses: peter-evans/create-pull-request@v7
+        with:
+          author: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
+          commit-message: >
+            types: Telegram Bot API schema changes
+          title: >
+            Update Telegram Bot API to the latest schema
+          body: >
+            This is an automated PR. Please check the diff, and the action logs, to check for any funky behavior.
+          branch: automated/tba
+          reviewers: luwqz1
+          assignees: luwqz1
+          labels: automated, TBA
+          delete-branch: true

telegrinder-0.5.0/.gitignore

@@ -0,0 +1,148 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+.idea
+*.iml
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+venv/*
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# Mac OS trash
+.DS_Store
+
+# Test databases
+*.db
+.db
+*.db-shm
+*.db-wal
+
+# pytest
+.pytest_cache
+
+# ruff
+.ruff_cache
+
+.vscode
+local
+
+pyvenv.cfg
+
+.basedpyright

telegrinder-0.5.0/.pre-commit-config.yaml

@@ -0,0 +1,73 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: check-merge-conflict
+        stages: [ pre-commit, pre-push ]
+      - id: check-ast
+        stages: [ pre-commit ]
+      - id: trailing-whitespace
+        stages: [ pre-commit ]
+      - id: end-of-file-fixer
+        stages: [ pre-commit ]
+
+  - repo: local
+    hooks:
+      - id: uv
+        name: uv-lock
+        description: "Run uv lock"
+        entry: uv lock --locked
+        language: system
+        pass_filenames: false
+        types: [ python ]
+        stages: [ pre-commit ]
+
+      - id: basedpyright
+        name: basedpyright
+        description: "Run 'basedpyright' for Python type checking"
+        entry: uv run basedpyright --level error
+        pass_filenames: false
+        language: system
+        types: [ python ]
+        stages: [ pre-commit ]
+
+      - id: pytest
+        name: pytest
+        description: "Run tests for testing code"
+        entry: uv run pytest tests
+        language: system
+        pass_filenames: false
+        types: [ python ]
+        stages: [ pre-commit ]
+
+      - id: ruff
+        name: ruff-isort
+        description: "Run 'ruff check --select I --select F401 --fix' for extremely fast Python sorting imports"
+        entry: uv run ruff check --select I --select F401 --fix
+        language: system
+        types: [ python ]
+        stages: [ pre-commit ]
+
+      - id: ruff
+        name: ruff-sortall
+        description: "Run 'ruff check --select RUF022 --fix' for extremely fast Python sorting dunder alls"
+        entry: uv run ruff check --select RUF022 --fix
+        language: system
+        types: [ python ]
+        stages: [ pre-commit ]
+
+      - id: ruff
+        name: ruff-format
+        description: "Run 'ruff format' for extremely fast Python formatting"
+        entry: uv run ruff format
+        language: system
+        types: [ python ]
+        stages: [ pre-commit ]
+
+      - id: ruff
+        name: ruff-check
+        description: "Run 'ruff check --fix' for extremely fast Python linting"
+        entry: uv run ruff check --fix
+        language: system
+        types: [ python ]
+        stages: [ pre-commit ]

telegrinder-0.5.0/.readthedocs.yaml

@@ -0,0 +1,13 @@
+version: 2
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.9"
+  commands:
+    - pip install mkdocs mkdocs-material mkdocs-redirects
+    - cat mkdocs.yml
+    - mkdocs build --clean --site-dir $READTHEDOCS_OUTPUT/html --config-file mkdocs.yml
+
+mkdocs:
+  configuration: mkdocs.yml

{telegrinder-0.4.1 → telegrinder-0.5.0}/LICENSE

@@ -1,7 +1,7 @@
 MIT License
 
-Copyright (c) 2022-2025 timoniq
-Copyright (c) 2024-2025 luwqz1
+Copyright (c) 2022 timoniq
+Copyright (c) 2024 luwqz1
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal