cicd-cli-tool 0.1.0__py3-none-any.whl

cicd_cli_tool-0.1.0.dist-info/METADATA

@@ -0,0 +1,41 @@
+Metadata-Version: 2.4
+Name: cicd-cli-tool
+Version: 0.1.0
+Summary: Auto-detect project frameworks and generate CI/CD pipeline files
+Author: Your Name
+Author-email: Ayoub Jedidi <ayoub.ejedidi@gmail.com>
+Keywords: ci,cd,jenkins,gitlab,github,pipeline,devops,cicd
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: typer[all]>=0.9.0
+Requires-Dist: jinja2>=3.1.2
+Requires-Dist: rich>=13.7.0
+Requires-Dist: pydantic<2
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Dynamic: author
+Dynamic: requires-python
+
+# CLI Client
+this cli provides every setup you need for these frameworks (nodejs,pytohn,java,gradle,maven,dotnet)
+after installing the cli with pip install -e 
+you'll use these commands :
+cicd--help : to see all commands you can use with cicd-cli
+cicd detect : detects everything is related to your project dependencies , version , framewokr, language etc ...
+you should provide the folder your project to work 
+cicd init : includes cicd detect , it will detect auto and will generate jenkinsfile and dockerfile for your project 
+this all you need to know about the cli
+if you need more example you find the tests folder ive used to test , simple example running 

cicd_cli_tool-0.1.0.dist-info/RECORD

