sleepyconvert 2.1.0

Convert data files, images, and documents between formats from a single terse CLI.

sleepyconvert

sleepyconvert is a succinct Typer-based CLI that converts data files, images, and documents between formats, inferring intent solely from the input and output extensions.

Supported conversions

• Data: csv, parquet, json, pkl, xlsx
• Images: png, jpg, jpeg
• Documents: html, pdf, md

Formats can only be converted within the same category.

Install

pip install sleepyconvert

Usage

sleepyconvert <input_path> <output_path>

The tool takes exactly two arguments — there is no subcommand. Both paths are resolved relative to the current working directory, and their extensions must belong to the same category.

sleepyconvert data.csv data.parquet
sleepyconvert report.md report.pdf
sleepyconvert photo.png photo.jpg
sleepyconvert --help

Development

python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

Then run pytest, or ./tools/test.sh to exercise the CLI end to end. Tear down with deactivate && rm -rf .venv.

Configuration

sleepyconvert is a sleepy util and reads shared settings from ~/sleepyconfig/params.yml. On first run the file is created with defaults and a note is printed to the console. Relevant key:

• convert_output_archive_dir — when set to a directory, every conversion also writes a dated copy of its output there as <archive_dir>/<yyyy>_<mm>_<dd>_<output_filename>. Leave as null to disable.

Documentation

• Specification — what the tool does
• Project outline — repository layout
• Test drive — setup, testing, and CLI usage
• Publishing — release to PyPI with Poetry