profile_d

An Ansible role to manage the current user's Bash or ZSH shell profile via a Debian-like .d directory.

Requirements

Control Node

None

Remote Node

None

Role Defaults

Variable	Type	Default Value	Description
profile_d_shell	str	"{{ ansible_user_shell }}"	The shell to configure.

Dependencies

None

Example Playbook

- hosts: my-workstation
  roles:
    - profile_d

License

MPL-2.0

Author Information

This role was created in 2020 by Brandon McNama.

Development

Dev Requirements

• Ruby 2.7 or later
• Python 3.8 or later
• Poetry 1.1 or later

This repository supports asdf for language selection.

Installation

bundle install --path vendor/bundle --jobs 2 --clean && poetry install --remove-untracked

Running linters

poetry run pre-commit

Running tests

This role uses Test Kitchen and Inspec for testing instead of Molecule. This is done in order to more easily support multiple testing drivers (both docker and exec) to ease testing on multiple operating systems.

There are 2 suites:

• The default suite is aimed at testing against Linux hosts using bash as the default shell. This suite uses docker to test multiple variants of ubuntu.
• The zsh suite is aimed at testing against MacOS using zsh as the default shell. This suite uses the exec driver to execute commands against the current host and is intended to be run against a CI runner host, such as in GitHub Actions.

To run tests, run bundle exec poetry run kitchen test <suite name>.