6 releases (breaking)

0.8.0 Mar 15, 2025
0.5.0 Jan 10, 2025
0.4.0 Oct 9, 2024
0.3.0 May 26, 2024
0.1.0 Aug 19, 2023

#163 in Development tools

Download history 2486/week @ 2024-12-02 2071/week @ 2024-12-09 2296/week @ 2024-12-16 1258/week @ 2024-12-23 3151/week @ 2024-12-30 5408/week @ 2025-01-06 2683/week @ 2025-01-13 5059/week @ 2025-01-20 6051/week @ 2025-01-27 7549/week @ 2025-02-03 7687/week @ 2025-02-10 5682/week @ 2025-02-17 6106/week @ 2025-02-24 7416/week @ 2025-03-03 9352/week @ 2025-03-10 3884/week @ 2025-03-17

27,563 downloads per month
Used in 19 crates (4 directly)

MIT/Apache

185KB
4.5K SLoC

About

Build status Latest version Docs License

scm-record is a Rust library for a UI component to interactively select changes to include in a commit. It's meant to be embedded in source control tooling.

You can think of this as an interactive replacement for git add -p, or a reimplementation of hg crecord/hg commit -i. Given a set of changes made by the user, this component presents them to the user and lets them select which of those changes should be staged for commit.

The scm-record library is directly integrated into these projects:

  • git-branchless: the git record -i command lets you interactively select and commit changes.
  • Jujutsu: as the built-in diff editor; see the ui.diff-editor configuration option.

Standalone executable

scm-diff-editor is a standalone executable that uses scm-record as the front-end. It can be installed via cargo:

$ cargo install --locked scm-diff-editor

The scm-diff-editor executable can be used with these tools:

Future work

Feature wishlist

Here are some features in the UI which are not yet implemented:

Integration with other projects

Here's some projects that don't use scm-record, but could benefit from integration with it (with your contribution):


lib.rs:

Reusable change selector UI for source control systems.

Dependencies

~7–17MB
~243K SLoC