skill-seekers-reference/tests/test_analyze_command.py

#!/usr/bin/env python3
"""Tests for analyze subcommand integration in main CLI."""

import sys
import unittest
from pathlib import Path

sys.path.insert(0, str(Path(__file__).parent.parent / "src"))

from skill_seekers.cli.main import create_parser


class TestAnalyzeSubcommand(unittest.TestCase):
    """Test analyze subcommand registration and argument parsing."""

    def setUp(self):
        """Create parser for testing."""
        self.parser = create_parser()

    def test_analyze_subcommand_exists(self):
        """Test that analyze subcommand is registered."""
        args = self.parser.parse_args(["analyze", "--directory", "."])
        self.assertEqual(args.command, "analyze")
        self.assertEqual(args.directory, ".")

    def test_analyze_with_output_directory(self):
        """Test analyze with custom output directory."""
        args = self.parser.parse_args(["analyze", "--directory", ".", "--output", "custom/"])
        self.assertEqual(args.output, "custom/")

    def test_quick_preset_flag(self):
        """Test --quick preset flag parsing."""
        args = self.parser.parse_args(["analyze", "--directory", ".", "--quick"])
        self.assertTrue(args.quick)
        self.assertFalse(args.comprehensive)

    def test_comprehensive_preset_flag(self):
        """Test --comprehensive preset flag parsing."""
        args = self.parser.parse_args(["analyze", "--directory", ".", "--comprehensive"])
        self.assertTrue(args.comprehensive)
        self.assertFalse(args.quick)

    def test_quick_and_comprehensive_mutually_exclusive(self):
        """Test that both flags can be parsed (mutual exclusion enforced at runtime)."""
        # The parser allows both flags; runtime logic prevents simultaneous use
        args = self.parser.parse_args(["analyze", "--directory", ".", "--quick", "--comprehensive"])
        self.assertTrue(args.quick)
        self.assertTrue(args.comprehensive)
        # Note: Runtime will catch this and return error code 1

    def test_enhance_flag(self):
        """Test --enhance flag parsing."""
        args = self.parser.parse_args(["analyze", "--directory", ".", "--enhance"])
        self.assertTrue(args.enhance)

    def test_skip_flags_passed_through(self):
        """Test that skip flags are recognized."""
        args = self.parser.parse_args(
            ["analyze", "--directory", ".", "--skip-patterns", "--skip-test-examples"]
        )
        self.assertTrue(args.skip_patterns)
        self.assertTrue(args.skip_test_examples)

    def test_all_skip_flags(self):
        """Test all skip flags are properly parsed."""
        args = self.parser.parse_args(
            [
                "analyze",
                "--directory",
                ".",
                "--skip-api-reference",
                "--skip-dependency-graph",
                "--skip-patterns",
                "--skip-test-examples",
                "--skip-how-to-guides",
                "--skip-config-patterns",
                "--skip-docs",
            ]
        )
        self.assertTrue(args.skip_api_reference)
        self.assertTrue(args.skip_dependency_graph)
        self.assertTrue(args.skip_patterns)
        self.assertTrue(args.skip_test_examples)
        self.assertTrue(args.skip_how_to_guides)
        self.assertTrue(args.skip_config_patterns)
        self.assertTrue(args.skip_docs)

    def test_backward_compatible_depth_flag(self):
        """Test that deprecated --depth flag still works."""
        args = self.parser.parse_args(["analyze", "--directory", ".", "--depth", "full"])
        self.assertEqual(args.depth, "full")

    def test_depth_flag_choices(self):
        """Test that depth flag accepts correct values."""
        for depth in ["surface", "deep", "full"]:
            args = self.parser.parse_args(["analyze", "--directory", ".", "--depth", depth])
            self.assertEqual(args.depth, depth)

    def test_languages_flag(self):
        """Test languages flag parsing."""
        args = self.parser.parse_args(
            ["analyze", "--directory", ".", "--languages", "Python,JavaScript"]
        )
        self.assertEqual(args.languages, "Python,JavaScript")

    def test_file_patterns_flag(self):
        """Test file patterns flag parsing."""
        args = self.parser.parse_args(
            ["analyze", "--directory", ".", "--file-patterns", "*.py,src/**/*.js"]
        )
        self.assertEqual(args.file_patterns, "*.py,src/**/*.js")

    def test_no_comments_flag(self):
        """Test no-comments flag parsing."""
        args = self.parser.parse_args(["analyze", "--directory", ".", "--no-comments"])
        self.assertTrue(args.no_comments)

    def test_verbose_flag(self):
        """Test verbose flag parsing."""
        args = self.parser.parse_args(["analyze", "--directory", ".", "--verbose"])
        self.assertTrue(args.verbose)

    def test_complex_command_combination(self):
        """Test complex command with multiple flags."""
        args = self.parser.parse_args(
            [
                "analyze",
                "--directory",
                "./src",
                "--output",
                "analysis/",
                "--quick",
                "--languages",
                "Python",
                "--skip-patterns",
                "--verbose",
            ]
        )
        self.assertEqual(args.directory, "./src")
        self.assertEqual(args.output, "analysis/")
        self.assertTrue(args.quick)
        self.assertEqual(args.languages, "Python")
        self.assertTrue(args.skip_patterns)
        self.assertTrue(args.verbose)

    def test_directory_is_required(self):
        """Test that directory argument is required."""
        with self.assertRaises(SystemExit):
            self.parser.parse_args(["analyze"])

    def test_default_output_directory(self):
        """Test default output directory value."""
        args = self.parser.parse_args(["analyze", "--directory", "."])
        self.assertEqual(args.output, "output/codebase/")


class TestAnalyzePresetBehavior(unittest.TestCase):
    """Test preset flag behavior and argument transformation."""

    def setUp(self):
        """Create parser for testing."""
        self.parser = create_parser()

    def test_quick_preset_implies_surface_depth(self):
        """Test that --quick preset should trigger surface depth."""
        args = self.parser.parse_args(["analyze", "--directory", ".", "--quick"])
        self.assertTrue(args.quick)
        # Note: Depth transformation happens in dispatch handler

    def test_comprehensive_preset_implies_full_depth(self):
        """Test that --comprehensive preset should trigger full depth."""
        args = self.parser.parse_args(["analyze", "--directory", ".", "--comprehensive"])
        self.assertTrue(args.comprehensive)
        # Note: Depth transformation happens in dispatch handler

    def test_enhance_flag_standalone(self):
        """Test --enhance flag can be used without presets."""
        args = self.parser.parse_args(["analyze", "--directory", ".", "--enhance"])
        self.assertTrue(args.enhance)
        self.assertFalse(args.quick)
        self.assertFalse(args.comprehensive)


if __name__ == "__main__":
    unittest.main()