Migrate to UV package manager

- Update pyproject.toml with all dependencies and metadata
- Remove setup.py and requirements.txt (replaced by pyproject.toml)
- Update all GitHub Actions workflows to use UV
- Add dev dependencies: ruff, pytest-xdist, pytest-cov
- Add comprehensive UV migration documentation
- Requires Python 3.12+ (down from 3.14)
- Use hatchling as build backend
- Configure ruff, black, mypy, and pytest in pyproject.toml

Author: bubthegreat

.github/workflows/mypy.yml

@@ -7,24 +7,28 @@ on:
     branches: [ master ]
 
 jobs:
-  build:
-
+  typecheck:
     runs-on: ubuntu-latest
     strategy:
       max-parallel: 4
       matrix:
-        python-version: [3.12, 3.13, 3.14]
+        python-version: ["3.12", "3.13"]
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
+
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v2
+      uses: actions/setup-python@v5
       with:
         python-version: ${{ matrix.python-version }}
-    - name: Install Dependencies
-      run: |
-        python -m pip install --upgrade pip
-        pip install -e .
+
+    - name: Install UV
+      uses: astral-sh/setup-uv@v4
+      with:
+        enable-cache: true
+
+    - name: Install dependencies
+      run: uv sync --all-extras
+
     - name: Run mypy
-      run: |
-        mypy src
+      run: uv run mypy src

.github/workflows/pytest.yml

@@ -7,24 +7,28 @@ on:
     branches: [ master ]
 
 jobs:
-  build:
-
+  test:
     runs-on: ubuntu-latest
     strategy:
       max-parallel: 4
       matrix:
-        python-version: [3.12, 3.13, 3.14]
+        python-version: ["3.12", "3.13"]
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
+
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v2
+      uses: actions/setup-python@v5
       with:
         python-version: ${{ matrix.python-version }}
-    - name: Install Dependencies
-      run: |
-        python -m pip install --upgrade pip
-        pip install -e .
-    - name: Run Tests
-      run: |
-        pytest tests
+
+    - name: Install UV
+      uses: astral-sh/setup-uv@v4
+      with:
+        enable-cache: true
+
+    - name: Install dependencies
+      run: uv sync --all-extras
+
+    - name: Run tests
+      run: uv run pytest tests

.github/workflows/python-publish.yml

@@ -1,10 +1,5 @@
-# This workflow will upload a Python Package using Twine when a release is created
-# For more information see: https://help.github.com/en/actions/language-and-framework-guides/using-python-with-github-actions#publishing-to-package-registries
-
-# This workflow uses actions that are not certified by GitHub.
-# They are provided by a third-party and are governed by
-# separate terms of service, privacy policy, and support
-# documentation.
+# This workflow will upload a Python Package using UV when a release is created
+# UV is a modern, fast Python package manager from Astral (creators of Ruff)
 
 name: Upload Python Package
 
@@ -14,23 +9,25 @@ on:
 
 jobs:
   deploy:
-
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
+
     - name: Set up Python
-      uses: actions/setup-python@v2
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.12'
+
+    - name: Install UV
+      uses: astral-sh/setup-uv@v4
       with:
-        python-version: '3.x'
-    - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip
-        pip install build
+        enable-cache: true
+
     - name: Build package
-      run: python -m build
+      run: uv build
+
     - name: Publish package
-      uses: pypa/gh-action-pypi-publish@27b31702a0e7fc50959f5ad993c78deac1bdfc29
-      with:
-        user: __token__
-        password: ${{ secrets.PYPI_API_TOKEN }}
+      env:
+        UV_PUBLISH_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+      run: uv publish

UV_MIGRATION.md

