Metadata-Version: 2.1
Name: git-browse
Version: 2.9.0
Summary: Open repositories, directories, and files in the browser
Home-page: https://github.com/albertyw/git-browse
Author: Albert Wang
Author-email: git@albertyw.com
License: MIT
Description: Git Browse
        ==========
        
        [![PyPI](https://img.shields.io/pypi/v/git-browse)](https://pypi.org/project/git-browse/)
        ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/git-browse)
        ![PyPI - License](https://img.shields.io/pypi/l/git-browse)
        
        [![Codeship Status for albertyw/git-browse](https://app.codeship.com/projects/fbd67810-b952-0134-2c2e-166255a25182/status?branch=master)](https://app.codeship.com/projects/194945)
        [![Dependency Status](https://pyup.io/repos/github/albertyw/git-browse/shield.svg)](https://pyup.io/repos/github/albertyw/git-browse/)
        [![Code Climate](https://codeclimate.com/github/albertyw/git-browse/badges/gpa.svg)](https://codeclimate.com/github/albertyw/git-browse)
        [![Test Coverage](https://codeclimate.com/github/albertyw/git-browse/badges/coverage.svg)](https://codeclimate.com/github/albertyw/git-browse/coverage)
        
        
        Open repositories, directories, and files in the browser. See also,
        [git-reviewers](https://github.com/albertyw/git-reviewer).
        
        ![Preview](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](https://github.com/phacility/arcanist/blob/master/src/workflow/ArcanistBrowseWorkflow.php)
        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](https://github.com/github/hub/blob/master/commands/browse.go).
        
        Installation
        ------------
        
        ### HomeBrew (preferred for MacOS)
        
        If you use Homebrew, you can install git-browse through the
        [homebrew-albertyw tap](https://github.com/albertyw/homebrew-albertyw>):
        
        ```bash
        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](https://github.com/albertyw/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] [-g] [-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
          -g, --godocs       Open objects in godocs
          -v, --version      show program's version number and exit
        ```
        
        ### Examples
        
        | Command                 | Opens                                                                                    |
        |-------------------------|------------------------------------------------------------------------------------------|
        | `git browse`            | <https://github.com/albertyw/git-browse>                                                 |
        | `git browse README.md`  | <https://github.com/albertyw/git-browse/blob/master/README.md>                           |
        | `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
        ----------------
        
        - [git-brws](https://github.com/rhysd/git-brws)
        - [hub browse](https://hub.github.com/)
        - [git open](https://github.com/paulirish/git-open)
        - [open-browser-github.vim](https://github.com/tyru/open-browser-github.vim)
        
        Development
        -----------
        
        ```bash
        pip install -r requirements-test.txt
        coverage run setup.py test
        coverage report
        flake8
        mypy git_browse/browse.py
        ```
        
        Publishing
        ----------
        
        ```bash
        pip install twine
        python setup.py sdist bdist_wheel
        twine upload dist/*
        ```
        
        Need to also update [albertyw/homebrew-albertyw](https://github.com/albertyw/homebrew-albertyw).
        
Keywords: github phabricator repository browser
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Topic :: Software Development :: Version Control
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Typing :: Typed
Description-Content-Type: text/markdown
Provides-Extra: dev
Provides-Extra: test
