Repository navigation

gh-137026: Add an explainer guide for asyncio - #137215

Merged

willingc merged 116 commits into

python:mainfrom

anordin95:main

Aug 9, 2025

Merged

gh-137026: Add an explainer guide for asyncio#137215
willingc merged 116 commits into
python:mainfrom
anordin95:main

Commits on Jul 29, 2025
- - Add an explainer guide (aka HOWTO, not how-to) for asyncio.
  anordin95
  committed
  05b35b0
- Fix linter errors.
  anordin95
  committed
  446534c
- - Enforce max line length of roughly 79 chars.
  anordin95
  committed
  176096d
- Add reference to subinterpreters.
  anordin95
  committed
  b745f88
- - Significantly reduce article size. Remove both example sections & "Which concurrency do I want" section.
  anordin95
  committed
  0f2b8db
- Align section-header lengths with section names.
  anordin95
  committed
  27d1dcd
- - Remove reference to deleted section.
  anordin95
  committed
  3852bb1
Commits on Jul 31, 2025
- - Fix a variety of rote style guide items like title-alignment, use of ie and $, and so forth.
  anordin95
  committed
  8bf6d2c
- - One last title alignment.
  anordin95
  committed
  397df8f
- - Style nit.
  anordin95
  committed
  84aedf7
- - Rework a variety of I statements.
  anordin95
  committed
  3d3e12c
- Lint fix.
  anordin95
  committed
  a5fdd0e
Commits on Aug 1, 2025
- - Firm up commentary on yield from in corotuines.
  anordin95
  committed
  b1aef5c
- Update language comparing await and yield from.
  anordin95
  committed
  64a12b4
- - Remove await-ing Tasks and futures section
  anordin95
  committed
  0fffd4b
- Update Doc/howto/a-conceptual-overview-of-asyncio.rst
  
  anordin95
  and
  ZeroIntensity
  authored
  bfd1212
- Update Doc/howto/a-conceptual-overview-of-asyncio.rst
  
  anordin95
  and
  ZeroIntensity
  authored
  c946563
- - Address comments related to style & writing flow.
  anordin95
  committed
  3fc668c
- per-thread event loop note.
  anordin95
  committed
  ebfe542
- Add section describing coroutines roots in generators.
  anordin95
  committed
  3978837
- Phrasing tweak.
  anordin95
  committed
  0dd99eb
- Use asyncio.create_task instead of asyncio.Task
  anordin95
  committed
  ff804fe
- Update Doc/howto/a-conceptual-overview-of-asyncio.rst
  
  anordin95
  and
  ZeroIntensity
  authored
  00a1a68
- Update Doc/howto/a-conceptual-overview-of-asyncio.rst
  
  anordin95
  and
  ZeroIntensity
  authored
  e982f9c
- small phrasing.
  anordin95
  committed
  a033876
- Update Doc/howto/a-conceptual-overview-of-asyncio.rst
  
  anordin95
  and
  ZeroIntensity
  authored
  dbbc0ab
- phrasing nit.
  anordin95
  committed
  af9ba25
- style nits
  anordin95
  committed
  34f3335
- Update Doc/howto/a-conceptual-overview-of-asyncio.rst
  
  anordin95
  and
  ZeroIntensity
  authored
  dca3d38
- phrasing nit
  anordin95
  committed
  db4ac35
- Fix misnaming of async generator.
  anordin95
  committed
  bb8d018
- phrasing nits.
  anordin95
  committed
  5fdd4e9
- Update Doc/howto/a-conceptual-overview-of-asyncio.rst
  
  anordin95
  and
  ZeroIntensity
  authored
  fe3c732
- Update Doc/howto/a-conceptual-overview-of-asyncio.rst
  
  anordin95
  and
  ZeroIntensity
  authored
  1abe9a1
- consistent spacing
  anordin95
  committed
  eadc0fb
- Update Doc/howto/a-conceptual-overview-of-asyncio.rst
  
  anordin95
  and
  ZeroIntensity
  authored
  1f7323d
Commits on Aug 2, 2025
- phrasing nits
  anordin95
  committed
  99ac489
- Update Doc/howto/a-conceptual-overview-of-asyncio.rst
  
  anordin95
  and
  ZeroIntensity
  authored
  feb8634
- Update Doc/howto/a-conceptual-overview-of-asyncio.rst
  
  anordin95
  and
  ZeroIntensity
  authored
  49e9c65
- Update Doc/howto/a-conceptual-overview-of-asyncio.rst
  
  anordin95
  and
  ZeroIntensity
  authored
  daba131
- Update Doc/howto/a-conceptual-overview-of-asyncio.rst
  
  anordin95
  and
  ZeroIntensity
  authored
  c31f3c5
- add conclusion
  anordin95
  committed
  6756257
- nits
  anordin95
  committed
  a730bd3
- - Variety of style & grammar improvements thanks to ZeroIntensity's comments.
  anordin95
  committed
  8fca2e3
- - Make all directives start with a 3 space indent. Then 4 thereafter.
  anordin95
  committed
  776daeb
- - Use :linenos: instead of manually writing the line numbers.
  anordin95
  committed
  0b795a2
- - Fix label typo for article.
  anordin95
  committed
  d10eeec
Commits on Aug 3, 2025
- fix label link.
  anordin95
  committed
  b2e90f3
- Apply suggestions from code review
  
  authored
  9e07a36
