thailint 0.3.2__py3-none-any.whl → 0.4.1__py3-none-any.whl

src/cli.py

@@ -362,6 +362,141 @@ def config_reset(ctx, yes: bool):
         sys.exit(1)
 
 
+@cli.command("init-config")
+@click.option(
+    "--preset",
+    "-p",
+    type=click.Choice(["strict", "standard", "lenient"]),
+    default="standard",
+    help="Configuration preset",
+)
+@click.option("--non-interactive", is_flag=True, help="Skip interactive prompts (for AI agents)")
+@click.option("--force", is_flag=True, help="Overwrite existing .thailint.yaml file")
+@click.option(
+    "--output", "-o", type=click.Path(), default=".thailint.yaml", help="Output file path"
+)
+def init_config(preset: str, non_interactive: bool, force: bool, output: str):
+    """
+    Generate a .thailint.yaml configuration file with preset values.
+
+    Creates a richly-commented configuration file with sensible defaults
+    and optional customizations for different strictness levels.
+
+    For AI agents, use --non-interactive mode:
+      thailint init-config --non-interactive --preset lenient
+
+    Presets:
+      strict:   Minimal allowed numbers (only -1, 0, 1)
+      standard: Balanced defaults (includes 2, 3, 4, 5, 10, 100, 1000)
+      lenient:  Includes time conversions (adds 60, 3600)
+
+    Examples:
+
+        \\b
+        # Interactive mode (default, for humans)
+        thailint init-config
+
+        \\b
+        # Non-interactive mode (for AI agents)
+        thailint init-config --non-interactive
+
+        \\b
+        # Generate with lenient preset
+        thailint init-config --preset lenient
+
+        \\b
+        # Overwrite existing config
+        thailint init-config --force
+
+        \\b
+        # Custom output path
+        thailint init-config --output my-config.yaml
+    """
+    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:
+        click.echo("thai-lint Configuration Generator")
+        click.echo("=" * 50)
+        click.echo("")
+        click.echo("This will create a .thailint.yaml configuration file.")
+        click.echo("For non-interactive mode (AI agents), use:")
+        click.echo("  thailint init-config --non-interactive")
+        click.echo("")
+
+        # Ask for preset
+        click.echo("Available presets:")
+        click.echo("  strict:   Only -1, 0, 1 allowed (strictest)")
+        click.echo("  standard: -1, 0, 1, 2, 3, 4, 5, 10, 100, 1000 (balanced)")
+        click.echo("  lenient:  Includes time conversions 60, 3600 (most permissive)")
+        click.echo("")
+
+        preset = click.prompt(
+            "Choose preset", type=click.Choice(["strict", "standard", "lenient"]), default=preset
+        )
+
+    # Generate config based on preset
+    config_content = _generate_config_content(preset)
+
+    # Write config file
+    try:
+        output_path.write_text(config_content, encoding="utf-8")
+        click.echo("")
+        click.echo(f"✓ Created {output}")
+        click.echo(f"✓ Preset: {preset}")
+        click.echo("")
+        click.echo("Next steps:")
+        click.echo(f"  1. Review and customize {output}")
+        click.echo("  2. Run: thailint magic-numbers .")
+        click.echo("  3. See docs: https://github.com/your-org/thai-lint")
+    except OSError as e:
+        click.echo(f"Error writing config file: {e}", err=True)
+        sys.exit(1)
+
+
+def _generate_config_content(preset: str) -> str:
+    """Generate config file content based on preset."""
+    # Preset configurations
+    presets = {
+        "strict": {
+            "allowed_numbers": "[-1, 0, 1]",
+            "max_small_integer": "3",
+            "description": "Strict (only universal values)",
+        },
+        "standard": {
+            "allowed_numbers": "[-1, 0, 1, 2, 3, 4, 5, 10, 100, 1000]",
+            "max_small_integer": "10",
+            "description": "Standard (balanced defaults)",
+        },
+        "lenient": {
+            "allowed_numbers": "[-1, 0, 1, 2, 3, 4, 5, 10, 60, 100, 1000, 3600]",
+            "max_small_integer": "10",
+            "description": "Lenient (includes time conversions)",
+        },
+    }
+
+    config = presets[preset]
+
+    # Read template
+    template_path = Path(__file__).parent / "templates" / "thailint_config_template.yaml"
+    template = template_path.read_text(encoding="utf-8")
+
+    # Replace placeholders
+    content = template.replace("{{PRESET}}", config["description"])
+    content = content.replace("{{ALLOWED_NUMBERS}}", config["allowed_numbers"])
+    content = content.replace("{{MAX_SMALL_INTEGER}}", config["max_small_integer"])
+
+    return content
+
+
 @cli.command("file-placement")
 @click.argument("paths", nargs=-1, type=click.Path())
 @click.option("--config", "-c", "config_file", type=click.Path(), help="Path to config file")

