style: enforce PEP8 compliance and update documentation structure

CONTRIBUTING.md

@@ -0,0 +1,25 @@
+## 贡献指南
+欢迎贡献代码！为了确保项目的高质量和一致性，请遵循以下贡献规程：
+### 提交规范
+- 提交信息必须符合 Angular 提交信息规范，格式如下：
+  - `type(scope): description`
+  - 例如：`feat(user): 添加用户注册功能`
+### 与数据库、API 代码相关的更改
+- 请确保所有更改都经过严格的测试，并且不会引入新的错误。
+### 创建 Pull Request
+- 请确保创建 Pull Request 前进行本地测试，确保通过所有 CI/CD 测试。
+### 支持的 Type 列表
+
+| Type     | 描述                                                         |
+|----------|-------------------------------------------------------------|
+| feat     | 添加新功能，比如新增用户注册、功能扩展等                    |
+| fix      | 修复 bug 或错误，解决问题的修改                           |
+| docs     | 文档相关修改，如更新说明文档、README、注释等                 |
+| style    | 代码格式、标点、空格等修改，不影响代码逻辑运行                |
+| refactor | 代码重构，调整代码结构而不改变功能                          |
+| perf     | 性能优化修改，提升效率或降低资源消耗                        |
+| test     | 添加或更新测试代码，保证项目稳定性                         |
+| chore    | 杂项维护，如依赖更新、构建脚本修改，不涉及代码逻辑            |
+| ci       | 持续集成相关修改，如 GitHub Actions 工作流程优化              |
+---
+感谢您的贡献！

README.md

