Settings + readme

README.md

@@ -4,39 +4,96 @@ https://github.com/welcoMattic/kymsu
 
 
 
-### Plug-ins:
+## Plug-ins:
 
 - **atom** (plug-ins)
 - **homebrew**  (brew and cask)
 - **installed** (create a list of all your brew, pip, npm... stuffs). 
-- **npm** (javascript package) (local or global package)
-- **mas** (Mac Appstore) plugin for KYMSU
+- **npm** (javascript package) (local or global packages)
+- **mas** (Mac Appstore)
 - **pip** (Python Package index) (pip or pip3)
 - **PECL** (PHP modules)
 - **Wordpress** (wp-cli) (for testing only)
 
+ 
 
-
-### Requirements
+## Requirements
 
 - [Homebrew](https://brew.sh/)
 - [pipdeptree](https://pypi.python.org/pypi/pipdeptree) for checking dependancies (pip plugin)
 
 
 
-### Installation
+## Installation
 
-`$ git clone git@github.com:Bruno21/kymsu.git && cd kymsu && ./install.sh`
+`$ git clone git@github.com:Bruno21/kymsu.git && cd kymsu2 && ./install.sh`
+
+A symbolic link is created in `/usr/local/bin/`
+
+Plug-ins are placed in `~/.kymsu/`
 
 
 
-### Credit
+## Usage
+
+Only update all the things:  `$ kymsu2` 
+
+With cleanup after updates: `$ kymsu2 --cleanup`
+
+No distract mode  (no user interaction):`$ kymsu2 --nodistract`
+
+Prefix plugin with a _ to ignore it:
+
+```bash
+# _wp.sh is disabled (still beta)
+~/.kymsu/plugins.d $ ls
+00-kymsu.sh _wp.sh      atom.sh     homebrew.sh mas.sh      npm.sh      pecl.sh     pip.sh
+```
+
+
+
+## Settings
+
+ There is a <u>settings section</u> on top of each plug-in:
+
+- *[homebrew-pip]* don't update a module, package...: add it to the `do_not_update` array on the top.
+
+```bash
+$ nano homebrew.sh
+declare -a do_not_update=('virtualbox,virtualbox-extension-pack')
+```
+
+- *[homebrew]* display info on updated pakages: `display_info=true`
+- *[homebrew-npm-pecl-pip]* no distract mode  (no user interaction): `no_distract=false`
+  *If running Homebrew plug-in in no_distract mode, Casks with 'latest' version number won't be updated.*
+- *[npm]* run npm maintenance tools: `doctor=true`
+- *[pip]* `version=pip or pip3`  `user="" or "--user"`
+
+
+
+## Update
+
+Git pull and re-run install.sh:
+
+`$ cd kymsu2 && git pull && ./install.sh`
+
+
+
+## Uninstall
+
+Run uninstall.sh:
+
+`$ cd kymsu2 && ./uninstall.sh`
+
+
+
+## Credit
 
 All credit goes to [welcoMattic](https://github.com/welcoMattic/kymsu)
 
 
 
-### License
+## License
 
 Same as KYMSU (MIT)
 

install.sh

@@ -9,6 +9,6 @@ ln -fs "${KYMSU_PATH}"/kymsu2.sh /usr/local/bin/kymsu2
 mkdir -p ~/.kymsu && echo "${KYMSU_PATH}" > ~/.kymsu/path
 cp -R "${KYMSU_PATH}/plugins.d" ~/.kymsu
 
-echo "KYMSU2 has been installed. Run kymsu2 command!"
+echo "altKYMSU has been installed. Run kymsu2 command!"
 echo "It's a fork from https://github.com/welcoMattic/kymsu"
 echo "All credits to welcoMattic"

kymsu2.sh

@@ -1,9 +1,9 @@
 #!/usr/bin/env bash
 
 if [[ "$1" == "-h" || "$1" == "--help" ]]; then
-  echo -e "\033[93m\033[1mkymsu2\033[0m"
+  echo -e "\033[93m\033[1maltKymsu\033[0m"
   echo ""
-  echo "Keep Your macOs Stuff Updated 2"
+  echo "alt Keep Your macOs Stuff Updated"
   echo "a fork from kymsu https://github.com/welcoMattic/kymsu"
   echo
   echo "USAGE: kymsu2"
@@ -16,6 +16,7 @@ if [[ "$1" == "-h" || "$1" == "--help" ]]; then
   echo
   echo "Tips:"
   echo " -prefix the plugin with _ to ignore it"
+  echo " -see Settings section on top of each plug-in"
   echo
   exit 0
 fi

plugins.d/homebrew.sh

@@ -9,6 +9,10 @@
 # ou
 # /usr/bin/find "$(brew --prefix)/Caskroom/"*'/.metadata' -type f -name '*.rb' -print0 | /usr/bin/xargs -0 /usr/bin/perl -i -0pe 's/depends_on macos: \[.*?\]//gsm;s/depends_on macos: .*//g'
 
+#########################################
+#
+# Settings:
+
 # Display info on updated pakages 
 display_info=true
 
@@ -17,6 +21,8 @@ declare -a do_not_update=('virtualbox,virtualbox-extension-pack')
 
 # No distract mode (no user interaction)(Casks with 'latest' version number won't be updated)
 no_distract=false
+#
+#########################################
 
 if [[ $1 == "--nodistract" ]]; then
 	no_distract=true

plugins.d/npm.sh

@@ -16,14 +16,25 @@
 
 # https://github.com/npm/npm/issues/17744
 
-# No distract mode
+#########################################
+#
+# Settings:
+
+# No distract mode (no user interaction)
 no_distract=false
 
-doctor=false
+if [[ $1 == "--nodistract" ]]; then
+	no_distract=true
+fi
+
+# Set doctor=true to run 'npm doctor' and 'npm cache verify' each time
+doctor=true
 
 # Local install
 local_path=$HOME/Sites/node_modules/
 
+#########################################
+
 echo -e "\033[1m🌿  npm \033[0m"
 echo ""
 
@@ -115,9 +126,9 @@ if [ "$doctor" = true ]; then
     echo ""
 fi
 
-
-if [[ $1 == "--npm_cleanup" ]]; then
-
+#if [[ $1 == "--npm_cleanup" ]]; then
+if [[ $1 == "--cleanup" ]]; then
+	echo "npm cache clean"
 	# As of npm@5, the npm cache self-heals from corruption issues and data extracted from the cache is guaranteed to be valid. 
 	# If you want to make sure everything is consistent, use 'npm cache verify' instead. 
 	# On the other hand, if you're debugging an issue with the installer, you can use `npm install --cache /tmp/empty-cache` to use a temporary cache instead of nuking the actual one.

plugins.d/pecl.sh

@@ -5,8 +5,18 @@
 
 # https://pecl.php.net
 
+#########################################
+#
+# Settings:
+
 # No distract mode (no user interaction)
 no_distract=false
+#
+#########################################
+
+if [[ $1 == "--nodistract" ]]; then
+	no_distract=true
+fi
 
 echo -e "\033[1m🐘 pecl \033[0m"
 

plugins.d/pip.sh

@@ -3,6 +3,10 @@
 # pip plugin for KYMSU
 # https://github.com/welcoMattic/kymsu
 
+#########################################
+#
+# Settings:
+
 #version: pip ou pip3
 version=pip3
 #user: "" or "--user"
@@ -11,6 +15,8 @@ user=""
 no_distract=false
 #add module to do_not_update array
 declare -a do_not_update=()
+#
+#########################################
 
 if [[ $1 == "--nodistract" ]]; then
 	no_distract=true

uninstall.sh

@@ -3,4 +3,4 @@
 rm -rf $(which kymsu2)
 rm -rf ~/.kymsu
 
-echo "KYMSU2 has been uninstalled."
+echo "altKYMSU has been uninstalled."