docs: actually write README
All checks were successful
Publish Docker Images / coverage-and-sonar (push) Successful in 18m50s
All checks were successful
Publish Docker Images / coverage-and-sonar (push) Successful in 18m50s
This commit is contained in:
48
README.md
48
README.md
@@ -1 +1,49 @@
|
|||||||
# jj-cz: Conventional Commits for Jujutsu
|
# jj-cz: Conventional Commits for Jujutsu
|
||||||
|
|
||||||
|
An interactive CLI tool that guides Jujutsu users through creating
|
||||||
|
[conventional commit](https://www.conventionalcommits.org/) messages.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
- Interactive prompts for type, scope, and description
|
||||||
|
- All 11 commit types with descriptions (feat, fix, docs, style,
|
||||||
|
refactor, perf, test, build, ci, chore, revert)
|
||||||
|
- Optional scope with validation
|
||||||
|
- 72-character first-line limit enforcement
|
||||||
|
- Preview before applying
|
||||||
|
- Clean cancellation with Ctrl+C
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
No fancy tricks, just run `jj-cz`.
|
||||||
|
|
||||||
|
```sh
|
||||||
|
jj-cz
|
||||||
|
```
|
||||||
|
|
||||||
|
The tool detects whether you're in a Jujutsu repository, guides you
|
||||||
|
through the commit message, and applies it to your current change.
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
- A Jujutsu repository
|
||||||
|
- An interactive terminal
|
||||||
|
|
||||||
|
You don’t need `jj` itself to be installed at all, though I’m not sure
|
||||||
|
what `jj-cz` alone would be good for without `jj`.
|
||||||
|
|
||||||
|
## Exit Codes
|
||||||
|
|
||||||
|
| Code | Meaning |
|
||||||
|
|------|------------------------------------------------------|
|
||||||
|
| 0 | Success or clean cancellation |
|
||||||
|
| 1 | Error (invalid input, repository issues, jj failure) |
|
||||||
|
| 130 | Interrupted |
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
You can install jj-cz with Cargo by building it from source.
|
||||||
|
|
||||||
|
```sh
|
||||||
|
cargo install --path .
|
||||||
|
```
|
||||||
|
|||||||
@@ -19,8 +19,8 @@
|
|||||||
};
|
};
|
||||||
|
|
||||||
nixConfig = {
|
nixConfig = {
|
||||||
extra-trusted-public-keys = [ "devenv.cachix.org-1:w1cLUi8dv3hnoSPGAuibQv+f9TZLr6cv/Hm9XgU50cw=" ];
|
extra-trusted-public-keys = ["devenv.cachix.org-1:w1cLUi8dv3hnoSPGAuibQv+f9TZLr6cv/Hm9XgU50cw="];
|
||||||
extra-substituters = [ "https://devenv.cachix.org" ];
|
extra-substituters = ["https://devenv.cachix.org"];
|
||||||
};
|
};
|
||||||
|
|
||||||
outputs = {
|
outputs = {
|
||||||
|
|||||||
@@ -11,7 +11,7 @@
|
|||||||
inherit version;
|
inherit version;
|
||||||
src = pkgs.lib.cleanSource ../.;
|
src = pkgs.lib.cleanSource ../.;
|
||||||
cargoLock.lockFile = ../Cargo.lock;
|
cargoLock.lockFile = ../Cargo.lock;
|
||||||
nativeBuildInputs = [ pkgs.upx ];
|
nativeBuildInputs = [pkgs.upx];
|
||||||
useNextest = true;
|
useNextest = true;
|
||||||
meta = {
|
meta = {
|
||||||
description = "Conventional commits for Jujutsu";
|
description = "Conventional commits for Jujutsu";
|
||||||
|
|||||||
Reference in New Issue
Block a user