Merge pull request #163 from david-lev/dev

Dev

Author: david-lev

.github/scripts/send_release_to_telegram.py

@@ -1,5 +1,6 @@
-import os
 import asyncio
+import logging
+import os
 
 from pyrogram import Client, types
 
@@ -65,7 +66,7 @@ async def send_to_telegram():
     release_body = os.getenv("RELEASE_BODY")
 
     message = format_release_message(release_tag, release_name, release_body)
-    print(message)
+    logging.info("Formatted message:\n%s", message)
 
     bot = Client(name="pywa_bot", api_id=api_id, api_hash=api_hash, bot_token=bot_token)
 

.github/workflows/lint.yml

@@ -1,25 +1,27 @@
-# This workflow copied from https://packaging.python.org/en/latest/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows/#the-whole-ci-cd-workflow
-
 name: Publish Python Package to PyPI
 
 on:
-  release:
-    types: [published]
+  workflow_run:
+    workflows: [ "tests" ]
+    types: [ completed ]
 
 jobs:
   build:
     name: Build distribution 📦
+    if: >
+      github.event.workflow_run.conclusion == 'success' &&
+      github.event.workflow_run.event == 'release'
     runs-on: ubuntu-latest
     permissions:
       contents: read
       actions: write
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           persist-credentials: false
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.x"
       - name: Install pypa/build
@@ -31,15 +33,16 @@ jobs:
       - name: Build a binary wheel and a source tarball
         run: python3 -m build
       - name: Store the distribution packages
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v5
         with:
           name: python-package-distributions
           path: dist/
 
+
   publish-to-pypi:
     name: >-
-      Publish Python Package to PyPI
-
+      Publish Python 🐍 distribution 📦 to PyPI
+    if: startsWith(github.ref, 'refs/tags/')  # only publish to PyPI on tag pushes
     needs:
       - build
     runs-on: ubuntu-latest
@@ -51,7 +54,7 @@ jobs:
 
     steps:
       - name: Download all the dists
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v6
         with:
           name: python-package-distributions
           path: dist/

.github/workflows/publish.yml

@@ -1,24 +1,31 @@
 name: Tests with pytest
 
-on: [ push, pull_request ]
+on:
+  push:
+  pull_request:
+  release:
+    types: [ published ]
 
 permissions:
   contents: read
 
 jobs:
-  build:
+  tests:
+    name: Tests with pytest
     runs-on: ${{ matrix.os }}
     strategy:
+      fail-fast: false
       matrix:
         os: [ ubuntu-latest, macos-latest, windows-latest ]
-        python-version: [ '3.10', '3.11', '3.12', '3.13' ]
+        python-version: [ '3.10', '3.11', '3.12', '3.13', '3.14' ]
 
     steps:
       - uses: actions/checkout@v4
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
+          cache: pip
 
       - name: Install dependencies
         run: |
@@ -27,9 +34,3 @@ jobs:
 
       - name: Run tests
         run: pytest
-#        run: pytest --cov --cov-report=xml
-#
-#      - name: Upload results to Codecov
-#        uses: codecov/codecov-action@v5
-#        with:
-#          token: ${{ secrets.CODECOV_TOKEN }}

.github/workflows/tests.yml

@@ -1,5 +1,10 @@
 # See https://pre-commit.com for more information
 # See https://pre-commit.com/hooks.html for more hooks
+
+ci:
+  autoupdate_branch: dev
+  autoupdate_schedule: quarterly
+
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v6.0.0
@@ -8,9 +13,17 @@ repos:
       - id: end-of-file-fixer
       - id: check-yaml
       - id: check-added-large-files
+      - id: check-executables-have-shebangs
+      - id: check-illegal-windows-names
+      - id: check-json
+#      - id: detect-private-key
+#      - id: pretty-format-json
+#        args: [ --autofix ]
+
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.14.3
+    rev: v0.14.10
     hooks:
-      - id: ruff
+      - id: ruff-check
+        args: [ --fix ]
       - id: ruff-format

.pre-commit-config.yaml

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 David Lev
+Copyright (c) 2026 David Lev
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

LICENSE