@@ -0,0 +1,147 @@
+# UV Package Manager Migration
+
+This project has been migrated from pip/setuptools to **UV**, a modern, fast Python package manager from Astral (the creators of Ruff).
+
+## What Changed
+
+### ✅ Migrated to UV
+- **Package management**: Now using `uv` instead of `pip`
+- **Configuration**: All dependencies now in `pyproject.toml` (single source of truth)
+- **Lock file**: `uv.lock` ensures reproducible builds
+- **GitHub Actions**: All workflows updated to use UV
+- **Dockerfile**: Already using UV (no changes needed)
+
+### ❌ Removed Files
+- `setup.py` - Replaced by `pyproject.toml`
+- `requirements.txt` - Dependencies now in `pyproject.toml`
+
+## Installation
+
+### Install UV
+
+```bash
+# macOS/Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Windows
+powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
+
+# Or with pip
+pip install uv
+```
+
+### Install Project Dependencies
+
+```bash
+# Install production dependencies
+uv sync
+
+# Install with dev dependencies
+uv sync --all-extras
+
+# Or just dev dependencies
+uv sync --extra dev
+```
+
+## Usage
+
+### Running the Application
+
+```bash
+# Run rom24
+uv run rom24
+
+# Or activate the virtual environment
+source .venv/bin/activate  # Linux/macOS
+.venv\Scripts\activate     # Windows
+rom24
+```
+
+### Development Commands
+
+```bash
+# Run tests
+uv run pytest
+
+# Run tests with coverage
+uv run pytest --cov=rom24
+
+# Run mypy type checking
+uv run mypy src
+
+# Run black formatter
+uv run black src
+
+# Run ruff linter
+uv run ruff check src
+
+# Format with ruff
+uv run ruff format src
+```
+
+### Adding Dependencies
+
+```bash
+# Add a production dependency
+uv add package-name
+
+# Add a dev dependency
+uv add --dev package-name
+
+# Remove a dependency
+uv remove package-name
+```
+
+### Updating Dependencies
+
+```bash
+# Update all dependencies
+uv lock --upgrade
+
+# Update a specific package
+uv lock --upgrade-package package-name
+```
+
+## Benefits of UV
+
+1. **⚡ Fast**: 10-100x faster than pip
+2. **🔒 Reliable**: Lock file ensures reproducible builds
+3. **🎯 Simple**: Single tool for all Python package management
+4. **🔄 Compatible**: Works with existing pip/PyPI ecosystem
+5. **📦 Modern**: Built with Rust, designed for modern Python workflows
+
+## Migration Notes
+
+- The `pyproject.toml` now contains all project metadata and dependencies
+- Dev dependencies are in `[project.optional-dependencies.dev]`
+- The entry point `rom24` is defined in `[project.scripts]`
+- Python 3.12+ is required (down from 3.14 in the old config)
+- All GitHub Actions workflows now use UV for faster CI/CD
+
+## Troubleshooting
+
+### UV not found
+Make sure UV is installed and in your PATH:
+```bash
+uv --version
+```
+
+### Dependencies not syncing
+Try removing the virtual environment and re-syncing:
+```bash
+rm -rf .venv
+uv sync --all-extras
+```
+
+### Lock file conflicts
+Update the lock file:
+```bash
+uv lock
+```
+
+## Documentation
+
+- UV Documentation: https://docs.astral.sh/uv/
+- UV GitHub: https://github.com/astral-sh/uv
+- Astral Blog: https://astral.sh/blog
+

pyproject.toml

@@ -0,0 +1,57 @@
+[project]
+name = "rom24"
+version = "0.0.1.alpha2"
+description = "ROM 2.4 Python MUD Server - A modern Python implementation of the classic ROM MUD"
+readme = "README.md"
+authors = [
+    { name = "Micheal Taylor", email = "bubthegreat@gmail.com" }
+]
+requires-python = ">=3.12"
+dependencies = [
+    "psutil>=6.1.1",
+]
+
+[project.optional-dependencies]
+dev = [
+    "black>=24.10.0",
+    "ipdb>=0.13.13",
+    "mypy>=1.14.1",
+    "pre-commit>=4.0.1",
+    "pytest>=9.0.2",
+    "pytest-xdist>=3.6.1",
+    "pytest-cov>=6.0.0",
+    "ruff>=0.8.4",
+]
+
+[project.scripts]
+rom24 = "rom24.pyom:pyom"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/rom24"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W"]
+ignore = ["E501"]  # Line too long (handled by formatter)
+
+[tool.black]
+line-length = 120
+target-version = ["py312"]
+
+[tool.mypy]
+python_version = "3.12"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = false
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py", "*_test.py"]
+addopts = "-v --cov=rom24 --cov-report=term-missing"