cpython/Doc/reference/grammar.rst

.. _full-grammar-specification:

Full Grammar specification
==========================

This is the full Python grammar, derived directly from the grammar
used to generate the CPython parser (see :source:`Grammar/python.gram`).
The version here omits details related to code generation and
error recovery.

The notation used here is the same as in the preceding docs,
and is described in the :ref:`notation <notation>` section,
except for an extra complication:

* ``~`` ("cut"): commit to the current alternative and fail the rule
  even if this fails to parse

.. literalinclude:: ../../Grammar/python.gram
  :language: peg
Docs: Add label to grammar spec for linking from PEPs (#113235) 2023-12-17 21:23:14 +02:00			`.. _full-grammar-specification:`

Merged revisions 65378-65379,65430 via svnmerge from svn+ssh://pythondev@svn.python.org/python/trunk ........ r65378 \| georg.brandl \| 2008-08-01 22:04:43 +0200 (Fri, 01 Aug 2008) \| 4 lines Add the grammar to the reference manual, since the new docs don't have the feature of putting all the small EBNF snippets together into one big file. ........ r65379 \| georg.brandl \| 2008-08-01 22:13:29 +0200 (Fri, 01 Aug 2008) \| 2 lines This should really be a comment. ........ r65430 \| georg.brandl \| 2008-08-03 11:21:18 +0200 (Sun, 03 Aug 2008) \| 2 lines #3495: use current version. ........ 2008-08-03 09:47:27 +00:00			`Full Grammar specification`
			`==========================`

bpo-40939: Use the new grammar for the grammar specification documentation (GH-19969) (We censor the heck out of actions and some other stuff using a custom "highlighter".) Co-authored-by: Guido van Rossum <guido@python.org> 2020-07-27 19:20:36 +01:00			`This is the full Python grammar, derived directly from the grammar`
			used to generate the CPython parser (see :source:`Grammar/python.gram`).
			`The version here omits details related to code generation and`
			`error recovery.`
Merged revisions 65378-65379,65430 via svnmerge from svn+ssh://pythondev@svn.python.org/python/trunk ........ r65378 \| georg.brandl \| 2008-08-01 22:04:43 +0200 (Fri, 01 Aug 2008) \| 4 lines Add the grammar to the reference manual, since the new docs don't have the feature of putting all the small EBNF snippets together into one big file. ........ r65379 \| georg.brandl \| 2008-08-01 22:13:29 +0200 (Fri, 01 Aug 2008) \| 2 lines This should really be a comment. ........ r65430 \| georg.brandl \| 2008-08-03 11:21:18 +0200 (Sun, 03 Aug 2008) \| 2 lines #3495: use current version. ........ 2008-08-03 09:47:27 +00:00
gh-127833: Reword and expand the Notation section (GH-134443) Prepare the docs for using the notation used in the `python.gram` file. If we want to sync the two, the meta-syntax should be the same. Link the Full Grammar docs here; keep only a few extras. Also, remove the distinction between lexical and syntactic rules, except for whitespace handling. With f- and t-strings, the line between the two is blurry. Co-authored-by: Blaise Pabon <blaise@gmail.com> Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Co-authored-by: Lysandros Nikolaou <lisandrosnik@gmail.com> Co-authored-by: Colin Marquardt <cmarqu42@gmail.com> 2025-06-09 15:50:11 +02:00			`The notation used here is the same as in the preceding docs,`
			and is described in the :ref:`notation <notation>` section,
gh-135676: Lexical analysis: Reword String literals and related sections (GH-135942) Co-authored-by: Blaise Pabon <blaise@gmail.com> Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com> Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> 2025-07-23 17:57:54 +02:00			`except for an extra complication:`
gh-127833: Reword and expand the Notation section (GH-134443) Prepare the docs for using the notation used in the `python.gram` file. If we want to sync the two, the meta-syntax should be the same. Link the Full Grammar docs here; keep only a few extras. Also, remove the distinction between lexical and syntactic rules, except for whitespace handling. With f- and t-strings, the line between the two is blurry. Co-authored-by: Blaise Pabon <blaise@gmail.com> Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Co-authored-by: Lysandros Nikolaou <lisandrosnik@gmail.com> Co-authored-by: Colin Marquardt <cmarqu42@gmail.com> 2025-06-09 15:50:11 +02:00
			* ``~`` ("cut"): commit to the current alternative and fail the rule
			`even if this fails to parse`
bpo-40939: Use the new grammar for the grammar specification documentation (GH-19969) (We censor the heck out of actions and some other stuff using a custom "highlighter".) Co-authored-by: Guido van Rossum <guido@python.org> 2020-07-27 19:20:36 +01:00
			`.. literalinclude:: ../../Grammar/python.gram`
			`:language: peg`