783 B
783 B
Contributing
Development
- Create a virtual environment.
- Install dev dependencies:
pip install -e '.[dev]'. - Copy
.env.exampleto.envfor local-only settings. - Run tests:
pytest -q. - Run lint:
ruff check ..
Rules
- Keep provider adapters capability-driven.
- Do not add risky extraction/download/cache behavior unless it is explicitly gated, disabled by default, documented, and tested.
- Do not commit secrets, cookies, local domains, tokens, or real credentials.
- Add tests for auth, validation, policy, favorites/playlists, jobs, and search merge behavior when touching those areas.
API compatibility
The frontend contract is the OpenAPI schema at /openapi.json. Schema-affecting changes must update docs/API.en.md and docs/API.ru.md.