@@ -0,0 +1,49 @@
+cli/main.py,sha256=PyX1gxNic6LZ96yx1rTHFG9rub8i5s3Y3oPH8REtCAU,13870
+core/__init__.py,sha256=4k9y0t_moGgaw2bzmbC-maaPJ5tM2mFlTnJj_NW7Cs4,126
+core/base_detector.py,sha256=yIYgr1WRJNNZ-Fef5YlB7KDyNM3bpp9PuK5F3x2wS9E,3608
+core/base_generator.py,sha256=U20eIAd9DSOrBltHSrHYVW-4nh77Z16BfwnAfXDYAEM,6445
+frameworks/__init__.py,sha256=D3rVWmuKN7te5qn41dcMD6GhdLEQv0OdlVx28K4izds,1051
+frameworks/dotnet/__init__.py,sha256=Nj8Fh8Fd_sOXrCl2rU0JW-Y_AIIeFyGIkGq70hdnzck,170
+frameworks/dotnet/detector.py,sha256=uuwpcbNQqz7YOJ7QhVvGE4bptcOWSCXXnbPT9boSFuU,4874
+frameworks/dotnet/generator.py,sha256=ScrCMg-aER9EtJb_32q383Xs7SiiinBSjUUGRoZw9vg,5754
+frameworks/dotnet/templates/Dockerfile.j2,sha256=YK7IaZfsAaB7mfNt1G2979upEaHEw7TXpD5OwqXT9as,542
+frameworks/dotnet/templates/Jenkinsfile.j2,sha256=j4ac3a5OkISiBLlruPy9F13_QMe310Tb4c1pk2iXIWU,163
+frameworks/dotnet/templates/github-actions.yml.j2,sha256=s8ytAfZK6Y6zb6K1d_wf6JcxBQaiVRtgCRvSUSXHj7c,1968
+frameworks/dotnet/templates/gitlab-ci.yml.j2,sha256=e2qcByOH6pPzQ29I8HoPAEu5mh1b7iBmFuo1-zXVto4,1347
+frameworks/gradle/__init__.py,sha256=uHycl82gkj4zjy_fFZZw4MEhett7PpJli1NoMxqNX30,172
+frameworks/gradle/detector.py,sha256=OI7yi_BOi3EDlC9m1SGycJjodeFj9M90EUrIpblcb1k,3969
+frameworks/gradle/generator.py,sha256=1c7nRj_H7aAtcp8ZrZ4wXJDavDa4WMcXrGlUjIjXYfA,5388
+frameworks/gradle/templates/Dockerfile.j2,sha256=qS4VZv98OyzALMDTgfCO_eshgM8AHIQqMwCworzzAdk,634
+frameworks/gradle/templates/Jenkinsfile.j2,sha256=Rr7AcYjf2l33SZVaDWW4D6YSbtqSViweIYhxtXG4f44,163
+frameworks/gradle/templates/github-actions.yml.j2,sha256=Vgfi8-REzplZv9DM1K34x7bEIp3STj3JenaEo-4uFZM,1966
+frameworks/gradle/templates/gitlab-ci.yml.j2,sha256=Fy2Z_zmkjptbZ89AH14LluEyRTsP60Bv3iLSPH2u9rw,1055
+frameworks/java/__init__.py,sha256=MhBeJxNdQyZKeDp5Lz4LEgCtSoCeO8zLLU4j-VXQkxk,158
+frameworks/java/detector.py,sha256=BD_Whan0twNB-kv3pnDqcPDwkUi39QGf55hjsN6t9oI,923
+frameworks/java/generator.py,sha256=sASHMg1WxTAszkTJroQv5mMBpJ9wNXEkTL9qfRqVBt0,929
+frameworks/maven/__init__.py,sha256=BflBSotd-iLNN1MDIqmQodZroAprzNnFF5PQXGHkrZ0,167
+frameworks/maven/detector.py,sha256=vFqWLhLFTxzMsj6i4cV6DT4aanpoa-MwuIAdfW-2K6U,3397
+frameworks/maven/generator.py,sha256=Pt8TDmioX_xd9--vFGxsCeirZ7mk0gvb-fpFIkN88kY,5617
+frameworks/maven/templates/Dockerfile.j2,sha256=0rSTYspIUZnSBPF0a01SwW2UcNgYbvicUVJ_hltH3-4,836
+frameworks/maven/templates/Jenkinsfile.j2,sha256=cXiCJmf_tSlbvfwJtAXj7JalHVAMdFWATTaquLLIV4o,162
+frameworks/maven/templates/github-actions.yml.j2,sha256=0bvN6ROsrRTByBAjcHPoBpXlSMdDgwh6kRMTQp6sjlI,564
+frameworks/maven/templates/gitlab-ci.yml.j2,sha256=1Dd8APErz-R-7k4Za8fPMtMsAvZy66fn5UQswAY9Cpg,1161
+frameworks/node/__init__.py,sha256=88s2aFa7FGELa2j7tlkmUWhkLfu8IrPjk0bwWyFDMTU,116
+frameworks/node/detector.py,sha256=GhxfkRuSWaznPnVbJNkPvrOQDwo44qv2yaElzWFEqi8,3258
+frameworks/node/generator.py,sha256=b-_wQL13hjhJKxwSkbtL1VNN3wloerP-rkZRViRVbfA,5393
+frameworks/node/templates/Dockerfile.j2,sha256=91z9TxWQOey0-XAbZW4cnx0Yl0rcSIdNrZVmLSLbjAM,636
+frameworks/node/templates/Jenkinsfile.j2,sha256=G6UG9KS6JIbExmsCT-HlZAkD6fGfZZE0YTff41_lOmA,160
+frameworks/node/templates/github-actions.yml.j2,sha256=TznC_ki8RYwudbRdB0LMB7OvuFBDXKRXszGg9v4jQic,6619
+frameworks/node/templates/gitlab-ci.yml.j2,sha256=rApavtOLnA5LdvnhQ4EW8kcqVYfS3Tudzacw6h3nl58,1334
+frameworks/python/__init__.py,sha256=Kl3eOjpv_tyNbBN1E9IABQFN0hjUOKspwTrdYxTnCkw,147
+frameworks/python/detector.py,sha256=67NL1VtGFqQ1wOdF0BcOdtlxzP3hU_Q0r5HyY005z-c,6187
+frameworks/python/generator.py,sha256=EgBcaOTCQxTMd7uXq7d0P1qsK3x8wOjc73jKM5-ORw4,9512
+frameworks/python/templates/Dockerfile.j2,sha256=fppi68xMCE9cBcHiaCrmX0mRPe1w_m7LRk-PSCbCwt0,817
+frameworks/python/templates/Jenkinsfile.j2,sha256=bfoTBiHVXLyGVCG5Ias-EwzJtC1gG3nrtreecQGz7Ak,163
+frameworks/python/templates/README.md.j2,sha256=ScPwDQYq2XkrHmvhaU27bvK3XJbi7sNgqBBc1tkkCfY,5493
+frameworks/python/templates/github-actions.yml.j2,sha256=tOFL7VTi90r-hDdm8cjYCkMFyekBsGyKjfBiOr7g4eE,2339
+frameworks/python/templates/gitlab-ci.yml.j2,sha256=5gvlepYPUuK6ZAALZ96OsRBCHzWA48WF0CXNx8uL4r0,1343
+cicd_cli_tool-0.1.0.dist-info/METADATA,sha256=XvcexTUZsnXJuXj-Ujqxq7KeBTD9ethGYL7DfCmUGT4,1838
+cicd_cli_tool-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+cicd_cli_tool-0.1.0.dist-info/entry_points.txt,sha256=WuJa44_vrSvNg8LaRDOBEeB2Q5g1_VSozoVZfMb0Wac,39
+cicd_cli_tool-0.1.0.dist-info/top_level.txt,sha256=iTFuqReac6OeWK02FqIhPrTzd4t9xBxk270SYfFrp4g,20
+cicd_cli_tool-0.1.0.dist-info/RECORD,,

