file-converter-tool 1.0.0

A powerful, open-source file converter supporting 15+ formats

🔄 Multi-Format File Converter

A powerful, open-source file converter supporting 15+ formats

Features • Installation • Usage • Supported Formats • Contributing

---

🌟 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

pip install file-converter

From source

git clone https://github.com/ab0jwad/file-converter.git
cd file-converter
pip install -e .

🚀 Usage

Command Line Interface

# 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

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

# 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 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 file for details.

🙏 Acknowledgments

• Open source community
• Contributors and users
• File format libraries and tools

📞 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Email: [e-mail]

---

⭐ Star this project on GitHub to support development!

Made with ❤️ by the File Converter Team