Common
=========

Common user settings and tools used by Jannik Beyerstedt.
This role is compatible with Debian based systems and macOS.


Requirements
------------

none


Role Variables
--------------

This role uses the apt package manager on Debian based hosts.
But for some operating systems the `ansible_os_family` variable is not set to "Debian" by the fact gathering even if it is Debian based (like Mendel GNU/Linux on the Google Coral Dev Board).
- `override_os_family`: Set to "Debian" in the host inventory, if `ansible_os_family` is not set correctly

The User Setup will change the user shell and global gitconfig. This can be disabled:
- `usersetup_chsh`: Boolean to disable changing the user shell to zsh
- `usersetup_gitconfig`: Boolean to disable overriding the global gitconfig

For a GUI/ Desktop machine, you can enable to install and configure VS Code:
- `user_vscode`: Boolean to install and set the basic configuration of VS Code
- `user_lang_cpp`: Boolean to install C/C++ dev tools and configure VS Code
- `user_lang_python`: Boolean to install Python dev tools and configure VS Code
- `user_lang_golang`: Boolean to install Golang dev tools and configure VS Code

The `user_lang_*` switches will also install the language only, if `user_vscode` is set to false.

To install just the dotfiles, set `common_settingsonly` to true.


Dependencies
------------

none


Example Playbook
----------------

You can simply run the whole role:
```yml
- name: Basic User Shell Setup
  hosts: all
  tasks:
  - name: Basics - Update first
    import_role:
      name: common
      tasks_from: update
    when: common_settingsonly | default(false) == false
  - name: Basics - Install essential tools
    import_role:
      name: common
      tasks_from: essentials
    when: common_settingsonly | default(false) == false
  - name: Basics - Install more tools
    import_role:
      name: common
      tasks_from: tools
    when: common_settingsonly | default(false) == false

  - name: Basics - Setup user shell
    import_role:
      name: common
      tasks_from: usersetup
    when: common_settingsonly | default(false) == false
  - name: Basics - Install dotfiles
    import_role:
      name: common
      tasks_from: usersettings

  # Additional Tasks for Specific Host Types (not included in the role's main.yml)

  # more tools for your main machine
  - name: Basics - Install user's working utilities
    import_role:
      name: common
      tasks_from: usertools

  # install programming languages and optionally VS Code
  - name: Basics - Install and configure VS Code
    import_role:
      name: common
      tasks_from: vscode
```

Or call the different tasks individually:
```yml
- name: Basic User Shell Setup
  hosts: all
  tasks:
  - import_role:
      name: common
```


License
-------

GPLv3