Exercise Management Controllers

Exercise Management Endpoints.

Provides functionality for CRUD operations on exercises. Distinguishes between user-defined custom exercises and system-wide defaults.

Creating, updating, and deleting system-default exercises requires superuser privileges.

async create_exercise(user_auth: app.domain.users.schemas.UserAuth, exercise_create: ExerciseCreate) → MsgSpecJSONResponse

Create a new exercise for the current user.

Returns:

The created exercise data.

Return type:

ExerciseRead

Raises:

ConflictException – If an exercise with the same name already exists for the user.

async create_system_exercise(_: app.domain.users.schemas.UserAuth, exercise_create: ExerciseCreateSystem) → MsgSpecJSONResponse

Create a new system exercise.

Requires superuser privileges.

Returns:

The created system exercise data.

Return type:

ExerciseRead

Raises:

ConflictException – If a similar exercise already exists in the system.

async get_exercise(user_auth: app.domain.users.schemas.UserAuth, exercise_id: UUID) → MsgSpecJSONResponse

Get details for a specific exercise by its ID.

Users can access their own exercises, system-default exercises, or exercises shared with them if they have the ‘trainer’ role.

Returns:

Detailed exercise data.

Return type:

ExerciseRead

Raises:

• NotFoundException – If the exercise is not found.

• PermissionDeniedException – If the user lacks access to the exercise.

async find_exercise(user_auth: app.domain.users.schemas.UserAuth = None) → MsgSpecJSONResponse

Find a user-defined or system exercise by name or slug.

Returns:

The found exercise data.

Return type:

ExerciseRead

Raises:

NotFoundException – If no exercise matches the criteria.

async get_list_exercises(user_auth: app.domain.users.schemas.UserAuth) → MsgSpecJSONResponse

Retrieve a paginated list of exercises based on filters.

Returns:

A paginated list of exercises.

Return type:

OffsetPagination[ExerciseRead]

async update_user_exercise(user_auth: app.domain.users.schemas.UserAuth, exercise_update: ExerciseUpdate, exercise_id: UUID) → MsgSpecJSONResponse

Update details for a specific user-defined exercise.

Returns:

The updated exercise data.

Return type:

ExerciseRead

Raises:

• NotFoundException – If the exercise is not found.

• ConflictException – If the new name conflicts with an existing exercise.

async update_system_exercise(_: app.domain.users.schemas.UserAuth, exercise_update: ExerciseUpdateSystem, exercise_id: UUID) → MsgSpecJSONResponse

Update details for a specific system exercise.

Requires superuser privileges.

Returns:

The updated system exercise data.

Return type:

ExerciseRead

Raises:

• NotFoundException – If the system exercise is not found.

• ConflictException – If the new name conflicts with an existing system exercise.

async delete_exercise(user_auth: app.domain.users.schemas.UserAuth, exercise_id: UUID) → Response

Delete a specific exercise by its ID.

Users can delete their own exercises. Requires superuser privileges to delete system exercises.

Returns:

204 No Content on successful deletion.

Return type:

Response

Raises:

• NotFoundException – If the exercise is not found.

• PermissionDeniedException – If the user lacks permission to delete the exercise.