Персональное приложение для отслеживания тренировок с текстовым интерфейсом (TUI), построенное на базе Textual.

WorkoutApp позволяет фиксировать и отслеживать ваши тренировки в удобном текстовом интерфейсе. Приложение сохраняет данные о тренировках в JSON-файл и предоставляет статистику по выполненным упражнениям.

Экран ввода данных

Экран статистики

• Выбор типа тренировки: Push ups или Strengh set
• Статус тренировки: Отметка о том, была ли выполнена тренировка
• Комментарии: Опциональное поле для заметок к тренировке
• Валидация: Проверка обязательных полей перед сохранением

• Таблица тренировок: Просмотр всех записей с датой, статусом, типом и комментариями
• Статистика:
  • Общее количество выполненных тренировок
  • Количество тренировок по типам (Push ups, Strengh set)
• Сброс прогресса: Возможность полностью очистить данные (с подтверждением)

• Python >= 3.14
• uv - современный менеджер пакетов Python

Если у вас еще не установлен uv, установите его:

# macOS и Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

1. Клонируйте репозиторий (или перейдите в директорию проекта):

cd workoutapp

2. Установите зависимости с помощью uv:

uv sync

3. Запустите приложение:

uv run src_workout/app.py

workoutapp/
├── src_workout/
│ ├── app.py # Главный файл приложения
│ ├── entry_screen.py # Экран ввода данных о тренировках
│ ├── stats_screen.py # Экран статистики
│ ├── storage.py # Модуль для работы с данными (JSON)
│ ├── messages.py # Система сообщений между экранами
│ ├── app.tcss # Стили для Textual
│ └── workouts.json # Файл с данными (создается автоматически)
├── pyproject.toml # Конфигурация проекта и зависимости
├── uv.lock # Файл блокировки зависимостей
└── README.md # Документация

Данные сохраняются в файл src_workout/workouts.json в формате JSON. Структура записи:

{
 "workouts": [
 {
 "id": 1,
 "date": "2026年01月09日",
 "was_done": true,
 "type": "push_ups",
 "comment": "Комментарий к тренировке"
 }
 ]
}

• Python 3.14+ - язык программирования
• Textual - фреймворк для создания TUI приложений
• uv - менеджер пакетов и зависимостей
• ty - статический анализатор типов для проверки кода

uv sync --dev

Это установит дополнительные инструменты разработки, включая ruff для линтинга кода.

Код проекта проверяется с помощью ty - высокопроизводительного статического анализатора типов от Astral.

Для проверки типов в проекте выполните:

uv run ty check .

uv run ruff check .

Этот проект создан для личного использования.

Вклад в проект приветствуется! Если вы нашли баг или хотите предложить новую функцию, создайте issue или pull request.

Приятных тренировок! 💪