modforge-cli 0.2.3__py3-none-any.whl

modforge_cli/core/utils.py

@@ -0,0 +1,416 @@
+from datetime import datetime
+import json
+from pathlib import Path
+import re
+import shutil
+import subprocess
+import sys
+import tempfile
+import traceback
+import urllib.request
+
+import aiohttp
+from rich.console import Console
+from rich.table import Table
+import typer
+
+from modforge_cli.api import ModrinthAPIConfig
+from modforge_cli.core import ModDownloader
+from modforge_cli.core.models import Manifest, SearchResult
+
+try:
+    from modforge_cli.__version__ import __author__, __version__
+except ImportError:
+    __version__ = "unknown"
+    __author__ = "Frank1o3"
+
+
+def normalize_search_term(term: str) -> str:
+    """
+    Normalize a search term for fuzzy matching.
+    
+    - Converts to lowercase
+    - Removes spaces, dashes, underscores
+    - Removes special characters
+    
+    Examples:
+        "Dynamic FPS" -> "dynamicfps"
+        "sodium-extra" -> "sodiumextra"
+        "3D Skin Layers" -> "3dskinlayers"
+    """
+    # Convert to lowercase
+    normalized = term.lower()
+    # Remove spaces, dashes, underscores
+    normalized = re.sub(r'[\s\-_]', '', normalized)
+    # Remove special characters except alphanumeric
+    normalized = re.sub(r'[^a-z0-9]', '', normalized)
+    return normalized
+
+
+def calculate_match_score(search_term: str, hit_slug: str, hit_title: str = "") -> int:
+    """
+    Calculate a match score between search term and a mod.
+    Higher score = better match.
+    
+    Scoring:
+        100: Exact slug match
+        90: Exact title match (case-insensitive)
+        80: Normalized slug match
+        70: Normalized title match
+        60: Slug starts with search term
+        50: Title starts with search term
+        40: Slug contains search term
+        30: Title contains search term
+        0: No match
+    """
+    search_lower = search_term.lower()
+    search_normalized = normalize_search_term(search_term)
+    
+    slug_lower = hit_slug.lower()
+    slug_normalized = normalize_search_term(hit_slug)
+    
+    title_lower = hit_title.lower() if hit_title else ""
+    title_normalized = normalize_search_term(hit_title) if hit_title else ""
+    
+    # Exact matches (highest priority)
+    if search_term == hit_slug:
+        return 100
+    if search_lower == title_lower:
+        return 90
+    
+    # Normalized matches
+    if search_normalized == slug_normalized:
+        return 80
+    if title_normalized and search_normalized == title_normalized:
+        return 70
+    
+    # Starts with matches
+    if slug_lower.startswith(search_lower):
+        return 60
+    if title_lower and title_lower.startswith(search_lower):
+        return 50
+    
+    # Contains matches
+    if search_lower in slug_lower:
+        return 40
+    if title_lower and search_lower in title_lower:
+        return 30
+    
+    # Normalized contains (fallback)
+    if search_normalized in slug_normalized:
+        return 20
+    if title_normalized and search_normalized in title_normalized:
+        return 10
+    
+    return 0
+
+
+def find_best_match(search_term: str, hits: list) -> tuple[object, int]:
+    """
+    Find the best matching mod from search results.
+    
+    Returns:
+        (best_hit, score) tuple
+    """
+    best_hit = None
+    best_score = 0
+    
+    for hit in hits:
+        # Get title from hit if available
+        title = getattr(hit, 'title', '') or getattr(hit, 'name', '')
+        score = calculate_match_score(search_term, hit.slug, title)
+        
+        if score > best_score:
+            best_score = score
+            best_hit = hit
+    
+    return best_hit, best_score
+
+
+def ensure_config_file(path: Path, url: str, label: str, console: Console) -> None:
+    """Download config file if missing"""
+    if path.exists():
+        return
+
+    path.parent.mkdir(parents=True, exist_ok=True)
+
+    console.print(f"[yellow]Missing {label} config.[/yellow] Downloading default…")
+
+    try:
+        urllib.request.urlretrieve(url, path)
+        console.print(f"[green]✓ {label} config installed at {path}[/green]")
+    except Exception as e:
+        console.print(f"[red]Failed to download {label} config:[/red] {e}")
+        raise typer.Exit(1) from e
+
+
+# --- Async Helper ---
+async def get_api_session() -> aiohttp.ClientSession:
+    """Returns a session with the correct ModForge-CLI headers."""
+    timeout = aiohttp.ClientTimeout(total=60, connect=10)
+    return aiohttp.ClientSession(
+        headers={"User-Agent": f"{__author__}/ModForge-CLI/{__version__}"},
+        timeout=timeout,
+        raise_for_status=False,  # Handle errors manually
+    )
+
+
+def get_manifest(console: Console, path: Path = Path.cwd()) -> Manifest | None:
+    """Load and validate manifest file"""
+    p = path / "ModForge-CLI.json"
+    if not p.exists():
+        return None
+    try:
+        return Manifest.model_validate_json(p.read_text())
+    except Exception as e:
+        console.print(f"[red]Error parsing manifest:[/red] {e}")
+        return None
+
+
+def save_registry_atomic(registry: dict, path: Path) -> None:
+    """
+    Atomically save registry to prevent corruption from concurrent access.
+
+    Uses a temp file + atomic rename to ensure the registry is never
+    left in a partially-written state.
+    """
+    path.parent.mkdir(parents=True, exist_ok=True)
+
+    # Write to temp file in same directory (required for atomic rename)
+    with tempfile.NamedTemporaryFile(
+        mode="w", delete=False, dir=path.parent, prefix=".registry-", suffix=".tmp"
+    ) as f:
+        json.dump(registry, f, indent=4)
+        temp_path = Path(f.name)
+
+    # Atomic rename (POSIX guarantees atomicity)
+    try:
+        temp_path.replace(path)
+    except Exception as e:
+        temp_path.unlink(missing_ok=True)
+        raise RuntimeError(f"Failed to save registry: {e}") from e
+
+
+def load_registry(path: Path) -> dict[str, str]:
+    """Load registry with error handling"""
+    if not path.exists():
+        return {}
+
+    try:
+        return json.loads(path.read_text())
+    except json.JSONDecodeError as e:
+        # Registry is corrupted - back it up and start fresh
+        backup = path.with_suffix(f".corrupt-{datetime.now():%Y%m%d-%H%M%S}.json")
+        shutil.copy(path, backup)
+        print(f"Warning: Corrupted registry backed up to {backup}")
+        return {}
+
+
+def setup_crash_logging() -> Path:
+    """Configure crash logging for bug reports"""
+    log_dir = Path.home() / ".config" / "ModForge-CLI" / "logs"
+    log_dir.mkdir(parents=True, exist_ok=True)
+
+    def excepthook(exc_type, exc_value, exc_traceback) -> None:
+        """Log crashes for bug reports"""
+
+        log_file = log_dir / f"crash-{datetime.now():%Y%m%d-%H%M%S}.log"
+
+        with open(log_file, "w") as f:
+            f.write(f"ModForge-CLI v{__version__}\n")
+            f.write(f"Python {sys.version}\n")
+            f.write(f"Platform: {sys.platform}\n\n")
+            traceback.print_exception(exc_type, exc_value, exc_traceback, file=f)
+
+        console = Console()
+        console.print(f"\n[red bold]ModForge-CLI crashed![/red bold]")
+        console.print(f"[yellow]Crash log saved to:[/yellow] {log_file}")
+        console.print("[dim]Please include this file when reporting the issue at:")
+        console.print("[dim]https://github.com/Frank1o3/ModForge-CLI/issues\n")
+
+    sys.excepthook = excepthook
+    return log_dir
+
+
+def install_fabric(
+    installer: Path,
+    mc_version: str,
+    loader_version: str,
+    game_dir: Path,
+) -> None:
+    """Install Fabric loader with better error handling"""
+    try:
+        result = subprocess.run(
+            [
+                "java",
+                "-jar",
+                str(installer),
+                "client",
+                "-mcversion",
+                mc_version,
+                "-loader",
+                loader_version,
+                "-dir",
+                str(game_dir),
+                "-noprofile",
+            ],
+            check=True,
+            capture_output=True,
+            text=True,
+        )
+    except subprocess.CalledProcessError as e:
+        raise RuntimeError(
+            f"Fabric installation failed:\n{e.stderr}\n\n"
+            f"Make sure Java is installed and accessible."
+        ) from e
+    except FileNotFoundError as e:
+        raise RuntimeError("Java not found. Please install Java 17 or higher and try again.") from e
+
+
+def detect_install_method() -> str:
+    """Detect how ModForge-CLI was installed"""
+    prefix = Path(sys.prefix)
+
+    if "pipx" in prefix.parts or "pipx" in str(prefix):
+        return "pipx"
+    return "pip"
+
+
+def self_update(console: Console) -> None:
+    """Update ModForge-CLI to latest version"""
+    method = detect_install_method()
+
+    try:
+        if method == "pipx":
+            console.print("[cyan]Updating ModForge-CLI using pipx...[/cyan]")
+            subprocess.run(["pipx", "upgrade", "ModForge-CLI"], check=True)
+        else:
+            console.print("[cyan]Updating ModForge-CLI using pip...[/cyan]")
+            subprocess.run(
+                [sys.executable, "-m", "pip", "install", "--upgrade", "ModForge-CLI"],
+                check=True,
+            )
+
+        console.print("[green]✓ ModForge-CLI updated successfully.[/green]")
+    except subprocess.CalledProcessError as e:
+        console.print(f"[red]Update failed:[/red] {e}")
+        raise
+
+
+async def run(api: ModrinthAPIConfig, manifest: Manifest, mods_dir: Path, index_file: Path) -> None:
+    """Download all mods with progress tracking"""
+    async with await get_api_session() as session:
+        downloader = ModDownloader(
+            api=api,
+            mc_version=manifest.minecraft,
+            loader=manifest.loader,
+            output_dir=mods_dir,
+            index_file=index_file,
+            session=session,
+        )
+        await downloader.download_all(manifest.mods)
+
+
+async def perform_add(
+    api: ModrinthAPIConfig,
+    name: str,
+    manifest: Manifest,
+    project_type: str,
+    console: Console,
+    manifest_file: Path,
+) -> None:
+    """
+    Search and add a project to the manifest with improved fuzzy matching.
+    
+    This function now:
+    - Normalizes search terms to handle spaces, dashes, case variations
+    - Scores matches to find the best result
+    - Shows multiple options if the match is uncertain
+    - Provides helpful feedback about what was found
+    """
+    async with await get_api_session() as session:
+        url = api.search(
+            name,
+            game_versions=[manifest.minecraft],
+            loaders=[manifest.loader],
+            project_type=project_type,
+        )
+
+        try:
+            async with session.get(url) as response:
+                if response.status != 200:
+                    console.print(f"[red]API request failed with status {response.status}[/red]")
+                    return
+
+                results = SearchResult.model_validate_json(await response.text())
+        except Exception as e:
+            console.print(f"[red]Failed to search Modrinth:[/red] {e}")
+            return
+
+        if not results or not results.hits:
+            console.print(f"[red]No {project_type} found for '{name}'[/red]")
+            console.print(f"[dim]Try searching on https://modrinth.com/mods?q={name}[/dim]")
+            return
+
+        # Find best match using scoring system
+        best_hit, best_score = find_best_match(name, results.hits)
+        
+        if not best_hit:
+            console.print(f"[red]No suitable match found for '{name}'[/red]")
+            return
+        
+        slug = best_hit.slug
+        
+        # Show what we found with confidence level
+        confidence_msg = ""
+        if best_score >= 80:
+            confidence_msg = "[green](high confidence match)[/green]"
+        elif best_score >= 60:
+            confidence_msg = "[yellow](medium confidence match)[/yellow]"
+        elif best_score >= 40:
+            confidence_msg = "[yellow](low confidence match)[/yellow]"
+        else:
+            confidence_msg = "[red](uncertain match - please verify)[/red]"
+        
+        console.print(f"[cyan]Found:[/cyan] {slug} {confidence_msg}")
+        
+        # If confidence is low and there are multiple results, show alternatives
+        if best_score < 60 and len(results.hits) > 1:
+            console.print("\n[yellow]Other possible matches:[/yellow]")
+            table = Table(show_header=True, header_style="bold cyan")
+            table.add_column("#", style="dim", width=3)
+            table.add_column("Slug", style="cyan")
+            table.add_column("Score", justify="right", style="dim")
+            
+            # Show top 5 alternatives
+            scored_hits = []
+            for hit in results.hits[:10]:
+                title = getattr(hit, 'title', '') or getattr(hit, 'name', '')
+                score = calculate_match_score(name, hit.slug, title)
+                scored_hits.append((hit, score))
+            
+            scored_hits.sort(key=lambda x: x[1], reverse=True)
+            
+            for idx, (hit, score) in enumerate(scored_hits[:5], 1):
+                table.add_row(str(idx), hit.slug, str(score))
+            
+            console.print(table)
+            console.print("\n[dim]Tip: Use the exact slug if the match is wrong[/dim]")
+            console.print(f"[dim]Example: ModForge-CLI add {scored_hits[1][0].slug if len(scored_hits) > 1 else 'exact-slug'}[/dim]\n")
+
+        # Add to appropriate list
+        target_list = {
+            "mod": manifest.mods,
+            "resourcepack": manifest.resourcepacks,
+            "shaderpack": manifest.shaderpacks,
+        }.get(project_type, manifest.mods)
+
+        if slug not in target_list:
+            target_list.append(slug)
+            try:
+                manifest_file.write_text(manifest.model_dump_json(indent=4))
+                console.print(f"[green]✓ Added {slug} to {project_type}s[/green]")
+            except Exception as e:
+                console.print(f"[red]Failed to save manifest:[/red] {e}")
+        else:
+            console.print(f"[yellow]{slug} is already in the manifest[/yellow]")

