NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #781 most downloaded on PyPI
Lint your Python architecture
Last release 1 months ago
04 Sep 2026
Release timing varies
gaps range from 9 days to 5 months
Nearly every release is documented
notes for 40 of 40 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
51 releases · first in 2019
Add support for lazy imports to the explore UI and drawgraph command.
drawgraph command.Add broken_contract_guidance option to contracts, for explaining how to fix them when they're broken.
broken_contract_guidance option to contracts, for explaining how to fix them when they're broken.TextField for multi-line text configuration values.--no-logo option to hide the logo in terminal output.One column per quarter.
Add module counts option to the explore UI and drawgraph command.
drawgraph command.Improve error message when root package is a single-file module.
Add --version flag to lint-imports and import-linter commands.
--version flag to lint-imports and import-linter commands.fastapi and uvicorn optional via the ui extra (pip install import-linter[ui]).fastapi and uvicorn in pyproject.toml.Add import-linter group command, with import-linter lint alias.
import-linter group command, with import-linter lint alias.import-linter explore command.import-linter drawgraph command.Support passing namespaces as root packages, not just portions.
Fix logo display bug on Windows (fall back to simpler heading) https://github.com/seddonym/import-linter/issues/309
Print using rich instead of click.
Add acyclic_siblings contract type.
acyclic_siblings contract type.IntegerField.Add version to pyproject.toml
Add version to pyproject.toml
Correct documentation that incorrectly stated that protected modules are allowed to import each other.
* Add protected contract type.
Fix incorrect handling of unicode characters in TOML files on Windows.
tox -echeck).Add as_packages field to forbidden contracts.
Add support for wildcards in layers contract containers.
helpers.pop_imports.Add support for wildcards in forbidden and independence contracts.
Add support for non-independent sibling modules in layer contracts.
importlinter.contracts.layers, Layer and LayerField
have changed their API slightly. This could impact custom
contract types depending on these classes.Add ability to exclude imports made in type checking guards via exclude_type_checking_imports setting.
exclude_type_checking_imports setting.Officially support Python 3.12.
click version 6.0 and 7.0 (#191).Fix bug that was preventing sibling layers being used in a containerless contract.
* Update to Grimp 3.0.
Use Grimp's find_illegal_dependencies_for_layers method in independence contracts.
Recursive wildcard support for ignored imports.
Forbidden contracts: when include_external_packages is true, error if an external subpackage is a forbidden module.
* Add caching.
Switch from optional dependency of toml to required dependency of tomli for Python versions < 3.11.
toml to required dependency of tomli for Python versions < 3.11.Add exhaustiveness option to layers contracts.
Officially support Python 3.11.
Include py.typed file in package data to support type checking
Add Python API for reading configuration.
Officially support Python 3.10.
Fix bug with ignoring external imports that occur multiple times in the same module.
Wildcard support for ignored imports.
* Fix TOML installation bug.
Add support for TOML configuration files.
* Support Click version 8.
Add allow_indirect_imports to Forbidden Contract type
Use a SetField for ignore_imports options.
\w characters in import exceptions.* Bring 1.1 out of beta.
Update to Grimp v1.2, significantly increasing speed of building the graph.
Allow contracts to mutate the graph without affecting other contracts.
* Officially support Python 3.8.
Make containers optional in Layers contracts.
Add https://pre-commit.com configuration.
Update to Grimp v1.0b10, fixing Windows incompatibility.
Update to Grimp v1.0b9, fixing error with using importlib.util.find_spec.
Improve error handling of modules/containers not in the graph.
Include the ability to build the graph with external packages.
* First usable alpha release.
* Release blank project on PyPI.
Your coding agent can read these notes before it upgrades. Set up the MCP server →