Skip to content
This repository has been archived by the owner on Jul 5, 2023. It is now read-only.

Update README to emphasize the outdated nature #168

Merged
merged 2 commits into from Oct 26, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
11 changes: 6 additions & 5 deletions README.md
Expand Up @@ -4,12 +4,14 @@
[![Chat at https://gitter.im/python/typed_ast](https://badges.gitter.im/python/typed_ast.svg)](https://gitter.im/python/typed_ast)

`typed_ast` is a Python 3 package that provides a Python 2.7 and Python 3
parser similar to the standard `ast` library. Unlike `ast`, the parsers in
parser similar to the standard `ast` library. Unlike `ast` up to Python 3.7, the parsers in
`typed_ast` include [PEP 484](https://www.python.org/dev/peps/pep-0484/) type
comments and are independent of the version of Python under which they are run.
The `typed_ast` parsers produce the standard Python AST (plus type comments),
and are both fast and correct, as they are based on the CPython 2.7 and 3.7
parsers. `typed_ast` runs on CPython 3.6-3.10 on Linux, OS X and Windows.
parsers. `typed_ast` runs on CPython 3.6-3.10 on Linux, OS X and Windows,
although starting with Python 3.8, we recommend to use the native `ast` parser
(see below).

## Development Philosophy

Expand Down Expand Up @@ -41,9 +43,8 @@ and has limited support for parsing older versions of Python 3.

## Submodules
### ast3
The `ast3` parser produces the AST from a recent version of Python 3
(currently Python 3.6). When new versions of Python 3 are released, it will be
updated to match any changes in their AST. (For rationale and technical
The `ast3` parser produces the AST from a Python 3 code, up to Python 3.7.
(For rationale and technical
details, see [here](update_process.md).) The AST it currently produces is described in
[ast3/Parser/Python.asdl](ast3/Parser/Python.asdl). If you wish to limit
parsing to older versions of Python 3, `ast3` can be configured to to give a
Expand Down
8 changes: 6 additions & 2 deletions setup.py
Expand Up @@ -83,11 +83,15 @@

long_description = """
`typed_ast` is a Python 3 package that provides a Python 2.7 and Python 3
parser similar to the standard `ast` library. Unlike `ast`, the parsers in
parser similar to the standard `ast` library. Unlike `ast` below Python 3.8,
the parsers in
`typed_ast` include PEP 484 type comments and are independent of the version of
Python under which they are run. The `typed_ast` parsers produce the standard
Python AST (plus type comments), and are both fast and correct, as they are
based on the CPython 2.7 and 3.6 parsers.
based on the CPython 2.7 and 3.7 parsers.

`typed_ast` does not support Python 3.8 or higher code. Use the `ast`
module from Python 3.8 or above for that.
""".strip()

_version_re = re.compile(r'__version__\s+=\s+(?P<version>.*)')
Expand Down