sleepyconvert 2.2.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

Install the CLI globally with uv:

uv tool 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

Create the environment and install in editable mode with uv:

uv venv
uv pip install -e ".[dev]"

Then run uv run pytest, or ./tools/test.sh to exercise the CLI end to end. Tear down with 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