umpaper-fetch 1.0.2__tar.gz → 1.0.4__tar.gz

{umpaper_fetch-1.0.2 → umpaper_fetch-1.0.4}/.gitignore

@@ -50,4 +50,20 @@ Thumbs.db
 
 # Credentials (never commit these)
 credentials.txt
-config.ini 
+config.ini
+
+# Documentation (local development only)
+docs/
+
+# Development/Debug files
+test_*.py
+debug_*.py
+example_*.py
+main.py
+search_response.html
+
+# Root-level duplicate modules (use umpaper_fetch/ instead)
+auth/
+downloader/
+scraper/
+utils/ 

umpaper_fetch-1.0.4/PKG-INFO

@@ -0,0 +1,363 @@
+Metadata-Version: 2.4
+Name: umpaper-fetch
+Version: 1.0.4
+Summary: Automated downloader for University Malaya past year exam papers
+Home-page: https://github.com/MarcusMQF/umpaper-fetch
+Author: Marcus Mah
+Author-email: Marcus Mah <marcusmah6969@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/MarcusMQF/umpaper-fetch
+Project-URL: Documentation, https://github.com/MarcusMQF/umpaper-fetch#readme
+Project-URL: Repository, https://github.com/MarcusMQF/umpaper-fetch
+Project-URL: Bug Reports, https://github.com/MarcusMQF/umpaper-fetch/issues
+Keywords: university,malaya,um,exam,papers,downloader,automation,selenium
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Education
+Classifier: Topic :: Education
+Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
+Classifier: Topic :: Utilities
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: selenium>=4.15.2
+Requires-Dist: requests>=2.31.0
+Requires-Dist: beautifulsoup4>=4.12.2
+Requires-Dist: webdriver-manager>=4.0.1
+Requires-Dist: lxml>=4.9.3
+Requires-Dist: urllib3>=2.0.7
+Requires-Dist: certifi>=2023.7.22
+Requires-Dist: tqdm>=4.66.1
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: black>=22.0; extra == "dev"
+Requires-Dist: flake8>=5.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# 🎓 Open Sourse UM PastYear Paper Downloader
+
+**One-click bulk download solution for University Malaya (UM) past year exam papers**
+
+Automate the tedious process of manually downloading past year papers one by one. Simply provide your UM credentials and subject code, and get all available papers in a single organized ZIP file.
+
+[![PyPI version](https://badge.fury.io/py/umpaper-fetch.svg)](https://badge.fury.io/py/umpaper-fetch)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## 🚀 Quick Start (For Regular Users)
+
+### **Installation**
+```bash
+# Install from PyPI
+pip install umpaper-fetch
+
+# Upgrade to latest version
+pip install --upgrade umpaper-fetch
+```
+
+### **Basic Usage**
+```bash
+# Run the downloader
+python -m umpaper_fetch.cli
+
+# Or with command-line shortcut (if available)
+um-papers
+```
+
+### **First Run**
+Follow the interactive prompts:
+1. Enter your UM username (without @siswa.um.edu.my)
+2. Enter your password securely
+3. Enter subject code (e.g., WIA1005)
+4. Choose download location
+5. Confirm download of found papers
+
+---
+
+## ✨ Key Features
+
+### 🚀 **Core Functionality**
+- **🔄 One-Click Bulk Download**: Download all past year papers for any subject code automatically
+- **📦 Smart ZIP Organization**: Automatically organizes papers by year and creates a structured ZIP archive
+- **🔐 Secure Authentication**: Handles complex UM OpenAthens authentication flow seamlessly
+- **⚡ Concurrent Downloads**: Multi-threaded downloading for faster performance
+- **🔄 Auto-Retry Logic**: Robust error handling with configurable retry attempts
+- **📊 Real-time Progress**: Live progress bars and detailed status updates
+
+### 📁 **File Organization**
+- **📂 Hierarchical Structure**: Papers organized by subject → year → semester
+- **🏷️ Smart File Naming**: Automatically detects and preserves meaningful filenames
+- **📋 Auto-Generated README**: Includes download summary and paper inventory in ZIP
+- **🗂️ Organized Output**: Individual PDFs + consolidated ZIP file
+- **🧹 Optional Cleanup**: Choice to keep individual files or ZIP only
+
+### 🖥️ **User Experience**
+- **📱 Terminal-Based Interface**: Clean, intuitive command-line interface
+- **🎯 Interactive Mode**: Prompts for credentials and settings when needed
+- **⚙️ Command-Line Mode**: Full automation with command-line arguments
+- **📍 Custom Download Locations**: Choose where to save your papers
+- **🔍 Browser Options**: Support for Edge, Chrome with auto-detection
+- **📝 Comprehensive Logging**: Detailed logs for troubleshooting
+
+---
+
+## 📋 Complete Command Reference
+
+### **For Regular Users**
+
+#### **Interactive Mode (Recommended for beginners)**
+```bash
+python -m umpaper_fetch.cli
+```
+*Prompts for all required information*
+
+#### **Quick Commands**
+```bash
+# With username and subject code
+python -m umpaper_fetch.cli --username john_doe --subject-code WIA1005
+
+# With custom output directory
+python -m umpaper_fetch.cli -u student123 -s WXES1116 -o "C:/Downloads/Papers"
+
+# Skip location prompt for automation
+python -m umpaper_fetch.cli -s WIA1005 --no-location-prompt
+```
+
+#### **Available Options**
+| Command | Short | Description | Default |
+|---------|-------|-------------|---------|
+| `--username` | `-u` | UM username (without @siswa.um.edu.my) | *prompted* |
+| `--subject-code` | `-s` | Subject code to search for (e.g., WIA1005) | *prompted* |
+| `--output-dir` | `-o` | Custom download directory | `./downloads` |
+| `--browser` | `-b` | Browser choice: `auto`, `chrome`, `edge` | `edge` |
+| `--timeout` | | Session timeout in seconds | `30` |
+| `--max-retries` | | Maximum retry attempts for failed downloads | `3` |
+| `--no-location-prompt` | | Skip interactive location selection | `false` |
+| `--verbose` | `-v` | Enable detailed debug logging | `false` |
+
+### **For Developers & Advanced Users**
+
+#### **Development Installation**
+```bash
+# Clone repository
+git clone https://github.com/MarcusMQF/umpaper-fetch.git
+cd umpaper-fetch
+
+# Install in development mode
+pip install -e .
+
+# Install development dependencies
+pip install -e .[dev]
+```
+
+#### **Debug Commands**
+```bash
+# Show browser window for debugging
+python -m umpaper_fetch.cli --show-browser --verbose --subject-code WIA1005
+
+# High-performance mode with extended timeouts
+python -m umpaper_fetch.cli -s WIA1005 --max-retries 5 --timeout 60
+
+# Force specific browser
+python -m umpaper_fetch.cli --browser chrome --subject-code CSC1025
+```
+
+#### **Developer Options**
+| Command | Description | Use Case |
+|---------|-------------|----------|
+| `--show-browser` | Show browser window (disable headless mode) | Debugging authentication |
+| `--verbose` | Enable detailed debug logging | Troubleshooting issues |
+| `--timeout 60` | Extended session timeout | Slow connections |
+| `--max-retries 5` | More retry attempts | Unstable connections |
+
+---
+
+## 💡 Tips for Best Experience
+
+### **Choose the Right Browser**
+```bash
+# Windows users (recommended)
+python -m umpaper_fetch.cli --browser edge --subject-code WIA1005
+
+# Mac/Linux users
+python -m umpaper_fetch.cli --browser chrome --subject-code WIA1005
+
+# Auto-detect (fallback)
+python -m umpaper_fetch.cli --browser auto --subject-code WIA1005
+```
+
+### **Optimize for Your Connection**
+```bash
+# For slow/unstable connections
+python -m umpaper_fetch.cli --timeout 90 --max-retries 5 --subject-code WIA1005
+
+# For fast connections
+python -m umpaper_fetch.cli --timeout 15 --max-retries 2 --subject-code WIA1005
+```
+
+### **Batch Processing Multiple Subjects**
+```bash
+# Process multiple subjects
+python -m umpaper_fetch.cli -s WIA1005 --no-location-prompt -o "./Papers/WIA1005"
+python -m umpaper_fetch.cli -s WIX1116 --no-location-prompt -o "./Papers/WXES1116"
+python -m umpaper_fetch.cli -s CSC1025 --no-location-prompt -o "./Papers/CSC1025"
+```
+
+### **Automation-Friendly Commands**
+```bash
+# Fully automated (only prompts for password)
+python -m umpaper_fetch.cli -u your_username -s WIA1005 --no-location-prompt -o "./Papers"
+
+# Silent mode with custom browser
+python -m umpaper_fetch.cli -u your-username -s WXES1116 --browser edge --no-location-prompt
+```
+
+---
+
+## 📊 What You Get
+
+### **Organized File Structure**
+```
+📁 downloads/
+├── 📁 WIA1005/
+│   ├── 📁 Year_2023/
+│   │   ├── WIA1005_Final_2023_S1.pdf
+│   │   └── WIA1005_Final_2023_S2.pdf
+│   ├── 📁 Year_2022/
+│   │   ├── WIA1005_Final_2022_S1.pdf
+│   │   └── WIA1005_Final_2022_S2.pdf
+│   └── 📁 Unsorted/
+│       └── WIA1005_Additional_Papers.pdf
+├── 📦 WIA1005_past_years.zip
+└── 📄 WIA1005_README.txt
+```
+
+### **ZIP Archive Contents**
+- **Hierarchical Organization**: Subject → Year → Files
+- **Automatic README**: Download summary and file inventory
+- **Optimized Compression**: Balanced compression for size/speed
+- **Preserve Metadata**: Original filenames and dates maintained
+
+---
+
+## 🔧 Prerequisites & Setup
+
+### **System Requirements**
+- **Python 3.8+** installed
+- **Internet connection** (stable recommended)
+- **UM student account** with active credentials
+- **Browser**: Microsoft Edge (Windows) or Google Chrome (Mac/Linux)
+
+### **Browser Setup**
+- **Windows**: Microsoft Edge (pre-installed, recommended)
+- **Mac/Linux**: Google Chrome (install from google.com/chrome)
+- **Auto-detection**: Tool will find the best available browser
+
+### **Firewall/Network**
+- Tool connects to `exampaper.um.edu.my` via HTTPS
+- No special firewall configuration needed
+- Works on UM campus network and external networks
+
+---
+
+## 🎯 Quick Command Cheat Sheet
+
+### **For Regular Users**
+```bash
+# Install and run
+pip install umpaper-fetch
+python -m umpaper_fetch.cli
+
+# Quick download with subject code
+python -m umpaper_fetch.cli -s WIA1005
+
+# Custom download location
+python -m umpaper_fetch.cli -s WIA1005 -o "C:/MyPapers"
+
+# Batch mode (no prompts except password)
+python -m umpaper_fetch.cli -u your_username -s WIA1005 --no-location-prompt
+```
+
+### **For Developers**
+```bash
+# Development setup
+git clone https://github.com/MarcusMQF/umpaper-fetch.git
+cd umpaper-fetch
+pip install -e .[dev]
+
+# Debug mode
+python -m umpaper_fetch.cli --show-browser --verbose -s WIA1005
+
+# Performance testing
+python -m umpaper_fetch.cli --max-retries 5 --timeout 60 -s WXES1116
+```
+
+---
+
+## 🔒 Security & Privacy
+
+### **What We Do**
+- ✅ Use secure HTTPS connections only
+- ✅ Handle UM authentication through official channels
+- ✅ Clean up browser data after each session
+- ✅ Never store or log passwords
+- ✅ Respect server rate limits
+
+### **What We Don't Do**
+- ❌ Store credentials anywhere
+- ❌ Bypass security measures
+- ❌ Access unauthorized content
+- ❌ Share or transmit personal data
+- ❌ Violate UM terms of service
+
+---
+
+## ⚖️ Legal & Academic Use
+
+**Educational Purpose Only**: This tool is designed for UM students to efficiently access past year papers for their studies. Users must:
+- Have valid UM credentials
+- Comply with UM's terms of service
+- Use papers for academic purposes only
+- Respect copyright and intellectual property rights
+
+**Disclaimer**: This is an unofficial tool not affiliated with University Malaya.
+
+---
+
+## 🤝 Support & Contributing
+
+### **Get Help**
+- 📖 Check this README for common usage patterns
+- 🐛 Report issues on [GitHub Issues](https://github.com/MarcusMQF/umpaper-fetch/issues)
+- 💡 Request features via GitHub Issues
+
+### **Contributing**
+Contributions welcome! Please:
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Make your changes with tests
+4. Submit a pull request
+5. Follow existing code style
+
+### **Development Setup**
+```bash
+git clone https://github.com/MarcusMQF/umpaper-fetch.git
+cd umpaper-fetch
+pip install -e .[dev]
+pytest  # Run tests
+```

umpaper_fetch-1.0.4/README.md

@@ -0,0 +1,314 @@
+# 🎓 Open Sourse UM PastYear Paper Downloader
+
+**One-click bulk download solution for University Malaya (UM) past year exam papers**
+
+Automate the tedious process of manually downloading past year papers one by one. Simply provide your UM credentials and subject code, and get all available papers in a single organized ZIP file.
+
+[![PyPI version](https://badge.fury.io/py/umpaper-fetch.svg)](https://badge.fury.io/py/umpaper-fetch)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## 🚀 Quick Start (For Regular Users)
+
+### **Installation**
+```bash
+# Install from PyPI
+pip install umpaper-fetch
+
+# Upgrade to latest version
+pip install --upgrade umpaper-fetch
+```
+
+### **Basic Usage**
+```bash
+# Run the downloader
+python -m umpaper_fetch.cli
+
+# Or with command-line shortcut (if available)
+um-papers
+```
+
+### **First Run**
+Follow the interactive prompts:
+1. Enter your UM username (without @siswa.um.edu.my)
+2. Enter your password securely
+3. Enter subject code (e.g., WIA1005)
+4. Choose download location
+5. Confirm download of found papers
+
+---
+
+## ✨ Key Features
+
+### 🚀 **Core Functionality**
+- **🔄 One-Click Bulk Download**: Download all past year papers for any subject code automatically
+- **📦 Smart ZIP Organization**: Automatically organizes papers by year and creates a structured ZIP archive
+- **🔐 Secure Authentication**: Handles complex UM OpenAthens authentication flow seamlessly
+- **⚡ Concurrent Downloads**: Multi-threaded downloading for faster performance
+- **🔄 Auto-Retry Logic**: Robust error handling with configurable retry attempts
+- **📊 Real-time Progress**: Live progress bars and detailed status updates
+
+### 📁 **File Organization**
+- **📂 Hierarchical Structure**: Papers organized by subject → year → semester
+- **🏷️ Smart File Naming**: Automatically detects and preserves meaningful filenames
+- **📋 Auto-Generated README**: Includes download summary and paper inventory in ZIP
+- **🗂️ Organized Output**: Individual PDFs + consolidated ZIP file
+- **🧹 Optional Cleanup**: Choice to keep individual files or ZIP only
+
+### 🖥️ **User Experience**
+- **📱 Terminal-Based Interface**: Clean, intuitive command-line interface
+- **🎯 Interactive Mode**: Prompts for credentials and settings when needed
+- **⚙️ Command-Line Mode**: Full automation with command-line arguments
+- **📍 Custom Download Locations**: Choose where to save your papers
+- **🔍 Browser Options**: Support for Edge, Chrome with auto-detection
+- **📝 Comprehensive Logging**: Detailed logs for troubleshooting
+
+---
+
+## 📋 Complete Command Reference
+
+### **For Regular Users**
+
+#### **Interactive Mode (Recommended for beginners)**
+```bash
+python -m umpaper_fetch.cli
+```
+*Prompts for all required information*
+
+#### **Quick Commands**
+```bash
+# With username and subject code
+python -m umpaper_fetch.cli --username john_doe --subject-code WIA1005
+
+# With custom output directory
+python -m umpaper_fetch.cli -u student123 -s WXES1116 -o "C:/Downloads/Papers"
+
+# Skip location prompt for automation
+python -m umpaper_fetch.cli -s WIA1005 --no-location-prompt
+```
+
+#### **Available Options**
+| Command | Short | Description | Default |
+|---------|-------|-------------|---------|
+| `--username` | `-u` | UM username (without @siswa.um.edu.my) | *prompted* |
+| `--subject-code` | `-s` | Subject code to search for (e.g., WIA1005) | *prompted* |
+| `--output-dir` | `-o` | Custom download directory | `./downloads` |
+| `--browser` | `-b` | Browser choice: `auto`, `chrome`, `edge` | `edge` |
+| `--timeout` | | Session timeout in seconds | `30` |
+| `--max-retries` | | Maximum retry attempts for failed downloads | `3` |
+| `--no-location-prompt` | | Skip interactive location selection | `false` |
+| `--verbose` | `-v` | Enable detailed debug logging | `false` |
+
+### **For Developers & Advanced Users**
+
+#### **Development Installation**
+```bash
+# Clone repository
+git clone https://github.com/MarcusMQF/umpaper-fetch.git
+cd umpaper-fetch
+
+# Install in development mode
+pip install -e .
+
+# Install development dependencies
+pip install -e .[dev]
+```
+
+#### **Debug Commands**
+```bash
+# Show browser window for debugging
+python -m umpaper_fetch.cli --show-browser --verbose --subject-code WIA1005
+
+# High-performance mode with extended timeouts
+python -m umpaper_fetch.cli -s WIA1005 --max-retries 5 --timeout 60
+
+# Force specific browser
+python -m umpaper_fetch.cli --browser chrome --subject-code CSC1025
+```
+
+#### **Developer Options**
+| Command | Description | Use Case |
+|---------|-------------|----------|
+| `--show-browser` | Show browser window (disable headless mode) | Debugging authentication |
+| `--verbose` | Enable detailed debug logging | Troubleshooting issues |
+| `--timeout 60` | Extended session timeout | Slow connections |
+| `--max-retries 5` | More retry attempts | Unstable connections |
+
+---
+
+## 💡 Tips for Best Experience
+
+### **Choose the Right Browser**
+```bash
+# Windows users (recommended)
+python -m umpaper_fetch.cli --browser edge --subject-code WIA1005
+
+# Mac/Linux users
+python -m umpaper_fetch.cli --browser chrome --subject-code WIA1005
+
+# Auto-detect (fallback)
+python -m umpaper_fetch.cli --browser auto --subject-code WIA1005
+```
+
+### **Optimize for Your Connection**
+```bash
+# For slow/unstable connections
+python -m umpaper_fetch.cli --timeout 90 --max-retries 5 --subject-code WIA1005
+
+# For fast connections
+python -m umpaper_fetch.cli --timeout 15 --max-retries 2 --subject-code WIA1005
+```
+
+### **Batch Processing Multiple Subjects**
+```bash
+# Process multiple subjects
+python -m umpaper_fetch.cli -s WIA1005 --no-location-prompt -o "./Papers/WIA1005"
+python -m umpaper_fetch.cli -s WIX1116 --no-location-prompt -o "./Papers/WXES1116"
+python -m umpaper_fetch.cli -s CSC1025 --no-location-prompt -o "./Papers/CSC1025"
+```
+
+### **Automation-Friendly Commands**
+```bash
+# Fully automated (only prompts for password)
+python -m umpaper_fetch.cli -u your_username -s WIA1005 --no-location-prompt -o "./Papers"
+
+# Silent mode with custom browser
+python -m umpaper_fetch.cli -u your-username -s WXES1116 --browser edge --no-location-prompt
+```
+
+---
+
+## 📊 What You Get
+
+### **Organized File Structure**
+```
+📁 downloads/
+├── 📁 WIA1005/
+│   ├── 📁 Year_2023/
+│   │   ├── WIA1005_Final_2023_S1.pdf
+│   │   └── WIA1005_Final_2023_S2.pdf
+│   ├── 📁 Year_2022/
+│   │   ├── WIA1005_Final_2022_S1.pdf
+│   │   └── WIA1005_Final_2022_S2.pdf
+│   └── 📁 Unsorted/
+│       └── WIA1005_Additional_Papers.pdf
+├── 📦 WIA1005_past_years.zip
+└── 📄 WIA1005_README.txt
+```
+
+### **ZIP Archive Contents**
+- **Hierarchical Organization**: Subject → Year → Files
+- **Automatic README**: Download summary and file inventory
+- **Optimized Compression**: Balanced compression for size/speed
+- **Preserve Metadata**: Original filenames and dates maintained
+
+---
+
+## 🔧 Prerequisites & Setup
+
+### **System Requirements**
+- **Python 3.8+** installed
+- **Internet connection** (stable recommended)
+- **UM student account** with active credentials
+- **Browser**: Microsoft Edge (Windows) or Google Chrome (Mac/Linux)
+
+### **Browser Setup**
+- **Windows**: Microsoft Edge (pre-installed, recommended)
+- **Mac/Linux**: Google Chrome (install from google.com/chrome)
+- **Auto-detection**: Tool will find the best available browser
+
+### **Firewall/Network**
+- Tool connects to `exampaper.um.edu.my` via HTTPS
+- No special firewall configuration needed
+- Works on UM campus network and external networks
+
+---
+
+## 🎯 Quick Command Cheat Sheet
+
+### **For Regular Users**
+```bash
+# Install and run
+pip install umpaper-fetch
+python -m umpaper_fetch.cli
+
+# Quick download with subject code
+python -m umpaper_fetch.cli -s WIA1005
+
+# Custom download location
+python -m umpaper_fetch.cli -s WIA1005 -o "C:/MyPapers"
+
+# Batch mode (no prompts except password)
+python -m umpaper_fetch.cli -u your_username -s WIA1005 --no-location-prompt
+```
+
+### **For Developers**
+```bash
+# Development setup
+git clone https://github.com/MarcusMQF/umpaper-fetch.git
+cd umpaper-fetch
+pip install -e .[dev]
+
+# Debug mode
+python -m umpaper_fetch.cli --show-browser --verbose -s WIA1005
+
+# Performance testing
+python -m umpaper_fetch.cli --max-retries 5 --timeout 60 -s WXES1116
+```
+
+---
+
+## 🔒 Security & Privacy
+
+### **What We Do**
+- ✅ Use secure HTTPS connections only
+- ✅ Handle UM authentication through official channels
+- ✅ Clean up browser data after each session
+- ✅ Never store or log passwords
+- ✅ Respect server rate limits
+
+### **What We Don't Do**
+- ❌ Store credentials anywhere
+- ❌ Bypass security measures
+- ❌ Access unauthorized content
+- ❌ Share or transmit personal data
+- ❌ Violate UM terms of service
+
+---
+
+## ⚖️ Legal & Academic Use
+
+**Educational Purpose Only**: This tool is designed for UM students to efficiently access past year papers for their studies. Users must:
+- Have valid UM credentials
+- Comply with UM's terms of service
+- Use papers for academic purposes only
+- Respect copyright and intellectual property rights
+
+**Disclaimer**: This is an unofficial tool not affiliated with University Malaya.
+
+---
+
+## 🤝 Support & Contributing
+
+### **Get Help**
+- 📖 Check this README for common usage patterns
+- 🐛 Report issues on [GitHub Issues](https://github.com/MarcusMQF/umpaper-fetch/issues)
+- 💡 Request features via GitHub Issues
+
+### **Contributing**
+Contributions welcome! Please:
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Make your changes with tests
+4. Submit a pull request
+5. Follow existing code style
+
+### **Development Setup**
+```bash
+git clone https://github.com/MarcusMQF/umpaper-fetch.git
+cd umpaper-fetch
+pip install -e .[dev]
+pytest  # Run tests
+```

{umpaper_fetch-1.0.2 → umpaper_fetch-1.0.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "umpaper-fetch"
-version = "1.0.2"
+version = "1.0.4"
 description = "Automated downloader for University Malaya past year exam papers"
 authors = [
     {name = "Marcus Mah", email = "marcusmah6969@gmail.com"}