thailint 0.11.0__tar.gz → 0.13.0__tar.gz

thailint-0.13.0/PKG-INFO

@@ -0,0 +1,184 @@
+Metadata-Version: 2.4
+Name: thailint
+Version: 0.13.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
+Author: Steve Jackson
+Requires-Python: >=3.11,<4.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Dist: click (>=8.1.0,<9.0.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-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
+Project-URL: Repository, https://github.com/be-wise-be-kind/thai-lint
+Description-Content-Type: text/markdown
+
+# thai-lint
+
+[![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/)
+[![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.
+
+thailint detects anti-patterns that AI tools frequently introduce: duplicate code, excessive nesting, magic numbers, SRP violations, and more. It works across Python, TypeScript, and JavaScript with unified rules - filling gaps that existing linters miss.
+
+## Installation
+
+```bash
+pip install thai-lint
+```
+
+Or with Docker:
+```bash
+docker run --rm -v $(pwd):/data washad/thailint:latest --help
+```
+
+## Quick Start
+
+```bash
+# Generate a config file (optional)
+thailint init-config
+
+# Run any linter
+thailint dry src/
+```
+
+That's it. See violations, fix them, ship better code.
+
+## Available Linters
+
+| Linter | What It Catches | Command | Docs |
+|--------|-----------------|---------|------|
+| **DRY** | Duplicate code across files | `thailint dry src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/dry-linter/) |
+| **Nesting** | Deeply nested if/for/while blocks | `thailint nesting src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/nesting-linter/) |
+| **Magic Numbers** | Unnamed numeric literals | `thailint magic-numbers src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/magic-numbers-linter/) |
+| **SRP** | Classes doing too much | `thailint srp src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/srp-linter/) |
+| **File Header** | Missing documentation headers | `thailint file-header src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/file-header-linter/) |
+| **Stateless Class** | Classes that should be functions | `thailint stateless-class src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/stateless-class-linter/) |
+| **Collection Pipeline** | Loops with embedded filtering | `thailint pipeline src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/collection-pipeline-linter/) |
+| **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/) |
+| **Stringly Typed** | Strings that should be enums | `thailint stringly-typed src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/stringly-typed-linter/) |
+
+## Configuration
+
+Create `.thailint.yaml` in your project root:
+
+```yaml
+dry:
+  enabled: true
+  min_duplicate_lines: 4
+
+nesting:
+  enabled: true
+  max_nesting_depth: 3
+
+magic-numbers:
+  enabled: true
+  allowed_numbers: [-1, 0, 1, 2, 10, 100]
+```
+
+Or generate one automatically:
+```bash
+thailint init-config --preset lenient  # or: strict, standard
+```
+
+See [Configuration Reference](https://thai-lint.readthedocs.io/en/latest/configuration/) for all options.
+
+## Output Formats
+
+```bash
+# Human-readable (default)
+thailint dry src/
+
+# JSON for CI/CD
+thailint dry --format json src/
+
+# SARIF for GitHub Code Scanning
+thailint dry --format sarif src/ > results.sarif
+```
+
+## Ignoring Violations
+
+```python
+# Line-level
+timeout = 3600  # thailint: ignore[magic-numbers]
+
+# File-level
+# thailint: ignore-file[dry]
+```
+
+Or in config:
+```yaml
+dry:
+  ignore:
+    - "tests/"
+    - "**/generated/**"
+```
+
+See [How to Ignore Violations](https://thai-lint.readthedocs.io/en/latest/how-to-ignore-violations/) for all 5 ignore levels.
+
+## CI/CD Integration
+
+```yaml
+# GitHub Actions
+- name: Run thailint
+  run: |
+    pip install thai-lint
+    thailint dry src/
+    thailint nesting src/
+```
+
+Exit codes: `0` = success, `1` = violations found, `2` = error.
+
+## Documentation
+
+- **[Quick Start Guide](https://thai-lint.readthedocs.io/en/latest/quick-start/)** - Get running in 5 minutes
+- **[Configuration Reference](https://thai-lint.readthedocs.io/en/latest/configuration/)** - All config options
+- **[Troubleshooting](https://thai-lint.readthedocs.io/en/latest/troubleshooting/)** - Common issues
+- **[Full Documentation](https://thai-lint.readthedocs.io/)** - Everything else
+
+## Contributing
+
+Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+```bash
+git clone https://github.com/be-wise-be-kind/thai-lint.git
+cd thai-lint
+poetry install
+just test
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Support
+
+- **Issues**: [github.com/be-wise-be-kind/thai-lint/issues](https://github.com/be-wise-be-kind/thai-lint/issues)
+- **Docs**: [thai-lint.readthedocs.io](https://thai-lint.readthedocs.io/)
+

thailint-0.13.0/README.md

@@ -0,0 +1,148 @@
+# thai-lint
+
+[![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/)
+[![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.
+
+thailint detects anti-patterns that AI tools frequently introduce: duplicate code, excessive nesting, magic numbers, SRP violations, and more. It works across Python, TypeScript, and JavaScript with unified rules - filling gaps that existing linters miss.
+
+## Installation
+
+```bash
+pip install thai-lint
+```
+
+Or with Docker:
+```bash
+docker run --rm -v $(pwd):/data washad/thailint:latest --help
+```
+
+## Quick Start
+
+```bash
+# Generate a config file (optional)
+thailint init-config
+
+# Run any linter
+thailint dry src/
+```
+
+That's it. See violations, fix them, ship better code.
+
+## Available Linters
+
+| Linter | What It Catches | Command | Docs |
+|--------|-----------------|---------|------|
+| **DRY** | Duplicate code across files | `thailint dry src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/dry-linter/) |
+| **Nesting** | Deeply nested if/for/while blocks | `thailint nesting src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/nesting-linter/) |
+| **Magic Numbers** | Unnamed numeric literals | `thailint magic-numbers src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/magic-numbers-linter/) |
+| **SRP** | Classes doing too much | `thailint srp src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/srp-linter/) |
+| **File Header** | Missing documentation headers | `thailint file-header src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/file-header-linter/) |
+| **Stateless Class** | Classes that should be functions | `thailint stateless-class src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/stateless-class-linter/) |
+| **Collection Pipeline** | Loops with embedded filtering | `thailint pipeline src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/collection-pipeline-linter/) |
+| **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/) |
+| **Stringly Typed** | Strings that should be enums | `thailint stringly-typed src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/stringly-typed-linter/) |
+
+## Configuration
+
+Create `.thailint.yaml` in your project root:
+
+```yaml
+dry:
+  enabled: true
+  min_duplicate_lines: 4
+
+nesting:
+  enabled: true
+  max_nesting_depth: 3
+
+magic-numbers:
+  enabled: true
+  allowed_numbers: [-1, 0, 1, 2, 10, 100]
+```
+
+Or generate one automatically:
+```bash
+thailint init-config --preset lenient  # or: strict, standard
+```
+
+See [Configuration Reference](https://thai-lint.readthedocs.io/en/latest/configuration/) for all options.
+
+## Output Formats
+
+```bash
+# Human-readable (default)
+thailint dry src/
+
+# JSON for CI/CD
+thailint dry --format json src/
+
+# SARIF for GitHub Code Scanning
+thailint dry --format sarif src/ > results.sarif
+```
+
+## Ignoring Violations
+
+```python
+# Line-level
+timeout = 3600  # thailint: ignore[magic-numbers]
+
+# File-level
+# thailint: ignore-file[dry]
+```
+
+Or in config:
+```yaml
+dry:
+  ignore:
+    - "tests/"
+    - "**/generated/**"
+```
+
+See [How to Ignore Violations](https://thai-lint.readthedocs.io/en/latest/how-to-ignore-violations/) for all 5 ignore levels.
+
+## CI/CD Integration
+
+```yaml
+# GitHub Actions
+- name: Run thailint
+  run: |
+    pip install thai-lint
+    thailint dry src/
+    thailint nesting src/
+```
+
+Exit codes: `0` = success, `1` = violations found, `2` = error.
+
+## Documentation
+
+- **[Quick Start Guide](https://thai-lint.readthedocs.io/en/latest/quick-start/)** - Get running in 5 minutes
+- **[Configuration Reference](https://thai-lint.readthedocs.io/en/latest/configuration/)** - All config options
+- **[Troubleshooting](https://thai-lint.readthedocs.io/en/latest/troubleshooting/)** - Common issues
+- **[Full Documentation](https://thai-lint.readthedocs.io/)** - Everything else
+
+## Contributing
+
+Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+```bash
+git clone https://github.com/be-wise-be-kind/thai-lint.git
+cd thai-lint
+poetry install
+just test
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Support
+
+- **Issues**: [github.com/be-wise-be-kind/thai-lint/issues](https://github.com/be-wise-be-kind/thai-lint/issues)
+- **Docs**: [thai-lint.readthedocs.io](https://thai-lint.readthedocs.io/)

{thailint-0.11.0 → thailint-0.13.0}/pyproject.toml

@@ -17,7 +17,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "thailint"
-version = "0.11.0"
+version = "0.13.0"
 description = "The AI Linter - Enterprise-grade linting and governance for AI-generated code across multiple languages"
 authors = ["Steve Jackson"]
 license = "MIT"

{thailint-0.11.0 → thailint-0.13.0}/src/analyzers/__init__.py

@@ -9,15 +9,16 @@ Overview: Package containing base analyzer classes for different programming lan
     (TypeScriptBaseAnalyzer, etc.) that linter-specific analyzers extend. Centralizes
     language parsing infrastructure to improve maintainability and consistency.
 
-Dependencies: tree-sitter, language-specific tree-sitter bindings
+Dependencies: tree-sitter, language-specific tree-sitter bindings, ast module
 
-Exports: TypeScriptBaseAnalyzer
+Exports: TypeScriptBaseAnalyzer, build_parent_map
 
 Interfaces: Base analyzer classes with parse(), walk_tree(), and extract() methods
 
 Implementation: Composition-based design for linter analyzers to use base utilities
 """
 
+from .ast_utils import build_parent_map
 from .typescript_base import TypeScriptBaseAnalyzer
 
-__all__ = ["TypeScriptBaseAnalyzer"]
+__all__ = ["TypeScriptBaseAnalyzer", "build_parent_map"]

thailint-0.13.0/src/analyzers/ast_utils.py

@@ -0,0 +1,54 @@
+"""
+Purpose: Common Python AST utilities for linter analyzers
+
+Scope: Shared AST traversal utilities for Python code analysis
+
+Overview: Provides common AST utility functions used across multiple Python linters.
+    Centralizes shared patterns like parent map building to eliminate code duplication.
+    The build_parent_map function creates a dictionary mapping AST nodes to their parents,
+    enabling upward tree traversal for context detection.
+
+Dependencies: ast module for AST node types
+
+Exports: build_parent_map
+
+Interfaces: build_parent_map(tree: ast.AST) -> dict[ast.AST, ast.AST]
+
+Implementation: Recursive AST traversal with parent tracking
+"""
+
+import ast
+
+
+def build_parent_map(tree: ast.AST) -> dict[ast.AST, ast.AST]:
+    """Build a map of AST nodes to their parent nodes.
+
+    Enables upward tree traversal for context detection (e.g., finding if a node
+    is inside a particular block type).
+
+    Args:
+        tree: Root AST node to build map from
+
+    Returns:
+        Dictionary mapping each node to its parent node
+    """
+    parent_map: dict[ast.AST, ast.AST] = {}
+    _build_parent_map_recursive(tree, None, parent_map)
+    return parent_map
+
+
+def _build_parent_map_recursive(
+    node: ast.AST, parent: ast.AST | None, parent_map: dict[ast.AST, ast.AST]
+) -> None:
+    """Recursively build parent map.
+
+    Args:
+        node: Current AST node
+        parent: Parent of current node
+        parent_map: Dictionary to populate
+    """
+    if parent is not None:
+        parent_map[node] = parent
+
+    for child in ast.iter_child_nodes(node):
+        _build_parent_map_recursive(child, node, parent_map)

{thailint-0.11.0 → thailint-0.13.0}/src/analyzers/typescript_base.py

@@ -18,6 +18,10 @@ Exports: TypeScriptBaseAnalyzer class with parsing and traversal utilities
 Interfaces: parse_typescript(code), walk_tree(node, node_type), extract_node_text(node)
 
 Implementation: Tree-sitter parser singleton, recursive AST traversal, composition pattern
+
+Suppressions:
+    - type:ignore[assignment]: Tree-sitter TS_PARSER fallback when import fails
+    - type:ignore[assignment,misc]: Tree-sitter Node type alias (optional dependency fallback)
 """
 
 from typing import Any

{thailint-0.11.0 → thailint-0.13.0}/src/cli/__init__.py

@@ -16,6 +16,9 @@ Exports: cli (main Click command group with all commands registered)
 Interfaces: Single import point for CLI access via 'from src.cli import cli'
 
 Implementation: Imports submodules to trigger command registration via Click decorators
+
+Suppressions:
+    - F401: Module re-exports required for public API interface
 """
 
 # Import the CLI group from main module

{thailint-0.11.0 → thailint-0.13.0}/src/cli/config.py

@@ -26,9 +26,11 @@ import sys
 from pathlib import Path
 
 import click
+import yaml
 
 from src.config import ConfigError, save_config, validate_config
 
+from .config_merge import perform_merge
 from .main import cli
 
 # Configure module logger
@@ -98,8 +100,6 @@ def _format_config_json(cfg: dict) -> None:
 
 def _format_config_yaml(cfg: dict) -> None:
     """Format configuration as YAML."""
-    import yaml
-
     click.echo(yaml.dump(cfg, default_flow_style=False, sort_keys=False))
 
 
@@ -285,6 +285,9 @@ def init_config(preset: str, non_interactive: bool, force: bool, output: str) ->
     Creates a richly-commented configuration file with sensible defaults
     and optional customizations for different strictness levels.
 
+    If a config file already exists, missing linter sections will be added
+    without modifying existing settings. Use --force to completely overwrite.
+
     For AI agents, use --non-interactive mode:
       thailint init-config --non-interactive --preset lenient
 
@@ -308,7 +311,7 @@ def init_config(preset: str, non_interactive: bool, force: bool, output: str) ->
         thailint init-config --preset lenient
 
         \\b
-        # Overwrite existing config
+        # Overwrite existing config (replaces entire file)
         thailint init-config --force
 
         \\b
@@ -317,19 +320,16 @@ def init_config(preset: str, non_interactive: bool, force: bool, output: str) ->
     """
     output_path = Path(output)
 
-    # Check if file exists (unless --force)
-    if output_path.exists() and not force:
-        click.echo(f"Error: {output} already exists", err=True)
-        click.echo("", err=True)
-        click.echo("Use --force to overwrite:", err=True)
-        click.echo("  thailint init-config --force", err=True)
-        sys.exit(1)
-
     # Interactive mode: Ask user for preferences
     if not non_interactive:
         preset = _run_interactive_preset_selection(preset)
 
-    # Generate config based on preset
+    # If file exists and not forcing overwrite, merge missing sections
+    if output_path.exists() and not force:
+        perform_merge(output_path, preset, output, _generate_config_content)
+        return
+
+    # Generate full config based on preset
     config_content = _generate_config_content(preset)
 
     # Write config file