rec / gitz Goto Github PK

This is a collection of seventeen git utilities aimed at people doing rapid development using Git.

Gitz is for two types of users - quality-obsessed individuals who relentlessly manicure their pull requests until every byte is in the right place; and ultra-rapid developers who want to generate large features quickly while taking advantage of continuous integration.

Most of these utilities only exist here, one came from a chat on Reddit and I don't know where one of them came from.

Four of them are written in Bash, the rest use Python 3. They have been tested on Mac OS/X (Darwin) and on Ubuntu, and will likely work on any Unix-like operating system.

Use pip:

pip3 install gitz

Or simply download this directory and make sure it's in your shell's PATH - gitz has no external dependencies.

This page contains a summary and a link to a manual page for each command. From the terminal, use -h flag like this: git new -h or use man like this: man git-new.

1. At the start of a session
   • git new safely creates fresh branches from upstream
   • git update for each branch, rebases from upstream and force-pushes
2. During development
   • git st is a more compact and prettier git status
   • git when shows you when documents were last changed
3. During rapid development
   • git infer commits files with an automatically generated message - great for committing tiny changes for later rebasing down
4. While cleaning up a branch for review
   • git permute permutes, squashes or removes commits in the current branch
   • git split split one or more commits, perhaps with the staging area, into many small individual commits, one per file
5. During repository maintenance
   • git rotate rotates through all branches
   • git copy, git delete, and git rename work on both local and upstream branches
6. Working with continuous integration
   • git stripe pushes a sequence of commits to individual remote branches where CI can find and test them

Informational commands that don't change your repository

git gitz

Print information about the gitz git commands

git go

Open a browser page for the current repo

git infer

Commit changes with an automatically generated message

(from https://github.com/moondewio/git-infer)

git multi-pick

Cherry-pick multiple commits, with an optional squash

git new

Create and push new branches

git rot

Rotate through branches in a Git repository

git st

Colorful, compact git status

git stripe

Push a sequence of commit IDs to a remote repository

git when

For each file, show the most recent commit that changed it.

Dotfiles are ignored by default.

git copy

Copy a git branch locally and remotely

git delete

Delete one or more branches locally and remotely

git rename

Rename a git branch locally and remotely

By default, the branches develop and master are protected - they are not allowed to be copied to, renamed, or deleted.

You can configure this in three ways:

• setting the --all/-a flag ignore protected branches entirely
• setting the environment variable GITZ_PROTECTED_BRANCHES overrides these defaults
• setting a value for the keys PROTECTED_BRANCHES in the file .gitz.json in the top directory of your Git project has the same effect

Slice, dice, shuffle and split your commits.

These commands are not intended for use on a shared or production branch, but can significantly speed up rapid development on private branches.

git adjust

Amend any commit, not just the last

git permute

Reorder and delete commits in the current branch

git split

Split a range of commits into many single-file commits

git update

Update branches from a reference branch