metadata-cleaner 1.0.0__tar.gz

metadata_cleaner-1.0.0/PKG-INFO

@@ -0,0 +1,221 @@
+Metadata-Version: 2.2
+Name: metadata-cleaner
+Version: 1.0.0
+Summary: A CLI tool to remove metadata from images, documents, audio, and video files.
+Home-page: https://github.com/sandy-sp/metadata-cleaner
+Author: Sandeep Paidipati
+Author-email: sandeep.paidipati@gmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click
+Requires-Dist: pillow
+Requires-Dist: pypdf
+Requires-Dist: python-docx
+Requires-Dist: mutagen
+Requires-Dist: pymediainfo
+Requires-Dist: tqdm
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# 📄 README.md
+---
+# Metadata Cleaner 🧹🔍  
+*A powerful CLI tool to remove metadata from images, PDFs, DOCX, audio, and video files.*
+
+---
+
+## 📌 Overview
+**Metadata Cleaner** is a fast and efficient **command-line tool** that removes metadata from various file formats, including **images, PDFs, documents, audio, and videos**.  
+This tool is designed for **privacy protection, security compliance, and data sanitization**.
+
+🔍 **Why use Metadata Cleaner?**  
+- **Protect your privacy** by stripping hidden metadata from files.  
+- **Sanitize sensitive documents** before sharing.  
+- **Reduce file size** by removing unnecessary metadata.  
+- **Batch process multiple files or entire folders** for efficiency.  
+
+---
+
+## 🚀 Features
+✅ **Supports Metadata Removal for:**  
+- 📷 **Images**: `JPG, PNG, TIFF`  
+- 📄 **Documents**: `PDF, DOCX`  
+- 🎵 **Audio**: `MP3, WAV, FLAC`  
+- 🎥 **Videos**: `MP4, MKV, MOV`  
+
+✅ **Batch Processing**  
+- Remove metadata **from individual files or entire folders**.  
+
+✅ **Parallel Processing**  
+- **Speed up processing** with **multi-file parallel execution**.  
+
+✅ **Interactive & User-Friendly CLI**  
+- Features **progress bars, confirmation prompts, and summary reports**.  
+
+✅ **Safe Metadata Removal**  
+- **Original files remain untouched**, and cleaned versions are saved in a separate folder.  
+
+✅ **Cross-Platform Compatibility**  
+- Works on **Linux, macOS, and Windows**.  
+
+---
+
+## 🛠️ Installation
+
+### **1️⃣ Install via `pip` (Recommended)**
+To install the latest version from **PyPI**, run:  
+```bash
+pip install metadata-cleaner
+```
+
+### **2️⃣ Install from Source**
+If you cloned this repository, install it manually:  
+```bash
+git clone https://github.com/sandy-sp/metadata-cleaner.git
+cd metadata-cleaner
+pip install .
+```
+
+---
+
+## 📖 Usage
+
+### **1️⃣ Remove Metadata from a Single File**
+```bash
+metadata-cleaner --file path/to/file.jpg
+```
+✅ **Example Output:**
+```
+Do you want to process file.jpg? [Y/n]: Y
+✅ Metadata removed. Cleaned file saved at: path/to/cleaned/file.jpg
+```
+
+### **2️⃣ Remove Metadata from All Files in a Folder**
+```bash
+metadata-cleaner --folder test_folder
+```
+✅ **Example Output:**
+```
+Do you want to process all files in test_folder? [Y/n]: Y
+Processing Files: 100% |███████████████████████| 5/5 [00:10s]
+
+📊 **Summary Report:**
+✅ Successfully processed: 5 files
+❌ Failed to process: 0 files
+Cleaned files saved in: test_folder/cleaned
+```
+
+### **3️⃣ Remove Metadata Without Confirmation Prompt**
+```bash
+metadata-cleaner --folder test_folder --yes
+```
+
+### **4️⃣ Display Help**
+```bash
+metadata-cleaner --help
+```
+✅ **Example Output:**
+```
+Usage: metadata-cleaner [OPTIONS]
+
+Options:
+  --file TEXT    Path to the file to clean metadata from.
+  --folder TEXT  Path to a folder to clean metadata from all supported files.
+  --output TEXT  Path to save the cleaned file(s).
+  --yes          Skip confirmation prompts.
+  --help         Show this message and exit.
+```
+
+---
+
+## 🔧 How It Works
+1️⃣ **Detects file type** and selects the appropriate metadata removal method.  
+2️⃣ **Processes the file** by removing metadata safely.  
+3️⃣ **Saves the cleaned version** in the `cleaned/` subfolder.  
+4️⃣ **Generates logs and a summary report** for easy tracking.  
+
+---
+
+## 💻 Supported File Formats & Methods
+
+| File Type | Supported Formats | Metadata Removal Method |
+|-----------|------------------|------------------------|
+| 📷 **Images** | `JPG, PNG, TIFF` | Pillow (`PIL`) |
+| 📄 **Documents** | `PDF, DOCX` | PyPDF2, python-docx |
+| 🎵 **Audio** | `MP3, WAV, FLAC` | Mutagen |
+| 🎥 **Videos** | `MP4, MKV, MOV` | FFmpeg |
+
+---
+
+## 🏗 Project Structure
+```
+metadata-cleaner/
+│── docs/                      # Documentation
+│── scripts/                   # Setup and installation scripts
+│── src/                       # Source code
+│   │── cli.py                 # CLI entry point
+│   │── remover.py             # Core metadata remover
+│   │── file_handlers/         # File-specific handlers
+│── tests/                     # Unit tests
+│── test_folder/               # Sample test files
+│── setup.py                   # Package setup
+│── requirements.txt           # Dependencies
+│── LICENSE                    # License information
+```
+
+---
+
+## 💡 Contributing
+We welcome contributions! To contribute:
+
+1️⃣ **Fork** the repository.  
+2️⃣ **Clone** your forked repo:
+   ```bash
+   git clone https://github.com/sandy-sp/metadata-cleaner.git
+   ```
+3️⃣ **Create a new branch** for your feature:
+   ```bash
+   git checkout -b feature-name
+   ```
+4️⃣ **Make changes & test**:
+   ```bash
+   pytest tests/
+   ```
+5️⃣ **Commit and push**:
+   ```bash
+   git commit -m "Added new feature"
+   git push origin feature-name
+   ```
+6️⃣ **Submit a Pull Request (PR).**
+
+---
+
+## 🔒 License
+This project is licensed under the **MIT License**.  
+See the full license in [`LICENSE`](LICENSE).
+
+---
+
+## 🔗 Links & Resources
+- 📖 **Documentation**: [API Reference](docs/API_REFERENCE.md)
+- 🐍 **PyPI Package**: [metadata-cleaner](https://pypi.org/project/metadata-cleaner/)
+- 🚀 **GitHub Repository**: [metadata-cleaner](https://github.com/sandy-sp/metadata-cleaner)
+
+---
+
+## ❤️ Support
+If you found this tool useful, give it a ⭐ on GitHub!  
+For issues or questions, [open an issue](https://github.com/sandy-sp/metadata-cleaner/issues).
+
+---

metadata_cleaner-1.0.0/README.md

@@ -0,0 +1,191 @@
+# 📄 README.md
+---
+# Metadata Cleaner 🧹🔍  
+*A powerful CLI tool to remove metadata from images, PDFs, DOCX, audio, and video files.*
+
+---
+
+## 📌 Overview
+**Metadata Cleaner** is a fast and efficient **command-line tool** that removes metadata from various file formats, including **images, PDFs, documents, audio, and videos**.  
+This tool is designed for **privacy protection, security compliance, and data sanitization**.
+
+🔍 **Why use Metadata Cleaner?**  
+- **Protect your privacy** by stripping hidden metadata from files.  
+- **Sanitize sensitive documents** before sharing.  
+- **Reduce file size** by removing unnecessary metadata.  
+- **Batch process multiple files or entire folders** for efficiency.  
+
+---
+
+## 🚀 Features
+✅ **Supports Metadata Removal for:**  
+- 📷 **Images**: `JPG, PNG, TIFF`  
+- 📄 **Documents**: `PDF, DOCX`  
+- 🎵 **Audio**: `MP3, WAV, FLAC`  
+- 🎥 **Videos**: `MP4, MKV, MOV`  
+
+✅ **Batch Processing**  
+- Remove metadata **from individual files or entire folders**.  
+
+✅ **Parallel Processing**  
+- **Speed up processing** with **multi-file parallel execution**.  
+
+✅ **Interactive & User-Friendly CLI**  
+- Features **progress bars, confirmation prompts, and summary reports**.  
+
+✅ **Safe Metadata Removal**  
+- **Original files remain untouched**, and cleaned versions are saved in a separate folder.  
+
+✅ **Cross-Platform Compatibility**  
+- Works on **Linux, macOS, and Windows**.  
+
+---
+
+## 🛠️ Installation
+
+### **1️⃣ Install via `pip` (Recommended)**
+To install the latest version from **PyPI**, run:  
+```bash
+pip install metadata-cleaner
+```
+
+### **2️⃣ Install from Source**
+If you cloned this repository, install it manually:  
+```bash
+git clone https://github.com/sandy-sp/metadata-cleaner.git
+cd metadata-cleaner
+pip install .
+```
+
+---
+
+## 📖 Usage
+
+### **1️⃣ Remove Metadata from a Single File**
+```bash
+metadata-cleaner --file path/to/file.jpg
+```
+✅ **Example Output:**
+```
+Do you want to process file.jpg? [Y/n]: Y
+✅ Metadata removed. Cleaned file saved at: path/to/cleaned/file.jpg
+```
+
+### **2️⃣ Remove Metadata from All Files in a Folder**
+```bash
+metadata-cleaner --folder test_folder
+```
+✅ **Example Output:**
+```
+Do you want to process all files in test_folder? [Y/n]: Y
+Processing Files: 100% |███████████████████████| 5/5 [00:10s]
+
+📊 **Summary Report:**
+✅ Successfully processed: 5 files
+❌ Failed to process: 0 files
+Cleaned files saved in: test_folder/cleaned
+```
+
+### **3️⃣ Remove Metadata Without Confirmation Prompt**
+```bash
+metadata-cleaner --folder test_folder --yes
+```
+
+### **4️⃣ Display Help**
+```bash
+metadata-cleaner --help
+```
+✅ **Example Output:**
+```
+Usage: metadata-cleaner [OPTIONS]
+
+Options:
+  --file TEXT    Path to the file to clean metadata from.
+  --folder TEXT  Path to a folder to clean metadata from all supported files.
+  --output TEXT  Path to save the cleaned file(s).
+  --yes          Skip confirmation prompts.
+  --help         Show this message and exit.
+```
+
+---
+
+## 🔧 How It Works
+1️⃣ **Detects file type** and selects the appropriate metadata removal method.  
+2️⃣ **Processes the file** by removing metadata safely.  
+3️⃣ **Saves the cleaned version** in the `cleaned/` subfolder.  
+4️⃣ **Generates logs and a summary report** for easy tracking.  
+
+---
+
+## 💻 Supported File Formats & Methods
+
+| File Type | Supported Formats | Metadata Removal Method |
+|-----------|------------------|------------------------|
+| 📷 **Images** | `JPG, PNG, TIFF` | Pillow (`PIL`) |
+| 📄 **Documents** | `PDF, DOCX` | PyPDF2, python-docx |
+| 🎵 **Audio** | `MP3, WAV, FLAC` | Mutagen |
+| 🎥 **Videos** | `MP4, MKV, MOV` | FFmpeg |
+
+---
+
+## 🏗 Project Structure
+```
+metadata-cleaner/
+│── docs/                      # Documentation
+│── scripts/                   # Setup and installation scripts
+│── src/                       # Source code
+│   │── cli.py                 # CLI entry point
+│   │── remover.py             # Core metadata remover
+│   │── file_handlers/         # File-specific handlers
+│── tests/                     # Unit tests
+│── test_folder/               # Sample test files
+│── setup.py                   # Package setup
+│── requirements.txt           # Dependencies
+│── LICENSE                    # License information
+```
+
+---
+
+## 💡 Contributing
+We welcome contributions! To contribute:
+
+1️⃣ **Fork** the repository.  
+2️⃣ **Clone** your forked repo:
+   ```bash
+   git clone https://github.com/sandy-sp/metadata-cleaner.git
+   ```
+3️⃣ **Create a new branch** for your feature:
+   ```bash
+   git checkout -b feature-name
+   ```
+4️⃣ **Make changes & test**:
+   ```bash
+   pytest tests/
+   ```
+5️⃣ **Commit and push**:
+   ```bash
+   git commit -m "Added new feature"
+   git push origin feature-name
+   ```
+6️⃣ **Submit a Pull Request (PR).**
+
+---
+
+## 🔒 License
+This project is licensed under the **MIT License**.  
+See the full license in [`LICENSE`](LICENSE).
+
+---
+
+## 🔗 Links & Resources
+- 📖 **Documentation**: [API Reference](docs/API_REFERENCE.md)
+- 🐍 **PyPI Package**: [metadata-cleaner](https://pypi.org/project/metadata-cleaner/)
+- 🚀 **GitHub Repository**: [metadata-cleaner](https://github.com/sandy-sp/metadata-cleaner)
+
+---
+
+## ❤️ Support
+If you found this tool useful, give it a ⭐ on GitHub!  
+For issues or questions, [open an issue](https://github.com/sandy-sp/metadata-cleaner/issues).
+
+---

metadata_cleaner-1.0.0/metadata_cleaner.egg-info/PKG-INFO

@@ -0,0 +1,221 @@
+Metadata-Version: 2.2
+Name: metadata-cleaner
+Version: 1.0.0
+Summary: A CLI tool to remove metadata from images, documents, audio, and video files.
+Home-page: https://github.com/sandy-sp/metadata-cleaner
+Author: Sandeep Paidipati
+Author-email: sandeep.paidipati@gmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click
+Requires-Dist: pillow
+Requires-Dist: pypdf
+Requires-Dist: python-docx
+Requires-Dist: mutagen
+Requires-Dist: pymediainfo
+Requires-Dist: tqdm
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# 📄 README.md
+---
+# Metadata Cleaner 🧹🔍  
+*A powerful CLI tool to remove metadata from images, PDFs, DOCX, audio, and video files.*
+
+---
+
+## 📌 Overview
+**Metadata Cleaner** is a fast and efficient **command-line tool** that removes metadata from various file formats, including **images, PDFs, documents, audio, and videos**.  
+This tool is designed for **privacy protection, security compliance, and data sanitization**.
+
+🔍 **Why use Metadata Cleaner?**  
+- **Protect your privacy** by stripping hidden metadata from files.  
+- **Sanitize sensitive documents** before sharing.  
+- **Reduce file size** by removing unnecessary metadata.  
+- **Batch process multiple files or entire folders** for efficiency.  
+
+---
+
+## 🚀 Features
+✅ **Supports Metadata Removal for:**  
+- 📷 **Images**: `JPG, PNG, TIFF`  
+- 📄 **Documents**: `PDF, DOCX`  
+- 🎵 **Audio**: `MP3, WAV, FLAC`  
+- 🎥 **Videos**: `MP4, MKV, MOV`  
+
+✅ **Batch Processing**  
+- Remove metadata **from individual files or entire folders**.  
+
+✅ **Parallel Processing**  
+- **Speed up processing** with **multi-file parallel execution**.  
+
+✅ **Interactive & User-Friendly CLI**  
+- Features **progress bars, confirmation prompts, and summary reports**.  
+
+✅ **Safe Metadata Removal**  
+- **Original files remain untouched**, and cleaned versions are saved in a separate folder.  
+
+✅ **Cross-Platform Compatibility**  
+- Works on **Linux, macOS, and Windows**.  
+
+---
+
+## 🛠️ Installation
+
+### **1️⃣ Install via `pip` (Recommended)**
+To install the latest version from **PyPI**, run:  
+```bash
+pip install metadata-cleaner
+```
+
+### **2️⃣ Install from Source**
+If you cloned this repository, install it manually:  
+```bash
+git clone https://github.com/sandy-sp/metadata-cleaner.git
+cd metadata-cleaner
+pip install .
+```
+
+---
+
+## 📖 Usage
+
+### **1️⃣ Remove Metadata from a Single File**
+```bash
+metadata-cleaner --file path/to/file.jpg
+```
+✅ **Example Output:**
+```
+Do you want to process file.jpg? [Y/n]: Y
+✅ Metadata removed. Cleaned file saved at: path/to/cleaned/file.jpg
+```
+
+### **2️⃣ Remove Metadata from All Files in a Folder**
+```bash
+metadata-cleaner --folder test_folder
+```
+✅ **Example Output:**
+```
+Do you want to process all files in test_folder? [Y/n]: Y
+Processing Files: 100% |███████████████████████| 5/5 [00:10s]
+
+📊 **Summary Report:**
+✅ Successfully processed: 5 files
+❌ Failed to process: 0 files
+Cleaned files saved in: test_folder/cleaned
+```
+
+### **3️⃣ Remove Metadata Without Confirmation Prompt**
+```bash
+metadata-cleaner --folder test_folder --yes
+```
+
+### **4️⃣ Display Help**
+```bash
+metadata-cleaner --help
+```
+✅ **Example Output:**
+```
+Usage: metadata-cleaner [OPTIONS]
+
+Options:
+  --file TEXT    Path to the file to clean metadata from.
+  --folder TEXT  Path to a folder to clean metadata from all supported files.
+  --output TEXT  Path to save the cleaned file(s).
+  --yes          Skip confirmation prompts.
+  --help         Show this message and exit.
+```
+
+---
+
+## 🔧 How It Works
+1️⃣ **Detects file type** and selects the appropriate metadata removal method.  
+2️⃣ **Processes the file** by removing metadata safely.  
+3️⃣ **Saves the cleaned version** in the `cleaned/` subfolder.  
+4️⃣ **Generates logs and a summary report** for easy tracking.  
+
+---
+
+## 💻 Supported File Formats & Methods
+
+| File Type | Supported Formats | Metadata Removal Method |
+|-----------|------------------|------------------------|
+| 📷 **Images** | `JPG, PNG, TIFF` | Pillow (`PIL`) |
+| 📄 **Documents** | `PDF, DOCX` | PyPDF2, python-docx |
+| 🎵 **Audio** | `MP3, WAV, FLAC` | Mutagen |
+| 🎥 **Videos** | `MP4, MKV, MOV` | FFmpeg |
+
+---
+
+## 🏗 Project Structure
+```
+metadata-cleaner/
+│── docs/                      # Documentation
+│── scripts/                   # Setup and installation scripts
+│── src/                       # Source code
+│   │── cli.py                 # CLI entry point
+│   │── remover.py             # Core metadata remover
+│   │── file_handlers/         # File-specific handlers
+│── tests/                     # Unit tests
+│── test_folder/               # Sample test files
+│── setup.py                   # Package setup
+│── requirements.txt           # Dependencies
+│── LICENSE                    # License information
+```
+
+---
+
+## 💡 Contributing
+We welcome contributions! To contribute:
+
+1️⃣ **Fork** the repository.  
+2️⃣ **Clone** your forked repo:
+   ```bash
+   git clone https://github.com/sandy-sp/metadata-cleaner.git
+   ```
+3️⃣ **Create a new branch** for your feature:
+   ```bash
+   git checkout -b feature-name
+   ```
+4️⃣ **Make changes & test**:
+   ```bash
+   pytest tests/
+   ```
+5️⃣ **Commit and push**:
+   ```bash
+   git commit -m "Added new feature"
+   git push origin feature-name
+   ```
+6️⃣ **Submit a Pull Request (PR).**
+
+---
+
+## 🔒 License
+This project is licensed under the **MIT License**.  
+See the full license in [`LICENSE`](LICENSE).
+
+---
+
+## 🔗 Links & Resources
+- 📖 **Documentation**: [API Reference](docs/API_REFERENCE.md)
+- 🐍 **PyPI Package**: [metadata-cleaner](https://pypi.org/project/metadata-cleaner/)
+- 🚀 **GitHub Repository**: [metadata-cleaner](https://github.com/sandy-sp/metadata-cleaner)
+
+---
+
+## ❤️ Support
+If you found this tool useful, give it a ⭐ on GitHub!  
+For issues or questions, [open an issue](https://github.com/sandy-sp/metadata-cleaner/issues).
+
+---

metadata_cleaner-1.0.0/metadata_cleaner.egg-info/SOURCES.txt

@@ -0,0 +1,28 @@
+LICENSE
+README.md
+setup.py
+metadata_cleaner.egg-info/PKG-INFO
+metadata_cleaner.egg-info/SOURCES.txt
+metadata_cleaner.egg-info/dependency_links.txt
+metadata_cleaner.egg-info/entry_points.txt
+metadata_cleaner.egg-info/requires.txt
+metadata_cleaner.egg-info/top_level.txt
+src/__init__.py
+src/cli.py
+src/remover.py
+src/config/__init__.py
+src/config/settings.py
+src/core/__init__.py
+src/core/metadata_utils.py
+src/file_handlers/__init__.py
+src/file_handlers/audio_handler.py
+src/file_handlers/docx_handler.py
+src/file_handlers/image_handler.py
+src/file_handlers/pdf_handler.py
+src/file_handlers/video_handler.py
+src/logs/__init__.py
+src/logs/logger.py
+tests/__init__.py
+tests/test_file_handlers.py
+tests/test_remover.py
+tests/test_settings_utils.py

metadata_cleaner-1.0.0/metadata_cleaner.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

metadata_cleaner-1.0.0/metadata_cleaner.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+metadata-cleaner = src.cli:main

metadata_cleaner-1.0.0/metadata_cleaner.egg-info/requires.txt

@@ -0,0 +1,7 @@
+click
+pillow
+pypdf
+python-docx
+mutagen
+pymediainfo
+tqdm

metadata_cleaner-1.0.0/metadata_cleaner.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+src
+tests

metadata_cleaner-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

metadata_cleaner-1.0.0/setup.py

@@ -0,0 +1,34 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="metadata-cleaner",
+    version="1.0.0",
+    author="Sandeep Paidipati",
+    author_email="sandeep.paidipati@gmail.com",
+    description="A CLI tool to remove metadata from images, documents, audio, and video files.",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    url="https://github.com/sandy-sp/metadata-cleaner",
+    packages=find_packages(),
+    include_package_data=True,
+    install_requires=[
+        "click",
+        "pillow",
+        "pypdf",
+        "python-docx",
+        "mutagen",
+        "pymediainfo",
+        "tqdm"
+    ],
+    entry_points={
+        "console_scripts": [
+            "metadata-cleaner = src.cli:main",
+        ],
+    },
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires='>=3.7',
+)

metadata_cleaner-1.0.0/src/cli.py

@@ -0,0 +1,49 @@
+import os
+import click
+from src.logs.logger import logger
+from src.remover import remove_metadata, remove_metadata_from_folder
+
+@click.command()
+@click.option('--file', '-f', type=click.Path(exists=True), help="Path to the file to clean metadata from.")
+@click.option('--folder', '-d', type=click.Path(exists=True), help="Path to a folder to clean metadata from all supported files.")
+@click.option('--output', '-o', type=click.Path(), help="Path to save the cleaned file(s).")
+@click.option('--yes', '-y', is_flag=True, help="Skip confirmation prompts.")
+def main(file, folder, output, yes):
+    """CLI for metadata removal. Supports single file or batch processing with interactivity."""
+    try:
+        if file:
+            if not yes and not click.confirm(f"Do you want to process {file}?", default=True):
+                click.echo("❌ Operation cancelled.")
+                return
+
+            logger.info(f"Processing single file: {file}")
+            cleaned_file = remove_metadata(file, output)
+            if cleaned_file:
+                click.echo(f"✅ Metadata removed. Cleaned file saved at: {cleaned_file}")
+            else:
+                click.echo(f"⚠️ Failed to process file: {file}")
+
+        elif folder:
+            if not yes and not click.confirm(f"Do you want to process all files in {folder}?", default=True):
+                click.echo("❌ Operation cancelled.")
+                return
+
+            logger.info(f"Processing folder: {folder}")
+            cleaned_files = remove_metadata_from_folder(folder, output)
+
+            # Display summary report
+            click.echo("\n📊 **Summary Report:**")
+            click.echo(f"✅ Successfully processed: {len(cleaned_files)} files")
+
+            if cleaned_files:
+                click.echo(f"Cleaned files saved in: {output if output else folder}")
+
+        else:
+            click.echo("❌ Please specify either --file or --folder to process.")
+
+    except Exception as e:
+        logger.error(f"CLI Error: {e}")
+        click.echo(f"❌ Error: {e}")
+
+if __name__ == "__main__":
+    main()

metadata_cleaner-1.0.0/src/config/settings.py

@@ -0,0 +1,19 @@
+import os
+
+# 🏠 Default output directory
+DEFAULT_OUTPUT_FOLDER = "cleaned"
+
+# 🛠 Enable or Disable Parallel Processing
+ENABLE_PARALLEL_PROCESSING = True
+
+# 📝 Logging Configuration
+LOG_FILE_PATH = os.path.join("logs", "metadata_cleaner.log")
+LOG_LEVEL = "INFO"  # Options: DEBUG, INFO, WARNING, ERROR
+
+# 🔧 Supported File Formats
+SUPPORTED_FORMATS = {
+    "images": [".jpg", ".jpeg", ".png", ".tiff"],
+    "documents": [".pdf", ".docx", ".doc"],
+    "audio": [".mp3", ".wav", ".flac", ".ogg"],
+    "videos": [".mp4", ".mkv", ".mov", ".avi"]
+}

metadata_cleaner-1.0.0/src/core/metadata_utils.py

@@ -0,0 +1,20 @@
+import os
+import shutil
+
+def ensure_output_folder(output_folder):
+    """Ensures the output folder exists. If not, creates it."""
+    if not os.path.exists(output_folder):
+        os.makedirs(output_folder)
+
+def copy_file_without_metadata(original_path, output_path):
+    """Copies a file to a new location while ensuring metadata is stripped."""
+    try:
+        shutil.copy(original_path, output_path)
+        return output_path
+    except Exception as e:
+        print(f"❌ Error copying file: {e}")
+        return None
+
+def get_file_extension(file_path):
+    """Returns the lowercase file extension of a file."""
+    return os.path.splitext(file_path)[1].lower()

metadata_cleaner-1.0.0/src/file_handlers/audio_handler.py

@@ -0,0 +1,19 @@
+from mutagen.mp3 import MP3
+from mutagen.easyid3 import EasyID3
+import shutil
+
+def remove_audio_metadata(file_path, output_path=None):
+    """Removes metadata from MP3 and other audio files."""
+    try:
+        audio = MP3(file_path, ID3=EasyID3)
+        audio.delete()
+        audio.save()
+
+        if output_path:
+            shutil.copy(file_path, output_path)  # Ensure file is saved to the output directory
+            return output_path
+        return file_path
+
+    except Exception as e:
+        print(f"Error removing metadata from {file_path}: {e}")
+        return None

metadata_cleaner-1.0.0/src/file_handlers/docx_handler.py

@@ -0,0 +1,17 @@
+from docx import Document
+
+def remove_docx_metadata(file_path, output_path=None):
+    """Removes metadata from DOCX files."""
+    doc = Document(file_path)
+
+    # Remove core properties
+    doc.core_properties.author = ""
+    doc.core_properties.title = ""
+    doc.core_properties.keywords = ""
+    doc.core_properties.comments = ""
+
+    if not output_path:
+        output_path = file_path.replace(".", "_cleaned.")
+
+    doc.save(output_path)
+    return output_path

metadata_cleaner-1.0.0/src/file_handlers/image_handler.py

@@ -0,0 +1,22 @@
+from PIL import Image
+import os
+
+def remove_image_metadata(file_path, output_path=None):
+    """Removes metadata from images (JPG, PNG, TIFF) with error handling."""
+    try:
+        img = Image.open(file_path)
+        
+        # Create a new image without metadata
+        data = list(img.getdata())
+        img_no_metadata = Image.new(img.mode, img.size)
+        img_no_metadata.putdata(data)
+
+        if not output_path:
+            output_path = file_path.replace(".", "_cleaned.")
+
+        img_no_metadata.save(output_path)
+        return output_path
+
+    except Exception as e:
+        print(f"Error removing metadata from {file_path}: {e}")
+        return None

metadata_cleaner-1.0.0/src/file_handlers/pdf_handler.py

@@ -0,0 +1,26 @@
+from PyPDF2 import PdfReader, PdfWriter
+import os
+
+def remove_pdf_metadata(file_path, output_path=None):
+    """Removes metadata from PDFs with error handling."""
+    try:
+        reader = PdfReader(file_path)
+        writer = PdfWriter()
+
+        # Copy pages and remove metadata
+        for page in reader.pages:
+            writer.add_page(page)
+
+        writer.add_metadata({})  # Clear metadata
+
+        if not output_path:
+            output_path = file_path.replace(".", "_cleaned.")
+
+        with open(output_path, "wb") as f:
+            writer.write(f)
+        
+        return output_path
+
+    except Exception as e:
+        print(f"Error removing metadata from {file_path}: {e}")
+        return None

metadata_cleaner-1.0.0/src/file_handlers/video_handler.py

@@ -0,0 +1,21 @@
+import subprocess
+import shutil
+
+def remove_video_metadata(file_path, output_path=None):
+    """Removes metadata from video files using FFmpeg."""
+    try:
+        if not output_path:
+            output_path = file_path.replace(".", "_cleaned.")
+
+        # Use FFmpeg to re-encode the file and strip metadata
+        command = [
+            "ffmpeg", "-i", file_path, "-map_metadata", "-1",
+            "-c:v", "libx264", "-c:a", "aac", output_path, "-y"
+        ]
+        subprocess.run(command, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL, check=True)
+
+        return output_path
+
+    except subprocess.CalledProcessError as e:
+        print(f"Error removing metadata from {file_path}: {e}")
+        return None

metadata_cleaner-1.0.0/src/logs/logger.py

@@ -0,0 +1,22 @@
+import logging
+import os
+
+LOG_FILE = "metadata_cleaner.log"
+
+# Ensure logs directory exists
+LOG_DIR = os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "logs"))
+os.makedirs(LOG_DIR, exist_ok=True)
+
+LOG_PATH = os.path.join(LOG_DIR, LOG_FILE)
+
+# Configure logging
+logging.basicConfig(
+    level=logging.INFO,
+    format="%(asctime)s - %(levelname)s - %(message)s",
+    handlers=[
+        logging.FileHandler(LOG_PATH),  # Log to a file
+        logging.StreamHandler()  # Log to console
+    ]
+)
+
+logger = logging.getLogger("metadata_cleaner")

metadata_cleaner-1.0.0/src/remover.py

@@ -0,0 +1,111 @@
+import os
+import concurrent.futures
+from tqdm import tqdm
+from src.logs.logger import logger
+from src.file_handlers.image_handler import remove_image_metadata
+from src.file_handlers.pdf_handler import remove_pdf_metadata
+from src.file_handlers.docx_handler import remove_docx_metadata
+from src.file_handlers.audio_handler import remove_audio_metadata
+from src.file_handlers.video_handler import remove_video_metadata
+
+SUPPORTED_EXTENSIONS = {
+    ".jpg": remove_image_metadata, ".jpeg": remove_image_metadata, ".png": remove_image_metadata, ".tiff": remove_image_metadata,
+    ".pdf": remove_pdf_metadata,
+    ".docx": remove_docx_metadata, ".doc": remove_docx_metadata,
+    ".mp3": remove_audio_metadata, ".wav": remove_audio_metadata, ".flac": remove_audio_metadata, ".ogg": remove_audio_metadata,
+    ".mp4": remove_video_metadata, ".mkv": remove_video_metadata, ".mov": remove_video_metadata, ".avi": remove_video_metadata
+}
+
+def remove_metadata(file_path, output_path=None):
+    """Removes metadata from a single file and logs detailed errors."""
+    try:
+        if not os.path.exists(file_path):
+            logger.error(f"File not found: {file_path}")
+            raise FileNotFoundError(f"File not found: {file_path}")
+
+        ext = os.path.splitext(file_path)[1].lower()
+        if ext not in SUPPORTED_EXTENSIONS:
+            logger.warning(f"Unsupported file type: {ext}")
+            raise ValueError(f"Unsupported file type: {ext}")
+
+        logger.info(f"Processing file: {file_path}")
+        remover_function = SUPPORTED_EXTENSIONS[ext]
+
+        cleaned_file = remover_function(file_path, output_path)
+
+        if cleaned_file and os.path.exists(cleaned_file):
+            logger.info(f"Metadata removed successfully: {cleaned_file}")
+            return cleaned_file
+        else:
+            logger.error(f"Failed to process file: {file_path}")
+            return None
+
+    except Exception as e:
+        logger.error(f"Error processing file {file_path}: {e}")
+        return None
+
+def process_file(file_path, output_folder):
+    """Processes a single file in parallel."""
+    try:
+        ext = os.path.splitext(file_path)[1].lower()
+        if ext in SUPPORTED_EXTENSIONS:
+            output_path = os.path.join(output_folder, os.path.basename(file_path)) if output_folder else file_path
+            cleaned_file = SUPPORTED_EXTENSIONS[ext](file_path, output_path)
+            if cleaned_file and os.path.exists(cleaned_file):
+                logger.info(f"✅ Metadata removed: {cleaned_file}")
+                return cleaned_file
+            else:
+                logger.error(f"❌ Failed to process: {file_path}")
+                return None
+        else:
+            logger.warning(f"⚠️ Unsupported file type: {file_path}")
+            return None
+    except Exception as e:
+        logger.error(f"Error processing {file_path}: {e}")
+        return None
+
+def remove_metadata_from_folder(folder_path, output_folder=None):
+    """Removes metadata from all supported files in a folder with parallel processing."""
+    if not os.path.exists(folder_path):
+        logger.error(f"❌ Folder not found: {folder_path}")
+        raise FileNotFoundError(f"Folder not found: {folder_path}")
+
+    # Create output folder inside test_folder
+    if not output_folder:
+        output_folder = os.path.join(folder_path, "cleaned")
+    os.makedirs(output_folder, exist_ok=True)
+
+    files_to_process = []
+    for root, _, files in os.walk(folder_path):
+        for file in files:
+            file_path = os.path.join(root, file)
+            ext = os.path.splitext(file)[1].lower()
+            if ext in SUPPORTED_EXTENSIONS:
+                files_to_process.append(file_path)
+
+    processed_files = []
+    failed_files = []
+
+    with tqdm(total=len(files_to_process), desc="Processing Files", unit="file") as pbar:
+        with concurrent.futures.ProcessPoolExecutor() as executor:
+            future_to_file = {executor.submit(process_file, file_path, output_folder): file_path for file_path in files_to_process}
+
+            for future in concurrent.futures.as_completed(future_to_file):
+                result = future.result()
+                if result:
+                    processed_files.append(result)
+                else:
+                    failed_files.append(future_to_file[future])
+                pbar.update(1)
+
+    # Summary Report
+    logger.info("\n📊 **Summary Report:**")
+    logger.info(f"✅ Successfully processed: {len(processed_files)} files")
+    logger.info(f"❌ Failed to process: {len(failed_files)} files")
+
+    if failed_files:
+        logger.info("\n⚠️ Failed Files:")
+        for file in failed_files:
+            logger.info(f"  - {file}")
+
+    return processed_files

metadata_cleaner-1.0.0/tests/test_file_handlers.py

@@ -0,0 +1,80 @@
+import unittest
+import os
+import subprocess
+from PIL import Image
+from docx import Document
+from PyPDF2 import PdfWriter
+from src.file_handlers.image_handler import remove_image_metadata
+from src.file_handlers.pdf_handler import remove_pdf_metadata
+from src.file_handlers.docx_handler import remove_docx_metadata
+from src.file_handlers.audio_handler import remove_audio_metadata
+from src.file_handlers.video_handler import remove_video_metadata
+
+class TestFileHandlers(unittest.TestCase):
+
+    def setUp(self):
+        """Create valid test files."""
+        self.test_image = "test_image.jpg"
+        self.test_pdf = "test_document.pdf"
+        self.test_docx = "test_document.docx"
+        self.test_audio = "test_audio.mp3"
+        self.test_video = "test_video.mp4"
+
+        # ✅ Create a valid JPG file
+        img = Image.new("RGB", (100, 100), color="blue")
+        img.save(self.test_image, "JPEG")
+
+        # ✅ Create a valid PDF
+        writer = PdfWriter()
+        writer.add_metadata({"/Author": "Test"})
+        with open(self.test_pdf, "wb") as f:
+            writer.write(f)
+
+        # ✅ Create a valid DOCX file
+        doc = Document()
+        doc.add_paragraph("This is a test document.")
+        doc.save(self.test_docx)
+
+        # ✅ Create a valid MP3 file
+        subprocess.run(["ffmpeg", "-f", "lavfi", "-i", "anullsrc=r=44100:cl=mono",
+                        "-t", "3", "-q:a", "9", "-acodec", "libmp3lame", self.test_audio, "-y"],
+                       stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+
+        # ✅ Create a valid MP4 file
+        subprocess.run(["ffmpeg", "-f", "lavfi", "-i", "color=c=blue:s=320x240:d=3",
+                        "-vf", "format=yuv420p", self.test_video, "-y"],
+                       stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+
+    def test_image_handler(self):
+        """Test image metadata removal."""
+        output_file = remove_image_metadata(self.test_image)
+        self.assertTrue(os.path.exists(output_file))
+
+    def test_pdf_handler(self):
+        """Test PDF metadata removal."""
+        output_file = remove_pdf_metadata(self.test_pdf)
+        self.assertTrue(os.path.exists(output_file))
+
+    def test_docx_handler(self):
+        """Test DOCX metadata removal."""
+        output_file = remove_docx_metadata(self.test_docx)
+        self.assertTrue(os.path.exists(output_file))
+
+    def test_audio_handler(self):
+        """Test audio metadata removal."""
+        output_file = remove_audio_metadata(self.test_audio)
+        self.assertTrue(os.path.exists(output_file))
+
+    def test_video_handler(self):
+        """Test video metadata removal."""
+        output_file = remove_video_metadata(self.test_video)
+        self.assertTrue(os.path.exists(output_file))
+
+    def tearDown(self):
+        """Clean up test files."""
+        for file in [self.test_image, self.test_pdf, self.test_docx, self.test_audio, self.test_video]:
+            if os.path.exists(file):
+                os.remove(file)
+
+if __name__ == "__main__":
+    unittest.main()

metadata_cleaner-1.0.0/tests/test_remover.py

@@ -0,0 +1,60 @@
+from PIL import Image
+import subprocess
+import unittest
+import os
+import shutil
+from docx import Document
+from PyPDF2 import PdfWriter
+from src.remover import remove_metadata, remove_metadata_from_folder
+
+class TestMetadataRemover(unittest.TestCase):
+
+    def setUp(self):
+        """Create valid test files with actual content."""
+        self.test_folder = "test_batch"
+        self.output_folder = "test_batch_output"
+        os.makedirs(self.test_folder, exist_ok=True)
+
+        # ✅ Create a valid JPG file
+        image_path = os.path.join(self.test_folder, "test_image.jpg")
+        img = Image.new("RGB", (100, 100), color="red")
+        img.save(image_path, "JPEG")
+
+        # ✅ Create a valid PDF file
+        writer = PdfWriter()
+        writer.add_metadata({"/Author": "Test"})
+        with open(os.path.join(self.test_folder, "test_document.pdf"), "wb") as f:
+            writer.write(f)
+
+        # ✅ Create a valid DOCX file
+        doc = Document()
+        doc.add_paragraph("This is a test document.")
+        doc.save(os.path.join(self.test_folder, "test_document.docx"))
+
+        # ✅ Create a valid MP3 file
+        mp3_path = os.path.join(self.test_folder, "test_audio.mp3")
+        subprocess.run(["ffmpeg", "-f", "lavfi", "-i", "anullsrc=r=44100:cl=mono",
+                        "-t", "3", "-q:a", "9", "-acodec", "libmp3lame", mp3_path, "-y"],
+                       stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+
+        # ✅ Create a valid MP4 file
+        mp4_path = os.path.join(self.test_folder, "test_video.mp4")
+        subprocess.run(["ffmpeg", "-f", "lavfi", "-i", "color=c=blue:s=320x240:d=3",
+                        "-vf", "format=yuv420p", mp4_path, "-y"],
+                       stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+
+    def test_batch_processing(self):
+        """Test batch metadata removal."""
+        cleaned_files = remove_metadata_from_folder(self.test_folder, self.output_folder)
+        self.assertEqual(len(cleaned_files), 5)  # Expect all 5 files to be processed
+
+        for file in cleaned_files:
+            self.assertTrue(os.path.exists(file))
+
+    def tearDown(self):
+        """Clean up test files."""
+        shutil.rmtree(self.test_folder, ignore_errors=True)
+        shutil.rmtree(self.output_folder, ignore_errors=True)
+
+if __name__ == "__main__":
+    unittest.main()

metadata_cleaner-1.0.0/tests/test_settings_utils.py

@@ -0,0 +1,57 @@
+import os
+import unittest
+from src.config.settings import DEFAULT_OUTPUT_FOLDER, ENABLE_PARALLEL_PROCESSING, LOG_LEVEL, SUPPORTED_FORMATS
+from src.core.metadata_utils import ensure_output_folder, copy_file_without_metadata, get_file_extension
+
+class TestSettingsAndUtils(unittest.TestCase):
+
+    def test_default_output_folder(self):
+        """Test if the default output folder is set correctly."""
+        self.assertEqual(DEFAULT_OUTPUT_FOLDER, "cleaned")
+
+    def test_parallel_processing_flag(self):
+        """Test if parallel processing flag is set correctly."""
+        self.assertTrue(isinstance(ENABLE_PARALLEL_PROCESSING, bool))
+
+    def test_log_level(self):
+        """Test if the log level is set to a valid value."""
+        valid_levels = ["DEBUG", "INFO", "WARNING", "ERROR"]
+        self.assertIn(LOG_LEVEL, valid_levels)
+
+    def test_supported_formats(self):
+        """Test if supported formats include key categories."""
+        self.assertIn("images", SUPPORTED_FORMATS)
+        self.assertIn("documents", SUPPORTED_FORMATS)
+        self.assertIn("audio", SUPPORTED_FORMATS)
+        self.assertIn("videos", SUPPORTED_FORMATS)
+
+    def test_ensure_output_folder(self):
+        """Test if ensure_output_folder creates the correct directory."""
+        test_folder = "test_output_folder"
+        ensure_output_folder(test_folder)
+        self.assertTrue(os.path.exists(test_folder))
+        os.rmdir(test_folder)  # Cleanup after test
+
+    def test_copy_file_without_metadata(self):
+        """Test if copy_file_without_metadata correctly copies a file."""
+        test_file = "test_original.txt"
+        copied_file = "test_copied.txt"
+
+        with open(test_file, "w") as f:
+            f.write("Test file content")
+
+        result = copy_file_without_metadata(test_file, copied_file)
+        self.assertTrue(os.path.exists(result))
+
+        # Cleanup
+        os.remove(test_file)
+        os.remove(copied_file)
+
+    def test_get_file_extension(self):
+        """Test if get_file_extension correctly extracts file extensions."""
+        self.assertEqual(get_file_extension("image.JPG"), ".jpg")
+        self.assertEqual(get_file_extension("document.PDF"), ".pdf")
+        self.assertEqual(get_file_extension("music.mp3"), ".mp3")
+
+if __name__ == "__main__":
+    unittest.main()