Skip to content

Commit d1555f2

Browse files
committed
[CPFeature-003][UpdateDocs] Updated the CLI help and usage docs with new functionality
1 parent 7fe0650 commit d1555f2

File tree

1 file changed

+32
-6
lines changed

1 file changed

+32
-6
lines changed

Sources/CommitPrefix/CLIArguments.swift

Lines changed: 32 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -141,14 +141,40 @@ public struct CLIArguments {
141141
private struct ArgumentBuilder {
142142

143143
let usage: String = """
144-
<Commit Prefix Description>
144+
[<PrefixValue1>,<PrefixValue2>,<PrefixValue3>...] [-o | --output] [-d | --delete]
145+
[-n | -normal] [ -b | --branchParse <ValidatorValue> ]
145146
"""
146147

147148
let overview: String = """
148-
The CommitPrefix stores a desired prefix for your commit messages.
149-
It stores it within the .git folder of the current repository. A
150-
commit-msg hook is also generated and stored within the .git
151-
folder which is used to prefix the commit message.
149+
150+
The CommitPrefix stores a desired set of prefixes for your commit messages. It
151+
stores it within the .git folder of the current repository. A commit-msg hook is
152+
also generated and stored within the .git folder which is used to prefix the
153+
commit message.
154+
155+
Modes:
156+
CommitPrefix has two modes, normal and branch parse.
157+
158+
- NORMAL
159+
example: commitPrefix <PrefixValue1>,<PrefixValue2>,<PrefixValue3>...
160+
161+
You can add normal prefixes by entering comma seperated values. These values will
162+
be parsed as prefixes and prepended to future commit messages.
163+
164+
- BRANCH_PARSE
165+
example commitPrefix -b <ValidatorValue>
166+
167+
Branch parse mode checks the current branch for an issue number validated by the
168+
value passed in as an argument. For example if you passed in a validator value of
169+
"eng" and your current branch was named ENG-342-SomeFeatureBranchLinkedToENG-101,
170+
commitPrefix will pickup [ENG-342] and [ENG-101] as branch prefixes to be
171+
prepended to you next commit along with any other normal prefixes you might have.
172+
173+
You can change back to NORMAL mode by entering:
174+
example: commitPrefix -n
175+
176+
To view the current state of prefixes and mode, enter:
177+
example: commitPrefix
152178
"""
153179

154180
func buildParser() -> ArgumentParser {
@@ -190,7 +216,7 @@ private struct ArgumentBuilder {
190216
option: "--branchParse",
191217
shortName: "-b",
192218
kind: Bool.self,
193-
usage: "Sets the mode to BRANCH_PARSE. Requires a validator",
219+
usage: "Sets the mode to BRANCH_PARSE. Requires a validator argument",
194220
completion: nil
195221
)
196222
}

0 commit comments

Comments
 (0)