Read Together

Сайт для учета прогресса чтения FB2- и EPUB-книг, личной библиотеки и совместного чтения с другими пользователями.

Возможности

• простая регистрация и вход;
• загрузка книг в формате FB2 и EPUB;
• автоматическое построение оглавления из body/section/title для FB2, nav.xhtml/toc.ncx для EPUB или структуры spine, если оглавление не найдено;
• извлечение названия, автора, описания и обложки книги;
• отметка прочитанных глав и текущей главы;
• массовая отметка всех глав прочитанными или непрочитанными;
• поиск, сортировка и переключение отображения библиотеки;
• управление своими книгами и выход из совместных книг;
• настройки профиля: смена имени пользователя и загрузка аватара;
• приглашение пользователей в совместное чтение;
• принятие и отклонение приглашений;
• общая страница прогресса участников;
• удаление участников из своей книги.

Запуск

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
uvicorn src.main:app --reload

После запуска сайт будет доступен на http://127.0.0.1:8000.

База SQLite создается автоматически по пути из READ_TOGETHER_DATABASE_URL. Переменные окружения можно задать в .env, он подхватывается при старте приложения.

Переменные окружения

• READ_TOGETHER_DATABASE_URL — путь к SQLite, например sqlite:///read_together.sqlite3.
• READ_TOGETHER_SESSION_COOKIE — имя cookie сессии, по умолчанию session_token.
• READ_TOGETHER_SESSION_MAX_AGE — время жизни cookie в секундах, по умолчанию 2592000.

Тесты

python3 -m pytest