Migrate from pip to uv

3.12

## Setup

```bash

python3 -m venv venv

source venv/bin/activate

pip install -r requirements.txt

```

Make sure you have `uv` installed.

## Run

ℹ️ This is completely risk-free, as it does not change files.

```bash

python3 -m karaokatalog.ui.serve $SONG_LIBRARY

uv run -m karaokatalog.ui.serve $SONG_LIBRARY

```

To speed up the start, use jsonification to create and persist a JSON of all songs in the library root dir before starting this UI.

**Create a bundle `.zip` file containg web app and data** that can be uploaded to any web hoster that can host static files.

```bash

python3 -m karaokatalog.ui.bundle $SONG_LIBRARY

uv run -m karaokatalog.ui.bundle $SONG_LIBRARY

```

### Deduplication

ℹ️ Deduplication is (mostly) risk-free: As it only deletes exact duplicates, you will not lose any data (given that I've made no programming errors, which is why the operation is only _mostly_ risk-free).

```bash

python3 -m karaokatalog.deduplicate $SONG_LIBRARY

uv run -m karaokatalog.deduplicate $SONG_LIBRARY

```

### Organization

ℹ️ Moving will not overwrite already existing files, the operation is therefore risk-free.

```bash

python3 -m karaokatalog.organize $SONG_LIBRARY

uv run -m karaokatalog.organize $SONG_LIBRARY

```

### Recoding

ℹ️ Deduplication is risk-reduced: We only change the encoding if we are reasonably certain our guessed encoding is correct. However, we could still make mistakes when detecting.

```bash

python3 -m karaokatalog.recode $SONG_LIBRARY

uv run -m karaokatalog.recode $SONG_LIBRARY

```

### Jsonification

ℹ️ This operation is risk-free: If a `songs.json` already exists, it is kept intact (so no data loss possible).

```bash

python3 -m karaokatalog.jsonify $SONG_LIBRARY

uv run -m karaokatalog.jsonify $SONG_LIBRARY

```

[project]

name = "karaokatalog"

version = "0.1.0"

readme = "README.md"

requires-python = ">=3.12"

dependencies = [

    "flask>=3.1.2",

    "tqdm>=4.67.1",

]

[tool.ruff.lint]

select = [

tqdm~=4.67.1