feat: add Modrinth modpack integration and tests

Author: devsker

.gitignore

@@ -145,4 +145,6 @@ ehthumbs.db
 Thumbs.db
 
 testIn
-testOut
+testOut
+
+*.mrpack

README.md

@@ -1,6 +1,6 @@
 # server pack builder
 
-A Python CLI tool for filtering Minecraft modpacks to create server-compatible mod sets.
+A Python CLI tool for filtering Minecraft modpacks to create server-compatible mod sets. It supports both local directory processing and direct Modrinth modpack integration.
 
 ## Installation
 
@@ -12,29 +12,49 @@ pip install -r requirements.txt
 
 ## Usage
 
-Run the tool with source and destination directories:
+The tool operates in two modes: Local and Modrinth.
+
+### Local Mode
+Process a local directory of mods:
 
 ```bash
 python server_pack_builder.py --source /path/to/mods --destination /path/to/server_mods
 ```
 
+### Modrinth Mode
+Download and filter a Modrinth modpack directly from a URL or slug:
+
+```bash
+python server_pack_builder.py --modrinth-url https://modrinth.com/modpack/fabric-boosted
+```
+
 ### Arguments
-- `--source`, `-s`: Path to the source 'mods' directory (required)
-- `--destination`, `-d`: Path to the destination 'mods' directory (required)
-- `--dry-run`: Simulate the process without copying files (optional)
-- `--verbose`, `-v`: Enable verbose logging (optional)
+
+#### Common
+- `--dry-run`: Simulate the process without copying or writing files.
+- `--verbose`, `-v`: Enable verbose logging.
+
+#### Local Mode
+- `--source`, `-s`: Path to the source 'mods' directory.
+- `--destination`, `-d`: Path to the destination 'mods' directory.
+
+#### Modrinth Mode
+- `--modrinth-url`, `-m`: Modrinth Modpack URL or Slug.
+- `--output-file`, `-o`: Output path for the generated `.mrpack` (optional, defaults to `{PackName}-server.mrpack`).
 
 ## Features
 
-- Filters out client-only mods
-- Supports Fabric and Forge mod loaders
-- Preserves server-required mods
+- **Client-Side Filtering**: Automatically detects and removes client-only mods by inspecting JAR metadata.
+- **Modrinth Integration**: Downloads, filters, and repacks `.mrpack` files.
+- **Multi-Loader Support**: Works with Fabric and Forge mod loaders.
+- **Overrides Preservation**: Keeps configuration and other data from the modpack's `overrides` folder.
 
 ## Development
 
 For linting and testing:
 
 ```bash
-black . && isort . && flake8 . && mypy .
-pytest
+python -m black . && python -m isort . && python -m flake8 . && python -m mypy .
+python -m pytest
 ```
+

requirements.txt

@@ -0,0 +1,2 @@
+requests
+tomli; python_version < "3.11"