packsmith 0.1.0__tar.gz

packsmith-0.1.0/.editorconfig

@@ -0,0 +1,24 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 4
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.json]
+indent_size = 2
+
+[*.yml]
+indent_size = 2
+
+[*.yaml]
+indent_size = 2
+
+[*.toml]
+indent_size = 4

packsmith-0.1.0/.env

@@ -0,0 +1 @@
+UV_LINK_MODE=copy

packsmith-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,53 @@
+name: Publish to PyPI
+
+on:
+  workflow_dispatch:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v7
+
+      - name: Set up Python
+        uses: actions/setup-python@v6.3.0
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.2.0
+        with:
+          version: latest
+
+      - name: Build distribution
+        run: uv build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v7.0.1
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/packsmith
+    permissions:
+      id-token: write
+    steps:
+    - name: Download all the dists
+      uses: actions/download-artifact@v8.0.1
+      with:
+        name: dist
+        path: dist/
+    - name: Publish distribution 📦 to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1.14

packsmith-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

packsmith-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,18 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.20
+    hooks:
+      - id: ruff-check
+      - id: ruff-format
+
+  - repo: https://github.com/astral-sh/ty-pre-commit
+    rev: v0.0.55
+    hooks:
+      - id: ty
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-yaml
+      - id: end-of-file-fixer
+      - id: trailing-whitespace

packsmith-0.1.0/.python-version

@@ -0,0 +1 @@
+3.14

packsmith-0.1.0/.vscode/settings.json

@@ -0,0 +1,32 @@
+{
+  "editor.formatOnSave": true,
+  "editor.codeActionsOnSave": {
+    "source.fixAll.ruff": "always",
+    "source.organizeImports.ruff": "always"
+  },
+  "[python]": {
+    "editor.defaultFormatter": "charliermarsh.ruff"
+  },
+  "python.analysis.typeCheckingMode": "off",
+  "files.trimTrailingWhitespace": true,
+  "files.insertFinalNewline": true,
+  "editor.rulers": [
+    88
+  ],
+  "editor.tabSize": 4,
+  "editor.insertSpaces": true,
+  "python.testing.pytestEnabled": true,
+  "python.testing.unittestEnabled": false,
+  "python.testing.pytestArgs": [
+    "tests"
+  ],
+  "python.terminal.activateEnvironment": true,
+  "files.exclude": {
+    "**/.git": true,
+    "**/.svn": true,
+    "**/.hg": true,
+    "**/.DS_Store": true,
+    "**/Thumbs.db": true,
+    "**/__pycache__": true
+  }
+}

packsmith-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 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.

packsmith-0.1.0/PKG-INFO