cicd_cli_tool-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

cicd_cli_tool-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+cicd = cli.main:main

cicd_cli_tool-0.1.0.dist-info/top_level.txt

@@ -0,0 +1,3 @@
+cli
+core
+frameworks

cli/main.py

@@ -0,0 +1,384 @@
+"""
+CLI for cicd-framework tool
+Auto-detects project framework and generates CI/CD files
+"""
+from typing import Optional, List
+import typer
+from pathlib import Path
+from rich.console import Console
+from rich.table import Table
+from frameworks import AVAILABLE_FRAMEWORKS
+
+app = typer.Typer(
+    help="CI/CD Framework Generator - Auto-detect and generate pipeline files",
+    add_completion=False
+)
+console = Console()
+
+
+@app.command()
+def init(
+    path: Path = typer.Argument(
+        Path("."),
+        help="Project path to analyze",
+        exists=True,
+        file_okay=False,
+        dir_okay=True,
+        resolve_path=True
+    ),
+    framework: Optional[str] = typer.Option(
+        None,
+        "--framework",
+        "-f",
+        help="Force specific framework (python, node, java, etc.)"
+    ),
+    platforms: str = typer.Option(
+        "jenkins",
+        "--platforms",
+        "-p",
+        help="CI/CD platforms to generate (comma-separated). Options: jenkins | gitlab | github"
+    ),
+    deployment_type: str = typer.Option(
+        "webapp",
+        "--deployment-type",
+        "-dt",
+        help="Type of deployment. Options: webapp | instance"
+    ),
+    cloud_provider: str = typer.Option(
+        "local",
+        "--cloud-provider",
+        "-cp",
+        help="Cloud provider for deployment. Options: local | aws | azure | gcp"
+    ),
+):
+    """
+    Initialize CI/CD pipeline for a project.
+
+    Auto-detects project framework and generates pipeline files.
+
+    Examples:
+
+        # Generate Jenkins pipeline (default)
+        $ cicd-framework init
+
+        # Generate GitLab CI only
+        $ cicd-framework init --platforms gitlab
+
+        # Generate all platforms
+        $ cicd-framework init --platforms jenkins,gitlab,github
+
+        # Force Python framework with multiple platforms
+        $ cicd-framework init --framework python --platforms gitlab,github
+
+        # Deploy to AWS as a webapp
+        $ cicd-framework init --cloud-provider aws --deployment-type webapp
+
+        # Deploy to Azure as a VM instance
+        $ cicd-framework init --cloud-provider azure --deployment-type instance
+    """
+    console.print("🔍 Detecting project framework...\n")
+
+    project_path = Path(path).resolve()
+
+    # Parse and validate platforms
+    requested_platforms = [p.strip().lower() for p in platforms.split(',')]
+    valid_platforms = ['jenkins', 'gitlab', 'github']
+    invalid = [p for p in requested_platforms if p not in valid_platforms]
+
+    if invalid:
+        console.print(f"[red]✗ Invalid platforms: {', '.join(invalid)}[/red]")
+        console.print(f"[yellow]Valid platforms: {', '.join(valid_platforms)}[/yellow]")
+        console.print("\n[dim]Tip: Use comma-separated values like --platforms jenkins,gitlab,github[/dim]")
+        raise typer.Exit(code=1)
+
+    # Validate deployment type
+    deployment_type = deployment_type.lower()
+    valid_deployment_types = ['webapp', 'instance']
+    if deployment_type not in valid_deployment_types:
+        console.print(f"[red]✗ Invalid deployment type: {deployment_type}[/red]")
+        console.print(f"[yellow]Valid deployment types: {', '.join(valid_deployment_types)}[/yellow]")
+        raise typer.Exit(code=1)
+
+    # Validate cloud provider
+    cloud_provider = cloud_provider.lower()
+    valid_cloud_providers = ['local', 'aws', 'azure', 'gcp']
+    if cloud_provider not in valid_cloud_providers:
+        console.print(f"[red]✗ Invalid cloud provider: {cloud_provider}[/red]")
+        console.print(f"[yellow]Valid cloud providers: {', '.join(valid_cloud_providers)}[/yellow]")
+        raise typer.Exit(code=1)
+
+    # If user specified framework, use only that
+    if framework:
+        if framework not in AVAILABLE_FRAMEWORKS:
+            console.print(f"[red]✗ Unknown framework: {framework}[/red]")
+            console.print(f"[yellow]Available frameworks: {', '.join(AVAILABLE_FRAMEWORKS.keys())}[/yellow]")
+            raise typer.Exit(code=1)
+
+        frameworks_to_try = [framework]
+    else:
+        # Try all available frameworks
+        frameworks_to_try = list(AVAILABLE_FRAMEWORKS.keys())
+
+    # Try each framework detector
+    detection_result = None
+    detected_framework = None
+
+    for fw_name in frameworks_to_try:
+        fw_config = AVAILABLE_FRAMEWORKS[fw_name]
+        DetectorClass = fw_config['detector']
+
+        console.print(f"   Trying {fw_name}...", style="dim")
+
+        # Initialize detector and try detection
+        detector = DetectorClass(project_path)
+        result = detector.detect()
+
+        if result is not None:
+            detection_result = result
+            detected_framework = fw_name
+            console.print(f"[green]✓ Detected: {fw_name}[/green]")
+            break
+
+    # Check if detection failed
+    if detection_result is None:
+        console.print("[red]✗ No supported framework detected![/red]")
+        console.print(f"[yellow]Supported frameworks: {', '.join(AVAILABLE_FRAMEWORKS.keys())}[/yellow]")
+        console.print("\n[dim]Tip: Use --framework to force a specific framework[/dim]")
+        raise typer.Exit(code=1)
+
+    # Add project path to result
+    detection_result['project_path'] = str(project_path)
+
+    # Add deployment configuration
+    detection_result['deployment_type'] = deployment_type
+    detection_result['cloud_provider'] = cloud_provider
+
+    # Display detection results
+    console.print()
+    table = Table(title="📊 Detection Results", show_header=True, header_style="bold cyan")
+    table.add_column("Property", style="cyan", no_wrap=True)
+    table.add_column("Value", style="green")
+
+    table.add_row("Framework", detected_framework)
+    table.add_row("Language", detection_result.get("language", "N/A"))
+    table.add_row("Cloud Provider", cloud_provider.upper() if cloud_provider != "local" else "Local Docker")
+    table.add_row("Deployment Type", deployment_type.capitalize())
+
+    # Add framework-specific details
+    if detected_framework == 'python':
+        table.add_row("Python Version", detection_result.get("python_version", "N/A"))
+        table.add_row("Package Manager", detection_result.get("package_manager", "N/A"))
+        table.add_row("Test Framework", detection_result.get("test_framework", "N/A"))
+        if detection_result.get("framework"):
+            table.add_row("Web Framework", detection_result.get("framework"))
+    elif detected_framework == 'node':
+        table.add_row("Node Version", detection_result.get("node_version", "N/A"))
+        table.add_row("Package Manager", detection_result.get("package_manager", "N/A"))
+        if detection_result.get("framework"):
+            table.add_row("Framework", detection_result.get("framework"))
+
+    console.print(table)
+    console.print()
+
+    # Display platforms to generate
+    platforms_display = ", ".join([f"[cyan]{p}[/cyan]" for p in requested_platforms])
+    console.print(f"[bold]📦 Generating CI/CD files for: {platforms_display}[/bold]\n")
+
+    # Get the appropriate generator
+    GeneratorClass = AVAILABLE_FRAMEWORKS[detected_framework]['generator']
+    generator = GeneratorClass()
+
+    try:
+        files = generator.generate(detection_result, project_path, requested_platforms)
+
+        console.print("[green]✅ Generation successful![/green]\n")
+
+        # Display generated files
+        files_table = Table(title="📄 Generated Files", show_header=True, header_style="bold green")
+        files_table.add_column("Platform", style="cyan", no_wrap=True)
+        files_table.add_column("File Path", style="yellow")
+
+        for platform, file_path in files['generated_files'].items():
+            # Make path relative to project for cleaner display
+            try:
+                rel_path = Path(file_path).relative_to(project_path)
+                files_table.add_row(platform.upper(), str(rel_path))
+            except ValueError:
+                files_table.add_row(platform.upper(), str(file_path))
+
+        console.print(files_table)
+        console.print()
+
+        return files
+    except Exception as e:
+        console.print(f"[red]✗ Generation failed: {e}[/red]")
+        import traceback
+        console.print("\n[dim]Stack trace:[/dim]")
+        traceback.print_exc()
+        raise typer.Exit(code=1)
+
+
+@app.command()
+def detect(
+    path: Path = typer.Argument(
+        Path("."),
+        help="Project path to analyze",
+        exists=True,
+        file_okay=False,
+        dir_okay=True,
+        resolve_path=True
+    ),
+    framework: Optional[str] = typer.Option(
+        None,
+        "--framework",
+        "-f",
+        help="Force specific framework detection"
+    ),
+):
+    """
+    Detect project configuration without generating files.
+
+    Useful for testing framework detection.
+
+    Examples:
+
+        # Auto-detect framework
+        $ cicd-framework detect
+
+        # Force Python detection
+        $ cicd-framework detect --framework python
+    """
+    project_path = Path(path).resolve()
+
+    console.print("🔍 Detecting project framework...\n")
+
+    # If user specified framework, use only that
+    if framework:
+        if framework not in AVAILABLE_FRAMEWORKS:
+            console.print(f"[red]✗ Unknown framework: {framework}[/red]")
+            console.print(f"[yellow]Available frameworks: {', '.join(AVAILABLE_FRAMEWORKS.keys())}[/yellow]")
+            raise typer.Exit(code=1)
+        frameworks_to_try = [framework]
+    else:
+        frameworks_to_try = list(AVAILABLE_FRAMEWORKS.keys())
+
+    # Try each framework
+    for fw_name in frameworks_to_try:
+        fw_config = AVAILABLE_FRAMEWORKS[fw_name]
+        DetectorClass = fw_config['detector']
+
+        console.print(f"   Trying {fw_name}...", style="dim")
+        detector = DetectorClass(project_path)
+        result = detector.detect()
+
+        if result is not None:
+            result['project_path'] = str(project_path)
+            result['detected_framework'] = fw_name
+            console.print(f"\n[green]✓ Detected: {fw_name}[/green]\n")
+            console.print_json(data=result)
+            return result
+
+    console.print("[red]✗ No supported framework detected![/red]")
+    console.print(f"[yellow]Supported frameworks: {', '.join(AVAILABLE_FRAMEWORKS.keys())}[/yellow]")
+    raise typer.Exit(code=1)
+
+
+@app.command(name="list")
+def list_frameworks():
+    """
+    List all supported frameworks and platforms.
+
+    Shows available framework detectors and generators.
+    """
+    console.print("\n[bold cyan]🚀 CI/CD Framework Generator[/bold cyan]\n")
+
+    # Frameworks table
+    frameworks_table = Table(title="Supported Frameworks", show_header=True, header_style="bold cyan")
+    frameworks_table.add_column("Framework", style="cyan", no_wrap=True)
+    frameworks_table.add_column("Detector", style="yellow")
+    frameworks_table.add_column("Generator", style="green")
+
+    for fw_name, fw_config in AVAILABLE_FRAMEWORKS.items():
+        frameworks_table.add_row(
+            fw_name.upper(),
+            fw_config['detector'].__name__,
+            fw_config['generator'].__name__
+        )
+
+    console.print(frameworks_table)
+    console.print()
+
+    # Platforms table
+    platforms_table = Table(title="Supported CI/CD Platforms", show_header=True, header_style="bold green")
+    platforms_table.add_column("Platform", style="green", no_wrap=True)
+    platforms_table.add_column("File Generated", style="yellow")
+    platforms_table.add_column("Description", style="dim")
+
+    platforms_table.add_row("Jenkins", "Jenkinsfile", "Declarative pipeline for Jenkins")
+    platforms_table.add_row("GitLab CI", ".gitlab-ci.yml", "GitLab CI/CD configuration")
+    platforms_table.add_row("GitHub Actions", ".github/workflows/ci.yml", "GitHub Actions workflow")
+
+    console.print(platforms_table)
+    console.print()
+
+
+@app.command()
+def version():
+    """
+    Show version information.
+    """
+    console.print("\n[bold cyan]CI/CD Framework Generator[/bold cyan]")
+    console.print("[dim]Version:[/dim] [green]1.0.0[/green]")
+    console.print("[dim]Author:[/dim] [yellow]Ayoub Jedidi[/yellow]")
+    console.print()
+
+
+@app.command()
+def options():
+    """
+    Show all available deployment options and their values.
+    """
+    console.print("\n[bold cyan]🚀 Available Deployment Options[/bold cyan]\n")
+
+    # Cloud Providers table
+    providers_table = Table(title="Cloud Providers", show_header=True, header_style="bold cyan")
+    providers_table.add_column("Value", style="green", no_wrap=True)
+    providers_table.add_column("Description", style="yellow")
+
+    providers_table.add_row("local", "Local Docker Registry (default)")
+    providers_table.add_row("aws", "Amazon Web Services")
+    providers_table.add_row("azure", "Microsoft Azure")
+    providers_table.add_row("gcp", "Google Cloud Platform")
+
+    console.print(providers_table)
+    console.print()
+
+    # Deployment Types table
+    types_table = Table(title="Deployment Types", show_header=True, header_style="bold green")
+    types_table.add_column("Value", style="green", no_wrap=True)
+    types_table.add_column("Description", style="yellow")
+
+    types_table.add_row("webapp", "Web Application/Service (default)")
+    types_table.add_row("instance", "VM/Container Instance")
+
+    console.print(types_table)
+    console.print()
+
+    # Usage examples
+    console.print("[bold]Usage Examples:[/bold]\n")
+    console.print("  [dim]#[/dim] Deploy to AWS as a web application:")
+    console.print("  [cyan]cicd init --cloud-provider aws --deployment-type webapp[/cyan]\n")
+    console.print("  [dim]#[/dim] Deploy to Azure as a VM instance:")
+    console.print("  [cyan]cicd init --cloud-provider azure --deployment-type instance[/cyan]\n")
+    console.print("  [dim]#[/dim] Local Docker deployment:")
+    console.print("  [cyan]cicd init --cloud-provider local[/cyan]\n")
+
+
+def main():
+    """Entry point for the CLI"""
+    app()
+
+
+if __name__ == "__main__":
+    main()
+

