Pre-release

This release is a pre-release and may not be stable for production use.

Coverage badge from codecov Documentation Status https://img.shields.io/badge/code%20style-black-000000.svg pre-commit.ci status

Tidelift

Professional support for astroid is available as part of the Tidelift Subscription. Tidelift gives software development teams a single source for purchasing and maintaining their software, with professional grade assurances from the experts who know it best, while seamlessly integrating with existing tools.

What’s this?

The aim of this module is to provide a common base representation of python source code. It is currently the library powering pylint’s capabilities.

It provides a compatible representation which comes from the _ast module. It rebuilds the tree generated by the builtin _ast module by recursively walking down the AST and building an extended ast. The new node classes have additional methods and attributes for different usages. They include some support for static inference and local name scopes. Furthermore, astroid can also build partial trees by inspecting living objects.

Installation

Extract the tarball, jump into the created directory and run:

pip install .

If you want to do an editable installation, you can run:

pip install -e .

If you have any questions, please mail the code-quality@python.org mailing list for support. See http://mail.python.org/mailman/listinfo/code-quality for subscription information and archives.

Documentation

http://astroid.readthedocs.io/en/latest/

Python Versions

astroid 2.0 is currently available for Python 3 only. If you want Python 2 support, use an older version of astroid (though note that these versions are no longer supported).

Test

Tests are in the ‘test’ subdirectory. To launch the whole tests suite, you can use either tox or pytest:

tox
pytest

Project links

Data verified by PyPI on Jul 27, 2025
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (4.3.1)

Owner

PyPI data
Data sourced directly from PyPI's database.

8 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for AWhetter from gravatar.com AWhetter Avatar for BryceGuinta from gravatar.com BryceGuinta Avatar for cdce8p from gravatar.com cdce8p
+5 more Avatar for Claudiu.Popa from gravatar.com Claudiu.Popa Avatar for hippo91 from gravatar.com hippo91 Avatar for jacobtylerwalls from gravatar.com jacobtylerwalls Avatar for logilab from gravatar.com logilab Avatar for pierre-sassoulas from gravatar.com pierre-sassoulas

GitHub Statistics

Data verified by PyPI on Jul 27, 2025
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

LGPL-2.1-or-later
View SPDX License List

Requires

Python >=3.10.0

Tags

abstract syntax tree python static code analysis

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

