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.md
  • README.rst
  • README.txt
  • README

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-package

Usage

import my_package
# Basic usage example

License

MIT


## Configuration

### Skip this check

```toml
[tool.pycmdcheck]
skip = ["ST001"]

CLI

pycmdcheck --skip ST001