- - introduce async-sleep name
  anordin95
  committed
  d12b29f
- Phrasing
  anordin95
  committed
  86039b7
- nit
  anordin95
  committed
  e5fafc4
- ungendered octopus
  anordin95
  committed
  1dc6e51
- teammates
  anordin95
  committed
  3c0b0a4
- jobs
  anordin95
  committed
  0f3931c
- rework fella to penguin
  anordin95
  committed
  82a1967
- - remove byline; add seealso
  anordin95
  committed
  9fa9fca
- Change ref from asyncio to use seealso block.
  anordin95
  committed
  9ff73dc
- Remove typehints. Fix indentation in one code example.
  anordin95
  committed
  be9629d
- Slight rephrase for clarity.
  anordin95
  committed
  f7dbaa6
- Make references point to asyncio. Wrap some long lines.
  anordin95
  committed
  689d517
Commits on Aug 4, 2025
- - Variety of style/phrasing improvements based on PR feedback.
  anordin95
  committed
  9da27dd
- phrasing.
  anordin95
  committed
  3c0c11c
- phrasing nit.
  anordin95
  committed
  671cc80
- Apply suggestions from code review
  
  anordin95
  and
  ZeroIntensity
  authored
  2a96782
- Update Doc/howto/a-conceptual-overview-of-asyncio.rst
  
  anordin95
  and
  willingc
  authored
  def6157
Commits on Aug 5, 2025
- nit
  anordin95
  committed
  a84827b
- Apply suggestions from code review
  
  anordin95
  and
  willingc
  authored
  01710e2
- fix backticks.
  anordin95
  committed
  b5f56f3
- nits
  anordin95
  committed
  3344574
Commits on Aug 6, 2025
- nit
  anordin95
  committed
  1ed21c0
- add section on asyncio.run
  anordin95
  committed
  b574f72
- title change under the hood.
  anordin95
  committed
  0fbd5b1
- modify task coro example.
  anordin95
  committed
  27785f3
- howtos article link.
  anordin95
  committed
  a75b55b
- prefer await without backticks.
  anordin95
  committed
  53ac647
- phrasing tweak.
  anordin95
  committed
  7b5ff84
- Rework phrasing around how await tasks pauses and returns control in the await section.
  anordin95
  committed
  a8030d6
- move code block to beforfe explanation in coroutine under the hood.
  anordin95
  committed
  b4d087a
- phrasing.
  anordin95
  committed
  9e5aaf6
Commits on Aug 7, 2025
- link to yield from.
  anordin95
  committed
  55a268c
- style nits
  anordin95
  committed
  43c1c96
- nit
  anordin95
  committed
  1f8f863
- - Modify language re: event-loop cycling endlessly.
  anordin95
  committed
  ef71d25
- - Add a note about debug=True on asyncio.run to await coro section.
  anordin95
  committed
  4796f85
- clarity nit
  anordin95
  committed
  1000ace
- - Add two other references in seealso block.
  anordin95
  committed
  e649c07
- nit
  anordin95
  committed
  d619868
- Language simplification
  anordin95
  committed
  52a90c0
- Apply suggestions from code review
  
  anordin95
  and
  ZeroIntensity
  authored
  08d4eec
- nit
  anordin95
  committed
  1934aad
- grammar fix.
  anordin95
  committed
  7a4eebe
- fix
  anordin95
  committed
  a2fd17a
- worker bees
  anordin95
  committed
  c944ff1
- rework event loop paragraph to significantly deemphasize queues
  anordin95
  committed
  27c026b
Commits on Aug 8, 2025
- remove all references to queue besides the initial analogy.
  anordin95
  committed
  0527218
- add note about garbage collection of tasks
  anordin95
  committed
  8adebdc
- add practical note re: garbage collection
  anordin95
  committed
  1422011
- phrasing nits
  anordin95
  committed
  a8fa7f6
- re arrange note on task gc.
  anordin95
  committed
  9d3828d
- line wrap nit
  anordin95
  committed
  ee5c4de
- Update Doc/howto/a-conceptual-overview-of-asyncio.rst
  
  anordin95
  and
  kumaraditya303
  authored
  9f7d93f
- link to debug mode docs.
  anordin95
  committed
  a25b270
- readd part2 prefix.
  anordin95
  committed
  7211ef2
- simplify title.
  anordin95
  committed
  4f625b8
- fix titles. tihnk I messed this up earlier.
  anordin95
  committed
  673a9f9
- avoid idiom in title.
  anordin95
  committed
  270ee6e
- fix titles once agian.
  anordin95
  committed
  e025747
- Apply suggestions from code review
  
  anordin95
  and
  StanFromIreland
  authored
  15aa0c5
- rework task gc example.
  anordin95
  committed
  5b3b697
- phrasing tweak.
  anordin95
  committed
  585521e
- tewak.
  anordin95
  committed
  6530adc
- nit
  anordin95
  committed
  ac87e24
- nit
  anordin95
  committed
  7e48175
- nit
  anordin95
  committed
  f881bfd
- nit
  anordin95
  committed
  2227e4b

Commits

Commits on Jul 29, 2025

Commits on Jul 31, 2025

Commits on Aug 1, 2025

Commits on Aug 2, 2025

Commits on Aug 3, 2025

Commits on Aug 4, 2025

Commits on Aug 5, 2025

Commits on Aug 6, 2025

Commits on Aug 7, 2025

Commits on Aug 8, 2025