v0.21.0

Release Notes

Add plot --cpu modes, including ps-cpu-timepoint for derived instantaneous CPU (#424)

• Change: con-duct plot now shows per-pid traces with max-across-pids and totals.* envelopes. Previously it drew only totals.pcpu and totals.rss as a single line per metric, with no per-pid breakdown.
• Change: con-duct plot now shows absolute rss on a secondary y-axis instead of pmem. Motivated by SLURM, where pmem = rss / host_total makes job usage look tiny on big nodes.
• Change: con-duct plot drops vsz from the secondary y-axis, since this is a rarely useful metric.
• Add: host available RAM in the legend when info.json is available.
• Add: --cpu argument to con-duct plot:
  • --cpu ps-pcpu (default): plot ps's raw lifetime pcpu per pid, untransformed. Every point on the chart is an unaltered ps reading.
  • --cpu ps-cpu-timepoint: at plot time, derive a per-interval estimate from consecutive (pcpu, etime) pairs to approximate instantaneous CPU. Sidesteps lifetime-average inflation on short-lived bursty pids.
• Change: con-duct run warns when --sample-interval is below 1.0s. ps reports etime as integer seconds, so pcpu calculations for sub-second-young pids are unstable.
• Change: byte humanization in con-duct plot is now decimal (base 1000, kB/MB/GB), matching the run summary. Previously the plot used base-1024 with decimal-style suffixes.
• Docs: new docs/resource-statistics.md explains what duct's pcpu / rss / pmem actually measure, how aggregation works, and how con-duct plot renders these. Linked from README.

---

🚀 Enhancement

• Add plot --cpu modes, including ps-cpu-timepoint for derived instantaneous CPU #424 (@asmacdo)

🐛 Bug Fix

• [pre-commit.ci] pre-commit autoupdate #422 (@pre-commit-ci[bot])
• Explained level options with examples #369 (@asmacdo)
• fix: clean error on output prefix collision instead of traceback #420 (@lobennett)
• fix: emit deprecation warning for {datetime_filesafe} format field #421 (@lobennett)

Authors: 3

• @pre-commit-ci[bot]
• Austin Macdonald (@asmacdo)
• Logan Bennett (@lobennett)

v0.20.1

🐛 Bug Fix

• Update README to include duct-gallery reference #417 (@yarikoptic @pre-commit-ci[bot])
• Enhance README with ReproMan usage information #417 (@yarikoptic)

⚠️ Pushed to main

• Update README to include smon reference (@yarikoptic)
• Add forgotten copyright notice for origin in LICENSE (@yarikoptic)

Authors: 2

• @pre-commit-ci[bot]
• Yaroslav Halchenko (@yarikoptic)

v0.20.0

🚀 Enhancement

• Allow direct invocation of cli.py #366 (@CodyCBakerPhD)
• Activate intel runner for mac CI #364 (@CodyCBakerPhD)

🐛 Bug Fix

• pp: humanize memory_total under -H #413 (@asmacdo)
• [pre-commit.ci] pre-commit autoupdate #400 (@pre-commit-ci[bot])
• Better error rendering on unsupported systems #392 (@CodyCBakerPhD @asmacdo)
• feat: replace support of "datetime_filesafe" format field in output file prefix format string with "datetime" #375 (@candleindark @pre-commit-ci[bot] @asmacdo)
• test: add rerun backoff to test_execution_summary #394 (@asmacdo)
• Added basic import structure for library usage #390 (@CodyCBakerPhD)
• Refactor: Break up duct_main.py into smaller modules #385 (@asmacdo)
• [pre-commit.ci] pre-commit autoupdate #387 (@pre-commit-ci[bot])
• refactor: extract Report and monitor_process to _tracker.py #383 (@asmacdo)
• refactor: extract IO utilities to _output.py #382 (@asmacdo)
• refactor: extract sampling functions to _sampling.py #381 (@asmacdo)
• refactor: extract SigIntHandler to _signals.py #380 (@asmacdo)
• refactor: extract SummaryFormatter to _formatter.py #379 (@asmacdo)
• refactor: extract models and enums to _models.py #377 (@asmacdo)
• refactor: extract constants to _constants.py #373 (@asmacdo @pre-commit-ci[bot])
• ci: run tests on all PRs, remove yamllint #374 (@asmacdo @pre-commit-ci[bot])
• Consolidate configurations into pyproject.toml #367 (@candleindark)
• Allow e2e tests to use configurable executable #365 (@asmacdo)
• Increase wait time on rerun for flakey tests #359 (@asmacdo)

🏠 Internal

• [pre-commit.ci] pre-commit autoupdate #398 (@pre-commit-ci[bot])

Authors: 4

• @pre-commit-ci[bot]
• Austin Macdonald (@asmacdo)
• Cody Baker (@CodyCBakerPhD)
• Isaac To (@candleindark)

v0.19.0

🚀 Enhancement

• Added Mac (M-series) support #351 (codycbakerphd@gmail.com @CodyCBakerPhD @asmacdo)
• Add --reverse option to con-duct ls command #308 (@asmacdo @yarikoptic)

🐛 Bug Fix

• Fix formatting for upstream linking instructions #360 (@CodyCBakerPhD)
• filter pyparsing deprecation warnings instead of pinning #355 (@asmacdo)
• pin pyparsing for oldestdeps environment #353 (@asmacdo)

🏠 Internal

• Improve handler of SIGINT signals #357 (@candleindark)

Authors: 5

• Austin Macdonald (@asmacdo)
• Cody Baker (@CodyCBakerPhD)
• CodyCBakerPhD (codycbakerphd@gmail.com)
• Isaac To (@candleindark)
• Yaroslav Halchenko (@yarikoptic)

v0.18.0

🚀 Enhancement

• Add matplotlib backwards compatibility to 3.5 #322 (@asmacdo)
• Add dotenv config #333 (@asmacdo)
• Use jsonl suffix #345 (@asmacdo)
• Modernize python #346 (@asmacdo)
• Combine clis #327 (@asmacdo)

🐛 Bug Fix

• Skip test_permission_denied_handling when running as root #349 (@Copilot @actions-user @asmacdo)
• Reorganize tests #329 (@asmacdo)
• Add installation instructions for remote forks #337 (@CodyCBakerPhD)
• remove rpds pin for non-pypy #334 (@asmacdo)
• Add demo and reference plot example in README #310 (@asmacdo)
• pin rpds-py so pypy 3.10 tests pass #331 (@asmacdo)
• Revert mergify integration (PRs #270 and #271) #328 (@asmacdo)
• test: Make tests invoke at least with INFO level so we see what is wrong #321 (@yarikoptic)
• fix: plot usage with info.json abs path #301 (@asmacdo)
• Add CLAUDE.md for reusable base prompt for claude code #307 (@yarikoptic @actions-user)

Authors: 5

• @actions-user
• @Copilot
• Austin Macdonald (@asmacdo)
• Cody Baker (@CodyCBakerPhD)
• Yaroslav Halchenko (@yarikoptic)

v0.17.0

🚀 Enhancement

• enh: Human-readable axis values/units on con-duct plots #302 (@asmacdo)

🐛 Bug Fix

• plot: allow for -o in addition to --output #300 (@yarikoptic)

Authors: 2

• Austin Macdonald (@asmacdo)
• Yaroslav Halchenko (@yarikoptic)

v0.16.0

🚀 Enhancement

• Change: Replace print statements with logger for error handling #296 (@asmacdo)
• Handle noninteractive matplotlib backends #293 (@asmacdo)
• con-duct plot should accept info.json in addition to usage.json #292 (@asmacdo)

🐛 Bug Fix

• Test against pre-release of 3.14 #230 (@yarikoptic @asmacdo)
• List a version in "duct is executing" log message #295 (@yarikoptic)

Authors: 2

• Austin Macdonald (@asmacdo)
• Yaroslav Halchenko (@yarikoptic)

v0.15.0

🚀 Enhancement

• add --messsage/-m and store in info.json #285 (@asmacdo)
• empty info files detected with con-duct ls should have debug message, not warnings #284 (@asmacdo)
• 228 human readable pp #286 (@asmacdo)

Authors: 1

• Austin Macdonald (@asmacdo)

v0.14.1

🐛 Bug Fix

• fix: pypy-310 can sometimes produce empty usage files #287 (@asmacdo)

Authors: 1

• Austin Macdonald (@asmacdo)

v0.14.0

🚀 Enhancement

• Current session mode #283 (@asmacdo)
• enh: add --version to con-duct #280 (@asmacdo)

🐛 Bug Fix

• remove development artifact #282 (@asmacdo)
• auto push cleanup to PRs #275 (@asmacdo @actions-user)
• Reduce flake: increase test_spawn_children sleep dur and add retries #277 (@asmacdo)
• bf: define pyci environment and there add pytest-mergify as dependency #271 (@yarikoptic)

Authors: 3

• @actions-user
• Austin Macdonald (@asmacdo)
• Yaroslav Halchenko (@yarikoptic)