Release Notes¶

vibelinter 1.0a1 (2025-12-03)¶

Update VBL101 (Blank Line Elimination) to allow blank lines immediately surrounding nested function and class definitions for better readability.

Fix VBL201 (Import Hub Enforcement) to correctly recognize private aliases (e.g., import x as _x) in simple imports, preventing false positive violations.

Add support for CPython 3.10 to 3.14.
Add support for PyPy 3.10 and 3.11.
CLI: Interactive command-line interface with check command supporting multiple output formats (text, JSON), context display, rule selection, and parallel processing.
Configuration: Support for pyproject.toml configuration files with rule selection, file path filtering, context line configuration, and per-rule settings.
Core linting engine with LibCST integration for single-pass AST analysis, rule orchestration, and violation collection across multiple Python files.
VBL101: Blank line elimination rule detects unnecessary blank lines in function bodies while preserving blank lines inside docstrings and string literals.
VBL201: Import hub enforcement rule ensures non-private imports only appear in designated hub modules (configurable via hub_patterns) to maintain architectural consistency and prevent namespace pollution.
VBL202: Import spaghetti prevention rule detects excessive relative import depth (more than 2 parent levels) and enforces proper import structure in re-export hub modules.