Merge branch 'main' into dependabot/github_actions/actions/upload-artifact-6

Author: svlandeg

.github/workflows/pre-commit.yml

@@ -7,7 +7,8 @@ on:
       - synchronize
 
 env:
-  IS_FORK: ${{ github.event.pull_request.head.repo.full_name != github.repository }}
+  # Forks and Dependabot don't have access to secrets
+  HAS_SECRETS: ${{ secrets.PRE_COMMIT != '' }}
 
 jobs:
   pre-commit:
@@ -19,16 +20,23 @@ jobs:
         run: echo "$GITHUB_CONTEXT"
       - uses: actions/checkout@v6
         name: Checkout PR for own repo
-        if: env.IS_FORK == 'false'
+        if: env.HAS_SECRETS == 'true'
         with:
-          # To be able to commit it needs more than the last commit
+          # To be able to commit it needs to fetch the head of the branch, not the
+          # merge commit
           ref: ${{ github.head_ref }}
+           # And it needs the full history to be able to compute diffs
+          fetch-depth: 0
           # A token other than the default GITHUB_TOKEN is needed to be able to trigger CI
           token: ${{ secrets.PRE_COMMIT }}
       # pre-commit lite ci needs the default checkout configs to work
       - uses: actions/checkout@v6
         name: Checkout PR for fork
-        if: env.IS_FORK == 'true'
+        if: env.HAS_SECRETS == 'false'
+        with:
+        # To be able to commit it needs the head branch of the PR, the remote one
+          ref: ${{ github.event.pull_request.head.sha }}
+          fetch-depth: 0
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
@@ -44,15 +52,12 @@ jobs:
         run: |
           uv venv
           uv pip install -r requirements.txt
-      - name: Run pre-commit
+      - name: Run prek - pre-commit
         id: precommit
-        run: |
-          # Fetch the base branch for comparison
-          git fetch origin ${{ github.base_ref }}
-          uvx pre-commit run --from-ref origin/${{ github.base_ref }} --to-ref HEAD --show-diff-on-failure
+        run: uvx prek run --from-ref origin/${GITHUB_BASE_REF} --to-ref HEAD --show-diff-on-failure
         continue-on-error: true
       - name: Commit and push changes
-        if: env.IS_FORK == 'false'
+        if: env.HAS_SECRETS == 'true'
         run: |
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
@@ -64,7 +69,7 @@ jobs:
             git push
           fi
       - uses: pre-commit-ci/lite-action@v1.1.0
-        if: env.IS_FORK == 'true'
+        if: env.HAS_SECRETS == 'false'
         with:
           msg: 🎨 Auto format
       - name: Error out on pre-commit errors

.github/workflows/test.yml

@@ -27,7 +27,6 @@ jobs:
     strategy:
       matrix:
         python-version:
-          - "3.8"
           - "3.9"
           - "3.10"
           - "3.11"
@@ -90,7 +89,7 @@ jobs:
       - uses: actions/checkout@v6
       - uses: actions/setup-python@v6
         with:
-          python-version: '3.8'
+          python-version: '3.13'
       - name: Setup uv
         uses: astral-sh/setup-uv@v7
         with:

.pre-commit-config.yaml

@@ -4,17 +4,26 @@ repos:
 -   repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v6.0.0
     hooks:
-    -   id: check-added-large-files
-    -   id: check-toml
-    -   id: check-yaml
+      - id: check-added-large-files
+      - id: check-toml
+      - id: check-yaml
         args:
         -   --unsafe
-    -   id: end-of-file-fixer
-    -   id: trailing-whitespace
--   repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.14.5
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+
+-   repo: local
     hooks:
-    -   id: ruff
-        args:
-        - --fix
-    -   id: ruff-format
+      - id: local-ruff-check
+        name: ruff check
+        entry: uv run ruff check --force-exclude --fix --exit-non-zero-on-fix
+        require_serial: true
+        language: unsupported
+        types: [python]
+
+      - id: local-ruff-format
+        name: ruff format
+        entry: uv run ruff format --force-exclude --exit-non-zero-on-format
+        require_serial: true
+        language: unsupported
+        types: [python]