core/__init__.py

@@ -0,0 +1,3 @@
+from .base_detector import BaseDetector
+from .base_generator import BaseGenerator
+__all__ = ['BaseDetector', 'BaseGenerator']

core/base_detector.py

@@ -0,0 +1,113 @@
+"""
+Base Detector class for all framework detectors
+Provides common utilities for file checking, reading, and dependency parsing
+"""
+import re
+from pathlib import Path
+from typing import Optional, Set, Dict
+
+
+class BaseDetector:
+    """Base class for framework-specific detectors"""
+
+    def __init__(self, project_path: Path):
+        """
+        Initialize detector with project path
+
+        Args:
+            project_path: Path to the project to detect
+        """
+        self.project_path = Path(project_path)
+
+    def detect(self) -> Optional[Dict]:
+        """
+        Main detection method - must be overridden by child classes
+
+        Returns:
+            Dict with detection results or None if not detected
+        """
+        raise NotImplementedError("Subclasses must implement detect()")
+
+    # ============ Shared File Utilities ============
+
+    def file_exists(self, filename: str) -> bool:
+        """Check if a file exists in project"""
+        return (self.project_path / filename).exists()
+
+    def read_file(self, filename: str) -> str:
+        """Read file content safely"""
+        try:
+            file_path = self.project_path / filename
+            if file_path.exists():
+                return file_path.read_text()
+        except Exception:
+            pass
+        return ""
+
+    def has_files_with_extension(self, extension: str) -> bool:
+        """Check if project has files with given extension"""
+        pattern = f"*.{extension}" if not extension.startswith('*') else extension
+        return bool(list(self.project_path.rglob(pattern)))
+
+    # ============ Shared Version Detection ============
+
+    def normalize_version(self, version: str) -> str:
+        """
+        Normalize version to X.Y format
+        Example: 3.11.2 -> 3.11
+        """
+        parts = version.split('.')
+        if len(parts) >= 2:
+            return f"{parts[0]}.{parts[1]}"
+        return version
+
+    def extract_version_from_content(self, content: str, pattern: str) -> Optional[str]:
+        """
+        Extract version using regex pattern
+
+        Args:
+            content: File content to search
+            pattern: Regex pattern with one capture group for version
+        """
+        match = re.search(pattern, content)
+        if match:
+            return self.normalize_version(match.group(1))
+        return None
+
+    # ============ Shared Dependency Parsing ============
+
+    def parse_dependencies_from_file(self, filename: str) -> Set[str]:
+        """
+        Parse dependencies from a requirements-style file
+        Returns set of lowercase package names
+        """
+        deps = set()
+        content = self.read_file(filename)
+
+        for line in content.split('\n'):
+            line = line.strip().lower()
+            # Skip comments and empty lines
+            if not line or line.startswith('#') or line.startswith('-r'):
+                continue
+
+            # Extract package name (before ==, >=, etc.)
+            pkg = re.split(r'[=<>~!]', line)[0].strip()
+            if pkg:
+                deps.add(pkg)
+
+        return deps
+
+    def check_dependency_in_files(self, dependency: str, *filenames) -> bool:
+        """
+        Check if a dependency exists in any of the given files
+
+        Args:
+            dependency: Package name to look for (case-insensitive)
+            *filenames: Variable number of filenames to check
+        """
+        dependency = dependency.lower()
+        for filename in filenames:
+            deps = self.parse_dependencies_from_file(filename)
+            if dependency in deps:
+                return True
+        return False