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, scikit-lego, MAPIE, Category Encoders 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
scikit-lego thresholder-score Thresholder.score ignores threshold, so a search scores every threshold the same
MAPIE calibrate-on-training-rows conformalize on the training rows gives intervals that covered 0.48 of new rows where 0.90 was asked
Category Encoders ordinal-mapping-pairs An OrdinalEncoder mapping given as a list of pairs codes every row as -1.0
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
├── lsp                    start the language server for editors
└── 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 in an editor

xpd lsp starts a language server, so an editor shows the issues while you type, with a quick fix for each fixable one and the rule's documentation on hover. The language server page has the setup for Neovim, Helix, Zed and VS Code.

Use with a coding agent

An agent can use xpd as a plugin, or through a hook, an MCP server and skills that you set up one at a time.

Way What the agent gets Setup
Plugin The MCP server and the skills together Load this repository in a client that supports Agent Plugins, such as Codex
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

Plugin

This repository is a plugin in the Agent Plugins format, version 1.0.0. A client that supports the format loads the folder and gets the MCP server and the skills. The plugin starts xpd with uvx, so the machine needs uv. Version 1.0.0 has no hooks, so the hook below stays a setting of its own.

xpd, loaded as a plugin
├── plugin.json                         the name and version of the plugin
├── skills/                             xpd, python-best-practices and python-review
├── mcp.json                            starts the MCP server of this version with uvx
└── .agents/plugins/marketplace.json    lists the plugin for Codex

Codex installs it with two commands.

codex plugin marketplace add bjoernaagaard/xpd
codex plugin add xpd@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 comes with xpd, and the command below adds it to Claude Code.

claude mcp add xpd -- uvx 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
│   ├── contract, gates            judge a run from a data file to a saved model
│   └── 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, build_pipeline

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. The code mode page is a first draft of a run from a data file to a saved scikit-learn model in one call.

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.15.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.15.0
File Size Uploaded Provenance Actions
xpd-0.15.0.tar.gz 447.7 kB Without provenance Details for xpd-0.15.0.tar.gz

Built distributions (wheels)

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

Total release size: 21.6 MB

Release files / xpd-0.15.0.tar.gz

Download URL xpd-0.15.0.tar.gz
Size 447.7 kB
Tags Source
SHA-256 checksum
How to use checksums
5502dc6191cad6a42503fffae212fd056aaf6115e948bac7abee7f4830e7c7bd
BLAKE2b-256 checksum
How to use checksums
0bc98ffe1402c5041d7c3be184d2c5c053674cc77c77c4602552064c132f6337
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.15.0-py3-none-win_amd64.whl

Download URL xpd-0.15.0-py3-none-win_amd64.whl
Size 3.2 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
76c8c837085f8cd53d1d5cc16cdb4da4020427f24327742c950da8b5fcea5e0f
BLAKE2b-256 checksum
How to use checksums
56155afde47e4584e67490f192e0e763199bcbfbd1dca543ce4e8e81c75ed071
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.15.0-py3-none-musllinux_1_2_x86_64.whl

Download URL xpd-0.15.0-py3-none-musllinux_1_2_x86_64.whl
Size 3.2 MB
Tags Linux musl 1.2+ x86-64 Python 3
SHA-256 checksum
How to use checksums
017ee70306e634e683c6cc2123fac5dae3e6b36e3015622498b6663ccd2dc5bb
BLAKE2b-256 checksum
How to use checksums
425a373508e6f18040b6713414bb0bb4c8ecb38d064dc6d99cb3bce95e5fc763
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.15.0-py3-none-musllinux_1_2_aarch64.whl

Download URL xpd-0.15.0-py3-none-musllinux_1_2_aarch64.whl
Size 2.9 MB
Tags Linux musl 1.2+ ARM64 Python 3
SHA-256 checksum
How to use checksums
4784435510e161cc9287dd9a0b87cce6943ce923513573b6b514a1d7d7033c3b
BLAKE2b-256 checksum
How to use checksums
e666191391d8dfd81da5d9a73cf2549ec7b59a2242d986f57295d7295fdc4c70
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.15.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL xpd-0.15.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 3.1 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
7151d3bf2f096363662956f11f542a34825c5d0cb9aa5afcd0d24a2beba1bb1b
BLAKE2b-256 checksum
How to use checksums
0fc831409ed9a205ee3ffa084cb917efe0d69692c283c5b4d46bb94e3bdf0154
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.15.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL xpd-0.15.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 2.9 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
ecf3c60c040e344af6b8b6cd012806e26e1031e487f3c002f452287e76aab6ff
BLAKE2b-256 checksum
How to use checksums
8cf430ccf370ca9a90fc1d0f1d804ba5d99af306a0464ad2046ca2751c83ae91
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.15.0-py3-none-macosx_11_0_arm64.whl

Download URL xpd-0.15.0-py3-none-macosx_11_0_arm64.whl
Size 2.8 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
da96a5e9f646a730d2bde54272b00e713b68db19b6960efc7992d5c1d7714ebb
BLAKE2b-256 checksum
How to use checksums
710be4ab0f69b804759ee1eaa887302de274ad6728df54c53e682c8c698fac4b
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.15.0-py3-none-macosx_10_12_x86_64.whl

Download URL xpd-0.15.0-py3-none-macosx_10_12_x86_64.whl
Size 3.0 MB
Tags Python 3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
77590db6d527ae59addce5895a682e8d2b7974ebc335b38396bec6cea9916fbe
BLAKE2b-256 checksum
How to use checksums
95cd14a91070fb0cc836f8e79824644e8e17727824026b2c840ddc25759d483c
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.15.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.15.0 This release

8 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