This role builds and returns Base16 themes. Base16 is a framework for generating themes for a wide variety of applications like Vim, Bash or i3 with color schemes like Tomorrow Night or Gruvbox.
This builder's goal is to make it easy to install and update Base16 colors across a wide range of applications. Using Ansible as a Base16 builder gives us a lot of flexibility. We can generate themes and either write them as standalone files or embed the theme into larger config file templates. This is particularly useful for applications that can only handle a single config file, like i3.
Instead of downloading pre-rendered color scheme templates, this role builds them on the fly. This lets us use Base16 color schemes that older template repos might not have picked up yet, as well as ensuring that we're always using the latest version of existing color schemes.
It currently implements vesion 0.9.1 of the Base16 spec.
---
roles:
- mnussbaum.base16-builder-ansible
tasks:
# Build a single color scheme and template and assign it to a variable
- base16_builder:
scheme: tomorrow-night
template: shell
register: base16_schemes
# It helps to print out the registered result once with debug to figure out how
# to access any particular scheme and template. Each Base16 template repo (e.g.
# "shell", "i3") can include multiple template files to render out, so every
# template repo will register their output at a slightly different index path in
# the result object.
- debug:
var: base16_schemes
# I'll elide the rendered contents for readability, but result will look like this:
#
# "base16_schemes": {
# "changed": true,
# "failed": false,
# "schemes": {
# "tomorrow-night": {
# "shell": {
# "scripts": {
# "base16-tomorrow-night.sh": "#!/bin/sh\n# base16-shell ..."
# }
# },
# "scheme-variables": {
# "base00-dec-b": "0.12941176470588237",
# "base00-dec-g": "0.12156862745098039",
# "base00-dec-r": "0.11372549019607843",
# "base00-hex": "1d1f21",
# "base00-hex-b": "21",
# "base00-hex-g": "1f",
# "base00-hex-r": "1d",
# "base00-rgb-b": "33",
# "base00-rgb-g": "31",
# "base00-rgb-r": "29",
# ...Many more color variables...
# "scheme-author": "Chris Kempson (http://chriskempson.com)",
# "scheme-name": "Tomorrow Night",
# "scheme-slug": "tomorrow-night",
# "scheme-slug-underscored": "tomorrow_night"
# }
# }
# }
# }
# You can write the generated color schemes to a file or render them into your
# own templates
- copy:
content: "{{ base16_schemes['schemes']['tomorrow-night']['shell']['scripts']['base16-tomorrow-night.sh'] }}"
dest: /my/bash/profile/dir/tomorrow-night-shell.sh
# Build every template for a single color scheme
- base16_builder:
scheme: tomorrow-night
register: base16_schemes
# Build every color scheme for a single template
- base16_builder:
template: shell
register: base16_schemes
# Build every color scheme for every template
- base16_builder: {}
register: base16_schemes
# Build every color scheme for a few select templates
- base16_builder:
template:
- shell
- i3
- qutebrowser
register: base16_schemes
# Download latest color scheme and template source files, but don't build anything
- base16_builder:
update: yes
build: no
# Download updates for and rebuild a single template and scheme
- base16_builder:
update: yes
scheme: tomorrow-night
template: shell
register: base16_schemes
# If you make your own Base16 color scheme and want to reference it before it's
# pulled into the master list of schemes you can fork the master list, add a
# reference to your scheme, and then use your list fork as the schemes source
# arg here. The same applies to new template repos and the master template
# list. Those master lists are available at:
#
# https://github.com/chriskempson/base16-schemes-source
# https://github.com/chriskempson/base16-templates-source
#
- base16_builder:
scheme: my-brand-new-color-scheme
template: shell
schemes_source: http://github.com/my-user/my-schemes-source-fork
templates_source: http://github.com/my-user/my-templates-source-forkscheme:
description:
- Set this to the name of a color scheme to only build that one scheme, instead of building all, which is the default
- Only building a single scheme is much faster then building all
required: false
type: string
default: Build all schemes
scheme_family:
description:
- Set this to the name of a group of schemes that live in a single repo (i.e. a family) to only build that group of schemes
- If this is unset, and a scheme argument is passed, it's expected the scheme name is present in the scheme family name. E.g. Scheme family "tomorrow" is present in scheme names "tomorrow-night" and "tomorrow"
- Only set this arg if the scheme family name isn't included in the scheme names. E.g. scheme family "materialtheme" isn't included in scheme name "material-darker"
required: false
type: string
default: Build all schemes
template:
description:
- Set this to the name of a template or a list of template names to only build them instead of building all, which is the default
- Only building a few templates is much faster then building all
required: false
type: list
default: Build all templates
cache_dir:
description:
- Parent directory to store cloned scheme, template and source data
- Will be created if it doesn't exist already
- The default looks for the $XDG_CACHE_DIR env var, then a ~/.cache dir, and falls back to the platform's temp dir if the first two don't exist
required: false
type: string
default: First available of $XDG_CACHE_DIR, $HOME/.cache, or platform derived temp dir
schemes_source:
description:
- Git repo URL or local directory path used to find schemes
- The source must include a list.yaml file that maps scheme names to scheme repo Git URLs or local directory paths
required: false
type: string
default: https://github.com/chriskempson/base16-schemes-source
templates_source:
description:
- Git repo URL or local directory path used to find templates
- The source must include a list.yaml file that maps template names to template repo Git URLs or local directory paths
required: false
type: string
default: https://github.com/chriskempson/base16-templates-source
update:
description:
- Clone or pull color scheme and template sources
- By default will update all schemes and templates, but will repect scheme and template args
- Build will donwload any missing data, so you never _need_ to call update
required: false
type: bool
default: no
build:
description:
- Set to "no" to disable building of any color schemes or templates
- Useful to set to "no" when used with update to only download sources
required: false
type: bool
default: yes-
Python 3.5 or greater, 2.7 will likely work, but is untested
-
Ansible
-
Pystache, which you can install with:
pip install pystache
You can install this role with
ansible-galaxy. Check out the
ansible-galaxy docs for all the different ways you can install roles, but the
simplest is just:
$ ansible-galaxy install mnussbaum.base16-builder-ansible
After you've installed the role you need to reference it, and then you can use
the base16_builder module it provides. Here's a very short example of this:
---
roles:
- mnussbaum.base16-builder-ansible
tasks:
- base16_builder:
scheme: tomorrow-night
template: shell
register: base16_schemesIf you don't want to, or can't, use ansible-galaxy, then you can clone this
repo and drop it directly into your Ansible roles
path.
Either way you install the role, don't forget to also install the Pystache dependency as mentioned above.
This project uses Pipenv to install dependencies. To run the tests:
pip install --user pipenv
pipenv install --dev
pipenv run nose2You can also run the tests in a Docker container against all supported Python versions with:
./ci- Parallelize git pulls
- Allow the Base16 unclaimed schemes to be used too