Registry / devops / hatch-pip-compile

hatch-pip-compile

library1.11.6pypypiunverified

A Hatch plugin that uses pip-compile (from pip-tools) to manage project dependencies, generating lockfiles and resolving versions. Current version 1.11.6, updated January 2026. Active development with regular bug fixes.

devops workflow

pip install hatch-pip-compile

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · HATCH-PIP-COMPILE

hatch-pip-compile

devopspythonv1.11.6

Install

7.8s avg

Import

—

Disk

78MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.11.6 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 71.3MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 7.8s · import 0.000s · 72MB

78MB installed

● package 78MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

HatchPipCompileBase

✓ from hatch_pip_compile import HatchPipCompileBase

✗ from hatch_pip_compile.plugin import HatchPipCompileBase

Enable pip-compile lockfile management for Hatch environments by adding configuration to pyproject.toml.

# Add to pyproject.toml under [tool.hatch.envs.default] # pip-compile = true # lockfile = "requirements.lock" # Then run: # hatch env create

Debug

Known issues

gotchaThe lockfile is generated using pip-compile but the environment installation uses pip, not uv by default. To use uv, set installer = "uv" in [tool.hatch.envs.default].

fix

Add 'installer = "uv"' to [tool.hatch.envs.default] in pyproject.toml if you want uv-based resolution.

affects: >=1.11.0

breakingIn v1.11.0, the plugin migrated to HatchPipCompileBase. If you imported or subclassed the old plugin class, your code may break.

fix

Use 'from hatch_pip_compile.plugin import HatchPipCompileBase' instead of the previous class.

affects: >=1.11.0

gotchaThe plugin reads environment variables like HATCH_PIP_COMPILE_LOCKFILE to override lockfile path, but the variable name case matters. Common mistake: using HATCH_PIP_COMPILE_LOCKFILE instead of the correct HATCH_PIP_COMPILE_LOCKFILE.

fix

Ensure environment variable is exactly HATCH_PIP_COMPILE_LOCKFILE (all caps) to override lockfile path.

affects: all

Upgrade

Version history

1.11.6latest on PyPI · released Jan 28, 2026

Audit

Dependencies

hatchlingrequiredRequired as Hatch plugin host

pip-toolsrequiredProvides pip-compile executable used for lockfile generation

Agent activity

25 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/juftin/hatch-pip-compile ↗

packagehttps://pypi.org/project/hatch-pip-compile/ ↗

docshttps://juftin.github.io/hatch-pip-compile ↗