Release version 1.5.0 - Auto-detect resume drive

Major enhancement: --resume no longer requires device specification.
Tool automatically searches and matches drive by serial number and model.

New Features:
- Auto-detect resume drive by serial number
- Device path independence (drive can change from /dev/sdb to /dev/sdc)
- New find_device_by_serial_model() function
- Backwards compatible (can still specify device manually)

Changes:
- Updated argument parser help text and examples
- Updated all --resume instructions throughout codebase
- Improved user feedback for auto-detection

Tests:
- Added TestAutoDetectResume class with 7 new tests
- Total: 174 tests passing with 97% code coverage

Documentation:
- Updated README.md with auto-detection examples
- Updated CHANGES.md with v1.5.0 release notes
- Updated TESTDESIGN.md with new test coverage

Author: cscortes

DOCS/CHANGES.md

@@ -11,6 +11,41 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.5.0] - 2025-10-19
+
+### Added
+- **Auto-Detect Resume Drive**: Major enhancement to `--resume` functionality
+  - `--resume` no longer requires device specification
+  - Automatically searches all drives and matches by serial number and model
+  - Device path (e.g., `/dev/sdb`) can now change between sessions
+  - New function `find_device_by_serial_model()` searches and matches drives
+  - Maintains backwards compatibility: can still specify device manually
+  - Shows clear feedback about which drive was detected
+  - Provides helpful error messages when no matching drive is found
+
+### Changed
+- **Argument Parser**: Updated help text and examples
+  - Device argument is now optional with `--resume`
+  - Updated help: "Resume previous wipe session (auto-detects drive by serial number)"
+  - Updated examples to show both `wipeit --resume` and `wipeit --resume /dev/sdb`
+
+### Improved
+- **User Messages**: Updated all `--resume` instructions throughout the codebase
+  - KeyboardInterrupt message now shows auto-detection info
+  - Device mismatch errors reference auto-detection
+  - Resume prompts clarify no device specification needed
+
+### Tests
+- **Comprehensive Test Coverage**: Added 7 new tests in `TestAutoDetectResume` class
+  - `test_find_device_by_serial_model_found()` - Successful auto-detection
+  - `test_find_device_by_serial_model_not_found()` - No matching device
+  - `test_find_device_by_serial_model_no_progress_file()` - Missing progress file
+  - `test_find_device_by_serial_model_no_serial_in_progress()` - Missing serial
+  - `test_setup_argument_parser_resume_without_device()` - Parser validation
+  - `test_main_resume_without_device_auto_detects()` - Integration test
+  - `test_main_resume_without_device_no_match()` - Error handling
+  - All 174 tests passing with 97% code coverage
+
 ## [1.4.4] - 2025-10-13
 
 ### Fixed

DOCS/TESTDESIGN.md

@@ -499,9 +499,9 @@ jobs:
 
 ## Test Statistics
 
-### Current Test Coverage (v1.2.0+)
-- **Total Test Classes**: 10
-- **Total Test Cases**: 75
+### Current Test Coverage (v1.5.0+)
+- **Total Test Classes**: 11
+- **Total Test Cases**: 82
 - **Test Coverage Breakdown**:
   - `TestParseSize`: 5 tests
   - `TestProgressFileFunctions`: 7 tests
@@ -513,6 +513,7 @@ jobs:
   - `TestWipeDeviceIntegration`: 2 tests (Added in 0.3.1)
   - `TestMountChecking`: 6 tests (Added in 1.1.0)
   - `TestDeviceDetector`: 35 tests (Added in 1.1.0+)
+  - `TestAutoDetectResume`: 7 tests (Added in 1.5.0)
 
 ### DeviceDetector Test Coverage
 The new `TestDeviceDetector` class provides comprehensive coverage of the object-oriented device detection functionality:
@@ -566,6 +567,23 @@ This test design document provides comprehensive coverage for all wipeit feature
 - Added comprehensive test coverage for HDD pretest functionality
 - Added critical bug test for float-to-integer conversion in adaptive chunk sizing
 - Increased test count from 34 to 40 tests
+### TestAutoDetectResume Test Coverage (v1.5.0)
+The new `TestAutoDetectResume` class provides comprehensive coverage of the auto-detection resume functionality:
+
+#### **Core Function Tests**
+- `test_find_device_by_serial_model_found()` - Successful device auto-detection by serial and model
+- `test_find_device_by_serial_model_not_found()` - No matching device scenario
+- `test_find_device_by_serial_model_no_progress_file()` - Missing progress file handling
+- `test_find_device_by_serial_model_no_serial_in_progress()` - Progress file without serial number
+
+#### **Integration Tests**
+- `test_setup_argument_parser_resume_without_device()` - Argument parser validation
+- `test_main_resume_without_device_auto_detects()` - Full integration with main()
+- `test_main_resume_without_device_no_match()` - Error handling when no match found
+
+### Recent Additions
+- **Added auto-detect resume test coverage (7 new tests)** (v1.5.0)
+- **Increased total test count from 75 to 82 tests** (v1.5.0)
 - Added comprehensive mount checking test coverage (6 new tests)
 - **Added comprehensive DeviceDetector class test coverage (35 new tests)**
 - **Increased total test count from 40 to 75 tests**

