From a966d5d4013d6ffa2e9d33b0c3644d6e0cea414c Mon Sep 17 00:00:00 2001
From: gjbae1212
Date: Wed, 19 Feb 2020 10:23:05 +0900
Subject: [PATCH] Update README.
---
README.md | 95 ++++++++++++++++++++++++++++++++++++++++++++++++++++---
1 file changed, 91 insertions(+), 4 deletions(-)
diff --git a/README.md b/README.md
index a1ed059..f10cdb8 100644
--- a/README.md
+++ b/README.md
@@ -6,15 +6,15 @@
-**FindGS** searches **your starred github repositories** that matched your input text from README, Name, Topic, Description.
+**FindGS** searches for **your starred repositories** in Github that are matched your input text to README, Name, Topic, Description.
**Motivation**
Maybe you have many starred repositories in github for using it in someday.
With stacking more and more your starred repositories, you can **difficult** to find **wanted repositories** in starred repositories.
-Because Github doesn't officially support to search it from README.
+Because github site doesn't officially support to search for it in README.
**FindGS** is an interactive CLI using your github token for searching repositories.
-> Notice that **FindGS** is using boltDB(cached) and bleve(indexing) internally.
+> Notice that **FindGS** makes internally caching db and indexing in local.
> Because Github API is limited 5000 per hourly, so it's required something for caching and for searching with higher performance.
> And **FindGS** updates cached data an interval of 1 hour when running it.
@@ -23,11 +23,98 @@ It's implemented using **Golang**.
-
+
## Getting Started
+
### Prerequisite
+It's required [**github personal access token**](https://github.com/settings/tokens).
+
+
+
+
+
+
+**This token should set global environment or pass to **findgs**.**
+```bash
+# EX1)
+export GITHUB_TOKEN=your-token # .zshrc or .bash_profile
+findgs run
+
+# EX2)
+findgs run -t your-token
+```
+
### Install
+Use to **Homebrew** if you want to install mac, but also you can download from [**releases**](https://github.com/gjbae1212/findgs/releases).
+```bash
+# mac
+$ brew tap gjbae1212/findgs
+$ brew install findgs
+
+# linux
+$ wget https://github.com/gjbae1212/findgs/releases/download/v1.0.1/findgs_1.0.1_Linux_x86_64.tar.gz
+
+# window
+$ wget https://github.com/gjbae1212/findgs/releases/download/v1.0.1/findgs_1.0.1_Windows_x86_64.tar.gz
+```
## Features
+**FindGS** is currently to support the following features:
+- ```findgs clear```
+- ```findgs run```
+------
+#### findgs clear
+Delete cached db and indexed data in local.
+```bash
+$ findgs clear
+```
+------
+#### findgs run
+Run an interactive CLI for searching your starred repositories in Github.
+```bash
+$ findgs run # need to `export GITHUB_TOKEN=your-token`
+
+or
+
+$ finds run -t your-token
+```
+----
+
+**An interactive CLI is currently to support the following commands:**
+
+**search**
+`search` command searches your starred repositories using input text. Also it's to support wildcard searching.
+```bash
+>> search cli tool for aws or gcp
+>> search hello*
+```
+
+**open**
+`open` command show your selected repository to browser.
+```bash
+>> open name blahblah
+```
+
+**list**
+`list` command show recently searched result.
+```bash
+>> list
+```
+
+**score**
+`score` command sets a score that can search repositories equal to or higher than the score.( 0 <= score)
+```bash
+# default score 0.1
+>> score 0.5 # change score to 0.5
+```
+
+**exit**
+`exit` program.
+```bash
+exit
+```
+------
+
## License
+This project is following The MIT.