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 Aug 17, 2026
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:
Latest release

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 Aug 17, 2026
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.3.1.tar.gz (439.5 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.3.1-py3-none-any.whl (286.7 kB view details)

Uploaded Python 3

File details

Details for the file astroid-4.3.1.tar.gz.

File metadata

  • Download URL: astroid-4.3.1.tar.gz
  • Upload date:
  • Size: 439.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for astroid-4.3.1.tar.gz
Algorithm Hash digest
SHA256 bb359253d8ced6635a3881c17ebcbbc0e0b65ca23b555a9bd03c92a3cbf4caa7
MD5 826cf13d4bad8c9aa5a6d81e61033d5e
BLAKE2b-256 3519e2dcf379dacfc70abd22a937a84d49ce6151223a989842541155978b353e

See more details on using hashes here.

Provenance

The following attestation bundles were made for astroid-4.3.1.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.3.1-py3-none-any.whl.

File metadata

  • Download URL: astroid-4.3.1-py3-none-any.whl
  • Upload date:
  • Size: 286.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for astroid-4.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 de41129d6de1e86cfedb698b8064c83a881853f98d6ea34de9e711f6bb420dfe
MD5 73cd66ef685990845b64b03b0dc66805
BLAKE2b-256 c1571df16329b79612616ee1725d6e0f03c21fac5e2ca185fed8148bfd468eec

See more details on using hashes here.

Provenance

The following attestation bundles were made for astroid-4.3.1-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

This release

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

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