modforge_cli-0.2.3.dist-info/METADATA

@@ -0,0 +1,70 @@
+Metadata-Version: 2.4
+Name: modforge-cli
+Version: 0.2.3
+Summary: ModForge-CLI — a Modrinth-based Minecraft modpack builder
+License: MIT
+License-File: LICENSE
+Author: Frank1o3
+Author-email: jahdy1o3@gmail.com
+Requires-Python: >=3.10,<4.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Dist: aiofiles (>=25.1.0,<26.0.0)
+Requires-Dist: aiohttp (>=3.13.3,<4.0.0)
+Requires-Dist: jsonschema (>=4.25.1,<5.0.0)
+Requires-Dist: pydantic (>=2.12.5,<3.0.0)
+Requires-Dist: pyfiglet (>=1.0.4,<2.0.0)
+Requires-Dist: pyzipper (>=0.3.6,<0.4.0)
+Requires-Dist: requests (>=2.32.5,<3.0.0)
+Requires-Dist: rich (>=14.2.0,<15.0.0)
+Requires-Dist: typer (>=0.21.1,<0.22.0)
+Project-URL: Homepage, https://frank1o3.github.io/ModForge-CLI/
+Project-URL: Repository, https://github.com/Frank1o3/ModForge-CLI
+Description-Content-Type: text/markdown
+
+# ModForge-CLI ⛏
+
+[![Python 3.13+](https://img.shields.io/badge/python-3.13%2B-blue)](https://www.python.org/)
+[![MIT License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![Modrinth API v2](https://img.shields.io/badge/Modrinth-API%20v2-orange)](https://docs.modrinth.com/api-spec)
+
+**ModForge-CLI** is a powerful CLI tool for building and managing custom Minecraft modpacks using the Modrinth API v2.
+
+Search for projects, fetch versions, validate manifests, download mods with hash checks, and generate complete files — all from the terminal.
+
+Ideal for modpack developers, server admins, and automation scripts.
+
+## Terminal Banner
+
+When you run ModForge-CLI, you'll be greeted with this colorful Minecraft-themed banner
+
+## Key Features
+
+- **Modrinth API v2 Integration**: Search projects, list versions, fetch metadata in bulk.
+- **Modpack Management**: Read/validate `modrinth.index.json`, build packs from metadata.
+- **Validation**: Full JSON Schema checks + optional Pydantic models for strict typing.
+
+## Installation
+
+Requires **Python 3.13+**.
+
+**Recommended (Poetry)**:
+
+```bash
+poetry install
+```
+
+**Alternative (pip)**:
+
+```bash
+pip install -r requirements.txt
+```
+

modforge_cli-0.2.3.dist-info/RECORD

@@ -0,0 +1,24 @@
+modforge_cli/__init__.py,sha256=UFmSxUpR5CtjtHIrKKfgWhpZeM559ufyWg3Q03SbJ_g,77
+modforge_cli/__main__.py,sha256=KxLK89lHZn5zaMp8l42d4AAzdqh2I9LSyE9XSWlL18k,4257
+modforge_cli/__version__.py,sha256=339BKq5iPtupYyyjt36PE8YybSEHI19D6hVQAqJvMEU,88
+modforge_cli/api/__init__.py,sha256=5BlfsH345QbdgkwpRCOLKhNLGlgRRWAy7oaceAXgbmU,138
+modforge_cli/api/modrinth.py,sha256=ptxAzaQ309i2uWZd1hLjjQDyZNcbAJr7RxT_13bqCXM,7787
+modforge_cli/cli/__init__.py,sha256=XzI-mK4_ycE-GFkwE4vtGklzzDEAjKDApiiCeq7d9BA,196
+modforge_cli/cli/export.py,sha256=pk6HZmnF-DN15TIu16-SXtq_B2AlhJW2BbbxCMgZO30,9734
+modforge_cli/cli/modpack.py,sha256=MpOjVT9UAnwJ-hliDi2Xtz0PzWRTwpCPMic922oRMp4,4595
+modforge_cli/cli/project.py,sha256=19-rLCAb3xNdEr7z0eq8dW3EfbQNjTufrCBLvVz54HE,1916
+modforge_cli/cli/setup.py,sha256=ZhnfWsH9OnMxf2eSR3ZWFdyK0jIv8zfqeffcLoD7-Yo,2081
+modforge_cli/cli/shared.py,sha256=-YAylKVUIHlPrPXv6dm6KiF7R5DkUcBnPkjqmrhK8zU,1161
+modforge_cli/cli/sklauncher.py,sha256=OaNc3W_5bCHEIN192UWv5T_Yc6kujzU4S5cMjtNI0n8,4408
+modforge_cli/cli/utils.py,sha256=Wn-bXsrVTdsKGZd-P7APycNQWu3mnZZaP9ud4SaThMk,1960
+modforge_cli/core/__init__.py,sha256=WHmCpDLbhIh7I0HL63mNAk3w6opFgJhCwybnFCqIrJk,844
+modforge_cli/core/downloader.py,sha256=LWOwpAZjXXANTGnDJz5IqiLK88oLNzsob6YfHUYmpAU,7134
+modforge_cli/core/models.py,sha256=gGn9f8P89dggMrk-Mu4NYYlylyJ5uF6WVU4PnDNErJk,1782
+modforge_cli/core/policy.py,sha256=mAnIyTd2aRTJTzQBDQWjuas9sFQVxy4fTNTwpCOBt6M,4766
+modforge_cli/core/resolver.py,sha256=qxRH115rQUNSy_7rg3P5knuKx15zLccc04vUyOorPYA,6210
+modforge_cli/core/utils.py,sha256=rTKApM5PNKXjZz3uOIIVReXYu62_v9t0k19h6RPoj30,13938
+modforge_cli-0.2.3.dist-info/METADATA,sha256=PM3rStkpJAJ5JcgbhVbwxMANnsT5mcZsmJGGP8APYKA,2468
+modforge_cli-0.2.3.dist-info/WHEEL,sha256=3ny-bZhpXrU6vSQ1UPG34FoxZBp3lVcvK0LkgUz6VLk,88
+modforge_cli-0.2.3.dist-info/entry_points.txt,sha256=_6WKjhPS5-J1nNSwGiljk6l9xchIpXmeH7gxrTfse7E,59
+modforge_cli-0.2.3.dist-info/licenses/LICENSE,sha256=SAuHlb0YymKIXKAXl0lwgwwu31REY-3oBdLARIObBbs,1065
+modforge_cli-0.2.3.dist-info/RECORD,,

modforge_cli-0.2.3.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 2.3.0
+Root-Is-Purelib: true
+Tag: py3-none-any

modforge_cli-0.2.3.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+modforge-cli=modforge_cli.__main__:main
+

modforge_cli-0.2.3.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Frank1o3
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.