Open git files, directories, hashes, tags, and branches in the browser
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
git_browse
.codeclimate.yml
.coveragerc
.gitignore
.pyup.yml
CHANGELOG.md
LICENSE
MANIFEST.in
README.rst
install.sh
requirements-test.txt
setup.py

README.rst

Git Browse

PyPI Python Versions

Codeship Status for albertyw/git-browse Dependency Status Code Climate Test Coverage

Open repositories, directories, and files in the browser. See also, git-reviewers.

https://user-images.githubusercontent.com/3151040/28054498-e7cb0746-65c9-11e7-882e-dbf612f5b075.gif

This is a script that can be added as a gitconfig alias to easily browse repositories on Git hosting services (e.g. github). It is built to model arcanist's browse command. It is specifically designed to have no dependencies so it should be easily installable and very portable.

If you're looking to browse different github repositories, you might like hub browse.

Installation

HomeBrew (preferred for MacOS)

If you use Homebrew, you can install git-browse through the homebrew-albertyw tap:

brew install albertyw/albertyw/git-browse

Manual

If you don't use Homebrew, first clone this repository to somewhere on your system (perhaps in your dotfiles repository), then run <REPOSITORY_LOCATION>/install.sh.

Usage

Usage: git browse [-h] [--path PATH] [--dry-run] [target]

If [target] is omitted, the root repository page will be opened. If [target] is a directory or file, then that object will be opened. If [target] is a commit hash, then that commit hash will be opened. If --path is available, then its value is be used to compute the relative path to the current git repository If --dry-run is set, then git-browse will only print out the target url instead of opening it in a browser

Examples

Command Opens
git browse https://github.com/albertyw/git-browse
git browse README.rst https://github.com/albertyw/git-browse/blob/master/README.rst
git browse git_browse https://github.com/albertyw/git-browse/tree/master/git_browse/
git browse v1.1.1 https://github.com/albertyw/git-browse/commit/80b219dee0aaa86b378993cbf88511126b813c5f

Related Projects

Development

pip install -r requirements-test.txt
coverage run setup.py test
coverage report
flake8
mypy git_browse/browse.py

Publishing

pip install twine
python setup.py sdist bdist_wheel
twine upload dist/*

Need to also update albertyw/homebrew-albertyw