@@ -0,0 +1,123 @@
+<p align="center">
+    <img src="https://github.com/user-attachments/assets/7fcbb16b-577d-4de2-b1b0-23ec9b839f17" alt="embyBot logo" width=200 height=200 />
+</p>
+<h1 align="center">embyBot</h1>
+<p align="center">
+    <em>⚡ The next-generation emby management bot</em>
+</p>
+
+<p align="center">
+<a href="https://opensource.org/licenses/Apache-2.0">
+<img src="https://img.shields.io/github/license/embyplus/embyBot" alt="license">
+</a>
+<img src="https://img.shields.io/badge/python-3.10+-blue?logo=python&logoColor=edb641" alt="python">
+<a href="https://www.python.org/dev/peps/pep-0008/">
+<img src="https://img.shields.io/badge/code%20style-PEP%208-000000.svg?logo=python&logoColor=blue" alt="PEP 8">
+</a>
+<a href="https://codecov.io/gh/embyplus/embyBot">
+<img src="https://codecov.io/gh/embyplus/embyBot/branch/master/graph/badge.svg" alt="codecov"/>
+</a>
+<br />
+<a bref="https://github.com/astral-sh/ruff">
+<img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json" alt="ruff">
+</a>
+<a href="https://github.com/astral-sh/uv">
+<img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json" alt="uv">
+</a>
+<a href="https://results.pre-commit.ci/latest/github/nonebot/nonebot2/master">
+<img src="https://results.pre-commit.ci/badge/github/nonebot/nonebot2/master.svg" alt="pre-commit"  />
+</a>
+<a href="https://github.com/nonebot/nonebot2/actions/workflows/pyright.yml">
+<img src="https://github.com/nonebot/nonebot2/actions/workflows/pyright.yml/badge.svg?branch=master&event=push" alt="pyright">
+</a>
+<a href="https://github.com/nonebot/nonebot2/actions/workflows/ruff.yml">
+<img src="https://github.com/nonebot/nonebot2/actions/workflows/ruff.yml/badge.svg?branch=master&event=push" alt="ruff">
+</a>
+</p>
+
+> [!IMPORTANT]
+> ⭐️ Thanks **everyone** who has contributed to the project, it means a lot!
+
+## 📣 Introduction
+
+A Telegram bot for managing **Emby**, developed with **Pyrogram** and using **MySQL** as the database.
+
+## ✨ Features
+
+
+#### User Management:
+
+-   Create Emby users with invitation codes and assign default passwords and policies.
+-   Provide admin commands to disable/enable Emby accounts.
+-   View current user information (whitelist status, admin privileges, ban status, etc.).
+
+#### Invitation Code Management:
+
+-   Generate standard and whitelist invitation codes.
+-   Automatically update the database and relevant status after using an invitation code.
+
+#### Route Management:
+
+-   Integrate the routing service API to allow users to quickly switch playback routes through the bot.
+
+#### Other Features:
+
+-   View the current number of Emby media items.
+-   Support limited-time or limited-quantity registration.
+
+## 🔰 Installation
+
+1. Clone the repository:
+
+   ```bash
+   git clone https://github.com/embyplus/embyBot
+   ```
+
+2. Copy and edit the environment variables file:
+
+   ```bash
+   cp .env.example .env
+   vim .env
+   ```
+
+3. Sync dependency environment
+
+   ```bash
+   uv sync
+   ```
+
+4. Run the bot:
+
+   ```bash
+   uv run app.py
+   ```
+
+
+### ⛏ Code Quality
+
+### Unit Tests
+
+```shell
+$ Writing...
+```
+
+### Integration Tests
+
+Continuous integration with [Sourcery-ai](https://sourcery.ai//).
+
+### Code Standards
+
+Use [Ruff](https://docs.astral.sh/ruff/) and [Codecov](https://codecov.io/) to maintain code quality.
+
+## Contribution Guide
+
+Please refer to the [Contribution Guide](./CONTRIBUTING.md).
+
+## Acknowledgments
+- [Pyrogram](https://docs.pyrogram.org/) - Telegram API for Python
+- [SQLAlchemy](https://www.sqlalchemy.org/) - Python SQL Toolkit and Object-Relational Mapping
+- [Emby Management Bot by 小草](https://github.com/xiaocao666tzh/EmbyBot)
+
+## 🎡 Activities
+
+![Alt](https://repobeats.axiom.co/api/embed/079b23892e48f7b9e6be2f0cb2c66b2833eeffda.svg "Repobeats analytics image")

app.py

@@ -3,7 +3,11 @@
 from datetime import datetime
 
 import pytz
-from py_tools.connections.db.mysql import DBManager, BaseOrmTable, SQLAlchemyManager
+from py_tools.connections.db.mysql import (
+    DBManager,
+    BaseOrmTable,
+    SQLAlchemyManager,
+)
 from sqlalchemy import text
 from sqlalchemy.ext.asyncio import create_async_engine
 
@@ -15,6 +19,9 @@
 
 # Initialize logger
 logger = logging.getLogger(__name__)
+console_handler = logging.StreamHandler()
+console_handler.setLevel(logging.INFO)
+logger.addHandler(console_handler)
 
 
 async def create_database_if_not_exists() -> None:
@@ -97,7 +104,9 @@ async def setup_bot() -> BotClient:
 
 async def fetch_group_members(bot_client: BotClient) -> None:
     """获取群组成员并更新配置。"""
-    members_in_group = await bot_client.get_group_members(config.telegram_group_ids)
+    members_in_group = await bot_client.get_group_members(
+        config.telegram_group_ids
+    )
     for group_members in members_in_group.values():
         for telegram_id in group_members:
             config.group_members[telegram_id] = group_members[telegram_id]
@@ -123,7 +132,9 @@ async def main() -> None:
     emby_router_api = EmbyRouterAPI(config.api_url, config.api_key)
     command_handler = CommandHandler(
         bot_client=bot_client,
-        user_service=UserService(emby_api=emby_api, emby_router_api=emby_router_api),
+        user_service=UserService(
+            emby_api=emby_api, emby_router_api=emby_router_api
+        ),
     )
     logger.info("Emby API 和命令处理器初始化完成。")
 

bot/__init__.py

@@ -2,7 +2,11 @@
 
 from .bot_client import BotClient
 from .commands import CommandHandler
-from .filters import user_in_group_on_filter, admin_user_on_filter, emby_user_on_filter
+from .filters import (
+    user_in_group_on_filter,
+    admin_user_on_filter,
+    emby_user_on_filter,
+)
 from .message_helper import get_user_telegram_id
 from .utils import parse_iso8601_to_normal_date, parse_timestamp_to_normal_date