gh-123152: Add a Concurrency Howto Page - #123163

Draft

ericsnowcurrently wants to merge 81 commits into

python:mainfrom

ericsnowcurrently:concurrency-howto

Commits on Aug 19, 2024

Let "python3" be set at the commandline.
ericsnowcurrently
committed
4187872

Commits on Aug 20, 2024

Commits on Aug 21, 2024

Clarify about "spook action at a distance".
ericsnowcurrently
committed
b7bb9a5
Clarify about the "pain" threads can cause.
ericsnowcurrently
committed
7efb9b4
Add references to the howto in the library docs.
ericsnowcurrently
committed
daaa02b
Clean up the Python concurrency models section.
ericsnowcurrently
committed
ad50bdd
Add a section about concurrent.futures.
ericsnowcurrently
committed
3a82978
Make the examples runnable.
ericsnowcurrently
committed
560f26e

Commits on Aug 22, 2024

Revert changes to Makefile.
ericsnowcurrently
committed
4f49ed7
Fix a typo.
ericsnowcurrently
committed
5151e3b
Fix sphinx warnings.
ericsnowcurrently
committed
14e59f8
Adjust the references.
ericsnowcurrently
committed
0b27fd9
Fill out and restructure the comparisons.
ericsnowcurrently
committed
0586c72
Fill out the section about Python theads.
ericsnowcurrently
committed
8df61ad
Fill out the section about multiple interpreters.
ericsnowcurrently
committed
269eaac
Fill out the section about multprocessing.
ericsnowcurrently
committed
7754912

Commits on Aug 23, 2024

Commits on Aug 26, 2024

Add a link to the "overhead" table.
ericsnowcurrently
committed
e7144ec
Expand the general explanation of workloads.
ericsnowcurrently
committed
e131b83
Updates for the first two workload examples.
ericsnowcurrently
committed
c601e27

Commits on Aug 27, 2024

Do not worry about demonstrating a web service.
ericsnowcurrently
committed
5c05581
Move the grep example up.
ericsnowcurrently
committed
a0a8ebb
Implement threads for the grep example.
ericsnowcurrently
committed
c3d1688

Commits on Aug 28, 2024

Implement grep using concurrent.futures.
ericsnowcurrently
committed
48ac79d

Commits on Aug 29, 2024

Fix nested lists and add quadrants.
ericsnowcurrently
committed
9a1a81c
Implement grep using multiprocessing.
ericsnowcurrently
committed
03156b5
Start reorganizing, and dump a bunch of explanation.
ericsnowcurrently
committed
e0d833e

Commits on Sep 3, 2024

Commits on Sep 4, 2024

Formatting and links for intro section.
ericsnowcurrently
committed
288c4f4
wording tweaks
ericsnowcurrently
committed
0b768ae
Update the section about multiple interpreters.
ericsnowcurrently
committed
ab24e83
Update the section about coroutines.
ericsnowcurrently
committed
f7f1769
Update the sections about multi-processing.
ericsnowcurrently
committed
fdf46cb
Clear out the section on downsides.
ericsnowcurrently
committed
4cc62a1
Update the section about shared resources.
ericsnowcurrently
committed
54bacb6
Normalize TODO comments.
ericsnowcurrently
committed
49ec62f
Move the explanations to the right places.
ericsnowcurrently
committed
8fd8406
Add sub-sections.
ericsnowcurrently
committed
fdcc128
Move the caveats subsections around.
ericsnowcurrently
committed
3033875
Fix formatting.
ericsnowcurrently
committed
3e4ab6a
Drop a TODO.
ericsnowcurrently
committed
f07c696
Hide the incomplete portions of text.
ericsnowcurrently
committed
7a04361
Tweak a table header.
ericsnowcurrently
committed
f9815bb
Fix a table header.
ericsnowcurrently
committed
48551a7

Commits on Sep 16, 2024

Fix the sidebar table of contents.
ericsnowcurrently
committed
eac23f9
Expand the grep section and code.
ericsnowcurrently
committed
3e1c53e
Make the examples more uniform.
ericsnowcurrently
committed
9f6ea1f

Commits on Sep 17, 2024

Fix some wording.
ericsnowcurrently
committed
3aaa4d1
Reorganize the example code a little.
ericsnowcurrently
committed
3a7b0be

Commits on Sep 18, 2024

Split up the examples file.
ericsnowcurrently
committed
36edcce
Tweak CLI.
ericsnowcurrently
committed
7b4af12

Commits on Sep 19, 2024

Simplify the examples.
ericsnowcurrently
committed
bc6e725
Drop all the context manager stuff.
ericsnowcurrently
committed
f4749f6

Commits on Sep 20, 2024

Implement the async example.
ericsnowcurrently
committed
eaaecca
Drop the text about do_search().
ericsnowcurrently
committed
ebf3130

Commits on Sep 23, 2024

Fix a typo.
ericsnowcurrently
committed
21ff9e1
Move the grep examples to individual files.
ericsnowcurrently
committed
3682348
Tweak run-examples.py to run the newer example code.
ericsnowcurrently
committed
10ee369

Commits on Sep 24, 2024

Drop the combined grep package.
ericsnowcurrently
committed
e6f0088
Fix the highlighting.
ericsnowcurrently
committed
3f2637b
cleanups
ericsnowcurrently
committed
9ce6ccf
Fix typos and wording.
ericsnowcurrently
committed
10a6571
Limit side-by-side example lines to 60 characters.
ericsnowcurrently
committed
793bfa0
Fix the examples.
ericsnowcurrently
committed
3e19d7e
Fix a ref.
ericsnowcurrently
committed
f826c9c

Commits on Sep 25, 2024

lint
ericsnowcurrently
committed
049f1de

Commits on Apr 29, 2025

Merge branch 'main' into concurrency-howto
AA-Turner
authored
7686e10