Skip to main content

xpd

xpd checks Python code for slow operations and wrong results. It checks code that uses pandas, NumPy, SciPy, scikit-learn or Apache Hamilton. xpd can rewrite many of the lines it reports, and a coding agent can run it after every edit.

What xpd reports

samples/bad.py holds slow loops and pandas assignments that write to a copy. The diff below shows what xpd check samples/bad.py --fix --unsafe-fixes changes. Each comment names the rule that reports the line.

 import pandas as pd

 df = pd.DataFrame({"a": [1, 2], "k": [1, 2]})
 other = df.copy()
 for i, row in df.iterrows():           # warning  pandas/row-loop
-    df["a"][i] = row["a"] * 2          # error    pandas/chained-assignment
+    df.loc[i, "a"] = row["a"] * 2
-df.dropna(inplace=True)                # info     pandas/no-inplace
+df = df.dropna()
 m = pd.merge(df, other, on="k")        # warning  pandas/merge-without-validate
 out = pd.DataFrame()
 for f in ["x.csv"]:
     out = pd.concat([out, pd.read_csv(f)])  # warning  pandas/concat-in-loop

Each message says what goes wrong and what to write instead.

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.

An issue has one of three severities, and a fix is either safe or unsafe.

Word Meaning
error The code gives a wrong result or raises. Fix it.
warning The code is slow or easy to get wrong. Fix it unless you can say why it is right here.
info A shorter or newer form exists.
safe fix Keeps what the code does. --fix writes it.
unsafe fix May change what the code does. --fix --unsafe-fixes writes it, so read the diff afterwards.

Rules

Each library has one pack of rules, written for the library's current version. A library's pack runs only on files that import the library. The Python pack runs on every file.

Pack One of its rules What the rule reports
pandas chained-assignment df["a"][i] = v writes to a copy, so the frame keeps its old values
NumPy append-flattens np.append without axis flattens both arrays
SciPy removed-keyword tol= on the sparse iterative solvers was removed and raises TypeError
scikit-learn fit-on-test A fit on the test rows makes the score on those rows useless
Hamilton node-mutates-input A node writes to one of its parameters, and Hamilton hands the same object to other nodes
Python dict-str-any dict[str, Any] in a signature hides the keys the function uses

xpd rules lists every rule, and the rules page shows each one with code before and after.

Install

uv tool install xpd

uvx xpd check . runs it once without an install.

Commands

xpd
├── check [paths]          lint files and folders, and rewrite with --fix
├── rules                  list every rule with its documentation
├── graph <files>          print the dataflow of step code or Hamilton modules
├── profile <data file>    print dtypes, nulls, unique counts and memory per column
├── equiv old.py new.py    run two scripts and compare the `result` each one leaves
├── hook                   lint the file that a Claude Code edit touched
├── mcp                    start the MCP server
└── skill                  print the agent skill for this version

check, rules and graph read the files and start no Python. profile and equiv run the project's Python and need pandas there. xpd <command> -h lists the flags of a command. The commands page explains the output and the exit codes.

Use with a coding agent

An agent can use xpd through a hook, through an MCP server and through skills.

Way What the agent gets Setup
Hook The issues of each file, right after the edit xpd hook in the Claude Code settings
MCP server Typed tools, the rules, the skills and prompts xpd mcp
Skills When to run each command, and Python style that a linter cannot check npx skills add bjoernaagaard/xpd

Hook

After each edit to a .py file, Claude Code sends the edit to xpd hook. When xpd finds issues, Claude Code shows them to the agent in the same turn.

Claude Code edits features.py
└── the PostToolUse hook runs xpd hook
    ├── no issues: exit code 0
    └── issues: exit code 2
        └── Claude Code shows the issues to the agent

Add the hook to .claude/settings.json in your project.

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [{ "type": "command", "command": "xpd hook" }]
      }
    ]
  }
}

MCP server

xpd mcp starts an MCP server, so an agent calls xpd through typed tools and needs no shell. The server needs the mcp extra, and the command below installs it and adds the server to Claude Code.

claude mcp add xpd -- uvx --from 'xpd[mcp]' xpd mcp
xpd mcp
├── tools
│   ├── check, fix                 lint, and write fixes after the user confirms unsafe ones
│   ├── graph, profile, equiv      the commands of the same names
│   ├── rules, rule                list the rules, and read one with its examples
│   └── show_issues, show_dataflow, show_columns    tables and a chart, in hosts that draw them
├── resources
│   ├── xpd://rules/{package}/{rule}    one rule's documentation
│   └── skill://<name>/SKILL.md         each skill that ships with xpd
└── prompts
    └── lint_and_fix, review, refactor_data_logic, add_to_dataflow

The server takes every rule and every result from the xpd binary, so it matches the installed version. The MCP page covers other clients, the settings and HTTP.

Skills

The repository includes Agent Skills in skills/. The Python skills work without xpd. They also run xpd when it is installed.

Skill What it does
xpd Says when to run each xpd command. xpd skill prints it for the installed version.
python-best-practices Holds 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 is at https://bjoernaagaard.github.io/xpd/. It also explains how to write a rule.

License

You may use xpd under the MIT license or the Apache-2.0 license.

Metadata

