mirror of
https://github.com/vinta/awesome-python.git
synced 2026-03-24 01:24:43 +08:00
7d1007d373
Reword the overview from 'curated list' to 'opinionated list' to better reflect editorial intent. Rename 'pypi-name' placeholder to 'project-name' and add a rule for projects not published on PyPI. Co-Authored-By: Claude <noreply@anthropic.com>
38 lines
1.5 KiB
Markdown
38 lines
1.5 KiB
Markdown
# CLAUDE.md
|
|
|
|
## Repository Overview
|
|
|
|
An opinionated list of Python frameworks, libraries, tools, and resources. Published at [awesome-python.com](https://awesome-python.com/).
|
|
|
|
## PR Review Guidelines
|
|
|
|
**Refer to [CONTRIBUTING.md](CONTRIBUTING.md)** for acceptance criteria, quality requirements, rejection rules, and entry format.
|
|
|
|
## Structure
|
|
|
|
- **README.md**: Source of truth. Hierarchical categories with alphabetically ordered entries.
|
|
- **CONTRIBUTING.md**: Submission guidelines and review criteria.
|
|
- **website/**: Static site generator that builds awesome-python.com from README.md.
|
|
- `build.py`: Parses README.md and renders HTML via Jinja2 templates.
|
|
- `fetch_github_stars.py`: Fetches star counts into `website/data/`.
|
|
- `readme_parser.py`: Markdown-to-structured-data parser.
|
|
- `templates/`, `static/`: Jinja2 templates and CSS/JS assets.
|
|
- `tests/`: Pytest tests for the build pipeline.
|
|
- **Makefile**: `make install`, `make build`, `make preview`, `make test`, `make fetch_github_stars`.
|
|
- **pyproject.toml**: Uses `uv` for dependency management. Python >=3.13.
|
|
|
|
## Entry Format
|
|
|
|
```markdown
|
|
- [project-name](https://github.com/owner/repo) - Description ending with period.
|
|
```
|
|
|
|
Use PyPI package name as display name. If not on PyPI, use the GitHub repo name. Use GitHub URLs when available.
|
|
|
|
## Key Rules
|
|
|
|
- Alphabetical ordering within categories is mandatory.
|
|
- Quality over quantity. Only "awesome" projects.
|
|
- One project per PR.
|
|
- README.md is the single source of content truth.
|