gukebox 1.0.0.dev6__tar.gz → 1.0.0.dev8__tar.gz

{gukebox-1.0.0.dev6 → gukebox-1.0.0.dev8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: gukebox
-Version: 1.0.0.dev6
+Version: 1.0.0.dev8
 Summary: A Jukebox to play music on speakers using 'CD' with NFC tag
 Keywords: jukebox,discstore,music,nfc
 Author: Gudsfile
@@ -58,8 +58,9 @@ Description-Content-Type: text/markdown
 
 # Jukebox \[gukebox\]
 
-[![python versions](https://img.shields.io/pypi/pyversions/gukebox.svg)](https://pypi.python.org/pypi/gukebox)
-[![gukebox last version](https://img.shields.io/pypi/v/gukebox.svg)](https://pypi.python.org/pypi/gukebox)
+![rpi](https://img.shields.io/badge/-Zero%202W%20%7C%203%20%7C%205-C51A4A?logo=raspberry-pi&label=RPi&logoColor=C51A4A&labcolor=C51A4A)
+[![python versions](https://img.shields.io/pypi/pyversions/gukebox.svg?logo=python)](https://pypi.python.org/pypi/gukebox)
+[![gukebox last version](https://img.shields.io/pypi/v/gukebox.svg?logo=pypi)](https://pypi.python.org/pypi/gukebox)
 [![license](https://img.shields.io/pypi/l/gukebox.svg)](https://pypi.python.org/pypi/gukebox)
 [![actions status](https://github.com/gudsfile/jukebox/actions/workflows/python.yml/badge.svg)](https://github.com/gudsfile/jukebox/actions)
 [![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
@@ -84,10 +85,9 @@ Description-Content-Type: text/markdown
 
 - [Install](#install)
 - [First steps](#first-steps)
-  - [Discstore](#manage-the-library-with-the-discstore)
 - [Usage](#usage)
-  - [Readers](#readers)
-  - [Players](#players)
+- [Readers](#readers)
+- [Players](#players)
 - [The library file](#the-library-file)
 - [Developer setup](#developer-setup)
 
@@ -216,16 +216,18 @@ Take a look at `library.example.json` and the [The library file](#the-library-fi
 Start the jukebox with the `jukebox` command (show help message with `--help`)
 
 ```shell
-jukebox PLAYER_TO_USE READER_TO_USE
+jukebox --player PLAYER --reader READER
 ```
 
 🎉 With choosing the `sonos` player and `pn532` reader, by approaching a NFC tag stored in the `library.json` file, you should hear the associated music begins.
 
-Optional Parameters
+**Optional Parameters**
 
 | Parameter | Description |
 | --- | --- |
 | `--help` | Show help message. |
+| `--player PLAYER` | Player to use (`sonos`, `dryrun`). |
+| `--reader READER` | Reader to use (`pn532`, `dryrun`). |
 | `--library` | Path to the library file, default: `~/.config/jukebox/library.json`. |
 | `--pause-delay SECONDS` | Grace period before pausing when the NFC tag is removed. Fractional values such as `0.5` or `0.2` are supported, with a minimum of `0.2` seconds to avoid pausing on brief missed reads. Default: 0.25 seconds. |
 | `--pause-duration SECONDS` | Maximum duration of a pause before resetting the queue. Default: 900 seconds (15 minutes). |
@@ -234,34 +236,23 @@ Optional Parameters
 
 ### Readers
 
-**Dry run** (`dryrun`)
-Read a text entry.
-Allows you to simulate reading an NFC tag by writting the tag id in the console.
-Expected syntax: `tag_id` or `tag_id duration_seconds`.
-- tag_id: the full identifier of the tag, in the format required by the system
-- duration_seconds: a non-negative number of seconds used to simulate how long the tag remains in place. Fractional values are allowed.
-Complete example: `your:tag:uid 2.5`
+| Name | Description |
+| --- | --- |
+| Dry Run (`dryrun`) | Simulates NFC tag reading via stdin. Input format: `tag_id` or `tag_id duration_seconds`. |
+| Pn532 NFC (`pn532`) | Reads physical NFC tags. Works with a **PN532** reader and **NTAG2xx** tags. Requires the `pn532` extra and SPI enabled on the Raspberry Pi. |
 
-**NFC Pn532** (`pn532`)
-Read an NFC tag and get its UID.
-This project works with an NFC reader like the **PN532** and NFC tags like the **NTAG2xx**.
-It is configured according to the [Waveshare PN532 wiki](https://www.waveshare.com/wiki/PN532_NFC_HAT).
-Don't forget to enable the SPI interface using the command `sudo raspi-config`, then go to: `Interface Options > SPI > Enable > Yes`.
+> [!NOTE]
+> See [docs/readers.md](docs/readers.md) for full setup, hardware requirements, and settings reference.
 
 ### Players
 
-**Dry run** (`dryrun`)
-Displays the events that a real speaker would have performed (`playing …`, `pause`, etc.).
-
-**Sonos** (`sonos`) [![SoCo](https://img.shields.io/badge/based%20on-SoCo-000)](https://github.com/SoCo/SoCo)
-Play music through a Sonos speaker.
-Three ways to select the speaker (mutually exclusive):
+| Name | Description |
+| --- | --- |
+| Dry Run (`dryrun`) | Displays the events that a real speaker would have performed (`playing …`, `pause`, etc.). |
+| Sonos (`sonos`) | [![SoCo](https://img.shields.io/badge/based%20on-SoCo-000)](https://github.com/SoCo/SoCo) Plays music through a Sonos speaker. Select by IP (`--sonos-host`), by name (`--sonos-name`), or let it auto-discover. |
 
-| Option | CLI flag | Environment variable | Behaviour |
-| --- | --- | --- | --- |
-| By IP | `--sonos-host 192.168.0.x` | `JUKEBOX_SONOS_HOST` | Connect directly, no discovery |
-| By name | `--sonos-name "Living Room"` | `JUKEBOX_SONOS_NAME` | Discover, then filter by name (case-sensitive) |
-| Auto | *(omit both)* | *(omit both)* | Discover, pick the first speaker alphabetically |
+> [!NOTE]
+> See [docs/players.md](docs/players.md) for the full configuration reference.
 
 ## The library file
 
@@ -341,9 +332,7 @@ uv sync
 
 Add `--all-extras` to install dependencies for all extras (`api` and `ui`).
 
-If needed, set `JUKEBOX_SONOS_HOST` (IP) or `JUKEBOX_SONOS_NAME` (speaker name) to select your Sonos speaker (see [Players](#players)).
-If neither is set, the jukebox will auto-discover a speaker on the network.
-To do this you can use a `.env` file and `uv run --env-file .env <command to run>`.
+If needed, you can use a `.env` file and `uv run --env-file .env <command to run>`.
 A `.env.example` file is available, you can copy it and modify it to use it.
 
 Create a `library.json` file and complete it with the desired NFC tags and CDs.
@@ -354,7 +343,7 @@ Take a look at `library.example.json` and the [The library file](#the-library-fi
 Start the jukebox with `uv` and use `--help` to show help message
 
 ```shell
-uv run jukebox PLAYER_TO_USE READER_TO_USE
+uv run jukebox --player PLAYER_TO_USE --reader READER_TO_USE
 ```
 
 Start the discstore `uv` and use `--help` to show help message
@@ -383,7 +372,7 @@ uv run --extra api discstore api
 uv run --extra ui discstore ui
 ```
 
-Other commands are available:
+### Development commands
 
 | Command | Description |
 | --- | --- |

{gukebox-1.0.0.dev6 → gukebox-1.0.0.dev8}/README.md

@@ -1,7 +1,8 @@
 # Jukebox \[gukebox\]
 
-[![python versions](https://img.shields.io/pypi/pyversions/gukebox.svg)](https://pypi.python.org/pypi/gukebox)
-[![gukebox last version](https://img.shields.io/pypi/v/gukebox.svg)](https://pypi.python.org/pypi/gukebox)
+![rpi](https://img.shields.io/badge/-Zero%202W%20%7C%203%20%7C%205-C51A4A?logo=raspberry-pi&label=RPi&logoColor=C51A4A&labcolor=C51A4A)
+[![python versions](https://img.shields.io/pypi/pyversions/gukebox.svg?logo=python)](https://pypi.python.org/pypi/gukebox)
+[![gukebox last version](https://img.shields.io/pypi/v/gukebox.svg?logo=pypi)](https://pypi.python.org/pypi/gukebox)
 [![license](https://img.shields.io/pypi/l/gukebox.svg)](https://pypi.python.org/pypi/gukebox)
 [![actions status](https://github.com/gudsfile/jukebox/actions/workflows/python.yml/badge.svg)](https://github.com/gudsfile/jukebox/actions)
 [![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
@@ -26,10 +27,9 @@
 
 - [Install](#install)
 - [First steps](#first-steps)
-  - [Discstore](#manage-the-library-with-the-discstore)
 - [Usage](#usage)
-  - [Readers](#readers)
-  - [Players](#players)
+- [Readers](#readers)
+- [Players](#players)
 - [The library file](#the-library-file)
 - [Developer setup](#developer-setup)
 
@@ -158,16 +158,18 @@ Take a look at `library.example.json` and the [The library file](#the-library-fi
 Start the jukebox with the `jukebox` command (show help message with `--help`)
 
 ```shell
-jukebox PLAYER_TO_USE READER_TO_USE
+jukebox --player PLAYER --reader READER
 ```
 
 🎉 With choosing the `sonos` player and `pn532` reader, by approaching a NFC tag stored in the `library.json` file, you should hear the associated music begins.
 
-Optional Parameters
+**Optional Parameters**
 
 | Parameter | Description |
 | --- | --- |
 | `--help` | Show help message. |
+| `--player PLAYER` | Player to use (`sonos`, `dryrun`). |
+| `--reader READER` | Reader to use (`pn532`, `dryrun`). |
 | `--library` | Path to the library file, default: `~/.config/jukebox/library.json`. |
 | `--pause-delay SECONDS` | Grace period before pausing when the NFC tag is removed. Fractional values such as `0.5` or `0.2` are supported, with a minimum of `0.2` seconds to avoid pausing on brief missed reads. Default: 0.25 seconds. |
 | `--pause-duration SECONDS` | Maximum duration of a pause before resetting the queue. Default: 900 seconds (15 minutes). |
@@ -176,34 +178,23 @@ Optional Parameters
 
 ### Readers
 
-**Dry run** (`dryrun`)
-Read a text entry.
-Allows you to simulate reading an NFC tag by writting the tag id in the console.
-Expected syntax: `tag_id` or `tag_id duration_seconds`.
-- tag_id: the full identifier of the tag, in the format required by the system
-- duration_seconds: a non-negative number of seconds used to simulate how long the tag remains in place. Fractional values are allowed.
-Complete example: `your:tag:uid 2.5`
+| Name | Description |
+| --- | --- |
+| Dry Run (`dryrun`) | Simulates NFC tag reading via stdin. Input format: `tag_id` or `tag_id duration_seconds`. |
+| Pn532 NFC (`pn532`) | Reads physical NFC tags. Works with a **PN532** reader and **NTAG2xx** tags. Requires the `pn532` extra and SPI enabled on the Raspberry Pi. |
 
-**NFC Pn532** (`pn532`)
-Read an NFC tag and get its UID.
-This project works with an NFC reader like the **PN532** and NFC tags like the **NTAG2xx**.
-It is configured according to the [Waveshare PN532 wiki](https://www.waveshare.com/wiki/PN532_NFC_HAT).
-Don't forget to enable the SPI interface using the command `sudo raspi-config`, then go to: `Interface Options > SPI > Enable > Yes`.
+> [!NOTE]
+> See [docs/readers.md](docs/readers.md) for full setup, hardware requirements, and settings reference.
 
 ### Players
 
-**Dry run** (`dryrun`)
-Displays the events that a real speaker would have performed (`playing …`, `pause`, etc.).
-
-**Sonos** (`sonos`) [![SoCo](https://img.shields.io/badge/based%20on-SoCo-000)](https://github.com/SoCo/SoCo)
-Play music through a Sonos speaker.
-Three ways to select the speaker (mutually exclusive):
+| Name | Description |
+| --- | --- |
+| Dry Run (`dryrun`) | Displays the events that a real speaker would have performed (`playing …`, `pause`, etc.). |
+| Sonos (`sonos`) | [![SoCo](https://img.shields.io/badge/based%20on-SoCo-000)](https://github.com/SoCo/SoCo) Plays music through a Sonos speaker. Select by IP (`--sonos-host`), by name (`--sonos-name`), or let it auto-discover. |
 
-| Option | CLI flag | Environment variable | Behaviour |
-| --- | --- | --- | --- |
-| By IP | `--sonos-host 192.168.0.x` | `JUKEBOX_SONOS_HOST` | Connect directly, no discovery |
-| By name | `--sonos-name "Living Room"` | `JUKEBOX_SONOS_NAME` | Discover, then filter by name (case-sensitive) |
-| Auto | *(omit both)* | *(omit both)* | Discover, pick the first speaker alphabetically |
+> [!NOTE]
+> See [docs/players.md](docs/players.md) for the full configuration reference.
 
 ## The library file
 
@@ -283,9 +274,7 @@ uv sync
 
 Add `--all-extras` to install dependencies for all extras (`api` and `ui`).
 
-If needed, set `JUKEBOX_SONOS_HOST` (IP) or `JUKEBOX_SONOS_NAME` (speaker name) to select your Sonos speaker (see [Players](#players)).
-If neither is set, the jukebox will auto-discover a speaker on the network.
-To do this you can use a `.env` file and `uv run --env-file .env <command to run>`.
+If needed, you can use a `.env` file and `uv run --env-file .env <command to run>`.
 A `.env.example` file is available, you can copy it and modify it to use it.
 
 Create a `library.json` file and complete it with the desired NFC tags and CDs.
@@ -296,7 +285,7 @@ Take a look at `library.example.json` and the [The library file](#the-library-fi
 Start the jukebox with `uv` and use `--help` to show help message
 
 ```shell
-uv run jukebox PLAYER_TO_USE READER_TO_USE
+uv run jukebox --player PLAYER_TO_USE --reader READER_TO_USE
 ```
 
 Start the discstore `uv` and use `--help` to show help message
@@ -325,7 +314,7 @@ uv run --extra api discstore api
 uv run --extra ui discstore ui
 ```
 
-Other commands are available:
+### Development commands
 
 | Command | Description |
 | --- | --- |

gukebox-1.0.0.dev8/discstore/adapters/inbound/api/__init__.py

@@ -0,0 +1,25 @@
+from discstore.adapters.inbound.api.current_tag_router import build_current_tag_router
+from discstore.adapters.inbound.api.discs_router import build_discs_router
+from discstore.adapters.inbound.api.models import (
+    CurrentTagDiscOutput,
+    CurrentTagStatusOutput,
+    DiscInput,
+    DiscOutput,
+    DiscPatchInput,
+    SettingsPatchInput,
+    SettingsResetInput,
+)
+from discstore.adapters.inbound.api.settings_router import build_settings_router
+
+__all__ = [
+    "CurrentTagDiscOutput",
+    "CurrentTagStatusOutput",
+    "DiscInput",
+    "DiscOutput",
+    "DiscPatchInput",
+    "SettingsPatchInput",
+    "SettingsResetInput",
+    "build_current_tag_router",
+    "build_discs_router",
+    "build_settings_router",
+]

gukebox-1.0.0.dev8/discstore/adapters/inbound/api/current_tag_router.py

@@ -0,0 +1,164 @@
+from typing import Any, Optional
+
+from fastapi import APIRouter, HTTPException, Response, status
+from pydantic import ValidationError
+
+from discstore.adapters.inbound.api.models import (
+    CurrentTagDiscOutput,
+    CurrentTagStatusOutput,
+    DiscInput,
+    DiscOutput,
+    DiscPatchInput,
+)
+from discstore.domain.entities import CurrentTagStatus, Disc, DiscMetadata, DiscOption
+from discstore.domain.use_cases.add_disc import AddDisc
+from discstore.domain.use_cases.edit_disc import EditDisc
+from discstore.domain.use_cases.get_current_tag_status import GetCurrentTagStatus
+from discstore.domain.use_cases.get_disc import GetDisc
+from discstore.domain.use_cases.remove_disc import RemoveDisc
+
+
+def build_current_tag_router(
+    get_current_tag_status: GetCurrentTagStatus,
+    add_disc: AddDisc,
+    edit_disc: EditDisc,
+    get_disc: GetDisc,
+    remove_disc: RemoveDisc,
+) -> APIRouter:
+    router = APIRouter(prefix="/api/v1", tags=["current-tag"])
+
+    def read_current_tag_status() -> Optional[CurrentTagStatus]:
+        return get_current_tag_status.execute()
+
+    def ensure_expected_tag_id_matches(
+        expected_tag_id: Optional[str], current_tag_status: Optional[CurrentTagStatus]
+    ) -> None:
+        if expected_tag_id is None:
+            return
+
+        actual_tag_id = None if current_tag_status is None else current_tag_status.tag_id
+        if actual_tag_id != expected_tag_id:
+            raise HTTPException(
+                status_code=409,
+                detail=f"Current tag changed: expected_tag_id='{expected_tag_id}', actual_tag_id={repr(actual_tag_id)}",
+            )
+
+    def build_current_tag_disc_output(tag_id: str, disc: Disc) -> CurrentTagDiscOutput:
+        return CurrentTagDiscOutput(tag_id=tag_id, disc=DiscOutput(**disc.model_dump()))
+
+    @router.get(
+        "/current-tag",
+        response_model=CurrentTagStatusOutput,
+        responses={204: {"description": "No current tag"}},
+        summary="Get the current NFC tag status",
+    )
+    def get_current_tag() -> Any:
+        current_tag_status = read_current_tag_status()
+        if current_tag_status is None:
+            return Response(status_code=204)
+
+        return CurrentTagStatusOutput(**current_tag_status.model_dump())
+
+    @router.get(
+        "/current-tag/disc",
+        response_model=CurrentTagDiscOutput,
+        responses={204: {"description": "No current tag"}, 404: {"description": "Current tag disc not found"}},
+        summary="Get the current tag disc",
+    )
+    def get_current_tag_disc() -> Any:
+        current_tag_status = read_current_tag_status()
+        if current_tag_status is None:
+            return Response(status_code=204)
+
+        if not current_tag_status.known_in_library:
+            raise HTTPException(status_code=404, detail=f"Tag does not exist: tag_id='{current_tag_status.tag_id}'")
+
+        return build_current_tag_disc_output(current_tag_status.tag_id, get_disc.execute(current_tag_status.tag_id))
+
+    @router.post(
+        "/current-tag/disc",
+        response_model=CurrentTagDiscOutput,
+        status_code=201,
+        responses={204: {"description": "No current tag"}, 409: {"description": "Current tag changed or disc exists"}},
+        summary="Create a disc for the current tag",
+    )
+    def create_current_tag_disc(
+        disc: DiscInput,
+        expected_tag_id: Optional[str] = None,
+    ) -> Any:
+        current_tag_status = read_current_tag_status()
+        ensure_expected_tag_id_matches(expected_tag_id, current_tag_status)
+        if current_tag_status is None:
+            return Response(status_code=204)
+
+        try:
+            new_disc = Disc(**disc.model_dump())
+            created_disc = add_disc.execute(current_tag_status.tag_id, new_disc)
+            return build_current_tag_disc_output(current_tag_status.tag_id, created_disc)
+        except ValueError as value_err:
+            raise HTTPException(status_code=409, detail=str(value_err))
+        except Exception as err:
+            raise HTTPException(status_code=500, detail=f"Server error: {str(err)}")
+
+    @router.patch(
+        "/current-tag/disc",
+        response_model=CurrentTagDiscOutput,
+        responses={
+            204: {"description": "No current tag"},
+            404: {"description": "Current tag disc not found"},
+            409: {"description": "Current tag changed"},
+        },
+        summary="Update the current tag disc",
+    )
+    def update_current_tag_disc(
+        disc_patch: DiscPatchInput,
+        expected_tag_id: Optional[str] = None,
+    ) -> Any:
+        current_tag_status = read_current_tag_status()
+        ensure_expected_tag_id_matches(expected_tag_id, current_tag_status)
+        if current_tag_status is None:
+            return Response(status_code=204)
+
+        try:
+            metadata = None
+            if disc_patch.metadata is not None:
+                metadata = DiscMetadata(**disc_patch.metadata.model_dump(exclude_unset=True))
+
+            option = None
+            if disc_patch.option is not None:
+                option = DiscOption(**disc_patch.option.model_dump(exclude_unset=True))
+
+            updated_disc = edit_disc.execute(current_tag_status.tag_id, disc_patch.uri, metadata, option)
+            return build_current_tag_disc_output(current_tag_status.tag_id, updated_disc)
+        except ValidationError as err:
+            raise HTTPException(status_code=422, detail=err.errors())
+        except ValueError as value_err:
+            raise HTTPException(status_code=404, detail=str(value_err))
+        except Exception as err:
+            raise HTTPException(status_code=500, detail=f"Server error: {str(err)}")
+
+    @router.delete(
+        "/current-tag/disc",
+        status_code=204,
+        responses={
+            204: {"description": "No current tag or disc deleted"},
+            404: {"description": "Current tag disc not found"},
+            409: {"description": "Current tag changed"},
+        },
+        summary="Delete the current tag disc",
+    )
+    def delete_current_tag_disc(expected_tag_id: Optional[str] = None) -> Response:
+        current_tag_status = read_current_tag_status()
+        ensure_expected_tag_id_matches(expected_tag_id, current_tag_status)
+        if current_tag_status is None:
+            return Response(status_code=status.HTTP_204_NO_CONTENT)
+
+        try:
+            remove_disc.execute(current_tag_status.tag_id)
+            return Response(status_code=status.HTTP_204_NO_CONTENT)
+        except ValueError as value_err:
+            raise HTTPException(status_code=404, detail=str(value_err))
+        except Exception as err:
+            raise HTTPException(status_code=500, detail=f"Server error: {str(err)}")
+
+    return router

gukebox-1.0.0.dev8/discstore/adapters/inbound/api/discs_router.py

@@ -0,0 +1,76 @@
+from typing import Dict
+
+from fastapi import APIRouter, HTTPException, Response, status
+from pydantic import ValidationError
+
+from discstore.adapters.inbound.api.models import DiscInput, DiscOutput, DiscPatchInput
+from discstore.domain.entities import Disc, DiscMetadata, DiscOption
+from discstore.domain.use_cases.add_disc import AddDisc
+from discstore.domain.use_cases.edit_disc import EditDisc
+from discstore.domain.use_cases.get_disc import GetDisc
+from discstore.domain.use_cases.list_discs import ListDiscs
+from discstore.domain.use_cases.remove_disc import RemoveDisc
+
+
+def build_discs_router(
+    add_disc: AddDisc,
+    list_discs: ListDiscs,
+    remove_disc: RemoveDisc,
+    edit_disc: EditDisc,
+    get_disc: GetDisc,
+) -> APIRouter:
+    router = APIRouter(prefix="/api/v1", tags=["discs"])
+
+    @router.get("/discs", response_model=Dict[str, DiscOutput], summary="List discs")
+    def list_discs_route() -> Dict[str, Disc]:
+        return list_discs.execute()
+
+    @router.get("/discs/{tag_id}", response_model=DiscOutput, summary="Get a disc")
+    def get_disc_route(tag_id: str) -> Disc:
+        try:
+            return get_disc.execute(tag_id)
+        except ValueError as value_err:
+            raise HTTPException(status_code=404, detail=str(value_err))
+        except Exception as err:
+            raise HTTPException(status_code=500, detail=f"Server error: {str(err)}")
+
+    @router.post("/discs/{tag_id}", response_model=DiscOutput, status_code=201, summary="Create a disc")
+    def create_disc_route(tag_id: str, disc: DiscInput) -> Disc:
+        try:
+            new_disc = Disc(**disc.model_dump())
+            return add_disc.execute(tag_id, new_disc)
+        except ValueError as value_err:
+            raise HTTPException(status_code=409, detail=str(value_err))
+        except Exception as err:
+            raise HTTPException(status_code=500, detail=f"Server error: {str(err)}")
+
+    @router.patch("/discs/{tag_id}", response_model=DiscOutput, summary="Update a disc")
+    def update_disc_route(tag_id: str, disc_patch: DiscPatchInput) -> Disc:
+        try:
+            metadata = None
+            if disc_patch.metadata is not None:
+                metadata = DiscMetadata(**disc_patch.metadata.model_dump(exclude_unset=True))
+
+            option = None
+            if disc_patch.option is not None:
+                option = DiscOption(**disc_patch.option.model_dump(exclude_unset=True))
+
+            return edit_disc.execute(tag_id, disc_patch.uri, metadata, option)
+        except ValidationError as err:
+            raise HTTPException(status_code=422, detail=err.errors())
+        except ValueError as value_err:
+            raise HTTPException(status_code=404, detail=str(value_err))
+        except Exception as err:
+            raise HTTPException(status_code=500, detail=f"Server error: {str(err)}")
+
+    @router.delete("/discs/{tag_id}", status_code=204, summary="Delete a disc")
+    def remove_disc_route(tag_id: str) -> Response:
+        try:
+            remove_disc.execute(tag_id)
+            return Response(status_code=status.HTTP_204_NO_CONTENT)
+        except ValueError as value_err:
+            raise HTTPException(status_code=404, detail=str(value_err))
+        except Exception as err:
+            raise HTTPException(status_code=500, detail=f"Server error: {str(err)}")
+
+    return router

gukebox-1.0.0.dev8/discstore/adapters/inbound/api/models.py

@@ -0,0 +1,48 @@
+from typing import Any, Dict, Optional
+
+from pydantic import BaseModel, RootModel
+
+from discstore.domain.entities import CurrentTagStatus, Disc
+
+
+class DiscInput(Disc):
+    pass
+
+
+class DiscOutput(Disc):
+    pass
+
+
+class DiscPatchMetadataInput(BaseModel):
+    artist: Optional[str] = None
+    album: Optional[str] = None
+    track: Optional[str] = None
+    playlist: Optional[str] = None
+
+
+class DiscPatchOptionInput(BaseModel):
+    shuffle: Optional[bool] = None
+    is_test: Optional[bool] = None
+
+
+class DiscPatchInput(BaseModel):
+    uri: Optional[str] = None
+    metadata: Optional[DiscPatchMetadataInput] = None
+    option: Optional[DiscPatchOptionInput] = None
+
+
+class CurrentTagStatusOutput(CurrentTagStatus):
+    pass
+
+
+class CurrentTagDiscOutput(BaseModel):
+    tag_id: str
+    disc: DiscOutput
+
+
+class SettingsResetInput(BaseModel):
+    path: str
+
+
+class SettingsPatchInput(RootModel[Dict[str, Any]]):
+    pass