Adding bin/setup help + updating README.

 * also adding bin/setup no-git-hook
 * also adding bin/setup help

Author: Konstantin Gredeskoul

README.md

@@ -436,16 +436,51 @@ To get the initial stuff setup required by this repo, please run the script:
 bin/setup
 ```
 
-Whenever you'll commit something, a pre-commit hook will run as well.
+This script does a couple of very useful things, including setting up a git commit
+hook that performs rubocop fixes and buildifier fixes of the Bazel build files.
+
+You can run partial setup comamnds like so:
+
+```bash
+❯ bin/setup -h
+
+USAGE:
+  bin/setup [ gems | git-hook | help | install | main | no-git-hook ]
+
+DESCRIPTION:
+  Runs full setup without any arguments.
+
+  Accepts one argument — one of the actions that typically run
+  as part of setup.
+
+  For instance, to perform full setup:
+
+    bin/setup
+
+  Or, to run only one of the sub-functions (actions), pass
+  it as an argument:
+
+    bin/setup help
+    bin/setup no-git-hook
+
+  etc.
+```
+
+Whenever you'll commit something, a pre-commit hook will run as well. If it
+finds anything that needs fixing, it will attempt to fix it. If the resulting
+git state is different than before the commit, the commit is aborted and the user
+should add any auto-fixed modifications to the list of staged files for commit.
 
 ### Running Tests
 
-We have a handy script you can use to run all tests:
+We have a pretty useful script you can use to run all tests in the repo that run on CI:
 
 ```bash
 bin/ci
 ```
 
+On a MacBook Pro it takes about 3 minutes to run.
+
 ## Copyright
 
 © 2018-2019 Yuki Yugui Sonoda & BazelRuby Authors

bin/setup

@@ -1,21 +1,68 @@
 #!/usr/bin/env bash
-
+#
+#
+# 
 set -e
 # shellcheck disable=SC1091
 source "bin/deps"
 
+__setup::actions() {
+  local sep="${1:-', '}"
+  printf "${bldylw}$(lib::array::join "${sep}" $(lib::util::functions-matching setup::))"
+}
+
+setup::help() {
+  printf "
+${bldpur}USAGE:${clr}
+  bin/setup [ $(__setup::actions " | ")${clr} ]
+
+${bldpur}DESCRIPTION:${clr}
+  Runs full setup without any arguments. 
+
+  Accepts one argument — one of the actions that typically run
+  as part of setup.
+
+  For instance, to perform full setup:
+
+    ${bldylw}bin/setup${clr}
+
+  Or, to run only one of the sub-functions (actions), pass 
+  it as an argument:
+    
+    ${bldylw}bin/setup help${clr}
+    ${bldylw}bin/setup no-git-hook${clr}
+
+  etc.
+ "
+}
+
+
+
 setup::gems() {
   for gem in rubocop relaxed-rubocop rubocop-performance; do
     lib::gem::install ${gem}
   done
 }
 
-setup::git() {
-  inf 'Installing git pre-commit hook'
+setup::no-git-hook() {
+  set -e
+  [[ -L .git/hooks/pre-commit ]] && {
+    info 'Removing git commit hook...'
+    run "rm -f .git/hooks/pre-commit"
+    echo
+  }
+  set +e
+}
+
+setup::git-hook() {
   set -e
-  [[ -L .git/hooks/pre-commit ]] || run "cd .git/hooks && ln -nfs ../../bin/pre-commit pre-commit"
+  if [[ ! -L .git/hooks/pre-commit ]]; then
+    info 'Installing git pre-commit hook'
+    run "cd .git/hooks && ln -nfs ../../bin/pre-commit pre-commit && cd -"
+  else
+    info: "git pre-commit hook is already installed."
+  fi
   set +e
-  ok:
 }
 
 setup::install() {
@@ -36,27 +83,35 @@ setup::install() {
       /usr/bin/env bash bin/show-env || true
     fi
   else
-    error "Operating system $(uname -s) is not currently supported." >&2
+    error "Operating system ${os} is not currently supported." >&2
   fi
   echo
   return 0
 }
 
 setup::main() {
   local action="$1"
+  [[ "${action}" == "-h" || ${action} == "--help" ]] && action="help"
   local func="setup::${action}"
 
-  if lib::util::is-a-function "${func}"; then
-    h2 "Executing partial setup for action ${bldylw}${action}"
-    shift
-    ${func} "$@"
+  if [[ -n ${action} ]] ; then
+    if lib::util::is-a-function "${func}"; then
+      [[ ${action} != "help" ]] && h2 "Executing partial setup for action ${bldylw}${action}"
+      shift
+      ${func} "$@"
+    else
+      h1 "Invalid action provided." "Valid actions are: $(__setup::actions)"
+      exit 1
+    fi
   else
     set +e
     h2 "Installing required development dependencies for working with rules_ruby and Bazel."
     setup::gems
-    [[ -z ${CI} ]] && setup::git
+    [[ -z ${CI} ]] && setup::git-hook
     setup::install "$@"
   fi
 }
 
 setup::main "$@"
+
+