thailint 0.15.0__tar.gz → 0.16.0__tar.gz

{thailint-0.15.0 → thailint-0.16.0}/CHANGELOG.md

@@ -27,6 +27,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 
 - **Stateless Class Linter** - Detect Python classes without state that should be module-level functions
+
+### Documentation
+
+- **Parallel Processing** - Added `--parallel` flag documentation to CLI reference and README
+  - Documents multi-core processing with ProcessPoolExecutor (up to 8 workers)
+  - Explains automatic fallback to sequential for small file counts
+  - Provides usage guidance and performance expectations
+
+## [0.15.4] - 2026-01-26
+
+### Added
+
+- **Inline Justifications for Lazy-Ignores** (#147) - Allow inline justifications directly next to ignore statements
+  - Syntax: `# noqa: PLR0912 - state machine inherently complex`
+  - Delimiter: ` - ` (space-dash-space) followed by justification text
+  - Inline justifications take precedence over header-based Suppressions
+  - Minimum justification length: 10 characters (configurable)
+  - New config options: `allow_inline_justifications`, `min_justification_length`
+  - Supports all ignore types: noqa, type:ignore, pylint:disable, nosec, pyright:ignore
+  - 27 new tests for inline justification functionality
+
+## [0.15.3] - 2026-01-26
+
+### Fixed
+
+- **DRY Linter**: Ignore directives (`# thailint: ignore-start dry` / `ignore-end`) now work correctly for both duplicate code and duplicate constant detection (#144)
   - AST-based detection of classes without `__init__`/`__new__` constructors
   - Detects classes without instance state (`self.attr` assignments)
   - Excludes ABC, Protocol, and decorated classes (legitimate patterns)

{thailint-0.15.0 → thailint-0.16.0}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: thailint
-Version: 0.15.0
+Version: 0.16.0
 Summary: The AI Linter - Enterprise-grade linting and governance for AI-generated code across multiple languages
 License: MIT
 License-File: LICENSE
-Keywords: linter,ai,code-quality,static-analysis,file-placement,governance,multi-language,cli,docker,python,performance,typescript
+Keywords: linter,ai,code-quality,static-analysis,file-placement,governance,multi-language,cli,docker,python,performance,typescript,rust
 Author: Steve Jackson
 Requires-Python: >=3.11,<4.0
 Classifier: Development Status :: 4 - Beta
@@ -24,9 +24,11 @@ Classifier: Topic :: Software Development :: Testing
 Classifier: Topic :: Utilities
 Classifier: Typing :: Typed
 Requires-Dist: click (>=8.1.0,<9.0.0)
+Requires-Dist: loguru (>=0.7.3,<0.8.0)
 Requires-Dist: pyprojroot (>=0.3.0,<0.4.0)
 Requires-Dist: pyyaml (>=6.0,<7.0)
 Requires-Dist: tree-sitter (>=0.25.2,<0.26.0)
+Requires-Dist: tree-sitter-rust (>=0.23.2,<0.24.0)
 Requires-Dist: tree-sitter-typescript (>=0.23.2,<0.24.0)
 Project-URL: Documentation, https://thai-lint.readthedocs.io/
 Project-URL: Homepage, https://github.com/be-wise-be-kind/thai-lint
@@ -37,7 +39,7 @@ Description-Content-Type: text/markdown
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
-[![PyPI](https://img.shields.io/pypi/v/thai-lint)](https://pypi.org/project/thai-lint/)
+[![PyPI](https://img.shields.io/pypi/v/thailint)](https://pypi.org/project/thailint/)
 [![Documentation](https://readthedocs.org/projects/thai-lint/badge/?version=latest)](https://thai-lint.readthedocs.io/)
 
 **The AI Linter** - Catch the mistakes AI coding assistants keep making.
@@ -47,7 +49,7 @@ thailint detects anti-patterns that AI tools frequently introduce: duplicate cod
 ## Installation
 
 ```bash
-pip install thai-lint
+pip install thailint
 ```
 
 Or with Docker:
@@ -82,8 +84,9 @@ That's it. See violations, fix them, ship better code.
 | **Method Property** | Methods that should be @property | `thailint method-property src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/method-property-linter/) |
 | **File Placement** | Files in wrong directories | `thailint file-placement src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/file-placement-linter/) |
 | **Lazy Ignores** | Unjustified linting suppressions | `thailint lazy-ignores src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/lazy-ignores-linter/) |
-| **Print Statements** | Debug prints left in code | `thailint print-statements src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/print-statements-linter/) |
+| **Improper Logging** | Print statements and conditional verbose patterns | `thailint improper-logging src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/improper-logging-linter/) |
 | **Stringly Typed** | Strings that should be enums | `thailint stringly-typed src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/stringly-typed-linter/) |
+| **LBYL** | Look Before You Leap anti-patterns | `thailint lbyl src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/lbyl-linter/) |
 
 ## Configuration
 
@@ -150,10 +153,12 @@ See [How to Ignore Violations](https://thai-lint.readthedocs.io/en/latest/how-to
 - name: Run thailint
   run: |
     pip install thai-lint
-    thailint dry src/
-    thailint nesting src/
+    thailint --parallel dry src/
+    thailint --parallel nesting src/
 ```
 
+Use `--parallel` for faster linting on large codebases (2-4x speedup on multi-core systems).
+
 Exit codes: `0` = success, `1` = violations found, `2` = error.
 
 ## Documentation

{thailint-0.15.0 → thailint-0.16.0}/README.md

@@ -2,7 +2,7 @@
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
-[![PyPI](https://img.shields.io/pypi/v/thai-lint)](https://pypi.org/project/thai-lint/)
+[![PyPI](https://img.shields.io/pypi/v/thailint)](https://pypi.org/project/thailint/)
 [![Documentation](https://readthedocs.org/projects/thai-lint/badge/?version=latest)](https://thai-lint.readthedocs.io/)
 
 **The AI Linter** - Catch the mistakes AI coding assistants keep making.
@@ -12,7 +12,7 @@ thailint detects anti-patterns that AI tools frequently introduce: duplicate cod
 ## Installation
 
 ```bash
-pip install thai-lint
+pip install thailint
 ```
 
 Or with Docker:
@@ -47,8 +47,9 @@ That's it. See violations, fix them, ship better code.
 | **Method Property** | Methods that should be @property | `thailint method-property src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/method-property-linter/) |
 | **File Placement** | Files in wrong directories | `thailint file-placement src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/file-placement-linter/) |
 | **Lazy Ignores** | Unjustified linting suppressions | `thailint lazy-ignores src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/lazy-ignores-linter/) |
-| **Print Statements** | Debug prints left in code | `thailint print-statements src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/print-statements-linter/) |
+| **Improper Logging** | Print statements and conditional verbose patterns | `thailint improper-logging src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/improper-logging-linter/) |
 | **Stringly Typed** | Strings that should be enums | `thailint stringly-typed src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/stringly-typed-linter/) |
+| **LBYL** | Look Before You Leap anti-patterns | `thailint lbyl src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/lbyl-linter/) |
 
 ## Configuration
 
@@ -115,10 +116,12 @@ See [How to Ignore Violations](https://thai-lint.readthedocs.io/en/latest/how-to
 - name: Run thailint
   run: |
     pip install thai-lint
-    thailint dry src/
-    thailint nesting src/
+    thailint --parallel dry src/
+    thailint --parallel nesting src/
 ```
 
+Use `--parallel` for faster linting on large codebases (2-4x speedup on multi-core systems).
+
 Exit codes: `0` = success, `1` = violations found, `2` = error.
 
 ## Documentation

{thailint-0.15.0 → thailint-0.16.0}/pyproject.toml

@@ -17,7 +17,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "thailint"
-version = "0.15.0"
+version = "0.16.0"
 description = "The AI Linter - Enterprise-grade linting and governance for AI-generated code across multiple languages"
 authors = ["Steve Jackson"]
 license = "MIT"
@@ -38,6 +38,7 @@ keywords = [
     "python",
     "performance",
     "typescript",
+    "rust",
 ]
 classifiers = [
     "Development Status :: 4 - Beta",
@@ -75,7 +76,9 @@ click = "^8.1.0"
 pyyaml = "^6.0"
 tree-sitter = "^0.25.2"
 tree-sitter-typescript = "^0.23.2"
+tree-sitter-rust = "^0.23.2"
 pyprojroot = "^0.3.0"
+loguru = "^0.7.3"
 
 [tool.poetry.group.dev.dependencies]
 # Core testing and linting
@@ -102,7 +105,6 @@ xenon = "^0.9.3"
 # Comprehensive security
 safety = "^3.2.11"
 pip-audit = "^2.8.0"
-loguru = "^0.7.3"
 pytest-xdist = "^3.8.0"
 
 [tool.poetry.scripts]

thailint-0.16.0/src/analyzers/rust_base.py

@@ -0,0 +1,155 @@
+"""
+Purpose: Base class for Rust AST analysis with tree-sitter parsing
+
+Scope: Common tree-sitter initialization, parsing, and traversal utilities for Rust
+
+Overview: Provides shared infrastructure for Rust code analysis using tree-sitter parser.
+    Implements common tree-sitter initialization with language setup and parser configuration.
+    Provides reusable parsing methods that convert Rust source to AST nodes. Includes
+    shared traversal utilities for walking AST trees recursively and finding nodes by type.
+    Delegates context-specific detection (test functions, async functions) to rust_context
+    module. Serves as foundation for specialized Rust analyzers (unwrap abuse, clone abuse).
+
+Dependencies: tree-sitter, tree-sitter-rust (optional), src.analyzers.rust_context
+
+Exports: RustBaseAnalyzer class with parsing and traversal utilities,
+    TREE_SITTER_RUST_AVAILABLE constant for runtime detection
+
+Interfaces: parse_rust(code), walk_tree(node, node_type), extract_node_text(node),
+    is_inside_test(node), is_async_function(node)
+
+Implementation: Tree-sitter parser singleton, recursive AST traversal, composition pattern
+    with rust_context helpers
+
+Suppressions:
+    - type:ignore[assignment]: Tree-sitter RUST_PARSER fallback when import fails
+    - type:ignore[assignment,misc]: Tree-sitter Node type alias (optional dependency fallback)
+"""
+
+from typing import Any
+
+from src.analyzers import rust_context
+
+try:
+    import tree_sitter_rust as tsrust
+    from tree_sitter import Language, Node, Parser
+
+    RUST_LANGUAGE = Language(tsrust.language())
+    RUST_PARSER = Parser(RUST_LANGUAGE)
+    TREE_SITTER_RUST_AVAILABLE = True
+except ImportError:
+    TREE_SITTER_RUST_AVAILABLE = False
+    RUST_PARSER = None  # type: ignore[assignment]
+    Node = Any  # type: ignore[assignment,misc]
+
+
+class RustBaseAnalyzer:
+    """Base analyzer for Rust code using tree-sitter."""
+
+    def __init__(self) -> None:
+        """Initialize Rust base analyzer."""
+        self.tree_sitter_available = TREE_SITTER_RUST_AVAILABLE
+
+    def parse_rust(self, code: str) -> Node | None:
+        """Parse Rust code to AST using tree-sitter.
+
+        Args:
+            code: Rust source code to parse
+
+        Returns:
+            Tree-sitter AST root node, or None if parsing fails or tree-sitter unavailable
+        """
+        if not TREE_SITTER_RUST_AVAILABLE or RUST_PARSER is None:
+            return None
+
+        tree = RUST_PARSER.parse(bytes(code, "utf8"))
+        return tree.root_node
+
+    def walk_tree(self, node: Node, node_type: str) -> list[Node]:
+        """Find all nodes of a specific type in the AST.
+
+        Recursively walks the tree and collects all nodes matching the given type.
+
+        Args:
+            node: Root tree-sitter node to search from
+            node_type: Tree-sitter node type to find (e.g., "function_item")
+
+        Returns:
+            List of all matching nodes
+        """
+        if not TREE_SITTER_RUST_AVAILABLE or node is None:
+            return []
+
+        nodes: list[Node] = []
+        self._walk_tree_recursive(node, node_type, nodes)
+        return nodes
+
+    def _walk_tree_recursive(self, node: Node, node_type: str, nodes: list[Node]) -> None:
+        """Recursively walk tree to find nodes of specific type.
+
+        Args:
+            node: Current tree-sitter node
+            node_type: Node type to find
+            nodes: List to accumulate matching nodes
+        """
+        if node.type == node_type:
+            nodes.append(node)
+
+        for child in node.children:
+            self._walk_tree_recursive(child, node_type, nodes)
+
+    def extract_node_text(self, node: Node) -> str:
+        """Extract text content from a tree-sitter node.
+
+        Args:
+            node: Tree-sitter node
+
+        Returns:
+            Decoded text content of the node
+        """
+        text = node.text
+        if text is None:
+            return ""
+        return text.decode()
+
+    def extract_identifier_name(self, node: Node) -> str:
+        """Extract identifier name from node children.
+
+        Common pattern for extracting names from function/struct declarations.
+
+        Args:
+            node: Node to extract identifier from
+
+        Returns:
+            Identifier name or "anonymous" fallback
+        """
+        for child in node.children:
+            if child.type == "identifier":
+                return self.extract_node_text(child)
+        return "anonymous"
+
+    def is_inside_test(self, node: Node) -> bool:
+        """Check if node is inside a test function or module.
+
+        Delegates to rust_context module for implementation.
+
+        Args:
+            node: Tree-sitter node to check
+
+        Returns:
+            True if the node is inside a test function or test module
+        """
+        return rust_context.is_inside_test(node)
+
+    def is_async_function(self, node: Node) -> bool:
+        """Check if a function_item is async.
+
+        Delegates to rust_context module for implementation.
+
+        Args:
+            node: Function item node to check
+
+        Returns:
+            True if the function is declared as async
+        """
+        return rust_context.is_async_function(node)

thailint-0.16.0/src/analyzers/rust_context.py

@@ -0,0 +1,141 @@
+"""
+Purpose: Rust-specific AST context detection utilities
+
+Scope: Helper functions for detecting test contexts and async functions in Rust code
+
+Overview: Provides standalone helper functions for analyzing Rust AST context information.
+    Includes functions for detecting if code is inside a test function or module by checking
+    for #[test] or #[cfg(test)] attributes on preceding siblings, and for detecting async
+    functions by checking for function_modifiers. These utilities are designed to be used
+    in composition with RustBaseAnalyzer for Rust-specific lint rules that need to understand
+    code context.
+
+Dependencies: tree-sitter (for Node type when available)
+
+Exports: is_inside_test, is_async_function, has_test_attribute, has_cfg_test_attribute
+
+Interfaces: All functions take tree-sitter Node objects and return bool
+
+Implementation: Sibling-based attribute lookup for Rust AST structure, iterative parent
+    traversal for context detection
+
+Suppressions:
+    - misc,assignment: Node type alias when tree-sitter optional dependency unavailable
+"""
+
+from typing import Any
+
+try:
+    from tree_sitter import Node
+
+    TREE_SITTER_AVAILABLE = True
+except ImportError:
+    TREE_SITTER_AVAILABLE = False
+    Node = Any  # type: ignore[misc,assignment]
+
+
+def _get_node_text(node: Node) -> str:
+    """Get decoded text from a node.
+
+    Args:
+        node: Tree-sitter node
+
+    Returns:
+        Decoded text content
+    """
+    return node.text.decode() if node.text else ""
+
+
+def has_test_attribute(function_node: Node) -> bool:
+    """Check if a function has #[test] attribute as preceding sibling.
+
+    Args:
+        function_node: Function item node
+
+    Returns:
+        True if function has #[test] attribute
+    """
+    prev_sibling = function_node.prev_sibling
+    while prev_sibling is not None and prev_sibling.type == "attribute_item":
+        if "test" in _get_node_text(prev_sibling):
+            return True
+        prev_sibling = prev_sibling.prev_sibling
+    return False
+
+
+def has_cfg_test_attribute(mod_node: Node) -> bool:
+    """Check if a module has #[cfg(test)] attribute as preceding sibling.
+
+    Args:
+        mod_node: Module item node
+
+    Returns:
+        True if module has #[cfg(test)] attribute
+    """
+    prev_sibling = mod_node.prev_sibling
+    while prev_sibling is not None and prev_sibling.type == "attribute_item":
+        if "cfg(test)" in _get_node_text(prev_sibling):
+            return True
+        prev_sibling = prev_sibling.prev_sibling
+    return False
+
+
+def is_inside_test(node: Node) -> bool:
+    """Check if node is inside a test function or module.
+
+    Walks up the tree looking for #[test] or #[cfg(test)] attributes.
+
+    Args:
+        node: Tree-sitter node to check
+
+    Returns:
+        True if the node is inside a test function or test module
+    """
+    current: Node | None = node
+    while current is not None:
+        if _is_test_context(current):
+            return True
+        current = current.parent
+    return False
+
+
+def _is_test_context(node: Node) -> bool:
+    """Check if a node represents a test context.
+
+    Args:
+        node: Node to check
+
+    Returns:
+        True if node is a test function or test module
+    """
+    if node.type == "function_item":
+        return has_test_attribute(node)
+    if node.type == "mod_item":
+        return has_cfg_test_attribute(node)
+    return False
+
+
+def is_async_function(node: Node) -> bool:
+    """Check if a function_item is async.
+
+    Args:
+        node: Function item node to check
+
+    Returns:
+        True if the function is declared as async
+    """
+    return any(
+        child.type == "function_modifiers" and _has_async_modifier(child) for child in node.children
+    )
+
+
+def _has_async_modifier(modifiers_node: Node) -> bool:
+    """Check if function_modifiers node contains async keyword.
+
+    Args:
+        modifiers_node: The function_modifiers node
+
+    Returns:
+        True if async keyword is present
+    """
+    return any(modifier.type == "async" for modifier in modifiers_node.children)

{thailint-0.15.0 → thailint-0.16.0}/src/cli/config.py

@@ -21,22 +21,18 @@ Implementation: Uses Click decorators for command definition, supports multiple
     validates configuration changes before saving, uses template file for init-config generation
 """
 
-import logging
 import sys
 from pathlib import Path
 
 import click
 import yaml
+from loguru import logger
 
 from src.config import ConfigError, save_config, validate_config
 
 from .config_merge import perform_merge
 from .main import cli
 
-# Configure module logger
-logger = logging.getLogger(__name__)
-
-
 # =============================================================================
 # Config Command Group
 # =============================================================================
@@ -150,12 +146,14 @@ def config_get(ctx: click.Context, key: str) -> None:
 
 def _convert_value_type(value: str) -> bool | int | float | str:
     """Convert string value to appropriate type."""
+    from contextlib import suppress
+
     if value.lower() in ["true", "false"]:
         return value.lower() == "true"
-    if value.isdigit():
-        return int(value)
-    if value.replace(".", "", 1).isdigit() and value.count(".") == 1:
-        return float(value)
+    # Use EAFP pattern for numeric conversion
+    for converter in (int, float):
+        with suppress(ValueError):
+            return converter(value)
     return value
 
 
@@ -175,8 +173,7 @@ def _save_and_report_success(
     """Save configuration and report success."""
     save_config(cfg, config_path)
     click.echo(f"Set {key} = {value}")
-    if verbose:
-        logger.info(f"Configuration updated: {key}={value}")
+    logger.debug(f"Configuration updated: {key}={value}")
 
 
 @config.command("set")
@@ -254,8 +251,7 @@ def config_reset(ctx: click.Context, yes: bool) -> None:
         save_config(DEFAULT_CONFIG.copy(), config_path)
         click.echo("Configuration reset to defaults")
 
-        if ctx.obj.get("verbose"):
-            logger.info("Configuration reset to defaults")
+        logger.debug("Configuration reset to defaults")
     except ConfigError as e:
         click.echo(f"Error resetting configuration: {e}", err=True)
         sys.exit(1)
@@ -460,7 +456,6 @@ def hello(ctx: click.Context, name: str, uppercase: bool) -> None:
         thai-lint hello --name Bob --uppercase
     """
     config = ctx.obj["config"]
-    verbose = ctx.obj.get("verbose", False)
 
     # Get greeting from config or use default
     greeting_template = config.get("greeting", "Hello")
@@ -474,5 +469,4 @@ def hello(ctx: click.Context, name: str, uppercase: bool) -> None:
     # Output greeting
     click.echo(message)
 
-    if verbose:
-        logger.info(f"Greeted {name} with template '{greeting_template}'")
+    logger.debug(f"Greeted {name} with template '{greeting_template}'")

{thailint-0.15.0 → thailint-0.16.0}/src/cli/linters/__init__.py

@@ -6,8 +6,9 @@ Scope: Export and registration of all linter CLI commands (nesting, srp, dry, ma
 Overview: Package initialization that imports all linter command modules to trigger their registration
     with the main CLI group via Click decorators. Each submodule defines commands using @cli.command()
     decorators that automatically register with the CLI when imported. Organized by logical grouping:
-    structure_quality (nesting, srp), code_smells (dry, magic-numbers), code_patterns (print-statements,
+    structure_quality (nesting, srp), code_smells (dry, magic-numbers), code_patterns (improper-logging,
     method-property, stateless-class), structure (file-placement, pipeline), documentation (file-header).
+    Note: print-statements is a deprecated alias for improper-logging.
 
 Dependencies: Click for CLI framework, src.cli.main for CLI group, individual linter modules
 
@@ -34,6 +35,7 @@ from src.cli.linters import (  # noqa: F401
 
 # Re-export command functions for testing and reference
 from src.cli.linters.code_patterns import (
+    improper_logging,
     method_property,
     print_statements,
     stateless_class,
@@ -52,7 +54,8 @@ __all__ = [
     "dry",
     "magic_numbers",
     # Code pattern commands
-    "print_statements",
+    "improper_logging",
+    "print_statements",  # deprecated alias for improper_logging
     "method_property",
     "stateless_class",
     # Structure commands