file-converter-tool 1.0.0__tar.gz

file_converter_tool-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Ab0jwad
+
+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.

file_converter_tool-1.0.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include requirements.txt
+include LICENSE
+include README.md

file_converter_tool-1.0.0/PKG-INFO

@@ -0,0 +1,203 @@
+Metadata-Version: 2.4
+Name: file-converter-tool
+Version: 1.0.0
+Summary: A powerful, open-source file converter supporting 15+ formats
+Home-page: https://github.com/ab0jwad/file-converter
+Author: Ab0jwad
+Author-email: ab0jwad@dev.com
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+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: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas>=2.0.0
+Requires-Dist: openpyxl>=3.1.0
+Requires-Dist: PyPDF2>=3.0.0
+Requires-Dist: python-docx>=0.8.11
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: Pillow>=10.0.0
+Requires-Dist: flask>=2.3.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: markdown>=3.5.0
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: pytest>=7.4.0
+Requires-Dist: pytest-cov>=4.1.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# 🔄 Multi-Format File Converter
+
+<div align="center">
+
+![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)
+![License](https://img.shields.io/badge/license-MIT-green.svg)
+![Python](https://img.shields.io/badge/python-3.8+-yellow.svg)
+
+**A powerful, open-source file converter supporting 15+ formats**
+
+[Features](#-features) • [Installation](#-installation) • [Usage](#-usage) • [Supported Formats](#-supported-formats) • [Contributing](#-contributing)
+
+</div>
+
+---
+
+## 🌟 Features
+
+- **Multi-Format Support**: Convert between 15+ file formats
+- **Batch Processing**: Convert multiple files at once
+- **Preserve Quality**: Maintain original formatting and quality
+- **CLI & GUI**: Command-line and web interface options
+- **Cross-Platform**: Works on Windows, macOS, and Linux
+- **Open Source**: Free and extensible
+
+## 📦 Installation
+
+### Using pip
+```bash
+pip install file-converter
+```
+
+### From source
+```bash
+git clone https://github.com/ab0jwad/file-converter.git
+cd file-converter
+pip install -e .
+```
+
+## 🚀 Usage
+
+### Command Line Interface
+```bash
+# Convert PDF to Word
+file-converter convert document.pdf --format docx --output converted.docx
+
+# Convert CSV to JSON
+file-converter convert data.csv --format json --output data.json
+
+# Batch convert all files in a directory
+file-converter batch ./input --output ./output --format json
+
+# List supported formats
+file-converter formats
+```
+
+### Python API
+```python
+from file_converter import FileConverter
+
+# Simple conversion
+converter = FileConverter()
+converter.convert('document.pdf', 'document.docx')
+
+# Batch conversion
+converter.convert_batch(['file1.csv', 'file2.csv'], format='json')
+
+# Get supported formats
+formats = converter.get_supported_formats()
+```
+
+## 📋 Supported Formats
+
+### 📄 Documents
+| From | To |
+|------|----|
+| PDF | Text (TXT) |
+| Word (DOCX) | Text (TXT) |
+| Text (TXT) | Word (DOCX), Markdown |
+
+### 📊 Data
+| From | To |
+|------|----|
+| CSV | JSON, XML, Excel (XLSX), YAML |
+| JSON | CSV, XML, YAML, HTML |
+| XML | JSON, CSV, YAML |
+| Excel (XLSX) | CSV, JSON, XML |
+| YAML | JSON, CSV, XML |
+
+### 🖼️ Images
+| From | To |
+|------|----|
+| PNG | JPG, WEBP |
+| JPG | PNG, WEBP |
+| WEBP | PNG, JPG |
+
+### 📝 Text & Code
+
+| From | To |
+|------|----|
+| Markdown | HTML, Text |
+| HTML | Markdown, Text |
+| Text (TXT) | Markdown, HTML |
+## 🔧 Requirements
+
+- Python 3.8 or higher
+- Dependencies listed in `requirements.txt`
+
+## 🧪 Testing
+
+```bash
+# Run all tests
+pytest
+
+# Run specific test
+pytest tests/test_converter.py -v
+
+# Test coverage
+pytest --cov=src tests/
+```
+
+## 🤝 Contributing
+
+We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 📝 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- Open source community
+- Contributors and users
+- File format libraries and tools
+
+## 📞 Support
+
+- **Issues**: [GitHub Issues](https://github.com/ab0jwad/file-converter/issues)
+- **Discussions**: [GitHub Discussions](https://github.com/ab0jwad/file-converter/discussions)
+- **Email**: support@fileconverter.dev
+
+---
+
+<div align="center">
+
+**⭐ Star this project on GitHub to support development!**
+
+[![GitHub stars](https://img.shields.io/github/stars/ab0jwad/file-converter.svg?style=social&label=Star)](https://github.com/ab0jwad/file-converter)
+
+Made with ❤️ by the File Converter Team
+
+</div>

file_converter_tool-1.0.0/README.md

@@ -0,0 +1,158 @@
+# 🔄 Multi-Format File Converter
+
+<div align="center">
+
+![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)
+![License](https://img.shields.io/badge/license-MIT-green.svg)
+![Python](https://img.shields.io/badge/python-3.8+-yellow.svg)
+
+**A powerful, open-source file converter supporting 15+ formats**
+
+[Features](#-features) • [Installation](#-installation) • [Usage](#-usage) • [Supported Formats](#-supported-formats) • [Contributing](#-contributing)
+
+</div>
+
+---
+
+## 🌟 Features
+
+- **Multi-Format Support**: Convert between 15+ file formats
+- **Batch Processing**: Convert multiple files at once
+- **Preserve Quality**: Maintain original formatting and quality
+- **CLI & GUI**: Command-line and web interface options
+- **Cross-Platform**: Works on Windows, macOS, and Linux
+- **Open Source**: Free and extensible
+
+## 📦 Installation
+
+### Using pip
+```bash
+pip install file-converter
+```
+
+### From source
+```bash
+git clone https://github.com/ab0jwad/file-converter.git
+cd file-converter
+pip install -e .
+```
+
+## 🚀 Usage
+
+### Command Line Interface
+```bash
+# Convert PDF to Word
+file-converter convert document.pdf --format docx --output converted.docx
+
+# Convert CSV to JSON
+file-converter convert data.csv --format json --output data.json
+
+# Batch convert all files in a directory
+file-converter batch ./input --output ./output --format json
+
+# List supported formats
+file-converter formats
+```
+
+### Python API
+```python
+from file_converter import FileConverter
+
+# Simple conversion
+converter = FileConverter()
+converter.convert('document.pdf', 'document.docx')
+
+# Batch conversion
+converter.convert_batch(['file1.csv', 'file2.csv'], format='json')
+
+# Get supported formats
+formats = converter.get_supported_formats()
+```
+
+## 📋 Supported Formats
+
+### 📄 Documents
+| From | To |
+|------|----|
+| PDF | Text (TXT) |
+| Word (DOCX) | Text (TXT) |
+| Text (TXT) | Word (DOCX), Markdown |
+
+### 📊 Data
+| From | To |
+|------|----|
+| CSV | JSON, XML, Excel (XLSX), YAML |
+| JSON | CSV, XML, YAML, HTML |
+| XML | JSON, CSV, YAML |
+| Excel (XLSX) | CSV, JSON, XML |
+| YAML | JSON, CSV, XML |
+
+### 🖼️ Images
+| From | To |
+|------|----|
+| PNG | JPG, WEBP |
+| JPG | PNG, WEBP |
+| WEBP | PNG, JPG |
+
+### 📝 Text & Code
+
+| From | To |
+|------|----|
+| Markdown | HTML, Text |
+| HTML | Markdown, Text |
+| Text (TXT) | Markdown, HTML |
+## 🔧 Requirements
+
+- Python 3.8 or higher
+- Dependencies listed in `requirements.txt`
+
+## 🧪 Testing
+
+```bash
+# Run all tests
+pytest
+
+# Run specific test
+pytest tests/test_converter.py -v
+
+# Test coverage
+pytest --cov=src tests/
+```
+
+## 🤝 Contributing
+
+We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 📝 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- Open source community
+- Contributors and users
+- File format libraries and tools
+
+## 📞 Support
+
+- **Issues**: [GitHub Issues](https://github.com/ab0jwad/file-converter/issues)
+- **Discussions**: [GitHub Discussions](https://github.com/ab0jwad/file-converter/discussions)
+- **Email**: support@fileconverter.dev
+
+---
+
+<div align="center">
+
+**⭐ Star this project on GitHub to support development!**
+
+[![GitHub stars](https://img.shields.io/github/stars/ab0jwad/file-converter.svg?style=social&label=Star)](https://github.com/ab0jwad/file-converter)
+
+Made with ❤️ by the File Converter Team
+
+</div>

file_converter_tool-1.0.0/requirements.txt

@@ -0,0 +1,12 @@
+pandas>=2.0.0
+openpyxl>=3.1.0
+PyPDF2>=3.0.0
+python-docx>=0.8.11
+PyYAML>=6.0
+Pillow>=10.0.0
+flask>=2.3.0
+click>=8.1.0
+markdown>=3.5.0
+beautifulsoup4>=4.12.0
+pytest>=7.4.0
+pytest-cov>=4.1.0

file_converter_tool-1.0.0/setup.cfg

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

file_converter_tool-1.0.0/setup.py

@@ -0,0 +1,43 @@
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+with open("requirements.txt", "r", encoding="utf-8") as fh:
+    requirements = [line.strip() for line in fh if line.strip() and not line.startswith("#")]
+
+setup(
+    name="file-converter-tool",
+    version="1.0.0",
+    author="Ab0jwad",
+    author_email="ab0jwad@dev.com",
+    description="A powerful, open-source file converter supporting 15+ formats",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/ab0jwad/file-converter",
+    packages=find_packages(where="src"),
+    package_dir={"": "src"},
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+        "Intended Audience :: End Users/Desktop",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+        "Topic :: Utilities",
+    ],
+    python_requires=">=3.8",
+    install_requires=requirements,
+    entry_points={
+        "console_scripts": [
+            "file-converter=file_converter.cli:main",
+        ],
+    },
+    include_package_data=True,
+    zip_safe=False,
+)

file_converter_tool-1.0.0/src/file_converter/__init__.py

@@ -0,0 +1,169 @@
+"""
+File Converter - Main Module
+Supports conversion between 15+ file formats
+"""
+
+import os
+from pathlib import Path
+from typing import Dict, List, Optional, Union
+
+from .converters.document import DocumentConverter
+from .converters.data import DataConverter
+from .converters.image import ImageConverter
+from .converters.text import TextConverter
+
+
+class FileConverter:
+    """Main file converter class supporting multiple formats"""
+    
+    def __init__(self):
+        """Initialize all converters"""
+        self.document_converter = DocumentConverter()
+        self.data_converter = DataConverter()
+        self.image_converter = ImageConverter()
+        self.text_converter = TextConverter()
+        
+        # Format mapping to appropriate converter
+        self.format_map = {
+            # Documents
+            'pdf': 'document',
+            'docx': 'document',
+            'doc': 'document',
+            'pptx': 'document',
+            'txt': 'text',
+            
+            # Data
+            'csv': 'data',
+            'json': 'data',
+            'xml': 'data',
+            'yaml': 'data',
+            'yml': 'data',
+            'xlsx': 'data',
+            'xls': 'data',
+            
+            # Images
+            'png': 'image',
+            'jpg': 'image',
+            'jpeg': 'image',
+            'webp': 'image',
+            'svg': 'image',
+            
+            # Text & Code
+            'md': 'text',
+            'html': 'text',
+            'rtf': 'text',
+        }
+    
+    def convert(self, input_file: Union[str, Path], 
+                output_file: Union[str, Path],
+                preserve_quality: bool = True) -> bool:
+        """
+        Convert a single file from one format to another
+        
+        Args:
+            input_file: Path to input file
+            output_file: Path to output file
+            preserve_quality: Whether to preserve quality (for images)
+            
+        Returns:
+            bool: True if conversion successful, False otherwise
+        """
+        input_path = Path(input_file)
+        output_path = Path(output_file)
+        
+        # Validate input file
+        if not input_path.exists():
+            raise FileNotFoundError(f"Input file not found: {input_file}")
+        
+        # Get input and output formats
+        input_format = input_path.suffix.lower().lstrip('.')
+        output_format = output_path.suffix.lower().lstrip('.')
+        
+        # Check if formats are supported
+        if input_format not in self.format_map:
+            raise ValueError(f"Unsupported input format: {input_format}")
+        
+        if output_format not in self.format_map:
+            raise ValueError(f"Unsupported output format: {output_format}")
+        
+        # Get appropriate converter
+        converter_type = self.format_map[input_format]
+        converter = getattr(self, f'{converter_type}_converter')
+        
+        # Perform conversion
+        try:
+            converter.convert(str(input_path), str(output_path))
+            return True
+        except Exception as e:
+            print(f"Conversion failed: {e}")
+            return False
+    
+    def convert_batch(self, input_files: List[Union[str, Path]],
+                     output_dir: Union[str, Path],
+                     output_format: str,
+                     preserve_quality: bool = True) -> Dict[str, bool]:
+        """
+        Convert multiple files in batch
+        
+        Args:
+            input_files: List of input file paths
+            output_dir: Directory for output files
+            output_format: Target format
+            preserve_quality: Whether to preserve quality
+            
+        Returns:
+            dict: Mapping of input files to conversion success status
+        """
+        output_path = Path(output_dir)
+        output_path.mkdir(parents=True, exist_ok=True)
+        
+        results = {}
+        for input_file in input_files:
+            input_path = Path(input_file)
+            output_file = output_path / f"{input_path.stem}.{output_format}"
+            
+            try:
+                success = self.convert(input_path, output_file, preserve_quality)
+                results[str(input_file)] = success
+            except Exception as e:
+                print(f"Failed to convert {input_file}: {e}")
+                results[str(input_file)] = False
+        
+        return results
+    
+    def get_supported_formats(self) -> Dict[str, List[str]]:
+        """
+        Get all supported formats organized by category
+        
+        Returns:
+            dict: Categories and their supported formats
+        """
+        return {
+            'documents': ['pdf', 'docx', 'doc', 'pptx', 'txt'],
+            'data': ['csv', 'json', 'xml', 'yaml', 'xlsx', 'xls'],
+            'images': ['png', 'jpg', 'jpeg', 'webp', 'svg'],
+            'text_code': ['md', 'html', 'rtf'],
+        }
+    
+    def get_conversion_matrix(self) -> Dict[str, List[str]]:
+        """
+        Get conversion matrix (what can convert to what)
+        
+        Returns:
+            dict: Source formats and possible target formats
+        """
+        return {
+            'pdf': ['txt'],
+            'docx': ['txt'],
+            'txt': ['docx', 'md', 'html'],
+            'csv': ['json', 'xml', 'xlsx', 'yaml'],
+            'json': ['csv', 'xml', 'yaml', 'html'],
+            'xml': ['json', 'csv', 'yaml'],
+            'xlsx': ['csv', 'json', 'xml'],
+            'yaml': ['json', 'csv', 'xml'],
+            'png': ['jpg', 'webp'],
+            'jpg': ['png', 'webp'],
+            'webp': ['png', 'jpg'],
+            'md': ['html', 'txt'],
+            'html': ['md', 'txt'],
+        }