Release files for xpd 0.13.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.13.0
File Size Uploaded Provenance Actions
xpd-0.13.0.tar.gz 351.8 kB Without provenance Details for xpd-0.13.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for xpd 0.13.0
File Actions
xpd-0.13.0-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details for xpd-0.13.0-py3-none-win_arm64.whl
xpd-0.13.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for xpd-0.13.0-py3-none-win_amd64.whl
xpd-0.13.0-py3-none-musllinux_1_2_x86_64.whl Python 3 none Linux musl 1.2+ x86-64 Details for xpd-0.13.0-py3-none-musllinux_1_2_x86_64.whl
xpd-0.13.0-py3-none-musllinux_1_2_aarch64.whl Python 3 none Linux musl 1.2+ ARM64 Details for xpd-0.13.0-py3-none-musllinux_1_2_aarch64.whl
xpd-0.13.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.13.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
xpd-0.13.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details for xpd-0.13.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
xpd-0.13.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for xpd-0.13.0-py3-none-macosx_11_0_arm64.whl
xpd-0.13.0-py3-none-macosx_10_12_x86_64.whl Python 3 none macOS 10.12+ x86-64 Details for xpd-0.13.0-py3-none-macosx_10_12_x86_64.whl

Total release size: 21.2 MB

Release files / xpd-0.13.0.tar.gz

Download URL xpd-0.13.0.tar.gz
Size 351.8 kB
Tags Source
SHA-256 checksum
How to use checksums
5eb918142e4af6538dfc2f607519c332e0181290b8084e2bea43e7b2466d6e52
BLAKE2b-256 checksum
How to use checksums
b0d203be4c7cbd97de6c8cf4e027aa6a1508e167b8c3847cdb9a9aff57e79291
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.13.0-py3-none-win_arm64.whl

Download URL xpd-0.13.0-py3-none-win_arm64.whl
Size 2.5 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
f9da0065af251da9487a9542d2fe29ada802050207ea06f1f8ac1c2ee202aef5
BLAKE2b-256 checksum
How to use checksums
23a78183b5f0999c543a59b523c04544b92df0005e23bdafb7dcc6981e65a444
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.13.0-py3-none-win_amd64.whl

Download URL xpd-0.13.0-py3-none-win_amd64.whl
Size 2.7 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
f4bbe6a44d67ab2b91e39a3d0102badbd21a842a5a37776e53acc1ec5765db58
BLAKE2b-256 checksum
How to use checksums
b3b7a426359fd754c3455b119243943a944160e84f44fc90f73998595611b297
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.13.0-py3-none-musllinux_1_2_x86_64.whl

Download URL xpd-0.13.0-py3-none-musllinux_1_2_x86_64.whl
Size 2.8 MB
Tags Linux musl 1.2+ x86-64 Python 3
SHA-256 checksum
How to use checksums
04165bd07558cd61e61ba6dab90bcecd21b2d4263ca4a6d743d0213a0bafa80c
BLAKE2b-256 checksum
How to use checksums
66e8c94b80dc9ad11e4e3f5046182a6511d3c7b30eac2a381ea5b782b5afc2b8
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.13.0-py3-none-musllinux_1_2_aarch64.whl

Download URL xpd-0.13.0-py3-none-musllinux_1_2_aarch64.whl
Size 2.5 MB
Tags Linux musl 1.2+ ARM64 Python 3
SHA-256 checksum
How to use checksums
898939c3f95c89ee87da06c49c2daf57fb7779fbc2b623eb0fa639e22ac4367e
BLAKE2b-256 checksum
How to use checksums
8d94fd3c33c482376564a46d5cc335546279476f6e555057657af33627d63b3e
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.13.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL xpd-0.13.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 2.7 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
69d282f0ea2275393d7e131191989899f448db2a08b080d2311d2a98f855f995
BLAKE2b-256 checksum
How to use checksums
e0756a61f6079ce7f0ed1bc6796a31e69b7ae1ed670a12ec11c235530f61ee97
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.13.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL xpd-0.13.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 2.5 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
8785d96bf89c964542cbc57119eb9d0efaff7e21e753399b7b7aefbec1d6ce7d
BLAKE2b-256 checksum
How to use checksums
61cbd75e228daec501db6b484f0903b21ec42701e6f746323509599d15d9cc99
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.13.0-py3-none-macosx_11_0_arm64.whl

Download URL xpd-0.13.0-py3-none-macosx_11_0_arm64.whl
Size 2.5 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
6958bd29474e4b3b1597038172ee95298d91948cd962725a1b828759621a8f0c
BLAKE2b-256 checksum
How to use checksums
bd23ddcadce4cabff7efe45b5aa3a233c6b48dfb9a40ee7d576d1c7475c1cbbb
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.13.0-py3-none-macosx_10_12_x86_64.whl

Download URL xpd-0.13.0-py3-none-macosx_10_12_x86_64.whl
Size 2.6 MB
Tags Python 3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
d25e66168ff06c21254437d12411c1e3f5c5438ee114cfa506610872998e69df
BLAKE2b-256 checksum
How to use checksums
996495e2c1683501d44346328ab872b556807989b9867417cb2a861edaafaff8
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.13.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.13.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