Metadata-Version: 2.1
Name: ghstar
Version: 0.2.0
Summary: Star GitHub repos from the command line
Home-page: https://www.github.com/gokulsoumya/ghstar
License: MIT
Keywords: github,stars
Author: Gokul
Author-email: gokulps15@gmail.com
Requires-Python: >=3.5,<4.0
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
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: Topic :: Terminals
Classifier: Topic :: Utilities
Requires-Dist: requests (>=2.22,<3.0)
Project-URL: Repository, https://www.github.com/gokulsoumya/ghstar
Description-Content-Type: text/markdown

# ghstar

Star GitHub repos from the command line.

```sh
# set the environment variables GH_UNAME and GH_TOKEN
# to your GitHub username and token/password

$ ghstar gokulsoumya/ghstar
Starred gokulsoumya/ghstar
```

(Because the command line is awesome, browsers are a hassle, and I'm lazy.)

## Installation

`ghstar` is written in Python3, available on PyPI and installable via pip:

```
pip install ghstar
```

## Usage

You must first set the environment variables `GH_UNAME` and `GH_TOKEN` to
your GitHub username and token/password. It is recommended to use a
[token](https://github.com/settings/tokens/new) with `public_repo` scope
instead of your password though either one works.

```
$ ghstar --help

usage: ghstar [-h] [-i] [-n SEARCH_COUNT] repo

Star GitHub repos from the command line.

positional arguments:
  repo                  name of repo to star

optional arguments:
  -h, --help            show this help message and exit
  -i, --interactive     search for a repo and star interactively
  -n SEARCH_COUNT, --search-count SEARCH_COUNT
                        number of search results to show when run
                        interactively

examples:
  ghstar gokulsoumya/ghstar
  ghstar jlevy/the-art-of-command-line
```

## Contributing

If you have a feature request or if you've found a nasty lil bug, definitely
open an [issue](https://github.com/gokulsoumya/ghstar/issues). And PRs are,
as always, welcome.

