TOOCS / Ansible Role: TOOCS.zsh

/!\ This role has a new name - Previous name: FlorianKempenich.zsh /!\

This role installs zsh and makes it the default shell.
You can also choose to install antigen.

What is TOOCS?

TOOCS stands for The Opinionated One-Click Setups, which includes tools and Ansible roles to set up a system quickly. They provide a straightforward and reliable way to install a specific tool. You can use them directly or look at the code for a step-by-step guide.

As the name suggests, they have specific opinions: they will install the tool in one click, but they do not guarantee a consistent method of doing so. New versions may introduce changes that could break things.
Make sure to read the code to understand what it does!

Requirements

This role works only on Ubuntu/Debian and OSX.

If you install antigen, remember to add its configuration to your .bashrc or .zshrc.
Example antigen configuration for .zshrc:

source ~/.antigen/antigen.zsh

antigen use oh-my-zsh

antigen bundle virtualenvwrapper
antigen bundle zsh-users/zsh-syntax-highlighting
antigen bundle zsh-users/zsh-autosuggestions

antigen theme agnoster

antigen apply

Role Variables

By default, this role will install antigen.
To skip the installation, set the variable skip_antigen to true.

Example Playbook

Basic installation with antigen:

- hosts: sandbox
  roles:
      - TOOCS.zsh

Installation without antigen:

- hosts: sandbox
  tasks:
    - include_role:
        name: TOOCS.zsh
      vars:
        skip_antigen: true

License

MIT

Author Information

Learn more about my work: Florian Kempenich