Release: v2.1.0

Author: InzGIBA

CHANGELOG.md

@@ -5,6 +5,89 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.1.0] - 2024-08-28
+
+### 🚀 Modernization Release - uv and Python 3.12+ Optimization
+
+This release modernizes the project to use `uv` for package management and removes all legacy `typing` imports in favor of modern Python 3.12+ type annotations.
+
+### Added
+
+#### 📦 Package Management Modernization
+- **uv Support**: Full migration from pip to uv for faster package management
+- **Hatchling Backend**: Updated build system to use hatchling instead of setuptools
+- **Optimized Dependencies**: Removed unused dependencies (pathlib-mate, typing-extensions)
+
+#### 🐍 Modern Python 3.12+ Features
+- **Native Type Annotations**: Removed all `typing` module imports
+- **Union Syntax**: Using `|` instead of `Union` throughout codebase
+- **Collections.abc**: Using built-in collections.abc instead of typing equivalents
+- **Modern Object Type**: Using `object` instead of `Any` where appropriate
+
+### Changed
+
+#### 🧹 Code Modernization
+- **Type System**: Complete removal of typing module dependencies
+- **Import Cleanup**: Removed unused imports (asyncio, typing-extensions)
+- **Dependency Reduction**: Streamlined dependency list to essential packages only
+
+#### 📚 Documentation Updates
+- **Installation Instructions**: Updated to recommend uv over pip
+- **Development Setup**: Modernized development workflow with uv
+- **Contributing Guide**: Updated with uv-based development process
+
+### Removed
+
+#### 🗑️ Legacy Code Cleanup
+- **Legacy Scripts**: Removed old compatibility scripts (wog_dump.py, convert_normal_map.py)
+- **Typing Imports**: Eliminated all `from typing import` statements
+- **Unused Dependencies**: Removed pathlib-mate and typing-extensions
+- **Dead Code**: Cleaned up unused imports and deprecated patterns
+
+### Migration Guide
+
+#### For Developers
+
+**Old Development Setup:**
+```bash
+pip install -e ".[dev]"
+```
+
+**New Development Setup:**
+```bash
+uv pip install -e ".[dev]"
+```
+
+#### Type Annotation Changes
+
+**Before (v2.0):**
+```python
+from typing import Any, Dict, List, Optional, Union
+
+def process_data(items: List[Dict[str, Any]]) -> Optional[Dict[str, Union[str, int]]]:
+    pass
+```
+
+**After (v2.1):**
+```python
+def process_data(items: list[dict[str, object]]) -> dict[str, str | int] | None:
+    pass
+```
+
+### Technical Improvements
+
+#### Performance
+- **Faster Installation**: uv provides significantly faster package resolution and installation
+- **Reduced Dependencies**: Fewer packages to install and manage
+- **Cleaner Imports**: No typing module overhead
+
+#### Developer Experience
+- **Modern Syntax**: Cleaner, more readable type annotations
+- **Better Tooling**: uv provides superior dependency management
+- **Simplified Setup**: Fewer steps required for development environment
+
+---
+
 ## [2.0.0] - 2024-08-28
 
 ### 🚀 Major Release - Complete Rewrite for Python 3.12+

CONTRIBUTING.md

@@ -14,14 +14,17 @@ Thank you for your interest in contributing to WOG Dump! This document provides
 
 2. **Set up Development Environment**
    ```bash
-   # Create virtual environment
-   python -m venv venv
-   source venv/bin/activate  # Linux/macOS
+   # Install uv if you haven't already
+   curl -LsSf https://astral.sh/uv/install.sh | sh
+   
+   # Create virtual environment with uv
+   uv venv
+   source .venv/bin/activate  # Linux/macOS
    # or
-   venv\Scripts\activate     # Windows
+   .venv\Scripts\activate     # Windows
 
    # Install in development mode
-   pip install -e ".[dev]"
+   uv pip install -e ".[dev]"
    ```
 
 3. **Install Pre-commit Hooks**

README.md

@@ -30,32 +30,39 @@ WOG Dump is a modern, completely refactored Python tool for extracting 3D gun mo
 
 ## 🚀 Installation
 
