Skip to main content

xpd

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

$ xpd check samples/bad.py
samples/bad.py:5:15: warning [pandas/row-loop] iterrows() builds a Series for every row. Compute on whole columns instead, such as df["a"] * df["w"]. When each row has to become a Python object, loop over itertuples() or to_dict("records").
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: info [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:5: warning [pandas/concat-in-loop] out grows by one concat per pass, and each concat copies every earlier row. Collect the frames in a list and concat once after the loop.
xpd: 5 issues, 2 more with --fix --unsafe-fixes

Install

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.

Skills

Three Agent Skills live in skills/. The two Python skills hold the style that a linter cannot check. They work without xpd, and they run it when it is installed.

Skill What it does
xpd When to run each xpd command. xpd skill prints it for the installed version.
python-best-practices The rules an agent follows when it writes or changes Python.
python-review Reviews a file, package or diff, and cites the rule for every finding.
npx skills add bjoernaagaard/xpd

Documentation

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

License

MIT or Apache-2.0, at your choice.

Metadata

Release files for xpd 0.12.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for xpd 0.12.0
File Size Uploaded Provenance Actions
xpd-0.12.0.tar.gz 264.4 kB Without provenance Details for xpd-0.12.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for xpd 0.12.0
File Actions
xpd-0.12.0-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details for xpd-0.12.0-py3-none-win_arm64.whl
xpd-0.12.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for xpd-0.12.0-py3-none-win_amd64.whl
xpd-0.12.0-py3-none-musllinux_1_2_x86_64.whl Python 3 none Linux musl 1.2+ x86-64 Details for xpd-0.12.0-py3-none-musllinux_1_2_x86_64.whl
xpd-0.12.0-py3-none-musllinux_1_2_aarch64.whl Python 3 none Linux musl 1.2+ ARM64 Details for xpd-0.12.0-py3-none-musllinux_1_2_aarch64.whl
xpd-0.12.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details for xpd-0.12.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
xpd-0.12.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details for xpd-0.12.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
xpd-0.12.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for xpd-0.12.0-py3-none-macosx_11_0_arm64.whl
xpd-0.12.0-py3-none-macosx_10_12_x86_64.whl Python 3 none macOS 10.12+ x86-64 Details for xpd-0.12.0-py3-none-macosx_10_12_x86_64.whl

Total release size: 20.3 MB

Release files / xpd-0.12.0.tar.gz

Download URL xpd-0.12.0.tar.gz
Size 264.4 kB
Tags Source
SHA-256 checksum
How to use checksums
8f08473338e471777b88bebcc54cdd58e5580ad1e0be28af761e90aeec5693ee
BLAKE2b-256 checksum
How to use checksums
0a7771d0276bea754e10b996f008898240a90313cdd5220ea8247e72c631ebaa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","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 / xpd-0.12.0-py3-none-win_arm64.whl

Download URL xpd-0.12.0-py3-none-win_arm64.whl
Size 2.4 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
4e3298fdfed8939fc1a1db9246af8920523dc2e20689a21c9abeab37e15877b8
BLAKE2b-256 checksum
How to use checksums
8fcc117f903b8b546c4e271473b2ba5b1a4633981ebacf8f0e53bc3c7451c639
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","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 / xpd-0.12.0-py3-none-win_amd64.whl

Download URL xpd-0.12.0-py3-none-win_amd64.whl
Size 2.6 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
d0627330152b508dee3191ef91438d3993b38d348e73cf7cf90f7cb2a72db148
BLAKE2b-256 checksum
How to use checksums
3add1ac23aef0ade28e74d74aa19e1792166646d166fbbf6faef37bcfc6251fe
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","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 / xpd-0.12.0-py3-none-musllinux_1_2_x86_64.whl

Download URL xpd-0.12.0-py3-none-musllinux_1_2_x86_64.whl
Size 2.7 MB
Tags Linux musl 1.2+ x86-64 Python 3
SHA-256 checksum
How to use checksums
4500ca33ea1b16d82c832e7132934575efff8e699eadf077b669f9d675c1a7a0
BLAKE2b-256 checksum
How to use checksums
ad9ff4ede3ff101c3b4ebee96b59334199c37c4b9cc939bcd0b76ed29255a572
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","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 / xpd-0.12.0-py3-none-musllinux_1_2_aarch64.whl

Download URL xpd-0.12.0-py3-none-musllinux_1_2_aarch64.whl
Size 2.4 MB
Tags Linux musl 1.2+ ARM64 Python 3
SHA-256 checksum
How to use checksums
fa868af0ae86d3887bdb36abf53aabd6c0313524e422839f848afb0b6b4d4ca1
BLAKE2b-256 checksum
How to use checksums
e2ae5ad1689fdf15512529a8865fc93d658b1f50acd3c1bd974f62d9c56c4d49
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","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 / xpd-0.12.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL xpd-0.12.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 2.6 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
bd9b77fba7c6fe63599e372af75e323358e81bfa7167bc6f3bf0b20a2451e36d
BLAKE2b-256 checksum
How to use checksums
0977c09e905d4ecaa66eeda2b2c7c0ccdcee2e4c32d7c808ca81b9fdb0f8709c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","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 / xpd-0.12.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL xpd-0.12.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 2.4 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
201bcec804b53a2353dc5bee363e488fd114da163ced8af2a431f75978778244
BLAKE2b-256 checksum
How to use checksums
6b64c2ece26a9d9b03896c3d77142ed2fdc85f785a9058be55b730d42ad74b42
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","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 / xpd-0.12.0-py3-none-macosx_11_0_arm64.whl

Download URL xpd-0.12.0-py3-none-macosx_11_0_arm64.whl
Size 2.4 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
8f872197461ef885af7ff872a44888697efd483dd27d08e13d3aab4514e198ff
BLAKE2b-256 checksum
How to use checksums
868a520480112c103f3e05ee6ffbca7b1da94d31170cb3afb4f0462383e5cf0c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","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 / xpd-0.12.0-py3-none-macosx_10_12_x86_64.whl

Download URL xpd-0.12.0-py3-none-macosx_10_12_x86_64.whl
Size 2.5 MB
Tags Python 3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
fc8b2fb654f0562280f29230d7ae42c92d25e877c054a0dd03d8b16ef2f85a3a
BLAKE2b-256 checksum
How to use checksums
3274e60dda29011a61859bf2e0e1acd0b90fbc8c52e91830a167255b85551c1e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","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}

Security for xpd 0.12.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.12.0 This release

9 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page