Skip to content

Latest commit

 

History

History
72 lines (54 loc) · 3.82 KB

README.md

File metadata and controls

72 lines (54 loc) · 3.82 KB
Raw

EnrolZSH

EnrolZSH is a dead simple zsh script, which provides you with simple deployment commands.

With the first release we introduce autoloading for specific projects. The commands are stored inside the project folder itself (enrol/deploy.zsh). This allows you do store all commands inside version control and makes sure all your coworkers are running the same script. In the next version we will improve this and ship some predefined commands. We'll also allow configuration on project basis. This will remove a lot of complexitity for the developer.

Requirements:

Installation:

  • Clone enrolzsh-plugin into ~/.oh-my-zsh/plugins/
  • Add enrolzsh to the plugins array inside ~/.zshrc.
plugins=(git enrolzsh)
  • Configure the global configuration file inside the enrolzsh plugin ~/.oh-my-zsh/plugins/enrolzsh/.enrolzsh_global.
  • Make sure your folder strucutre looks like this:
    • ER_VM_DIR: Base folder, where the virtual machine lives (e.g ScotchBox)
    • ER_PROJECT_DIR: The public of the VM (mostly .../public)
    • All projects are stored inside the ENROL_PROJECT_DIR
  • Create a enrol folder inside every project you create.
  • Add a deploy.zsh file inside the created enrol folder an add all your scripts there. A boilerplate is linked here: EnrolZSH Project Boilerplate
  • Make sure your current projects are stored inside the global settings. So you don't have to init the project every time.
    • Add a prefix and the directory at the bottom of .enrolzsh_global, like this: test="~/Projects/public/test"
    • Include the prefix inside the variable ER_AUTOLOAD
  • You're ready to go.

Important notes:

Operating system

Enrol supports Linux and MacOS. Windows works mostly iniside it's Unix subsystem, but is not tested and will fall short on certain commands like enrol.finder.

Custom enrol script:

When providing a custom enrol script inside the enrol-directory make sure to prefix variables when using so. Enrol will load your script inside the global context and this has potential for dramatic issues.

Available commands:

Make use of the great gloabing feature inside ZSH by making use of . Type enr and , then again and you will see all your possibilities.

  • enrol: Welcome screen

  • enrol --version: Get installed version

  • enrol --help: Help screen

  • enrol --update: Update enrol when via git, just works when you've cloned the enrolzsh.

  • enrol.projects: Loads all projects from the main project folder (defined inside the global settings) into the namespace. After this command it's possible to call the project via enrol.PROJECT (PROJECT = Folder name without TLD, if you used any). If you have a script called deploy.zsh inside the project it will also work during runtime. This command will do the same as autoload, but only at runtime of the terminal.

  • enrol.base: Return to configured base path.

  • enrol.reload: Reload zsh config - important after adjusting global config.

  • To make it easier for you to grasp all available project right of the but. Every autoloaded project will be accessible under enrol.PREFIX and will direct to the root directory of the project. Just type enrol. + TAB for autocompletion and search for your project.

Some shorthands for vagrant inside the defined VM folder:

  • enrol.vu: vagrant up
  • enrol.vh: vagrant halt
  • enrol.vr: vagrant reload
  • enrol.vs: vagrant ssh
  • enrol.vb: vagrant box update

Helper functions:

  • enrol.helper.finder: Open current directory in finder

Config functions:

  • enrol.config.global: Edit global settings directly in CMD (Nano)
  • enrol.config.finder: Open finder inside enrolzsh plugin directory (MacOS)