README.md

@@ -72,7 +72,7 @@ A secure device wiping utility that overwrites block devices with random data.
 ### Configuration Options
 - **Buffer Size**: Configurable from 1MB to 1TB (default: 100MB)
 - **Skip Pretest**: Option to bypass HDD pretest for faster start
-- **Resume Flag**: Explicit --resume option for continuing interrupted wipes
+- **Resume Flag**: Auto-detects drive by serial number for seamless resume
 - **List Devices**: Dedicated --list option for device enumeration
 
 ### Technical Features
@@ -143,9 +143,10 @@ Found pending wipe operations:
    Written: 1.00 GB / 4.00 GB
    Buffer size: 100 MB
    Started: Thu Oct  9 18:04:00 2025
-   Resume command: sudo ./wipeit.py --resume /dev/sdb
+   Resume command: sudo ./wipeit.py --resume
 
-NOTE: To resume any operation, use: sudo ./wipeit.py --resume <device>
+NOTE: To resume any operation, simply run: sudo ./wipeit.py --resume
+NOTE: The tool will automatically find the correct drive by serial number
 NOTE: To start fresh, the progress file will be overwritten
 ==================================================
 
@@ -334,20 +335,32 @@ Progress: 15.42% | Written: 19.74 GB | Speed: 82.15 MB/s | ETA: 17.23 min
 ^C
 Wipe interrupted at 19.74 GB (15.42% complete)
 Progress saved. To resume, run:
-  sudo ./wipeit.py --resume /dev/sdb
+  sudo ./wipeit.py --resume
 ```
 
+The tool will automatically find the correct drive by matching the serial number from the progress file.
+
 #### Resume an interrupted wipe
 
 To continue from where you left off:
 
 ```bash
-sudo ./wipeit.py --resume /dev/sdb
+sudo ./wipeit.py --resume
 ```
 
+The tool will automatically find the correct drive by matching the serial number from the progress file.
+
 **Example resume session with HDD and pretest results:**
 ```bash
-$ sudo ./wipeit.py --resume /dev/sdb
+$ sudo ./wipeit.py --resume
+
+======================================================================
+AUTO-DETECTING RESUME DRIVE
+======================================================================
+✓ Found matching drive: /dev/sdb
+  Serial: WD-WMAYUA1234567
+  Model: Hitachi_HTS545032B9A300
+  Size: 128.00 GB
 
 Detected disk type: HDD (confidence: HIGH)
    Detection details: Rotational device
@@ -373,7 +386,15 @@ Progress: 16.12% | Written: 20.64 GB | Speed: 85.32 MB/s | ETA: 16.45 min | Buff
 
 **Example resume session without pretest results:**
 ```bash
-$ sudo ./wipeit.py --resume /dev/sdb
+$ sudo ./wipeit.py --resume
+
+======================================================================
+AUTO-DETECTING RESUME DRIVE
+======================================================================
+✓ Found matching drive: /dev/sdb
+  Serial: WD-WMAYUA1234567
+  Model: Hitachi_HTS545032B9A300
+  Size: 128.00 GB
 
 Detected disk type: HDD (confidence: HIGH)
    Detection details: Rotational device
@@ -435,7 +456,7 @@ $ sudo ./wipeit.py /dev/sdb
    Started: Wed Oct  1 18:30:45 2025
 
 Options:
-   1. Resume previous session: sudo ./wipeit.py --resume /dev/sdb
+   1. Resume previous session: sudo ./wipeit.py --resume
    2. Start fresh (will overwrite previous progress)
 
 Start fresh wipe? (y/n): n
@@ -576,9 +597,11 @@ sudo wipeit --buffer-size 2G /dev/sdd
 
 ### 4. Resume an interrupted wipe
 ```bash
-sudo ./wipeit.py --resume /dev/sdb
+sudo ./wipeit.py --resume
 ```
 
+The tool will automatically find the correct drive by matching the serial number from the progress file.
+
 ### 5. Check what devices are available
 ```bash
 sudo wipeit

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "wipeit"
-version = "1.4.4"
+version = "1.5.0"
 description = "A secure device wiping utility that overwrites block devices with random data"
 authors = [
     {name = "Luis Cortes", email = "mrluiscortes@gmail.com"}