integratergithub / glitter

🌌⭐ Git tooling of the future.

❯ Glitter

Git tooling of the future.

❯ 👀 Features

• Config files (with defaults!)
• Fast
• Easy to use
• Friendly errors
• Multi branch support
• Beautiful, as if it just rolled in Glitter!

❯ 📚 Documentation

For proper docs, see here, this also includes examples.

❯ ✋ What, how and why?

Glitter is a wrapper for Git essentially, allowing you to compress multiple commands into one. Glitter is written in rust which not only makes it fast but also efficient. We simply parse your .glitterrc (if it exists, if not it'll use the default config) and run a few git commands under the hood. Why? Simplicity. If you maintain a project, this is probably the thing for you.

❯ 😀 Installation

Windows

Scoop

scoop install glitter

MacOS

Brew

brew tap eternalmoon1234/brew
brew install glitter

Linux

This is a bash script that can install on any platform other then windows, not just linux.

curl -fsSL https://raw.githubusercontent.com/Milo123459/glitter/master/install.sh | bash

Other

Check the releases and download the appropriate binary. Or build from source.

To build from source run this:

You need rust installed!

git clone https://github.com/Milo123459/glitter
cd glitter
cargo install --path .

To update:

cd glitter
git pull
cargo install --path .

🛑 Please report any bug reports in issues, I'll try and respond ASAP

❯ 🎉 Get started

We're so happy to see your interest in Glitter! Leave a ⭐ if you like Glitter!

Firstly, lets create a .glitterrc - the configuration file for Glitter.

The glitterrc is basically JSON but a fancy extension. If we want to make it so it automatically templates our commit message we can do it like so:

{
    "commit_message": "$1($2): $3+"
}

and you can use it like so: glitter push chore deps bump deps, this would produce the message chore(deps): bump deps. As you probably understand, $ is the prefix of arguments, ie, you can do $1 for the first argument, $2 for the second, etc. The + basically means all arguments after the one you specify will be placed there. Lets say we want it to be chore(Deps): bump deps and it formats with that case. How? Easy. Lets add another key to our file:

{
    ...
    "commit_message_arguments": []
}

inside this key we can then add the argument to configure, in this case, the 2nd one, let's add that.

{
    ...
    "commit_message_arguments": [
        {
            "argument": 2
        }
    ]
}

and then, to configure the case, add the key case and watch the magic!

{
    ...
    "commit_message_arguments": [
        {
            "argument": 2,
            "case": "pascal"
        }
    ]

}

Running glitter push chore deps bump deps would then give us the commit message of chore(Deps): bump deps 🎉!

❯ 📷 FAQ

Does "this hello" count as 1 or 2 arguments?

This example counts as 1. For example glitter push hello "world how" are you would give the following arguments:

1: hello
2: world how
3: are
4: you

Why is it fast sometimes but not the next?

That's reliant on your internet connection. - We are just running git commands under the hood. Git will be the thing taking it's sweet time.

❯ 📣 Available Cases

• lower
• upper
• snake
• screaming-snake
• kebab
• train
• sentence
• title
• class
• pascal

.. got a suggestion? Please make a discussion.

INSTALLATION ERRORS are to go in issues.