astroid-4.0.0b0.tar.gz (398.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

astroid-4.0.0b0-py3-none-any.whl (272.3 kB view details)

Uploaded Python 3

File details

Details for the file astroid-4.0.0b0.tar.gz.

File metadata

  • Download URL: astroid-4.0.0b0.tar.gz
  • Upload date:
  • Size: 398.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for astroid-4.0.0b0.tar.gz
Algorithm Hash digest
SHA256 f51c943922fc811f97553501feb4f2a6a1be58060e3d36980740d2d053cdac75
MD5 0659eeaefbed08da770bbea7a866511e
BLAKE2b-256 33175bb188d5293518fc5ce1121b0a51c54afd8bcd641629f9ea463d5249ca7f

See more details on using hashes here.

Provenance

The following attestation bundles were made for astroid-4.0.0b0.tar.gz:

Publisher: release.yml on pylint-dev/astroid

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file astroid-4.0.0b0-py3-none-any.whl.

File metadata

  • Download URL: astroid-4.0.0b0-py3-none-any.whl
  • Upload date:
  • Size: 272.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for astroid-4.0.0b0-py3-none-any.whl
Algorithm Hash digest
SHA256 27914cb19e17f0727a99270593d0aa2d83c409b7a02328ddf3eda683d7d7f04e
MD5 3c1bd043a4adc7186b2d5b40cbe2aca6
BLAKE2b-256 56c13dd73cc41579515cff10a32d0d0f87dbbdf1a67e6d9704883fedba2ffbd4

See more details on using hashes here.

Provenance

The following attestation bundles were made for astroid-4.0.0b0-py3-none-any.whl:

Publisher: release.yml on pylint-dev/astroid

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

4.3.1

4.3.0

4.2.0b5 pre-release

4.2.0b4 pre-release

4.2.0b3 pre-release

4.2.0b2 pre-release

4.2.0b1 pre-release

4.1.2

4.1.1

4.1.0

4.0.4

4.0.3

4.0.2

4.0.1

4.0.0

4.0.0rc0 pre-release

4.0.0b3 pre-release

4.0.0b2 pre-release

4.0.0b1 pre-release

This release

4.0.0b0 pre-release

4.0.0a0 pre-release

3.3.11

3.3.10

3.3.9

3.3.8

3.3.7 yanked

Reason this release was yanked:

Creates crash with cryptography module in pylint

3.3.6

3.3.5

3.3.4

3.3.3

3.3.2

3.3.1

3.3.0

3.2.4

3.2.3

3.2.2

3.2.1

3.2.0

3.1.0

3.0.3

3.0.2

3.0.1

3.0.0

3.0.0b0 pre-release

3.0.0a9 pre-release

3.0.0a8 pre-release

3.0.0a7 pre-release

3.0.0a6 pre-release

3.0.0a5 pre-release

3.0.0a4 pre-release

3.0.0a3 pre-release

3.0.0a2 pre-release

3.0.0a1 pre-release

2.15.8

2.15.7

2.15.6

2.15.5

2.15.4

2.15.3

2.15.2

2.15.1

2.15.0

2.14.2

2.14.1

2.14.0

2.13.5

2.13.4

2.13.3

2.13.2

2.13.1 yanked

Reason this release was yanked:

Wrong metadata under python 3.10 for typing-extensions

2.13.0 yanked

Reason this release was yanked:

Wrong metadata under python 3.10 for typing-extensions

2.12.14

2.12.13

2.12.12

2.12.11

2.12.10

2.12.9

2.12.8

2.12.7

2.12.6

2.12.5

2.12.4

2.12.3

2.12.2

2.12.1

2.12.0

2.11.7

2.11.6

2.11.5

2.11.4

2.11.3

2.11.2

2.11.1

2.11.0

2.10.0

2.9.3

2.9.2

2.9.1

2.9.0

2.8.6

2.8.5

2.8.4

2.8.3

2.8.2

2.8.2.dev0 pre-release

2.8.1

2.8.0

2.7.3

2.7.2

2.7.1

2.7.0

2.6.6

2.6.5

2.6.4

2.6.3

2.6.2

2.6.1

2.6.0

2.6.0.dev0 pre-release

2.5.8

2.5.7

2.5.6

2.5.5

2.5.4

2.5.3

2.5.2

2.5.1

2.5

2.4.2

2.4.1

2.4.0

2.3.3

2.3.2

2.3.1

2.3.0

2.2.5

2.2.4

2.2.3

2.2.2

2.2.1

2.2.0

2.2.0.dev1 pre-release

2.2.0.dev0 pre-release

2.1.0

2.1.0.dev0 pre-release

2.0.4

2.0.3

2.0.2

2.0.1

2.0

2.0.0.dev4 pre-release

2.0.0.dev3 pre-release

2.0.0.dev2 pre-release

2.0.0.dev1 pre-release

2.0.0.dev0 pre-release

1.6.6

1.6.5

1.6.4

1.6.3

1.6.2

1.6.1

1.6.0

1.5.3

1.5.2

1.5.1

1.5.0

1.4.9

1.4.8

1.4.7

1.4.6

1.4.5

1.4.4

1.4.3

1.4.2

1.4.1

1.4.0

1.3.8

1.3.7

1.3.6

1.3.5

1.3.4

1.3.3

1.3.2

1.3.1

1.3.0

1.2.1

1.2.0

1.1.1

1.1.0

1.0.1

1.0.0

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page