# altKYMSU
altKYMSU is a fork from **KYMSU** (Keep Your macOs Stuff Updated)
https://github.com/welcoMattic/kymsu

Each plugin notifie you about available update and upgrade apps and packages.

homebrew and pecl plugins notifie you if apache/php configuration files have been modified.



## Plug-ins:

- **atom** ([plug-ins](https://atom.io/packages/list))
- **antibody** ([zsh plug-ins](https://getantibody.github.io))
- **gem** ([Ruby](https://rubygems.org))
- **homebrew**  ([brew and cask](https://formulae.brew.sh))
- **installed** (create a list of all your brew, pip, npm... stuffs and a Brewfile). 
- **nodejs** ([npm package](https://www.npmjs.com)) (local or global packages) (can update [nvm](https://github.com/nvm-sh/nvm) script)
- **mas** (Mac Appstore)
- **pecl** ([PHP modules](https://pecl.php.net)) (<u>for testing only</u>)
- **perl** (Perl modules ([cpan](https://metacpan.org)))
- **pip** ([Python Package index](https://pypi.org)) (pip or pip3)
- **pipx** ([Python Apps in Isolated Environments](https://pypa.github.io/pipx/))
- **rust** ([Rust](https://www.rust-lang.org))
- **venv** ([Environnement virtuel Python](https://docs.python.org/3/library/venv.html))
- **wp** (WordPress [wp-cli](https://wp-cli.org/fr/)) <u>(for testing only)</u>

 

## Requirements

- [Homebrew](https://brew.sh/)
- [jq](https://github.com/stedolan/jq) *(brew install jq)* for processing JSON data (homebrew plugin)

Optionnal:

- [pipdeptree](https://pypi.python.org/pypi/pipdeptree) *(pip install pipdeptree)* for checking dependancies (pip plugin)
- [terminal-notifier](https://github.com/julienXX/terminal-notifier) *(brew install terminal-notifier)* for sending macOS notification (all plugins)
- ~~[Bash 5](https://www.gnu.org/software/bash/) *(brew install bash)* for associative array (homebrew plugin)~~ (homebrew plugin 2.0)



## Installation

`$ 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/`



## Usage

Only update all the things:  `$ kymsu2` 

Run only 1 script: `$ kymsu2 -s homebrew` (option -s and name of script without extension)

With cleanup after updates: `$ kymsu2 --cleanup`

No distract mode (no user interaction):`$ kymsu2 --nodistract` `$ kymsu2 -n` (update without confirmation)

Help: `$ kymsu2 --help` `$ kymsu2 -h`

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
```

`Installed.sh` create a Markdown file with all yours installed stuffs and a Brewfile. I suggest to disable the plugin and run it manually.



## Settings

 There is a <u>settings section</u> on top of each plug-in:

- *[homebrew-pip-nodejs]* 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-nodejs-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.*
- *[nodejs]* 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`



## Automate

altKYMSU comes with 2 **.plist** files (one for kymsu2, one for installed.sh) to automate the use of KYMSU.  Please edit and drag them into the folder ~ / Library / LaunchAgents

For configure LaunchAgent, I suggest [LaunchControl](http://www.soma-zone.com).



## Uninstall

Run uninstall.sh:

`$ cd kymsu2 && ./uninstall.sh`



## Credit

All credit goes to [welcoMattic](https://github.com/welcoMattic/kymsu)



## License

Same as KYMSU (MIT)