Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

python-notebooks-async

/python-notebooks-async

Pomaga pisać i przeglądać kod asyncio w notebookach Jupyter, porządkując własność pętli zdarzeń i zadania, oraz naprawia błąd „This event loop is already running” i niedokończone zadania.

Repozytorium
skills ↗
Licencja
CC0-1.0
Ostatnia zmiana repozytorium
20.10.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 20.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

CC0-1.0, otwarta.

Co robi i kiedy

Pomaga pisać i przeglądać kod asyncio w notebookach Jupyter, porządkując własność pętli zdarzeń i zadania, oraz naprawia błąd „This event loop is already running” i niedokończone zadania.

Wyzwalacze z opisu

#%%
Oryginalny opis (EN)

Use when writing or reviewing asyncio code in Jupyter notebooks or '#%%' cell workflows — structuring event-loop ownership, orchestrating async tasks, or choosing compatibility strategies. Also use when hitting RuntimeError: This event loop is already running, asyncio.run() failures in cells, or tasks silently never completing.

Jak działa

  1. Overview
  2. When to Use
  3. Invocation Notice
  4. Quick Reference
  5. Common Mistakes
  6. References
Sekcje z nagłówków SKILL.md, w oryginale · 61 linii, 421 słów
Podgląd SKILL.md
---
name: python-notebooks-async
description: |-
  Use when writing or reviewing asyncio code in Jupyter notebooks or '#%%' cell workflows — structuring event-loop ownership, orchestrating async tasks, or choosing compatibility strategies. Also use when hitting RuntimeError: This event loop is already running, asyncio.run() failures in cells, or tasks silently never completing.
---

# Python Notebooks Async

## Overview

Notebook kernels own the event loop; async code must cooperate with that ownership rather than fight it.
This skill covers orchestration patterns, top-level `await`, and compatibility constraints for `.ipynb` and `#%%` workflows.

Treat these recommendations as preferred defaults.
When project constraints require deviation, call out tradeoffs and compensating controls.

## When to Use

- `asyncio.run()` raises `RuntimeError` inside a notebook cell.
- Event-loop conflicts when mixing async libraries in Jupyter.
- Porting async scripts into notebook workflows.
- Orchestrating concurrent tasks (`gather`, `TaskGroup`) in IPython kernels.
- Deciding where to place reusable async logic across notebook/module boundaries.

### When NOT to Use

- Pure script or service code with no notebook involvement.
- Synchronous notebook workflows with no async needs.
- General asyncio API design outside notebook contexts — the `python` skill covers concurrency audit defaults.

## Invocation Notice

- Tell the user when this skill is running: `python-notebooks-async`.
  Skip the notice when the user asked for the skill by name or slash command; spelling and spacing need not match.
  A phrase from this skill's own trigger list is not a name — naming the work is not naming the skill.

## Quick Reference

- Treat notebook kernels as loop-owned environments; never create a competing loop.
- Use top-level `await` instead of `asyncio.run()` in notebook cells.
- Orchestrate concurrent work with `asyncio.gather()` or `asyncio.TaskGroup`.
- Keep reusable async logic in regular `.py` modules, imported into notebooks.
- Use `nest_asyncio` only as a constrained compatibility fallback, not a default.
- Avoid fire-and-forget tasks — always `await` or collect results explicitly.

## Common Mistakes

- **Calling `asyncio.run()` in a notebook cell.**
  The kernel already runs a loop; `asyncio.run()` tries to start a second one and raises `RuntimeError`.
  Use `await` directly instead.
- **Applying `nest_asyncio` globally by default.**
  It patches the loop to allow reentrant calls but masks design problems and can hide subtle concurrency bugs.
  Reserve it for legacy compatibility.
- **Defining async helpers inline in cells instead of modules.**
  Inline definitions are lost on kernel restart and cannot be tested outside the notebook.
  Extract to `.py` files.
- **Ignoring returned tasks or coroutines.**
  Calling an async function without `await` silently produces a never-executed coroutine object, with no error until results are missing downstream.
- **Mixing blocking I/O with async in the same cell.**
  Synchronous calls like `requests.get()` block the event loop, starving concurrent tasks.
  Use `aiohttp`, `httpx`, or `asyncio.to_thread()`.

## References

- `references/notebooks-async.md` — event-loop ownership, background-work and fire-and-forget patterns, script/notebook compatibility, blocking-library interop, `nest_asyncio` policy
Pliki w paczce (2)
  • SKILL.md 3 KB
  • references/notebooks-async.md 4 KB

Wersje

W bazie nie ma innych skilli o nazwie python-notebooks-async.

Migawka bazy z 13.11.2026 · wersja paczki e494f5f429d6 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 1 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90python-asyncio
    Pomaga ocenić, czy asyncio się opłaca, utrzymać pętlę zdarzeń bez blokad i ułożyć współbieżność z TaskGroup oraz rozsądnym anulowaniem, także przy zawieszonej lub wolnej pętli.
  • 100interactive-notebook-demo
    Pomaga pisać i przeglądać notebooki demonstracyjne (format #%% lub Jupyter), które pokazują funkcję, bibliotekę lub API i służą jako półinteraktywna dokumentacja.
  • 100async-python-patterns
    Porządkuje kod asyncio: zarządzanie zadaniami, anulowanie, ograniczanie tempa i wywołania blokujące poza pętlą zdarzeń, a także wybór między asyncio, wątkami i multiprocessingiem.
  • 100async-python-patterns
    Porządkuje kod asyncio: zarządzanie zadaniami, anulowanie, ograniczanie tempa i wywołania blokujące poza pętlą zdarzeń, a także wybór między asyncio, wątkami i multiprocessingiem.
  • 100python-asyncio-pitfalls
    Diagnozuje blokady pętli zdarzeń asyncio, wywołania blokujące w coroutines, wybór gather lub TaskGroup, anulowanie, mieszanie kodu sync i async oraz ostrzeżenia o zniszczonych zadaniach.
  • 95asyncio
    Pokazuje wzorce asyncio w Pythonie, pułapki współbieżności i kontrolę obciążenia przy pisaniu usług asynchronicznych.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.