Skip to main content

Open repositories, directories, and files in the browser

Project description

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

$ git browse -h
'browse' is aliased to '!~/.dotfiles/scripts/git/git-browse/git_browse/browse.py --path=${GIT_PREFIX:-./}'
usage: browse.py [-h] [--path PATH] [-d] [-s] [-v] [target]

Open repositories, directories, and files in the browser.
https://github.com/albertyw/git-browse

positional arguments:
  target             file, directory, git hash, or git branch you wish to
                     browse

optional arguments:
  -h, --help         show this help message and exit
  --path PATH        relative path to the current git repository
  -d, --dry-run      Do not open the url in the brower, and only print to
                     stdout
  -s, --sourcegraph  Open objects in sourcegraph
  -v, --version      show program's version number and exit

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

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

git-browse-2.7.3.tar.gz (8.3 kB view details)

Uploaded Source

Built Distribution

git_browse-2.7.3-py3-none-any.whl (7.1 kB view details)

Uploaded Python 3

File details

Details for the file git-browse-2.7.3.tar.gz.

File metadata

  • Download URL: git-browse-2.7.3.tar.gz
  • Upload date:
  • Size: 8.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.1.0 requests-toolbelt/0.9.1 tqdm/4.47.0 CPython/3.8.2

File hashes

Hashes for git-browse-2.7.3.tar.gz
Algorithm Hash digest
SHA256 695495637bf5bd1c38d33f0e68fa32b5f838ea95c20efe5eb69d2cd47adfab4a
MD5 057385e24d6ddc32fc4fabe0b928fce2
BLAKE2b-256 5d6b861d9501f6e8e16c054f7a819129df356151c05a7eb104fb719b974b2fe3

See more details on using hashes here.

File details

Details for the file git_browse-2.7.3-py3-none-any.whl.

File metadata

  • Download URL: git_browse-2.7.3-py3-none-any.whl
  • Upload date:
  • Size: 7.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.1.0 requests-toolbelt/0.9.1 tqdm/4.47.0 CPython/3.8.2

File hashes

Hashes for git_browse-2.7.3-py3-none-any.whl
Algorithm Hash digest
SHA256 39ea7a1d3ffa8ed1a83e6e5683d9ec928824ceccf21fc6733c7fbcb0c3aed428
MD5 684376bf7c11f0630ef97b514596ae86
BLAKE2b-256 b72dd1204345e08bab9f6eb53ad01592b970b10f404daf3a1a629caa80b5d075

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page