src/linters/magic_numbers/config.py

@@ -4,7 +4,7 @@ Purpose: Configuration schema for magic numbers linter
 Scope: MagicNumberConfig dataclass with allowed_numbers and max_small_integer settings
 
 Overview: Defines configuration schema for magic numbers linter. Provides MagicNumberConfig dataclass
-    with allowed_numbers set (default includes common acceptable numbers like 0, 1, 2, -1, 10, 100, 1000)
+    with allowed_numbers set (default includes common acceptable numbers like -1, 0, 1, 2, 3, 4, 5, 10, 100, 1000)
     and max_small_integer threshold (default 10) for range() contexts. Supports per-file and per-directory
     config overrides through from_dict class method. Validates that configuration values are appropriate
     types. Integrates with orchestrator's configuration system to allow users to customize allowed numbers
@@ -29,8 +29,11 @@ class MagicNumberConfig:
     """Configuration for magic numbers linter."""
 
     enabled: bool = True
-    allowed_numbers: set[int | float] = field(default_factory=lambda: {-1, 0, 1, 2, 10, 100, 1000})
+    allowed_numbers: set[int | float] = field(
+        default_factory=lambda: {-1, 0, 1, 2, 3, 4, 5, 10, 100, 1000}
+    )
     max_small_integer: int = 10
+    ignore: list[str] = field(default_factory=list)
 
     def __post_init__(self) -> None:
         """Validate configuration values."""
@@ -54,18 +57,26 @@ class MagicNumberConfig:
             lang_config = config[language]
             allowed_numbers = set(
                 lang_config.get(
-                    "allowed_numbers", config.get("allowed_numbers", {-1, 0, 1, 2, 10, 100, 1000})
+                    "allowed_numbers",
+                    config.get("allowed_numbers", {-1, 0, 1, 2, 3, 4, 5, 10, 100, 1000}),
                 )
             )
             max_small_integer = lang_config.get(
                 "max_small_integer", config.get("max_small_integer", 10)
             )
         else:
-            allowed_numbers = set(config.get("allowed_numbers", {-1, 0, 1, 2, 10, 100, 1000}))
+            allowed_numbers = set(
+                config.get("allowed_numbers", {-1, 0, 1, 2, 3, 4, 5, 10, 100, 1000})
+            )
             max_small_integer = config.get("max_small_integer", 10)
 
+        ignore_patterns = config.get("ignore", [])
+        if not isinstance(ignore_patterns, list):
+            ignore_patterns = []
+
         return cls(
             enabled=config.get("enabled", True),
             allowed_numbers=allowed_numbers,
             max_small_integer=max_small_integer,
+            ignore=ignore_patterns,
         )

src/linters/magic_numbers/linter.py

@@ -24,6 +24,7 @@ Implementation: Composition pattern with helper classes, AST-based analysis with
 """
 
 import ast
+from pathlib import Path
 
 from src.core.base import BaseLintContext, MultiLanguageLintRule
 from src.core.linter_utils import load_linter_config
@@ -98,6 +99,48 @@ class MagicNumberRule(MultiLanguageLintRule):  # thailint: ignore[srp]
             return None
         return load_linter_config(context, "magic_numbers", MagicNumberConfig)
 
+    def _is_file_ignored(self, context: BaseLintContext, config: MagicNumberConfig) -> bool:
+        """Check if file matches ignore patterns.
+
+        Args:
+            context: Lint context
+            config: Magic numbers configuration
+
+        Returns:
+            True if file should be ignored
+        """
+        if not config.ignore:
+            return False
+
+        if not context.file_path:
+            return False
+
+        file_path = Path(context.file_path)
+        for pattern in config.ignore:
+            if self._matches_pattern(file_path, pattern):
+                return True
+        return False
+
+    def _matches_pattern(self, file_path: Path, pattern: str) -> bool:
+        """Check if file path matches a glob pattern.
+
+        Args:
+            file_path: Path to check
+            pattern: Glob pattern (e.g., "test/**", "**/test_*.py", "specific/file.py")
+
+        Returns:
+            True if path matches pattern
+        """
+        # Try glob pattern matching first (handles **, *, etc.)
+        if file_path.match(pattern):
+            return True
+
+        # Also check if pattern is a substring (for partial path matching)
+        if pattern in str(file_path):
+            return True
+
+        return False
+
     def _check_python(self, context: BaseLintContext, config: MagicNumberConfig) -> list[Violation]:
         """Check Python code for magic number violations.
 
