plain.code
Preconfigured code formatting and linting.
Overview
Plain.code provides comprehensive code quality tools with sensible defaults:
- Ruff - Python linting and formatting
- ty - Python type checking
- oxlint - JavaScript and TypeScript linting
- oxfmt - JavaScript, TypeScript, JSON, and CSS formatting
Ruff and ty are installed as Python dependencies. oxlint and oxfmt are managed automatically as standalone binaries (npm is not required).
Commands
plain fix
The most used command is plain fix, which automatically fixes linting issues and formats your code:
plain fix
You can also apply unsafe fixes or add noqa comments to suppress errors:
# Apply Ruff's unsafe fixes
plain fix --unsafe-fixes
# Add noqa comments instead of fixing
plain fix --add-noqa
plain code check
To check your code without making changes (including type checking):
plain code check
You can skip specific tools if needed:
# Skip type checking during rapid development
plain code check --skip-ty
# Only run type checks
plain code check --skip-ruff --skip-oxc
# Skip oxlint and oxfmt checks
plain code check --skip-oxc
# Skip annotation coverage checks
plain code check --skip-annotations
If plain.dev is installed, plain code check will be run automatically as a part of plain pre-commit to help catch issues before they are committed.
plain code annotations
Check the type annotation coverage of your codebase:
plain code annotations
This outputs a summary like 85.2% typed (23/27 functions).
To see which functions are missing annotations:
plain code annotations --details
You can also output the results as JSON for use in CI or other tools:
plain code annotations --json
Settings
Default configuration is provided by ruff_defaults.toml.
You can customize the behavior in your pyproject.toml:
[tool.plain.code]
exclude = ["path/to/exclude"]
[tool.plain.code.ty]
enabled = true # Set to false to disable ty
[tool.plain.code.oxc]
enabled = true # Set to false to disable oxlint/oxfmt
version = "1.43.0" # Pin to a specific version
[tool.plain.code.annotations]
enabled = true # Set to false to disable annotation checks
exclude = ["migrations"] # Exclude specific patterns
For more advanced configuration options, see get_code_config.
Generally you won't need to change the configuration. The defaults are designed to "just work" for most projects. If you find yourself needing extensive customization, consider using the underlying tools (Ruff, ty, oxlint, oxfmt) directly instead.
FAQs
How do I install or update oxlint/oxfmt manually?
oxlint and oxfmt are installed automatically when you run plain fix or plain code check. If you need to manage them manually:
# Install oxlint/oxfmt (or reinstall if corrupted)
plain code install
# Force reinstall even if up to date
plain code install --force
# Update to the latest version
plain code update
Why are test files excluded from annotation coverage?
Test files (test_*.py, *_test.py, and files in tests/ or test/ directories) are excluded by default because they typically contain many small helper functions where type annotations add noise without providing significant value. You can customize this behavior via the exclude option in the annotations configuration.
How do I check a specific directory?
All commands accept a path argument:
plain fix path/to/directory
plain code check path/to/directory
plain code annotations path/to/directory
Installation
Install the plain.code package from PyPI:
uv add plain.code
1 maintainer
Metadata
1 maintainer
Release files for plain.code 0.27.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| plain_code-0.27.0.tar.gz | 20.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| plain_code-0.27.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 45.0 kB
Release files / plain_code-0.27.0.tar.gz
| Download URL | plain_code-0.27.0.tar.gz |
|---|---|
| Size | 20.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a149a2b0e97bdf23e5ddfdc8073bba8190db92b61bf3711c0544f9cc3514ddc8
|
|
BLAKE2b-256 checksum How to use checksums |
7a9cdea03989c8e5cfa74cdd63db4972a7cf7e6d1ab55c191b15ddf311338b07
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / plain_code-0.27.0-py3-none-any.whl
| Download URL | plain_code-0.27.0-py3-none-any.whl |
|---|---|
| Size | 24.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3adeb5364f514676a6b58f80d8c7fcb762816222ec44261c4a0b5cc747c01d72
|
|
BLAKE2b-256 checksum How to use checksums |
3ceff5be1900875184d7898bd6312ee53908aae82322a85677434a0ab3c7a0b8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
