A flake8 plugin to enforce object calisthenics rule "one dot per line"
Project description
Flake8 One Dot Per Line Plugin
flake8-one-dot
is a Flake8 plugin that enforces the Object Calisthenics principle of "One Dot Per Line" to promote better encapsulation and minimize the violation of the law of Demeter in Python code. It achieves this by flagging lines that contain multiple attribute accesses, which can indicate a code smell related to excessive knowledge of internal structures.
Installation
Install flake8-one-dot
via pip:
pip install flake8-one-dot
Usage
After installation, the plugin will automatically be activated when you run Flake8:
flake8 your_project_directory
Any line with more than one dot will be reported as a violation, prompting a refactoring suggestion to improve encapsulation.
Configuration
flake8-one-dot
does not require any specific configurations and works out-of-the-box with the default Flake8 settings.
Rules Enforced
- FOD100: Too many dots per line (more than one dot found)
This rule helps developers recognize lines of code that may be overly reliant on object internals or chain multiple method calls in ways that could complicate future refactoring and maintenance.
Motivation
The "One Dot Per Line" rule helps maintain clean separation between objects and their internal data, encouraging methods to be short and ensuring that objects interact with each other through well-defined interfaces. This reduces coupling and enhances modularity, making the codebase easier to understand and maintain.
Contributing
We appreciate contributions from the community to make flake8-one-dot
more effective or to fix potential bugs. If you have suggestions or want to contribute code, please feel free to fork the repository, make your changes, and submit a pull request.
License
This plugin is distributed under the MIT License. The full license text can be found in the LICENSE
file included with the source code.
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 flake8_one_dot-0.1.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5c57b415c1c0833325ca5d401ce95962223978a8e508563d41cb3b8cd13ea273 |
|
MD5 | 96c70b3e2f2d831fecead49208197923 |
|
BLAKE2b-256 | 3dbabcae4e408542bc839d4c8fc3ec06870d7c73d156a0e2db1bfacec8f0d59e |