@@ -108,6 +151,9 @@ class MagicNumberRule(MultiLanguageLintRule):  # thailint: ignore[srp]
         Returns:
             List of violations found in Python code
         """
+        if self._is_file_ignored(context, config):
+            return []
+
         tree = self._parse_python_code(context.file_content)
         if tree is None:
             return []
@@ -267,6 +313,9 @@ class MagicNumberRule(MultiLanguageLintRule):  # thailint: ignore[srp]
         Returns:
             List of violations found in TypeScript/JavaScript code
         """
+        if self._is_file_ignored(context, config):
+            return []
+
         analyzer = TypeScriptMagicNumberAnalyzer()
         root_node = analyzer.parse_typescript(context.file_content or "")
         if root_node is None:

src/templates/thailint_config_template.yaml

@@ -0,0 +1,132 @@
+# thai-lint Configuration File
+# Generated by: thailint init-config
+#
+# For non-interactive mode (AI agents): thailint init-config --non-interactive
+#
+# Full documentation: https://github.com/your-org/thai-lint
+
+# ============================================================================
+# MAGIC NUMBERS LINTER
+# ============================================================================
+# Detects unnamed numeric literals that should be extracted as constants
+#
+# Preset: {{PRESET}}
+#
+magic-numbers:
+  enabled: true
+
+  # Numbers that are acceptable without being named constants
+  # Default: [-1, 0, 1, 2, 3, 4, 5, 10, 100, 1000]
+  allowed_numbers: {{ALLOWED_NUMBERS}}
+
+  # Maximum integer allowed in range() or enumerate() without flagging
+  # Default: 10
+  max_small_integer: {{MAX_SMALL_INTEGER}}
+
+  # -------------------------------------------------------------------------
+  # OPTIONAL: Uncomment to add time conversions (lenient mode)
+  # -------------------------------------------------------------------------
+  # allowed_numbers: [-1, 0, 1, 2, 3, 4, 5, 10, 60, 100, 1000, 3600]
+
+  # -------------------------------------------------------------------------
+  # OPTIONAL: Uncomment to add common HTTP status codes
+  # -------------------------------------------------------------------------
+  # allowed_numbers: [-1, 0, 1, 2, 3, 4, 5, 10, 100, 200, 201, 204, 400, 401, 403, 404, 500, 502, 503, 1000]
+
+  # -------------------------------------------------------------------------
+  # OPTIONAL: Uncomment to add decimal proportions (0.0-1.0)
+  # -------------------------------------------------------------------------
+  # allowed_numbers: [-1, 0, 1, 2, 3, 4, 5, 10, 100, 1000, 0.0, 0.1, 0.2, 0.25, 0.3, 0.4, 0.5, 0.6, 0.7, 0.75, 0.8, 0.9, 1.0]
+
+# ============================================================================
+# NESTING LINTER
+# ============================================================================
+# Checks for excessive nesting depth (if/for/while/try statements)
+#
+nesting:
+  enabled: true
+
+  # Maximum nesting depth allowed
+  # Default: 4
+  max_nesting_depth: 4
+
+# ============================================================================
+# SINGLE RESPONSIBILITY PRINCIPLE (SRP) LINTER
+# ============================================================================
+# Detects classes that may have too many responsibilities
+#
+srp:
+  enabled: true
+
+  # Maximum methods per class
+  # Default: 7
+  max_methods: 7
+
+  # Maximum lines of code per class
+  # Default: 200
+  max_loc: 200
+
+# ============================================================================
+# DRY (DON'T REPEAT YOURSELF) LINTER
+# ============================================================================
+# Detects duplicate code blocks
+#
+dry:
+  enabled: true
+
+  # Minimum lines for a block to be considered duplicate
+  # Default: 6
+  min_duplicate_lines: 6
+
+  # Enable SQLite caching for faster incremental scans
+  # Default: true
+  cache_enabled: true
+
+  # Cache file location (relative to project root)
+  # Default: .thailint-cache/dry.db
+  cache_path: .thailint-cache/dry.db
+
+# ============================================================================
+# FILE PLACEMENT LINTER
+# ============================================================================
+# Ensures files are in appropriate directories
+#
+file-placement:
+  enabled: true
+
+  # Rules for file placement
+  rules:
+    # Test files should be in tests/ directory
+    - pattern: "test_*.py"
+      required_dir: "tests/"
+      message: "Test files must be in tests/ directory"
+
+    # Config files should be in config/ or root
+    - pattern: "*config*.py"
+      required_dir: ["config/", "./"]
+      message: "Config files should be in config/ or project root"
+
+# ============================================================================
+# GLOBAL SETTINGS
+# ============================================================================
+#
+# Exclude patterns (files/directories to ignore)
+exclude:
+  - ".git/"
+  - ".venv/"
+  - "venv/"
+  - "node_modules/"
+  - "__pycache__/"
+  - "*.pyc"
+  - ".pytest_cache/"
+  - "dist/"
+  - "build/"
+  - ".eggs/"
+
+# Output format (text or json)
+# Default: text
+output_format: text
+
+# Exit with error code if violations found
+# Default: true
+fail_on_violations: true

