-
Notifications
You must be signed in to change notification settings - Fork 88
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs: add basic instructions in readme
- Loading branch information
1 parent
3baf32c
commit 79b6042
Showing
1 changed file
with
32 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1 +1,32 @@ | ||
# ghstats | ||
# ghs | ||
|
||
CLI tool to get your Github profile's stats and summary. | ||
|
||
## Installation | ||
|
||
The stable version of this package is maintained on pypi, install using pip: | ||
|
||
```bash | ||
pip install ghs | ||
``` | ||
|
||
## PAT | ||
|
||
Generate a Github personal access token (https://github.com/settings/tokens) and use the `ghs -t` command to save it in the config file. This will make sure that your private contributions are also considered while generating the stats and the summary. | ||
|
||
## Usage | ||
|
||
``` | ||
➜ ghs -h | ||
usage: ghs [-h] [-v] [-t] [-u <username>] [--highlights] [-c] | ||
Get stats and highlights of your github profile. | ||
optional arguments: | ||
-h, --help show this help message and exit | ||
-v, --version print cli version and exit | ||
-t, --token-update update the token in config and exit | ||
-u <username> github username | ||
--highlights display the highlights of user's github profile | ||
-c, --copy-to-clipboard copy the output to clipboard | ||
``` |