asyncer/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "0.0.11"
+__version__ = "0.0.12"
 
 from ._main import PendingValueException as PendingValueException
 from ._main import SoonValue as SoonValue

asyncer/_main.py

@@ -1,12 +1,10 @@
 import functools
 import sys
+from collections.abc import Awaitable, Coroutine
 from importlib import import_module
 from typing import (
     Any,
-    Awaitable,
     Callable,
-    Coroutine,
-    Dict,
     Generic,
     Optional,
     TypeVar,
@@ -200,7 +198,7 @@ class ExtendedTaskGroup(LibTaskGroup, TaskGroup):  # type: ignore
 def runnify(
     async_function: Callable[T_ParamSpec, Coroutine[Any, Any, T_Retval]],
     backend: str = "asyncio",
-    backend_options: Optional[Dict[str, Any]] = None,
+    backend_options: Optional[dict[str, Any]] = None,
 ) -> Callable[T_ParamSpec, T_Retval]:
     """
     Take an async function and create a regular (blocking) function that receives the

docs/contributing.md

@@ -104,10 +104,10 @@ Go into the docs director at `docs/`:
 $ cd docs/
 ```
 
-Then run `mkdocs` in that directory:
+Then run `zensical` in that directory:
 
 ```console
-$ mkdocs serve --dev-addr 8008
+$ zensical serve --dev-addr 8008
 ```
 
 ///
@@ -133,7 +133,7 @@ Completion will take effect once you restart the terminal.
 
 ### Docs Structure
 
-The documentation uses <a href="https://www.mkdocs.org/" class="external-link" target="_blank">MkDocs</a>.
+The documentation uses <a href="https://zensical.org" class="external-link" target="_blank">Zensical</a>.
 
 And there are extra tools/scripts in place in `./scripts/docs.py`.
 

docs/management-tasks.md

@@ -90,7 +90,7 @@ A PR should have a specific use case that it is solving.
 * If the PR is for a feature, it should have docs.
     * Unless it's a feature we want to discourage, like support for a corner case that we don't want users to use.
 * The docs should include a source example file, not write Python directly in Markdown.
-* If the source example(s) file can have different syntax for Python 3.8, 3.9, 3.10, there should be different versions of the file, and they should be shown in tabs in the docs.
+* If the source example(s) file can have different syntax for different Python versions, there should be different versions of the file, and they should be shown in tabs in the docs.
 * There should be tests testing the source example.
 * Before the PR is applied, the new tests should fail.
 * After applying the PR, the new tests should pass.

docs/release-notes.md

@@ -2,12 +2,26 @@
 
 ## Latest Changes
 
+### Internal
+
+* 👷 Update secrets check. PR [#446](https://github.com/fastapi/asyncer/pull/446) by [@YuriiMotov](https://github.com/YuriiMotov).
+* 🔧 Migrate from Material for MkDocs to Zensical. PR [#445](https://github.com/fastapi/asyncer/pull/445) by [@tiangolo](https://github.com/tiangolo).
+* 🔧 Update pre-commit to use local Ruff instead of hook, unpin `prek`. PR [#443](https://github.com/fastapi/asyncer/pull/443) by [@YuriiMotov](https://github.com/YuriiMotov).
+
+## 0.0.12
+
+### Breaking Changes
+
+* ➖ Drop support for Python 3.8. PR [#441](https://github.com/fastapi/asyncer/pull/441) by [@tiangolo](https://github.com/tiangolo).
+
 ### Docs
 
+* 📝 Update code examples to Python 3.9. PR [#442](https://github.com/fastapi/asyncer/pull/442) by [@YuriiMotov](https://github.com/YuriiMotov).
 * 📝 Relax the warnings as I have been using Asyncer in production for a while (and other teams as well). PR [#424](https://github.com/fastapi/asyncer/pull/424) by [@tiangolo](https://github.com/tiangolo).
 
 ### Internal
 
+* ⬆️ Use prek as a pre-commit alternative. PR [#437](https://github.com/fastapi/asyncer/pull/437) by [@YuriiMotov](https://github.com/YuriiMotov).
 * 👷 Configure coverage, error on main tests, don't wait for Smokeshow. PR [#435](https://github.com/fastapi/asyncer/pull/435) by [@YuriiMotov](https://github.com/YuriiMotov).
 * 👷 Run Smokeshow always, even on test failures. PR [#434](https://github.com/fastapi/asyncer/pull/434) by [@YuriiMotov](https://github.com/YuriiMotov).
 * 🔥 Remove Material for MkDocs Insiders extra files. PR [#432](https://github.com/fastapi/asyncer/pull/432) by [@tiangolo](https://github.com/tiangolo).

docs/tutorial/asyncify.md

@@ -16,7 +16,7 @@ Let's see a **broken** example first.
 
 Let's see a sync (regular, blocking) function `do_sync_work()`:
 
-{* docs_src/tutorial/asyncify/tutorial001.py ln[8:10] hl[8:10] *}
+{* docs_src/tutorial/asyncify/tutorial001_py39.py ln[8:10] hl[8:10] *}
 
 This function could be talking to a database, a remote API, etc. But it doesn't use `await`, it just makes Python wait there without a warning using `time.sleep(1)`.
 
@@ -26,15 +26,15 @@ Here's the problem.
 
 Let's just call that **slow** sync (regular, blocking) function directly from inside the async code 😱:
 
-{* docs_src/tutorial/asyncify/tutorial001.py hl[14] *}
+{* docs_src/tutorial/asyncify/tutorial001_py39.py hl[14] *}
 
 Because that function is not async, but still it makes Python wait there, it will impede any other async code that could have been started from running. It will all have to **just wait** there doing nothing, wasting computation time. 😭
 
 ## Use Asyncify
 
 In those cases where you want to run "**sync**" (synchronous, blocking) code **from inside of async** code in a way that is compatible with the rest of the async code you can use **Asyncer**'s `asyncify()`. 🚀
 
-{* docs_src/tutorial/asyncify/tutorial002.py hl[4,13] *}
+{* docs_src/tutorial/asyncify/tutorial002_py39.py hl[4,13] *}
 
 `asyncify()` takes the **sync (blocking) function** that you want to call and then returns another **async function** that takes the actual **arguments for the original sync function**.
 
@@ -44,7 +44,7 @@ Then you can `await` that and get the return value that was **safely** executed
 
 Notice that now the function `do_sync_work` is not an `async` function:
 
-{* docs_src/tutorial/asyncify/tutorial002.py ln[7:9] hl[7:9] *}
+{* docs_src/tutorial/asyncify/tutorial002_py39.py ln[7:9] hl[7:9] *}
 
 ...it even has a line:
 

docs/tutorial/first-steps.md

@@ -6,7 +6,7 @@ Asyncer is based on **AnyIO**, so let's start with a simple example just using *
 
 Let's start with a simple main async function.
 
-{* docs_src/tutorial/first_steps/tutorial001.py ln[9:11] hl[9:10] *}
+{* docs_src/tutorial/first_steps/tutorial001_py39.py ln[9:11] hl[9:10] *}
 
 When working with **async** code you normally use `async` and `await`.
 
@@ -25,13 +25,13 @@ The function `do_work()` also needs to be declared with `async def` for us to be
 
 For this example, let's simulate that by making `do_work()` wait there for 1 second:
 
-{* docs_src/tutorial/first_steps/tutorial001.py ln[4:11] hl[4:5] *}
+{* docs_src/tutorial/first_steps/tutorial001_py39.py ln[4:11] hl[4:5] *}
 
 ## Run the Main Function
 
 As `main()` is an `async` function, we can't call it directly because we can't `await` it. Instead, we call it with `anyio.run()`:
 
-{* docs_src/tutorial/first_steps/tutorial001.py hl[1,14] *}
+{* docs_src/tutorial/first_steps/tutorial001_py39.py hl[1,14] *}
 
 `anyio.run()` will do everything necessary to call `main()`, handling all the `await` parts, and waiting there until it finishes.