git-x - a set of handy git extensions.
Project description
License |
|
---|---|
CI |
|
Packages |
|
git-x - a set of handy git extensions.
Installation
pip install git-x --upgrade
How to Use
Show help message
Run
git-x
, or ignore the - in git-x:
git x
It will output the help message, which showing all the available commands:
$ git x
Usage: git-x [OPTIONS] COMMAND [ARGS]...
Options:
-h Show this message and exit.
Commands:
a Add file contents to the index
amend Amend files into repository
b Show current branch name
ci Commit all the indexed files
cia Add files into index and commit
clb Clean merged local branch.
co Checkout/Create branch
llg Show recent <number> logs
m Merge codes from branch <from> to current branch
p Pull latest code
pr Create pull request from current branch to <to_branch>
st Show the working tree status
up Create remote branch
Note: If you have an exe like git-x.exe in windows, or git-x.sh in linux or mac, you can run the command with git x directly. This is handled by git.
Run commands
git-x includes a list of commands, let’s take st as an example:
There are several ways to run the command:
1. Run with git-x
Run
git x st -h
Or,
git-x st -h
It will output the help doc of st command:
$ git x st -h
Usage: git-x st [OPTIONS]
Show file status, same as 'git status'
Options:
-h Show this message and exit.
2. Run with git- or git
You may see that in the Usage line, it shows git-st, which means that you can run the commands listed above with git-:
git-st -h
Or, even run with git:
git st -h
They both output the help doc of st command:
$ git-st -h
Usage: git-st [OPTIONS]
Show file status, same as 'git status'
Options:
-h Show this message and exit.
Usages of all commands
In the next we will show the detailed usage of each commands:
git x
List out all the available commands:
Usage: git-x [OPTIONS] COMMAND [ARGS]... Options: -h Show this message and exit. Commands: a Add file contents to the index amend Amend files into repository b Show current branch name ci Commit all the indexed files cia Add files into index and commit clb Clean merged local branch. co Checkout/Create branch llg Show recent <number> logs m Merge codes from branch <from> to current branch p Pull latest code pr Create pull request from current branch to <to_branch> st Show the working tree status up Create remote branch
git a
This is the description and example of this command:
Usage: git-a [OPTIONS] <pathspec> Add file that specified in <pathspec> contents into the index. Ignore/Remove the file contents from the index if the files are specified in the -x option. The <pathspec> syntax is same as the one in 'git status' parameter. Examples: 1. Add all sql files: git a *.sql 2. Add all files, but ignore all config files(ending with .config extensions) git a . -x *.config 3. Ignore multiple files(*.config, *.md) by using more than one '-x' to specify multiple patterns. git a . -x *.config -x *.md //There is an known issue on mac or linux system,as the *.md will be auto expanded into a file list. In this case, you can use " to wrap the paramter. like git a . -x "*.config" 4. Remove all config files from the index git -x *.config Options: -x, --exclude <pathspec> Exclude the files that match the pattern(same as the <pathspec> for 'git add' command) -h Show this message and exit.
git amend
This is the description and example of this command:
Usage: git-amend [OPTIONS] Amend files into repository, this only amend the files that already in the index. Examples: 1. Amend without editing git amend 2. Amend, and edit the commit message, this will open the editing window, depends on what editor is configured in git. git amend -e Options: -e, --edit Prompt edit window [default: False] -h Show this message and exit.
git b
This is the description and example of this command:
Usage: git-b [OPTIONS] Show current branch name. Example: git b Options: -h Show this message and exit.
git ci
This is the description and example of this command:
Usage: git-ci [OPTIONS] <comment> Commit all the indexed files into repository, same as 'git commit -m <comment>'. Example: git ci "This is the comment." Options: -h Show this message and exit.
git cia
This is the description and example of this command:
Usage: git-cia [OPTIONS] <comment> Add content files into index, and then create a new commit. By default it will add all the files under the current folder. You can ignore/remove files by specifying in the '-x' option. This is a combination of the following commands: `git a . -x <pathspec>` `git commit -m <comment>` Examples: 1. Add all files and create a commit. git cia "This is the comment" 2. Exclude *.config files, and create a commit. git -x *.config "This is the comment" 3. Exclude the *.cs and *.config files, and create a commit. git -x *.config -x *.cs "This is the comment" Options: -x, --exclude <pathspec> -h Show this message and exit.
git clb
This is the description and example of this command:
Usage: git-clb [OPTIONS] Clean merged local branch. It will always let user to confirm before remove. By default, it will ignore current branch and branches with name master, dev, develop, trunk. Because those branches are mostly used as trunk/release branches. Options: -h Show this message and exit.
git co
This is the description and example of this command:
Usage: git-co [OPTIONS] <branch> <start_point> Check out the branch matching the string in <branch>. If multiple branches include the <branch> text, all those branches will be listed and let user to choose. This only works if '-b' is not present. If '-b' is present, a new branch with name <branch> will be created. Examples: Suppose we have 5 existing branches - master, develop, feature_1, feature_2, develop1 1. Switch to an existing branch 'develop' git co develop 2. Create a new branch 'feature_3' git co -b feature_3 3. Create a new branch, and set the start point with <start_point> git co -b feature_3 32aa51b 4. Switch to a branch with name like 'feature_*' gi co feature_ Then it will list all indexed branches with 'feature_' in the name, and let the user to choose: Found 4 branches including "feature_": ==================== 0: feature_1 1: feature_2 ==================== Please select branch by index: Then, the user can choose 0, click ENTER to switch to feature_1 branch. 5. Switch to a branch with -f option: gi co develop -f if there is a branch name exactly matching 'develop', it will check out that branch, no matter there are other branches with 'develop' in the name. If there is not exactly matches, then follow the same logic without -f option Found 1 branch exactly matching "develop": git co -b -f develop Options: -b Indicate to create the branch if it doesn't exist, same to '-B' option in 'git checkout' command. [default: False] -f If set, checkout the branch directly without checking all brranches which name contains the <branch> -h Show this message and exit.
git llg
This is the description and example of this command:
Usage: git-llg [OPTIONS] <number> Show recent <number> logs, the default number is 5. This is same as 'git log --oneline -n <number>' Example: 1. Show recent 5 commit messages. git llg 2. Show recent 6 commit messages. git llg 6 3. Show with graph git llg -g 4. Show with graph, author, and date git llg -gad Options: -g, --graph Show in graph mode -a, --author Show the author name of each commit -d, --date show relative date of each commit -h Show this message and exit.
git m
This is the description and example of this command:
Usage: git-m [OPTIONS] <from> Merge codes from branch <from> to current branch. It will switch to branch <from>, pull the latest code, and then switch back to previous branch, and merge the code from <from> into current branch. You need to make sure that there is no unstaged changes. Examples: 1. Merge latest code from master branch to current branch(develop) git m master Options: -h Show this message and exit.
git p
This is the description and example of this command:
Usage: git-p [OPTIONS] Pull the latest code from remote with '--rebase' option. It is same as 'git pull --rebase' Options: -h Show this message and exit.
git pr
This is the description and example of this command:
Usage: git-pr [OPTIONS] <to_branch> Create pull request from current branch to <to_branch>. Currently it only support to raise pull request to github and bitbucket. The repository url is retrieved from the .git/config file. Examples: 1. Create PR against master branch git pr master Options: -h Show this message and exit.
git st
This is the description and example of this command:
Usage: git-st [OPTIONS] Show the working tree status, same as 'git status' Options: -h Show this message and exit.
git up
This is the description and example of this command:
Usage: git-up [OPTIONS] Create remote branch, same as 'git push --set-upstream origin' Options: -h Show this message and exit.
Notice:
You need to install git cli tool first, as all the commands will call the native git commands eventually.
Finally, happy git-ing with git-x.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for git_x-0.3.3-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9bebde6e9500a4e70944e62bd9fcad8d6ede62a671e035906e1ed3177db8b118 |
|
MD5 | 587034d6fa8625420debfa680f9a5877 |
|
BLAKE2b-256 | 162f705a7c9c3abea54c169c64a611d755fb5b0c86b6afdce7e81e14ac6f18d6 |