{thailint-0.3.2.dist-info → thailint-0.4.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: thailint
-Version: 0.3.2
+Version: 0.4.1
 Summary: The AI Linter - Enterprise-grade linting and governance for AI-generated code across multiple languages
 License: MIT
 Keywords: linter,ai,code-quality,static-analysis,file-placement,governance,multi-language,cli,docker,python
@@ -35,11 +35,20 @@ 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/)
-[![Tests](https://img.shields.io/badge/tests-253%2F253%20passing-brightgreen.svg)](tests/)
-[![Coverage](https://img.shields.io/badge/coverage-88%25-brightgreen.svg)](htmlcov/)
+[![Tests](https://img.shields.io/badge/tests-263%2F263%20passing-brightgreen.svg)](tests/)
+[![Coverage](https://img.shields.io/badge/coverage-87%25-brightgreen.svg)](htmlcov/)
 
 The AI Linter - Enterprise-ready linting and governance for AI-generated code across multiple languages.
 
+## Documentation
+
+**New to thailint?** Start here:
+- **[Quick Start Guide](docs/quick-start.md)** - Get running in 5 minutes
+- **[Configuration Reference](docs/configuration.md)** - Complete config options for all linters
+- **[Troubleshooting Guide](docs/troubleshooting.md)** - Common issues and solutions
+
+**Full Documentation:** Browse the **[docs/](docs/)** folder for comprehensive guides covering installation, all linters, configuration patterns, and integration examples.
+
 ## Overview
 
 thailint is a modern, enterprise-ready multi-language linter designed specifically for AI-generated code. It focuses on common mistakes and anti-patterns that AI coding assistants frequently introduce—issues that existing linters don't catch or don't handle consistently across languages.
@@ -55,6 +64,8 @@ We're not trying to replace the wonderful existing linters like Pylint, ESLint,
 
 thailint complements your existing linting stack by catching the patterns AI tools repeatedly miss.
 
+**Complete documentation available in the [docs/](docs/) folder** covering installation, configuration, all linters, and troubleshooting.
+
 ## Features
 
 ### Core Capabilities
@@ -151,6 +162,8 @@ thailint dry --config .thailint.yaml src/
 thailint dry --format json src/
 ```
 
+**New to thailint?** See the **[Quick Start Guide](docs/quick-start.md)** for a complete walkthrough including config generation, understanding output, and next steps.
+
 ### Library Mode
 
 ```python

{thailint-0.3.2.dist-info → thailint-0.4.1.dist-info}/RECORD

@@ -2,7 +2,7 @@ src/__init__.py,sha256=f601zncODr2twrUHqTLS5wyOdZqZi9tMjAe2INhRKqU,2175
 src/analyzers/__init__.py,sha256=fFloZtjkBGwYbAhKTxS3Qy3yDr2_3i3WSfKTw1mAioo,972
 src/analyzers/typescript_base.py,sha256=4I7fAcMOAY9vY1AXh52QpohgFmguBECwOkvBRP4zCS4,5054
 src/api.py,sha256=pJ5l3qxccKBEY-BkANwzTgLAl1ZFq7OP6hx6LSxbhDw,4664
-src/cli.py,sha256=1qhjXAy7JDdav90xQ5pOeH1_f1A9qYJLIwxTQzq3oiU,35657
+src/cli.py,sha256=zRl6FHyr24puWli77ogFtuPFWKbTNMI93kmu1V4kPEQ,40369
 src/config.py,sha256=2ebAjIpAhw4bHbOxViEA5nCjfBlDEIrMR59DBrzcYzM,12460
 src/core/__init__.py,sha256=5FtsDvhMt4SNRx3pbcGURrxn135XRbeRrjSUxiXwkNc,381
 src/core/base.py,sha256=Eklcagi2ktfY4Kytl_ObXov2U49N9OGDpw4cu4PUzGY,7824
@@ -47,9 +47,9 @@ src/linters/file_placement/pattern_validator.py,sha256=eMt5GB5lgJMhhQACOlfDXQFfS
 src/linters/file_placement/rule_checker.py,sha256=JONXcaYxZ8CM_7Zg6Th01p5cve1rJ8YkReAUJ44nfUg,7795
 src/linters/file_placement/violation_factory.py,sha256=NkQmBcgpa3g3W2ZdFZNQ5djLVP4x9OKs65d7F1rCKvM,6040
 src/linters/magic_numbers/__init__.py,sha256=17dkCUf0uiYLvpOZF01VDojj92NzxXZMtRhrSBUzsdc,1689
-src/linters/magic_numbers/config.py,sha256=xtT1kFD68VScUf5BRL1mpzWUiQLIWoI6iqniwBu0GgY,2946
+src/linters/magic_numbers/config.py,sha256=3zV6ZNezouBWUYy4kMw5PUlPNvIWXVwOxTz1moZfRoI,3270
 src/linters/magic_numbers/context_analyzer.py,sha256=cGXozlKll10Zao56c2E8ThIyH2mSQaPaUau_g7ngRLw,8446
-src/linters/magic_numbers/linter.py,sha256=f240nyxsSN9-ttF6c7gA0LNwo6mBd85bWVO2I45G3DI,16354
+src/linters/magic_numbers/linter.py,sha256=_AIlPHVdZIi7hVZ-VmlBLw9OqdVPKAdNzHnPhTSiJb8,17768
 src/linters/magic_numbers/python_analyzer.py,sha256=0u1cFaaFCqOW5yeW-YbmPoZuVIeN_KtmkFyyxup6aR0,2803
 src/linters/magic_numbers/typescript_analyzer.py,sha256=DCYRdxjgMd6PkhJWKnc1W-S1T0sa-F9AHCLV2JwcR8g,7468
 src/linters/magic_numbers/violation_builder.py,sha256=SqIQv3N9lpP2GRC1TC5InrvaEdrAq24V7Ec2Xj5olb0,3308
@@ -73,10 +73,11 @@ src/linters/srp/violation_builder.py,sha256=jaIjVtRYWUTs1SVJVwd0FxCojo0DxhPzfhyf
 src/orchestrator/__init__.py,sha256=XXLDJq2oaB-TpP2Y97GRnde9EkITGuFCmuLrDfxI9nY,245
 src/orchestrator/core.py,sha256=zb4H4HtDNLmnsRCUXI3oNtfM3T-nTPW9Q2pAbI61VEs,8374
 src/orchestrator/language_detector.py,sha256=rHyVMApit80NTTNyDH1ObD1usKD8LjGmH3DwqNAWYGc,2736
+src/templates/thailint_config_template.yaml,sha256=u8WFv2coE4uqfgf_slw7xjo4kGYIowDm1RIgxsKQzrE,4275
 src/utils/__init__.py,sha256=NiBtKeQ09Y3kuUzeN4O1JNfUIYPQDS2AP1l5ODq-Dec,125
 src/utils/project_root.py,sha256=ldv2-XeMT0IElpSgrHdTaP2CUfwmdZix8vQ2qXO1O5s,2735
-thailint-0.3.2.dist-info/LICENSE,sha256=kxh1J0Sb62XvhNJ6MZsVNe8PqNVJ7LHRn_EWa-T3djw,1070
-thailint-0.3.2.dist-info/METADATA,sha256=P46brGR5esX9nGSoCtedmac_zupk8pAN4iHS2dJhM_g,33249
-thailint-0.3.2.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-thailint-0.3.2.dist-info/entry_points.txt,sha256=l7DQJgU18sVLDpSaXOXY3lLhnQHQIRrSJZTQjG1cEAk,62
-thailint-0.3.2.dist-info/RECORD,,
+thailint-0.4.1.dist-info/LICENSE,sha256=kxh1J0Sb62XvhNJ6MZsVNe8PqNVJ7LHRn_EWa-T3djw,1070
+thailint-0.4.1.dist-info/METADATA,sha256=eTR4Su6Xbo9tMZWxoefVZvDUJndYmF0JD6GhfhiVGOk,34038
+thailint-0.4.1.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+thailint-0.4.1.dist-info/entry_points.txt,sha256=l7DQJgU18sVLDpSaXOXY3lLhnQHQIRrSJZTQjG1cEAk,62
+thailint-0.4.1.dist-info/RECORD,,