gh-127833: lexical analysis: Improve section on Names #131474
Conversation
| 16.0.0 can be found at | ||
| https://www.unicode.org/Public/16.0.0/ucd/DerivedCoreProperties.txt |
There was a problem hiding this comment.
Maybe the link could be moved below too? Inline links are nice ;-)
| include the uppercase and lowercase letters (``A`` through ``Z`` and ``a`` to | ||
| ``z``), the underscore ``_`` and, except for the first character, the digits |
There was a problem hiding this comment.
| include the uppercase and lowercase letters (``A`` through ``Z`` and ``a`` to | |
| ``z``), the underscore ``_`` and, except for the first character, the digits | |
| include the uppercase and lowercase letters, the underscore ``_`` and, except | |
| for the first character, the digits |
Do we really need to explain this here too?
This is just below:
Besides
A-Z,a-z,_and0-9...
There was a problem hiding this comment.
I'd definitely keep it here; making it clear that “letters in the ASCII range” is A-Z and a-z.
Perhaps shorten it:
| include the uppercase and lowercase letters (``A`` through ``Z`` and ``a`` to | |
| ``z``), the underscore ``_`` and, except for the first character, the digits | |
| include the uppercase and lowercase letters (``A-Z`` and ``a-z``), | |
| the underscore ``_`` and, except for the first character, the digits |
I'd be OK with deduplicating the later occurence, but something like “ASCII characters as listed above” is almost as long as repeating the lists. This isn't code, it can be a little WET.
There was a problem hiding this comment.
That would be better :-)
| in (`id_start` `xid_continue`*)"> | ||
| xid_continue: <all characters in `id_continue` whose NFKC normalization is | ||
| in (`id_continue`*)"> | ||
| identifier: <`NAME`, except keywords> | ||
|
|
||
| A non-normative HTML file listing all valid identifier characters for Unicode | ||
| 16.0.0 can be found at |
There was a problem hiding this comment.
| 16.0.0 can be found at | |
| 15.1.0 can be found at |
Unicode categories use the version of the Unicode Character Database as
included in the :mod:unicodedatamodule.
According to the docs that is 15.1.0 at the moment, maybe we should link to that one instead?
Co-authored-by: Stan Ulbrych <[email protected]>
Use consistent terminology: "names" are "identifiers", "keywords", and "soft keywords".
Start with the simple case (ASCII), then get more and more technical.
Define NAME in the formal lexical grammar.
Exclude keywords in the
identifierdefinition.📚 Documentation preview 📚: https://cpython-previews--131474.org.readthedocs.build/