Files
kymsu2/README.md
Bruno 21 eaeda193d6 LaunchAgent
-creation de 2 .plist pour lancer automatiquement KYMSU2 et Installed.sh
-màj de la doc
2019-08-11 11:16:04 +02:00

110 lines
2.5 KiB
Markdown

# altKYMSU
altKYMSU is a fork from **KYMSU** (Keep Your macOs Stuff Updated)
https://github.com/welcoMattic/kymsu
## Plug-ins:
- **atom** (plug-ins)
- **homebrew** (brew and cask)
- **installed** (create a list of all your brew, pip, npm... stuffs and a Brewfile).
- **npm** (javascript package) (local or global packages)
- **mas** (Mac Appstore)
- **pip** (Python Package index) (pip or pip3)
- **PECL** (PHP modules)
- **Wordpress** (wp-cli) <u>(for testing only)</u>
## Requirements
- [Homebrew](https://brew.sh/)
- [pipdeptree](https://pypi.python.org/pypi/pipdeptree) for checking dependancies (pip plugin)
## 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`
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
```
`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]* 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`
## 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)