ST001: HasReadme
Overview
| Property | Value |
|---|---|
| ID | ST001 |
| Name | HasReadme |
| Group | structure |
| Severity | ERROR |
Description
Checks that a README file exists in the package root directory.
A README file is essential for any package as it provides:
- Project description and purpose
- Installation instructions
- Basic usage examples
- Links to documentation
What it checks
The check looks for any of these files in the package root:
README.mdREADME.rstREADME.txtREADME
How to fix
Create a README.md file in your package root:
# My Package
A brief description of what your package does.
## Installation
```bash
pip install my-packageUsage
import my_package
# Basic usage exampleLicense
MIT
## Configuration
### Skip this check
```toml
[tool.pycmdcheck]
skip = ["ST001"]
CLI
pycmdcheck --skip ST001