Skip to content

Building 70 Projects ranging from beginner to advanced so anyone can โ€” learn from, build upon, use as a reference, or even copy directly. Owned by my cybersecurity company ๐Ÿ‘‡

Add 'PROJECTS/metadata-scrubber-tool/' from commit '250a648855780c5f1a9268f9cffef4c65f82cbbc'

HERITAGE-XION38aa333d3d93
diff --cc PROJECTS/metadata-scrubber-tool/.github/workflows/publish.yml
index 00000000,3359f907..3359f907
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/.github/workflows/publish.yml
+++ b/PROJECTS/metadata-scrubber-tool/.github/workflows/publish.yml
diff --cc PROJECTS/metadata-scrubber-tool/.github/workflows/test.yml
index 00000000,f882d808..f882d808
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/.github/workflows/test.yml
+++ b/PROJECTS/metadata-scrubber-tool/.github/workflows/test.yml
diff --cc PROJECTS/metadata-scrubber-tool/.gitignore
index 00000000,00000000..8b24a52f
new file mode 100644
--- /dev/null
+++ b/PROJECTS/metadata-scrubber-tool/.gitignore
@@@ -1,0 -1,0 +1,52 @@@
++# ============== Python ==============
++__pycache__/
++*.py[cod]
++*$py.class
++*.so
++.Python
++*.egg-info/
++*.egg
++dist/
++build/
++
++# ============== Virtual Environment ==============
++.venv/
++venv/
++ENV/
++
++# ============== IDE / Editor ==============
++.vscode/
++.idea/
++*.swp
++*.swo
++.qodo/
++
++# ============== Testing ==============
++.pytest_cache/
++.coverage
++htmlcov/
++coverage.xml
++*.cover
++
++# ============== Type Checking ==============
++.mypy_cache/
++.pyright/
++
++# ============== Linting ==============
++.ruff_cache/
++
++# ============== Environment ==============
++.env
++.env.local
++*.log
++
++# ============== OS Generated ==============
++.DS_Store
++Thumbs.db
++
++# ============== Project Specific ==============
++# Output directory for processed images
++tests/assets/output/
++
++
++.yapfignore/
diff --cc PROJECTS/metadata-scrubber-tool/.python-version
index 00000000,6324d401..6324d401
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/.python-version
+++ b/PROJECTS/metadata-scrubber-tool/.python-version
diff --cc PROJECTS/metadata-scrubber-tool/.style.yapf
index 00000000,00000000..8abdade4
new file mode 100644
--- /dev/null
+++ b/PROJECTS/metadata-scrubber-tool/.style.yapf
@@@ -1,0 -1,0 +1,47 @@@
++# โ’ธAngelaMos | 2025 | CarterPerez-dev
++[style]
++based_on_style = pep8
++column_limit = 89
++indent_width = 4
++continuation_indent_width = 4
++indent_closing_brackets = false
++dedent_closing_brackets = true
++indent_blank_lines = false
++spaces_before_comment = 2
++spaces_around_power_operator = false
++spaces_around_default_or_named_assign = true
++space_between_ending_comma_and_closing_bracket = false
++space_inside_brackets = false
++spaces_around_subscript_colon = true
++blank_line_before_nested_class_or_def = false
++blank_line_before_class_docstring = false
++blank_lines_around_top_level_definition = 2
++blank_lines_between_top_level_imports_and_variables = 2
++blank_line_before_module_docstring = false
++split_before_logical_operator = true
++split_before_first_argument = true
++split_before_named_assigns = true
++split_complex_comprehension = true
++split_before_expression_after_opening_paren = false
++split_before_closing_bracket = true
++split_all_comma_separated_values = true
++split_all_top_level_comma_separated_values = false
++coalesce_brackets = false
++each_dict_entry_on_separate_line = true
++allow_multiline_lambdas = false
++allow_multiline_dictionary_keys = false
++split_penalty_import_names = 0
++join_multiple_lines = false
++align_closing_bracket_with_visual_indent = true
++arithmetic_precedence_indication = false
++split_penalty_for_added_line_split = 275
++use_tabs = false
++split_before_dot = false
++split_arguments_when_comma_terminated = true
++i18n_function_call = ['_', 'N_', 'gettext', 'ngettext']
++i18n_comment = ['# Translators:', '# i18n:']
++split_penalty_comprehension = 80
++split_penalty_after_opening_bracket = 280
++split_penalty_before_if_expr = 0
++split_penalty_bitwise_operator = 290
++split_penalty_logical_operator = 0
diff --cc PROJECTS/metadata-scrubber-tool/.yapfignore
index 00000000,b39b8d26..b39b8d26
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/.yapfignore
+++ b/PROJECTS/metadata-scrubber-tool/.yapfignore
diff --cc PROJECTS/metadata-scrubber-tool/LICENSE
index 00000000,00000000..d1a703c6
new file mode 100644
--- /dev/null
+++ b/PROJECTS/metadata-scrubber-tool/LICENSE
@@@ -1,0 -1,0 +1,21 @@@
++MIT License
++
++Copyright (c) 2026 HERITAGE-XION
++
++Permission is hereby granted, free of charge, to any person obtaining a copy
++of this software and associated documentation files (the "Software"), to deal
++in the Software without restriction, including without limitation the rights
++to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
++copies of the Software, and to permit persons to whom the Software is
++furnished to do so, subject to the following conditions:
++
++The above copyright notice and this permission notice shall be included in all
++copies or substantial portions of the Software.
++
++THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
++IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
++FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
++AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
++LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
++OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
++SOFTWARE.
diff --cc PROJECTS/metadata-scrubber-tool/README.md
index 00000000,00000000..af357d82
new file mode 100644
--- /dev/null
+++ b/PROJECTS/metadata-scrubber-tool/README.md
@@@ -1,0 -1,0 +1,256 @@@
++# ๐Ÿ”’ Metadata Scrubber
++
++A privacy-focused CLI tool that removes sensitive metadata from files. Supports images, PDFs, and Microsoft Office documents. Perfect for protecting your privacy before sharing files online.
++
++[![Tests](https://github.com/Heritage-XioN/metadata-scrubber-tool/actions/workflows/test.yml/badge.svg)](https://github.com/Heritage-XioN/metadata-scrubber-tool/actions)
++[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://python.org)
++[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
++
++## โœจ Features
++
++- **Multi-format support** - Images (JPEG, PNG), PDFs, and Office docs (Word, Excel, PowerPoint)
++- **Concurrent processing** - Process 1000+ files efficiently with ThreadPoolExecutor
++- **Dry-run mode** - Preview what would be scrubbed without making changes
++- **Verification reports** - Before/after comparison to confirm removal
++- **Smart format detection** - Uses library-level format detection, not just file extensions
++- **Beautiful CLI** - Rich progress bars and formatted output
++- **Privacy-first** - Removes GPS coordinates, author info, timestamps, camera data
++
++## ๐Ÿ“ Supported Formats
++
++| Category | Extensions | Metadata Removed |
++|----------|------------|------------------|
++| **Images** | `.jpg`, `.jpeg`, `.png` | EXIF, GPS, camera info, timestamps |
++| **PDF** | `.pdf` | Author, creator, producer, dates |
++| **Word** | `.docx` | Author, title, comments, keywords |
++| **Excel** | `.xlsx`, `.xlsm`, `.xltx`, `.xltm` | Author, title, company, comments |
++| **PowerPoint** | `.pptx`, `.pptm`, `.potx`, `.potm` | Author, title, comments, keywords |
++
++## ๐Ÿš€ Quick Start
++
++### Installation
++
++```bash
++# Using uv (recommended)
++uv pip install metadata-scrubber
++
++# Or clone and install locally
++git clone https://github.com/Heritage-XioN/metadata-scrubber-tool.git
++cd metadata-scrubber-tool
++uv sync
++```
++
++### Basic Usage
++
++```bash
++# Read metadata from a file
++mst read document.pdf
++
++# Scrub metadata and save to output folder
++mst scrub photo.jpg --output ./cleaned
++
++# Batch process entire folder
++mst scrub ./documents -r -ext docx --output ./cleaned
++
++# Verify removal
++mst verify original.jpg ./cleaned/processed_original.jpg
++```
++
++## ๐Ÿ“– Commands
++
++### `mst read` - View Metadata
++
++Extract and display all embedded metadata from a file.
++
++```bash
++mst read photo.jpg # Single file
++mst read report.pdf # PDF file
++mst read ./docs -r -ext docx # All Word docs recursively
++```
++
++**Example output:**
++```
++โ•ญโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ Metadata Report โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ
++โ”‚ โ•ญโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ โ”‚
++โ”‚ โ”‚ Property โ”‚ Value โ”‚ โ”‚
++โ”‚ โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค โ”‚
++โ”‚ โ”‚ ๐Ÿ“ท Camera โ”‚ โ”‚ โ”‚
++โ”‚ โ”‚ Make โ”‚ Canon โ”‚ โ”‚
++โ”‚ โ”‚ Model โ”‚ Canon EOS 80D โ”‚ โ”‚
++โ”‚ โ”‚ Software โ”‚ Adobe Photoshop โ”‚ โ”‚
++โ”‚ โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค โ”‚
++โ”‚ โ”‚ ๐Ÿ“ GPS โ”‚ โ”‚ โ”‚
++โ”‚ โ”‚ GPSLatitude โ”‚ 40.7128 โ”‚ โ”‚
++โ”‚ โ”‚ GPSLongitude โ”‚ -74.0060 โ”‚ โ”‚
++โ”‚ โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค โ”‚
++โ”‚ โ”‚ ๐Ÿ“… Dates โ”‚ โ”‚ โ”‚
++โ”‚ โ”‚ DateTimeOriginal โ”‚ 2024:01:15 14:30:00 โ”‚ โ”‚
++โ”‚ โ”‚ created โ”‚ 2024-01-15 14:30:00 โ”‚ โ”‚
++โ”‚ โ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ โ”‚
++โ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ
++```
++
++---
++
++### `mst scrub` - Remove Metadata
++
++Remove sensitive metadata from files and save cleaned copies.
++
++```bash
++mst scrub photo.jpg --output ./out # Single file
++mst scrub ./photos -r -ext jpg -o ./out # All JPEGs in directory
++mst scrub ./docs -r -ext pdf --dry-run # Preview without changes
++mst scrub ./files -r -ext xlsx -w 8 # 8 concurrent workers
++```
++
++**Example output:**
++```
++Processing 42 files with 4 workers...
++
++โ ธ Scrubbing metadata... โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ” 100% 42/42 0:00:12
++
++โ•ญโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ Summary โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ
++โ”‚ โœ… Processed: 42 โ”‚
++โ”‚ โŒ Failed: 0 โ”‚
++โ”‚ ๐Ÿ“ Output: C:\Users\...\cleaned โ”‚
++โ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ
++```
++
++**Dry-run example:**
++```bash
++mst scrub ./photos -r -ext jpg --dry-run
++```
++```
++๐Ÿ” DRY-RUN MODE - No files will be modified
++
++Would process 15 files:
++ โ€ข photo1.jpg โ†’ processed_photo1.jpg
++ โ€ข photo2.jpg โ†’ processed_photo2.jpg
++ โ€ข vacation/beach.jpg โ†’ processed_beach.jpg
++ ...
++```
++
++---
++
++### `mst verify` - Verify Metadata Removal
++
++Compare original and processed files to confirm sensitive data was removed.
++
++```bash
++mst verify original.jpg ./out/processed_original.jpg
++```
++
++**Example output:**
++```
++Comparing: test_canon.jpg โ†’ processed_test_canon.jpg
++
++ Verification Report
++โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ณโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ณโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”“
++โ”ƒ Property โ”ƒ Before โ”ƒ After โ”ƒ
++โ”กโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ•‡โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ•‡โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ฉ
++โ”‚ Make โ”‚ Canon โ”‚ โœ… Removed โ”‚
++โ”‚ Model โ”‚ Canon EOS 80D โ”‚ โœ… Removed โ”‚
++โ”‚ Software โ”‚ Adobe Photoshop โ”‚ โœ… Removed โ”‚
++โ”‚ GPSLatitude โ”‚ 40.7128 โ”‚ โœ… Removed โ”‚
++โ”‚ GPSLongitude โ”‚ -74.0060 โ”‚ โœ… Removed โ”‚
++โ”‚ Artist โ”‚ John Smith โ”‚ โœ… Removed โ”‚
++โ”‚ Copyright โ”‚ ยฉ 2024 John Smith โ”‚ โœ… Removed โ”‚
++โ”‚ DateTimeOriginal โ”‚ 2024:01:15 14:30:00 โ”‚ โšช Preserved โ”‚
++โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
++
++โœ… Status: CLEAN - All sensitive metadata removed
++Removed: 38 | Preserved: 2
++```
++
++---
++
++## โš™๏ธ CLI Options
++
++| Option | Description |
++|--------|-------------|
++| `-r`, `--recursive` | Process directories recursively |
++| `-ext`, `--extension` | Filter by file extension (jpg, png, pdf, docx, xlsx, pptx) |
++| `-o`, `--output` | Output directory for cleaned files |
++| `-d`, `--dry-run` | Preview without making changes |
++| `-w`, `--workers` | Number of concurrent workers (default: 4, max: 16) |
++| `-V`, `--verbose` | Show detailed debug logs |
++| `-v`, `--version` | Show version |
++
++---
++
++## ๐Ÿ› ๏ธ Development
++
++### Setup
++
++```bash
++git clone https://github.com/Heritage-XioN/metadata-scrubber-tool.git
++cd metadata-scrubber-tool
++
++# Install with dev dependencies
++uv sync --all-extras
++
++# Run tests
++pytest
++
++# Run linting
++ruff check .
++
++# Run type checking
++mypy src
++```
++
++### Project Structure
++
++```
++src/
++โ”œโ”€โ”€ main.py # CLI entry point (Typer app)
++โ”œโ”€โ”€ commands/
++โ”‚ โ”œโ”€โ”€ read.py # Read metadata command
++โ”‚ โ”œโ”€โ”€ scrub.py # Scrub metadata command
++โ”‚ โ””โ”€โ”€ verify.py # Verify removal command
++โ”œโ”€โ”€ services/
++โ”‚ โ”œโ”€โ”€ metadata_factory.py # Factory for creating handlers
++โ”‚ โ”œโ”€โ”€ metadata_handler.py # Abstract base class
++โ”‚ โ”œโ”€โ”€ image_handler.py # JPEG/PNG handler
++โ”‚ โ”œโ”€โ”€ pdf_handler.py # PDF handler
++โ”‚ โ”œโ”€โ”€ excel_handler.py # Excel handler
++โ”‚ โ”œโ”€โ”€ powerpoint_handler.py # PowerPoint handler
++โ”‚ โ”œโ”€โ”€ worddoc_handler.py # Word document handler
++โ”‚ โ”œโ”€โ”€ report_generator.py # Verification reports
++โ”‚ โ””โ”€โ”€ batch_processor.py # Concurrent batch processing
++โ””โ”€โ”€ core/
++ โ”œโ”€โ”€ jpeg_metadata.py # JPEG EXIF processor
++ โ””โ”€โ”€ png_metadata.py # PNG metadata processor
++
++docs/
++โ”œโ”€โ”€ metadata-risks.md # Privacy risks documentation
++โ””โ”€โ”€ best-practices.md # Secure file sharing guide
++```
++
++---
++
++## ๐Ÿ“š Documentation
++
++- **[Metadata Risks](docs/metadata-risks.md)** - Why metadata matters for privacy
++- **[Best Practices](docs/best-practices.md)** - Guidelines for secure file sharing
++
++---
++
++## โš ๏ธ Security Considerations
++
++- **Original files are never modified** - processed copies are created
++- **Use `--dry-run`** to preview changes before committing
++- **Use `mst verify`** to confirm sensitive data was removed
++- **GPS coordinates** are completely stripped for privacy
++- **Author information** is removed from all supported formats
++- **Always backup files** before scrubbing in production
++
++---
++
++## ๐Ÿ“„ License
++
++MIT License - See [LICENSE](LICENSE) for details.
++
++---
++
++Made with โค๏ธ for privacy
diff --cc PROJECTS/metadata-scrubber-tool/docker-compose.yml
index 00000000,c38bf62a..c38bf62a
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/docker-compose.yml
+++ b/PROJECTS/metadata-scrubber-tool/docker-compose.yml
diff --cc PROJECTS/metadata-scrubber-tool/docs/best-practices.md
index 00000000,c3c46cc0..c3c46cc0
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/docs/best-practices.md
+++ b/PROJECTS/metadata-scrubber-tool/docs/best-practices.md
diff --cc PROJECTS/metadata-scrubber-tool/docs/metadata-risks.md
index 00000000,b0406ec7..b0406ec7
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/docs/metadata-risks.md
+++ b/PROJECTS/metadata-scrubber-tool/docs/metadata-risks.md
diff --cc PROJECTS/metadata-scrubber-tool/main.py
index 00000000,72921b84..72921b84
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/main.py
+++ b/PROJECTS/metadata-scrubber-tool/main.py
diff --cc PROJECTS/metadata-scrubber-tool/pyproject.toml
index 00000000,0451e2ed..0451e2ed
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/pyproject.toml
+++ b/PROJECTS/metadata-scrubber-tool/pyproject.toml
diff --cc PROJECTS/metadata-scrubber-tool/pyrightconfig.json
index 00000000,848796cb..848796cb
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/pyrightconfig.json
+++ b/PROJECTS/metadata-scrubber-tool/pyrightconfig.json
diff --cc PROJECTS/metadata-scrubber-tool/requirements.txt
index 00000000,23f28d13..23f28d13
mode 000000,100644..100644
Binary files differ
diff --cc PROJECTS/metadata-scrubber-tool/scripts/generate_png_tests.py
index 00000000,7cab3219..7cab3219
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/scripts/generate_png_tests.py
+++ b/PROJECTS/metadata-scrubber-tool/scripts/generate_png_tests.py
diff --cc PROJECTS/metadata-scrubber-tool/src/__init__.py
index 00000000,00000000..e69de29b
new file mode 100644
--- /dev/null
+++ b/PROJECTS/metadata-scrubber-tool/src/__init__.py
diff --cc PROJECTS/metadata-scrubber-tool/src/__pycache__/__init__.cpython-314.pyc
index 00000000,39691a0e..39691a0e
mode 000000,100644..100644
Binary files differ
diff --cc PROJECTS/metadata-scrubber-tool/src/commands/__init__.py
index 00000000,fef0be3c..fef0be3c
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/src/commands/__init__.py
+++ b/PROJECTS/metadata-scrubber-tool/src/commands/__init__.py
diff --cc PROJECTS/metadata-scrubber-tool/src/commands/read.py
index 00000000,c827b0da..c827b0da
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/src/commands/read.py
+++ b/PROJECTS/metadata-scrubber-tool/src/commands/read.py
diff --cc PROJECTS/metadata-scrubber-tool/src/commands/scrub.py
index 00000000,ef6f3b1c..ef6f3b1c
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/src/commands/scrub.py
+++ b/PROJECTS/metadata-scrubber-tool/src/commands/scrub.py
diff --cc PROJECTS/metadata-scrubber-tool/src/commands/verify.py
index 00000000,2b40810f..2b40810f
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/src/commands/verify.py
+++ b/PROJECTS/metadata-scrubber-tool/src/commands/verify.py
diff --cc PROJECTS/metadata-scrubber-tool/src/core/jpeg_metadata.py
index 00000000,3fe680b0..3fe680b0
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/src/core/jpeg_metadata.py
+++ b/PROJECTS/metadata-scrubber-tool/src/core/jpeg_metadata.py
diff --cc PROJECTS/metadata-scrubber-tool/src/core/png_metadata.py
index 00000000,f970a28a..f970a28a
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/src/core/png_metadata.py
+++ b/PROJECTS/metadata-scrubber-tool/src/core/png_metadata.py
diff --cc PROJECTS/metadata-scrubber-tool/src/main.py
index 00000000,7780b582..7780b582
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/src/main.py
+++ b/PROJECTS/metadata-scrubber-tool/src/main.py
diff --cc PROJECTS/metadata-scrubber-tool/src/services/batch_processor.py
index 00000000,b7bee94a..b7bee94a
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/src/services/batch_processor.py
+++ b/PROJECTS/metadata-scrubber-tool/src/services/batch_processor.py
diff --cc PROJECTS/metadata-scrubber-tool/src/services/excel_handler.py
index 00000000,59501f47..59501f47
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/src/services/excel_handler.py
+++ b/PROJECTS/metadata-scrubber-tool/src/services/excel_handler.py
diff --cc PROJECTS/metadata-scrubber-tool/src/services/image_handler.py
index 00000000,13ee901d..13ee901d
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/src/services/image_handler.py
+++ b/PROJECTS/metadata-scrubber-tool/src/services/image_handler.py
diff --cc PROJECTS/metadata-scrubber-tool/src/services/metadata_factory.py
index 00000000,91c45f7d..91c45f7d
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/src/services/metadata_factory.py
+++ b/PROJECTS/metadata-scrubber-tool/src/services/metadata_factory.py
diff --cc PROJECTS/metadata-scrubber-tool/src/services/metadata_handler.py
index 00000000,1b45400d..1b45400d
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/src/services/metadata_handler.py
+++ b/PROJECTS/metadata-scrubber-tool/src/services/metadata_handler.py
diff --cc PROJECTS/metadata-scrubber-tool/src/services/pdf_handler.py
index 00000000,f08dc2b8..f08dc2b8
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/src/services/pdf_handler.py
+++ b/PROJECTS/metadata-scrubber-tool/src/services/pdf_handler.py
diff --cc PROJECTS/metadata-scrubber-tool/src/services/powerpoint_handler.py
index 00000000,7277431a..7277431a
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/src/services/powerpoint_handler.py
+++ b/PROJECTS/metadata-scrubber-tool/src/services/powerpoint_handler.py
diff --cc PROJECTS/metadata-scrubber-tool/src/services/report_generator.py
index 00000000,6525f225..6525f225
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/src/services/report_generator.py
+++ b/PROJECTS/metadata-scrubber-tool/src/services/report_generator.py
diff --cc PROJECTS/metadata-scrubber-tool/src/services/worddoc_handler.py
index 00000000,5a60c5a5..5a60c5a5
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/src/services/worddoc_handler.py
+++ b/PROJECTS/metadata-scrubber-tool/src/services/worddoc_handler.py
diff --cc PROJECTS/metadata-scrubber-tool/src/utils/__init__.py
index 00000000,00000000..e69de29b
new file mode 100644
--- /dev/null
+++ b/PROJECTS/metadata-scrubber-tool/src/utils/__init__.py
diff --cc PROJECTS/metadata-scrubber-tool/src/utils/display.py
index 00000000,04ea030b..04ea030b
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/src/utils/display.py
+++ b/PROJECTS/metadata-scrubber-tool/src/utils/display.py
diff --cc PROJECTS/metadata-scrubber-tool/src/utils/exceptions.py
index 00000000,9d6484b6..9d6484b6
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/src/utils/exceptions.py
+++ b/PROJECTS/metadata-scrubber-tool/src/utils/exceptions.py
diff --cc PROJECTS/metadata-scrubber-tool/src/utils/formatter.py
index 00000000,be2544c6..be2544c6
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/src/utils/formatter.py
+++ b/PROJECTS/metadata-scrubber-tool/src/utils/formatter.py
diff --cc PROJECTS/metadata-scrubber-tool/src/utils/get_target_files.py
index 00000000,43ac4132..43ac4132
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/src/utils/get_target_files.py
+++ b/PROJECTS/metadata-scrubber-tool/src/utils/get_target_files.py
diff --cc PROJECTS/metadata-scrubber-tool/src/utils/logger.py
index 00000000,46487e94..46487e94
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/src/utils/logger.py
+++ b/PROJECTS/metadata-scrubber-tool/src/utils/logger.py
diff --cc PROJECTS/metadata-scrubber-tool/tests/__init__.py
index 00000000,00000000..e69de29b
new file mode 100644
--- /dev/null
+++ b/PROJECTS/metadata-scrubber-tool/tests/__init__.py
diff --cc PROJECTS/metadata-scrubber-tool/tests/assets/test_docx/file-sample_1MB.docx
index 00000000,b36cfed5..b36cfed5
mode 000000,100644..100644
Binary files differ
diff --cc PROJECTS/metadata-scrubber-tool/tests/assets/test_docx/file-sample_500kB.docx
index 00000000,d168926e..d168926e
mode 000000,100644..100644
Binary files differ
diff --cc PROJECTS/metadata-scrubber-tool/tests/assets/test_images/generated_test_03.png
index 00000000,55c0f9bb..55c0f9bb
mode 000000,100644..100644
Binary files differ
diff --cc PROJECTS/metadata-scrubber-tool/tests/assets/test_images/generated_test_04.png
index 00000000,2c9fe767..2c9fe767
mode 000000,100644..100644
Binary files differ
diff --cc PROJECTS/metadata-scrubber-tool/tests/assets/test_images/generated_test_05.png
index 00000000,3a870f81..3a870f81
mode 000000,100644..100644
Binary files differ
diff --cc PROJECTS/metadata-scrubber-tool/tests/assets/test_images/test_canon.jpg
index 00000000,6eb33f12..6eb33f12
mode 000000,100644..100644
Binary files differ
diff --cc PROJECTS/metadata-scrubber-tool/tests/assets/test_images/test_fuji.jpg
index 00000000,8cf1e5ca..8cf1e5ca
mode 000000,100644..100644
Binary files differ
diff --cc PROJECTS/metadata-scrubber-tool/tests/assets/test_pdfs/file-example_PDF_1MB.pdf
index 00000000,13ce5749..13ce5749
mode 000000,100644..100644
Binary files differ
diff --cc PROJECTS/metadata-scrubber-tool/tests/assets/test_pdfs/sample.pdf
index 00000000,c01805e8..c01805e8
mode 000000,100644..100644
Binary files differ
diff --cc PROJECTS/metadata-scrubber-tool/tests/assets/test_pptx/Extlst-test.pptx
index 00000000,e94b88ab..e94b88ab
mode 000000,100644..100644
Binary files differ
diff --cc PROJECTS/metadata-scrubber-tool/tests/assets/test_pptx/sample3.pptx
index 00000000,c970c944..c970c944
mode 000000,100644..100644
Binary files differ
diff --cc PROJECTS/metadata-scrubber-tool/tests/assets/test_xlsx/file_example_XLSX_1000.xlsx
index 00000000,e933f724..e933f724
mode 000000,100644..100644
Binary files differ
diff --cc PROJECTS/metadata-scrubber-tool/tests/assets/test_xlsx/file_example_XLSX_5000.xlsx
index 00000000,e79d0802..e79d0802
mode 000000,100644..100644
Binary files differ
diff --cc PROJECTS/metadata-scrubber-tool/tests/conftest.py
index 00000000,1c48f41c..1c48f41c
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/tests/conftest.py
+++ b/PROJECTS/metadata-scrubber-tool/tests/conftest.py
diff --cc PROJECTS/metadata-scrubber-tool/tests/e2e/__init__.py
index 00000000,00000000..e69de29b
new file mode 100644
--- /dev/null
+++ b/PROJECTS/metadata-scrubber-tool/tests/e2e/__init__.py
diff --cc PROJECTS/metadata-scrubber-tool/tests/e2e/test_main.py
index 00000000,bf705910..bf705910
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/tests/e2e/test_main.py
+++ b/PROJECTS/metadata-scrubber-tool/tests/e2e/test_main.py
diff --cc PROJECTS/metadata-scrubber-tool/tests/e2e/test_read_command.py
index 00000000,bc4cb48a..bc4cb48a
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/tests/e2e/test_read_command.py
+++ b/PROJECTS/metadata-scrubber-tool/tests/e2e/test_read_command.py
diff --cc PROJECTS/metadata-scrubber-tool/tests/e2e/test_scrub_command.py
index 00000000,d9e77734..d9e77734
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/tests/e2e/test_scrub_command.py
+++ b/PROJECTS/metadata-scrubber-tool/tests/e2e/test_scrub_command.py
diff --cc PROJECTS/metadata-scrubber-tool/tests/e2e/test_verify_command.py
index 00000000,0d9592ac..0d9592ac
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/tests/e2e/test_verify_command.py
+++ b/PROJECTS/metadata-scrubber-tool/tests/e2e/test_verify_command.py
diff --cc PROJECTS/metadata-scrubber-tool/tests/integration/__init__.py
index 00000000,00000000..e69de29b
new file mode 100644
--- /dev/null
+++ b/PROJECTS/metadata-scrubber-tool/tests/integration/__init__.py
diff --cc PROJECTS/metadata-scrubber-tool/tests/integration/test_metadata_factory.py
index 00000000,78a62220..78a62220
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/tests/integration/test_metadata_factory.py
+++ b/PROJECTS/metadata-scrubber-tool/tests/integration/test_metadata_factory.py
diff --cc PROJECTS/metadata-scrubber-tool/tests/unit/__init__.py
index 00000000,00000000..e69de29b
new file mode 100644
--- /dev/null
+++ b/PROJECTS/metadata-scrubber-tool/tests/unit/__init__.py
diff --cc PROJECTS/metadata-scrubber-tool/tests/unit/test_excel_handler.py
index 00000000,fcb70829..fcb70829
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/tests/unit/test_excel_handler.py
+++ b/PROJECTS/metadata-scrubber-tool/tests/unit/test_excel_handler.py
diff --cc PROJECTS/metadata-scrubber-tool/tests/unit/test_image_handler.py
index 00000000,229f5e47..229f5e47
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/tests/unit/test_image_handler.py
+++ b/PROJECTS/metadata-scrubber-tool/tests/unit/test_image_handler.py
diff --cc PROJECTS/metadata-scrubber-tool/tests/unit/test_pdf_handler.py
index 00000000,801b3e2e..801b3e2e
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/tests/unit/test_pdf_handler.py
+++ b/PROJECTS/metadata-scrubber-tool/tests/unit/test_pdf_handler.py
diff --cc PROJECTS/metadata-scrubber-tool/tests/unit/test_powerpoint_handler.py
index 00000000,9fa5716c..9fa5716c
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/tests/unit/test_powerpoint_handler.py
+++ b/PROJECTS/metadata-scrubber-tool/tests/unit/test_powerpoint_handler.py
diff --cc PROJECTS/metadata-scrubber-tool/tests/unit/test_worddoc_handler.py
index 00000000,19c2eaaf..19c2eaaf
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/tests/unit/test_worddoc_handler.py
+++ b/PROJECTS/metadata-scrubber-tool/tests/unit/test_worddoc_handler.py
diff --cc PROJECTS/metadata-scrubber-tool/typings/piexif/__init__.pyi
index 00000000,580fd2c3..580fd2c3
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/typings/piexif/__init__.pyi
+++ b/PROJECTS/metadata-scrubber-tool/typings/piexif/__init__.pyi
diff --cc PROJECTS/metadata-scrubber-tool/typings/piexif/_common.pyi
index 00000000,bc0a391c..bc0a391c
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/typings/piexif/_common.pyi
+++ b/PROJECTS/metadata-scrubber-tool/typings/piexif/_common.pyi
diff --cc PROJECTS/metadata-scrubber-tool/typings/piexif/_dump.pyi
index 00000000,b30bc42e..b30bc42e
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/typings/piexif/_dump.pyi
+++ b/PROJECTS/metadata-scrubber-tool/typings/piexif/_dump.pyi
diff --cc PROJECTS/metadata-scrubber-tool/typings/piexif/_exceptions.pyi
index 00000000,065711d8..065711d8
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/typings/piexif/_exceptions.pyi
+++ b/PROJECTS/metadata-scrubber-tool/typings/piexif/_exceptions.pyi
diff --cc PROJECTS/metadata-scrubber-tool/typings/piexif/_exif.pyi
index 00000000,6612462d..6612462d
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/typings/piexif/_exif.pyi
+++ b/PROJECTS/metadata-scrubber-tool/typings/piexif/_exif.pyi
diff --cc PROJECTS/metadata-scrubber-tool/typings/piexif/_insert.pyi
index 00000000,1ed299bf..1ed299bf
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/typings/piexif/_insert.pyi
+++ b/PROJECTS/metadata-scrubber-tool/typings/piexif/_insert.pyi
diff --cc PROJECTS/metadata-scrubber-tool/typings/piexif/_load.pyi
index 00000000,8c778fd5..8c778fd5
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/typings/piexif/_load.pyi
+++ b/PROJECTS/metadata-scrubber-tool/typings/piexif/_load.pyi
diff --cc PROJECTS/metadata-scrubber-tool/typings/piexif/_remove.pyi
index 00000000,aed1e529..aed1e529
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/typings/piexif/_remove.pyi
+++ b/PROJECTS/metadata-scrubber-tool/typings/piexif/_remove.pyi
diff --cc PROJECTS/metadata-scrubber-tool/typings/piexif/_transplant.pyi
index 00000000,306bc2db..306bc2db
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/typings/piexif/_transplant.pyi
+++ b/PROJECTS/metadata-scrubber-tool/typings/piexif/_transplant.pyi
diff --cc PROJECTS/metadata-scrubber-tool/typings/piexif/_webp.pyi
index 00000000,51b78017..51b78017
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/typings/piexif/_webp.pyi
+++ b/PROJECTS/metadata-scrubber-tool/typings/piexif/_webp.pyi
diff --cc PROJECTS/metadata-scrubber-tool/typings/piexif/helper.pyi
index 00000000,0b9dfee4..0b9dfee4
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/typings/piexif/helper.pyi
+++ b/PROJECTS/metadata-scrubber-tool/typings/piexif/helper.pyi
diff --cc PROJECTS/metadata-scrubber-tool/uv.lock
index 00000000,8f055311..8f055311
mode 000000,100644..100644
--- a/PROJECTS/metadata-scrubber-tool/uv.lock
+++ b/PROJECTS/metadata-scrubber-tool/uv.lock