Metadata-Version: 2.4
Name: xpd
Version: 0.7.0
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Rust
Classifier: Topic :: Software Development :: Quality Assurance
License-File: LICENSE-MIT
License-File: LICENSE-APACHE
Summary: Fast, opinionated linter for Python library habits, starting with pandas and scikit-learn, for humans and coding agents
Keywords: pandas,python,linter,ast-grep,agents
Home-Page: https://snestra.github.io/xpd/
License-Expression: MIT OR Apache-2.0
Requires-Python: >=3.11
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Documentation, https://snestra.github.io/xpd/
Project-URL: Repository, https://github.com/Snestra/xpd

# xpd

xpd is a fast, opinionated linter for Python library habits that make code slow or wrong,
starting with pandas and scikit-learn. Each library gets one set of rules, written for its current
version. It fixes what it can, and it is built to run after every edit a coding agent makes.

```console
$ xpd check samples/bad.py
samples/bad.py:5:15: warning [pandas/row-loop] A loop over rows runs Python once per row. Compute on whole columns instead, such as df["a"] * df["w"].
samples/bad.py:6:5: error [pandas/chained-assignment] Chained assignment writes to a copy under copy-on-write, so the frame keeps its old values. Assign to df.loc[i, "a"] instead.
samples/bad.py:7:1: warning [pandas/no-inplace] inplace=True gives no speedup and blocks chaining. Reassign instead.
samples/bad.py:8:5: warning [pandas/merge-without-validate] merge without validate= can silently duplicate rows.
samples/bad.py:11:11: warning [pandas/concat-in-loop] Concatenating inside a loop is quadratic. Collect frames in a list, concat once.
xpd: 5 issues, 2 more with --fix --unsafe-fixes
```

## Install

```sh
uv tool install xpd   # or: uvx xpd check .
```

Before version 0.7.0 the package was `pdx-lint` and the command was `pdx`.

## Use

| Command | What it does |
| --- | --- |
| `xpd check [paths]` | Lint files and folders. Exit 1 on any error, 2 if xpd can't run. |
| `xpd check --fix` | Apply safe fixes, then lint. Add `--unsafe-fixes` to apply the rest. |
| `xpd profile data.csv` | Show dtypes, nulls, unique counts and memory per column. Needs pandas. |
| `xpd equiv old.py new.py` | Check that two scripts leave an equal `result`. Needs pandas. |
| `xpd graph features.py` | Print the dataflow of step code or Apache Hamilton modules: what reads what, and what does not connect. |
| `xpd hook` | Lint the file a Claude Code edit touched. |
| `xpd skill` | Print the agent skill for this version. |

Run `xpd -h` for every flag.

## Documentation

The full guide, including the Claude Code hook setup and how to write a rule, lives at
<https://snestra.github.io/xpd/>.

## License

MIT or Apache-2.0, at your choice.

