cocommit

cocommit

How to run

Insert blerb about go install if it works

Download the binary for your OS on the release page
Once downloaded you need to create an alias for your shell guides found below:
Bash Guide for alias
^please note if you use another shell than bash you will need to look up how to do it in that shell^
Powershell Guide for alias

Once you've created an alias for the program you need to create an author file. You can run the program and it will prompt you to create an author file if one is not found in the default location.

Optionally you can set an env variable (author_file) in your shell. This should be the path pointing to your authors file
For bash you just need to add this to your .bashrc file:

export author_file='path/to/your/aurhors'

Powershell guide for env variable

Please note that the syntax line at the top of the authors file should not be deleted and that you must add at least one author to the file to run the program

you can now run it using the alias shorthand you assigned to it

Usage:

The CLI has two modes, the CLI commands and the TUI below are guides on how to use both

TUI

To launch the TUI run the program with no args

$ cocommit

From here you will be asked to write a commit message and then select authors from a list. This creates the same message as the CLI way of doing it but is a bit nicer to work with. The TUI has lots of keybinds that can be seen on the list view by pressing ?. You can create authors, add temp authors or do all of the usual selections like negated selections or select all. Below is a small video showing a run through of the TUI.

CLI

$ cocommit "message" <name1> [name2] [name3]...

$ cocommit "message" <name:email1> [name:email2] [name:email3]...

$ cocommit "message" <name:email1> <name1> [name:email2]

$ cocommit "message" all
*adds all comitters execpt ones tagged with ex*

$ cocommit "message" ^<name1> ^[name2]
*adds all users except the negated users and users tagged with ex*

$ cocommit "message" <group_name>
*adds all users that has that group tag in author file*

$ cocommit "message"
*Runs git commit -m "message"*

$ cocommit users
*prints list of users*

Syntax for the author file

The syntax for the author file can be found at the top of the template file included in the repo. It should look like this (opt) is optional syntax:

name_short|Name|Username|email (opt: |ex) (opt: ;;group1 or ;;group1|group2|group3...)

opt explained:
ex -> excludes the given author for all and negation commands
group -> groups an author which can then be called as an argument to add all people from that group. An author can be a part of multiple groups

Why?

Writing co-authors onto commits can be pretty tedious so automating this process as a simple shell alias is a lot nicer

Workflows

This repo is sort of a test bed for working with Dagger CI but therefore also should support automated testing and building at some point See ci folder for the current dagger workflows