Convertions

The convertions project is a collection of Python scripts designed to convert between various file formats and extract content from different types of files. This toolset includes scripts for converting CSV, JSON, Excel, HTML, Markdown, YAML, PNG, JPG, PDF files, and more.

Table of Contents

• Installation
• Usage
  • CSV to Excel
  • CSV to JSON
  • Excel to CSV
  • HTML to Markdown
  • JSON to CSV
  • Markdown to HTML
  • YAML to Markdown
  • PNG to JPG
  • JPG to PNG
  • PDF to JPG
  • JPGs to PDF
  • Image to Markdown
  • PDF to Markdown
• Adding New Scripts
• Virtual Environment

Installation

1. Clone the Repository:

   git clone https://github.com/yourusername/convertions.git
   cd convertions
   

2. Set Up the Virtual Environment:

   python3 -m venv venv
   source venv/bin/activate
   

3. Install Dependencies:

   pip install -r requirements.txt
   

4. Add the Convertions Directory to PATH:

   • For Bash:

     echo 'export PATH="$HOME/codeWS/Python3/convertions:$PATH"' >> ~/.bashrc
     source ~/.bashrc
     

   • For Zsh:

     echo 'export PATH="$HOME/codeWS/Python3/convertions:$PATH"' >> ~/.zshrc
     source ~/.zshrc
     

Usage

CSV to Excel

Convert a CSV file to an Excel file.

convertions csvtoexcel <input_csv_path> <output_excel_path>

CSV to JSON

Convert a CSV file to a JSON file.

convertions csvtojson <input_csv_path> <output_json_path>

Excel to CSV

Convert an Excel file to a CSV file.

convertions excelto_csv <input_excel_path> <output_csv_path>

HTML to Markdown

Convert an HTML file to a Markdown file.

convertions htmltomd <input_html_path> <output_md_path>

JSON to CSV

Convert a JSON file to a CSV file.

convertions jsontocsv <input_json_path> <output_csv_path>

Markdown to HTML

Convert a Markdown file to an HTML file.

convertions mdtohtml <input_md_path> <output_html_path>

YAML to Markdown

Convert a YAML file to a Markdown file.

convertions yamltomd <input_yaml_path> <output_md_path>

PNG to JPG

Convert a PNG image to a JPG image.

convertions pngtojpg <input_png_path> <output_jpg_path>

JPG to PNG

Convert a JPG image to a PNG image.

convertions jpgtopng <input_jpg_path> <output_png_path>

PDF to JPG

Convert a PDF file to JPG images (one per page).

convertions pdftojpg <input_pdf_path> <output_jpg_path>

JPGs to PDF

Combine multiple JPG images into a single PDF file.

convertions jpgstopdf <output_pdf_path> <input_jpg_path1> <input_jpg_path2> ...

Image to Markdown

Extract text content from an image (JPG/PNG) using OCR and convert it to a Markdown file.

convertions imagetomd <input_image_path> <output_md_path>

PDF to Markdown

Extract text content from a PDF file and convert it to a Markdown file.

convertions pdftomd <input_pdf_path> <output_md_path>

Adding New Scripts

To add a new script to the convertions toolset:

1. Place the new script in the `~/codeWS/Python3/convertions` directory.
2. Ensure the script is executable:

   chmod +x ~/codeWS/Python3/convertions/new_script.py
   

3. Update `convertions.py` to include the new command and map it to the script.

Virtual Environment

The convertions toolset uses a virtual environment to manage dependencies. Ensure the virtual environment is activated before running any scripts:

source venv/bin/activate

To deactivate the virtual environment, use:

deactivate

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Pillow
• PyMuPDF
• pytesseract