-### Quick Install (Recommended)
+### Quick Install with uv (Recommended)
+
+[uv](https://github.com/astral-sh/uv) is the modern, fast Python package installer and resolver.
+
 ```bash
+# Install uv if you haven't already
+curl -LsSf https://astral.sh/uv/install.sh | sh
+# or with pip: pip install uv
+
 # Clone the repository
 git clone https://github.com/hampta/WOG-dump
 cd WOG-dump
 
-# Install in development mode
-pip install -e .
+# Install in development mode with uv
+uv pip install -e .
 ```
 
-### Manual Install
+### Alternative Installation Methods
+
+**Traditional pip:**
 ```bash
 # Clone repository
 git clone https://github.com/hampta/WOG-dump
 cd WOG-dump
 
-# Install dependencies
-pip install -r requirements.txt
-# OR install from pyproject.toml
-pip install .
+# Install with pip
+pip install -e .
 ```
 
-### Development Setup
+**Development Setup with uv:**
 ```bash
 # Install with development dependencies
-pip install -e ".[dev]"
+uv pip install -e ".[dev]"
 
 # Install pre-commit hooks
 pre-commit install
@@ -207,8 +214,8 @@ pytest -m slow              # Slow tests
 ## 🔨 Development
 
 ```bash
-# Install development dependencies
-pip install -e ".[dev]"
+# Install development dependencies with uv
+uv pip install -e ".[dev]"
 
 # Code formatting
 black src/ tests/
@@ -219,6 +226,9 @@ mypy src/
 
 # Linting
 flake8 src/ tests/
+
+# Run all checks
+uv run pre-commit run --all-files
 ```
 
 ## ➕ Additional Tools

convert_normal_map.py

@@ -1,10 +1,10 @@
 [build-system]
-requires = ["setuptools>=68.0", "wheel"]
-build-backend = "setuptools.build_meta"
+requires = ["hatchling"]
+build-backend = "hatchling.build"
 
 [project]
 name = "wog-dump"
-version = "2.0.0"
+version = "2.1.0"
 description = "A modern tool to download, decrypt and unpack 3D gun models from World of Guns: Gun Disassembly"
 readme = "README.md"
 license = {text = "MIT"}
@@ -37,8 +37,6 @@ dependencies = [
     "pydantic>=2.4.0",
     "pillow>=10.0.0",
     "rich>=13.0.0",
-    "pathlib-mate>=1.0.0",
-    "typing-extensions>=4.8.0",
 ]
 
 [project.optional-dependencies]
@@ -68,12 +66,6 @@ Documentation = "https://github.com/hampta/WOG-dump/blob/main/README.md"
 wog-dump = "wog_dump.cli.main:main"
 wog-convert-normals = "wog_dump.utils.normal_map:cli_main"
 
-[tool.setuptools.packages.find]
-where = ["src"]
-
-[tool.setuptools.package-dir]
-"" = "src"
-
 [tool.black]
 line-length = 88
 target-version = ['py312']

pyproject.toml

@@ -9,7 +9,7 @@
 
 from __future__ import annotations
 
-__version__ = "2.0.0"
+__version__ = "2.1.0"
 __author__ = "hampta"
 __email__ = "hampta@example.com"
 __description__ = "A modern tool to download, decrypt and unpack 3D gun models from World of Guns: Gun Disassembly"

requirements.txt

@@ -4,7 +4,6 @@
 
 import sys
 from pathlib import Path
-from typing import Any
 
 import click
 

src/wog_dump/__init__.py

@@ -5,7 +5,6 @@
 import os
 import platform
 from pathlib import Path
-from typing import Any, ClassVar
 
 from pydantic import BaseModel, Field, computed_field, field_validator
 
@@ -137,7 +136,7 @@ def get_config() -> WOGConfig:
     return _config
 
 
-def set_config(**kwargs: Any) -> WOGConfig:
+def set_config(**kwargs: object) -> WOGConfig:
     """Set configuration parameters and return the updated config."""
     global _config
     if _config is None:

src/wog_dump/cli/main.py

@@ -9,7 +9,6 @@
 from concurrent.futures import ThreadPoolExecutor, as_completed
 from io import BytesIO
 from pathlib import Path
-from typing import Any
 
 import requests
 import UnityPy
@@ -71,7 +70,7 @@ def get_key_for_asset(self, asset_name: str) -> str | None:
 
             return None
 
-        except (requests.RequestException, bz2.BZ2Error, UnicodeDecodeError) as e:
+        except (requests.RequestException, OSError, UnicodeDecodeError) as e:
             self.logger.error(f"Failed to get key for {asset_name}: {e}")
             return None