New Component gist - manage gist in CLI (#213)

* New Component gist - manage gist in CLI

run
  ./gist/gist help

for more information

* Fix some typo, comments and outdated code

* Remove unnecessary quotes with bash syntax

* Improve code for configuration

- in ~/.config/gist.conf, quote every value to include spaces
  (mainly for key 'action')
- skip prompt for username when not necessary
- improve syntax

* Use variable to configure behavior

- mark 's' for starred gist
- hint for showing hint or helper message, default to be true
- when create/edit a gist, disable helper message

* Improve auto_sync feature

Default to be true. When doing `gist fetch` and some gists is not cloned yet,
show 'cloning' when it is true, 'not cloned yet' if false (since we are
not cloning repo).

* Add README for gist

* Add more introduction into README

* Improve helper message

* Improve code with shellcheck

* Remove trailing spaces

* Fix behavior when fetching gist

Just return 0 when there are no gist in response

* Add variable for delete confirmation

* Add parameter to specify decription when editing

* Fix invalid syntax causes error

* Update tests

Includes the following 14 tests:
1. Tool name
2. Tool version
3. Tool update
4. gist help
5. gist config (for user)
6. gist config (for token)
7. gist new
8. gist fetch
9. gist fetch star
10. gist
11. gist <index>
12. gist edit
13. gist delete
14. gist user

* Improve edit command

Do not fetch gists again, use response to update local index file

* Improve fetch command up to 100 gists

Still, need a way to deal with Github pagination if user's gists is more
than 100.

ref:
https://developer.github.com/v3/guides/traversing-with-pagination/

* Fix invalid token in test

Since Github check every commit to not include user token,
concat strings to avoid this.

* Fix syntax error from 4f4f27f

* Fix test on Travis CI

- Use script from repo, or test for gist would fails
- Add gist into install.sh

* Fix code for test from 821eb99

* Fix return value for fetch command

return 0 anyway even if fail to sync repos

* Improve code syntax with shellcheck

* Add configuration for git protocol

Default to HTTPS, this should suppress the ssh key setting for some
users.

* Change test pattern to be simpler

* Improve edit commend

Allow cursor to scroll back when editing new description

* Improve user command up to 100 gists

Just like what 3e8e57e did

* Improve test condition

Narrow down the scope of alnum.
Also, use pattern for test of user command.

* Color description text with braces

* Fix/Improve helper message

* Fix bug about folder configuration

If user gives folder with empty string or not writable,
set it to default value `~/gist`.

* Improve code style

* Fix typo and missing link

* Replace default action with hint

* Update README

* Fix bug about private mark

Variable 'mark' should be reset everytime, or the value from previous
line would persist.

* Return false instantly when the given id is not valid

* Change remote url if user configure protocol

* Add error message for gist config

* Fix bug about parsing starred gists

* Refactor code for marking star/non-star gist

* Refactor behavior about subcommand detail

- Store created/updated time inside index file
- gist detail only shows the content from index file

* Fix missing argument of sed for darwin

* Update output of 'gist user'

* Fix default configuration for 'gist fetch'

* Show working when checkout to non-master branch

* Update helper message and todo item

* Improve 'gist grep'

Now it supports description, filename and file content

* Suppress wrong status message with merged commit

* Remove unnecessary exit statement

* Change format when creating a new gist

* Update todo items

* Update comments for functions

* Refactor code to reduce repetitive text

* Update test to fit changes in 85fb3dd

* Update todo items

* Add blink visuals to indicate valid indices

* Refactor code for order of functions

* Improve 'gist push'

Allow empty index if user is already inside repo

* Refactor code for readibility

* Update README

* Fix potential error when getting ID from a given index

Originally, if user gives command like 'gist .', _gist_id() still
returns true

* Reformat list of starred gist

* Refactor code

* Improve/Fix 'gist edit'

- Prefill with original description
- Fix pattern when editing is finished
- Fix unnecessary prefix for result when edit is done

* Refactor code about INDEX file format

Refactor code to reduce potential code changes when INDEX file format
changes

* Improve 'gist push'

- Allow directly push if commit is ready
- Only push when current commit is ahead

* Add new subcommand 'gist tag'

* Apply hashtags to 'gist detail'

- a standalone function to extract hashtags from description
- in 'gist detail', split puse description and trailing tags into 2
  lines for a clear format

* Add definition for characters used in tag

* Modify sub-commands for tags

- 'gist tag' to show gist list without url but tags insdead
- 'gist tags' to list existing tags

* Fix column difference caused by color control code

* Modify hint wording

* Fix logic error with index prefix

It loses prefix 'p' for newly created private gist
Fow now, decide prefix only in _parse_response()

* Reformat 'gist detail'

* Modify parameter for 'gist delete'

Use environment variable is too risky here

* Fix logic error about format

Original approach also replace ', ' with ',' in description

* Add todo item

* Refactor code

* Modify behavior for 'gist tag'

- Always print list with tag=true
- Let tags align right

* Add new subcommand 'gist pin'

* Fix logic error with invalid index

* Modify short subcommand for user form U to u

* Improve 'gist tags' and 'gist pin'

'gist tag'
- Replace hint with pinned tags

'gist tags'
- Display each line by the first charactor
- highlight pinned tags
- Show pinned tags at the bottom

'gist pin'
- With given tags, update pinned tags and do 'gist tags' again
- With no aguments, print gists with pinned tags

* Improve code readibility

* Add color for pinned tags in 'gist tag'

* Add todo items

* Add pipe support

* Fix format for showing author

prevent author name concates file number if its length > 12

* Refactor code for tag condition, speed up 'gist tag'

* Improve sed usage

* Add subcommand 'gist all'

To show both user gists and starred gist

* Update helper message

* Update helper message

* Fix dotfile is gone in 'gist detail'

* Reformat star list

* Add language support

* Prevent language contains space

* Replace non-parsable file type into 'Text'

* Reformat index to let pipe easier

Make sure no space in front of index, this helps commands
like 'cut' works without extra processing

* Add default action 'into subshell'

* Improve syntax

* Fix logic error in 'gist grep'

Remove content greping for hashtags inside original description

* Fetch gists after doing 'git push'

* Refator grep in 'gist grep' to speed up

* Add alert message when index file is empty

* Update hint message

* Add subcommand 'gist lan'

* Add parameter for index range

* Suppress hint when STDIN is not empty

* Add subcommand 'gist last'

* Supress hint message when command is in pipe

* Fix logic error about action

* Fetch in background when 'gist push' is performed

* Update comments

* Add hint for mtime of INDEX file

* Fix runtime error

Only output the first line of grep result in files

* Improve 'gist detail'

Make it works without index if working dir is a gist repo

* Refactor code

* Refactor code

* Add gist into install/uninstall script

Also, with alphabetical order

* Add description into README

* Refactor helper message for general use case

* Chech internet when using Github API

* Fix hint configuration

* Update manual

* Fix error message for 'gist detail'

when there is no valid index, show error message

* Update README

Now it contains contents with new sub-commands:
tag, tags, pin, lan

* Update README

Correct titile level

* Improve README with wording

* Fix 'gist detail' inside repo

* Improve 'gist help' with proper pattern

* Enable backspace and readline hotkeys with 'gist new'

* Improve 'gist tag <tag-value>'

Use user put '.' as pattern, treat them as '[^ ]'

* Update helper message and comments

* Pin tags with regex pattern

* Update todo items

* Refactor the way of checking repo status

* Add configuration 'show_untagged'

* Make Command Substitution works with configuration

* Process more after 'gist fetch'

* Remove outdated TODO items

* Add processing for filename with space

* Fix/Refactor the way to process description

* Merge branch 'tag-refactor'

* Remove method checkInternet

All API calls github.com, do not need this.

* Add shorter argument '-n' for '--no-action'

* Update todo items

* Refactor code

* Update hint

* Fix Mac Compatibility

Looks like alias fails in bash script, even after adding:
  shopt -s expand_aliases

* Improve removing temporary files

- Specify directory instead of each files to remove
- background job cannot be trapped, so need to call script again

* Remove temporary file after user create a gist

* Add option to debug with log

* Allow remove token

* Mac compatibility for 'mktemp'

* Fix error on Mac when getting gist ID

* Fix bats test with latest changes

- Use 'gist' instead of 'todo' to get version
- 'gist <index>' returns path at the last line
- Config file keeps value without single quote now
- Use 'gist detail' to check description is modified by 'gist edit'
  Since the output of 'gist edit' might hides description by small
  screen width

* Remove finished todo item

* Refactor variable 'mark'

- make it global and export it to sub-shell
- refator _sync_repos(), now only do 'git pull' in repos that:
  1. Already cloned before
  2. Fit the mark. That is, either user's gist or starred gists

* Refactor code

* Use valid URL when export to github

Also change some texts

* Refactor code

* Improve sub-command 'tag', 'edit' and 'new'

1. By default, do not shows tags for starred gist
2. Tags user typed allow any number of leading '#'
3. Fix the parameter of 'gist edit', it takes arguemnts behind $1 as
   description
4. An easy to read way to wrap JSON body

* Fix sed compatibility for BSD version

* Use simpler way to clone repo in background

And this way also do not need to export variables into new bash instance

* Initialize variables to avoid affetcted by env variables

* Update hint text for 'gist clean'

* Show status with description, do not override file_num and comment_num

* Refactor mark usage

So by default, 'gist lan' won't show starred gists

* Suppress error msg with insane filename

* Change hint and helper message by script name

* Also use variable to set hint and helper message

* Fix logic error in helper message

* Update comments, helper msg and todo items

* Refactor code in _configure()

* Refactor code

* Refactor _show_list()

* Fix json processing for 'edit'

Looks like xargs cannot handle too many texts

* Improve README with wording

* Update README

* Add configuration 'show_untagged'

Co-authored-by: HackMD <no-reply@hackmd.io>
Co-authored-by: GeoThings <geothings@GeoThingss-MacBook-Pro.local>

Author: 3 people

README.md

@@ -129,6 +129,24 @@ Provides data for  wan, lan, router, dns, mac, and ip geolocation
 Written by: [Jake Meyer](https://github.com/jakewmeyer)
 </details>
 
+<details>
+<summary>Gist</summary>
+
+Manage your gist like a pro
+
+Clone your owned gists and starred gists as git repos, and Fetch/Create/Edit/Delete them with Github API. It also supports quick search with hashtag and contents.
+
+For more information, please go through the [guide](gist/README.md)
+
+<div align="center">
+
+<img max-height="500px" max-width="500px" src="https://github.com/alexanderepstein/Bash-Snippets/blob/master/gist/gist.png?raw=true">
+
+</div>
+
+Written by: [typebrook](https://github.com/typebrook)
+</details>
+
 <details>
 <summary>Lyrics</summary>
 

bash-snippets.1

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "BASH\-SNIPPETS" "1" "December 2017" "ff" ""
+.TH "BASH\-SNIPPETS" "1" "April 2020" "" ""
 .
 .SH "NAME"
 \fBbash\-snippets\fR \- A collection of small bash scripts for heavy terminal users
@@ -274,6 +274,91 @@ Example: geo \-a 8\.8\.8\.8 \-o city,zip,isp
 .
 .IP "" 0
 .
+.SS "Gist"
+Description: Manage your gists with git and Github API v3
+.
+.P
+Usage: gist [command] [args]
+.
+.IP "\(bu" 4
+[star|all] List your gists, use \'star\' as argument for your starred gists, \'all\' or \'a\' for both your and starred gists\. Format for each line is: \fIINDEX\fR \fIURL\fR \fIFILE_NUM\fR \fICOMMENT_NUM\fR \fIDESCRIPTION\fR
+.
+.IP "\(bu" 4
+fetch Update the local list of your gists, \'star\' as argument for your starred gists
+.
+.IP "\(bu" 4
+\fIINDEX\fR Show the path of local gist repo and do custom actions
+.
+.IP "\(bu" 4
+new Create a new gist with files or STDIN
+.
+.IP "\(bu" 4
+grep Grep gists by description, filename and content with a given pattern
+.
+.IP "\(bu" 4
+tag Modify/List tags for a gist
+.
+.IP "\(bu" 4
+tags List all tags and pinned tags
+.
+.IP "\(bu" 4
+pin, Pin/Unpin tags, or filter gists with pinned tags
+.
+.IP "\(bu" 4
+lan Filter gists or list gist with coding languages
+.
+.IP "\(bu" 4
+detail Show the detail of a gist
+.
+.IP "\(bu" 4
+edit Edit description for a gist
+.
+.IP "\(bu" 4
+delete Delete gists by given indices
+.
+.IP "\(bu" 4
+push Push changes by git
+.
+.IP "\(bu" 4
+clean Clean local repos of removed gists
+.
+.IP "\(bu" 4
+config Do configuration
+.
+.IP "\(bu" 4
+user Get list of gists with a given Github user
+.
+.IP "\(bu" 4
+github Import selected gist as a new Github repo
+.
+.IP "\(bu" 4
+help Show the helper message
+.
+.IP "" 0
+.
+.P
+Example:
+.
+.IP "\(bu" 4
+gist (Show your gists)
+.
+.IP "\(bu" 4
+gist tag (Show your gists with tags)
+.
+.IP "\(bu" 4
+gist fetch (update the list of gists from github\.com)
+.
+.IP "\(bu" 4
+gist 3 (show the repo path of your 3rd gist, and do custom actions)
+.
+.IP "\(bu" 4
+gist 3 \-\-no\-action (show the repo path of your 3rd gist, and do not perform actions)
+.
+.IP "\(bu" 4
+gist new \-\-desc bar foo (create a new gist with files and description)
+.
+.IP "" 0
+.
 .SS "Lyrics"
 Description: Fetch lyrics for a certain song\.
 .