@@ -1,6 +1,6 @@
 sphinx-book-theme==1.1.4
 sphinx-copybutton==0.5.2
-sphinxext-opengraph==0.12.0
+sphinxext-opengraph==0.13.0
 sphinx-togglebutton==0.3.2
 myst-parser==4.0.1
 sphinxcontrib-googleanalytics==0.5

docs/requirements.txt

@@ -50,6 +50,9 @@ Others
 .. autoclass:: ConversationalAutomation()
 
 .. autoclass:: QRCode()
+    :members: fetch_image, update, delete
+
+.. autoclass:: QRCodeImageType()
 
 .. autoclass:: Command()
 

docs/source/content/types/others.rst

@@ -50,8 +50,27 @@ cryptography = ["cryptography"]
 "Funding" = "https://github.com/sponsors/david-lev"
 "Changelog" = "https://github.com/david-lev/pywa/blob/master/CHANGELOG.md"
 
+
+[tool.ruff]
+extend-exclude = [
+    "pywa*/__init__.py",
+]
+
 [tool.ruff.lint]
-ignore = ["E731", "F401", "E402", "F405"]
+select = [
+    "E4",
+    "E7",
+    "E9",
+    "F",
+    "T",
+    "B",
+    "C4",
+    "I",
+]
+ignore = [
+    "E402",
+    "F405",
+]
 
 
 [tool.coverage.run]

pyproject.toml

@@ -27,41 +27,42 @@
 import threading
 from concurrent import futures
 from typing import (
+    TYPE_CHECKING,
     Any,
+    AsyncIterable,
+    AsyncIterator,
     BinaryIO,
     Iterable,
-    TYPE_CHECKING,
-    NamedTuple,
-    Literal,
     Iterator,
-    AsyncIterable,
-    AsyncIterator,
+    Literal,
+    NamedTuple,
 )
 
 import httpx
 
+from pywa.types.others import InteractiveType
+
 from .types import (
-    FlowMetricName,
-    FlowMetricGranularity,
-    FlowJSON,
+    Button,
+    ButtonUrl,
     CallbackData,
+    CallPermissionRequestButton,
+    FlowButton,
+    FlowJSON,
+    FlowMetricGranularity,
+    FlowMetricName,
+    SectionList,
     URLButton,
     VoiceCallButton,
-    SectionList,
-    FlowButton,
-    Button,
-    CallPermissionRequestButton,
-    ButtonUrl,
 )
-from pywa.types.others import InteractiveType
 from .types.media import Media
 from .types.templates import (
+    BaseParams,
+    Carousel,
+    HeaderFormatType,
     TemplateBaseComponent,
     _BaseMediaHeaderComponent,
-    HeaderFormatType,
-    Carousel,
     _BaseMediaParams,
-    BaseParams,
 )
 
 if TYPE_CHECKING:
@@ -382,12 +383,13 @@ def get_media_from_file_like_obj(
     try:
         length = os.fstat(file_obj.fileno()).st_size
     except (AttributeError, OSError):
-        pos = file_obj.tell()
-        file_obj.seek(0, io.SEEK_END)
-        length = file_obj.tell()
-        file_obj.seek(pos)
-    except (AttributeError, OSError):
-        length = None
+        try:
+            pos = file_obj.tell()
+            file_obj.seek(0, io.SEEK_END)
+            length = file_obj.tell()
+            file_obj.seek(pos)
+        except (AttributeError, OSError):
+            length = None
     filename = getattr(file_obj, "name", None)
     return MediaInfo(
         content=file_obj,
@@ -458,6 +460,7 @@ def internal_upload_media(
     media_type: str | None,
     mime_type: str | None,
     filename: str | None,
+    ttl_minutes: int | None = None,
     download_chunk_size: int | None,
     wa: WhatsApp,
     phone_id: str,
@@ -526,9 +529,11 @@ def internal_upload_media(
                 or media_info.mime_type
                 or _media_types_default_mime_types.get(media_type, "text/plain"),
                 filename=final_filename,
+                ttl_minutes=ttl_minutes,
             )["id"],
             uploaded_to=phone_id,
             filename=final_filename,
+            ttl_minutes=ttl_minutes,
         )
 
     finally: