Layer Linter checks that your project follows a custom-defined layered architecture.
Project description
Layer Linter
Layer Linter checks that your project follows a custom-defined layered architecture.
Free software: BSD license
Documentation: https://layer-linter.readthedocs.io.
Overview
Layer Linter can be used as part of an automated test suite to check that you are following a self-imposed layered architecture within your Python project. This is particularly useful if you are working on a complex codebase within a team, when you want to enforce a particular architectural style.
To define how layers work within your project, you create a layers.yaml file. This file prescribes the order in which different modules within your project may import from each other.
Running the layer-lint command will parse the file, analyse your project’s internal dependencies within your project, and error if you are violating your prescribed architecture.
Quick start
Install Layer Linter:
pip install layer-linter
Create a layers.yaml in the root of your project, in this format:
My Layers Contract:
packages:
- myproject.packageone
- myproject.packagetwo
- myproject.packagethree
layers:
- highlevelmodule
- mediumlevelmodule
- lowlevelmodule
From your project root, run:
layer-lint myproject
If your code violates the contract, you will see an error message as follows:
Contracts: 0 kept, 1 broken.
- Broken contract My Layers Contract:
- myproject.packagetwo.mediumlevelmodule not allowed to import myproject.packagetwo.highlevelmodule.
History
0.1.0 (2018-06-20)
First release on PyPI.
0.2.0 (2018-06-23)
Look for layers.yaml in current working directory.
0.3.0 (2018-06-24)
Rename command to layer-lint.
Changed order of layers in layers.yaml to be listed high level to low level.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for layer_linter-0.3.0-py34,py35,py36-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3f4bf6e83e4609f471997a252f39b75cbdd7afe690ab53635c7cd1e82d2843b1 |
|
MD5 | 892de6db1aa062e8aca76bca6ca80aa1 |
|
BLAKE2b-256 | 846f711aa6d5d5ddcb2fd5cefe6baaf72beea39923a4769ac0e3c019b13ec2fe |