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>