@@ -0,0 +1,123 @@
+Metadata-Version: 2.4
+Name: packsmith
+Version: 0.1.0
+Summary: A CLI based minecraft mod pack creator/manager
+Project-URL: Homepage, https://github.com/Frank1o3/packsmith
+Project-URL: Repository, https://github.com/Frank1o3/packsmith
+Project-URL: Issues, https://github.com/Frank1o3/packsmith/issues
+Author: Frank1o3
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cli,curseforge,minecraft,modpack,modrinth
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Games/Entertainment
+Classifier: Topic :: Utilities
+Requires-Python: >=3.14
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: pydantic>=2.13.4
+Requires-Dist: pyfiglet>=1.0.4
+Requires-Dist: tomli-w>=1.2.0
+Requires-Dist: typer>=0.26.8
+Description-Content-Type: text/markdown
+
+# Packsmith
+
+Packsmith is a CLI tool for creating and managing Minecraft modpacks. It is designed to help you initialize a pack, add mods or other content, resolve dependencies from Modrinth, download the resolved files, and export a distributable modpack archive.
+
+This project is a remake of [ModForge-CLI](https://github.com/Frank1o3/ModForge-CLI), with a focus on a cleaner codebase and a more direct workflow for modern modpack creation.
+
+## What Packsmith does
+
+Packsmith helps you:
+
+- create a new modpack structure with the expected folders
+- add mods, resourcepacks, and shaders to a pack manifest
+- resolve Modrinth dependencies into a lockfile
+- download the resolved files into the correct directories
+- export a modpack as an `.mrpack`-style archive for distribution
+
+## Installation
+
+You can install the project locally with:
+
+```bash
+pip install -e .
+```
+
+Or with `uv`:
+
+```bash
+uv sync
+```
+
+## Basic workflow
+
+1. Create a new pack:
+
+```bash
+packsmith init <pack-name> <game-version> <loader> <loader-version>
+```
+
+2. Add content to the pack:
+
+```bash
+packsmith add <name> mod
+```
+
+You can also use other project types such as `resourcepack` or `shader`.
+
+3. Resolve dependencies:
+
+```bash
+packsmith resolve
+```
+
+4. Download the resolved files:
+
+```bash
+packsmith download
+```
+
+5. Export the pack:
+
+```bash
+packsmith export --client
+```
+
+or
+
+```bash
+packsmith export --server
+```
+
+by default it will export the pack with both server and client stuff
+
+## Project structure
+
+When you initialize a pack, Packsmith creates a basic folder layout similar to this:
+
+```text
+<pack-name>/
+  meta.json
+  lock.toml
+  mods/
+  overrides/
+    config/
+    resourcepacks/
+    shaderpacks/
+```
+
+## Notes
+
+Packsmith is still being developed, and some features are still evolving. The current focus is on building a reliable workflow for modpack creation, dependency resolution, and export.
+
+And i am planning on adding a command that takes in you minecraft version and loader and will give you back the latest most compatible loader for that version of the game
+
+## Mention
+You can look at the [test.sh](test.sh) file in the repos root the code in it makes a basic modpack and you can use it as reference

packsmith-0.1.0/README.md

@@ -0,0 +1,95 @@
+# Packsmith
+
+Packsmith is a CLI tool for creating and managing Minecraft modpacks. It is designed to help you initialize a pack, add mods or other content, resolve dependencies from Modrinth, download the resolved files, and export a distributable modpack archive.
+
+This project is a remake of [ModForge-CLI](https://github.com/Frank1o3/ModForge-CLI), with a focus on a cleaner codebase and a more direct workflow for modern modpack creation.
+
+## What Packsmith does
+
+Packsmith helps you:
+
+- create a new modpack structure with the expected folders
+- add mods, resourcepacks, and shaders to a pack manifest
+- resolve Modrinth dependencies into a lockfile
+- download the resolved files into the correct directories
+- export a modpack as an `.mrpack`-style archive for distribution
+
+## Installation
+
+You can install the project locally with:
+
+```bash
+pip install -e .
+```
+
+Or with `uv`:
+
+```bash
+uv sync
+```
+
+## Basic workflow
+
+1. Create a new pack:
+
+```bash
+packsmith init <pack-name> <game-version> <loader> <loader-version>
+```
+
+2. Add content to the pack:
+
+```bash
+packsmith add <name> mod
+```
+
+You can also use other project types such as `resourcepack` or `shader`.
+
+3. Resolve dependencies:
+
+```bash
+packsmith resolve
+```
+
+4. Download the resolved files:
+
+```bash
+packsmith download
+```
+
+5. Export the pack:
+
+```bash
+packsmith export --client
+```
+
+or
+
+```bash
+packsmith export --server
+```
+
+by default it will export the pack with both server and client stuff
+
+## Project structure
+
+When you initialize a pack, Packsmith creates a basic folder layout similar to this:
+
+```text
+<pack-name>/
+  meta.json
+  lock.toml
+  mods/
+  overrides/
+    config/
+    resourcepacks/
+    shaderpacks/
+```
+
+## Notes
+
+Packsmith is still being developed, and some features are still evolving. The current focus is on building a reliable workflow for modpack creation, dependency resolution, and export.
+
+And i am planning on adding a command that takes in you minecraft version and loader and will give you back the latest most compatible loader for that version of the game
+
+## Mention
+You can look at the [test.sh](test.sh) file in the repos root the code in it makes a basic modpack and you can use it as reference

packsmith-0.1.0/pyproject.toml

@@ -0,0 +1,64 @@
+[project]
+name = "packsmith"
+version = "0.1.0"
+description = "A CLI based minecraft mod pack creator/manager"
+readme = "README.md"
+requires-python = ">=3.14"
+license = "MIT"
+
+dependencies = [
+    "httpx>=0.28.1",
+    "pydantic>=2.13.4",
+    "pyfiglet>=1.0.4",
+    "tomli-w>=1.2.0",
+    "typer>=0.26.8",
+]
+
+authors = [
+    { name = "Frank1o3" }
+]
+
+keywords = [
+    "minecraft",
+    "modrinth",
+    "curseforge",
+    "modpack",
+    "cli",
+]
+
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Games/Entertainment",
+    "Topic :: Utilities",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[dependency-groups]
+dev = [
+    "pre-commit>=4.6.0",
+    "pytest>=9.1.1",
+    "pytest-cov>=7.1.0",
+    "pytest-mock>=3.15.1",
+    "ruff>=0.15.20",
+    "ty>=0.0.55",
+]
+
+[project.scripts]
+packsmith = "packsmith.main:main"
+
+[project.urls]
+Homepage = "https://github.com/Frank1o3/packsmith"
+Repository = "https://github.com/Frank1o3/packsmith"
+Issues = "https://github.com/Frank1o3/packsmith/issues"
+
+[tool.uv]
+package = true

packsmith-0.1.0/ruff.toml

@@ -0,0 +1,63 @@
+target-version = "py314"
+line-length = 88
+src = ["src"]
+
+preview = true
+unsafe-fixes = false
+
+exclude = [
+    ".git",
+    ".venv",
+    ".pytest_cache",
+    ".ruff_cache",
+    "__pycache__",
+    "build",
+    "dist",
+]
+
+[lint]
+select = ["ALL"]
+
+ignore = [
+    # TODOs
+    "TD002",
+    "TD003",
+    "FIX002",
+
+    # Docstrings (enable gradually)
+    "D100",
+    "D101",
+    "D102",
+    "D103",
+    "D104",
+    "D105",
+    "D106",
+    "D107",
+    "D203",
+    "D205",
+    "D213",
+
+    # Tests
+    "S101",
+
+    # Allow Any when needed
+    "ANN401",
+
+    # Security exceptions
+    "S324",
+
+    # Formatter compatibility
+    "COM812",
+    "ISC001",
+]
+
+dummy-variable-rgx = "^(_+|(_[A-Za-z0-9_]*[A-Za-z0-9]+?))$"
+
+[lint.per-file-ignores]
+"tests/**/*.py" = ["S101", "D", "PLR2004"]
+
+[format]
+quote-style = "double"
+indent-style = "space"
+line-ending = "lf"
+docstring-code-format = true

packsmith-0.1.0/src/packsmith/__init__.py

@@ -0,0 +1,2 @@
+# Copyright (c) 2026 Frank1o3
+# SPDX-License-Identifier: MIT

packsmith-0.1.0/src/packsmith/__main__.py

@@ -0,0 +1,6 @@
+# Copyright (c) 2026 Frank1o3
+# SPDX-License-Identifier: MIT
+
+from .main import main
+
+main()

packsmith-0.1.0/src/packsmith/api/__init__.py

@@ -0,0 +1,5 @@
+# Copyright (c) 2026 Frank1o3
+# SPDX-License-Identifier: MIT
+from .modrinth import ModrinthClient
+
+__all__ = ["ModrinthClient"]

packsmith-0.1.0/src/packsmith/api/modrinth.py

@@ -0,0 +1,140 @@
+# Copyright (c) 2026 Frank1o3
+# SPDX-License-Identifier: MIT
+
+from __future__ import annotations
+
+import asyncio
+import json
+import logging
+import time
+from collections.abc import Mapping, Sequence
+from importlib.metadata import version
+from typing import TYPE_CHECKING, Any
+
+from httpx import AsyncClient, QueryParams, Response
+from pydantic import BaseModel
+
+from packsmith.core.models import Hit, ProjectVersion, ProjectVersions, Search
+
+if TYPE_CHECKING:
+    from packsmith.core.models import ProjectType
+
+PrimitiveData = str | int | float | bool | None
+
+QueryParamTypes = (
+    QueryParams
+    | Mapping[str, PrimitiveData | Sequence[PrimitiveData]]
+    | list[tuple[str, PrimitiveData]]
+    | tuple[tuple[str, PrimitiveData], ...]
+    | str
+    | bytes
+) | None
+
+logger = logging.getLogger(__name__)
+
+
+class RateLimitState(BaseModel):
+    limit: int | None = None
+    remaining: int | None = None
+    reset_after: float | None = None
+    last_update: float | None = None
+
+
+class ModrinthClient:
+    BASE_URL = "https://api.modrinth.com/v2"
+
+    def __init__(self) -> None:
+        user_agent = f"Frank1o3/packsmith/{version('packsmith')} (https://github.com/Frank1o3/packsmith)"
+
+        self._client = AsyncClient(
+            base_url=self.BASE_URL, headers={"User-Agent": user_agent}, timeout=30.0
+        )
+        self.rate = RateLimitState()
+        self._lock = asyncio.Lock()
+
+    async def get(
+        self,
+        path: str,
+        *,
+        params: QueryParamTypes = None,
+    ) -> Any:
+        async with self._lock:
+            await self._respect_rate_limit()
+
+        resp = await self._client.get(path, params=params)
+        self._update_rate_limit(resp)
+        resp.raise_for_status()
+
+        return resp.json()
+
+    async def search(
+        self, name: str, project_type: ProjectType, loader: str, game_version: str
+    ) -> Search:
+        facets = [
+            [f"project_type:{project_type}"],
+            [f"versions:{game_version}"],
+        ]
+        params = {
+            "query": name,
+            "limit": 15,
+            "facets": json.dumps(facets),
+        }
+        if project_type == "mod":
+            facets.append([f"categories:{loader}"])
+        return Search.model_validate(await self.get("/search", params=params))
+
+    async def get_project(self, project_id: str) -> Hit:
+        endpoint = f"/project/{project_id}/"
+        return Hit.model_validate_json(await self.get(endpoint))
+
+    async def get_project_versions(self, project_id: str) -> list[ProjectVersion]:
+        endpoint = f"/project/{project_id}/version"
+        return ProjectVersions.validate_python(await self.get(endpoint))
+
+    # ------------------------
+    # rate limit logic
+    # ------------------------
+    def _update_rate_limit(self, resp: Response) -> None:
+        headers = resp.headers
+
+        self.rate.limit = self._safe_int(headers.get("X-Ratelimit-Limit"))
+        self.rate.remaining = self._safe_int(headers.get("X-Ratelimit-Remaining"))
+
+        reset = headers.get("X-Ratelimit-Reset")
+        if reset is not None:
+            self.rate.reset_after = self._safe_float(reset)
+            self.rate.last_update = time.time()
+
+    async def _respect_rate_limit(self) -> None:
+        if (
+            self.rate.remaining is not None
+            and self.rate.remaining <= 0
+            and self.rate.reset_after is not None
+            and self.rate.last_update is not None
+        ):
+            wait_time = self.rate.reset_after - (time.time() - self.rate.last_update)
+            if wait_time > 0:
+                await asyncio.sleep(wait_time)
+
+    async def close(self) -> None:
+        await self._client.aclose()
+
+    async def __aexit__(self, *_: object) -> None:
+        await self.close()
+
+    # ------------------------
+    # Static methods
+    # ------------------------
+    @staticmethod
+    def _safe_int(value: str | None) -> int | None:
+        try:
+            return int(value) if value is not None else None
+        except ValueError:
+            return None
+
+    @staticmethod
+    def _safe_float(value: str | None) -> float | None:
+        try:
+            return float(value) if value is not None else None
+        except ValueError:
+            return None

packsmith-0.1.0/src/packsmith/cli/__init__.py

@@ -0,0 +1,2 @@
+# Copyright (c) 2026 Frank1o3
+# SPDX-License-Identifier: MIT