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 Oct 11, 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 Oct 11, 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.1.tar.gz (405.4 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.1-py3-none-any.whl (276.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: astroid-4.0.1.tar.gz
  • Upload date:
  • Size: 405.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for astroid-4.0.1.tar.gz
Algorithm Hash digest
SHA256 0d778ec0def05b935e198412e62f9bcca8b3b5c39fdbe50b0ba074005e477aab
MD5 051c60ab412e828323ef5743202f4948
BLAKE2b-256 a7d16eee8726a863f28ff50d26c5eacb1a590f96ccbb273ce0a8c047ffb10f5a

See more details on using hashes here.

Provenance

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

File metadata

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

File hashes

Hashes for astroid-4.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 37ab2f107d14dc173412327febf6c78d39590fdafcb44868f03b6c03452e3db0
MD5 a8258e188c00e786e6e2f02d4cf81dc2
BLAKE2b-256 47f4034361a9cbd9284ef40c8ad107955ede4efae29cbc17a059f63f6569c06a

See more details on using hashes here.

Provenance

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

4.3.1

2 files

4.3.0

2 files

Pre-release

4.2.0b5

2 files

Pre-release

4.2.0b4

2 files

Pre-release

4.2.0b3

2 files

Pre-release

4.2.0b2

2 files

Pre-release

4.2.0b1

2 files

4.1.2

2 files

4.1.1

2 files

4.1.0

2 files

4.0.4

2 files

4.0.3

2 files

4.0.2

2 files

This release

4.0.1 This release

2 files

4.0.0

2 files

Pre-release

4.0.0rc0

2 files

Pre-release

4.0.0b3

2 files

Pre-release

4.0.0b2

2 files

Pre-release

4.0.0b1

2 files

Pre-release

4.0.0b0

2 files

Pre-release

4.0.0a0

2 files

3.3.11

2 files

3.3.10

2 files

3.3.9

2 files

3.3.8

2 files

Yanked

3.3.7

2 files

Yanked reason: Creates crash with cryptography module in pylint

3.3.6

2 files

3.3.5

2 files

3.3.4

2 files

3.3.3

2 files

3.3.2

2 files

3.3.1

2 files

3.3.0

2 files

3.2.4

2 files

3.2.3

2 files

3.2.2

2 files

3.2.1

2 files

3.2.0

2 files

3.1.0

2 files

3.0.3

2 files

3.0.2

2 files

3.0.1

2 files

3.0.0

2 files

Pre-release

3.0.0b0

2 files

Pre-release

3.0.0a9

2 files

Pre-release

3.0.0a8

2 files

Pre-release

3.0.0a7

2 files

Pre-release

3.0.0a6

2 files

Pre-release

3.0.0a5

2 files

Pre-release

3.0.0a4

2 files

Pre-release

3.0.0a3

2 files

Pre-release

3.0.0a2

2 files

Pre-release

3.0.0a1

2 files

2.15.8

2 files

2.15.7

2 files

2.15.6

2 files

2.15.5

2 files

2.15.4

2 files

2.15.3

2 files

2.15.2

2 files

2.15.1

2 files

2.15.0

2 files

2.14.2

2 files

2.14.1

2 files

2.14.0

2 files

2.13.5

2 files

2.13.4

2 files

2.13.3

2 files

2.13.2

2 files

Yanked

2.13.1

2 files

Yanked reason: Wrong metadata under python 3.10 for typing-extensions

Yanked

2.13.0

2 files

Yanked reason: Wrong metadata under python 3.10 for typing-extensions

2.12.14

2 files

2.12.13

2 files

2.12.12

2 files

2.12.11

2 files

2.12.10

2 files

2.12.9

2 files

2.12.8

2 files

2.12.7

2 files

2.12.6

2 files

2.12.5

2 files

2.12.4

2 files

2.12.3

2 files

2.12.2

2 files

2.12.1

2 files

2.12.0

2 files

2.11.7

2 files

2.11.6

2 files

2.11.5

2 files

2.11.4

2 files

2.11.3

2 files

2.11.2

2 files

2.11.1

2 files

2.11.0

2 files

2.10.0

2 files

2.9.3

2 files

2.9.2

2 files

2.9.1

2 files

2.9.0

2 files

2.8.6

2 files

2.8.5

2 files

2.8.4

2 files

2.8.3

2 files

2.8.2

2 files

Pre-release

2.8.2.dev0

2 files

2.8.1

2 files

2.8.0

2 files

2.7.3

2 files

2.7.2

2 files

2.7.1

2 files

2.7.0

2 files

2.6.6

2 files

2.6.5

2 files

2.6.4

2 files

2.6.3

2 files

2.6.2

2 files

2.6.1

2 files

2.6.0

2 files

Pre-release

2.6.0.dev0

2 files

2.5.8

2 files

2.5.7

2 files

2.5.6

2 files

2.5.5

2 files

2.5.4

2 files

2.5.3

2 files

2.5.2

2 files

2.5.1

2 files

2.5

2 files

2.4.2

2 files

2.4.1

2 files

2.4.0

2 files

2.3.3

2 files

2.3.2

2 files

2.3.1

2 files

2.3.0

2 files

2.2.5

2 files

2.2.4

2 files

2.2.3

2 files

2.2.2

2 files

2.2.1

2 files

2.2.0

2 files

Pre-release

2.2.0.dev1

2 files

Pre-release

2.2.0.dev0

2 files

2.1.0

2 files

Pre-release

2.1.0.dev0

2 files

2.0.4

2 files

2.0.3

2 files

2.0.2

2 files

2.0.1

2 files

2.0

2 files

Pre-release

2.0.0.dev4

2 files

Pre-release

2.0.0.dev3

2 files

Pre-release

2.0.0.dev2

2 files

Pre-release

2.0.0.dev1

2 files

Pre-release

2.0.0.dev0

2 files

1.6.6

2 files

1.6.5

2 files

1.6.4

2 files

1.6.3

2 files

1.6.2

2 files

1.6.1

2 files

1.6.0

2 files

1.5.3

2 files

1.5.2

2 files

1.5.1

2 files

1.5.0

2 files

1.4.9

2 files

1.4.8

2 files

1.4.7

2 files

1.4.6

2 files

1.4.5

2 files

1.4.4

2 files

1.4.3

2 files

1.4.2

2 files

1.4.1

2 files

1.4.0

2 files

1.3.8

2 files

1.3.7

2 files

1.3.6

2 files

1.3.5

2 files

1.3.4

2 files

1.3.3

2 files

1.3.2

2 files

1.3.1

2 files

1.3.0

2 files

1.2.1

1 file

1.2.0

1 file

1.1.1

1 file

1.1.0

1 file

1.0.1

1 file

1.0.0

1 file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page