Equipment Controllers

Equipment Management Endpoints.

Provides functionality for CRUD operations on fitness equipment.

Creating, updating, and deleting equipment entries requires superuser privileges. Reading equipment data is available to all authenticated users.

async create_equipment(_: app.domain.users.schemas.UserAuth, schema_data: EquipmentCreate) → MsgSpecJSONResponse

Create a new equipment entry.

Requires superuser privileges.

Returns:

The created equipment data.

Return type:

EquipmentRead

Raises:

ConflictException – If equipment with the same name already exists.

async get_list_equipment(_: app.domain.users.schemas.UserAuth) → MsgSpecJSONResponse

Retrieve all equipment with filtering and sorting.

Returns:

A list of equipment items.

Return type:

list[EquipmentRead]

async get_equipment(_: app.domain.users.schemas.UserAuth, equipment_id: int) → MsgSpecJSONResponse

Get information about specific equipment.

Returns:

Detailed equipment data.

Return type:

EquipmentRead

Raises:

NotFoundException – If equipment with the given ID does not exist.

async update_equipment(_: app.domain.users.schemas.UserAuth, schema_data: EquipmentUpdate, equipment_id: int) → MsgSpecJSONResponse

Update information about specific equipment.

Requires superuser privileges.

Returns:

The updated equipment data.

Return type:

EquipmentRead

Raises:

• NotFoundException – If equipment with the given ID does not exist.

• ConflictException – If equipment with the same name already exists.

async delete_equipment(_: app.domain.users.schemas.UserAuth, equipment_id: int) → Response

Remove equipment from the system.

Requires superuser privileges.

Returns:

204 No Content on success.

Return type:

Response

Raises:

NotFoundException – If equipment with the given ID does not exist.