Skip to content
Merged
Changes from all commits
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
2d9e9ef
Include three comments from @carreau (drop two bullets, *args in exam…
pauleveritt Jul 30, 2024
f961b65
Lambda-wrapped expressions use annotation scope
jimbaker Jul 17, 2024
4cab3da
Clarify use of annotation scope
jimbaker Jul 18, 2024
708b47e
Mention what happens to named unicodes followed by text
lysnikolaou Jul 19, 2024
fb46927
Use DecodedConcrete in assertion
lysnikolaou Jul 19, 2024
7afd442
Rewrite why annotation scope is needed (#4)
jimbaker Jul 20, 2024
695ee12
PEP 747: Fix rules related to UnionType (T1 | T2). Contrast TypeExpr …
davidfstr Jul 9, 2024
7720888
PEP 694: Fix typo (#3859)
warsaw Jul 10, 2024
c77b6ff
PEP 2026: Update following discussion (#3860)
hugovk Jul 11, 2024
fc0b959
PEP 101: Remove outdated info and add new info (#3863)
hugovk Jul 15, 2024
27334b1
PEP 11: Add Russell as an iOS contact (#3865)
hugovk Jul 16, 2024
4022666
Meta: Document the PEPs API (#3864)
hugovk Jul 17, 2024
e8e2c77
PEP 719: Update for today's release of 3.13.0b4 (#3868)
Yhg1s Jul 18, 2024
7368a3d
PEP 740: Mark as Provisional (#3848)
woodruffw Jul 18, 2024
e248a85
PEP 749: Add section on metaclasses (#3847)
JelleZijlstra Jul 23, 2024
be27c4a
PEP 8: Update a Wikipedia link (#3552)
Rnbsov Jul 24, 2024
ef06ba1
PEP 635: Minor typo fix in code sample (#3871)
Mariatta Jul 24, 2024
482f224
PEP 751: A file format to list Python dependencies for installation r…
brettcannon Jul 24, 2024
5b4e2ab
PEP 743: Rewrite to hide (soft-)deprecated API (GH-3869)
encukou Jul 25, 2024
5ef5ca0
PEP 751: Add Discussions-To and Post-History (#3872)
brettcannon Jul 25, 2024
b7bf1ca
PEP 639: Incorporate the latest discussion feedback (#3866)
befeleme Jul 25, 2024
100a9e7
PEP 715: clarify what `[package.tool]` is (#3873)
brettcannon Jul 25, 2024
a1c4b12
PEP 665: Superseded-By: 751 (#3875)
hugovk Jul 26, 2024
52ad686
PEP 751: update based on feedback (#3877)
brettcannon Jul 26, 2024
1770125
Include three comments from @carreau (drop two bullets, *args in exam…
pauleveritt Jul 30, 2024
454cbed
Merge remote-tracking branch 'origin/pep-750-tagstr' into pep-750-tagstr
pauleveritt Aug 6, 2024
326de70
Merge remote-tracking branch 'origin/pep-750-tagstr' into pep-750-tagstr
pauleveritt Aug 6, 2024
a7de80f
From Carol, move the point about import to the following paragraph.
pauleveritt Aug 6, 2024
4486816
Per Carol: Remove paragraph about lifecycles as that is about *a* DSL…
pauleveritt Aug 6, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 2 additions & 6 deletions peps/pep-0750.rst
Original file line number Diff line number Diff line change
Expand Up @@ -736,12 +736,12 @@ Consumers can look at tag strings as starting from f-strings:

- They look familiar
- Scoping and syntax rules are the same
- You just need to import the tag function

They first thing they need to absorb: unlike f-strings, the string isn't
immediately evaluated "in-place". Something else (the tag function) happens.
That's the second thing to teach: the tag functions do something particular.
Thus the concept of "domain specific languages" (DSLs).
Thus the concept of "domain specific languages" (DSLs). What's extra to
teach: you need to import the tag function before tagging a string.

Tag function authors think in terms of making a DSL. They have
business policies they want to provide in a Python-familiar way. With tag
Expand All @@ -751,10 +751,6 @@ the bar for making a DSL.
Tag authors can begin with simple use cases. After authors gain experience, tag strings can be used to add larger
patterns: lazy evaluation, intermediate representations, registries, and more.

Finally, framework authors can provide contact points with their lifecycles.
For example, decorators which tag function authors can use to memoize
interpolations in the function args.

Each of these points also match the teaching of decorators. In that case,
a learner consumes something which applies to the code just after it. They
don't need to know too much about decorator theory to take advantage of the
Expand Down