Upgrade to GitHub-native Dependabot (#1084)

Co-authored-by: dependabot-preview[bot] <27856297+dependabot-preview[bot]@users.noreply.github.com>

.all-contributorsrc

@@ -553,9 +553,535 @@
       "name": "Bob 'Wombat' Hogg",
       "avatar_url": "https://avatars3.githubusercontent.com/u/2373856?v=4",
       "profile": "https://github.com/rwhogg",
+      "contributions": []
+    },
+    {
+      "login": "hxw",
+      "name": "Christopher Hall",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/143462?v=4",
+      "profile": "https://github.com/hxw",
+      "contributions": []
+    },
+    {
+      "login": "hneiva",
+      "name": "Heitor Neiva",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/3451557?v=4",
+      "profile": "https://github.com/hneiva",
+      "contributions": []
+    },
+    {
+      "login": "herbygillot",
+      "name": "Herby Gillot",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/618376?v=4",
+      "profile": "https://github.com/herbygillot",
+      "contributions": []
+    },
+    {
+      "login": "brudil",
+      "name": "James Canning",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/382352?v=4",
+      "profile": "http://brudil.com",
+      "contributions": []
+    },
+    {
+      "login": "jeffz",
+      "name": "jeffz",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/45892?v=4",
+      "profile": "https://twitter.com/jeffz4000",
+      "contributions": []
+    },
+    {
+      "login": "mikkeljuhl",
+      "name": "Mikkel Jeppesen Juhl",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/1764035?v=4",
+      "profile": "https://mikkeljuhl.com",
+      "contributions": []
+    },
+    {
+      "login": "lesteenman",
+      "name": "Erik",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/963290?v=4",
+      "profile": "https://github.com/lesteenman",
+      "contributions": []
+    },
+    {
+      "login": "nyourchuck",
+      "name": "Nate Yourchuck",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/155574?v=4",
+      "profile": "https://github.com/nyourchuck",
+      "contributions": []
+    },
+    {
+      "login": "Ameobea",
+      "name": "Casey Primozic",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/4335849?v=4",
+      "profile": "https://cprimozic.net/",
+      "contributions": []
+    },
+    {
+      "login": "andor-pierdelacabeza",
+      "name": "Alvaro [Andor]",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/2430915?v=4",
+      "profile": "http://pierdelacabeza.com/maruja",
+      "contributions": []
+    },
+    {
+      "login": "Midnight-Conqueror",
+      "name": "Joel Valentine",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/17101621?v=4",
+      "profile": "https://github.com/Midnight-Conqueror",
+      "contributions": []
+    },
+    {
+      "login": "v-braun",
+      "name": "Viktor Braun",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/4738210?v=4",
+      "profile": "https://www.viktor-braun.de",
+      "contributions": []
+    },
+    {
+      "login": "ChrisDBrown",
+      "name": "ChrisDBrown",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/3877652?v=4",
+      "profile": "https://www.chrisdbrown.co.uk/",
+      "contributions": []
+    },
+    {
+      "login": "Narengowda",
+      "name": "Narendra L",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/582821?v=4",
+      "profile": "https://narengowda.github.io/",
+      "contributions": []
+    },
+    {
+      "login": "ibaum",
+      "name": "ibaum",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/24609103?v=4",
+      "profile": "https://github.com/ibaum",
+      "contributions": []
+    },
+    {
+      "login": "noxer",
+      "name": "Tim Scheuermann",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/566185?v=4",
+      "profile": "https://github.com/noxer",
+      "contributions": []
+    },
+    {
+      "login": "indradhanush",
+      "name": "Indradhanush Gupta",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/2682729?v=4",
+      "profile": "https://indradhanush.github.io/",
+      "contributions": []
+    },
+    {
+      "login": "VictorAvelar",
+      "name": "Victor Hugo Avelar Ossorio",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/7926849?v=4",
+      "profile": "https://victoravelar.com",
+      "contributions": []
+    },
+    {
+      "login": "scw007",
+      "name": "Steven Whitehead",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/4001640?v=4",
+      "profile": "https://github.com/scw007",
+      "contributions": []
+    },
+    {
+      "login": "lawrencecraft",
+      "name": "Lawrence Craft",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/660580?v=4",
+      "profile": "https://github.com/lawrencecraft",
+      "contributions": []
+    },
+    {
+      "login": "aviaviavi",
+      "name": "Avi Press",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/1388071?v=4",
+      "profile": "http://avi.press",
+      "contributions": []
+    },
+    {
+      "login": "Tardog",
+      "name": "Sarah Kraßnigg",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/22562624?v=4",
+      "profile": "https://github.com/Tardog",
+      "contributions": []
+    },
+    {
+      "login": "jmks",
+      "name": "Jason Schweier",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/4923990?v=4",
+      "profile": "http://jmks.ca",
+      "contributions": []
+    },
+    {
+      "login": "massa1240",
+      "name": "Massa",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/8268483?v=4",
+      "profile": "https://github.com/massa1240",
+      "contributions": []
+    },
+    {
+      "login": "Boot-Error",
+      "name": "Vighnesh SK",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/8546140?v=4",
+      "profile": "http://boot-error.github.io",
+      "contributions": []
+    },
+    {
+      "login": "alexfornuto",
+      "name": "Alex Fornuto",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/2349184?v=4",
+      "profile": "http://alexfornuto.com",
+      "contributions": []
+    },
+    {
+      "login": "stevenwhitehead",
+      "name": "stevenwhitehead",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/30630257?v=4",
+      "profile": "https://github.com/stevenwhitehead",
+      "contributions": []
+    },
+    {
+      "login": "jdenoy-saagie",
+      "name": "Johan Denoyer",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/55875303?v=4",
+      "profile": "https://github.com/jdenoy-saagie",
+      "contributions": []
+    },
+    {
+      "login": "caalberts",
+      "name": "Albert Salim",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/4749355?v=4",
+      "profile": "https://albertsalim.dev",
+      "contributions": []
+    },
+    {
+      "login": "felicianotech",
+      "name": "Ricardo N Feliciano",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/6017470?v=4",
+      "profile": "https://Feliciano.Tech",
+      "contributions": []
+    },
+    {
+      "login": "3mard",
+      "name": "Omer Davutoglu",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/42009880?v=4",
+      "profile": "https://github.com/3mard",
+      "contributions": []
+    },
+    {
+      "login": "hemu",
+      "name": "Hemu",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/1871299?v=4",
+      "profile": "https://github.com/hemu",
+      "contributions": []
+    },
+    {
+      "login": "Daanikus",
+      "name": "Dan Bent",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/18027087?v=4",
+      "profile": "https://github.com/Daanikus",
+      "contributions": []
+    },
+    {
+      "login": "C123R",
+      "name": "C123R",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/20225764?v=4",
+      "profile": "https://cizer.dev",
+      "contributions": []
+    },
+    {
+      "login": "madepolli",
+      "name": "Matjaž Depolli",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/7237000?v=4",
+      "profile": "https://github.com/madepolli",
+      "contributions": []
+    },
+    {
+      "login": "schoentoon",
+      "name": "Toon Schoenmakers",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/417618?v=4",
+      "profile": "https://blog.schoentoon.blue",
+      "contributions": []
+    },
+    {
+      "login": "TDHTTTT",
+      "name": "TDHTTTT",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/24703459?v=4",
+      "profile": "http://tdhttt.com",
+      "contributions": []
+    },
+    {
+      "login": "jottr",
+      "name": "jottr",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/2744198?v=4",
+      "profile": "https://github.com/jottr",
+      "contributions": []
+    },
+    {
+      "login": "NickyMateev",
+      "name": "Nikolay Mateev",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/15074116?v=4",
+      "profile": "https://www.linkedin.com/in/nikolay-mateev-79187b167/",
+      "contributions": []
+    },
+    {
+      "login": "Gibstick",
+      "name": "Charlie Wang",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/1320418?v=4",
+      "profile": "https://charliewang.io",
+      "contributions": []
+    },
+    {
+      "login": "liyiheng",
+      "name": "liyiheng",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/16461061?v=4",
+      "profile": "https://github.com/liyiheng",
+      "contributions": []
+    },
+    {
+      "login": "bjoernw",
+      "name": "Bjoern Weidlich",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/1467156?v=4",
+      "profile": "https://bjoern.svbtle.com",
+      "contributions": []
+    },
+    {
+      "login": "firecat53",
+      "name": "Scott Hansen",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/568113?v=4",
+      "profile": "https://github.com/firecat53",
+      "contributions": []
+    },
+    {
+      "login": "davidsbond",
+      "name": "David Bond",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/6227720?v=4",
+      "profile": "https://davidsbond.github.io",
+      "contributions": []
+    },
+    {
+      "login": "yesnault",
+      "name": "Yvonnick Esnault",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/395454?v=4",
+      "profile": "https://github.com/yesnault",
+      "contributions": []
+    },
+    {
+      "login": "leterio",
+      "name": "Vinícius Letério",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/15060358?v=4",
+      "profile": "https://github.com/leterio",
+      "contributions": []
+    },
+    {
+      "login": "acaloiaro",
+      "name": "Adriano",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/3331648?v=4",
+      "profile": "https://adriano.fyi",
+      "contributions": []
+    },
+    {
+      "login": "jonhadfield",
+      "name": "Jon Hadfield",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/843944?v=4",
+      "profile": "https://github.com/jonhadfield",
+      "contributions": []
+    },
+    {
+      "login": "Tdnshah",
+      "name": "Tejas Shah",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/13272752?v=4",
+      "profile": "https://github.com/Tdnshah",
+      "contributions": []
+    },
+    {
+      "login": "mogensen",
+      "name": "Frederik Mogensen",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/592710?v=4",
+      "profile": "https://github.com/mogensen",
+      "contributions": []
+    },
+    {
+      "login": "rsaarelm",
+      "name": "Risto Saarelma",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/41840?v=4",
+      "profile": "https://github.com/rsaarelm",
+      "contributions": []
+    },
+    {
+      "login": "sam-github",
+      "name": "Sam Roberts",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/17607?v=4",
+      "profile": "https://sam-github.github.io/",
+      "contributions": []
+    },
+    {
+      "login": "gerchardon",
+      "name": "gerchardon",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/5973160?v=4",
+      "profile": "https://github.com/gerchardon",
+      "contributions": []
+    },
+    {
+      "login": "mryanmurphy",
+      "name": "Matt",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/641427?v=4",
+      "profile": "https://github.com/mryanmurphy",
+      "contributions": []
+    },
+    {
+      "login": "ripienaar",
+      "name": "R.I.Pienaar",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/82342?v=4",
+      "profile": "http://devco.net/",
+      "contributions": []
+    },
+    {
+      "login": "fmotrifork",
+      "name": "Frederik Mogensen",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/18327738?v=4",
+      "profile": "https://github.com/fmotrifork",
+      "contributions": []
+    },
+    {
+      "login": "aeter",
+      "name": "aeter",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/238607?v=4",
+      "profile": "https://github.com/aeter",
+      "contributions": []
+    },
+    {
+      "login": "timhwang21",
+      "name": "Tim Hwang",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/5831434?v=4",
+      "profile": "http://timhwang21.gitbook.io",
+      "contributions": []
+    },
+    {
+      "login": "cyingfan",
+      "name": "Ying Fan Chong",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/10404961?v=4",
+      "profile": "http://about.me/yingfan",
+      "contributions": []
+    },
+    {
+      "login": "MartinJohns",
+      "name": "Martin Johns",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/5269069?v=4",
+      "profile": "https://github.com/MartinJohns",
+      "contributions": []
+    },
+    {
+      "login": "jamietanna",
+      "name": "Jamie Tanna",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/3315059?v=4",
+      "profile": "https://www.jvt.me",
+      "contributions": []
+    },
+    {
+      "login": "trimble",
+      "name": "Todd Trimble",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/371317?v=4",
+      "profile": "https://github.com/trimble",
+      "contributions": []
+    },
+    {
+      "login": "mhanberg",
+      "name": "Mitchell Hanberg",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/5523984?v=4",
+      "profile": "https://www.mitchellhanberg.com",
+      "contributions": []
+    },
+    {
+      "login": "franga2000",
+      "name": "Miha Frangež",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/3891092?v=4",
+      "profile": "https://franga2000.com",
+      "contributions": []
+    },
+    {
+      "login": "sahilister",
+      "name": "Sahil Dhiman",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/52946452?v=4",
+      "profile": "https://blog.sahilister.in/",
+      "contributions": []
+    },
+    {
+      "login": "applegreengrape",
+      "name": "Pingzhou | 平舟",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/17727004?v=4",
+      "profile": "https://pzoo.netlify.app/",
+      "contributions": []
+    },
+    {
+      "login": "YuviGold",
+      "name": "Yuval Goldberg",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/29873449?v=4",
+      "profile": "https://github.com/YuviGold",
+      "contributions": []
+    },
+    {
+      "login": "dabcoder",
+      "name": "David Bouchare",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/5034531?v=4",
+      "profile": "https://github.com/dabcoder",
+      "contributions": []
+    },
+    {
+      "login": "stone",
+      "name": "Fredrik Steen",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/29077?v=4",
+      "profile": "https://github.com/stone",
+      "contributions": []
+    },
+    {
+      "login": "zye1996",
+      "name": "zye1996",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/28901953?v=4",
+      "profile": "https://github.com/zye1996",
+      "contributions": []
+    },
+    {
+      "login": "pgaxatte",
+      "name": "Pierre Gaxatte",
+      "avatar_url": "https://avatars.githubusercontent.com/u/30696904?v=4",
+      "profile": "https://github.com/pgaxatte",
+      "contributions": []
+    },
+    {
+      "login": "xntrik",
+      "name": "Christian Frichot",
+      "avatar_url": "https://avatars.githubusercontent.com/u/678260?v=4",
+      "profile": "https://xntrik.wtf",
+      "contributions": []
+    },
+    {
+      "login": "LKaemmerling",
+      "name": "Lukas Kämmerling",
+      "avatar_url": "https://avatars.githubusercontent.com/u/4281581?v=4",
+      "profile": "https://lukas-kaemmerling.de",
+      "contributions": []
+    },
+    {
+      "login": "inetAnt",
+      "name": "Antoine Meillet",
+      "avatar_url": "https://avatars.githubusercontent.com/u/1765366?v=4",
+      "profile": "https://inetant.net/",
+      "contributions": []
+    },
+    {
+      "login": "cclauss",
+      "name": "Christian Clauss",
+      "avatar_url": "https://avatars.githubusercontent.com/u/3709715?v=4",
+      "profile": "https://www.patreon.com/cclauss",
       "contributions": [
       ]
     }
   ],
-  "contributorsPerLine": 7
+  "contributorsPerLine": 7,
+  "commitConvention": "none"
 }

.github/FUNDING.yml

@@ -1 +1 @@
-patreon: wtfutil
+github: senorprogrammer

.github/dependabot.yml

@@ -0,0 +1,11 @@
+version: 2
+updates:
+- package-ecosystem: gomod
+  directory: "/"
+  schedule:
+    interval: daily
+  open-pull-requests-limit: 10
+  reviewers:
+  - senorprogrammer
+  assignees:
+  - senorprogrammer

.github/workflows/codeql-analysis.yml

@@ -0,0 +1,51 @@
+name: "Code scanning - action"
+
+on:
+  push:
+  pull_request:
+  schedule:
+    - cron: '0 3 * * 3,6'
+
+jobs:
+  CodeQL-Build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v2
+      with:
+        # We must fetch at least the immediate parents so that if this is
+        # a pull request then we can checkout the head.
+        fetch-depth: 2
+
+    # If this run was triggered by a pull request event, then checkout
+    # the head of the pull request instead of the merge commit.
+    - run: git checkout HEAD^2
+      if: ${{ github.event_name == 'pull_request' }}
+      
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v1
+      # Override language selection by uncommenting this and choosing your languages
+      # with:
+      #   languages: go, javascript, csharp, python, cpp, java
+
+    # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
+    # If this step fails, then you should remove it and run the build manually (see below)
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v1
+
+    # ℹ️ Command-line programs to run using the OS shell.
+    # 📚 https://git.io/JvXDl
+
+    # ✏️ If the Autobuild fails above, remove it and uncomment the following three lines
+    #    and modify them (or add more) to build your code if your project
+    #    uses a compiled language
+
+    #- run: |
+    #   make bootstrap
+    #   make release
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v1

.github/workflows/golangci-lint.yml

@@ -0,0 +1,22 @@
+name: golangci-lint
+on:
+  push:
+    tags:
+      - v*
+    branches:
+      - master
+  pull_request:
+jobs:
+  golangci:
+    name: lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: golangci-lint
+        uses: golangci/golangci-lint-action@v2
+        with:
+          # Required: the version of golangci-lint is required and must be
+          # specified without patch version: we always use the latest patch version.
+          # https://github.com/golangci/golangci-lint/releases
+          version: v1.39
+          args: ./...

.github/workflows/goreleaser.yml

@@ -0,0 +1,30 @@
+name: goreleaser
+
+on:
+  push:
+    tags:
+      - '*'
+
+jobs:
+  goreleaser:
+    runs-on: ubuntu-latest
+    steps:
+      -
+        name: Checkout
+        uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+      -
+        name: Set up Go
+        uses: actions/setup-go@v2
+        with:
+          go-version: 1.16
+      -
+        name: Run GoReleaser
+        uses: goreleaser/goreleaser-action@v2
+        with:
+          version: latest
+          args: release --rm-dist
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GH_PAT }}

.github/workflows/staticcheck.yml

@@ -0,0 +1,70 @@
+name: static check
+on: pull_request
+
+jobs:
+  imports:
+    name: Imports
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@master
+    - name: check
+      uses: grandcolline/golang-github-actions@4356d0458ea4bfdb55fcb296437812acef970f9b
+      with:
+        run: imports
+        token: ${{ secrets.GITHUB_TOKEN }}
+
+  errcheck:
+    name: Errcheck
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@master
+    - name: check
+      uses: grandcolline/golang-github-actions@4356d0458ea4bfdb55fcb296437812acef970f9b
+      with:
+        run: errcheck
+        token: ${{ secrets.GITHUB_TOKEN }}
+
+  #lint:
+    #name: Lint
+    #runs-on: ubuntu-latest
+    #steps:
+    #- uses: actions/checkout@master
+    #- name: check
+      #uses: grandcolline/golang-github-actions@4356d04
+      #with:
+        #run: lint
+        #token: ${{ secrets.GITHUB_TOKEN }}
+
+  shadow:
+    name: Shadow
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@master
+    - name: check
+      uses: grandcolline/golang-github-actions@4356d0458ea4bfdb55fcb296437812acef970f9b
+      with:
+        run: shadow
+        token: ${{ secrets.GITHUB_TOKEN }}
+
+  staticcheck:
+    name: StaticCheck
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@master
+    - name: check
+      uses: grandcolline/golang-github-actions@4356d0458ea4bfdb55fcb296437812acef970f9b
+      with:
+        run: staticcheck
+        token: ${{ secrets.GITHUB_TOKEN }}
+
+  #sec:
+    #name: Sec
+    #runs-on: ubuntu-latest
+    #steps:
+    #- uses: actions/checkout@master
+    #- name: check
+      #uses: grandcolline/golang-github-actions@4356d04
+      #with:
+        #run: sec
+        #token: ${{ secrets.GITHUB_TOKEN }}
+        #flags: "-exclude=G104"

.golangci.yml

@@ -0,0 +1,18 @@
+run:
+  timeout: 2m
+
+linters:
+  enable:
+    - vet
+    - errcheck
+    - staticcheck
+#   - dupl
+#   - funlen
+#   - goconst
+#   - gocritic
+    - gofmt
+#   - golint
+#   - misspell
+#   - stylecheck
+    - unconvert
+#   - whitespace

.goreleaser.yml

@@ -1,9 +1,10 @@
 env:
   - GO111MODULE=on
-  - GOPROXY="https://gocenter.io"
+  - GOPROXY="https://proxy.golang.org,direct"
 
-archive:
-  wrap_in_directory: true
+archives:
+  - id: default
+    wrap_in_directory: true
 
 builds:
   - binary: wtfutil
@@ -11,7 +12,6 @@ builds:
       - darwin
       - linux
     goarch:
-      - 386
       - amd64
       - arm
       - arm64
@@ -21,14 +21,10 @@ before:
     - make install
 
 brews:
-  - github:
-      owner: wtfutil
-      name: homebrew-wtfutil
-
+  -
     name: wtfutil
     homepage: 'https://wtfutil.com'
     description: 'The personal information dashboard for your terminal.'
-
-dockers:
-  - image_templates:
-    - wtfutil/wtf
+    tap:
+      owner: wtfutil
+      name: homebrew-wtfutil

.travis.yml

@@ -1,14 +1,14 @@
 language: go
+
 go:
-  - "1.11.x"
-  - "1.12.x"
-sudo: false
+  - "1.16.x"
+
 before_install:
   # Make sure travis builds work for forks
   - mkdir -p $TRAVIS_BUILD_DIR $GOPATH/src/github.com/wtfutil
   - test ! -d $GOPATH/src/github.com/wtfutil/wtf && mv $TRAVIS_BUILD_DIR $GOPATH/src/github.com/wtfutil/wtf || true
   - export TRAVIS_BUILD_DIR=$HOME/gopath/src/github.com/wtfutil/wtf
   - cd $HOME/gopath/src/github.com/wtfutil/wtf
-  - export GOPROXY="https://gocenter.io" && export GO111MODULE=on
+  - export GOPROXY="https://proxy.golang.org,direct"
 
-script: go get ./... && go test -v github.com/wtfutil/wtf/...
+script: go get ./... && ./scripts/check-uncommitted-vendor-files.sh && go test -v github.com/wtfutil/wtf/...

CHANGELOG.md

@@ -4,7 +4,380 @@
 
 ### ⚡️ Added
 
-* Kubernetes module, [#142](https://github.com/wtfutil/wtf/issues/142) by [@sudermanjr](https://github.com/sudermanjr)
+* Yahoo Finance module added, by [@inetAnt](https://github.com/inetAnt)
+
+### 🐞 Fixed
+
+* Fixed error closing the Jira module response body, [#1070](https://github.com/wtfutil/wtf/issues/1070) by [@senorprogrammer](https://github.com/senorprogrammer)
+
+## v0.36.0
+
+### ⚡️ Added
+
+* HealthChecks module added, by [@stone](https://github.com/stone)
+* Asana module added, by [@xntrik](https://github.com/xntrik)
+* Kubernetes module now displays the Ready Replicas and Total Replicas count, by [@LKaemmerling](https://github.com/LKaemmerling)
+* Now builds using Go 1.16, which provides support for Apple's M1 ARM hardware, by [@LKaemmerling](https://github.com/LKaemmerling)
+
+### 🐞 Fixed
+
+* Numerous dangling response bodies closed, by [@dabcoder](https://github.com/dabcoder)
+* HackerNews read-on-response error fixed, by [@LKaemmerling](https://github.com/LKaemmerling)
+* CircleCI read-on-response error fixed, by [@dabcoder](https://github.com/dabcoder)
+
+## v0.35.0
+
+### ⚡️ Added
+
+* CircleCI module now supports `numberOfBuilds` setting defining how many builds to display, [#1020](https://github.com/wtfutil/wtf/issues/1020) by [@dabcoder](https://github.com/dabcoder)
+* The <kbd>\\</kbd> key now opens module documentation in the browser for the currently-focused module, by [@senorprogrammer](https://github.com/senorprogrammer)
+* Krisinformation module added, by [@stone](https://github.com/stone)
+* Covid module has been added, by [@dabcoder](https://github.com/dabcoder)
+* Support for a "Language" configuration key added. Supports any BCP 47 tag for identifying a langauge, by [@senorprogrammer](https://github.com/senorprogrammer)
+
+### 🐞 Fixed
+
+* CryptoLive prices update again, [#1041](https://github.com/wtfutil/wtf/issues/1041) by [@zye1996](https://github.com/zye1996)
+
+## v0.34.0
+2020-11-08
+
+### ⚡️ Added
+
+* DigitalOcean module now supports custom column definitions in the default layout. See [the docs](https://wtfutil.com/modules/digitalocean/) for details, [#986](https://github.com/wtfutil/wtf/issues/986) by [@senorprogrammer](https://github.com/senorprogrammer)
+* Finnhub stock quotes module added, [#930](https://github.com/wtfutil/wtf/issues/930) by [@applegreengrape](https://github.com/applegreengrape)
+* Grafana Alerts module added, by [@schoentoon](https://github.com/schoentoon)
+
+### 👍 Updated
+
+* Updated `google.golang.org/api` from 0.30.0 to 0.33.0
+* Updated `github.com/digitalocean/godo` from 1.46.0 to 1.52.0
+* Updated `github.com/xanzy/go-gitlab` from 0.38.1 to 0.39.0
+* Updated `github.com/zorkian/go-datadog-api` from 2.29.0+incompatible to 2.30.0+incompatible
+* Updated `golang.org/x/text` from 0.3.3 to 0.3.4
+
+## v0.33.0
+2020-10-13
+
+### ⚡️ Added
+
+* FeedReader module supports [display mode switching](https://github.com/wtfutil/wtf/pull/976) via the `t` key, by [@cyingfan](https://github.com/cyingfan)
+* Clocks module now supports `natural` ordering option, [#896](https://github.com/wtfutil/wtf/issues/896) by [@seanstoppable](https://github.com/Seanstoppable)
+* Exit banner message added, by [@senorprogrammer](https://github.com/senorprogrammer)
+* [UptimeRobot module added](https://github.com/wtfutil/wtf/pull/983), by [@franga2000](https://github.com/franga2000)
+* Gitlab module now defaults the domain to `https://gitlab.com`, by [@jmks](https://github.com/jmks)
+
+### 🐞 Fixed
+
+* Exchange Rates module now displays rates in alphabetical order, sorted by the base rate, by [@senorprogrammer](https://github.com/senorprogrammer)
+* Feed Reader module no longer crashes on feeds that don't have a published date, [#958](https://github.com/wtfutil/wtf/issues/958) by [@cyingfan](https://github.com/cyingfan)
+* Stray blank lines no longer appear at the end of highlightable lists, [#977](https://github.com/wtfutil/wtf/pull/977) by [@cyingfan](https://github.com/cyingfan)
+* `config.yml` now properly set to `0600` instead of `0666`, by [@cyingfan](https://github.com/cyingfan)
+* Now blank-imports the `time/tzinfo` package to provide timezone support for Windows users, [#994](https://github.com/wtfutil/wtf/issues/994) by [@trimble](https://github.com/trimble)
+
+### 👍 Updated
+
+* Updated `github.com/gdamore/tcell` from 1.3.0 to 1.4.0
+* Updated `github.com/shirou/gopsutil` from 2.20.7+incompatible to 2.20.9+incompatible
+* Updated `github.com/mmcdole/gofeed` from 1.0.0 to 1.1.0
+* Updated `github.com/digitalocean/godo` from 1.42.1 to 1.46.0
+* Updated `github.com/xanzy/go-gitlab` from 0.33.0 to 0.38.1
+* Updated `github.com/adlio/trello` from 1.7.0 to 1.8.0
+* Updated `github.com/alecthomas/chroma` from 0.8.0 to 0.8.1
+* Updated `github.com/nicklaw5/helix` from 0.5.9 to 0.7.0
+
+* Now requires Go 1.15 for compilation in Dockerfiles and go.mod, by [@seanstoppable](https://github.com/Seanstoppable)
+
+## v0.32.0
+
+### ⚡️ Added
+
+* PagerDuty module now supports `showOncallEnd` setting, which determines whether or not to display the oncall rotation end date, by [@senorprogrammer](https://github.com/senorprogrammer)
+* Exchange Rates module now supports `precision` setting, which determines how many decimal places to display, [#897](https://github.com/wtfutil/wtf/issues/897) by [@senorprogrammer](https://github.com/senorprogrammer)
+
+### 🐞 Fixed
+
+* Todo module's edit modal now shows up quickly, [#876](https://github.com/wtfutil/wtf/issues/876) by [@aeter](https://github.com/aeter)
+* Jira module title now displays properly, [#942](https://github.com/wtfutil/wtf/issues/942) by [@timhwang21](https://github.com/timhwang21)
+
+### 👍 Updated
+
+* Updated `alecthomas/chroma` from 0.7.3 to 0.8.0
+* Updated `digitalocean/godo` from 1.38.0 to 1.42.1
+* Updated `google.golang.org/api` from 0.29.0 to 0.30.0
+* Updated `shirou/gopsutil` from 2.20.6+incompatible to 2.20.7+incompatible
+
+## v0.31.0
+
+### ⚡️ Added
+
+* [docker-credential-helpers](https://github.com/docker/docker-credential-helpers) support added to provide optional securing of module secrets, [#517](https://github.com/wtfutil/wtf/issues/517) by [@sam-github](https://github.com/sam-github)
+* `make lint` now uses [golangci-lint](https://github.com/golangci/golangci-lint-action), by [@sam-github](https://github.com/sam-github)
+* GitHub module now supports per-section configuration, [#864](https://github.com/wtfutil/wtf/issues/864) by [@mryanmurphy](https://github.com/mryanmurphy)
+* PagerDuty module now accepts Team ID and User ID as filters, by [@mryanmurphy](https://github.com/mryanmurphy)
+* Weather module now supports a `useEmoji` setting, toggling the use of emoji characters in the title, by [@jonhadfield](https://github.com/jonhadfield)
+* Pocket documentation added, by [@3mard](https://github.com/3mard)
+
+
+### 🐞 Fixed
+
+* GitLab Todo module now allows domain to be set, defaults to `https://gitlab.com`, by [@gerchardon](https://github.com/gerchardon)
+* Pi-hole module now works with Pi-hole v4 and v5, by [@jonhadfield](https://github.com/jonhadfield)
+* Null pointer exception fixed in VictorOps module, by [@ripienaar](https://github.com/ripienaar)
+
+### 👍 Updated
+
+* Updated `google.golang.org/api` from 0.25.0 to 0.29.0
+* Updated `pkg/profile` from 1.4.0 to 1.5.0
+* Updated `nicklaw5/helix` from 0.5.8 to 0.5.9
+* Updated `digitalocean/godo` from 1.37.0 to 1.38.0
+* Updated `gopkg.in/yaml.v2` from 2.2.8 to 2.3.0
+* Updated `xanzy/go-gitlab` from 0.31.0 to 0.33.0
+* Updated `stretchr/testify` from 1.5.1 to 1.6.1
+* Updated `golang.org/x/text` from 0.3.2 to 0.3.3
+* Updated `shirou/gopsutil` from 2.20.4+incompatible to 2.20.6+incompatible
+
+## v0.30.0
+
+### ⚡️ Added
+
+* Expansive keyboard controls for the [GitLab](https://wtfutil.com/modules/gitlab/) module, by [@mogensen](https://github.com/mogensen)
+* [IPInfo](https://wtfutil.com/modules/ipaddress/ipinfo/) module now supports IPv6 lookup, by [@acaloiaro](https://github.com/acaloiaro)
+* The GitHub repo now runs a set of actions that lint PRs for code quality and conformity and comment in-line on the PRs. See here for action details https://github.com/wtfutil/wtf/actions
+
+### 🐞 Fixed
+
+* Random capital letters around display, [#811](https://github.com/wtfutil/wtf/issues/811) by [@jonhadfield](https://github.com/jonhadfield)
+* [Feed Reader](https://wtfutil.com/modules/feedreader/) module now properly sorts multi-feed items by date, by [@rsaarelm](https://github.com/rsaarelm)
+
+### 👍 Updated
+
+* Updated `zorkian/go-datadog-api` from 2.28.0+incompatible to 2.29.0+incompatible
+* Updated `shirou/gopsutil` from 2.20.3+incompatible to 2.20.4+incompatible
+* Updated `google.golang.org/api` from 0.22.0 to 0.23.0
+
+## 0.29.0
+
+### ⚡️ Added
+
+* gCal module now has a `showEndTime` boolean option for displaying meeting end times, by [@acaloiaro](https://github.com/acaloiaro)
+* [Pi-hole](https://wtfutil.com/modules/pihole/) module added, by [@jonhadfield](https://github.com/jonhadfield)
+
+### 🐞 Fixed
+
+* Docker module subheading display, [#847](https://github.com/wtfutil/wtf/issues/847) by [@senorprogrammer](https://github.com/senorprogrammer)
+* Improved display of currencies for the Exchange Rate module, by [@indradhanush](https://github.com/indradhanush)
+
+### 👍 Updated
+
+* Updated `nicklaw5/helix` from 0.5.7 to 0.5.8
+* Updated `digitalocean/godo` from 1.34.0 to 1.35.1
+* Updated `xanzy/go-gitlab` from 0.28.0 to 0.31.0
+* Updated `shirou/gopsutil` from 2.20.2+incompatible to 2.20.3+incompatible
+* Updated `alecthomas/chroma` from 0.7.1 to 0.7.2
+* Updated `google.golang.org/api` from 0.21.0 to 0.22.0
+
+## v0.28.0
+
+### ⚡️ Added
+
+* Support for customizing CPU, Mem, and Swap display in ResourceUsage, by [@leterio](https://github.com/leterio)
+
+### 👍 Updated
+
+* Now prefers Go 1.14 for compilation (should still work under 1.13 however)
+* Updated `shirou/gopsutil` from 2.20.1+incompatible to 2.20.2+incompatible
+* Updated `google.golang.org/api` from 0.17.0 to 0.20.0
+* Updated `digitalocean/godo` from 1.30.0 to 1.32.0
+* Updated `xanzy/go-gitlab` from 0.26.0 to 0.28.0
+* Updated `adlio/trello` from 1.6.0 to 1.7.0
+* Updated `zorkian/go-datadog-api` from 2.27.0+incompatible to 2.28.0+incompatible
+
+## 0.27.0
+
+### ⚡️ Added
+
+* GitLab Todo module added, by [@elliotrushton](https://github.com/elliotrushton)
+* [CDS](https://wtfutil.com/modules/cds/) module added, by [@yesnault](https://github.com/yesnault)
+
+### 🐞 Fixed
+
+* The `vendor` directory has been removed, [#792](https://github.com/wtfutil/wtf/issues/792) by [@bjoernw](https://github.com/bjoernw)
+
+### 👍 Updated
+
+* Updated `zorkian/go-datadog-api` from 2.26.0+incompatible to 2.27.0+incompatible
+* Updated `google.golang.org/api` from 0.15.0 to 0.17.0
+* Updated `github.com/nicklaw5/helix` from 0.5.5 to 0.5.7
+* Updated `xanzy/go-gitlab` from 0.23.0 to 0.26.0
+* Updated `stretchr/testify` from o.4.0 to 0.5.1
+
+## 0.26.0
+
+### ⚡️ Added
+
+* `myName` config setting added to PagerDuty module, by [@senorprogrammer](https://github.com/senorprogrammer)
+* `withDate` config setting added to Digital Clock module, by [@senorprogrammer](https://github.com/senorprogrammer)
+* Twitch module added, by [@bjoernw](https://github.com/bjoernw)
+* HackerNews module now opens HN comments when there is no alternative external link, [#758](https://github.com/wtfutil/wtf/issues/758) by [@senorprogrammer](https://github.com/senorprogrammer)
+* gCal module now now allows users to hide all-day events, [#733](https://github.com/wtfutil/wtf/issues/733) by [@senorprogrammer](https://github.com/senorprogrammer)
+* SpaceX module added, by [@bjoernw](https://github.com/bjoernw)
+* Support for obeying `XDG_CONFIG_HOME` when set, [#699](https://github.com/wtfutil/wtf/issues/699) by [@Seanstoppable](https://github.com/Seanstoppable)
+
+### 🐞 Fixed
+
+* Module templating working again, [#748](https://github.com/wtfutil/wtf/issues/748) by [@senorprogrammer](https://github.com/senorprogrammer)
+* CmdRunner title spacing issue fixed, [#784](https://github.com/wtfutil/wtf/issues/784) by [@senorprogrammer](https://github.com/senorprogrammer)
+* Colors in cmdrunner fixed when using nodejs chalk et al., [#618](https://github.com/wtfutil/wtf/issues/618) by [@Seanstoppable](https://github.com/Seanstoppable)
+* Docker buid instructions updated and improved, by [@firecat53](https://github.com/firecat53)
+* Kubernetes module can now be used with multiple contexts, [#809](https://github.com/wtfutil/wtf/issues/809) by [@davidsbond](https://github.com/davidsbond)
+
+### 👍 Updated
+
+* Updated `digitalocean/godo` from 1.22.0 to 1.30.0
+* Updated `google.golang.org/api` from 0.14.0 to 0.15.0
+* Updated `alecthomas/chroma` from 0.7.0 to 0.7.1
+* Updated `pkg/errors` from 0.8.1 to 0.9.1
+* Updated `xanzy/go-gitlab` from 0.22.2 to 0.23.0
+* Updated `shirou/gopsutil` from 2.19.11 to 2.20.1
+* Updated `zorkian/go-datadog-api` from 2.25.0 to 2.26.0
+* Updated `gopkg.in/yaml.v2` from 2.2.7 to 2.2.8
+* Updated `nicklaw5/helix` from 0.5.4 to 0.5.5
+
+## 0.25.0
+
+### ⚡️ Added
+
+* [DigitalOcean](https://wtfutil.com/modules/digitalocean/) module added, by [@senorprogrammer](https://github.com/senorprogrammer)
+* [Transmission](https://wtfutil.com/modules/transmission/) module now supports a `hideComplete` configuration setting, by [@schoentoon](https://github.com/schoentoon)
+* Pocket module added, [#742] by [@3mard](https://github.com/3mard)
+* [Exchange Rates](https://wtfutil.com/modules/exchange_rates/) module added, by [@schoentoon](https://github.com/schoentoon)
+* [GitHub](https://wtfutil.com/modules/github/) modules supports 'p' keyboard command to open **p**ull requests, by [@NickyMateev](https://github.com/NickyMateev)
+* [GitHub](https://wtfutil.com/modules/github/) modules supports 'i' keyboard command to open **i**ssues, by [@NickyMateev](https://github.com/NickyMateev)
+* [Jenkins](https://wtfutil.com/modules/jenkins/) module now supports multi-configuration projects, by [@NickyMateev](https://github.com/NickyMateev)
+
+### 🐞 Fixed
+
+* Subreddit out of bounds error fixed, [#753](https://github.com/wtfutil/wtf/issues/753) by [@TDHTTTT](https://github.com/TDHTTTT)
+* Homebrew builds now contain version information, [#557](https://github.com/wtfutil/wtf/issues/557) by [@jottr](https://github.com/jottr)
+* CmdRunner flicker problem, [#732](https://github.com/wtfutil/wtf/issues/732) by [@Gibstick](https://github.com/Gibstick)
+
+### 👍 Updated
+
+* Switched from `gocenter.io` as the Go proxy to `proxy.golang.org`, by [@chenrui333](https://github.com/chenrui333)
+* Updated `go-datadog-api` to version 2.25.0+incompatible
+* Updated `adlio/trello` to version 1.6.0
+* Updated `alecthomas/chroma` to version 0.7.0
+* Updated `olekukonko/tablewriter` to version 0.0.3
+* Updated `pkg/profile` to version 1.4.0
+* Updated `yaml.v2` to 2.2.7
+* Updated `google.golang.org/api` to 0.14.0
+* Updated `xanzy/go-gitlab` to 0.22.2
+* Uodated `shirou/gopsutil` to 2.19.11+incompatible
+
+
+## v0.24.0
+
+### ⚡️ Added
+
+* Proper, usable [Docker file](https://github.com/wtfutil/wtf/blob/master/Dockerfile) added, by [@Boot-Error](https://github.com/Boot-Error)
+* [GitLab](https://wtfutil.com/modules/gitlab/) module displays issues assigned to, and opened by, the user, by [@caalberts](https://github.com/caalberts)
+* [TravisCI](https://wtfutil.com/modules/travisci/) now checks for uncommitted vendor changes, by [@indradhanush](https://github.com/indradhanush)
+* Football module added, by [@C123R](https://github.com/C123R)
+* [resourceuseage](https://wtfutil.com/modules/resourceusage/) now supports a `cpuCombined` setting, by [@madepolli](https://github.com/madepolli)
+* [Twitter Stats](https://wtfutil.com/modules/twitter/twittertweets/) module added, by [@Ameobea](https://github.com/Ameobea)
+
+### 🐞 Fixed
+
+* Github PRs do not count against issues, by [@alexfornuto](https://github.com/alexfornuto)
+* Todo scrolling now works properly, [#707](https://github.com/wtfutil/wtf/issues/707) by [3mard](https://github.com/3mard)
+* Configs with a missing `color` key now load properly, [#718](https://github.com/wtfutil/wtf/issues/718) and [#730](https://github.com/wtfutil/wtf/issues/730) by [@senorprogrammer](https://github.com/senorprogrammer)
+
+## 0.23.0
+
+### ⚡️ Added
+
+* [Azure DevOps](https://wtfutil.com/modules/azure-devops/) module added, by [@v-braun](https://github.com/v-braun)
+* [Dev.to](https://wtfutil.com/modules/devto/) module added, by [@VictorAvelar](https://github.com/VictorAvelar)
+* [TravisCI]() module now supports enterprise endpoints, [#652](https://github.com/wtfutil/wtf/issues/652) by [@scw007](https://github.com/scw007)
+* [Subreddit](https://wtfutil.com/modules/subreddit/) module added, by [@lawrencecraft](https://github.com/lawrencecraft)
+* [gCal](https://wtfutil.com/modules/google/gcal/) module now supports a `hourFormat` setting for defining whether to display 12 or 24-hour times, [#665](https://github.com/wtfutil/wtf/issues/665) by [@senorprogrammer](https://github.com/senorprogrammer)
+* [Scarf](https://scarf.sh) installation instructions added to README, by [@aviaviavi](https://github.com/aviaviavi)
+* Spotify widget now supports colour themes, [#659](https://github.com/wtfutil/wtf/issues/659) by [@Tardog](https://github.com/Tardog)
+* [Buildkite](https://wtfutil.com/modules/buildkite/) module added, by [@jmks](https://github.com/jmks)
+* [Improvements](https://github.com/wtfutil/wtf/pull/680) to the [CmdRunner](https://wtfutil.com/modules/cmdrunner/) module, by [@noxer](https://github.com/noxer)
+
+### 🐞 Fixed
+
+* gCal calendar event time colour can now be changed by setting the `eventTime` configuration setting, [#638](https://github.com/wtfutil/wtf/issues/638) by [@indradhanush](https://github.com/indradhanush)
+* [Clocks](https://wtfutil.com/modules/clocks/) now obeys global row colour settings, [#658](https://github.com/wtfutil/wtf/issues/658) by [@senorprogrammer](https://github.com/senorprogrammer)
+* [Transmission](https://wtfutil.com/modules/transmission/) module no longer blocks rendering when a Transmission daemon cannot be found, [#661](https://github.com/wtfutil/wtf/issues/661) by [@senorprogrammer](https://github.com/senorprogrammer)
+* [Trello](https://wtfutil.com/modules/trello/) module now respects project list order, [#664](https://github.com/wtfutil/wtf/issues/664) by [@Seanstoppable](https://github.com/Seanstoppable)
+* [Todo](https://wtfutil.com/modules/todo/) module now respects checkbox settings, [#616](https://github.com/wtfutil/wtf/issues/616) by [@Seanstoppable](https://github.com/Seanstoppable)
+* [Todoist](https://wtfutil.com/modules/todoist/) module now properly handles todo items with due date and times, [#645](https://github.com/wtfutil/wtf/issues/645) by [@massa1240](https://github.com/massa1240)
+* Invalid pointer error in [Azure DevOps](https://wtfutil.com/modules/azure-devops/) fixed by [@Boot-Error](https://github.com/Boot-Error)
+* Renamed slice error in [Dev](https://wtfutil.com/modules/devto/) fixed by [@Boot-Error](https://github.com/Boot-Error)
+
+### 👍 Updated
+
+* Updated `go-datadog-api` to version v2.24.0
+* Updated `go-github` to version 26.13
+* Updated `watcher` to version 1.0.7
+* Updated `google-api-go-client` to version 0.10.0
+* Updated `chroma` to version 0.6.7
+* Updated `go-gitlab` to version 0.20.1
+* Updated `trello` to version 1.4.0
+* Updated `tcell` to version 1.3.0
+* Updated `gopsutil` to version 2.19.9+incompatible
+* Updated `yaml` to version 2.2.4
+
+## v0.22.0
+
+### ⚡️ Added
+
+* [Arpansagovau](https://wtfutil.com/modules/weather_services/arpansagovau/) (arpansa.gov.au) module added, by [@jeffz](https://github.com/jeffz)
+* 'calendarReadLevel' setting added to gCal module, by [@mikkeljuhl](https://github.com/mikkeljuhl)
+* Todoist module now catches and displays API errors, by [@Seanstoppable](https://github.com/Seanstoppable)
+* TravisCI sort orders now configurable,  by [@nyourchuck](https://github.com/nyourchuck)
+* Google Analytics module now supports real-time metrics, [#581](https://github.com/wtfutil/wtf/issues/581) by [@Ameobea](https://github.com/Ameobea)
+* Colors in configuration can now be defined using long-form hex, i.e.: #ff0000, by [@Seanstoppable](https://github.com/Seanstoppable)
+* GitHub module pull requests are now selectable and openable via keyboard, [#547](https://github.com/wtfutil/wtf/issues/547) by [@Midnight-Conqueror](https://github.com/Midnight-Conqueror)
+* [Docker](https://wtfutil.com/modules/docker/) module added, [#594](https://github.com/wtfutil/wtf/issues/594) by [@v-braun](https://github.com/v-braun)
+* NewRelic module now supports displaying data from multiple apps, [#471](https://github.com/wtfutil/wtf/issues/471) by [@ChrisDBrown](https://github.com/ChrisDBrown) and [@Seanstoppable](https://github.com/Seanstoppable)
+* [Digital Clock](https://wtfutil.com/modules/digitalclock/) module added, by [@Narengowda](https://github.com/Narengowda)
+
+### 🐞 Fixed
+
+* ScrollableWidget bounds checking error fixed, [#578](https://github.com/wtfutil/wtf/issues/578) by [@Seanstoppable](https://github.com/Seanstoppable)
+* Now properly URL-decodes Jenkins branch names, [#575](https://github.com/wtfutil/wtf/issues/575) by [@lesteenman](https://github.com/lesteenman)
+* Jira column sizes render properly, [#574](https://github.com/wtfutil/wtf/issues/574) by [@lesteenman](https://github.com/lesteenman)
+* Todoist module updated to latest API version, by [@Seanstoppable](https://github.com/Seanstoppable)
+* gCal colour highlighting working again, [#611](https://github.com/wtfutil/wtf/issues/611) by [@senorprogrammer](https://github.com/senorprogrammer)
+* Per-module background and text colour settings working again, [#568](https://github.com/wtfutil/wtf/issues/568) by [@Seanstoppable](https://github.com/Seanstoppable)
+* Git module no longer forces sorting of repositories, [#608](https://github.com/wtfutil/wtf/pull/608) by [@Seanstoppable](https://github.com/Seanstoppable)
+* GitHub PR icons render properly without phantom characters, by [@Midnight-Conqueror](https://github.com/Midnight-Conqueror)
+* GitLab configuration now takes a list of project paths, [#566](https://github.com/wtfutil/wtf/issues/566) by [@senorprogrammer](https://github.com/senorprogrammer)
+* Kubernetes configuration segfault fixed, [#549](https://github.com/wtfutil/wtf/issues/549) by [@ibaum](https://github.com/ibaum)
+
+## v0.21.0
+
+### ⚡️ Added
+
+* Power Soure module support added for FreeBSD, by [@hxw](https://github.com/hxw)
+
+### 🐞 Fixed
+
+* Power indicator displays ∞ on Linux when fully-charged and on AC power, [#534](https://github.com/wtfutil/wtf/issues/534) by [@Seanstoppable](https://github.com/Seanstoppable)
+* Default background color is now the terminal background color, making transparency support possible in MacOS and Linux,  by [@Seanstoppable](https://github.com/Seanstoppable)
+* `xdg-open` now used as the opener for HTTP/HTTPS by default, by [@hxw](https://github.com/hxw)
+* Transmission port over-ride now working, [#565](https://github.com/wtfutil/wtf/issues/565) by [@Seanstoppable](https://github.com/Seanstoppable)
+* Default config is now created on first run, [#553](https://github.com/wtfutil/wtf/issues/553) by [@senorprogrammer](https://github.com/senorprogrammer)
+
+## v0.20.0
+
+### ⚡️ Added
+
+* Kubernetes module added, [#142](https://github.com/wtfutil/wtf/issues/142) by [@sudermanjr](https://github.com/sudermanjr)
 
 ### 🐞 Fixed
 
@@ -165,7 +538,7 @@
 
 ### ⚡️ Added
 
-* Dependencies are now managed and installed using Go modules. See README.md for details, [#406](https://github.com/wtfutil/wtf/issues/406) by [@retgits](https://github.com/retgits) 
+* Dependencies are now managed and installed using Go modules. See README.md for details, [#406](https://github.com/wtfutil/wtf/issues/406) by [@retgits](https://github.com/retgits)
 
 ## 0.7.2
 
@@ -214,7 +587,7 @@
 ### ⚡️ Added
 
 * Resource Usage module added by [@nicholas-eden](https://github.com/nicholas-eden)
-* Recursive repo search in Git module ([#126](https://github.com/wtfutil/wtf/issues/126) by [@anandsudhir](http://github.com/anandsudhir)) 
+* Recursive repo search in Git module ([#126](https://github.com/wtfutil/wtf/issues/126) by [@anandsudhir](http://github.com/anandsudhir))
 * HTTP/HTTPS handling in OpenFile() util function by [@jdenoy](https://github.com/jdenoy)
 * Honor system http proxies when using non-default transport by [@skymeyer](https://github.com/skymeyer)
 * VictorOps module added by [ImDevinC](https://github.com/ImDevinC)

CONTRIBUTING.md

@@ -1,16 +1,12 @@
 # Contributing
 
-When contributing to this repository, please first discuss the change you wish to make via issue,
-email, or any other method with the owners of this repository before making a change.
-
-Note that we have a code of conduct. Please follow it in all your interactions with the project.
-
 ## Pull Request Process
 
 1. Ensure any install or build dependencies are removed before the end of the layer when doing a
    build.
 2. Update the static documentation with details of changes to the interface, this includes new environment
    variables, useful file locations and configuration parameters.
+
 Documentation lives at [wtfdocs](https://github.com/wtfutil/wtfdocs) and is a [Hugo](https://gohugo.io) app. See Hugo's documentation for usage.
 
 ## Code of Conduct

Dockerfile

@@ -1,3 +1,26 @@
-FROM scratch
-COPY wtfutil /
-ENTRYPOINT ["/wtfutil"]
+FROM golang:1.16-alpine as build
+
+ARG version=master
+
+RUN apk add git make ncurses && \
+    git clone https://github.com/wtfutil/wtf.git $GOPATH/src/github.com/wtfutil/wtf && \
+    cd $GOPATH/src/github.com/wtfutil/wtf && \
+    git checkout $version
+
+ENV GOPROXY=https://proxy.golang.org,direct
+ENV GO111MODULE=on
+ENV GOSUMDB=off
+
+WORKDIR $GOPATH/src/github.com/wtfutil/wtf
+
+ENV PATH=$PATH:./bin
+
+RUN make build
+
+FROM alpine
+
+COPY --from=build /go/src/github.com/wtfutil/wtf/bin/wtfutil /usr/local/bin/
+RUN adduser -h /config -DG users -u 20000 wtf
+
+USER wtf
+ENTRYPOINT ["wtfutil"]

Dockerfile.build

@@ -0,0 +1,18 @@
+FROM golang:1.16 as build
+
+ARG version=master
+
+RUN git clone https://github.com/wtfutil/wtf.git $GOPATH/src/github.com/wtfutil/wtf && \
+    cd $GOPATH/src/github.com/wtfutil/wtf && \
+    git checkout $version
+
+ENV GOPROXY=https://proxy.golang.org,direct
+ENV GO111MODULE=on
+ENV GOSUMDB=off
+
+WORKDIR $GOPATH/src/github.com/wtfutil/wtf
+
+ENV PATH=$PATH:./bin
+
+RUN make build && \
+    cp bin/wtfutil /usr/local/bin/

LICENSE.md

@@ -1,6 +1,8 @@
-Copyright 2018, Chris Cummer
+*Mozilla Public License, version 2.0* 
 
-Mozilla Public License, version 2.0 1. Definitions 1.1. “Contributor” means each individual or legal entity that creates, contributes to the creation of, or owns Covered Software.
+1. Definitions 
+ 
+1.1. “Contributor” means each individual or legal entity that creates, contributes to the creation of, or owns Covered Software.
 
 1.2. “Contributor Version” means the combination of the Contributions of others (if any) used by a Contributor and that particular Contributor’s Contribution.
 
@@ -24,9 +26,9 @@ that the Covered Software was made available under the terms of version 1.1 or e
 
 1.10. “Modifications” means any of the following:
 
-any file in Source Code Form that results from an addition to, deletion from, or modification of the contents of Covered Software; or
+  any file in Source Code Form that results from an addition to, deletion from, or modification of the contents of Covered Software; or
 
-any new file in Source Code Form that contains any Covered Software.
+  any new file in Source Code Form that contains any Covered Software.
 
 1.11. “Patent Claims” of a Contributor means any patent claim(s), including without limitation, method, process, and apparatus claims, in any patent Licensable by such Contributor that would be infringed, but for the grant of the License, by the making, using, selling, offering for sale, having made, import, or transfer of either its Contributions or its Contributor Version.
 
@@ -36,7 +38,9 @@ any new file in Source Code Form that contains any Covered Software.
 
 1.14. “You” (or “Your”) means an individual or a legal entity exercising rights under this License. For legal entities, “You” includes any entity that controls, is controlled by, or is under common control with You. For purposes of this definition, “control” means (a) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (b) ownership of more than fifty percent (50%) of the outstanding shares or beneficial ownership of such entity.
 
-2. License Grants and Conditions 2.1. Grants Each Contributor hereby grants You a world-wide, royalty-free, non-exclusive license:
+2. License Grants and Conditions 
+ 
+2.1. Grants Each Contributor hereby grants You a world-wide, royalty-free, non-exclusive license:
 
 under intellectual property rights (other than patent or trademark) Licensable by such Contributor to use, reproduce, make available, modify, display, perform, distribute, and otherwise exploit its Contributions, either on an unmodified basis, with Modifications, or as part of a Larger Work; and
 
@@ -62,7 +66,9 @@ This License does not grant any rights in the trademarks, service marks, or logo
 
 2.7. Conditions Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted in Section 2.1.
 
-3. Responsibilities 3.1. Distribution of Source Form All distribution of Covered Software in Source Code Form, including any Modifications that You create or to which You contribute, must be under the terms of this License. You must inform recipients that the Source Code Form of the Covered Software is governed by the terms of this License, and how they can obtain a copy of this License. You may not attempt to alter or restrict the recipients’ rights in the Source Code Form.
+3. Responsibilities
+
+3.1. Distribution of Source Form All distribution of Covered Software in Source Code Form, including any Modifications that You create or to which You contribute, must be under the terms of this License. You must inform recipients that the Source Code Form of the Covered Software is governed by the terms of this License, and how they can obtain a copy of this License. You may not attempt to alter or restrict the recipients’ rights in the Source Code Form.
 
 3.2. Distribution of Executable Form If You distribute Covered Software in Executable Form then:
 
@@ -76,23 +82,37 @@ You may distribute such Executable Form under the terms of this License, or subl
 
 3.5. Application of Additional Terms You may choose to offer, and to charge a fee for, warranty, support, indemnity or liability obligations to one or more recipients of Covered Software. However, You may do so only on Your own behalf, and not on behalf of any Contributor. You must make it absolutely clear that any such warranty, support, indemnity, or liability obligation is offered by You alone, and You hereby agree to indemnify every Contributor for any liability incurred by such Contributor as a result of warranty, support, indemnity or liability terms You offer. You may include additional disclaimers of warranty and limitations of liability specific to any jurisdiction.
 
-4. Inability to Comply Due to Statute or Regulation If it is impossible for You to comply with any of the terms of this License with respect to some or all of the Covered Software due to statute, judicial order, or regulation then You must: (a) comply with the terms of this License to the maximum extent possible; and (b) describe the limitations and the code they affect. Such description must be placed in a text file included with all distributions of the Covered Software under this License. Except to the extent prohibited by statute or regulation, such description must be sufficiently detailed for a recipient of ordinary skill to be able to understand it.
+4. Inability to Comply Due to Statute or Regulation 
 
-5. Termination 5.1. The rights granted under this License will terminate automatically if You fail to comply with any of its terms. However, if You become compliant, then the rights granted under this License from a particular Contributor are reinstated (a) provisionally, unless and until such Contributor explicitly and finally terminates Your grants, and (b) on an ongoing basis, if such Contributor fails to notify You of the non-compliance by some reasonable means prior to 60 days after You have come back into compliance. Moreover, Your grants from a particular Contributor are reinstated on an ongoing basis if such Contributor notifies You of the non-compliance by some reasonable means, this is the first time You have received notice of non-compliance with this License from such Contributor, and You become compliant prior to 30 days after Your receipt of the notice.
+If it is impossible for You to comply with any of the terms of this License with respect to some or all of the Covered Software due to statute, judicial order, or regulation then You must: (a) comply with the terms of this License to the maximum extent possible; and (b) describe the limitations and the code they affect. Such description must be placed in a text file included with all distributions of the Covered Software under this License. Except to the extent prohibited by statute or regulation, such description must be sufficiently detailed for a recipient of ordinary skill to be able to understand it.
+
+5. Termination 
+
+5.1. The rights granted under this License will terminate automatically if You fail to comply with any of its terms. However, if You become compliant, then the rights granted under this License from a particular Contributor are reinstated (a) provisionally, unless and until such Contributor explicitly and finally terminates Your grants, and (b) on an ongoing basis, if such Contributor fails to notify You of the non-compliance by some reasonable means prior to 60 days after You have come back into compliance. Moreover, Your grants from a particular Contributor are reinstated on an ongoing basis if such Contributor notifies You of the non-compliance by some reasonable means, this is the first time You have received notice of non-compliance with this License from such Contributor, and You become compliant prior to 30 days after Your receipt of the notice.
 
 5.2. If You initiate litigation against any entity by asserting a patent infringement claim (excluding declaratory judgment actions, counter-claims, and cross-claims) alleging that a Contributor Version directly or indirectly infringes any patent, then the rights granted to You by any and all Contributors for the Covered Software under Section 2.1 of this License shall terminate.
 
 5.3. In the event of termination under Sections 5.1 or 5.2 above, all end user license agreements (excluding distributors and resellers) which have been validly granted by You or Your distributors under this License prior to termination shall survive termination.
 
-6. Disclaimer of Warranty Covered Software is provided under this License on an “as is” basis, without warranty of any kind, either expressed, implied, or statutory, including, without limitation, warranties that the Covered Software is free of defects, merchantable, fit for a particular purpose or non-infringing. The entire risk as to the quality and performance of the Covered Software is with You. Should any Covered Software prove defective in any respect, You (not any Contributor) assume the cost of any necessary servicing, repair, or correction. This disclaimer of warranty constitutes an essential part of this License. No use of any Covered Software is authorized under this License except under this disclaimer.
+6. Disclaimer of Warranty 
 
-7. Limitation of Liability Under no circumstances and under no legal theory, whether tort (including negligence), contract, or otherwise, shall any Contributor, or anyone who distributes Covered Software as permitted above, be liable to You for any direct, indirect, special, incidental, or consequential damages of any character including, without limitation, damages for lost profits, loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses, even if such party shall have been informed of the possibility of such damages. This limitation of liability shall not apply to liability for death or personal injury resulting from such party’s negligence to the extent applicable law prohibits such limitation. Some jurisdictions do not allow the exclusion or limitation of incidental or consequential damages, so this exclusion and limitation may not apply to You.
+Covered Software is provided under this License on an “as is” basis, without warranty of any kind, either expressed, implied, or statutory, including, without limitation, warranties that the Covered Software is free of defects, merchantable, fit for a particular purpose or non-infringing. The entire risk as to the quality and performance of the Covered Software is with You. Should any Covered Software prove defective in any respect, You (not any Contributor) assume the cost of any necessary servicing, repair, or correction. This disclaimer of warranty constitutes an essential part of this License. No use of any Covered Software is authorized under this License except under this disclaimer.
 
-8. Litigation Any litigation relating to this License may be brought only in the courts of a jurisdiction where the defendant maintains its principal place of business and such litigation shall be governed by laws of that jurisdiction, without reference to its conflict-of-law provisions. Nothing in this Section shall prevent a party’s ability to bring cross-claims or counter-claims.
+7. Limitation of Liability 
 
-9. Miscellaneous This License represents the complete agreement concerning the subject matter hereof. If any provision of this License is held to be unenforceable, such provision shall be reformed only to the extent necessary to make it enforceable. Any law or regulation which provides that the language of a contract shall be construed against the drafter shall not be used to construe this License against a Contributor.
+Under no circumstances and under no legal theory, whether tort (including negligence), contract, or otherwise, shall any Contributor, or anyone who distributes Covered Software as permitted above, be liable to You for any direct, indirect, special, incidental, or consequential damages of any character including, without limitation, damages for lost profits, loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses, even if such party shall have been informed of the possibility of such damages. This limitation of liability shall not apply to liability for death or personal injury resulting from such party’s negligence to the extent applicable law prohibits such limitation. Some jurisdictions do not allow the exclusion or limitation of incidental or consequential damages, so this exclusion and limitation may not apply to You.
 
-10. Versions of the License 10.1. New Versions Mozilla Foundation is the license steward. Except as provided in Section 10.3, no one other than the license steward has the right to modify or publish new versions of this License. Each version will be given a distinguishing version number.
+8. Litigation 
+
+Any litigation relating to this License may be brought only in the courts of a jurisdiction where the defendant maintains its principal place of business and such litigation shall be governed by laws of that jurisdiction, without reference to its conflict-of-law provisions. Nothing in this Section shall prevent a party’s ability to bring cross-claims or counter-claims.
+
+9. Miscellaneous 
+
+This License represents the complete agreement concerning the subject matter hereof. If any provision of this License is held to be unenforceable, such provision shall be reformed only to the extent necessary to make it enforceable. Any law or regulation which provides that the language of a contract shall be construed against the drafter shall not be used to construe this License against a Contributor.
+
+10. Versions of the License 
+
+10.1. New Versions Mozilla Foundation is the license steward. Except as provided in Section 10.3, no one other than the license steward has the right to modify or publish new versions of this License. Each version will be given a distinguishing version number.
 
 10.2. Effect of New Versions You may distribute the Covered Software under the terms of the version of the License under which You originally received the Covered Software, or under the terms of any subsequent version published by the license steward.
 
@@ -100,10 +120,14 @@ You may distribute such Executable Form under the terms of this License, or subl
 
 10.4. Distributing Source Code Form that is Incompatible With Secondary Licenses If You choose to distribute Source Code Form that is Incompatible With Secondary Licenses under the terms of this version of the License, the notice described in Exhibit B of this License must be attached.
 
-Exhibit A - Source Code Form License Notice This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
+Exhibit A - Source Code Form License Notice 
+
+This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
 
 If it is not possible or desirable to put the notice in a particular file, then You may include the notice in a location (such as a LICENSE file in a relevant directory) where a recipient would be likely to look for such a notice.
 
 You may add additional accurate notices of copyright ownership.
 
-Exhibit B - “Incompatible With Secondary Licenses” Notice This Source Code Form is “Incompatible With Secondary Licenses”, as defined by the Mozilla Public License, v. 2.0.
+Exhibit B - “Incompatible With Secondary Licenses” Notice 
+
+This Source Code Form is “Incompatible With Secondary Licenses”, as defined by the Mozilla Public License, v. 2.0.

Makefile

@@ -1,58 +1,164 @@
-.PHONY: build contrib_check install binary_msg lint run size test uninstall
+.PHONY: build clean contrib_check coverage docker-build docker-install help install isntall lint run size test uninstall
 
 # detect GOPATH if not set
 ifndef $(GOPATH)
-		$(info GOPATH is not set, autodetecting..)
-		TESTPATH := $(dir $(abspath ../../..))
-		DIRS := bin pkg src
-		# create a ; separated line of tests and pass it to shell
-		MISSING_DIRS := $(shell $(foreach entry,$(DIRS),test -d "$(TESTPATH)$(entry)" || echo "$(entry)";))
-		ifeq ($(MISSING_DIRS),)
-				$(info Found GOPATH: $(TESTPATH))
-				export GOPATH := $(TESTPATH)
-		else
-				$(info ..missing dirs "$(MISSING_DIRS)" in "$(TESTDIR)")
-				$(info GOPATH autodetection failed)
-		endif
+	$(info GOPATH is not set, autodetecting..)
+	TESTPATH := $(dir $(abspath ../../..))
+	DIRS := bin pkg src
+
+	# create a ; separated line of tests and pass it to shell
+	MISSING_DIRS := $(shell $(foreach entry,$(DIRS),test -d "$(TESTPATH)$(entry)" || echo "$(entry)";))
+	ifeq ($(MISSING_DIRS),)
+		$(info Found GOPATH: $(TESTPATH))
+		export GOPATH := $(TESTPATH)
+	else
+		$(info ..missing dirs "$(MISSING_DIRS)" in "$(TESTDIR)")
+		$(info GOPATH autodetection failed)
+	endif
 endif
 
 # Set go modules to on and use GoCenter for immutable modules
 export GO111MODULE = on
-export GOPROXY = https://gocenter.io
+export GOPROXY = https://proxy.golang.org,direct
 
 # Determines the path to this Makefile
 THIS_FILE := $(lastword $(MAKEFILE_LIST))
 
-build:
-	go build -o bin/wtfutil
-	@$(MAKE) -f $(THIS_FILE) binary_msg
+APP=wtfutil
 
-contrib_check:
+define HEADER
+____    __    ____ .___________. _______
+\   \  /  \  /   / |           ||   ____|
+ \   \/    \/   /  `---|  |----`|  |__
+  \            /       |  |     |   __|
+   \    /\    /        |  |     |  |
+    \__/  \__/         |__|     |__|
+
+endef
+export HEADER
+
+# -------------------- Actions -------------------- #
+
+## build: builds a local version
+build:
+	@echo "$$HEADER"
+	@echo "Building..."
+	go build -o bin/${APP}
+	@echo "Done building"
+
+## clean: removes old build cruft
+clean:
+	rm -rf ./dist
+	rm -rf ./bin/${APP}
+	@echo "Done cleaning"
+
+## contrib-check: checks for any contributors who have not been given due credit
+contrib-check:
 	npx all-contributors-cli check
 
+## coverage: figures out and displays test code coverage
+coverage:
+	go test -coverprofile=coverage.out ./...
+	go tool cover -html=coverage.out
+
+## docker-build: builds in docker
+docker-build:
+	@echo "Building ${APP} in Docker..."
+	docker build -t wtfutil:build --build-arg=version=master -f Dockerfile.build .
+	@echo "Done with docker build"
+
+## docker-install: installs a local version of the app from docker build
+docker-install:
+	@echo "Installing..."
+	docker create --name wtf_build wtfutil:build
+	docker cp wtf_build:/usr/local/bin/wtfutil ~/.local/bin/
+	$(eval INSTALLPATH = $(shell which ${APP}))
+	@echo "${APP} installed into ${INSTALLPATH}"
+	docker rm wtf_build
+
+## gosec: runs the gosec static security scanner against the source code
+gosec:
+	gosec -tests ./...
+
+## help: prints this help message
+help:
+	@echo "Usage: \n"
+	@sed -n 's/^##//p' ${MAKEFILE_LIST} | column -t -s ':' |  sed -e 's/^/ /'
+
+## isntall: an alias for 'install'
+isntall:
+	@$(MAKE) -f $(THIS_FILE) install
+
+## install: installs a local version of the app
 install:
-	@echo "Installing wtfutil..."
+	$(eval GOVERS = $(shell go version))
+	@echo "$$HEADER"
+	@echo "Installing ${APP} with ${GOVERS}..."
 	@go clean
 	@go install -ldflags="-s -w -X main.version=$(shell git describe --always --abbrev=6) -X main.date=$(shell date +%FT%T%z)"
-	@mv ~/go/bin/wtf ~/go/bin/wtfutil
-	@$(MAKE) -f $(THIS_FILE) binary_msg
-
-binary_msg:
-	@echo "Install path: "
-	@which wtfutil || echo "Could not find wtfutil in PATH" && exit 0
+	@mv ~/go/bin/wtf ~/go/bin/${APP}
+	$(eval INSTALLPATH = $(shell which ${APP}))
+	@echo "${APP} installed into ${INSTALLPATH}"
 
+## lint: runs a number of code quality checks against the source code
 lint:
-	structcheck ./...
-	varcheck ./...
+	golangci-lint cache clean
+	golangci-lint run
 
+# lint:
+# 	@echo "\033[35mhttps://github.com/kisielk/errcheck\033[0m"
+# 	errcheck ./app
+# 	errcheck ./cfg
+# 	errcheck ./flags
+# 	errcheck ./help
+# 	errcheck ./logger
+# 	errcheck ./modules/...
+# 	errcheck ./utils
+# 	errcheck ./view
+# 	errcheck ./wtf
+# 	errcheck ./main.go
+
+# 	@echo "\033[35mhttps://golang.org/cmd/vet/k\033[0m"
+# 	go vet ./app
+# 	go vet ./cfg
+# 	go vet ./flags
+# 	go vet ./help
+# 	go vet ./logger
+# 	go vet ./modules/...
+# 	go vet ./utils
+# 	go vet ./view
+# 	go vet ./wtf
+# 	go vet ./main.go
+
+# 	@echo "\033[35m# https://staticcheck.io/docs/k\033[0m"
+# 	staticcheck ./app
+# 	staticcheck ./cfg
+# 	staticcheck ./flags
+# 	staticcheck ./help
+# 	staticcheck ./logger
+# 	staticcheck ./modules/...
+# 	staticcheck ./utils
+# 	staticcheck ./view
+# 	staticcheck ./wtf
+# 	staticcheck ./main.go
+
+# 	@echo "\033[35m# https://github.com/mdempsky/unconvert\033[0m"
+# 	unconvert ./...
+
+## loc: displays the lines of code (LoC) count
+loc:
+	@loc --exclude _sample_configs/ _site/ docs/ Makefile *.md
+
+## run: executes the locally-installed version
 run: build
-	bin/wtfutil
-
-size:
-	loc --exclude _sample_configs/ _site/ docs/ Makefile *.md
+	@echo "$$HEADER"
+	bin/${APP}
 
+## test: runs the test suite
 test: build
+	@echo "$$HEADER"
 	go test ./...
 
+## uninstall: uninstals a locally-installed version
 uninstall:
-	@rm ~/go/bin/wtfutil
+	@rm ~/go/bin/${APP}

README.md

@@ -1,39 +1,51 @@
+<p align="center">
+    <img src="./images/logo_transparent.png?raw=true" title="WTF" alt="WTF" width="560" height="560" />
+</p>
 
-[![All Contributors](https://img.shields.io/badge/all_contributors-78-orange.svg?style=flat-square)](#contributors)
-[![Build Status](https://travis-ci.com/wtfutil/wtf.svg?branch=master)](https://travis-ci.com/wtfutil/wtf)
-[![Twitter](https://img.shields.io/badge/follow-on%20twitter-blue.svg)](https://twitter.com/wtfutil)
-[![Go Report Card](https://goreportcard.com/badge/github.com/wtfutil/wtf)](https://goreportcard.com/report/github.com/wtfutil/wtf)
+<p align="center">
+    <a href="#contributors"><img alt="All Contributors" src="https://img.shields.io/badge/all_contributors-114-orange.svg?style=flat-square"></a>
+    <a href="https://travis-ci.com/wtfutil/wtf"><img alt="Travis Status" src="https://img.shields.io/travis/com/wtfutil/wtf/master.svg?label=travis&maxAge=43200"></a>
+    <a href="https://goreportcard.com/report/github.com/wtfutil/wtf"><img alt="Go Report Card" src="https://goreportcard.com/badge/github.com/wtfutil/wtf"></a>
+    <a href="https://twitter.com/wtfutil"><img alt="Twitter" src="https://img.shields.io/badge/follow-on%20twitter-blue.svg"></a>
+</p>
 
-# WTF
+WTF (aka 'wtfutil') is the personal information dashboard for your terminal, providing at-a-glance access to your very important but infrequently-needed stats and data.
 
-A personal terminal-based dashboard utility, designed for
-displaying infrequently-needed, but very important, daily data.
+Used by thousands of developers and tech people around the world, WTF is free and open-source. To support the continued use and development of WTF, please consider sponsoring WTF via [GitHub Sponsors](https://github.com/sponsors/senorprogrammer).
 
-* [Screenshot](#screenshot)
-* [Quick Start](#quick-start)
-    * [Install via Homebrew](#install-via-homebrew)
-    * [Install the Binary](#install-the-binary)
-    * [Install from Source](#install-from-source)
+### Are you a contributor or sponsor?
+
+Awesome! [See here](https://wtfutil.com/#exit-message) for how you can change the exit message, the message WTF shows when quitting, to something special just for you.
+
+#
+
+<p></p>
+
+* [Installation](#installation)
+    * [Installing via Homebrew](#installing-via-homebrew)
+    * [Installing via MacPorts](#installing-via-macports)
+    * [Installing a Binary](#installing-a-binary)
+    * [Installing from Source](#installing-from-source)
+    * [Running via Docker](#running-via-docker)
 * [Communication](#communication)
     * [Slack](#slack)
     * [Twitter](#twitter)
 * [Documentation](#documentation)
 * [Modules](#modules)
+* [Getting Bugs Fixed or Features Added](#getting-bugs-fixed-or-features-added)
 * [Contributing to the Source Code](#contributing-to-the-source-code)
     * [Adding Dependencies](#adding-dependencies)
 * [Contributing to the Documentation](#contributing-to-the-documentation)
 * [Contributors](#contributors)
 * [Acknowledgements](#acknowledgments)
 
-## Screenshot
-
 <p align="center">
 <img src="./images/screenshot.jpg" title="screenshot" width="720" height="420" />
 </p>
 
-## Quick Start
+## Installation
 
-### Install via Homebrew
+### Installing via Homebrew
 
 The simplest way from Homebrew:
 
@@ -52,7 +64,18 @@ brew install wtfutil
 wtfutil
 ```
 
-### Install the Binary
+### Installing via MacPorts
+
+You can also install via [MacPorts](https://www.macports.org/):
+
+```console
+sudo port selfupdate
+sudo port install wtfutil
+
+wtfutil
+```
+
+### Installing a Binary
 
 [Download the latest binary](https://github.com/wtfutil/wtf/releases) from GitHub.
 
@@ -64,13 +87,16 @@ chmod a+x /usr/local/bin/wtfutil
 
 and you should be good to go.
 
-### Install from Source
+### Installing from Source
 
 If you want to run the build command from within your `$GOPATH`:
 
 ```bash
-# Set the Go proxy variable to GoCenter
-export GOPROXY="https://gocenter.io"
+# Set the Go proxy
+export GOPROXY="https://proxy.golang.org,direct"
+
+# Disable the Go checksum database
+export GOSUMDB=off
 
 # Enable Go modules
 export GO111MODULE=on
@@ -84,8 +110,8 @@ make run
 If you want to run the build command from a folder that is not in your `$GOPATH`:
 
 ```bash
-# Set the Go proxy variable to GoCenter
-export GOPROXY="https://gocenter.io"
+# Set the Go proxy
+export GOPROXY="https://proxy.golang.org,direct"
 
 go get -u github.com/wtfutil/wtf
 cd $GOPATH/src/github.com/wtfutil/wtf
@@ -93,7 +119,45 @@ make install
 make run
 ```
 
-**Note:** WTF is _only_ compatible with Go versions **1.11.0** or later (due to the use of Go modules). If you would like to use `gccgo` to compile, you _must_ use `gccgo-9` or later which introduces support for Go modules.
+### Installing from Source using Docker
+
+All building is done inside a docker container. You can then copy the binary to
+your local machine.
+
+```bash
+curl -o Dockerfile.build https://raw.githubusercontent.com/wtfutil/wtf/master/Dockerfile.build
+docker build -f Dockerfile.build -t wtfutil --build-arg=version=master .
+docker create --name wtf_build wtfutil
+docker cp wtf_build:/usr/local/bin/wtfutil ~/.local/bin
+docker rm wtf_build
+```
+
+**Note:** WTF is _only_ compatible with Go versions **1.16.0** or later (due to the use of Go modules and newer standard library functions). If you would like to use `gccgo` to compile, you _must_ use `gccgo-9` or later which introduces support for Go modules.
+
+### Installing via Arch User Repository
+
+Arch Linux users can utilise the [wtfutil](https://aur.archlinux.org/packages/wtfutil) package to build it from source, or [wtfutil-bin](https://aur.archlinux.org/packages/wtfutil-bin/) to install pre-built binaries.
+
+## Running via Docker
+
+You can run `wtf` inside a docker container:
+
+```bash
+# download or create the Dockerfile
+curl -o Dockerfile https://raw.githubusercontent.com/wtfutil/wtf/master/Dockerfile
+
+# build the docker container
+docker build -t wtfutil .
+
+# or for a particular tag or branch
+docker build --build-arg=version=v0.25.0 -t wtfutil .
+
+# run the container
+docker run -it wtfutil
+
+# run container with a local config file
+docker run -it -v path/to/config.yml:/config/config.yml wtfutil --config=/config/config.yml
+```
 
 ## Communication
 
@@ -105,15 +169,15 @@ Find #wtfutil on https://gophers.slack.com/ and join us.
 
 ### Twitter
 
-Also, follow [on Twitter](https://twitter.com/wtfutil) for news and latest updates. 
+Also, follow [on Twitter](https://twitter.com/wtfutil) for news and latest updates.
 
 ## Documentation
 
 See [https://wtfutil.com](https://wtfutil.com) for the definitive
 documentation. Here's some short-cuts:
 
-* [Installation](https://wtfutil.com/getting_started/installation/)
-* [Configuration](https://wtfutil.com/configuration/)
+* [Installation](https://wtfutil.com/quick_start/)
+* [Configuration](https://wtfutil.com/configuration/files/)
 * [Module Documentation](https://wtfutil.com/modules/)
 
 ## Modules
@@ -122,6 +186,7 @@ Modules are the chunks of functionality that make WTF useful. Modules are added
 
 Some interesting modules you might consider adding to get you started:
 
+* [DigitalOcean](https://wtfutil.com/modules/digitalocean/)
 * [GitHub](https://wtfutil.com/modules/github/)
 * [Google Calendar](https://wtfutil.com/modules/google/gcal/)
 * [HackerNews](https://wtfutil.com/modules/hackernews/)
@@ -132,15 +197,21 @@ Some interesting modules you might consider adding to get you started:
 * [Transmission](https://wtfutil.com/modules/transmission/)
 * [Trello](https://wtfutil.com/modules/trello/)
 
+## Getting Bugs Fixed or Features Added
+
+WTF is open-source software, informally maintained by a small collection of volunteers who come and go at their leisure. There are absolutely no guarantees that, even if an issue is opened for them, bugs will be fixed or features added.
+
+If there is a bug that you really need to have fixed or a feature you really want to have implemented, you can greatly increase your chances of that happening by creating a bounty on [BountySource](https://www.bountysource.com) to provide an incentive for someone to tackle it.
+
 ## Contributing to the Source Code
 
-First, please read [Talk, then code](https://dave.cheney.net/2019/02/18/talk-then-code) by Dave Cheney. It's great advice and will often save a lot of time and effort. 
+First, kindly read [Talk, then code](https://dave.cheney.net/2019/02/18/talk-then-code) by Dave Cheney. It's great advice and will often save a lot of time and effort.
 
-Next, please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests.
+Next, kindly read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests.
 
 Then create your branch, write your code, submit your PR, and join the rest of the awesome people who've contributed their time and effort towards WTF. Without their contributors, WTF wouldn't be possible.
 
-And don't worry if you've never written Go before, or never contributed to an open source project before, or that your code won't be good enough. For a surprising number of people WTF has been their first Go project, or first open source contribution. If you're here, and you've read this far, you're the right stuff.
+Don't worry if you've never written Go before, or never contributed to an open source project before, or that your code won't be good enough. For a surprising number of people WTF has been their first Go project, or first open source contribution. If you're here, and you've read this far, you're the right stuff.
 
 ## Contributing to the Documentation
 
@@ -155,20 +226,210 @@ Dependency management in WTF is handled by [Go modules](https://github.com/golan
 ## Contributors
 
 <!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
-<!-- prettier-ignore -->
-| [<img src="https://avatars0.githubusercontent.com/u/6413?v=4" width="48px;" alt="Chris Cummer"/><br /><sub><b>Chris Cummer</b></sub>](https://twitter.com/senorprogrammer)<br /> | [<img src="https://avatars2.githubusercontent.com/u/3252403?v=4" width="48px;" alt="Anand Sudhir Prayaga"/><br /><sub><b>Anand Sudhir Prayaga</b></sub>](https://github.com/anandsudhir)<br /> | [<img src="https://avatars1.githubusercontent.com/u/34973359?v=4" width="48px;" alt="Hossein Mehrabi"/><br /><sub><b>Hossein Mehrabi</b></sub>](https://github.com/jeangovil)<br /> | [<img src="https://avatars0.githubusercontent.com/u/11779018?v=4" width="48px;" alt="FengYa"/><br /><sub><b>FengYa</b></sub>](https://github.com/Fengyalv)<br /> | [<img src="https://avatars2.githubusercontent.com/u/17337753?v=4" width="48px;" alt="deltax"/><br /><sub><b>deltax</b></sub>](https://fluxionnetwork.github.io/fluxion/)<br /> | [<img src="https://avatars0.githubusercontent.com/u/1319630?v=4" width="48px;" alt="Bill Keenan"/><br /><sub><b>Bill Keenan</b></sub>](https://github.com/BillKeenan)<br /> | [<img src="https://avatars2.githubusercontent.com/u/118081?v=4" width="48px;" alt="June S"/><br /><sub><b>June S</b></sub>](http://blog.sapara.com)<br /> |
-| :---: | :---: | :---: | :---: | :---: | :---: | :---: |
-| [<img src="https://avatars3.githubusercontent.com/u/16461061?v=4" width="48px;" alt="liyiheng"/><br /><sub><b>liyiheng</b></sub>](https://github.com/XanthusL)<br /> | [<img src="https://avatars2.githubusercontent.com/u/9014288?v=4" width="48px;" alt="baustinanki"/><br /><sub><b>baustinanki</b></sub>](https://github.com/baustinanki)<br /> | [<img src="https://avatars0.githubusercontent.com/u/371475?v=4" width="48px;" alt="lucus lee"/><br /><sub><b>lucus lee</b></sub>](https://github.com/lixin9311)<br /> | [<img src="https://avatars1.githubusercontent.com/u/7537841?v=4" width="48px;" alt="Mike Lloyd"/><br /><sub><b>Mike Lloyd</b></sub>](https://github.com/mxplusb)<br /> | [<img src="https://avatars3.githubusercontent.com/u/10998?v=4" width="48px;" alt="Sergio Rubio"/><br /><sub><b>Sergio Rubio</b></sub>](http://rubiojr.rbel.co)<br /> | [<img src="https://avatars3.githubusercontent.com/u/17374492?v=4" width="48px;" alt="Farhad Farahi"/><br /><sub><b>Farhad Farahi</b></sub>](https://github.com/FarhadF)<br /> | [<img src="https://avatars1.githubusercontent.com/u/634604?v=4" width="48px;" alt="Lasantha Kularatne"/><br /><sub><b>Lasantha Kularatne</b></sub>](http://lasantha.blogspot.com/)<br /> |
-| [<img src="https://avatars1.githubusercontent.com/u/823331?v=4" width="48px;" alt="Mark Old"/><br /><sub><b>Mark Old</b></sub>](https://github.com/dlom)<br /> | [<img src="https://avatars0.githubusercontent.com/u/5546718?v=4" width="48px;" alt="flw"/><br /><sub><b>flw</b></sub>](http://flw.tools/)<br /> | [<img src="https://avatars0.githubusercontent.com/u/6024927?v=4" width="48px;" alt="David Barda"/><br /><sub><b>David Barda</b></sub>](https://github.com/davebarda)<br /> | [<img src="https://avatars2.githubusercontent.com/u/4261980?v=4" width="48px;" alt="Geoff Lee"/><br /><sub><b>Geoff Lee</b></sub>](https://github.com/matrinox)<br /> | [<img src="https://avatars3.githubusercontent.com/u/1022918?v=4" width="48px;" alt="George Opritescu"/><br /><sub><b>George Opritescu</b></sub>](http://international.github.io)<br /> | [<img src="https://avatars3.githubusercontent.com/u/497310?v=4" width="48px;" alt="Grazfather"/><br /><sub><b>Grazfather</b></sub>](https://twitter.com/Grazfather)<br /> | [<img src="https://avatars2.githubusercontent.com/u/1691120?v=4" width="48px;" alt="Michael Cordell"/><br /><sub><b>Michael Cordell</b></sub>](http://www.mikecordell.com/)<br /> |
-| [<img src="https://avatars2.githubusercontent.com/u/1215497?v=4" width="48px;" alt="Patrick José Pereira"/><br /><sub><b>Patrick José Pereira</b></sub>](http://patrick.ibexcps.com)<br /> | [<img src="https://avatars2.githubusercontent.com/u/1483092?v=4" width="48px;" alt="sherod taylor"/><br /><sub><b>sherod taylor</b></sub>](https://github.com/sherodtaylor)<br /> | [<img src="https://avatars2.githubusercontent.com/u/3062663?v=4" width="48px;" alt="Andrew Scott"/><br /><sub><b>Andrew Scott</b></sub>](http://cogentia.io)<br /> | [<img src="https://avatars1.githubusercontent.com/u/12018440?v=4" width="48px;" alt="Lassi Piironen"/><br /><sub><b>Lassi Piironen</b></sub>](https://github.com/lsipii)<br /> | [<img src="https://avatars0.githubusercontent.com/u/14799210?v=4" width="48px;" alt="BlackWebWolf"/><br /><sub><b>BlackWebWolf</b></sub>](https://github.com/BlackWebWolf)<br /> | [<img src="https://avatars0.githubusercontent.com/u/1894885?v=4" width="48px;" alt="andrewzolotukhin"/><br /><sub><b>andrewzolotukhin</b></sub>](https://github.com/andrewzolotukhin)<br /> | [<img src="https://avatars1.githubusercontent.com/u/8568280?v=4" width="48px;" alt="Leon Stigter"/><br /><sub><b>Leon Stigter</b></sub>](https://retgits.github.io)<br /> |
-| [<img src="https://avatars3.githubusercontent.com/u/21756?v=4" width="48px;" alt="Amr Tamimi"/><br /><sub><b>Amr Tamimi</b></sub>](https://tamimi.se)<br /> | [<img src="https://avatars3.githubusercontent.com/u/3717137?v=4" width="48px;" alt="Jagdeep Singh"/><br /><sub><b>Jagdeep Singh</b></sub>](https://jagdeep.me)<br /> | [<img src="https://avatars0.githubusercontent.com/u/889171?v=4" width="48px;" alt="Lineu Felipe"/><br /><sub><b>Lineu Felipe</b></sub>](https://github.com/darkSasori)<br /> | [<img src="https://avatars2.githubusercontent.com/u/159124?v=4" width="48px;" alt="Konstantin"/><br /><sub><b>Konstantin</b></sub>](https://github.com/kvj)<br /> | [<img src="https://avatars2.githubusercontent.com/u/6044920?v=4" width="48px;" alt="Brendan O'Leary"/><br /><sub><b>Brendan O'Leary</b></sub>](http://www.brendanoleary.com)<br /> | [<img src="https://avatars2.githubusercontent.com/u/1226441?v=4" width="48px;" alt="bertl4398"/><br /><sub><b>bertl4398</b></sub>](https://github.com/bertl4398)<br /> | [<img src="https://avatars2.githubusercontent.com/u/6553695?v=4" width="48px;" alt="Ferenc-"/><br /><sub><b>Ferenc-</b></sub>](https://github.com/Ferenc-)<br /> |
-| [<img src="https://avatars1.githubusercontent.com/u/952036?v=4" width="48px;" alt="Rohan Verma"/><br /><sub><b>Rohan Verma</b></sub>](http://rohanverma.net)<br /> | [<img src="https://avatars1.githubusercontent.com/u/19293566?v=4" width="48px;" alt="Tim Fitzgerald"/><br /><sub><b>Tim Fitzgerald</b></sub>](https://github.com/fimtitzgerald)<br /> | [<img src="https://avatars2.githubusercontent.com/u/1081051?v=4" width="48px;" alt="Federico Ruggi"/><br /><sub><b>Federico Ruggi</b></sub>](https://github.com/ruggi)<br /> | [<img src="https://avatars2.githubusercontent.com/u/7293328?v=4" width="48px;" alt="Craig Woodward"/><br /><sub><b>Craig Woodward</b></sub>](https://github.com/ctwoodward)<br /> | [<img src="https://avatars3.githubusercontent.com/u/15367484?v=4" width="48px;" alt="ReadmeCritic"/><br /><sub><b>ReadmeCritic</b></sub>](https://twitter.com/ReadmeCritic)<br /> | [<img src="https://avatars0.githubusercontent.com/u/141402?v=4" width="48px;" alt="Eugene"/><br /><sub><b>Eugene</b></sub>](https://github.com/jdevelop)<br /> | [<img src="https://avatars1.githubusercontent.com/u/12983705?s=460&v=4" width="48px;" alt="Kenny Wu"/><br /><sub><b>Kenny Wu</b></sub>](https://github.com/Trinergy)<br /> |
-| [<img src="https://avatars0.githubusercontent.com/u/538234?v=4" width="48px;" alt="Renán Romero"/><br /><sub><b>Renán Romero</b></sub>](http://www.romeroruiz.com)<br /> | [<img src="https://avatars1.githubusercontent.com/u/5031240?v=4" width="48px;" alt="Bastian Groß"/><br /><sub><b>Bastian Groß</b></sub>](https://github.com/sticreations)<br /> | [<img src="https://avatars1.githubusercontent.com/u/2496835?v=4" width="48px;" alt="nicholas-eden"/><br /><sub><b>nicholas-eden</b></sub>](https://github.com/nicholas-eden)<br /> | [<img src="https://avatars1.githubusercontent.com/u/279390?v=4" width="48px;" alt="Dan Rabinowitz"/><br /><sub><b>Dan Rabinowitz</b></sub>](https://github.com/danrabinowitz)<br /> | [<img src="https://avatars1.githubusercontent.com/u/6897575?v=4" width="48px;" alt="David Missmann"/><br /><sub><b>David Missmann</b></sub>](https://github.com/dvdmssmnn)<br /> | [<img src="https://avatars2.githubusercontent.com/u/882006?v=4" width="48px;" alt="Mathias Weber"/><br /><sub><b>Mathias Weber</b></sub>](https://github.com/mweb)<br /> | [<img src="https://avatars1.githubusercontent.com/u/32081703?v=4" width="48px;" alt="TheRedSpy15"/><br /><sub><b>TheRedSpy15</b></sub>](https://github.com/TheRedSpy15)<br /> |
-| [<img src="https://avatars0.githubusercontent.com/u/9569897?v=4" width="48px;" alt="Harald Nordgren"/><br /><sub><b>Harald Nordgren</b></sub>](https://www.linkedin.com/in/harald-nordgren-44778192)<br /> | [<img src="https://avatars0.githubusercontent.com/u/11583824?v=4" width="48px;" alt="Matei Alexandru Gardus"/><br /><sub><b>Matei Alexandru Gardus</b></sub>](http://stormfirefox1.github.io)<br /> | [<img src="https://avatars2.githubusercontent.com/u/1523955?v=4" width="48px;" alt="Sean Smith"/><br /><sub><b>Sean Smith</b></sub>](https://github.com/Seanstoppable)<br /> | [<img src="https://avatars1.githubusercontent.com/u/1646238?v=4" width="48px;" alt="Halil Kaskavalci"/><br /><sub><b>Halil Kaskavalci</b></sub>](http://kaskavalci.com)<br /> | [<img src="https://avatars2.githubusercontent.com/u/246715?v=4" width="48px;" alt="Johan Denoyer"/><br /><sub><b>Johan Denoyer</b></sub>](http://www.johandenoyer.fr)<br /> | [<img src="https://avatars1.githubusercontent.com/u/593516?v=4" width="48px;" alt="Jelle Vink"/><br /><sub><b>Jelle Vink</b></sub>](https://skymeyer.be)<br /> | [<img src="https://avatars1.githubusercontent.com/u/3997333?v=4" width="48px;" alt="Devin Collins"/><br /><sub><b>Devin Collins</b></sub>](http://imdevinc.com)<br /> |
-| [<img src="https://avatars3.githubusercontent.com/u/18333?v=4" width="48px;" alt="Danne Stayskal"/><br /><sub><b>Danne Stayskal</b></sub>](http://danne.stayskal.com/)<br /> | [<img src="https://avatars1.githubusercontent.com/u/2006658?v=4" width="48px;" alt="Max Beizer"/><br /><sub><b>Max Beizer</b></sub>](https://www.maxbeizer.com)<br /> | [<img src="https://avatars1.githubusercontent.com/u/194392?v=4" width="48px;" alt="E:V:A"/><br /><sub><b>E:V:A</b></sub>](http://tinyurl.com/nwmj4as)<br /> | [<img src="https://avatars0.githubusercontent.com/u/1425500?v=4" width="48px;" alt="Gabriel"/><br /><sub><b>Gabriel</b></sub>](https://github.com/GaboFDC)<br /> | [<img src="https://avatars2.githubusercontent.com/u/10111411?v=4" width="48px;" alt="Andrew Scibek"/><br /><sub><b>Andrew Scibek</b></sub>](https://github.com/AndrewScibek)<br /> | [<img src="https://avatars0.githubusercontent.com/u/29709822?v=4" width="48px;" alt="FriedCosey"/><br /><sub><b>FriedCosey</b></sub>](https://github.com/FriedCosey)<br /> | [<img src="https://avatars1.githubusercontent.com/u/3891?v=4" width="48px;" alt="Michele Gerarduzzi"/><br /><sub><b>Michele Gerarduzzi</b></sub>](https://michelegera.dev/)<br /> |
-| [<img src="https://avatars3.githubusercontent.com/u/13438569?v=4" width="48px;" alt="Jack Morris"/><br /><sub><b>Jack Morris</b></sub>](https://github.com/rudolphjacksonm)<br /> | [<img src="https://avatars0.githubusercontent.com/u/14993807?v=4" width="48px;" alt="foorb"/><br /><sub><b>foorb</b></sub>](https://github.com/foorb)<br /> | [<img src="https://avatars0.githubusercontent.com/u/5819098?v=4" width="48px;" alt="Levi Baber"/><br /><sub><b>Levi Baber</b></sub>](http://researchit.las.iastate.edu)<br /> | [<img src="https://avatars0.githubusercontent.com/u/38514?v=4" width="48px;" alt="Graham Anderson"/><br /><sub><b>Graham Anderson</b></sub>](https://github.com/gnanderson)<br /> | [<img src="https://avatars2.githubusercontent.com/u/1936828?v=4" width="48px;" alt="Romain Bossart"/><br /><sub><b>Romain Bossart</b></sub>](https://github.com/bosr)<br /> | [<img src="https://avatars0.githubusercontent.com/u/969838?v=4" width="48px;" alt="Kirill Motkov"/><br /><sub><b>Kirill Motkov</b></sub>](http://eonix.ru)<br /> | [<img src="https://avatars1.githubusercontent.com/u/3665694?v=4" width="48px;" alt="Brian Choromanski"/><br /><sub><b>Brian Choromanski</b></sub>](http://www.BrianChoromanski.com)<br /> |
-| [<img src="https://avatars0.githubusercontent.com/u/1302304?v=4" width="48px;" alt="Sean DuBois"/><br /><sub><b>Sean DuBois</b></sub>](http://siobud.com)<br /> | [<img src="https://avatars1.githubusercontent.com/u/47195730?v=4" width="48px;" alt="Gary Kim"/><br /><sub><b>Gary Kim</b></sub>](https://github.com/gary-kim)<br /> | [<img src="https://avatars1.githubusercontent.com/u/6660171?v=4" width="48px;" alt="Dylan"/><br /><sub><b>Dylan</b></sub>](https://dylanbartels.com)<br /> | [<img src="https://avatars0.githubusercontent.com/u/1990354?v=4" width="48px;" alt="Dmytro Prokhorenkov"/><br /><sub><b>Dmytro Prokhorenkov</b></sub>](http://liet.me)<br /> | [<img src="https://avatars1.githubusercontent.com/u/590442?v=4" width="48px;" alt="Elliot"/><br /><sub><b>Elliot</b></sub>](https://github.com/elliotrushton)<br /> | [<img src="https://avatars3.githubusercontent.com/u/1580956?v=4" width="48px;" alt="chenrui"/><br /><sub><b>chenrui</b></sub>](http://chenrui.dev)<br /> | [<img src="https://avatars0.githubusercontent.com/u/7624765?v=4" width="48px;" alt="Andrew Suderman"/><br /><sub><b>Andrew Suderman</b></sub>](https://github.com/sudermanjr)<br /> |
-| [<img src="https://avatars3.githubusercontent.com/u/2373856?v=4" width="48px;" alt="Bob 'Wombat' Hogg"/><br /><sub><b>Bob 'Wombat' Hogg</b></sub>](https://github.com/rwhogg)<br /> |
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tr>
+    <td align="center"><a href="https://twitter.com/senorprogrammer"><img src="https://avatars0.githubusercontent.com/u/6413?v=4" width="48px;" alt=""/><br /><sub><b>Chris Cummer</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/anandsudhir"><img src="https://avatars2.githubusercontent.com/u/3252403?v=4" width="48px;" alt=""/><br /><sub><b>Anand Sudhir Prayaga</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/jeangovil"><img src="https://avatars1.githubusercontent.com/u/34973359?v=4" width="48px;" alt=""/><br /><sub><b>Hossein Mehrabi</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/Fengyalv"><img src="https://avatars0.githubusercontent.com/u/11779018?v=4" width="48px;" alt=""/><br /><sub><b>FengYa</b></sub></a><br /></td>
+    <td align="center"><a href="https://fluxionnetwork.github.io/fluxion/"><img src="https://avatars2.githubusercontent.com/u/17337753?v=4" width="48px;" alt=""/><br /><sub><b>deltax</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/BillKeenan"><img src="https://avatars0.githubusercontent.com/u/1319630?v=4" width="48px;" alt=""/><br /><sub><b>Bill Keenan</b></sub></a><br /></td>
+    <td align="center"><a href="http://blog.sapara.com"><img src="https://avatars2.githubusercontent.com/u/118081?v=4" width="48px;" alt=""/><br /><sub><b>June S</b></sub></a><br /></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/XanthusL"><img src="https://avatars3.githubusercontent.com/u/16461061?v=4" width="48px;" alt=""/><br /><sub><b>liyiheng</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/baustinanki"><img src="https://avatars2.githubusercontent.com/u/9014288?v=4" width="48px;" alt=""/><br /><sub><b>baustinanki</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/lixin9311"><img src="https://avatars0.githubusercontent.com/u/371475?v=4" width="48px;" alt=""/><br /><sub><b>lucus lee</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/mxplusb"><img src="https://avatars1.githubusercontent.com/u/7537841?v=4" width="48px;" alt=""/><br /><sub><b>Mike Lloyd</b></sub></a><br /></td>
+    <td align="center"><a href="http://rubiojr.rbel.co"><img src="https://avatars3.githubusercontent.com/u/10998?v=4" width="48px;" alt=""/><br /><sub><b>Sergio Rubio</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/FarhadF"><img src="https://avatars3.githubusercontent.com/u/17374492?v=4" width="48px;" alt=""/><br /><sub><b>Farhad Farahi</b></sub></a><br /></td>
+    <td align="center"><a href="http://lasantha.blogspot.com/"><img src="https://avatars1.githubusercontent.com/u/634604?v=4" width="48px;" alt=""/><br /><sub><b>Lasantha Kularatne</b></sub></a><br /></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/dlom"><img src="https://avatars1.githubusercontent.com/u/823331?v=4" width="48px;" alt=""/><br /><sub><b>Mark Old</b></sub></a><br /></td>
+    <td align="center"><a href="http://flw.tools/"><img src="https://avatars0.githubusercontent.com/u/5546718?v=4" width="48px;" alt=""/><br /><sub><b>flw</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/davebarda"><img src="https://avatars0.githubusercontent.com/u/6024927?v=4" width="48px;" alt=""/><br /><sub><b>David Barda</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/matrinox"><img src="https://avatars2.githubusercontent.com/u/4261980?v=4" width="48px;" alt=""/><br /><sub><b>Geoff Lee</b></sub></a><br /></td>
+    <td align="center"><a href="http://international.github.io"><img src="https://avatars3.githubusercontent.com/u/1022918?v=4" width="48px;" alt=""/><br /><sub><b>George Opritescu</b></sub></a><br /></td>
+    <td align="center"><a href="https://twitter.com/Grazfather"><img src="https://avatars3.githubusercontent.com/u/497310?v=4" width="48px;" alt=""/><br /><sub><b>Grazfather</b></sub></a><br /></td>
+    <td align="center"><a href="http://www.mikecordell.com/"><img src="https://avatars2.githubusercontent.com/u/1691120?v=4" width="48px;" alt=""/><br /><sub><b>Michael Cordell</b></sub></a><br /></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="http://patrick.ibexcps.com"><img src="https://avatars2.githubusercontent.com/u/1215497?v=4" width="48px;" alt=""/><br /><sub><b>Patrick José Pereira</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/sherodtaylor"><img src="https://avatars2.githubusercontent.com/u/1483092?v=4" width="48px;" alt=""/><br /><sub><b>sherod taylor</b></sub></a><br /></td>
+    <td align="center"><a href="http://cogentia.io"><img src="https://avatars2.githubusercontent.com/u/3062663?v=4" width="48px;" alt=""/><br /><sub><b>Andrew Scott</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/lsipii"><img src="https://avatars1.githubusercontent.com/u/12018440?v=4" width="48px;" alt=""/><br /><sub><b>Lassi Piironen</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/BlackWebWolf"><img src="https://avatars0.githubusercontent.com/u/14799210?v=4" width="48px;" alt=""/><br /><sub><b>BlackWebWolf</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/andrewzolotukhin"><img src="https://avatars0.githubusercontent.com/u/1894885?v=4" width="48px;" alt=""/><br /><sub><b>andrewzolotukhin</b></sub></a><br /></td>
+    <td align="center"><a href="https://retgits.github.io"><img src="https://avatars1.githubusercontent.com/u/8568280?v=4" width="48px;" alt=""/><br /><sub><b>Leon Stigter</b></sub></a><br /></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://tamimi.se"><img src="https://avatars3.githubusercontent.com/u/21756?v=4" width="48px;" alt=""/><br /><sub><b>Amr Tamimi</b></sub></a><br /></td>
+    <td align="center"><a href="https://jagdeep.me"><img src="https://avatars3.githubusercontent.com/u/3717137?v=4" width="48px;" alt=""/><br /><sub><b>Jagdeep Singh</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/darkSasori"><img src="https://avatars0.githubusercontent.com/u/889171?v=4" width="48px;" alt=""/><br /><sub><b>Lineu Felipe</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/kvj"><img src="https://avatars2.githubusercontent.com/u/159124?v=4" width="48px;" alt=""/><br /><sub><b>Konstantin</b></sub></a><br /></td>
+    <td align="center"><a href="http://www.brendanoleary.com"><img src="https://avatars2.githubusercontent.com/u/6044920?v=4" width="48px;" alt=""/><br /><sub><b>Brendan O'Leary</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/bertl4398"><img src="https://avatars2.githubusercontent.com/u/1226441?v=4" width="48px;" alt=""/><br /><sub><b>bertl4398</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/Ferenc-"><img src="https://avatars2.githubusercontent.com/u/6553695?v=4" width="48px;" alt=""/><br /><sub><b>Ferenc-</b></sub></a><br /></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="http://rohanverma.net"><img src="https://avatars1.githubusercontent.com/u/952036?v=4" width="48px;" alt=""/><br /><sub><b>Rohan Verma</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/fimtitzgerald"><img src="https://avatars1.githubusercontent.com/u/19293566?v=4" width="48px;" alt=""/><br /><sub><b>Tim Fitzgerald</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/ruggi"><img src="https://avatars2.githubusercontent.com/u/1081051?v=4" width="48px;" alt=""/><br /><sub><b>Federico Ruggi</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/ctwoodward"><img src="https://avatars2.githubusercontent.com/u/7293328?v=4" width="48px;" alt=""/><br /><sub><b>Craig Woodward</b></sub></a><br /></td>
+    <td align="center"><a href="https://twitter.com/ReadmeCritic"><img src="https://avatars3.githubusercontent.com/u/15367484?v=4" width="48px;" alt=""/><br /><sub><b>ReadmeCritic</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/jdevelop"><img src="https://avatars0.githubusercontent.com/u/141402?v=4" width="48px;" alt=""/><br /><sub><b>Eugene</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/Trinergy"><img src="https://avatars1.githubusercontent.com/u/12983705?s=460&v=4" width="48px;" alt=""/><br /><sub><b>Kenny Wu</b></sub></a><br /></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="http://www.romeroruiz.com"><img src="https://avatars0.githubusercontent.com/u/538234?v=4" width="48px;" alt=""/><br /><sub><b>Renán Romero</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/sticreations"><img src="https://avatars1.githubusercontent.com/u/5031240?v=4" width="48px;" alt=""/><br /><sub><b>Bastian Groß</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/nicholas-eden"><img src="https://avatars1.githubusercontent.com/u/2496835?v=4" width="48px;" alt=""/><br /><sub><b>nicholas-eden</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/danrabinowitz"><img src="https://avatars1.githubusercontent.com/u/279390?v=4" width="48px;" alt=""/><br /><sub><b>Dan Rabinowitz</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/dvdmssmnn"><img src="https://avatars1.githubusercontent.com/u/6897575?v=4" width="48px;" alt=""/><br /><sub><b>David Missmann</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/mweb"><img src="https://avatars2.githubusercontent.com/u/882006?v=4" width="48px;" alt=""/><br /><sub><b>Mathias Weber</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/TheRedSpy15"><img src="https://avatars1.githubusercontent.com/u/32081703?v=4" width="48px;" alt=""/><br /><sub><b>TheRedSpy15</b></sub></a><br /></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://www.linkedin.com/in/harald-nordgren-44778192"><img src="https://avatars0.githubusercontent.com/u/9569897?v=4" width="48px;" alt=""/><br /><sub><b>Harald Nordgren</b></sub></a><br /></td>
+    <td align="center"><a href="http://stormfirefox1.github.io"><img src="https://avatars0.githubusercontent.com/u/11583824?v=4" width="48px;" alt=""/><br /><sub><b>Matei Alexandru Gardus</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/Seanstoppable"><img src="https://avatars2.githubusercontent.com/u/1523955?v=4" width="48px;" alt=""/><br /><sub><b>Sean Smith</b></sub></a><br /></td>
+    <td align="center"><a href="http://kaskavalci.com"><img src="https://avatars1.githubusercontent.com/u/1646238?v=4" width="48px;" alt=""/><br /><sub><b>Halil Kaskavalci</b></sub></a><br /></td>
+    <td align="center"><a href="http://www.johandenoyer.fr"><img src="https://avatars2.githubusercontent.com/u/246715?v=4" width="48px;" alt=""/><br /><sub><b>Johan Denoyer</b></sub></a><br /></td>
+    <td align="center"><a href="https://skymeyer.be"><img src="https://avatars1.githubusercontent.com/u/593516?v=4" width="48px;" alt=""/><br /><sub><b>Jelle Vink</b></sub></a><br /></td>
+    <td align="center"><a href="http://imdevinc.com"><img src="https://avatars1.githubusercontent.com/u/3997333?v=4" width="48px;" alt=""/><br /><sub><b>Devin Collins</b></sub></a><br /></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="http://danne.stayskal.com/"><img src="https://avatars3.githubusercontent.com/u/18333?v=4" width="48px;" alt=""/><br /><sub><b>Danne Stayskal</b></sub></a><br /></td>
+    <td align="center"><a href="https://www.maxbeizer.com"><img src="https://avatars1.githubusercontent.com/u/2006658?v=4" width="48px;" alt=""/><br /><sub><b>Max Beizer</b></sub></a><br /></td>
+    <td align="center"><a href="http://tinyurl.com/nwmj4as"><img src="https://avatars1.githubusercontent.com/u/194392?v=4" width="48px;" alt=""/><br /><sub><b>E:V:A</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/GaboFDC"><img src="https://avatars0.githubusercontent.com/u/1425500?v=4" width="48px;" alt=""/><br /><sub><b>Gabriel</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/AndrewScibek"><img src="https://avatars2.githubusercontent.com/u/10111411?v=4" width="48px;" alt=""/><br /><sub><b>Andrew Scibek</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/FriedCosey"><img src="https://avatars0.githubusercontent.com/u/29709822?v=4" width="48px;" alt=""/><br /><sub><b>FriedCosey</b></sub></a><br /></td>
+    <td align="center"><a href="https://michelegera.dev/"><img src="https://avatars1.githubusercontent.com/u/3891?v=4" width="48px;" alt=""/><br /><sub><b>Michele Gerarduzzi</b></sub></a><br /></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/rudolphjacksonm"><img src="https://avatars3.githubusercontent.com/u/13438569?v=4" width="48px;" alt=""/><br /><sub><b>Jack Morris</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/foorb"><img src="https://avatars0.githubusercontent.com/u/14993807?v=4" width="48px;" alt=""/><br /><sub><b>foorb</b></sub></a><br /></td>
+    <td align="center"><a href="http://researchit.las.iastate.edu"><img src="https://avatars0.githubusercontent.com/u/5819098?v=4" width="48px;" alt=""/><br /><sub><b>Levi Baber</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/gnanderson"><img src="https://avatars0.githubusercontent.com/u/38514?v=4" width="48px;" alt=""/><br /><sub><b>Graham Anderson</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/bosr"><img src="https://avatars2.githubusercontent.com/u/1936828?v=4" width="48px;" alt=""/><br /><sub><b>Romain Bossart</b></sub></a><br /></td>
+    <td align="center"><a href="http://eonix.ru"><img src="https://avatars0.githubusercontent.com/u/969838?v=4" width="48px;" alt=""/><br /><sub><b>Kirill Motkov</b></sub></a><br /></td>
+    <td align="center"><a href="http://www.BrianChoromanski.com"><img src="https://avatars1.githubusercontent.com/u/3665694?v=4" width="48px;" alt=""/><br /><sub><b>Brian Choromanski</b></sub></a><br /></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="http://siobud.com"><img src="https://avatars0.githubusercontent.com/u/1302304?v=4" width="48px;" alt=""/><br /><sub><b>Sean DuBois</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/gary-kim"><img src="https://avatars1.githubusercontent.com/u/47195730?v=4" width="48px;" alt=""/><br /><sub><b>Gary Kim</b></sub></a><br /></td>
+    <td align="center"><a href="https://dylanbartels.com"><img src="https://avatars1.githubusercontent.com/u/6660171?v=4" width="48px;" alt=""/><br /><sub><b>Dylan</b></sub></a><br /></td>
+    <td align="center"><a href="http://liet.me"><img src="https://avatars0.githubusercontent.com/u/1990354?v=4" width="48px;" alt=""/><br /><sub><b>Dmytro Prokhorenkov</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/elliotrushton"><img src="https://avatars1.githubusercontent.com/u/590442?v=4" width="48px;" alt=""/><br /><sub><b>Elliot</b></sub></a><br /></td>
+    <td align="center"><a href="http://chenrui.dev"><img src="https://avatars3.githubusercontent.com/u/1580956?v=4" width="48px;" alt=""/><br /><sub><b>chenrui</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/sudermanjr"><img src="https://avatars0.githubusercontent.com/u/7624765?v=4" width="48px;" alt=""/><br /><sub><b>Andrew Suderman</b></sub></a><br /></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/rwhogg"><img src="https://avatars3.githubusercontent.com/u/2373856?v=4" width="48px;" alt=""/><br /><sub><b>Bob 'Wombat' Hogg</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/hxw"><img src="https://avatars0.githubusercontent.com/u/143462?v=4" width="48px;" alt=""/><br /><sub><b>Christopher Hall</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/hneiva"><img src="https://avatars1.githubusercontent.com/u/3451557?v=4" width="48px;" alt=""/><br /><sub><b>Heitor Neiva</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/herbygillot"><img src="https://avatars3.githubusercontent.com/u/618376?v=4" width="48px;" alt=""/><br /><sub><b>Herby Gillot</b></sub></a><br /></td>
+    <td align="center"><a href="http://brudil.com"><img src="https://avatars3.githubusercontent.com/u/382352?v=4" width="48px;" alt=""/><br /><sub><b>James Canning</b></sub></a><br /></td>
+    <td align="center"><a href="https://twitter.com/jeffz4000"><img src="https://avatars1.githubusercontent.com/u/45892?v=4" width="48px;" alt=""/><br /><sub><b>jeffz</b></sub></a><br /></td>
+    <td align="center"><a href="https://mikkeljuhl.com"><img src="https://avatars0.githubusercontent.com/u/1764035?v=4" width="48px;" alt=""/><br /><sub><b>Mikkel Jeppesen Juhl</b></sub></a><br /></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/lesteenman"><img src="https://avatars1.githubusercontent.com/u/963290?v=4" width="48px;" alt=""/><br /><sub><b>Erik</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/nyourchuck"><img src="https://avatars1.githubusercontent.com/u/155574?v=4" width="48px;" alt=""/><br /><sub><b>Nate Yourchuck</b></sub></a><br /></td>
+    <td align="center"><a href="https://cprimozic.net/"><img src="https://avatars3.githubusercontent.com/u/4335849?v=4" width="48px;" alt=""/><br /><sub><b>Casey Primozic</b></sub></a><br /></td>
+    <td align="center"><a href="http://pierdelacabeza.com/maruja"><img src="https://avatars3.githubusercontent.com/u/2430915?v=4" width="48px;" alt=""/><br /><sub><b>Alvaro [Andor]</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/Midnight-Conqueror"><img src="https://avatars1.githubusercontent.com/u/17101621?v=4" width="48px;" alt=""/><br /><sub><b>Joel Valentine</b></sub></a><br /></td>
+    <td align="center"><a href="https://www.viktor-braun.de"><img src="https://avatars0.githubusercontent.com/u/4738210?v=4" width="48px;" alt=""/><br /><sub><b>Viktor Braun</b></sub></a><br /></td>
+    <td align="center"><a href="https://www.chrisdbrown.co.uk/"><img src="https://avatars3.githubusercontent.com/u/3877652?v=4" width="48px;" alt=""/><br /><sub><b>ChrisDBrown</b></sub></a><br /></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://narengowda.github.io/"><img src="https://avatars2.githubusercontent.com/u/582821?v=4" width="48px;" alt=""/><br /><sub><b>Narendra L</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/ibaum"><img src="https://avatars1.githubusercontent.com/u/24609103?v=4" width="48px;" alt=""/><br /><sub><b>ibaum</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/noxer"><img src="https://avatars3.githubusercontent.com/u/566185?v=4" width="48px;" alt=""/><br /><sub><b>Tim Scheuermann</b></sub></a><br /></td>
+    <td align="center"><a href="https://indradhanush.github.io/"><img src="https://avatars0.githubusercontent.com/u/2682729?v=4" width="48px;" alt=""/><br /><sub><b>Indradhanush Gupta</b></sub></a><br /></td>
+    <td align="center"><a href="https://victoravelar.com"><img src="https://avatars3.githubusercontent.com/u/7926849?v=4" width="48px;" alt=""/><br /><sub><b>Victor Hugo Avelar Ossorio</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/scw007"><img src="https://avatars3.githubusercontent.com/u/4001640?v=4" width="48px;" alt=""/><br /><sub><b>Steven Whitehead</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/lawrencecraft"><img src="https://avatars0.githubusercontent.com/u/660580?v=4" width="48px;" alt=""/><br /><sub><b>Lawrence Craft</b></sub></a><br /></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="http://avi.press"><img src="https://avatars1.githubusercontent.com/u/1388071?v=4" width="48px;" alt=""/><br /><sub><b>Avi Press</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/Tardog"><img src="https://avatars0.githubusercontent.com/u/22562624?v=4" width="48px;" alt=""/><br /><sub><b>Sarah Kraßnigg</b></sub></a><br /></td>
+    <td align="center"><a href="http://jmks.ca"><img src="https://avatars1.githubusercontent.com/u/4923990?v=4" width="48px;" alt=""/><br /><sub><b>Jason Schweier</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/massa1240"><img src="https://avatars2.githubusercontent.com/u/8268483?v=4" width="48px;" alt=""/><br /><sub><b>Massa</b></sub></a><br /></td>
+    <td align="center"><a href="http://boot-error.github.io"><img src="https://avatars3.githubusercontent.com/u/8546140?v=4" width="48px;" alt=""/><br /><sub><b>Vighnesh SK</b></sub></a><br /></td>
+    <td align="center"><a href="http://alexfornuto.com"><img src="https://avatars3.githubusercontent.com/u/2349184?v=4" width="48px;" alt=""/><br /><sub><b>Alex Fornuto</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/stevenwhitehead"><img src="https://avatars0.githubusercontent.com/u/30630257?v=4" width="48px;" alt=""/><br /><sub><b>stevenwhitehead</b></sub></a><br /></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/jdenoy-saagie"><img src="https://avatars2.githubusercontent.com/u/55875303?v=4" width="48px;" alt=""/><br /><sub><b>Johan Denoyer</b></sub></a><br /></td>
+    <td align="center"><a href="https://albertsalim.dev"><img src="https://avatars1.githubusercontent.com/u/4749355?v=4" width="48px;" alt=""/><br /><sub><b>Albert Salim</b></sub></a><br /></td>
+    <td align="center"><a href="https://Feliciano.Tech"><img src="https://avatars1.githubusercontent.com/u/6017470?v=4" width="48px;" alt=""/><br /><sub><b>Ricardo N Feliciano</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/3mard"><img src="https://avatars3.githubusercontent.com/u/42009880?v=4" width="48px;" alt=""/><br /><sub><b>Omer Davutoglu</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/hemu"><img src="https://avatars0.githubusercontent.com/u/1871299?v=4" width="48px;" alt=""/><br /><sub><b>Hemu</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/Daanikus"><img src="https://avatars0.githubusercontent.com/u/18027087?v=4" width="48px;" alt=""/><br /><sub><b>Dan Bent</b></sub></a><br /></td>
+    <td align="center"><a href="https://cizer.dev"><img src="https://avatars3.githubusercontent.com/u/20225764?v=4" width="48px;" alt=""/><br /><sub><b>C123R</b></sub></a><br /></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/madepolli"><img src="https://avatars1.githubusercontent.com/u/7237000?v=4" width="48px;" alt=""/><br /><sub><b>Matjaž Depolli</b></sub></a><br /></td>
+    <td align="center"><a href="https://blog.schoentoon.blue"><img src="https://avatars1.githubusercontent.com/u/417618?v=4" width="48px;" alt=""/><br /><sub><b>Toon Schoenmakers</b></sub></a><br /></td>
+    <td align="center"><a href="http://tdhttt.com"><img src="https://avatars2.githubusercontent.com/u/24703459?v=4" width="48px;" alt=""/><br /><sub><b>TDHTTTT</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/jottr"><img src="https://avatars0.githubusercontent.com/u/2744198?v=4" width="48px;" alt=""/><br /><sub><b>jottr</b></sub></a><br /></td>
+    <td align="center"><a href="https://www.linkedin.com/in/nikolay-mateev-79187b167/"><img src="https://avatars3.githubusercontent.com/u/15074116?v=4" width="48px;" alt=""/><br /><sub><b>Nikolay Mateev</b></sub></a><br /></td>
+    <td align="center"><a href="https://charliewang.io"><img src="https://avatars1.githubusercontent.com/u/1320418?v=4" width="48px;" alt=""/><br /><sub><b>Charlie Wang</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/liyiheng"><img src="https://avatars3.githubusercontent.com/u/16461061?v=4" width="48px;" alt=""/><br /><sub><b>liyiheng</b></sub></a><br /></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://bjoern.svbtle.com"><img src="https://avatars1.githubusercontent.com/u/1467156?v=4" width="48px;" alt=""/><br /><sub><b>Bjoern Weidlich</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/firecat53"><img src="https://avatars1.githubusercontent.com/u/568113?v=4" width="48px;" alt=""/><br /><sub><b>Scott Hansen</b></sub></a><br /></td>
+    <td align="center"><a href="https://davidsbond.github.io"><img src="https://avatars3.githubusercontent.com/u/6227720?v=4" width="48px;" alt=""/><br /><sub><b>David Bond</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/yesnault"><img src="https://avatars3.githubusercontent.com/u/395454?v=4" width="48px;" alt=""/><br /><sub><b>Yvonnick Esnault</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/leterio"><img src="https://avatars0.githubusercontent.com/u/15060358?v=4" width="48px;" alt=""/><br /><sub><b>Vinícius Letério</b></sub></a><br /></td>
+    <td align="center"><a href="https://adriano.fyi"><img src="https://avatars3.githubusercontent.com/u/3331648?v=4" width="48px;" alt=""/><br /><sub><b>Adriano</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/jonhadfield"><img src="https://avatars1.githubusercontent.com/u/843944?v=4" width="48px;" alt=""/><br /><sub><b>Jon Hadfield</b></sub></a><br /></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/Tdnshah"><img src="https://avatars2.githubusercontent.com/u/13272752?v=4" width="48px;" alt=""/><br /><sub><b>Tejas Shah</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/mogensen"><img src="https://avatars2.githubusercontent.com/u/592710?v=4" width="48px;" alt=""/><br /><sub><b>Frederik Mogensen</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/rsaarelm"><img src="https://avatars1.githubusercontent.com/u/41840?v=4" width="48px;" alt=""/><br /><sub><b>Risto Saarelma</b></sub></a><br /></td>
+    <td align="center"><a href="https://sam-github.github.io/"><img src="https://avatars2.githubusercontent.com/u/17607?v=4" width="48px;" alt=""/><br /><sub><b>Sam Roberts</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/gerchardon"><img src="https://avatars0.githubusercontent.com/u/5973160?v=4" width="48px;" alt=""/><br /><sub><b>gerchardon</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/mryanmurphy"><img src="https://avatars2.githubusercontent.com/u/641427?v=4" width="48px;" alt=""/><br /><sub><b>Matt</b></sub></a><br /></td>
+    <td align="center"><a href="http://devco.net/"><img src="https://avatars0.githubusercontent.com/u/82342?v=4" width="48px;" alt=""/><br /><sub><b>R.I.Pienaar</b></sub></a><br /></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/fmotrifork"><img src="https://avatars3.githubusercontent.com/u/18327738?v=4" width="48px;" alt=""/><br /><sub><b>Frederik Mogensen</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/aeter"><img src="https://avatars0.githubusercontent.com/u/238607?v=4" width="48px;" alt=""/><br /><sub><b>aeter</b></sub></a><br /></td>
+    <td align="center"><a href="http://timhwang21.gitbook.io"><img src="https://avatars3.githubusercontent.com/u/5831434?v=4" width="48px;" alt=""/><br /><sub><b>Tim Hwang</b></sub></a><br /></td>
+    <td align="center"><a href="http://about.me/yingfan"><img src="https://avatars1.githubusercontent.com/u/10404961?v=4" width="48px;" alt=""/><br /><sub><b>Ying Fan Chong</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/MartinJohns"><img src="https://avatars1.githubusercontent.com/u/5269069?v=4" width="48px;" alt=""/><br /><sub><b>Martin Johns</b></sub></a><br /></td>
+    <td align="center"><a href="https://www.jvt.me"><img src="https://avatars0.githubusercontent.com/u/3315059?v=4" width="48px;" alt=""/><br /><sub><b>Jamie Tanna</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/trimble"><img src="https://avatars3.githubusercontent.com/u/371317?v=4" width="48px;" alt=""/><br /><sub><b>Todd Trimble</b></sub></a><br /></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://www.mitchellhanberg.com"><img src="https://avatars2.githubusercontent.com/u/5523984?v=4" width="48px;" alt=""/><br /><sub><b>Mitchell Hanberg</b></sub></a><br /></td>
+    <td align="center"><a href="https://franga2000.com"><img src="https://avatars3.githubusercontent.com/u/3891092?v=4" width="48px;" alt=""/><br /><sub><b>Miha Frangež</b></sub></a><br /></td>
+    <td align="center"><a href="https://blog.sahilister.in/"><img src="https://avatars0.githubusercontent.com/u/52946452?v=4" width="48px;" alt=""/><br /><sub><b>Sahil Dhiman</b></sub></a><br /></td>
+    <td align="center"><a href="https://pzoo.netlify.app/"><img src="https://avatars2.githubusercontent.com/u/17727004?v=4" width="48px;" alt=""/><br /><sub><b>Pingzhou &#124; 平舟</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/YuviGold"><img src="https://avatars0.githubusercontent.com/u/29873449?v=4" width="48px;" alt=""/><br /><sub><b>Yuval Goldberg</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/dabcoder"><img src="https://avatars3.githubusercontent.com/u/5034531?v=4" width="48px;" alt=""/><br /><sub><b>David Bouchare</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/stone"><img src="https://avatars3.githubusercontent.com/u/29077?v=4" width="48px;" alt=""/><br /><sub><b>Fredrik Steen</b></sub></a><br /></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/zye1996"><img src="https://avatars2.githubusercontent.com/u/28901953?v=4" width="48px;" alt=""/><br /><sub><b>zye1996</b></sub></a><br /></td>
+    <td align="center"><a href="https://github.com/pgaxatte"><img src="https://avatars.githubusercontent.com/u/30696904?v=4" width="48px;" alt=""/><br /><sub><b>Pierre Gaxatte</b></sub></a><br /></td>
+    <td align="center"><a href="https://xntrik.wtf"><img src="https://avatars.githubusercontent.com/u/678260?v=4" width="48px;" alt=""/><br /><sub><b>Christian Frichot</b></sub></a><br /></td>
+    <td align="center"><a href="https://lukas-kaemmerling.de"><img src="https://avatars.githubusercontent.com/u/4281581?v=4" width="48px;" alt=""/><br /><sub><b>Lukas Kämmerling</b></sub></a><br /></td>
+    <td align="center"><a href="https://inetant.net/"><img src="https://avatars.githubusercontent.com/u/1765366?v=4" width="48px;" alt=""/><br /><sub><b>Antoine Meillet</b></sub></a><br /></td>
+    <td align="center"><a href="https://www.patreon.com/cclauss"><img src="https://avatars.githubusercontent.com/u/3709715?v=4" width="48px;" alt=""/><br /><sub><b>Christian Clauss</b></sub></a><br /></td>
+  </tr>
+</table>
+
+<!-- markdownlint-enable -->
+<!-- prettier-ignore-end -->
 <!-- ALL-CONTRIBUTORS-LIST:END -->
 
 ## Acknowledgments
@@ -176,8 +437,7 @@ Dependency management in WTF is handled by [Go modules](https://github.com/golan
 The inspiration for `WTF` came from Monica Dinculescu's
 [tiny-care-terminal](https://github.com/notwaldorf/tiny-care-terminal).
 
-Many thanks to <a href="https://lendesk.com">Lendesk</a> for supporting this project by
-providing time to develop it.
+WTF is built atop [tcell](https://github.com/gdamore/tcell) and [tview](https://github.com/rivo/tview), fantastic projects both. WTF is built, packaged, and deployed via [GoReleaser](https://goreleaser.com).
 
 <p align="center">
 <img src="./images/dude_wtf.png?raw=true" title="Dude WTF" width="251" height="201" />

_sample_configs/bargraph_config.yml

@@ -18,5 +18,4 @@ wtf:
         left: 0
         height: 2
         width: 2
-      refreshInterval: 30
-      updateInterval: 15
+      refreshInterval: 30

_sample_configs/dynamic_sizing.yml

@@ -0,0 +1,21 @@
+wtf:
+  mods:
+    battery:
+      type: power
+      title: "⚡️"
+      enabled: true
+      position:
+        top: 0
+        left: 0
+        height: 1
+        width: 1
+      refreshInterval: 15
+    security_info:
+      type: security
+      enabled: true
+      position:
+        top: 0
+        left: 1
+        height: 1
+        width: 1
+      refreshInterval: 3600

_sample_configs/sample_config.yml

@@ -61,7 +61,7 @@ wtf:
         UTC: "Etc/UTC"
         Vancouver: "America/Vancouver"
         New_York: "America/New_York"
-        Sao_Paolo: "America/Sao_Paulo"
+        Sao_Paulo: "America/Sao_Paulo"
         Denver: "America/Denver"
         Iqaluit: "America/Iqaluit"
         Bahamas: "America/Nassau"
@@ -98,7 +98,7 @@ wtf:
         left: 0
         height: 2
         width: 1
-    refreshInterval: 3600
+      refreshInterval: 3600
     ip:
       type: ipinfo
       title: "My IP"
@@ -177,4 +177,4 @@ wtf:
         left: 1
         height: 1
         width: 3
-      refreshInterval: 3600
+      refreshInterval: 3600

_sample_configs/small_config.yml

@@ -0,0 +1,17 @@
+wtf:
+  grid:
+    columns: [20, 20]
+    rows: [3, 3]
+  refreshInterval: 1
+  mods:
+    uptime:
+      type: cmdrunner
+      args: [""]
+      cmd: "uptime"
+      enabled: true
+      position:
+        top: 0
+        left: 0
+        height: 1
+        width: 1
+      refreshInterval: 30

app/app_manager.go

@@ -0,0 +1,71 @@
+package app
+
+import (
+	"errors"
+
+	"github.com/olebedev/config"
+	"github.com/rivo/tview"
+)
+
+// WtfAppManager handles the instances of WtfApp, ensuring that they're displayed as requested
+type WtfAppManager struct {
+	WtfApps []*WtfApp
+
+	selected int
+}
+
+// NewAppManager creates and returns an instance of AppManager
+func NewAppManager() WtfAppManager {
+	appMan := WtfAppManager{
+		WtfApps: []*WtfApp{},
+	}
+
+	return appMan
+}
+
+// MakeNewWtfApp creates and starts a new instance of WtfApp from a set of configuration params
+func (appMan *WtfAppManager) MakeNewWtfApp(config *config.Config, configFilePath string) {
+	wtfApp := NewWtfApp(tview.NewApplication(), config, configFilePath)
+	appMan.Add(wtfApp)
+
+	wtfApp.Start()
+}
+
+// Add adds a WtfApp to the collection of apps that the AppManager manages.
+// This app is then available for display onscreen.
+func (appMan *WtfAppManager) Add(wtfApp *WtfApp) {
+	appMan.WtfApps = append(appMan.WtfApps, wtfApp)
+}
+
+// Current returns the currently-displaying instance of WtfApp
+func (appMan *WtfAppManager) Current() (*WtfApp, error) {
+	if appMan.selected < 0 || appMan.selected >= len(appMan.WtfApps) {
+		return nil, errors.New("invalid app index selected")
+	}
+
+	return appMan.WtfApps[appMan.selected], nil
+}
+
+// Next cycles the WtfApps forward by one, making the next one in the list
+// the current one. If there are none after the current one, it wraps around.
+func (appMan *WtfAppManager) Next() (*WtfApp, error) {
+	appMan.selected++
+
+	if appMan.selected >= len(appMan.WtfApps) {
+		appMan.selected = 0
+	}
+
+	return appMan.Current()
+}
+
+// Prev cycles the WtfApps backwards by one, making the previous one in the
+// list the current one. If there are none before the current one, it wraps around.
+func (appMan *WtfAppManager) Prev() (*WtfApp, error) {
+	appMan.selected--
+
+	if appMan.selected < 0 {
+		appMan.selected = len(appMan.WtfApps) - 1
+	}
+
+	return appMan.Current()
+}

app/display.go

@@ -20,8 +20,14 @@ func NewDisplay(widgets []wtf.Wtfable, config *config.Config) *Display {
 		config: config,
 	}
 
+	firstWidget := widgets[0]
+	display.Grid.SetBackgroundColor(
+		wtf.ColorFor(
+			firstWidget.CommonSettings().Colors.WidgetTheme.Background,
+		),
+	)
+
 	display.build(widgets)
-	display.Grid.SetBackgroundColor(wtf.ColorFor(config.UString("wtf.colors.background", "black")))
 
 	return &display
 }

app/error_messages.go

@@ -1,19 +0,0 @@
-package app
-
-// This file contains the error messages that get written to the terminal when
-// something goes wrong with the configuration process.
-//
-// As a general rule, if one of these has to be shown the app should then die
-// via os.Exit(1)
-
-import (
-	"fmt"
-
-	"github.com/logrusorgru/aurora"
-)
-
-/* -------------------- Unexported Functions -------------------- */
-
-func displayError(err error) {
-	fmt.Printf("%s %s\n\n", aurora.Red("Error:"), err.Error())
-}

app/exit_message.go

@@ -0,0 +1,104 @@
+package app
+
+import (
+	"fmt"
+	"os"
+	"strings"
+
+	"github.com/logrusorgru/aurora"
+	"github.com/olebedev/config"
+)
+
+const exitMessageHeader = `
+	      ____    __    ____ .___________. _______
+	      \   \  /  \  /   / |           ||   ____|
+	       \   \/    \/   /  ----|  |-----|  |__
+	        \            /       |  |     |   __|
+	         \    /\    /        |  |     |  |
+	          \__/  \__/         |__|     |__|
+
+    the personal information dashboard for your terminal
+`
+
+// DisplayExitMessage displays the onscreen exit message when the app quits
+func (wtfApp *WtfApp) DisplayExitMessage() {
+	exitMessageIsDisplayable := readDisplayableConfig(wtfApp.config)
+
+	wtfApp.displayExitMsg(exitMessageIsDisplayable)
+}
+
+/* -------------------- Unexported Functions -------------------- */
+
+func (wtfApp *WtfApp) displayExitMsg(exitMessageIsDisplayable bool) string {
+	// If a sponsor or contributor and opt out of seeing the exit message, do not display it
+	if (wtfApp.ghUser.IsContributor || wtfApp.ghUser.IsSponsor) && !exitMessageIsDisplayable {
+		return ""
+	}
+
+	msgs := []string{}
+
+	msgs = append(msgs, aurora.Magenta(exitMessageHeader).String())
+
+	if wtfApp.ghUser.IsContributor {
+		msgs = append(msgs, wtfApp.contributorThankYouMessage())
+	}
+
+	if wtfApp.ghUser.IsSponsor {
+		msgs = append(msgs, wtfApp.sponsorThankYouMessage())
+	}
+
+	if !wtfApp.ghUser.IsContributor && !wtfApp.ghUser.IsSponsor {
+		msgs = append(msgs, wtfApp.supportRequestMessage())
+	}
+
+	displayMsg := strings.Join(msgs, "\n")
+
+	fmt.Println(displayMsg)
+
+	return displayMsg
+}
+
+// readDisplayableConfig figures out whether or not the exit message should be displayed
+// per the user's wishes. It allows contributors and sponsors to opt out of the exit message
+func readDisplayableConfig(cfg *config.Config) bool {
+	displayExitMsg := cfg.UBool("wtf.exitMessage.display", true)
+	return displayExitMsg
+}
+
+// readGitHubAPIKey attempts to find a GitHub API key somewhere in the configuration file
+func readGitHubAPIKey(cfg *config.Config) string {
+	apiKey := cfg.UString("wtf.exitMessage.githubAPIKey", os.Getenv("WTF_GITHUB_TOKEN"))
+	if apiKey != "" {
+		return apiKey
+	}
+
+	moduleConfig, err := cfg.Get("wtf.mods.github")
+	if err != nil {
+		return ""
+	}
+
+	return moduleConfig.UString("apiKey", "")
+}
+
+/* -------------------- Messaging -------------------- */
+
+func (wtfApp *WtfApp) contributorThankYouMessage() string {
+	str := "    On behalf of all the users of WTF, thank you for contributing to the source code."
+	str += fmt.Sprintf(" %s", aurora.Green("\n\n    You rock."))
+
+	return str
+}
+
+func (wtfApp *WtfApp) sponsorThankYouMessage() string {
+	str := "    Your sponsorship of WTF makes a difference. Thank you for sponsoring and supporting WTF."
+	str += fmt.Sprintf(" %s", aurora.Green("\n\n    You're awesome."))
+
+	return str
+}
+
+func (wtfApp *WtfApp) supportRequestMessage() string {
+	str := "    The development and maintenance of WTF is supported by sponsorships.\n"
+	str += fmt.Sprintf("    Please consider sponsoring WTF at %s\n", aurora.Green("https://github.com/sponsors/senorprogrammer"))
+
+	return str
+}

app/exit_message_test.go

@@ -0,0 +1,71 @@
+package app
+
+import (
+	"strings"
+	"testing"
+
+	"github.com/wtfutil/wtf/support"
+	"gotest.tools/assert"
+)
+
+func Test_displayExitMessage(t *testing.T) {
+	tests := []struct {
+		name          string
+		isDisplayable bool
+		isContributor bool
+		isSponsor     bool
+		compareWith   string
+		expected      string
+	}{
+		{
+			name:          "when not displayable",
+			isDisplayable: false,
+			isContributor: true,
+			isSponsor:     true,
+			compareWith:   "equals",
+			expected:      "",
+		},
+		{
+			name:          "when contributor",
+			isDisplayable: true,
+			isContributor: true,
+			compareWith:   "contains",
+			expected:      "thank you for contributing",
+		},
+		{
+			name:          "when sponsor",
+			isDisplayable: true,
+			isSponsor:     true,
+			compareWith:   "contains",
+			expected:      "Thank you for sponsoring",
+		},
+		{
+			name:          "when user",
+			isDisplayable: true,
+			isContributor: false,
+			isSponsor:     false,
+			compareWith:   "contains",
+			expected:      "supported by sponsorships",
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			wtfApp := WtfApp{}
+			wtfApp.ghUser = &support.GitHubUser{
+				IsContributor: tt.isContributor,
+				IsSponsor:     tt.isSponsor,
+			}
+
+			actual := wtfApp.displayExitMsg(tt.isDisplayable)
+
+			if tt.compareWith == "equals" {
+				assert.Equal(t, actual, tt.expected)
+			}
+
+			if tt.compareWith == "contains" {
+				assert.Equal(t, true, strings.Contains(actual, tt.expected))
+			}
+		})
+	}
+}

app/focus_tracker.go

@@ -1,6 +1,7 @@
 package app
 
 import (
+	"fmt"
 	"sort"
 
 	"github.com/olebedev/config"
@@ -8,6 +9,7 @@ import (
 	"github.com/wtfutil/wtf/wtf"
 )
 
+// FocusState is a custom type that differentiates focusable scopes
 type FocusState int
 
 const (
@@ -19,17 +21,18 @@ const (
 // FocusTracker is used by the app to track which onscreen widget currently has focus,
 // and to move focus between widgets.
 type FocusTracker struct {
-	App       *tview.Application
 	Idx       int
 	IsFocused bool
 	Widgets   []wtf.Wtfable
 
-	config *config.Config
+	config   *config.Config
+	tviewApp *tview.Application
 }
 
-func NewFocusTracker(app *tview.Application, widgets []wtf.Wtfable, config *config.Config) FocusTracker {
+// NewFocusTracker creates and returns an instance of FocusTracker
+func NewFocusTracker(tviewApp *tview.Application, widgets []wtf.Wtfable, config *config.Config) FocusTracker {
 	focusTracker := FocusTracker{
-		App:       app,
+		tviewApp:  tviewApp,
 		Idx:       -1,
 		IsFocused: false,
 		Widgets:   widgets,
@@ -44,6 +47,7 @@ func NewFocusTracker(app *tview.Application, widgets []wtf.Wtfable, config *conf
 
 /* -------------------- Exported Functions -------------------- */
 
+// FocusOn puts the focus on the item that belongs to the focus character passed in
 func (tracker *FocusTracker) FocusOn(char string) bool {
 	if !tracker.useNavShortcuts() {
 		return false
@@ -107,6 +111,7 @@ func (tracker *FocusTracker) Prev() {
 	tracker.IsFocused = true
 }
 
+// Refocus forces the focus back to the currently-selected item
 func (tracker *FocusTracker) Refocus() {
 	tracker.focus(tracker.Idx)
 }
@@ -115,6 +120,7 @@ func (tracker *FocusTracker) Refocus() {
 
 // AssignHotKeys assigns an alphabetic keyboard character to each focusable
 // widget so that the widget can be brought into focus by pressing that keyboard key
+// Valid numbers are between 1 and 9, inclusive
 func (tracker *FocusTracker) assignHotKeys() {
 	if !tracker.useNavShortcuts() {
 		return
@@ -122,30 +128,37 @@ func (tracker *FocusTracker) assignHotKeys() {
 
 	usedKeys := make(map[string]bool)
 	focusables := tracker.focusables()
-	i := 1
 
+	// First, block out the explicitly-defined characters so they can't be automatically
+	// assigned to other modules
 	for _, focusable := range focusables {
 		if focusable.FocusChar() != "" {
 			usedKeys[focusable.FocusChar()] = true
 		}
 	}
+
+	focusNum := 1
+
+	// Range over all the modules and assign focus characters to any that are focusable
+	// and don't have explicitly-defined focus characters
 	for _, focusable := range focusables {
 		if focusable.FocusChar() != "" {
 			continue
 		}
-		if _, foundKey := usedKeys[string('0'+i)]; foundKey {
-			for ; foundKey; _, foundKey = usedKeys[string('0'+i)] {
-				i++
+
+		if _, foundKey := usedKeys[fmt.Sprint(focusNum)]; foundKey {
+			for ; foundKey; _, foundKey = usedKeys[fmt.Sprint(focusNum)] {
+				focusNum++
 			}
 		}
 
-		// Don't have nav characters > "9"
-		if i >= 10 {
+		// Don't allow focus characters > "9"
+		if focusNum >= 10 {
 			break
 		}
 
-		focusable.SetFocusChar(string('0' + i))
-		i++
+		focusable.SetFocusChar(fmt.Sprint(focusNum))
+		focusNum++
 	}
 }
 
@@ -158,7 +171,11 @@ func (tracker *FocusTracker) blur(idx int) {
 	view := widget.TextView()
 	view.Blur()
 
-	view.SetBorderColor(wtf.ColorFor(widget.BorderColor()))
+	view.SetBorderColor(
+		wtf.ColorFor(
+			widget.BorderColor(),
+		),
+	)
 
 	tracker.IsFocused = false
 }
@@ -178,8 +195,12 @@ func (tracker *FocusTracker) focus(idx int) {
 	}
 
 	view := widget.TextView()
-	view.SetBorderColor(wtf.ColorFor(tracker.config.UString("wtf.colors.border.focused", "gray")))
-	tracker.App.SetFocus(view)
+	view.SetBorderColor(
+		wtf.ColorFor(
+			widget.CommonSettings().Colors.BorderTheme.Focused,
+		),
+	)
+	tracker.tviewApp.SetFocus(view)
 }
 
 func (tracker *FocusTracker) focusables() []wtf.Wtfable {
@@ -192,7 +213,7 @@ func (tracker *FocusTracker) focusables() []wtf.Wtfable {
 	}
 
 	// Sort for deterministic ordering
-	sort.SliceStable(focusable[:], func(i, j int) bool {
+	sort.SliceStable(focusable, func(i, j int) bool {
 		iTop := focusable[i].CommonSettings().Top
 		jTop := focusable[j].CommonSettings().Top
 
@@ -222,7 +243,7 @@ func (tracker *FocusTracker) focusState() FocusState {
 	}
 
 	for _, widget := range tracker.Widgets {
-		if widget.TextView() == tracker.App.GetFocus() {
+		if widget.TextView() == tracker.tviewApp.GetFocus() {
 			return widgetFocused
 		}
 	}

app/module_validator.go

@@ -5,55 +5,77 @@ import (
 	"os"
 
 	"github.com/logrusorgru/aurora"
+	"github.com/wtfutil/wtf/cfg"
 	"github.com/wtfutil/wtf/wtf"
 )
 
+// ModuleValidator is responsible for validating the state of a module's configuration
 type ModuleValidator struct{}
 
+type widgetError struct {
+	name             string
+	validationErrors []cfg.Validatable
+}
+
+// NewModuleValidator creates and returns an instance of ModuleValidator
 func NewModuleValidator() *ModuleValidator {
-	val := &ModuleValidator{}
-	return val
+	return &ModuleValidator{}
 }
 
 // Validate rolls through all the enabled widgets and looks for configuration errors.
 // If it finds any it stringifies them, writes them to the console, and kills the app gracefully
 func (val *ModuleValidator) Validate(widgets []wtf.Wtfable) {
-	var errStr string
-	hasErrors := false
+	validationErrors := validate(widgets)
 
-	for _, widget := range widgets {
-		var widgetErrStr string
-
-		for _, val := range widget.CommonSettings().Validations() {
-			if val.HasError() {
-				hasErrors = true
-				widgetErrStr += fmt.Sprintf(" - %s\t%s %v\n", val, aurora.Red("Error:"), val.Error())
+	if len(validationErrors) > 0 {
+		fmt.Println()
+		for _, error := range validationErrors {
+			for _, message := range error.errorMessages() {
+				fmt.Println(message)
 			}
 		}
-
-		if widgetErrStr != "" {
-			errStr += fmt.Sprintf(
-				"%s\n",
-				fmt.Sprintf(
-					"%s in %s configuration",
-					aurora.Red("Errors"),
-					aurora.Yellow(
-						fmt.Sprintf(
-							"%s.position",
-							widget.Name(),
-						),
-					),
-				),
-			)
-
-			errStr += widgetErrStr + "\n"
-		}
-	}
-
-	if hasErrors {
 		fmt.Println()
-		fmt.Printf(errStr)
 
 		os.Exit(1)
 	}
 }
+
+func validate(widgets []wtf.Wtfable) (widgetErrors []widgetError) {
+	for _, widget := range widgets {
+		error := widgetError{name: widget.Name()}
+
+		for _, val := range widget.CommonSettings().Validations() {
+			if val.HasError() {
+				error.validationErrors = append(error.validationErrors, val)
+			}
+		}
+
+		if len(error.validationErrors) > 0 {
+			widgetErrors = append(widgetErrors, error)
+		}
+	}
+
+	return widgetErrors
+}
+
+func (err widgetError) errorMessages() (messages []string) {
+	widgetMessage := fmt.Sprintf(
+		"%s in %s configuration",
+		aurora.Red("Errors"),
+		aurora.Yellow(
+			fmt.Sprintf(
+				"%s.position",
+				err.name,
+			),
+		),
+	)
+	messages = append(messages, widgetMessage)
+
+	for _, e := range err.validationErrors {
+		configMessage := fmt.Sprintf(" - %s\t%s %v", e.String(), aurora.Red("Error:"), e.Error())
+
+		messages = append(messages, configMessage)
+	}
+
+	return messages
+}

app/module_validator_test.go

@@ -0,0 +1,102 @@
+package app
+
+import (
+	"fmt"
+	"testing"
+
+	"github.com/logrusorgru/aurora"
+	"github.com/olebedev/config"
+	"github.com/stretchr/testify/assert"
+	"github.com/wtfutil/wtf/wtf"
+)
+
+const (
+	valid = `
+wtf:
+  mods:
+    clocks:
+      enabled: true
+      position:
+        top: 0
+        left: 0
+        height: 1
+        width: 1
+      refreshInterval: 30`
+
+	invalid = `
+wtf:
+  mods:
+    clocks:
+      enabled: true
+      position:
+        top: abc
+        left: 0
+        height: 1
+        width: 1
+      refreshInterval: 30`
+)
+
+func Test_NewModuleValidator(t *testing.T) {
+	assert.IsType(t, &ModuleValidator{}, NewModuleValidator())
+}
+
+func Test_validate(t *testing.T) {
+	tests := []struct {
+		name       string
+		moduleName string
+		config     *config.Config
+		expected   []string
+	}{
+		{
+			name:       "valid config",
+			moduleName: "clocks",
+			config: func() *config.Config {
+				cfg, _ := config.ParseYaml(valid)
+				return cfg
+			}(),
+			expected: []string{},
+		},
+		{
+			name:       "invalid config",
+			moduleName: "clocks",
+			config: func() *config.Config {
+				cfg, _ := config.ParseYaml(invalid)
+				return cfg
+			}(),
+			expected: []string{
+				fmt.Sprintf("%s in %s configuration", aurora.Red("Errors"), aurora.Yellow("clocks.position")),
+				fmt.Sprintf(
+					" - Invalid value for %s:	0	%s strconv.ParseInt: parsing \"abc\": invalid syntax",
+					aurora.Yellow("top"),
+					aurora.Red("Error:"),
+				),
+			},
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			widget := MakeWidget(nil, nil, tt.moduleName, tt.config)
+
+			if widget == nil {
+				t.Logf("Failed to create widget %s", tt.moduleName)
+				t.FailNow()
+			}
+
+			errs := validate([]wtf.Wtfable{widget})
+
+			if len(tt.expected) == 0 {
+				assert.Empty(t, errs)
+			} else {
+				assert.NotEmpty(t, errs)
+
+				var actual []string
+				for _, err := range errs {
+					actual = append(actual, err.errorMessages()...)
+				}
+
+				assert.Equal(t, tt.expected, actual)
+			}
+		})
+	}
+}

app/scheduler.go

@@ -29,7 +29,7 @@ func Schedule(widget wtf.Wtfable) {
 				return
 			}
 		case quit := <-widget.QuitChan():
-			if quit == true {
+			if quit {
 				timer.Stop()
 				return
 			}

app/widget_maker.go

@@ -3,30 +3,47 @@ package app
 import (
 	"github.com/olebedev/config"
 	"github.com/rivo/tview"
+	"github.com/wtfutil/wtf/modules/asana"
+	"github.com/wtfutil/wtf/modules/azuredevops"
 	"github.com/wtfutil/wtf/modules/bamboohr"
 	"github.com/wtfutil/wtf/modules/bargraph"
+	"github.com/wtfutil/wtf/modules/buildkite"
+	cdsfavorites "github.com/wtfutil/wtf/modules/cds/favorites"
+	cdsqueue "github.com/wtfutil/wtf/modules/cds/queue"
+	cdsstatus "github.com/wtfutil/wtf/modules/cds/status"
 	"github.com/wtfutil/wtf/modules/circleci"
 	"github.com/wtfutil/wtf/modules/clocks"
 	"github.com/wtfutil/wtf/modules/cmdrunner"
+	"github.com/wtfutil/wtf/modules/covid"
 	"github.com/wtfutil/wtf/modules/cryptoexchanges/bittrex"
 	"github.com/wtfutil/wtf/modules/cryptoexchanges/blockfolio"
 	"github.com/wtfutil/wtf/modules/cryptoexchanges/cryptolive"
 	"github.com/wtfutil/wtf/modules/datadog"
+	"github.com/wtfutil/wtf/modules/devto"
+	"github.com/wtfutil/wtf/modules/digitalclock"
+	"github.com/wtfutil/wtf/modules/digitalocean"
+	"github.com/wtfutil/wtf/modules/docker"
+	"github.com/wtfutil/wtf/modules/exchangerates"
 	"github.com/wtfutil/wtf/modules/feedreader"
+	"github.com/wtfutil/wtf/modules/football"
 	"github.com/wtfutil/wtf/modules/gcal"
 	"github.com/wtfutil/wtf/modules/gerrit"
 	"github.com/wtfutil/wtf/modules/git"
 	"github.com/wtfutil/wtf/modules/github"
 	"github.com/wtfutil/wtf/modules/gitlab"
+	"github.com/wtfutil/wtf/modules/gitlabtodo"
 	"github.com/wtfutil/wtf/modules/gitter"
 	"github.com/wtfutil/wtf/modules/googleanalytics"
+	"github.com/wtfutil/wtf/modules/grafana"
 	"github.com/wtfutil/wtf/modules/gspreadsheets"
 	"github.com/wtfutil/wtf/modules/hackernews"
+	"github.com/wtfutil/wtf/modules/healthchecks"
 	"github.com/wtfutil/wtf/modules/hibp"
 	"github.com/wtfutil/wtf/modules/ipaddresses/ipapi"
 	"github.com/wtfutil/wtf/modules/ipaddresses/ipinfo"
 	"github.com/wtfutil/wtf/modules/jenkins"
 	"github.com/wtfutil/wtf/modules/jira"
+	"github.com/wtfutil/wtf/modules/krisinformation"
 	"github.com/wtfutil/wtf/modules/kubernetes"
 	"github.com/wtfutil/wtf/modules/logger"
 	"github.com/wtfutil/wtf/modules/mercurial"
@@ -34,22 +51,31 @@ import (
 	"github.com/wtfutil/wtf/modules/newrelic"
 	"github.com/wtfutil/wtf/modules/opsgenie"
 	"github.com/wtfutil/wtf/modules/pagerduty"
+	"github.com/wtfutil/wtf/modules/pihole"
+	"github.com/wtfutil/wtf/modules/pocket"
 	"github.com/wtfutil/wtf/modules/power"
 	"github.com/wtfutil/wtf/modules/resourceusage"
 	"github.com/wtfutil/wtf/modules/rollbar"
 	"github.com/wtfutil/wtf/modules/security"
+	"github.com/wtfutil/wtf/modules/spacex"
 	"github.com/wtfutil/wtf/modules/spotify"
 	"github.com/wtfutil/wtf/modules/spotifyweb"
 	"github.com/wtfutil/wtf/modules/status"
+	"github.com/wtfutil/wtf/modules/stocks/finnhub"
+	"github.com/wtfutil/wtf/modules/stocks/yfinance"
+	"github.com/wtfutil/wtf/modules/subreddit"
 	"github.com/wtfutil/wtf/modules/textfile"
 	"github.com/wtfutil/wtf/modules/todo"
-	"github.com/wtfutil/wtf/modules/todoist"
+	"github.com/wtfutil/wtf/modules/todo_plus"
 	"github.com/wtfutil/wtf/modules/transmission"
 	"github.com/wtfutil/wtf/modules/travisci"
-	"github.com/wtfutil/wtf/modules/trello"
+	"github.com/wtfutil/wtf/modules/twitch"
 	"github.com/wtfutil/wtf/modules/twitter"
+	"github.com/wtfutil/wtf/modules/twitterstats"
 	"github.com/wtfutil/wtf/modules/unknown"
+	"github.com/wtfutil/wtf/modules/uptimerobot"
 	"github.com/wtfutil/wtf/modules/victorops"
+	"github.com/wtfutil/wtf/modules/weatherservices/arpansagovau"
 	"github.com/wtfutil/wtf/modules/weatherservices/prettyweather"
 	"github.com/wtfutil/wtf/modules/weatherservices/weather"
 	"github.com/wtfutil/wtf/modules/zendesk"
@@ -58,7 +84,7 @@ import (
 
 // MakeWidget creates and returns instances of widgets
 func MakeWidget(
-	app *tview.Application,
+	tviewApp *tview.Application,
 	pages *tview.Pages,
 	moduleName string,
 	config *config.Config,
@@ -66,176 +92,266 @@ func MakeWidget(
 	var widget wtf.Wtfable
 
 	moduleConfig, _ := config.Get("wtf.mods." + moduleName)
+
+	// Don' try to initialize modules that don't exist
+	if moduleConfig == nil {
+		return nil
+	}
+
+	// Don't try to initialize modules that aren't enabled
 	if enabled := moduleConfig.UBool("enabled", false); !enabled {
-		// Don't initialize modules that aren't enabled
 		return nil
 	}
 
 	// Always in alphabetical order
 	switch moduleConfig.UString("type", moduleName) {
+	case "arpansagovau":
+		settings := arpansagovau.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = arpansagovau.NewWidget(tviewApp, settings)
+	case "asana":
+		settings := asana.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = asana.NewWidget(tviewApp, pages, settings)
+	case "azuredevops":
+		settings := azuredevops.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = azuredevops.NewWidget(tviewApp, pages, settings)
 	case "bamboohr":
 		settings := bamboohr.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = bamboohr.NewWidget(app, settings)
+		widget = bamboohr.NewWidget(tviewApp, settings)
 	case "bargraph":
 		settings := bargraph.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = bargraph.NewWidget(app, settings)
+		widget = bargraph.NewWidget(tviewApp, settings)
 	case "bittrex":
 		settings := bittrex.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = bittrex.NewWidget(app, settings)
+		widget = bittrex.NewWidget(tviewApp, settings)
 	case "blockfolio":
 		settings := blockfolio.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = blockfolio.NewWidget(app, settings)
+		widget = blockfolio.NewWidget(tviewApp, settings)
+	case "buildkite":
+		settings := buildkite.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = buildkite.NewWidget(tviewApp, pages, settings)
+	case "cdsFavorites":
+		settings := cdsfavorites.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = cdsfavorites.NewWidget(tviewApp, pages, settings)
+	case "cdsQueue":
+		settings := cdsqueue.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = cdsqueue.NewWidget(tviewApp, pages, settings)
+	case "cdsStatus":
+		settings := cdsstatus.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = cdsstatus.NewWidget(tviewApp, pages, settings)
 	case "circleci":
 		settings := circleci.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = circleci.NewWidget(app, settings)
+		widget = circleci.NewWidget(tviewApp, settings)
 	case "clocks":
 		settings := clocks.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = clocks.NewWidget(app, settings)
+		widget = clocks.NewWidget(tviewApp, settings)
+	case "covid":
+		settings := covid.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = covid.NewWidget(tviewApp, settings)
 	case "cmdrunner":
 		settings := cmdrunner.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = cmdrunner.NewWidget(app, settings)
+		widget = cmdrunner.NewWidget(tviewApp, settings)
 	case "cryptolive":
 		settings := cryptolive.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = cryptolive.NewWidget(app, settings)
+		widget = cryptolive.NewWidget(tviewApp, settings)
 	case "datadog":
 		settings := datadog.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = datadog.NewWidget(app, pages, settings)
+		widget = datadog.NewWidget(tviewApp, pages, settings)
+	case "devto":
+		settings := devto.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = devto.NewWidget(tviewApp, pages, settings)
+	case "digitalclock":
+		settings := digitalclock.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = digitalclock.NewWidget(tviewApp, settings)
+	case "digitalocean":
+		settings := digitalocean.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = digitalocean.NewWidget(tviewApp, pages, settings)
+	case "docker":
+		settings := docker.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = docker.NewWidget(tviewApp, pages, settings)
 	case "feedreader":
 		settings := feedreader.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = feedreader.NewWidget(app, pages, settings)
+		widget = feedreader.NewWidget(tviewApp, pages, settings)
+	case "football":
+		settings := football.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = football.NewWidget(tviewApp, pages, settings)
 	case "gcal":
 		settings := gcal.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = gcal.NewWidget(app, settings)
+		widget = gcal.NewWidget(tviewApp, settings)
 	case "gerrit":
 		settings := gerrit.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = gerrit.NewWidget(app, pages, settings)
+		widget = gerrit.NewWidget(tviewApp, pages, settings)
 	case "git":
 		settings := git.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = git.NewWidget(app, pages, settings)
+		widget = git.NewWidget(tviewApp, pages, settings)
 	case "github":
 		settings := github.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = github.NewWidget(app, pages, settings)
+		widget = github.NewWidget(tviewApp, pages, settings)
 	case "gitlab":
 		settings := gitlab.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = gitlab.NewWidget(app, pages, settings)
+		widget = gitlab.NewWidget(tviewApp, pages, settings)
+	case "gitlabtodo":
+		settings := gitlabtodo.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = gitlabtodo.NewWidget(tviewApp, pages, settings)
 	case "gitter":
 		settings := gitter.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = gitter.NewWidget(app, pages, settings)
+		widget = gitter.NewWidget(tviewApp, pages, settings)
 	case "googleanalytics":
 		settings := googleanalytics.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = googleanalytics.NewWidget(app, settings)
+		widget = googleanalytics.NewWidget(tviewApp, settings)
 	case "gspreadsheets":
 		settings := gspreadsheets.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = gspreadsheets.NewWidget(app, settings)
+		widget = gspreadsheets.NewWidget(tviewApp, settings)
+	case "grafana":
+		settings := grafana.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = grafana.NewWidget(tviewApp, pages, settings)
 	case "hackernews":
 		settings := hackernews.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = hackernews.NewWidget(app, pages, settings)
+		widget = hackernews.NewWidget(tviewApp, pages, settings)
+	case "healthchecks":
+		settings := healthchecks.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = healthchecks.NewWidget(tviewApp, pages, settings)
 	case "hibp":
 		settings := hibp.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = hibp.NewWidget(app, settings)
+		widget = hibp.NewWidget(tviewApp, settings)
 	case "ipapi":
 		settings := ipapi.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = ipapi.NewWidget(app, settings)
+		widget = ipapi.NewWidget(tviewApp, settings)
 	case "ipinfo":
 		settings := ipinfo.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = ipinfo.NewWidget(app, settings)
+		widget = ipinfo.NewWidget(tviewApp, settings)
 	case "jenkins":
 		settings := jenkins.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = jenkins.NewWidget(app, pages, settings)
+		widget = jenkins.NewWidget(tviewApp, pages, settings)
 	case "jira":
 		settings := jira.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = jira.NewWidget(app, pages, settings)
+		widget = jira.NewWidget(tviewApp, pages, settings)
 	case "kubernetes":
 		settings := kubernetes.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = kubernetes.NewWidget(app, settings)
+		widget = kubernetes.NewWidget(tviewApp, settings)
+	case "krisinformation":
+		settings := krisinformation.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = krisinformation.NewWidget(tviewApp, settings)
 	case "logger":
 		settings := logger.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = logger.NewWidget(app, settings)
+		widget = logger.NewWidget(tviewApp, settings)
 	case "mercurial":
 		settings := mercurial.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = mercurial.NewWidget(app, pages, settings)
+		widget = mercurial.NewWidget(tviewApp, pages, settings)
 	case "nbascore":
 		settings := nbascore.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = nbascore.NewWidget(app, pages, settings)
+		widget = nbascore.NewWidget(tviewApp, pages, settings)
 	case "newrelic":
 		settings := newrelic.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = newrelic.NewWidget(app, settings)
+		widget = newrelic.NewWidget(tviewApp, pages, settings)
 	case "opsgenie":
 		settings := opsgenie.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = opsgenie.NewWidget(app, settings)
+		widget = opsgenie.NewWidget(tviewApp, settings)
 	case "pagerduty":
 		settings := pagerduty.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = pagerduty.NewWidget(app, settings)
+		widget = pagerduty.NewWidget(tviewApp, settings)
+	case "pihole":
+		settings := pihole.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = pihole.NewWidget(tviewApp, pages, settings)
 	case "power":
 		settings := power.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = power.NewWidget(app, settings)
+		widget = power.NewWidget(tviewApp, settings)
 	case "prettyweather":
 		settings := prettyweather.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = prettyweather.NewWidget(app, settings)
+		widget = prettyweather.NewWidget(tviewApp, settings)
+	case "pocket":
+		settings := pocket.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = pocket.NewWidget(tviewApp, pages, settings)
 	case "resourceusage":
 		settings := resourceusage.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = resourceusage.NewWidget(app, settings)
+		widget = resourceusage.NewWidget(tviewApp, settings)
 	case "rollbar":
 		settings := rollbar.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = rollbar.NewWidget(app, pages, settings)
+		widget = rollbar.NewWidget(tviewApp, pages, settings)
 	case "security":
 		settings := security.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = security.NewWidget(app, settings)
+		widget = security.NewWidget(tviewApp, settings)
+	case "spacex":
+		settings := spacex.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = spacex.NewWidget(tviewApp, settings)
 	case "spotify":
 		settings := spotify.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = spotify.NewWidget(app, pages, settings)
+		widget = spotify.NewWidget(tviewApp, pages, settings)
 	case "spotifyweb":
 		settings := spotifyweb.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = spotifyweb.NewWidget(app, pages, settings)
+		widget = spotifyweb.NewWidget(tviewApp, pages, settings)
 	case "status":
 		settings := status.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = status.NewWidget(app, settings)
+		widget = status.NewWidget(tviewApp, settings)
+	case "subreddit":
+		settings := subreddit.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = subreddit.NewWidget(tviewApp, pages, settings)
 	case "textfile":
 		settings := textfile.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = textfile.NewWidget(app, pages, settings)
+		widget = textfile.NewWidget(tviewApp, pages, settings)
 	case "todo":
 		settings := todo.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = todo.NewWidget(app, pages, settings)
+		widget = todo.NewWidget(tviewApp, pages, settings)
+	case "todo_plus":
+		settings := todo_plus.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = todo_plus.NewWidget(tviewApp, pages, settings)
 	case "todoist":
-		settings := todoist.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = todoist.NewWidget(app, pages, settings)
+		settings := todo_plus.FromTodoist(moduleName, moduleConfig, config)
+		widget = todo_plus.NewWidget(tviewApp, pages, settings)
 	case "transmission":
 		settings := transmission.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = transmission.NewWidget(app, pages, settings)
+		widget = transmission.NewWidget(tviewApp, pages, settings)
 	case "travisci":
 		settings := travisci.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = travisci.NewWidget(app, pages, settings)
+		widget = travisci.NewWidget(tviewApp, pages, settings)
 	case "trello":
-		settings := trello.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = trello.NewWidget(app, settings)
+		settings := todo_plus.FromTrello(moduleName, moduleConfig, config)
+		widget = todo_plus.NewWidget(tviewApp, pages, settings)
+	case "twitch":
+		settings := twitch.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = twitch.NewWidget(tviewApp, pages, settings)
 	case "twitter":
 		settings := twitter.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = twitter.NewWidget(app, pages, settings)
+		widget = twitter.NewWidget(tviewApp, pages, settings)
+	case "twitterstats":
+		settings := twitterstats.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = twitterstats.NewWidget(tviewApp, pages, settings)
+	case "uptimerobot":
+		settings := uptimerobot.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = uptimerobot.NewWidget(tviewApp, pages, settings)
 	case "victorops":
 		settings := victorops.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = victorops.NewWidget(app, settings)
+		widget = victorops.NewWidget(tviewApp, settings)
 	case "weather":
 		settings := weather.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = weather.NewWidget(app, pages, settings)
+		widget = weather.NewWidget(tviewApp, pages, settings)
 	case "zendesk":
 		settings := zendesk.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = zendesk.NewWidget(app, pages, settings)
+		widget = zendesk.NewWidget(tviewApp, pages, settings)
+	case "exchangerates":
+		settings := exchangerates.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = exchangerates.NewWidget(tviewApp, pages, settings)
+	case "finnhub":
+		settings := finnhub.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = finnhub.NewWidget(tviewApp, settings)
+	case "yfinance":
+		settings := yfinance.NewSettingsFromYAML(moduleName, moduleConfig, config)
+		widget = yfinance.NewWidget(tviewApp, settings)
 	default:
 		settings := unknown.NewSettingsFromYAML(moduleName, moduleConfig, config)
-		widget = unknown.NewWidget(app, settings)
+		widget = unknown.NewWidget(tviewApp, settings)
 	}
 
 	return widget
 }
 
 // MakeWidgets creates and returns a collection of enabled widgets
-func MakeWidgets(app *tview.Application, pages *tview.Pages, config *config.Config) []wtf.Wtfable {
+func MakeWidgets(tviewApp *tview.Application, pages *tview.Pages, config *config.Config) []wtf.Wtfable {
 	widgets := []wtf.Wtfable{}
 
 	moduleNames, _ := config.Map("wtf.mods")
 
 	for moduleName := range moduleNames {
-		widget := MakeWidget(app, pages, moduleName, config)
+		widget := MakeWidget(tviewApp, pages, moduleName, config)
 
 		if widget != nil {
 			widgets = append(widgets, widget)

app/widget_maker_test.go

@@ -0,0 +1,77 @@
+package app
+
+import (
+	"testing"
+
+	"github.com/olebedev/config"
+	"github.com/stretchr/testify/assert"
+	"github.com/wtfutil/wtf/modules/clocks"
+	"github.com/wtfutil/wtf/wtf"
+)
+
+const (
+	disabled = `
+wtf:
+  mods:
+    clocks:
+      enabled: false
+      position:
+        top: 0
+        left: 0
+        height: 1
+        width: 1
+      refreshInterval: 30`
+
+	enabled = `
+wtf:
+  mods:
+    clocks:
+      enabled: true
+      position:
+        top: 0
+        left: 0
+        height: 1
+        width: 1
+      refreshInterval: 30`
+)
+
+func Test_MakeWidget(t *testing.T) {
+	tests := []struct {
+		name       string
+		moduleName string
+		config     *config.Config
+		expected   wtf.Wtfable
+	}{
+		{
+			name:       "invalid module",
+			moduleName: "",
+			config:     &config.Config{},
+			expected:   nil,
+		},
+		{
+			name:       "valid disabled module",
+			moduleName: "clocks",
+			config: func() *config.Config {
+				cfg, _ := config.ParseYaml(disabled)
+				return cfg
+			}(),
+			expected: nil,
+		},
+		{
+			name:       "valid enabled module",
+			moduleName: "clocks",
+			config: func() *config.Config {
+				cfg, _ := config.ParseYaml(enabled)
+				return cfg
+			}(),
+			expected: &clocks.Widget{},
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			actual := MakeWidget(nil, nil, tt.moduleName, tt.config)
+			assert.IsType(t, tt.expected, actual)
+		})
+	}
+}

app/wtf_app.go

@@ -1,14 +1,19 @@
 package app
 
 import (
+	"fmt"
 	"log"
+	"os"
 	"time"
 
 	"github.com/gdamore/tcell"
+	_ "github.com/gdamore/tcell/terminfo/extended"
+	"github.com/logrusorgru/aurora"
 	"github.com/olebedev/config"
 	"github.com/radovskyb/watcher"
 	"github.com/rivo/tview"
 	"github.com/wtfutil/wtf/cfg"
+	"github.com/wtfutil/wtf/support"
 	"github.com/wtfutil/wtf/utils"
 	"github.com/wtfutil/wtf/wtf"
 )
@@ -16,52 +21,75 @@ import (
 // WtfApp is the container for a collection of widgets that are all constructed from a single
 // configuration file and displayed together
 type WtfApp struct {
-	app            *tview.Application
+	TViewApp *tview.Application
+
 	config         *config.Config
 	configFilePath string
 	display        *Display
 	focusTracker   FocusTracker
-	isCustomConfig bool
+	ghUser         *support.GitHubUser
 	pages          *tview.Pages
 	validator      *ModuleValidator
 	widgets        []wtf.Wtfable
 }
 
 // NewWtfApp creates and returns an instance of WtfApp
-func NewWtfApp(app *tview.Application, config *config.Config, configFilePath string, isCustom bool) *WtfApp {
-	wtfApp := WtfApp{
-		app:            app,
+func NewWtfApp(tviewApp *tview.Application, config *config.Config, configFilePath string) *WtfApp {
+	wtfApp := &WtfApp{
+		TViewApp: tviewApp,
+
 		config:         config,
 		configFilePath: configFilePath,
-		isCustomConfig: isCustom,
 		pages:          tview.NewPages(),
 	}
 
-	wtfApp.app.SetInputCapture(wtfApp.keyboardIntercept)
-	wtfApp.widgets = MakeWidgets(wtfApp.app, wtfApp.pages, wtfApp.config)
+	wtfApp.TViewApp.SetBeforeDrawFunc(func(s tcell.Screen) bool {
+		s.Clear()
+		return false
+	})
+
+	wtfApp.widgets = MakeWidgets(wtfApp.TViewApp, wtfApp.pages, wtfApp.config)
 	wtfApp.display = NewDisplay(wtfApp.widgets, wtfApp.config)
-	wtfApp.focusTracker = NewFocusTracker(wtfApp.app, wtfApp.widgets, wtfApp.config)
+	wtfApp.focusTracker = NewFocusTracker(wtfApp.TViewApp, wtfApp.widgets, wtfApp.config)
 	wtfApp.validator = NewModuleValidator()
 
+	githubAPIKey := readGitHubAPIKey(wtfApp.config)
+	wtfApp.ghUser = support.NewGitHubUser(githubAPIKey)
+
 	wtfApp.pages.AddPage("grid", wtfApp.display.Grid, true, true)
-	wtfApp.app.SetRoot(wtfApp.pages, true)
 
 	wtfApp.validator.Validate(wtfApp.widgets)
 
-	return &wtfApp
+	firstWidget := wtfApp.widgets[0]
+	wtfApp.pages.Box.SetBackgroundColor(
+		wtf.ColorFor(
+			firstWidget.CommonSettings().Colors.WidgetTheme.Background,
+		),
+	)
+
+	wtfApp.TViewApp.SetInputCapture(wtfApp.keyboardIntercept)
+	wtfApp.TViewApp.SetRoot(wtfApp.pages, true)
+
+	return wtfApp
 }
 
 /* -------------------- Exported Functions -------------------- */
 
-// App returns the *tview.Application instance
-func (wtfApp *WtfApp) App() *tview.Application {
-	return wtfApp.app
+// Run starts the underlying tview app
+func (wtfApp *WtfApp) Run() {
+	if err := wtfApp.TViewApp.Run(); err != nil {
+		fmt.Printf("\n%s %v\n", aurora.Red("ERROR"), err)
+		os.Exit(1)
+	}
 }
 
 // Start initializes the app
 func (wtfApp *WtfApp) Start() {
-	wtfApp.scheduleWidgets()
+	go wtfApp.scheduleWidgets()
 	go wtfApp.watchForConfigChanges()
+
+	// FIXME: This should be moved to the AppManager
+	go func() { _ = wtfApp.ghUser.Load() }()
 }
 
 // Stop kills all the currently-running widgets in this app
@@ -80,9 +108,18 @@ func (wtfApp *WtfApp) stopAllWidgets() {
 func (wtfApp *WtfApp) keyboardIntercept(event *tcell.EventKey) *tcell.EventKey {
 	// These keys are global keys used by the app. Widgets should not implement these keys
 	switch event.Key() {
+	case tcell.KeyCtrlC:
+		wtfApp.Stop()
+		wtfApp.TViewApp.Stop()
+		wtfApp.DisplayExitMessage()
 	case tcell.KeyCtrlR:
 		wtfApp.refreshAllWidgets()
 		return nil
+	case tcell.KeyCtrlSpace:
+		// FIXME: This can't reside in the app, the app doesn't know about
+		// the AppManager. The AppManager needs to catch this one
+		fmt.Println("Next app")
+		return nil
 	case tcell.KeyTab:
 		wtfApp.focusTracker.Next()
 	case tcell.KeyBacktab:
@@ -102,6 +139,7 @@ func (wtfApp *WtfApp) keyboardIntercept(event *tcell.EventKey) *tcell.EventKey {
 		switch string(event.Rune()) {
 		case "/":
 			return nil
+		default:
 		}
 	}
 
@@ -132,11 +170,17 @@ func (wtfApp *WtfApp) watchForConfigChanges() {
 			case <-watch.Event:
 				wtfApp.Stop()
 
-				config := cfg.LoadWtfConfigFile(wtfApp.configFilePath, wtfApp.isCustomConfig)
+				config := cfg.LoadWtfConfigFile(wtfApp.configFilePath)
+				newApp := NewWtfApp(wtfApp.TViewApp, config, wtfApp.configFilePath)
+				openURLUtil := utils.ToStrs(config.UList("wtf.openUrlUtil", []interface{}{}))
+				utils.Init(config.UString("wtf.openFileUtil", "open"), openURLUtil)
 
-				newApp := NewWtfApp(wtfApp.app, config, wtfApp.configFilePath, wtfApp.isCustomConfig)
 				newApp.Start()
 			case err := <-watch.Error:
+				if err == watcher.ErrWatchedFileDeleted {
+					// Usually happens because the watcher looks for the file as the OS is updating it
+					continue
+				}
 				log.Fatalln(err)
 			case <-watch.Closed:
 				return

cfg/common_settings.go

@@ -5,25 +5,13 @@ import (
 	"strings"
 
 	"github.com/olebedev/config"
+	"golang.org/x/text/language"
+	"golang.org/x/text/message"
 )
 
-type Colors struct {
-	Background      string
-	BorderFocusable string
-	BorderFocused   string
-	BorderNormal    string
-	Checked         string
-	Foreground      string
-	HighlightFore   string
-	HighlightBack   string
-	Text            string
-	Title           string
-
-	Rows struct {
-		Even string
-		Odd  string
-	}
-}
+const (
+	defaultLanguageTag = "en-CA"
+)
 
 type Module struct {
 	Name string
@@ -41,38 +29,66 @@ type Sigils struct {
 	}
 }
 
+// Common defines a set of common configuration settings applicable to all modules
 type Common struct {
-	Colors
 	Module
 	PositionSettings `help:"Defines where in the grid this module’s widget will be displayed."`
 	Sigils
 
+	Colors ColorTheme
+	Config *config.Config
+
+	DocPath string
+
 	Bordered        bool   `help:"Whether or not the module should be displayed with a border." values:"true, false" optional:"true" default:"true"`
 	Enabled         bool   `help:"Whether or not this module is executed and if its data displayed onscreen." values:"true, false" optional:"true" default:"false"`
+	Focusable       bool   `help:"Whether or  not this module is focusable." values:"true, false" optional:"true" default:"false"`
+	LanguageTag     string `help:"The BCP 47 langauge tag to localize text to." values:"Any supported BCP 47 language tag." optional:"true" default:"en-CA"`
 	RefreshInterval int    `help:"How often, in seconds, this module will update its data." values:"A positive integer, 0..n." optional:"true"`
 	Title           string `help:"The title string to show when displaying this module" optional:"true"`
-	Config          *config.Config
 
 	focusChar int `help:"Define one of the number keys as a short cut key to access the widget." optional:"true"`
 }
 
-func NewCommonSettingsFromModule(name, defaultTitle string, moduleConfig *config.Config, globalSettings *config.Config) *Common {
-	colorsConfig, _ := globalSettings.Get("wtf.colors")
-	sigilsPath := "wtf.sigils"
+// NewCommonSettingsFromModule returns a common settings configuration tailed to the given module
+func NewCommonSettingsFromModule(name, defaultTitle string, defaultFocusable bool, moduleConfig *config.Config, globalConfig *config.Config) *Common {
+	baseColors := NewDefaultColorTheme()
+
+	colorsConfig, err := globalConfig.Get("wtf.colors")
+	if err != nil && strings.Contains(err.Error(), "Nonexistent map") {
+		// Create a default colors config to fill in for the missing one
+		// This comes into play when the configuration file does not contain a `colors:` key, i.e:
+		//
+		//     wtf:
+		//       # colors:                <- missing
+		//       refreshInterval: 1
+		//       openFileUtil: "open"
+		//
+		colorsConfig, _ = NewDefaultColorConfig()
+	}
+
+	// And finally create a third instance to be the final default fallback in case there are empty or nil values in
+	// the colors extracted from the config file (aka colorsConfig)
+	defaultColorTheme := NewDefaultColorTheme()
+
+	baseColors.BorderTheme.Focusable = moduleConfig.UString("colors.border.focusable", colorsConfig.UString("border.focusable", defaultColorTheme.BorderTheme.Focusable))
+	baseColors.BorderTheme.Focused = moduleConfig.UString("colors.border.focused", colorsConfig.UString("border.focused", defaultColorTheme.BorderTheme.Focused))
+	baseColors.BorderTheme.Unfocusable = moduleConfig.UString("colors.border.normal", colorsConfig.UString("border.normal", defaultColorTheme.BorderTheme.Unfocusable))
+
+	baseColors.CheckboxTheme.Checked = moduleConfig.UString("colors.checked", colorsConfig.UString("checked", defaultColorTheme.CheckboxTheme.Checked))
+
+	baseColors.RowTheme.EvenForeground = moduleConfig.UString("colors.rows.even", colorsConfig.UString("rows.even", defaultColorTheme.RowTheme.EvenForeground))
+	baseColors.RowTheme.OddForeground = moduleConfig.UString("colors.rows.odd", colorsConfig.UString("rows.odd", defaultColorTheme.RowTheme.OddForeground))
+
+	baseColors.TextTheme.Label = moduleConfig.UString("colors.label", colorsConfig.UString("label", defaultColorTheme.TextTheme.Label))
+	baseColors.TextTheme.Subheading = moduleConfig.UString("colors.subheading", colorsConfig.UString("subheading", defaultColorTheme.TextTheme.Subheading))
+	baseColors.TextTheme.Text = moduleConfig.UString("colors.text", colorsConfig.UString("text", defaultColorTheme.TextTheme.Text))
+	baseColors.TextTheme.Title = moduleConfig.UString("colors.title", colorsConfig.UString("title", defaultColorTheme.TextTheme.Title))
+
+	baseColors.WidgetTheme.Background = moduleConfig.UString("colors.background", colorsConfig.UString("background", defaultColorTheme.WidgetTheme.Background))
 
 	common := Common{
-		Colors: Colors{
-			Background:      moduleConfig.UString("background", globalSettings.UString("background", "black")),
-			BorderFocusable: colorsConfig.UString("border.focusable", "red"),
-			BorderFocused:   colorsConfig.UString("border.focused", "orange"),
-			BorderNormal:    colorsConfig.UString("border.normal", "gray"),
-			Checked:         colorsConfig.UString("checked", "white"),
-			Foreground:      moduleConfig.UString("foreground", colorsConfig.UString("foreground", "white")),
-			HighlightFore:   colorsConfig.UString("highlight.fore", "black"),
-			HighlightBack:   colorsConfig.UString("highlight.back", "green"),
-			Text:            moduleConfig.UString("colors.text", colorsConfig.UString("text", "white")),
-			Title:           moduleConfig.UString("colors.title", colorsConfig.UString("title", "white")),
-		},
+		Colors: baseColors,
 
 		Module: Module{
 			Name: name,
@@ -82,22 +98,21 @@ func NewCommonSettingsFromModule(name, defaultTitle string, moduleConfig *config
 		PositionSettings: NewPositionSettingsFromYAML(name, moduleConfig),
 
 		Bordered:        moduleConfig.UBool("border", true),
+		Config:          moduleConfig,
 		Enabled:         moduleConfig.UBool("enabled", false),
+		Focusable:       moduleConfig.UBool("focusable", defaultFocusable),
+		LanguageTag:     globalConfig.UString("wtf.language", defaultLanguageTag),
 		RefreshInterval: moduleConfig.UInt("refreshInterval", 300),
 		Title:           moduleConfig.UString("title", defaultTitle),
-		Config:          moduleConfig,
 
 		focusChar: moduleConfig.UInt("focusChar", -1),
 	}
 
-	common.Colors.Rows.Even = moduleConfig.UString("colors.rows.even", moduleConfig.UString("rows.even", "white"))
-	common.Colors.Rows.Odd = moduleConfig.UString("colors.rows.even", moduleConfig.UString("rows.odd", "lightblue"))
-
-	common.Sigils.Checkbox.Checked = globalSettings.UString(sigilsPath+".checkbox.checked", "x")
-	common.Sigils.Checkbox.Unchecked = globalSettings.UString(sigilsPath+".checkbox.unchecked", " ")
-
-	common.Sigils.Paging.Normal = globalSettings.UString(sigilsPath+".paging.normal", globalSettings.UString("wtf.paging.pageSigil", "*"))
-	common.Sigils.Paging.Selected = globalSettings.UString(sigilsPath+".paging.select", globalSettings.UString("wtf.paging.selectedSigil", "_"))
+	sigilsPath := "wtf.sigils"
+	common.Sigils.Checkbox.Checked = globalConfig.UString(sigilsPath+".checkbox.checked", "x")
+	common.Sigils.Checkbox.Unchecked = globalConfig.UString(sigilsPath+".checkbox.unchecked", " ")
+	common.Sigils.Paging.Normal = globalConfig.UString(sigilsPath+".paging.normal", globalConfig.UString("wtf.paging.pageSigil", "*"))
+	common.Sigils.Paging.Selected = globalConfig.UString(sigilsPath+".paging.select", globalConfig.UString("wtf.paging.selectedSigil", "_"))
 
 	return &common
 }
@@ -105,27 +120,55 @@ func NewCommonSettingsFromModule(name, defaultTitle string, moduleConfig *config
 /* -------------------- Exported Functions -------------------- */
 
 func (common *Common) DefaultFocusedRowColor() string {
-	return fmt.Sprintf("%s:%s", common.Colors.HighlightFore, common.Colors.HighlightBack)
+	return fmt.Sprintf(
+		"%s:%s",
+		common.Colors.RowTheme.HighlightedForeground,
+		common.Colors.RowTheme.HighlightedBackground,
+	)
 }
 
 func (common *Common) DefaultRowColor() string {
-	return fmt.Sprintf("%s:%s", common.Colors.Foreground, common.Colors.Background)
+	return fmt.Sprintf(
+		"%s:%s",
+		common.Colors.RowTheme.EvenForeground,
+		common.Colors.RowTheme.EvenBackground,
+	)
 }
 
+// FocusChar returns the keyboard number assigned to the widget used to give onscreen
+// focus to this widget, as a string. Focus characters can be a range between 1 and 9
 func (common *Common) FocusChar() string {
-	if common.focusChar <= -1 {
+	if common.focusChar <= 0 {
 		return ""
 	}
 
-	return string('0' + common.focusChar)
+	if common.focusChar > 9 {
+		return ""
+	}
+
+	return fmt.Sprint(common.focusChar)
+}
+
+// LocalizedPrinter returns a message.Printer instance localized to the BCP 47 language
+// configuration value defined in 'wtf.language' config. If none exists, it defaults to
+// 'en-CA'. Use this to format numbers, etc.
+func (common *Common) LocalizedPrinter() (*message.Printer, error) {
+	langTag, err := language.Parse(common.LanguageTag)
+	if err != nil {
+		return nil, err
+	}
+
+	prntr := message.NewPrinter(langTag)
+
+	return prntr, nil
 }
 
 func (common *Common) RowColor(idx int) string {
 	if idx%2 == 0 {
-		return common.Colors.Rows.Even
+		return common.Colors.RowTheme.EvenForeground
 	}
 
-	return common.Colors.Rows.Odd
+	return common.Colors.RowTheme.OddForeground
 }
 
 func (common *Common) RightAlignFormat(width int) string {
@@ -133,7 +176,9 @@ func (common *Common) RightAlignFormat(width int) string {
 	return fmt.Sprintf("%%%ds", width-borderOffset)
 }
 
-func (common *Common) SigilStr(len, pos int, width int) string {
+// PaginationMarker generates the pagination indicators that appear in the top-right corner
+// of multisource widgets
+func (common *Common) PaginationMarker(len, pos, width int) string {
 	sigils := ""
 
 	if len > 1 {
@@ -147,6 +192,15 @@ func (common *Common) SigilStr(len, pos int, width int) string {
 	return sigils
 }
 
+// SetDocumentationPath is used to explicitly set the documentation path that should be opened
+// when the key to open the documentation is pressed.
+// Setting this is probably not necessary unless the module documentation is nested inside a
+// documentation subdirectory in the /wtfutildocs repo, or the module here has a different
+// name than the module's display name in the documentation (which ideally wouldn't be a thing).
+func (common *Common) SetDocumentationPath(path string) {
+	common.DocPath = path
+}
+
 // Validations aggregates all the validations from all the sub-sections in Common into a
 // single array of validations
 func (common *Common) Validations() []Validatable {

cfg/common_settings_test.go

@@ -0,0 +1,194 @@
+package cfg
+
+import (
+	"testing"
+
+	"github.com/olebedev/config"
+	"github.com/stretchr/testify/assert"
+)
+
+var (
+	testYaml = `
+wtf:
+  colors:
+`
+
+	moduleConfig, _   = config.ParseYaml(testYaml)
+	globalSettings, _ = config.ParseYaml(testYaml)
+
+	testCfg = NewCommonSettingsFromModule(
+		"test",
+		"Test Config",
+		true,
+		moduleConfig,
+		globalSettings,
+	)
+)
+
+func Test_NewCommonSettingsFromModule(t *testing.T) {
+	assert.Equal(t, true, testCfg.Bordered)
+	assert.Equal(t, false, testCfg.Enabled)
+	assert.Equal(t, true, testCfg.Focusable)
+	assert.Equal(t, "test", testCfg.Module.Name)
+	assert.Equal(t, "test", testCfg.Module.Type)
+	assert.Equal(t, "", testCfg.FocusChar())
+	assert.Equal(t, 300, testCfg.RefreshInterval)
+	assert.Equal(t, "Test Config", testCfg.Title)
+}
+
+func Test_DefaultFocusedRowColor(t *testing.T) {
+	assert.Equal(t, "black:green", testCfg.DefaultFocusedRowColor())
+}
+
+func Test_DefaultRowColor(t *testing.T) {
+	assert.Equal(t, "white:transparent", testCfg.DefaultRowColor())
+}
+
+func Test_FocusChar(t *testing.T) {
+	tests := []struct {
+		name         string
+		before       func(testCfg *Common)
+		expectedChar string
+	}{
+		{
+			name: "with negative focus char",
+			before: func(testCfg *Common) {
+				testCfg.focusChar = -1
+			},
+			expectedChar: "",
+		},
+		{
+			name: "with positive focus char",
+			before: func(testCfg *Common) {
+				testCfg.focusChar = 3
+			},
+			expectedChar: "3",
+		},
+		{
+			name: "with zero focus char",
+			before: func(testCfg *Common) {
+				testCfg.focusChar = 0
+			},
+			expectedChar: "",
+		},
+		{
+			name: "with large focus char",
+			before: func(testCfg *Common) {
+				testCfg.focusChar = 10
+			},
+			expectedChar: "",
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			tt.before(testCfg)
+
+			assert.Equal(t, tt.expectedChar, testCfg.FocusChar())
+		})
+	}
+}
+
+func Test_RowColor(t *testing.T) {
+	tests := []struct {
+		name          string
+		idx           int
+		expectedColor string
+	}{
+		{
+			name:          "odd rows, default",
+			idx:           3,
+			expectedColor: "lightblue",
+		},
+		{
+			name:          "even rows, default",
+			idx:           8,
+			expectedColor: "white",
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			assert.Equal(t, tt.expectedColor, testCfg.RowColor(tt.idx))
+		})
+	}
+}
+
+func Test_RightAlignFormat(t *testing.T) {
+	tests := []struct {
+		name     string
+		width    int
+		expected string
+	}{
+		{
+			name:     "with zero",
+			width:    0,
+			expected: "%-2s",
+		},
+		{
+			name:     "with positive integer",
+			width:    3,
+			expected: "%1s",
+		},
+		{
+			name:     "with negative integer",
+			width:    -3,
+			expected: "%-5s",
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			assert.Equal(t, tt.expected, testCfg.RightAlignFormat(tt.width))
+		})
+	}
+}
+
+func Test_PaginationMarker(t *testing.T) {
+	tests := []struct {
+		name     string
+		len      int
+		pos      int
+		width    int
+		expected string
+	}{
+		{
+			name:     "with zero pages",
+			len:      0,
+			pos:      1,
+			width:    5,
+			expected: "",
+		},
+		{
+			name:     "with one page",
+			len:      1,
+			pos:      1,
+			width:    5,
+			expected: "",
+		},
+		{
+			name:     "with multiple pages",
+			len:      3,
+			pos:      1,
+			width:    5,
+			expected: "[lightblue]*_*[white]",
+		},
+		{
+			name:     "with negative pages",
+			len:      -3,
+			pos:      1,
+			width:    5,
+			expected: "",
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			assert.Equal(t, tt.expected, testCfg.PaginationMarker(tt.len, tt.pos, tt.width))
+		})
+	}
+}
+
+func Test_Validations(t *testing.T) {
+	assert.Equal(t, 4, len(testCfg.Validations()))
+}

cfg/config_files.go

@@ -29,7 +29,7 @@ const (
 
 // CreateFile creates the named file in the config directory, if it does not already exist.
 // If the file exists it does not recreate it.
-// If successful, eturns the absolute path to the file
+// If successful, returns the absolute path to the file
 // If unsuccessful, returns an error
 func CreateFile(fileName string) (string, error) {
 	configDir, err := WtfConfigDir()
@@ -37,7 +37,7 @@ func CreateFile(fileName string) (string, error) {
 		return "", err
 	}
 
-	filePath := fmt.Sprintf("%s/%s", configDir, fileName)
+	filePath := filepath.Join(configDir, fileName)
 
 	// Check if the file already exists; if it does not, create it
 	_, err = os.Stat(filePath)
@@ -58,16 +58,15 @@ func CreateFile(fileName string) (string, error) {
 // Initialize takes care of settings up the initial state of WTF configuration
 // It ensures necessary directories and files exist
 func Initialize(hasCustom bool) {
-	if hasCustom == false {
+	if !hasCustom {
 		migrateOldConfig()
 	}
 
 	// These always get created because this is where modules should write any permanent
 	// data they need to persist between runs (i.e.: log, textfile, etc.)
-	createXdgConfigDir()
 	createWtfConfigDir()
 
-	if hasCustom == false {
+	if !hasCustom {
 		createWtfConfigFile()
 		chmodConfigFile()
 	}
@@ -75,7 +74,13 @@ func Initialize(hasCustom bool) {
 
 // WtfConfigDir returns the absolute path to the configuration directory
 func WtfConfigDir() (string, error) {
-	configDir, err := expandHomeDir(WtfConfigDirV2)
+	configDir := os.Getenv("XDG_CONFIG_HOME")
+	if configDir == "" {
+		configDir = WtfConfigDirV2
+	} else {
+		configDir += "/wtf/"
+	}
+	configDir, err := expandHomeDir(configDir)
 	if err != nil {
 		return "", err
 	}
@@ -84,17 +89,12 @@ func WtfConfigDir() (string, error) {
 }
 
 // LoadWtfConfigFile loads the specified config file
-func LoadWtfConfigFile(filePath string, isCustomConfig bool) *config.Config {
+func LoadWtfConfigFile(filePath string) *config.Config {
 	absPath, _ := expandHomeDir(filePath)
 
 	cfg, err := config.ParseYamlFile(absPath)
 	if err != nil {
-		if isCustomConfig {
-			displayWtfCustomConfigFileLoadError(err)
-		} else {
-			displayWtfConfigFileLoadError(err)
-		}
-
+		displayWtfConfigFileLoadError(absPath, err)
 		os.Exit(1)
 	}
 
@@ -105,7 +105,8 @@ func LoadWtfConfigFile(filePath string, isCustomConfig bool) *config.Config {
 
 // chmodConfigFile sets the mode of the config file to r+w for the owner only
 func chmodConfigFile() {
-	relPath := fmt.Sprintf("%s%s", WtfConfigDirV2, WtfConfigFile)
+	configDir, _ := WtfConfigDir()
+	relPath := filepath.Join(configDir, WtfConfigFile)
 	absPath, _ := expandHomeDir(relPath)
 
 	_, err := os.Stat(absPath)
@@ -119,27 +120,13 @@ func chmodConfigFile() {
 	}
 }
 
-// createXdgConfigDir creates the necessary base directory for storing the config file
-// If ~/.config is missing, it will try to create it
-func createXdgConfigDir() {
-	xdgConfigDir, _ := expandHomeDir(XdgConfigDir)
-
-	if _, err := os.Stat(xdgConfigDir); os.IsNotExist(err) {
-		err := os.Mkdir(xdgConfigDir, os.ModePerm)
-		if err != nil {
-			displayXdgConfigDirCreateError(err)
-			os.Exit(1)
-		}
-	}
-}
-
 // createWtfConfigDir creates the necessary directories for storing the default config file
 // If ~/.config/wtf is missing, it will try to create it
 func createWtfConfigDir() {
 	wtfConfigDir, _ := WtfConfigDir()
 
 	if _, err := os.Stat(wtfConfigDir); os.IsNotExist(err) {
-		err := os.Mkdir(wtfConfigDir, os.ModePerm)
+		err := os.MkdirAll(wtfConfigDir, os.ModePerm)
 		if err != nil {
 			displayWtfConfigDirCreateError(err)
 			os.Exit(1)
@@ -209,7 +196,7 @@ func home() (string, error) {
 // to the new, XDG-compatible location
 func migrateOldConfig() {
 	srcDir, _ := expandHomeDir(WtfConfigDirV1)
-	destDir, _ := expandHomeDir(WtfConfigDirV2)
+	destDir, _ := WtfConfigDir()
 
 	// If the old config directory doesn't exist, do not move
 	if _, err := os.Stat(srcDir); os.IsNotExist(err) {

cfg/copy.go

@@ -34,17 +34,17 @@ func fcopy(src, dest string, info os.FileInfo) error {
 	if err != nil {
 		return err
 	}
-	defer f.Close()
+	defer func() { _ = f.Close() }()
 
 	if err = os.Chmod(f.Name(), info.Mode()); err != nil {
 		return err
 	}
 
-	s, err := os.Open(src)
+	s, err := os.Open(filepath.Clean(src))
 	if err != nil {
 		return err
 	}
-	defer s.Close()
+	defer func() { _ = f.Close() }()
 
 	_, err = io.Copy(f, s)
 	return err

cfg/default_color_theme.go

@@ -0,0 +1,109 @@
+package cfg
+
+import (
+	"github.com/olebedev/config"
+	"gopkg.in/yaml.v2"
+)
+
+// BorderTheme defines the default color scheme for drawing widget borders
+type BorderTheme struct {
+	Focusable   string
+	Focused     string
+	Unfocusable string
+}
+
+// CheckboxTheme defines the default color scheme for drawing checkable rows in widgets
+type CheckboxTheme struct {
+	Checked string
+}
+
+// RowTheme defines the default color scheme for row text
+type RowTheme struct {
+	EvenBackground string
+	EvenForeground string
+
+	OddBackground string
+	OddForeground string
+
+	HighlightedBackground string
+	HighlightedForeground string
+}
+
+// TextTheme defines the default color scheme for text rendering
+type TextTheme struct {
+	Label      string
+	Subheading string
+	Text       string
+	Title      string
+}
+
+// WidgetTheme defines the default color scheme for the widget rect itself
+type WidgetTheme struct {
+	Background string
+}
+
+// ColorTheme is an alamgam of all the default color settings
+type ColorTheme struct {
+	BorderTheme
+	CheckboxTheme
+	RowTheme
+	TextTheme
+	WidgetTheme
+}
+
+// NewDefaultColorTheme creates and returns an instance of DefaultColorTheme
+func NewDefaultColorTheme() ColorTheme {
+	defaultTheme := ColorTheme{
+		BorderTheme: BorderTheme{
+			Focusable:   "blue",
+			Focused:     "orange",
+			Unfocusable: "gray",
+		},
+
+		CheckboxTheme: CheckboxTheme{
+			Checked: "gray",
+		},
+
+		RowTheme: RowTheme{
+			EvenBackground: "transparent",
+			EvenForeground: "white",
+
+			OddBackground: "transparent",
+			OddForeground: "lightblue",
+
+			HighlightedForeground: "black",
+			HighlightedBackground: "green",
+		},
+
+		TextTheme: TextTheme{
+			Label:      "lightblue",
+			Subheading: "red",
+			Text:       "white",
+			Title:      "green",
+		},
+
+		WidgetTheme: WidgetTheme{
+			Background: "transparent",
+		},
+	}
+
+	return defaultTheme
+}
+
+// NewDefaultColorConfig creates and returns a config.Config-compatible configuration struct
+// using a DefaultColorTheme to pre-populate all the relevant values
+func NewDefaultColorConfig() (*config.Config, error) {
+	colorTheme := NewDefaultColorTheme()
+
+	yamlBytes, err := yaml.Marshal(colorTheme)
+	if err != nil {
+		return nil, err
+	}
+
+	cfg, err := config.ParseYamlBytes(yamlBytes)
+	if err != nil {
+		return nil, err
+	}
+
+	return cfg, nil
+}

cfg/default_color_theme_test.go

@@ -0,0 +1,26 @@
+package cfg
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+)
+
+func Test_NewDefaultColorTheme(t *testing.T) {
+	theme := NewDefaultColorTheme()
+
+	assert.Equal(t, "orange", theme.BorderTheme.Focused)
+	assert.Equal(t, "red", theme.TextTheme.Subheading)
+	assert.Equal(t, "transparent", theme.WidgetTheme.Background)
+}
+
+func Test_NewDefaultColorConfig(t *testing.T) {
+	cfg, err := NewDefaultColorConfig()
+
+	assert.Nil(t, err)
+
+	assert.Equal(t, "orange", cfg.UString("bordertheme.focused"))
+	assert.Equal(t, "red", cfg.UString("texttheme.subheading"))
+	assert.Equal(t, "transparent", cfg.UString("widgettheme.background"))
+	assert.Equal(t, "", cfg.UString("widgettheme.missing"))
+}

cfg/default_config_file.go

@@ -1,15 +1,14 @@
 package cfg
 
-const defaultConfigFile = `
-wtf:
+const defaultConfigFile = `wtf:
   colors:
     border:
       focusable: darkslateblue
       focused: orange
       normal: gray
   grid:
-    columns: [32, 32, 32, 32]
-    rows: [10, 10, 10, 4, 4]
+    columns: [32, 32, 32, 32, 90]
+    rows: [10, 10, 10, 4, 4, 90]
   refreshInterval: 1
   mods:
     clocks_a:
@@ -37,7 +36,7 @@ wtf:
           odd: "white"
       enabled: true
       locations:
-        Avignon: "Europe/Paris"
+        Paris: "Europe/Paris"
         Barcelona: "Europe/Madrid"
         Dubai: "Asia/Dubai"
       position:
@@ -59,7 +58,7 @@ wtf:
         left: 1
         width: 2
         height: 1
-      updateInterval: 14400
+      refreshInterval: 14400
     ipinfo:
       colors:
         name: "lightblue"

cfg/error_messages.go

@@ -30,31 +30,14 @@ func displayDefaultConfigWriteError(err error) {
 	displayError(err)
 }
 
-func displayXdgConfigDirCreateError(err error) {
-	fmt.Printf("\n%s Could not create the '%s' directory.\n", aurora.Red("ERROR"), aurora.Yellow(XdgConfigDir))
-	fmt.Println()
-	displayError(err)
-}
-
 func displayWtfConfigDirCreateError(err error) {
 	fmt.Printf("\n%s Could not create the '%s' directory.\n", aurora.Red("ERROR"), aurora.Yellow(WtfConfigDirV2))
 	fmt.Println()
 	displayError(err)
 }
 
-func displayWtfConfigFileLoadError(err error) {
-	fmt.Printf("\n%s Could not load '%s'.\n", aurora.Red("ERROR"), aurora.Yellow(WtfConfigFile))
-	fmt.Println()
-	fmt.Println("This could mean one of two things:")
-	fmt.Println()
-	fmt.Printf("    1. Your %s file is missing. Check in %s to see if %s is there.\n", aurora.Yellow(WtfConfigFile), aurora.Yellow("~/.config/wtf/"), aurora.Yellow(WtfConfigFile))
-	fmt.Printf("    2. Your %s file has a syntax error. Try running it through http://www.yamllint.com to check for errors.\n", aurora.Yellow(WtfConfigFile))
-	fmt.Println()
-	displayError(err)
-}
-
-func displayWtfCustomConfigFileLoadError(err error) {
-	fmt.Printf("\n%s Could not load '%s'.\n", aurora.Red("ERROR"), aurora.Yellow(WtfConfigFile))
+func displayWtfConfigFileLoadError(path string, err error) {
+	fmt.Printf("\n%s Could not load '%s'.\n", aurora.Red("ERROR"), aurora.Yellow(path))
 	fmt.Println()
 	fmt.Println("This could mean one of two things:")
 	fmt.Println()

cfg/parsers.go

@@ -0,0 +1,28 @@
+package cfg
+
+import (
+	"fmt"
+
+	"github.com/olebedev/config"
+)
+
+// ParseAsMapOrList takes a configuration key and attempts to parse it first as a map
+// and then as a list. Map entries are concatenated as "key/value"
+func ParseAsMapOrList(ymlConfig *config.Config, configKey string) []string {
+	result := []string{}
+
+	mapItems, err := ymlConfig.Map(configKey)
+	if err == nil {
+		for key, value := range mapItems {
+			result = append(result, fmt.Sprintf("%s/%s", value, key))
+		}
+		return result
+	}
+
+	listItems := ymlConfig.UList(configKey)
+	for _, listItem := range listItems {
+		result = append(result, listItem.(string))
+	}
+
+	return result
+}

cfg/parsers_test.go

@@ -0,0 +1,50 @@
+package cfg
+
+import (
+	"testing"
+
+	"github.com/olebedev/config"
+)
+
+func Test_ParseAsMapOrList(t *testing.T) {
+	tests := []struct {
+		name          string
+		configKey     string
+		yaml          string
+		expectedCount int
+	}{
+		{
+			name:          "as empty set",
+			configKey:     "data",
+			yaml:          "",
+			expectedCount: 0,
+		},
+		{
+			name:          "as map",
+			configKey:     "data",
+			yaml:          "data:\n  a: cat\n  b: dog",
+			expectedCount: 2,
+		},
+		{
+			name:          "as list",
+			configKey:     "data",
+			yaml:          "data:\n  - cat\n  - dog\n  - rat\n",
+			expectedCount: 3,
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			ymlConfig, err := config.ParseYaml(tt.yaml)
+			if err != nil {
+				t.Errorf("\nexpected: no error\n     got: %v", err)
+			}
+
+			actual := ParseAsMapOrList(ymlConfig, tt.configKey)
+
+			if tt.expectedCount != len(actual) {
+				t.Errorf("\nexpected: %d\n     got: %d", tt.expectedCount, len(actual))
+			}
+		})
+	}
+}

cfg/position_settings.go

@@ -41,10 +41,10 @@ func NewPositionSettingsFromYAML(moduleName string, moduleConfig *config.Config)
 	pos := PositionSettings{
 		Validations: validations,
 
-		Top:    validations.valueFor("top"),
-		Left:   validations.valueFor("left"),
-		Width:  validations.valueFor("width"),
-		Height: validations.valueFor("height"),
+		Top:    validations.intValueFor("top"),
+		Left:   validations.intValueFor("left"),
+		Width:  validations.intValueFor("width"),
+		Height: validations.intValueFor("height"),
 	}
 
 	return pos

cfg/position_validation.go

@@ -54,6 +54,8 @@ func (posVal *positionValidation) String() string {
 	return fmt.Sprintf("Invalid value for %s:\t%d", aurora.Yellow(posVal.name), posVal.intVal)
 }
 
+/* -------------------- Unexported Functions -------------------- */
+
 func newPositionValidation(name string, intVal int, err error) *positionValidation {
 	posVal := &positionValidation{
 		err:    err,

cfg/position_validation_test.go

@@ -0,0 +1,26 @@
+package cfg
+
+import (
+	"errors"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+)
+
+var (
+	posVal = &positionValidation{
+		err:    errors.New("Busted"),
+		name:   "top",
+		intVal: -3,
+	}
+)
+
+func Test_Attributes(t *testing.T) {
+	assert.EqualError(t, posVal.Error(), "Busted")
+	assert.Equal(t, true, posVal.HasError())
+	assert.Equal(t, -3, posVal.IntValue())
+
+	assert.Contains(t, posVal.String(), "Invalid")
+	assert.Contains(t, posVal.String(), "top")
+	assert.Contains(t, posVal.String(), "-3")
+}

cfg/secrets.go

@@ -0,0 +1,224 @@
+package cfg
+
+import (
+	"errors"
+	"fmt"
+	"runtime"
+
+	"github.com/docker/docker-credential-helpers/client"
+	"github.com/docker/docker-credential-helpers/credentials"
+	"github.com/olebedev/config"
+	"github.com/wtfutil/wtf/logger"
+)
+
+type SecretLoadParams struct {
+	name         string
+	globalConfig *config.Config
+	service      string
+
+	secret *string
+}
+
+// Load module secrets.
+//
+// The credential helpers impose this structure:
+//
+//   SERVICE is mapped to a SECRET and USERNAME
+//
+// Only SECRET is secret, SERVICE and USERNAME are not, so this
+// API doesn't expose USERNAME.
+//
+// SERVICE was intended to be the URL of an API server, but
+// for hosted services that do not have or need a configurable
+// API server, its easier to just use the module name as the
+// SERVICE:
+//
+//     cfg.ModuleSecret(name, globalConfig, &settings.apiKey).Load()
+//
+//  The user will use the module name as the service, and the API key as
+//  the secret, for example:
+//
+//     % wtfutil save-secret circleci
+//     Secret: ...
+//
+// If a module (such as pihole, jenkins, or github) might have multiple
+// instantiations each using a different API service (with its own unique
+// API key), then the module should use the API URL to lookup the secret.
+// For example, for github:
+//
+//     cfg.ModuleSecret(name, globalConfig, &settings.apiKey).
+//         Service(settings.baseURL).
+//         Load()
+//
+// The user will use the API URL as the service, and the API key as the
+// secret, for example, with github configured as:
+//
+//     -- config.yml
+//     mods:
+//       github:
+//         baseURL: "https://github.mycompany.com/api/v3"
+//         ...
+//
+//  the secret must be saved as:
+//
+//     % wtfutil save-secret https://github.mycompany.com/api/v3
+//     Secret: ...
+//
+//  If baseURL is not set in the configuration it will be the modules
+//  default, and the SERVICE will default to the module name, "github",
+//  and the user must save the secret as:
+//
+//     % wtfutil save-secret github
+//     Secret: ...
+//
+//  Ideally, the individual module documentation would describe the
+//  SERVICE name to use to save the secret.
+func ModuleSecret(name string, globalConfig *config.Config, secret *string) *SecretLoadParams {
+	return &SecretLoadParams{
+		name:         name,
+		globalConfig: globalConfig,
+		secret:       secret,
+		service:      name, // Default the service to the module name
+	}
+}
+
+func (slp *SecretLoadParams) Service(service string) *SecretLoadParams {
+	if service != "" {
+		slp.service = service
+	}
+	return slp
+}
+
+func (slp *SecretLoadParams) Load() {
+	configureSecret(
+		slp.globalConfig,
+		slp.service,
+		slp.secret,
+	)
+}
+
+type Secret struct {
+	Service  string
+	Secret   string
+	Username string
+	Store    string
+}
+
+func configureSecret(
+	globalConfig *config.Config,
+	service string,
+	secret *string,
+) {
+	if service == "" {
+		return
+	}
+
+	if secret == nil {
+		return
+	}
+
+	// Don't overwrite the secret if it was configured with yaml
+	if *secret != "" {
+		return
+	}
+
+	cred, err := FetchSecret(globalConfig, service)
+
+	if err != nil {
+		logger.Log(fmt.Sprintf("Loading secret failed: %s", err.Error()))
+		return
+	}
+
+	if cred == nil {
+		// No secret store configued.
+		return
+	}
+
+	if secret != nil && *secret == "" {
+		*secret = cred.Secret
+	}
+}
+
+// Fetch secret for `service`. Service is customarily a URL, but can be any
+// identifier uniquely used by wtf to identify the service, such as the name
+// of the module.  nil is returned if the secretStore global property is not
+// present or the secret is not found in that store.
+func FetchSecret(globalConfig *config.Config, service string) (*Secret, error) {
+	prog := newProgram(globalConfig)
+
+	if prog == nil {
+		// No secret store configured.
+		return nil, nil
+	}
+
+	cred, err := client.Get(prog.runner, service)
+
+	if err != nil {
+		return nil, fmt.Errorf("get %v from %v: %w", service, prog.store, err)
+	}
+
+	return &Secret{
+		Service:  cred.ServerURL,
+		Secret:   cred.Secret,
+		Username: cred.Username,
+		Store:    prog.store,
+	}, nil
+}
+
+func StoreSecret(globalConfig *config.Config, secret *Secret) error {
+	prog := newProgram(globalConfig)
+
+	if prog == nil {
+		return errors.New("cannot store secrets: wtf.secretStore is not configured")
+	}
+
+	cred := &credentials.Credentials{
+		ServerURL: secret.Service,
+		Username:  secret.Username,
+		Secret:    secret.Secret,
+	}
+
+	// docker-credential requires a username, but it isn't necessary for
+	// all services. Use a default if a username was not set.
+	if cred.Username == "" {
+		cred.Username = "default"
+	}
+
+	err := client.Store(prog.runner, cred)
+
+	if err != nil {
+		return fmt.Errorf("store %v: %w", prog.store, err)
+	}
+
+	return nil
+}
+
+type program struct {
+	store  string
+	runner client.ProgramFunc
+}
+
+func newProgram(globalConfig *config.Config) *program {
+	secretStore := globalConfig.UString("wtf.secretStore", "(none)")
+
+	if secretStore == "(none)" {
+		return nil
+	}
+
+	if secretStore == "" {
+		switch runtime.GOOS {
+		case "windows":
+			secretStore = "winrt"
+		case "darwin":
+			secretStore = "osxkeychain"
+		default:
+			secretStore = "secretservice"
+		}
+
+	}
+
+	return &program{
+		secretStore,
+		client.NewShellProgramFunc("docker-credential-" + secretStore),
+	}
+}

cfg/validations.go

@@ -18,7 +18,7 @@ func (vals *Validations) append(key string, posVal Validatable) {
 	vals.validations[key] = posVal
 }
 
-func (vals *Validations) valueFor(key string) int {
+func (vals *Validations) intValueFor(key string) int {
 	val := vals.validations[key]
 	if val != nil {
 		return val.IntValue()

cfg/validations_test.go

@@ -0,0 +1,38 @@
+package cfg
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+)
+
+var (
+	vals = NewValidations()
+)
+
+func Test_intValueFor(t *testing.T) {
+	vals.append("left", newPositionValidation("left", 3, nil))
+
+	tests := []struct {
+		name     string
+		key      string
+		expected int
+	}{
+		{
+			name:     "with valid key",
+			key:      "left",
+			expected: 3,
+		},
+		{
+			name:     "with invalid key",
+			key:      "cat",
+			expected: 0,
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			assert.Equal(t, tt.expected, vals.intValueFor(tt.key))
+		})
+	}
+}

checklist/checklist.go

@@ -22,7 +22,8 @@ func NewChecklist(checkedIcon, uncheckedIcon string) Checklist {
 
 /* -------------------- Exported Functions -------------------- */
 
-// Add creates a new item in the checklist
+// Add creates a new checklist item and prepends it onto the existing
+// list of items. The new one is at the start of the list
 func (list *Checklist) Add(checked bool, text string) {
 	item := NewChecklistItem(
 		checked,
@@ -48,9 +49,10 @@ func (list *Checklist) CheckedItems() []*ChecklistItem {
 }
 
 // Delete removes the selected item from the checklist
-func (list *Checklist) Delete() {
-	list.Items = append(list.Items[:list.selected], list.Items[list.selected+1:]...)
-	list.Prev()
+func (list *Checklist) Delete(selectedIndex int) {
+	if selectedIndex >= 0 && selectedIndex < len(list.Items) {
+		list.Items = append(list.Items[:selectedIndex], list.Items[selectedIndex+1:]...)
+	}
 }
 
 // IsSelectable returns true if the checklist has selectable items, false if it does not
@@ -76,35 +78,14 @@ func (list *Checklist) LongestLine() int {
 	return maxLen
 }
 
-func (list *Checklist) Selected() int {
-	return list.selected
-}
-
-// SelectedItem returns the currently-selected checklist item or nil if no item is selected
-func (list *Checklist) SelectedItem() *ChecklistItem {
-	if list.IsUnselectable() {
-		return nil
-	}
-
-	return list.Items[list.selected]
-}
-
-func (list *Checklist) SetSelectedByItem(selectableItem *ChecklistItem) {
+// IndexByItem returns the index of a giving item if found, otherwise returns 0 with ok set to false
+func (list *Checklist) IndexByItem(selectableItem *ChecklistItem) (index int, ok bool) {
 	for idx, item := range list.Items {
 		if item == selectableItem {
-			list.selected = idx
-			break
+			return idx, true
 		}
 	}
-}
-
-// Toggle switches the checked state of the currently-selected item
-func (list *Checklist) Toggle() {
-	if list.IsUnselectable() {
-		return
-	}
-
-	list.SelectedItem().Toggle()
+	return 0, false
 }
 
 // UncheckedItems returns a slice of all the unchecked items
@@ -125,65 +106,6 @@ func (list *Checklist) Unselect() {
 	list.selected = -1
 }
 
-// Update sets the text of the currently-selected item to the provided text
-func (list *Checklist) Update(text string) {
-	item := list.SelectedItem()
-
-	if item == nil {
-		return
-	}
-
-	item.Text = text
-}
-
-/* -------------------- Item Movement -------------------- */
-
-// Prev selects the previous item UP in the checklist
-func (list *Checklist) Prev() {
-	list.selected--
-	if list.selected < 0 {
-		list.selected = len(list.Items) - 1
-	}
-}
-
-// Next selects the next item DOWN in the checklist
-func (list *Checklist) Next() {
-	list.selected++
-	if list.selected >= len(list.Items) {
-		list.selected = 0
-	}
-}
-
-// Promote moves the selected item UP in the checklist
-func (list *Checklist) Promote() {
-	if list.IsUnselectable() {
-		return
-	}
-
-	k := list.selected - 1
-	if k < 0 {
-		k = len(list.Items) - 1
-	}
-
-	list.Swap(list.selected, k)
-	list.selected = k
-}
-
-// Demote moves the selected item DOWN in the checklist
-func (list *Checklist) Demote() {
-	if list.IsUnselectable() {
-		return
-	}
-
-	j := list.selected + 1
-	if j >= len(list.Items) {
-		j = 0
-	}
-
-	list.Swap(list.selected, j)
-	list.selected = j
-}
-
 /* -------------------- Sort Interface -------------------- */
 
 func (list *Checklist) Len() int {

checklist/checklist_item.go

@@ -1,7 +1,5 @@
 package checklist
 
-import ()
-
 // ChecklistItem is a module for creating generic checklist implementations
 // See 'Todo' for an implementation example
 type ChecklistItem struct {

checklist/checklist_item_test.go

@@ -10,8 +10,8 @@ func testChecklistItem() *ChecklistItem {
 	item := NewChecklistItem(
 		false,
 		"test",
-		"x",
-		" ",
+		"",
+		"",
 	)
 	return item
 }

checklist/checklist_test.go

@@ -0,0 +1,436 @@
+package checklist
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+)
+
+func Test_NewCheckist(t *testing.T) {
+	cl := NewChecklist("o", "-")
+
+	assert.IsType(t, Checklist{}, cl)
+	assert.Equal(t, "o", cl.checkedIcon)
+	assert.Equal(t, -1, cl.selected)
+	assert.Equal(t, "-", cl.uncheckedIcon)
+	assert.Equal(t, 0, len(cl.Items))
+}
+
+func Test_Add(t *testing.T) {
+	cl := NewChecklist("o", "-")
+	cl.Add(true, "test item")
+
+	assert.Equal(t, 1, len(cl.Items))
+}
+
+func Test_CheckedItems(t *testing.T) {
+	tests := []struct {
+		name        string
+		expectedLen int
+		checkedLen  int
+		before      func(cl *Checklist)
+	}{
+		{
+			name:        "with no items",
+			expectedLen: 0,
+			checkedLen:  0,
+			before:      func(cl *Checklist) {},
+		},
+		{
+			name:        "with no checked items",
+			expectedLen: 1,
+			checkedLen:  0,
+			before: func(cl *Checklist) {
+				cl.Add(false, "unchecked item")
+			},
+		},
+		{
+			name:        "with one checked item",
+			expectedLen: 2,
+			checkedLen:  1,
+			before: func(cl *Checklist) {
+				cl.Add(false, "unchecked item")
+				cl.Add(true, "checked item")
+			},
+		},
+		{
+			name:        "with multiple checked items",
+			expectedLen: 3,
+			checkedLen:  2,
+			before: func(cl *Checklist) {
+				cl.Add(false, "unchecked item")
+				cl.Add(true, "checked item 11")
+				cl.Add(true, "checked item 2")
+			},
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			cl := NewChecklist("o", "-")
+			tt.before(&cl)
+
+			assert.Equal(t, tt.expectedLen, len(cl.Items))
+			assert.Equal(t, tt.checkedLen, len(cl.CheckedItems()))
+		})
+	}
+}
+
+func Test_Delete(t *testing.T) {
+	tests := []struct {
+		name        string
+		idx         int
+		expectedLen int
+	}{
+		{
+			name:        "with valid index",
+			idx:         0,
+			expectedLen: 0,
+		},
+		{
+			name:        "with invalid index",
+			idx:         2,
+			expectedLen: 1,
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			cl := NewChecklist("o", "-")
+
+			cl.Add(true, "test item")
+			cl.Delete(tt.idx)
+
+			assert.Equal(t, tt.expectedLen, len(cl.Items))
+		})
+	}
+}
+
+func Test_IsSelectable(t *testing.T) {
+	tests := []struct {
+		name     string
+		selected int
+		expected bool
+	}{
+		{
+			name:     "nothing selected",
+			selected: -1,
+			expected: false,
+		},
+		{
+			name:     "valid selection",
+			selected: 1,
+			expected: true,
+		},
+		{
+			name:     "invalid selection",
+			selected: 3,
+			expected: false,
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			cl := NewChecklist("o", "-")
+			cl.Add(true, "test item 1")
+			cl.Add(false, "test item 2")
+
+			cl.selected = tt.selected
+
+			assert.Equal(t, tt.expected, cl.IsSelectable())
+		})
+	}
+}
+
+func Test_IsUnselectable(t *testing.T) {
+	tests := []struct {
+		name     string
+		selected int
+		expected bool
+	}{
+		{
+			name:     "nothing selected",
+			selected: -1,
+			expected: true,
+		},
+		{
+			name:     "valid selection",
+			selected: 1,
+			expected: false,
+		},
+		{
+			name:     "invalid selection",
+			selected: 3,
+			expected: true,
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			cl := NewChecklist("o", "-")
+			cl.Add(true, "test item 1")
+			cl.Add(false, "test item 2")
+
+			cl.selected = tt.selected
+
+			assert.Equal(t, tt.expected, cl.IsUnselectable())
+		})
+	}
+}
+
+func Test_LongestLine(t *testing.T) {
+	tests := []struct {
+		name        string
+		expectedLen int
+		before      func(cl *Checklist)
+	}{
+		{
+			name:        "with no items",
+			expectedLen: 0,
+			before:      func(cl *Checklist) {},
+		},
+		{
+			name:        "with different-length items",
+			expectedLen: 12,
+			before: func(cl *Checklist) {
+				cl.Add(true, "test item 1")
+				cl.Add(false, "test item 22")
+			},
+		},
+		{
+			name:        "with same-length items",
+			expectedLen: 11,
+			before: func(cl *Checklist) {
+				cl.Add(true, "test item 1")
+				cl.Add(false, "test item 2")
+			},
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			cl := NewChecklist("o", "-")
+			tt.before(&cl)
+
+			assert.Equal(t, tt.expectedLen, cl.LongestLine())
+		})
+	}
+}
+
+func Test_IndexByItem(t *testing.T) {
+	cl := NewChecklist("o", "-")
+	cl.Add(false, "unchecked item")
+	cl.Add(true, "checked item")
+
+	tests := []struct {
+		name        string
+		item        *ChecklistItem
+		expectedIdx int
+		expectedOk  bool
+	}{
+		{
+			name:        "with nil",
+			item:        nil,
+			expectedIdx: 0,
+			expectedOk:  false,
+		},
+		{
+			name:        "with valid item",
+			item:        cl.Items[1],
+			expectedIdx: 1,
+			expectedOk:  true,
+		},
+		{
+			name:        "with valid item",
+			item:        NewChecklistItem(false, "invalid", "x", " "),
+			expectedIdx: 0,
+			expectedOk:  false,
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+
+			idx, ok := cl.IndexByItem(tt.item)
+
+			assert.Equal(t, tt.expectedIdx, idx)
+			assert.Equal(t, tt.expectedOk, ok)
+		})
+	}
+}
+
+func Test_UncheckedItems(t *testing.T) {
+	tests := []struct {
+		name        string
+		expectedLen int
+		checkedLen  int
+		before      func(cl *Checklist)
+	}{
+		{
+			name:        "with no items",
+			expectedLen: 0,
+			checkedLen:  0,
+			before:      func(cl *Checklist) {},
+		},
+		{
+			name:        "with no unchecked items",
+			expectedLen: 1,
+			checkedLen:  0,
+			before: func(cl *Checklist) {
+				cl.Add(true, "unchecked item")
+			},
+		},
+		{
+			name:        "with one unchecked item",
+			expectedLen: 2,
+			checkedLen:  1,
+			before: func(cl *Checklist) {
+				cl.Add(false, "unchecked item")
+				cl.Add(true, "checked item")
+			},
+		},
+		{
+			name:        "with multiple unchecked items",
+			expectedLen: 3,
+			checkedLen:  2,
+			before: func(cl *Checklist) {
+				cl.Add(false, "unchecked item")
+				cl.Add(true, "checked item 11")
+				cl.Add(false, "checked item 2")
+			},
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			cl := NewChecklist("o", "-")
+			tt.before(&cl)
+
+			assert.Equal(t, tt.expectedLen, len(cl.Items))
+			assert.Equal(t, tt.checkedLen, len(cl.UncheckedItems()))
+		})
+	}
+}
+
+func Test_Unselect(t *testing.T) {
+	cl := NewChecklist("o", "-")
+	cl.Add(false, "unchecked item")
+
+	cl.selected = 0
+	assert.Equal(t, 0, cl.selected)
+
+	cl.Unselect()
+	assert.Equal(t, -1, cl.selected)
+}
+
+/* -------------------- Sort Interface -------------------- */
+
+func Test_Len(t *testing.T) {
+	tests := []struct {
+		name        string
+		expectedLen int
+		before      func(cl *Checklist)
+	}{
+		{
+			name:        "with no items",
+			expectedLen: 0,
+			before:      func(cl *Checklist) {},
+		},
+		{
+			name:        "with one item",
+			expectedLen: 1,
+			before: func(cl *Checklist) {
+				cl.Add(false, "unchecked item")
+			},
+		},
+		{
+			name:        "with multiple items",
+			expectedLen: 3,
+			before: func(cl *Checklist) {
+				cl.Add(false, "unchecked item")
+				cl.Add(true, "checked item 1")
+				cl.Add(false, "checked item 2")
+			},
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			cl := NewChecklist("o", "-")
+			tt.before(&cl)
+
+			assert.Equal(t, tt.expectedLen, cl.Len())
+		})
+	}
+}
+
+func Test_Less(t *testing.T) {
+	tests := []struct {
+		name     string
+		first    string
+		second   string
+		expected bool
+	}{
+		{
+			name:     "same",
+			first:    "",
+			second:   "",
+			expected: false,
+		},
+		{
+			name:     "last less",
+			first:    "beta",
+			second:   "alpha",
+			expected: true,
+		},
+		{
+			name:     "first less",
+			first:    "alpha",
+			second:   "beta",
+			expected: false,
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			cl := NewChecklist("o", "-")
+			cl.Add(false, tt.first)
+			cl.Add(false, tt.second)
+
+			assert.Equal(t, tt.expected, cl.Less(0, 1))
+		})
+	}
+}
+
+func Test_Swap(t *testing.T) {
+	tests := []struct {
+		name     string
+		first    string
+		second   string
+		expected bool
+	}{
+		{
+			name:   "same",
+			first:  "",
+			second: "",
+		},
+		{
+			name:   "last less",
+			first:  "alpha",
+			second: "beta",
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			cl := NewChecklist("o", "-")
+			cl.Add(false, tt.first)
+			cl.Add(false, tt.second)
+
+			cl.Swap(0, 1)
+
+			assert.Equal(t, tt.expected, cl.Items[0].Text == "beta")
+			assert.Equal(t, tt.expected, cl.Items[1].Text == "alpha")
+		})
+	}
+}

flags/flags.go

@@ -4,21 +4,41 @@ import (
 	"fmt"
 	"os"
 	"path/filepath"
+	"strings"
 
+	"github.com/chzyer/readline"
 	goFlags "github.com/jessevdk/go-flags"
 	"github.com/olebedev/config"
+	"github.com/wtfutil/wtf/cfg"
 	"github.com/wtfutil/wtf/help"
-	"github.com/wtfutil/wtf/utils"
 )
 
 // Flags is the container for command line flag data
 type Flags struct {
 	Config  string `short:"c" long:"config" optional:"yes" description:"Path to config file"`
-	Module  string `short:"m" long:"module" optional:"yes" description:"Display info about a specific module, i.e.: 'wtf -m=todo'"`
+	Module  string `short:"m" long:"module" optional:"yes" description:"Display info about a specific module, i.e.: 'wtfutil -m=todo'"`
 	Profile bool   `short:"p" long:"profile" optional:"yes" description:"Profile application memory usage"`
 	Version bool   `short:"v" long:"version" description:"Show version info"`
+	// Work-around go-flags misfeatures. If any sub-command is defined
+	// then `wtf` (no sub-commands, the common usage), is warned about.
+	Opt struct {
+		Cmd  string   `positional-arg-name:"command"`
+		Args []string `positional-arg-name:"args"`
+	} `positional-args:"yes"`
+
+	hasCustom bool
 }
 
+var EXTRA = `
+Commands:
+  save-secret <service>
+    service      Service URL or module name of secret.
+  Save a secret into the secret store. The secret will be prompted for.
+  Requires wtf.secretStore to be configured.  See individual modules for
+  information on what service and secret means for their configuration,
+  not all modules use secrets.
+`
+
 // NewFlags creates an instance of Flags
 func NewFlags() *Flags {
 	flags := Flags{}
@@ -34,21 +54,73 @@ func (flags *Flags) ConfigFilePath() string {
 
 // RenderIf displays special-case information based on the flags passed
 // in, if any flags were passed in
-func (flags *Flags) RenderIf(version string, config *config.Config) {
+func (flags *Flags) RenderIf(version, date string, config *config.Config) {
 	if flags.HasModule() {
 		help.Display(flags.Module, config)
 		os.Exit(0)
 	}
 
 	if flags.HasVersion() {
-		fmt.Println(version)
+		fmt.Printf("%s (%s)\n", version, date)
 		os.Exit(0)
 	}
+
+	if flags.Opt.Cmd == "" {
+		return
+	}
+
+	switch cmd := flags.Opt.Cmd; cmd {
+	case "save-secret":
+		var service, secret string
+		args := flags.Opt.Args
+
+		if len(args) < 1 || args[0] == "" {
+			fmt.Fprintf(os.Stderr, "save-secret: service required, see `%s --help`\n", os.Args[0])
+			os.Exit(1)
+		}
+
+		service = args[0]
+
+		if len(args) > 1 {
+			fmt.Fprintf(os.Stderr, "save-secret: too many arguments, see `%s --help`\n", os.Args[0])
+			os.Exit(1)
+		}
+
+		b, err := readline.Password("Secret: ")
+		if err != nil {
+			fmt.Fprintf(os.Stderr, "Error: %v\n", err)
+			os.Exit(1)
+		}
+		secret = string(b)
+		secret = strings.TrimSpace(secret)
+
+		if secret == "" {
+			fmt.Fprintf(os.Stderr, "save-secret: secret required, see `%s --help`\n", os.Args[0])
+			os.Exit(1)
+		}
+
+		err = cfg.StoreSecret(config, &cfg.Secret{
+			Service:  service,
+			Secret:   secret,
+			Username: "default",
+		})
+
+		if err != nil {
+			fmt.Fprintf(os.Stderr, "Saving secret for service %q: %s\n", service, err.Error())
+			os.Exit(1)
+		}
+
+		fmt.Printf("Saved secret for service %q\n", service)
+		os.Exit(0)
+	default:
+		fmt.Fprintf(os.Stderr, "Command `%s` is not supported, try `%s --help`\n", cmd, os.Args[0])
+		os.Exit(1)
+	}
 }
 
 // HasCustomConfig returns TRUE if a config path was passed in, FALSE if one was not
 func (flags *Flags) HasCustomConfig() bool {
-	return len(flags.Config) > 0
+	return flags.hasCustom
 }
 
 // HasModule returns TRUE if a module name was passed in, FALSE if one was not
@@ -58,7 +130,7 @@ func (flags *Flags) HasModule() bool {
 
 // HasVersion returns TRUE if the version flag was passed in, FALSE if it was not
 func (flags *Flags) HasVersion() bool {
-	return flags.Version == true
+	return flags.Version
 }
 
 // Parse parses the incoming flags
@@ -66,19 +138,23 @@ func (flags *Flags) Parse() {
 	parser := goFlags.NewParser(flags, goFlags.Default)
 	if _, err := parser.Parse(); err != nil {
 		if flagsErr, ok := err.(*goFlags.Error); ok && flagsErr.Type == goFlags.ErrHelp {
+			fmt.Println(EXTRA)
 			os.Exit(0)
 		}
 	}
 
-	// If no config file is explicitly passed in as a param,
-	// set the flag to the default config file
-	if !flags.HasCustomConfig() {
-		homeDir, err := utils.Home()
-		if err != nil {
-			fmt.Printf("Error: %v\n", err)
-			os.Exit(1)
-		}
-
-		flags.Config = filepath.Join(homeDir, ".config", "wtf", "config.yml")
+	// If we have a custom config, then we're done parsing parameters, we don't need to
+	// generate the default value
+	flags.hasCustom = (len(flags.Config) > 0)
+	if flags.hasCustom {
+		return
 	}
+
+	// If no config file is explicitly passed in as a param then set the flag to the default config file
+	configDir, err := cfg.WtfConfigDir()
+	if err != nil {
+		fmt.Printf("Error: %v\n", err)
+		os.Exit(1)
+	}
+	flags.Config = filepath.Join(configDir, "config.yml")
 }

generator/settings.tpl

@@ -0,0 +1,29 @@
+package {{(Lower .Name)}}
+
+import (
+	"github.com/olebedev/config"
+	"github.com/wtfutil/wtf/cfg"
+)
+
+const (
+	defaultFocusable = false
+	defaultTitle     = "{{(.Name)}}"
+)
+
+// Settings defines the configuration properties for this module
+type Settings struct {
+	common *cfg.Common
+
+    // Define your settings attributes here
+}
+
+// NewSettingsFromYAML creates a new settings instance from a YAML config block
+func NewSettingsFromYAML(name string, ymlConfig *config.Config, globalConfig *config.Config) *Settings {
+	settings := Settings{
+        common: cfg.NewCommonSettingsFromModule(name, defaultTitle, defaultFocusable, ymlConfig, globalConfig),
+
+        // Configure your settings attributes here. See http://github.com/olebedev/config for type details
+	}
+
+	return &settings
+}

generator/textwidget.go

@@ -36,17 +36,41 @@ func main() {
 		widgetName,
 	}
 
-	tpl, _ := template.New("textwidget.tpl").Funcs(template.FuncMap{
-		"Lower": strings.ToLower,
-		"Title": strings.Title,
-	}).ParseFiles("generator/textwidget.tpl")
+	createModuleDirectory(data)
 
-	err := os.Mkdir(strings.ToLower(widgetName), os.ModePerm)
+	generateWidgetFile(data)
+	generateSettingsFile(data)
+}
+
+/* -------------------- Unexported Functions -------------------- */
+
+func createModuleDirectory(data struct{ Name string }) {
+	err := os.MkdirAll(strings.ToLower(fmt.Sprintf("modules/%s", data.Name)), os.ModePerm)
 	if err != nil {
 		fmt.Println(err.Error())
 	}
+}
 
-	out, err := os.Create(fmt.Sprintf("%s/widget.go", strings.ToLower(widgetName)))
+func generateWidgetFile(data struct{ Name string }) {
+	tpl, _ := template.New("textwidget.tpl").Funcs(template.FuncMap{
+		"Lower": strings.ToLower,
+	}).ParseFiles("generator/textwidget.tpl")
+
+	out, err := os.Create(fmt.Sprintf("modules/%s/widget.go", strings.ToLower(data.Name)))
+	if err != nil {
+		fmt.Println(err.Error())
+	}
+	defer out.Close()
+
+	tpl.Execute(out, data)
+}
+
+func generateSettingsFile(data struct{ Name string }) {
+	tpl, _ := template.New("settings.tpl").Funcs(template.FuncMap{
+		"Lower": strings.ToLower,
+	}).ParseFiles("generator/settings.tpl")
+
+	out, err := os.Create(fmt.Sprintf("modules/%s/settings.go", strings.ToLower(data.Name)))
 	if err != nil {
 		fmt.Println(err.Error())
 	}

generator/textwidget.tpl

@@ -1,56 +1,45 @@
-// Package {{(Lower .Name)}}
 package {{(Lower .Name)}}
 
 import (
-	"strconv"
-
-	"github.com/gdamore/tcell"
 	"github.com/rivo/tview"
-	"github.com/wtfutil/wtf/wtf"
+	"github.com/wtfutil/wtf/view"
 )
 
-const HelpText = `
- Keyboard commands for {{(Title .Name)}}:
-`
-
+// Widget is the container for your module's data
 type Widget struct {
-	wtf.HelpfulWidget
-	wtf.KeyboardWidget
-	wtf.TextWidget
+	view.TextWidget
 
 	settings *Settings
 }
 
-func NewWidget(app *tview.Application, pages *tview.Pages, settings *Settings) *Widget {
+// NewWidget creates and returns an instance of Widget
+func NewWidget(tviewApp *tview.Application, pages *tview.Pages, settings *Settings) *Widget {
 	widget := Widget{
-		HelpfulWidget: wtf.NewHelpfulWidget(app, pages, HelpText),
-		KeyboardWidget: wtf.NewKeyboardWidget(),
-		TextWidget:    wtf.NewTextWidget(app, settings.common, false),
+		TextWidget: view.NewTextWidget(tviewApp, settings.common),
 
 		settings: settings,
 	}
 
-  widget.initializeKeyboardControls()
-	widget.View.SetInputCapture(widget.InputCapture)
-
-	widget.View.SetScrollable(true)
-	widget.View.SetRegions(true)
-
-	widget.HelpfulWidget.SetView(widget.View)
-
 	return &widget
 }
 
 /* -------------------- Exported Functions -------------------- */
 
+// Refresh updates the onscreen contents of the widget
 func (widget *Widget) Refresh() {
 
-	// The last call should always be to the display function
-  widget.display()
+    // The last call should always be to the display function
+    widget.display()
 }
 
 /* -------------------- Unexported Functions -------------------- */
 
-func (widget *Widget) display() {
-  widget.Redraw(widget.CommonSettings().Title, "Some text", false)
+func (widget *Widget) content() string {
+	return "This is my widget"
 }
+
+func (widget *Widget) display() {
+	widget.Redraw(func() (string, string, bool) {
+		return widget.CommonSettings().Title, widget.content(), false
+	})
+}

go.mod

@@ -1,57 +1,86 @@
 module github.com/wtfutil/wtf
 
-go 1.12
+go 1.16
 
 require (
-	cloud.google.com/go v0.40.0 // indirect
-	code.cloudfoundry.org/bytefmt v0.0.0-20180906201452-2aa6f33b730c
-	github.com/PagerDuty/go-pagerduty v0.0.0-20190503230806-cf1437c7c8d6
-	github.com/StackExchange/wmi v0.0.0-20190523213609-cbe66965904d // indirect
-	github.com/adlio/trello v1.0.0
-	github.com/alecthomas/chroma v0.6.3
-	github.com/alecthomas/repr v0.0.0-20181024024818-d37bc2a10ba1 // indirect
-	github.com/andygrunwald/go-gerrit v0.0.0-20190625080919-64931d233c2d
+	bitbucket.org/mikehouston/asana-go v0.0.0-20201102222432-715318d0343a
+	code.cloudfoundry.org/bytefmt v0.0.0-20190819182555-854d396b647c
+	github.com/Azure/go-autorest v11.1.2+incompatible // indirect
+	github.com/Microsoft/go-winio v0.4.14 // indirect
+	github.com/PagerDuty/go-pagerduty v0.0.0-20191002190746-f60f4fc45222
+	github.com/StackExchange/wmi v0.0.0-20190523213315-cbe66965904d // indirect
+	github.com/VictorAvelar/devto-api-go v1.0.0
+	github.com/adlio/trello v1.8.0
+	github.com/alecthomas/chroma v0.8.1
+	github.com/andygrunwald/go-gerrit v0.0.0-20190825170856-5959a9bf9ff8
 	github.com/briandowns/openweathermap v0.0.0-20180804155945-5f41b7c9d92d
-	github.com/cenkalti/backoff v2.2.0+incompatible // indirect
-	github.com/darkSasori/todoist v0.0.0-20180703032645-ec6b38b374ab
+	github.com/cenkalti/backoff v2.2.1+incompatible // indirect
+	github.com/chzyer/readline v0.0.0-20180603132655-2972be24d48e
+	github.com/creack/pty v1.1.11
+	github.com/digitalocean/godo v1.52.0
+	github.com/docker/distribution v2.7.1+incompatible // indirect
+	github.com/docker/docker v1.13.1
+	github.com/docker/docker-credential-helpers v0.6.3
+	github.com/docker/go-connections v0.4.0 // indirect
+	github.com/docker/go-units v0.4.0 // indirect
 	github.com/dustin/go-humanize v1.0.0
-	github.com/gdamore/tcell v1.1.4
+	github.com/gdamore/tcell v1.4.0
 	github.com/go-ole/go-ole v1.2.4 // indirect
-	github.com/godbus/dbus v5.0.1+incompatible // indirect
-	github.com/golang/glog v0.0.0-20170312005925-543a34c32e4d // indirect
-	github.com/google/go-github/v26 v26.0.9
-	github.com/hashicorp/go-cleanhttp v0.5.1 // indirect
+	github.com/godbus/dbus v4.1.0+incompatible // indirect
+	github.com/google/go-github/v32 v32.1.0
+	github.com/gophercloud/gophercloud v0.5.0 // indirect
 	github.com/hekmon/cunits v2.0.1+incompatible // indirect
 	github.com/hekmon/transmissionrpc v0.0.0-20190525133028-1d589625bacd
+	github.com/jedib0t/go-pretty/v6 v6.1.0
 	github.com/jessevdk/go-flags v1.4.0
-	github.com/logrusorgru/aurora v0.0.0-20190428105938-cea283e61946
-	github.com/mattn/go-isatty v0.0.8 // indirect
-	github.com/mmcdole/gofeed v1.0.0-beta2.0.20190420154928-0e68beaf6fdf
+	github.com/lib/pq v1.2.0 // indirect
+	github.com/logrusorgru/aurora v0.0.0-20190803045625-94edacc10f9b
+	github.com/microsoft/azure-devops-go-api/azuredevops v0.0.0-20191014190507-26902c1d4325
+	github.com/mmcdole/gofeed v1.1.0
+	github.com/nicklaw5/helix v0.7.0
 	github.com/olebedev/config v0.0.0-20190528211619-364964f3a8e4
-	github.com/pkg/profile v1.3.0
-	github.com/radovskyb/watcher v1.0.6
-	github.com/rivo/tview v0.0.0-20190721135419-23dc8a0944e4
-	github.com/rivo/uniseg v0.1.0 // indirect
-	github.com/shirou/gopsutil v2.18.12+incompatible
-	github.com/sticreations/spotigopher v0.0.0-20181009182052-98632f6f94b0
-	github.com/stretchr/testify v1.3.0
-	github.com/xanzy/go-gitlab v0.18.0
-	github.com/yfronto/newrelic v0.0.0-20180622232530-7c9c2852e8f9
-	github.com/zmb3/spotify v0.0.0-20190520155326-158b1863f5b5
-	github.com/zorkian/go-datadog-api v2.21.0+incompatible
-	go.opencensus.io v0.22.0 // indirect
-	golang.org/x/crypto v0.0.0-20190701094942-4def268fd1a4 // indirect
-	golang.org/x/net v0.0.0-20190628185345-da137c7871d7 // indirect
-	golang.org/x/oauth2 v0.0.0-20190614102709-0f29369cfe45
-	golang.org/x/sync v0.0.0-20190427212804-112230192c58 // indirect
-	golang.org/x/sys v0.0.0-20190730174312-6a60838ec25 // indirect
-	golang.org/x/tools v0.0.0-20190710184609-286818132824 // indirect
-	google.golang.org/api v0.7.0
-	google.golang.org/appengine v1.6.1 // indirect
-	google.golang.org/genproto v0.0.0-20190627203621-eb59cef1c072 // indirect
-	google.golang.org/grpc v1.21.1 // indirect
-	gopkg.in/jarcoal/httpmock.v1 v1.0.0-20190314184232-a8ac0a50d0b5 // indirect
-	gopkg.in/yaml.v2 v2.2.2
-	k8s.io/apimachinery v0.0.0-20190802060556-6fa4771c83b3
-	k8s.io/client-go v12.0.0+incompatible
+	github.com/olekukonko/tablewriter v0.0.4
+	github.com/onsi/ginkgo v1.12.0 // indirect
+	github.com/onsi/gomega v1.9.0 // indirect
+	github.com/ovh/cds v0.0.0-20201014170613-39429542624d
+	github.com/pborman/uuid v1.2.0 // indirect
+	github.com/piquette/finance-go v1.0.0
+	github.com/pkg/errors v0.9.1
+	github.com/pkg/profile v1.5.0
+	github.com/radovskyb/watcher v1.0.7
+	github.com/rivo/tview v0.0.0-20200108161608-1316ea7a4b35
+	github.com/shirou/gopsutil v2.20.9+incompatible
+	github.com/shopspring/decimal v1.2.0 // indirect
+	github.com/shurcooL/githubv4 v0.0.0-20200802174311-f27d2ca7f6d5
+	github.com/shurcooL/graphql v0.0.0-20181231061246-d48a9a75455f // indirect
+	github.com/spf13/cobra v0.0.5 // indirect
+	github.com/spf13/pflag v1.0.5 // indirect
+	github.com/spf13/viper v1.6.1 // indirect
+	github.com/ssor/bom v0.0.0-20170718123548-6386211fdfcf // indirect
+	github.com/stretchr/testify v1.6.1
+	github.com/wtfutil/spotigopher v0.0.0-20191127141047-7d8168fe103a
+	github.com/wtfutil/todoist v0.0.2-0.20191216004217-0ec29ceda61a
+	github.com/xanzy/go-gitlab v0.39.0
+	github.com/zmb3/spotify v0.0.0-20191010212056-e12fb981aacb
+	github.com/zorkian/go-datadog-api v2.30.0+incompatible
+	golang.org/x/oauth2 v0.0.0-20200902213428-5d25da1a8d43
+	golang.org/x/sync v0.0.0-20200625203802-6e8e738ad208
+	golang.org/x/text v0.3.4
+	google.golang.org/api v0.33.0
+	gopkg.in/jarcoal/httpmock.v1 v1.0.0-20181110093347-3be5f16b70eb // indirect
+	gopkg.in/yaml.v2 v2.3.0
+	gotest.tools v2.2.0+incompatible
+	jaytaylor.com/html2text v0.0.0-20200412013138-3577fbdbcff7
+	k8s.io/apimachinery v0.0.0-20190223094358-dcb391cde5ca
+	k8s.io/client-go v10.0.0+incompatible
 )
+
+// These hacks are in place to work around this bug in coreos/etcd/proxy/grpcproxy > v1.30.0 that fails
+// with this error:
+//
+//    google.golang.org/grpc/naming: module google.golang.org/grpc@latest found (v1.31.1), but does not contain package google.golang.org/grpc/naming
+//
+// See here for more details: https://github.com/etcd-io/etcd/issues/12124
+replace google.golang.org/grpc v1.30.0 => google.golang.org/grpc v1.29.1
+
+replace google.golang.org/grpc v1.31.0 => google.golang.org/grpc v1.29.1

help/help.go

@@ -18,7 +18,11 @@ func Display(moduleName string, cfg *config.Config) {
 }
 
 func helpFor(moduleName string, cfg *config.Config) string {
-	cfg.Set("wtf.mods."+moduleName+".enabled", true)
+	err := cfg.Set("wtf.mods."+moduleName+".enabled", true)
+	if err != nil {
+		return ""
+	}
+
 	widget := app.MakeWidget(nil, nil, moduleName, cfg)
 
 	// Since we are forcing enabled config, if no module

logger/log.go

@@ -4,8 +4,6 @@ import (
 	"log"
 	"os"
 	"path/filepath"
-
-	"github.com/wtfutil/wtf/utils"
 )
 
 /* -------------------- Exported Functions -------------------- */
@@ -19,7 +17,7 @@ func Log(msg string) {
 	if err != nil {
 		log.Fatalf("error opening file: %v", err)
 	}
-	defer f.Close()
+	defer func() { _ = f.Close() }()
 
 	log.SetOutput(f)
 	log.Println(msg)
@@ -30,7 +28,7 @@ func LogFileMissing() bool {
 }
 
 func LogFilePath() string {
-	dir, err := utils.Home()
+	dir, err := os.UserHomeDir()
 	if err != nil {
 		return ""
 	}

main.go

@@ -1,78 +1,65 @@
 package main
 
-// Generators
-// To generate the skeleton for a new TextWidget use 'WTF_WIDGET_NAME=MySuperAwesomeWidget go generate -run=text
-//go:generate -command text go run generator/textwidget.go
-//go:generate text
-
 import (
 	"fmt"
 	"log"
 	"os"
 
+	// Blank import of tzdata embeds the timezone database to allow Windows hosts to find timezone
+	// information even if the timezone database is not available on the local system. See release
+	// notes at https://golang.org/doc/go1.15#time/tzdata for details. This prevents "no timezone
+	// data available" errors in clocks module.
+	_ "time/tzdata"
+
 	"github.com/logrusorgru/aurora"
-	"github.com/olebedev/config"
 	"github.com/pkg/profile"
 
-	"github.com/rivo/tview"
 	"github.com/wtfutil/wtf/app"
 	"github.com/wtfutil/wtf/cfg"
 	"github.com/wtfutil/wtf/flags"
 	"github.com/wtfutil/wtf/utils"
+	"github.com/wtfutil/wtf/wtf"
 )
 
-var tviewApp *tview.Application
-
 var (
-	commit  = "dev"
 	date    = "dev"
 	version = "dev"
 )
 
-/* -------------------- Functions -------------------- */
-
-func setTerm(config *config.Config) {
-	term := config.UString("wtf.term", os.Getenv("TERM"))
-	err := os.Setenv("TERM", term)
-	if err != nil {
-		fmt.Printf("\n%s Failed to set $TERM to %s.\n", aurora.Red("ERROR"), aurora.Yellow(term))
-		os.Exit(1)
-	}
-}
-
 /* -------------------- Main -------------------- */
 
 func main() {
 	log.SetFlags(log.LstdFlags | log.Lshortfile)
 
-	// Manage the configuration directories and config file
-
 	// Parse and handle flags
 	flags := flags.NewFlags()
 	flags.Parse()
 
-	hasCustom := flags.HasCustomConfig()
-	cfg.Initialize(hasCustom)
-
 	// Load the configuration file
-	config := cfg.LoadWtfConfigFile(flags.ConfigFilePath(), hasCustom)
-	flags.RenderIf(version, config)
+	cfg.Initialize(flags.HasCustomConfig())
+	config := cfg.LoadWtfConfigFile(flags.ConfigFilePath())
+
+	wtf.SetTerminal(config)
+
+	flags.RenderIf(version, date, config)
 
 	if flags.Profile {
 		defer profile.Start(profile.MemProfile).Stop()
 	}
 
-	utils.Init(config.UString("wtf.openFileUtil", "open"))
+	openFileUtil := config.UString("wtf.openFileUtil", "open")
+	openURLUtil := utils.ToStrs(config.UList("wtf.openUrlUtil", []interface{}{}))
+	utils.Init(openFileUtil, openURLUtil)
 
-	setTerm(config)
+	/* Initialize the App Manager */
+	appMan := app.NewAppManager()
+	appMan.MakeNewWtfApp(config, flags.Config)
 
-	// Build the application
-	tviewApp = tview.NewApplication()
-	wtfApp := app.NewWtfApp(tviewApp, config, flags.Config, hasCustom)
-	wtfApp.Start()
-
-	if err := tviewApp.Run(); err != nil {
+	currentApp, err := appMan.Current()
+	if err != nil {
 		fmt.Printf("\n%s %v\n", aurora.Red("ERROR"), err)
 		os.Exit(1)
 	}
+
+	currentApp.Run()
 }

modules/asana/client.go

@@ -0,0 +1,280 @@
+package asana
+
+import (
+	"fmt"
+	"strings"
+	"time"
+
+	asana "bitbucket.org/mikehouston/asana-go"
+)
+
+func fetchTasksFromProject(token, projectId, mode string) ([]*TaskItem, error) {
+	taskItems := []*TaskItem{}
+	uidToName := make(map[string]string)
+
+	client := asana.NewClientWithAccessToken(token)
+
+	uid, err := getCurrentUserId(client, mode)
+	if err != nil {
+		return nil, err
+	}
+
+	q := &asana.TaskQuery{
+		Project: projectId,
+	}
+
+	fetchedTasks, _, err := getTasksFromAsana(client, q)
+	if err != nil {
+		return nil, fmt.Errorf("error fetching tasks: %s", err)
+	}
+
+	processFetchedTasks(client, &fetchedTasks, &taskItems, &uidToName, mode, projectId, uid)
+
+	return taskItems, nil
+}
+
+func fetchTasksFromProjectSections(token, projectId string, sections []string, mode string) ([]*TaskItem, error) {
+	taskItems := []*TaskItem{}
+	uidToName := make(map[string]string)
+
+	client := asana.NewClientWithAccessToken(token)
+
+	uid, err := getCurrentUserId(client, mode)
+	if err != nil {
+		return nil, err
+	}
+
+	p := &asana.Project{
+		ID: projectId,
+	}
+
+	for _, section := range sections {
+
+		sectionId, err := findSection(client, p, section)
+		if err != nil {
+			return nil, fmt.Errorf("error fetching tasks: %s", err)
+		}
+
+		q := &asana.TaskQuery{
+			Section: sectionId,
+		}
+
+		fetchedTasks, _, err := getTasksFromAsana(client, q)
+		if err != nil {
+			return nil, fmt.Errorf("error fetching tasks: %s", err)
+		}
+
+		if len(fetchedTasks) > 0 {
+			taskItem := &TaskItem{
+				name:     section,
+				taskType: TASK_SECTION,
+			}
+
+			taskItems = append(taskItems, taskItem)
+		}
+
+		processFetchedTasks(client, &fetchedTasks, &taskItems, &uidToName, mode, projectId, uid)
+
+	}
+
+	return taskItems, nil
+}
+
+func fetchTasksFromWorkspace(token, workspaceId, mode string) ([]*TaskItem, error) {
+	taskItems := []*TaskItem{}
+	uidToName := make(map[string]string)
+
+	client := asana.NewClientWithAccessToken(token)
+
+	uid, err := getCurrentUserId(client, mode)
+	if err != nil {
+		return nil, err
+	}
+
+	q := &asana.TaskQuery{
+		Workspace: workspaceId,
+		Assignee:  "me",
+	}
+
+	fetchedTasks, _, err := getTasksFromAsana(client, q)
+	if err != nil {
+		return nil, fmt.Errorf("error fetching tasks: %s", err)
+	}
+
+	processFetchedTasks(client, &fetchedTasks, &taskItems, &uidToName, mode, workspaceId, uid)
+
+	return taskItems, nil
+
+}
+
+func toggleTaskCompletionById(token, taskId string) error {
+	client := asana.NewClientWithAccessToken(token)
+
+	t := &asana.Task{
+		ID: taskId,
+	}
+
+	err := t.Fetch(client)
+	if err != nil {
+		return fmt.Errorf("error fetching task: %s", err)
+	}
+
+	updateReq := &asana.UpdateTaskRequest{}
+
+	if *t.Completed {
+		f := false
+		updateReq.Completed = &f
+	} else {
+		t := true
+		updateReq.Completed = &t
+	}
+
+	err = t.Update(client, updateReq)
+	if err != nil {
+		return fmt.Errorf("error updating task: %s", err)
+	}
+
+	return nil
+}
+
+func processFetchedTasks(client *asana.Client, fetchedTasks *[]*asana.Task, taskItems *[]*TaskItem, uidToName *map[string]string, mode, projectId, uid string) {
+
+	for _, task := range *fetchedTasks {
+		switch {
+		case strings.HasSuffix(mode, "_all"):
+			if task.Assignee != nil {
+				// Check if we have already looked up this user
+				if assigneeName, ok := (*uidToName)[task.Assignee.ID]; ok {
+					task.Assignee.Name = assigneeName
+				} else {
+					// We haven't looked up this user before, perform the lookup now
+					assigneeName, err := getOtherUserEmail(client, task.Assignee.ID)
+					if err != nil {
+						task.Assignee.Name = "Error"
+					}
+					(*uidToName)[task.Assignee.ID] = assigneeName
+					task.Assignee.Name = assigneeName
+				}
+			} else {
+				task.Assignee = &asana.User{
+					Name: "Unassigned",
+				}
+			}
+			taskItem := buildTaskItem(task, projectId)
+			(*taskItems) = append((*taskItems), taskItem)
+		case !strings.HasSuffix(mode, "_all") && task.Assignee != nil && task.Assignee.ID == uid:
+			taskItem := buildTaskItem(task, projectId)
+			(*taskItems) = append((*taskItems), taskItem)
+		}
+	}
+}
+
+func buildTaskItem(task *asana.Task, projectId string) *TaskItem {
+	dueOnString := ""
+	if task.DueOn != nil {
+		dueOn := time.Time(*task.DueOn)
+		currentYear, _, _ := time.Now().Date()
+		if currentYear != dueOn.Year() {
+			dueOnString = dueOn.Format("Jan 2 2006")
+		} else {
+			dueOnString = dueOn.Format("Jan 2")
+		}
+	}
+
+	assignString := ""
+	if task.Assignee != nil {
+		assignString = task.Assignee.Name
+	}
+
+	taskItem := &TaskItem{
+		name:        task.Name,
+		id:          task.ID,
+		numSubtasks: task.NumSubtasks,
+		dueOn:       dueOnString,
+		url:         fmt.Sprintf("https://app.asana.com/0/%s/%s/f", projectId, task.ID),
+		taskType:    TASK_TYPE,
+		completed:   *task.Completed,
+		assignee:    assignString,
+	}
+
+	return taskItem
+
+}
+
+func getOtherUserEmail(client *asana.Client, uid string) (string, error) {
+	if uid == "" {
+		return "", fmt.Errorf("missing uid")
+	}
+
+	u := &asana.User{
+		ID: uid,
+	}
+
+	err := u.Fetch(client, nil)
+	if err != nil {
+		return "", fmt.Errorf("error fetching user: %s", err)
+	}
+
+	return u.Email, nil
+}
+
+func getCurrentUserId(client *asana.Client, mode string) (string, error) {
+	if strings.HasSuffix(mode, "_all") {
+		return "", nil
+	}
+	u, err := client.CurrentUser()
+	if err != nil {
+		return "", fmt.Errorf("error getting current user: %s", err)
+	}
+
+	return u.ID, nil
+}
+
+func findSection(client *asana.Client, project *asana.Project, sectionName string) (string, error) {
+	sectionId := ""
+
+	sections, _, err := project.Sections(client, &asana.Options{
+		Limit: 100,
+	})
+	if err != nil {
+		return "", fmt.Errorf("error getting sections: %s", err)
+	}
+
+	for _, section := range sections {
+		if section.Name == sectionName {
+			sectionId = section.ID
+			break
+		}
+	}
+
+	if sectionId == "" {
+		return "", fmt.Errorf("we didn't find the section %s", sectionName)
+	}
+
+	return sectionId, nil
+}
+
+func getTasksFromAsana(client *asana.Client, q *asana.TaskQuery) ([]*asana.Task, bool, error) {
+	moreTasks := false
+
+	tasks, np, err := client.QueryTasks(q, &asana.Options{
+		Limit: 100,
+		Fields: []string{
+			"assignee",
+			"name",
+			"num_subtasks",
+			"due_on",
+			"completed",
+		},
+	})
+
+	if err != nil {
+		return nil, false, fmt.Errorf("error querying tasks: %s", err)
+	}
+
+	if np != nil {
+		moreTasks = true
+	}
+
+	return tasks, moreTasks, nil
+}

modules/asana/keyboard.go

@@ -0,0 +1,20 @@
+package asana
+
+import "github.com/gdamore/tcell"
+
+func (widget *Widget) initializeKeyboardControls() {
+	widget.InitializeHelpTextKeyboardControl(widget.ShowHelp)
+	widget.InitializeRefreshKeyboardControl(widget.Refresh)
+
+	widget.SetKeyboardChar("j", widget.Next, "Select next task")
+	widget.SetKeyboardChar("k", widget.Prev, "Select previous task")
+	widget.SetKeyboardChar("q", widget.Unselect, "Unselect task")
+	widget.SetKeyboardChar("o", widget.openTask, "Open task in browser")
+	widget.SetKeyboardChar("x", widget.toggleTaskCompletion, "Toggles the task's completion state")
+	widget.SetKeyboardChar("?", widget.ShowHelp, "Shows help")
+
+	widget.SetKeyboardKey(tcell.KeyDown, widget.Next, "Select next task")
+	widget.SetKeyboardKey(tcell.KeyUp, widget.Prev, "Select previous task")
+	widget.SetKeyboardKey(tcell.KeyEsc, widget.Unselect, "Unselect task")
+	widget.SetKeyboardKey(tcell.KeyEnter, widget.openTask, "Open task in browser")
+}

modules/asana/settings.go

@@ -0,0 +1,48 @@
+package asana
+
+import (
+	"github.com/olebedev/config"
+	"github.com/wtfutil/wtf/cfg"
+	"github.com/wtfutil/wtf/utils"
+)
+
+const (
+	defaultFocusable = true
+	defaultTitle     = "Asana"
+)
+
+type Settings struct {
+	*cfg.Common
+
+	projectId string `help:"The Asana Project ID. If the mode is 'project' or 'project_sections' this is required to known which Asana Project to pull your tasks from" values:"A valid Asana Project ID string" optional:"true"`
+
+	workspaceId string `help:"The Asana Workspace ID. If mode is 'workspace' this is required" values:"A valid Asana Workspace ID string" optional:"true"`
+
+	sections []string `help:"The Asana Section Labels to fetch from the Project. Required if the mode is 'project_sections'" values:"An array of Asana Section Label strings" optional:"true"`
+
+	allUsers bool `help:"Fetch tasks for all users, defaults to false" values:"bool" optional:"true"`
+
+	mode string `help:"What mode to query Asana, 'project', 'project_sections', 'workspace'" values:"A string with either 'project', 'project_sections' or 'workspace'"`
+
+	hideComplete bool `help:"Hide completed tasks, defaults to false" values:"bool" optional:"true"`
+
+	apiKey string `help:"Your Asana Personal Access Token. Leave this blank to use the WTF_ASANA_TOKEN environment variable." values:"Your Asana Personal Access Token as a string" optional:"true"`
+
+	token string
+}
+
+func NewSettingsFromYAML(name string, ymlConfig *config.Config, globalConfig *config.Config) *Settings {
+	settings := Settings{
+		Common: cfg.NewCommonSettingsFromModule(name, defaultTitle, defaultFocusable, ymlConfig,
+			globalConfig),
+		projectId:    ymlConfig.UString("projectId", ""),
+		apiKey:       ymlConfig.UString("apiKey", ""),
+		workspaceId:  ymlConfig.UString("workspaceId", ""),
+		sections:     utils.ToStrs(ymlConfig.UList("sections")),
+		allUsers:     ymlConfig.UBool("allUsers", false),
+		mode:         ymlConfig.UString("mode", ""),
+		hideComplete: ymlConfig.UBool("hideComplete", false),
+	}
+
+	return &settings
+}

modules/asana/widget.go

@@ -0,0 +1,259 @@
+package asana
+
+import (
+	"fmt"
+	"os"
+	"strings"
+	"sync"
+
+	"github.com/rivo/tview"
+	"github.com/wtfutil/wtf/utils"
+	"github.com/wtfutil/wtf/view"
+)
+
+type TaskType int
+
+const (
+	TASK_TYPE TaskType = iota
+	TASK_SECTION
+	TASK_BREAK
+)
+
+type TaskItem struct {
+	name        string
+	numSubtasks int32
+	dueOn       string
+	id          string
+	url         string
+	taskType    TaskType
+	completed   bool
+	assignee    string
+}
+
+type Widget struct {
+	view.ScrollableWidget
+
+	tasks []*TaskItem
+
+	mu       sync.Mutex
+	err      error
+	settings *Settings
+	tviewApp *tview.Application
+}
+
+func NewWidget(tviewApp *tview.Application, pages *tview.Pages, settings *Settings) *Widget {
+	widget := &Widget{
+		ScrollableWidget: view.NewScrollableWidget(tviewApp, pages, settings.Common),
+
+		tviewApp: tviewApp,
+		settings: settings,
+	}
+
+	widget.SetRenderFunction(widget.Render)
+	widget.initializeKeyboardControls()
+
+	return widget
+}
+
+/* -------------------- Exported Functions -------------------- */
+
+func (widget *Widget) Refresh() {
+	widget.tasks = nil
+	widget.err = nil
+	widget.SetItemCount(0)
+
+	widget.mu.Lock()
+	defer widget.mu.Unlock()
+	tasks, err := widget.Fetch(
+		widget.settings.workspaceId,
+		widget.settings.projectId,
+		widget.settings.mode,
+		widget.settings.sections,
+		widget.settings.allUsers,
+	)
+	if err != nil {
+		widget.err = err
+	} else {
+		widget.tasks = tasks
+		widget.SetItemCount(len(tasks))
+	}
+
+	widget.Render()
+}
+
+func (widget *Widget) Render() {
+	widget.Redraw(widget.content)
+}
+
+func (widget *Widget) Fetch(workspaceId, projectId, mode string, sections []string, allUsers bool) ([]*TaskItem, error) {
+
+	availableModes := map[string]interface{}{
+		"project":          nil,
+		"project_sections": nil,
+		"workspace":        nil,
+	}
+
+	if _, ok := availableModes[mode]; !ok {
+		return nil, fmt.Errorf("missing mode, or mode is invalid - please set to project, project_sections or workspace")
+	}
+
+	if widget.settings.apiKey != "" {
+		widget.settings.token = widget.settings.apiKey
+	} else {
+		widget.settings.token = os.Getenv("WTF_ASANA_TOKEN")
+	}
+
+	if widget.settings.token == "" {
+		return nil, fmt.Errorf("missing environment variable token or apikey config")
+	}
+
+	subMode := mode
+	if allUsers && mode != "workspace" {
+		subMode += "_all"
+	}
+
+	if projectId == "" && strings.HasPrefix(subMode, "project") {
+		return nil, fmt.Errorf("missing project id")
+	}
+
+	if workspaceId == "" && subMode == "workspace" {
+		return nil, fmt.Errorf("missing workspace id")
+	}
+
+	var tasks []*TaskItem
+	var err error
+
+	switch {
+	case strings.HasPrefix(subMode, "project_sections"):
+		tasks, err = fetchTasksFromProjectSections(widget.settings.token, projectId, sections, subMode)
+	case strings.HasPrefix(subMode, "project"):
+		tasks, err = fetchTasksFromProject(widget.settings.token, projectId, subMode)
+	case subMode == "workspace":
+		tasks, err = fetchTasksFromWorkspace(widget.settings.token, workspaceId, subMode)
+	default:
+		err = fmt.Errorf("no mode found")
+	}
+
+	if err != nil {
+		return nil, err
+	}
+
+	return tasks, nil
+
+}
+
+/* -------------------- Unexported Functions -------------------- */
+
+func (widget *Widget) content() (string, string, bool) {
+
+	title := widget.CommonSettings().Title
+	if widget.err != nil {
+		return title, widget.err.Error(), true
+	}
+
+	data := widget.tasks
+	if len(data) == 0 {
+		return title, "No data", false
+	}
+
+	var str string
+
+	for idx, taskItem := range data {
+		switch {
+		case taskItem.taskType == TASK_TYPE:
+			if widget.settings.hideComplete && taskItem.completed {
+				continue
+			}
+
+			rowColor := widget.RowColor(idx)
+
+			completed := "[ []"
+			if taskItem.completed {
+				completed = "[x[]"
+			}
+
+			row := ""
+
+			if widget.settings.allUsers && taskItem.assignee != "" {
+				row = fmt.Sprintf(
+					"[%s]  %s %s: %s",
+					rowColor,
+					completed,
+					taskItem.assignee,
+					taskItem.name,
+				)
+			} else {
+				row = fmt.Sprintf(
+					"[%s]  %s %s",
+					rowColor,
+					completed,
+					taskItem.name,
+				)
+			}
+
+			if taskItem.numSubtasks > 0 {
+				row += fmt.Sprintf(" (%d)", taskItem.numSubtasks)
+			}
+
+			if taskItem.dueOn != "" {
+				row += fmt.Sprintf(" due: %s", taskItem.dueOn)
+			}
+
+			row += " [white]"
+
+			str += utils.HighlightableHelper(widget.View, row, idx, len(taskItem.name))
+
+		case taskItem.taskType == TASK_SECTION:
+			if idx > 1 {
+				row := "[white] "
+
+				str += utils.HighlightableHelper(widget.View, row, idx, len(taskItem.name))
+			}
+			row := fmt.Sprintf(
+				"[white] %s [white]",
+				taskItem.name,
+			)
+
+			str += utils.HighlightableHelper(widget.View, row, idx, len(taskItem.name))
+
+			row = "[white] "
+
+			str += utils.HighlightableHelper(widget.View, row, idx, len(taskItem.name))
+
+		}
+
+	}
+
+	return title, str, false
+
+}
+
+func (widget *Widget) openTask() {
+	sel := widget.GetSelected()
+
+	if sel >= 0 && widget.tasks != nil && sel < len(widget.tasks) {
+		task := widget.tasks[sel]
+		if task.taskType == TASK_TYPE && task.url != "" {
+			utils.OpenFile(task.url)
+		}
+	}
+}
+
+func (widget *Widget) toggleTaskCompletion() {
+	sel := widget.GetSelected()
+
+	if sel >= 0 && widget.tasks != nil && sel < len(widget.tasks) {
+		task := widget.tasks[sel]
+		if task.taskType == TASK_TYPE {
+			widget.mu.Lock()
+
+			err := toggleTaskCompletionById(widget.settings.token, task.id)
+			if err != nil {
+				widget.err = err
+			}
+
+			widget.mu.Unlock()
+			widget.Refresh()
+		}
+	}
+}

modules/azuredevops/client.go

@@ -0,0 +1,59 @@
+package azuredevops
+
+import (
+	"fmt"
+	"strings"
+
+	azrBuild "github.com/microsoft/azure-devops-go-api/azuredevops/build"
+	"github.com/pkg/errors"
+)
+
+func (widget *Widget) getBuildStats() string {
+	projName := widget.settings.projectName
+	statusFilter := azrBuild.BuildStatusValues.All
+	top := widget.settings.maxRows
+	builds, err := widget.cli.GetBuilds(widget.ctx, azrBuild.GetBuildsArgs{Project: &projName, StatusFilter: &statusFilter, Top: &top})
+	if err != nil {
+		return errors.Wrap(err, "could not get builds").Error()
+	}
+
+	result := ""
+	for _, build := range builds.Value {
+		num := *build.BuildNumber
+		branch := *build.SourceBranch
+		reason := *build.Reason
+		triggers := *build.TriggerInfo
+		if reason == azrBuild.BuildReasonValues.PullRequest {
+			branch = triggers["pr.sourceBranch"]
+		}
+		branch = strings.TrimPrefix(branch, "refs/heads/")
+		status := *build.Status
+		statusDisplay := "[white:grey]unknown"
+		if status == azrBuild.BuildStatusValues.InProgress {
+			statusDisplay = "[white:blue]in progress"
+		} else if status == azrBuild.BuildStatusValues.Cancelling {
+			statusDisplay = "[white:orange]in cancelling"
+		} else if (status == azrBuild.BuildStatusValues.Postponed) || (status == azrBuild.BuildStatusValues.NotStarted) {
+			statusDisplay = "[white:blue]waiting"
+		} else if status == azrBuild.BuildStatusValues.Completed {
+			buildResult := *build.Result
+			if buildResult == azrBuild.BuildResultValues.Succeeded {
+				statusDisplay = "[white:green]succeeded"
+			} else if buildResult == azrBuild.BuildResultValues.Failed {
+				statusDisplay = "[white:red]failed"
+			} else if buildResult == azrBuild.BuildResultValues.Canceled {
+				statusDisplay = "[white:darkgrey]cancelled"
+			} else if buildResult == azrBuild.BuildResultValues.PartiallySucceeded {
+				statusDisplay = "[white:magenta]partially"
+			}
+		}
+
+		result += fmt.Sprintf("%s[-:-:-] #%s %s (%s) \n", statusDisplay, num, branch, reason)
+	}
+
+	if result == "" {
+		result = "no builds found"
+	}
+
+	return result
+}

modules/azuredevops/example-conf.yml

@@ -0,0 +1,42 @@
+wtf:
+  colors:
+    # background: black
+    # foreground: blue
+    border:
+      focusable: darkslateblue
+      focused: orange
+      normal: gray
+    checked: yellow
+    highlight: 
+      fore: black
+      back: gray
+    rows:
+      even: yellow
+      odd: white
+  grid:
+    # How _wide_ the columns are, in terminal characters. In this case we have
+    # four columns, each of which are 35 characters wide.
+    # columns: [50, ]
+    # How _high_ the rows are, in terminal lines. In this case we have four rows
+    # that support ten line of text and one of four.
+    # rows: [50]
+  refreshInterval: 1
+  openFileUtil: "open"
+  mods:
+    azuredevops:
+      type: azuredevops
+      title: "💻"
+      enabled: true
+      position:
+        top: 0
+        left: 0
+        height: 3
+        width: 3
+      refreshInterval: 1
+      labelColor: lightblue # title label color (optional / default: white)
+      apiToken: "mysecret api token" # api key (required)
+      orgUrl: "https://dev.azure.com/myawesomecompany/" # url to your azure devops project (required)
+      prjectName: "the awesome project"  # name of your project (required)
+      maxRows: 3 #max rows to show (optional / default 3)
+
+  

modules/azuredevops/settings.go

@@ -0,0 +1,42 @@
+package azuredevops
+
+import (
+	"os"
+
+	"github.com/olebedev/config"
+	"github.com/wtfutil/wtf/cfg"
+)
+
+const (
+	defaultFocus = false
+	defaultTitle = "azuredevops"
+)
+
+// Settings defines the configuration options for this module
+type Settings struct {
+	*cfg.Common
+
+	apiToken    string `help:"Your Azure DevOps Access Token."`
+	labelColor  string
+	maxRows     int
+	orgURL      string `help:"Your Azure DevOps organization URL."`
+	projectName string
+}
+
+// NewSettingsFromYAML creates and returns an instance of Settings with configuration options populated
+func NewSettingsFromYAML(name string, ymlConfig *config.Config, globalConfig *config.Config) *Settings {
+	settings := Settings{
+		Common: cfg.NewCommonSettingsFromModule(name, defaultTitle, defaultFocus, ymlConfig, globalConfig),
+
+		apiToken:    ymlConfig.UString("apiToken", os.Getenv("WTF_AZURE_DEVOPS_API_TOKEN")),
+		labelColor:  ymlConfig.UString("labelColor", "white"),
+		maxRows:     ymlConfig.UInt("maxRows", 3),
+		orgURL:      ymlConfig.UString("orgURL", os.Getenv("WTF_AZURE_DEVOPS_ORG_URL")),
+		projectName: ymlConfig.UString("projectName", os.Getenv("WTF_AZURE_DEVOPS_PROJECT_NAME")),
+	}
+
+	cfg.ModuleSecret(name, globalConfig, &settings.apiToken).
+		Service(settings.orgURL).Load()
+
+	return &settings
+}

modules/azuredevops/widget.go

@@ -0,0 +1,66 @@
+package azuredevops
+
+import (
+	"context"
+	"fmt"
+
+	azr "github.com/microsoft/azure-devops-go-api/azuredevops"
+	azrBuild "github.com/microsoft/azure-devops-go-api/azuredevops/build"
+	"github.com/pkg/errors"
+	"github.com/rivo/tview"
+	"github.com/wtfutil/wtf/view"
+)
+
+type Widget struct {
+	view.TextWidget
+	cli           azrBuild.Client
+	settings      *Settings
+	displayBuffer string
+	ctx           context.Context
+}
+
+func NewWidget(tviewApp *tview.Application, pages *tview.Pages, settings *Settings) *Widget {
+	widget := Widget{
+		TextWidget: view.NewTextWidget(tviewApp, pages, settings.Common),
+		settings:   settings,
+	}
+
+	widget.View.SetScrollable(true)
+	connection := azr.NewPatConnection(settings.orgURL, settings.apiToken)
+	ctx := context.Background()
+
+	cli, err := azrBuild.NewClient(ctx, connection)
+	if err != nil {
+		widget.displayBuffer = errors.Wrap(err, "could not create client 2").Error()
+	} else {
+		widget.cli = cli
+		widget.ctx = ctx
+	}
+
+	widget.refreshDisplayBuffer()
+
+	return &widget
+}
+
+func (widget *Widget) Refresh() {
+	widget.refreshDisplayBuffer()
+	widget.Redraw(widget.display)
+}
+
+func (widget *Widget) display() (string, string, bool) {
+	return widget.CommonSettings().Title, widget.displayBuffer, true
+}
+
+func (widget *Widget) refreshDisplayBuffer() {
+	if widget.cli == nil {
+		return
+	}
+
+	widget.displayBuffer = ""
+
+	widget.displayBuffer += fmt.Sprintf("[%s::bul] build status - %s\n",
+		widget.settings.labelColor,
+		widget.settings.projectName)
+
+	widget.displayBuffer += widget.getBuildStats()
+}

modules/bamboohr/request.go

@@ -18,7 +18,7 @@ func Request(apiKey string, apiURL string) ([]byte, error) {
 	if err != nil {
 		return nil, err
 	}
-	defer resp.Body.Close()
+	defer func() { _ = resp.Body.Close() }()
 
 	data, err := ParseBody(resp)
 	if err != nil {

modules/bamboohr/settings.go

@@ -7,10 +7,13 @@ import (
 	"github.com/wtfutil/wtf/cfg"
 )
 
-const defaultTitle = "BambooHR"
+const (
+	defaultFocusable = false
+	defaultTitle     = "BambooHR"
+)
 
 type Settings struct {
-	common *cfg.Common
+	*cfg.Common
 
 	apiKey    string `help:"Your BambooHR API token."`
 	subdomain string `help:"Your BambooHR API subdomain name."`
@@ -18,11 +21,13 @@ type Settings struct {
 
 func NewSettingsFromYAML(name string, ymlConfig *config.Config, globalConfig *config.Config) *Settings {
 	settings := Settings{
-		common: cfg.NewCommonSettingsFromModule(name, defaultTitle, ymlConfig, globalConfig),
+		Common: cfg.NewCommonSettingsFromModule(name, defaultTitle, defaultFocusable, ymlConfig, globalConfig),
 
-		apiKey:    ymlConfig.UString("apiKey", os.Getenv("WTF_BAMBOO_HR_TOKEN")),
+		apiKey:    ymlConfig.UString("apiKey", ymlConfig.UString("apikey", os.Getenv("WTF_BAMBOO_HR_TOKEN"))),
 		subdomain: ymlConfig.UString("subdomain", os.Getenv("WTF_BAMBOO_HR_SUBDOMAIN")),
 	}
 
+	cfg.ModuleSecret(name, globalConfig, &settings.apiKey).Load()
+
 	return &settings
 }

modules/bamboohr/widget.go

@@ -10,17 +10,18 @@ import (
 	"github.com/wtfutil/wtf/wtf"
 )
 
-const APIURI = "https://api.bamboohr.com/api/gateway.php"
+const apiURI = "https://api.bamboohr.com/api/gateway.php"
 
 type Widget struct {
 	view.TextWidget
 
 	settings *Settings
+	items    []Item
 }
 
-func NewWidget(app *tview.Application, settings *Settings) *Widget {
+func NewWidget(tviewApp *tview.Application, settings *Settings) *Widget {
 	widget := Widget{
-		TextWidget: view.NewTextWidget(app, settings.common, false),
+		TextWidget: view.NewTextWidget(tviewApp, nil, settings.Common),
 
 		settings: settings,
 	}
@@ -32,33 +33,33 @@ func NewWidget(app *tview.Application, settings *Settings) *Widget {
 
 func (widget *Widget) Refresh() {
 	client := NewClient(
-		APIURI,
+		apiURI,
 		widget.settings.apiKey,
 		widget.settings.subdomain,
 	)
 
-	todayItems := client.Away(
+	widget.items = client.Away(
 		"timeOff",
 		time.Now().Local().Format(wtf.DateFormat),
 		time.Now().Local().Format(wtf.DateFormat),
 	)
 
-	widget.Redraw(widget.CommonSettings().Title, widget.contentFrom(todayItems), false)
+	widget.Redraw(widget.content)
 }
 
 /* -------------------- Unexported Functions -------------------- */
 
-func (widget *Widget) contentFrom(items []Item) string {
-	if len(items) == 0 {
-		return fmt.Sprintf("\n\n\n\n\n\n\n\n%s", utils.CenterText("[grey]no one[white]", 50))
-	}
-
+func (widget *Widget) content() (string, string, bool) {
 	str := ""
-	for _, item := range items {
-		str += widget.format(item)
+	if len(widget.items) == 0 {
+		str = fmt.Sprintf("\n\n\n\n\n\n\n\n%s", utils.CenterText("[grey]no one[white]", 50))
+	} else {
+		for _, item := range widget.items {
+			str += widget.format(item)
+		}
 	}
 
-	return str
+	return widget.CommonSettings().Title, str, false
 }
 
 func (widget *Widget) format(item Item) string {

modules/bargraph/settings.go

@@ -5,15 +5,18 @@ import (
 	"github.com/wtfutil/wtf/cfg"
 )
 
-const defaultTitle = "Bargraph"
+const (
+	defaultFocusable = false
+	defaultTitle     = "Bargraph"
+)
 
 type Settings struct {
-	common *cfg.Common
+	*cfg.Common
 }
 
 func NewSettingsFromYAML(name string, ymlConfig *config.Config, globalConfig *config.Config) *Settings {
 	settings := Settings{
-		common: cfg.NewCommonSettingsFromModule(name, defaultTitle, ymlConfig, globalConfig),
+		Common: cfg.NewCommonSettingsFromModule(name, defaultTitle, defaultFocusable, ymlConfig, globalConfig),
 	}
 
 	return &settings

modules/bargraph/widget.go

@@ -5,29 +5,27 @@ This is a demo bargraph that just populates some random date/val data
 */
 
 import (
-	"github.com/rivo/tview"
 	"math/rand"
 	"time"
 
+	"github.com/rivo/tview"
+
 	"github.com/wtfutil/wtf/view"
 )
 
-var started = false
-var ok = true
-
 // Widget define wtf widget to register widget later
 type Widget struct {
 	view.BarGraph
 
-	app *tview.Application
+	tviewApp *tview.Application
 }
 
 // NewWidget Make new instance of widget
-func NewWidget(app *tview.Application, settings *Settings) *Widget {
+func NewWidget(tviewApp *tview.Application, settings *Settings) *Widget {
 	widget := Widget{
-		BarGraph: view.NewBarGraph(app, "Sample Bar Graph", settings.common, false),
+		BarGraph: view.NewBarGraph(tviewApp, "Sample Bar Graph", settings.Common),
 
-		app: app,
+		tviewApp: tviewApp,
 	}
 
 	widget.View.SetWrap(true)
@@ -47,11 +45,12 @@ func MakeGraph(widget *Widget) {
 
 	barTime := time.Now()
 	for i := 0; i < lineCount; i++ {
-		barTime = barTime.Add(time.Duration(time.Minute))
+		barTime = barTime.Add(time.Minute)
 
 		bar := view.Bar{
-			Label:   barTime.Format("15:04"),
-			Percent: rand.Intn(100-5) + 5,
+			Label:      barTime.Format("15:04"),
+			Percent:    rand.Intn(100-5) + 5,
+			LabelColor: "red",
 		}
 
 		stats[i] = bar
@@ -70,7 +69,7 @@ func (widget *Widget) Refresh() {
 
 	widget.View.Clear()
 
-	widget.app.QueueUpdateDraw(func() {
+	widget.tviewApp.QueueUpdateDraw(func() {
 		display(widget)
 	})
 

modules/buildkite/client.go

@@ -0,0 +1,108 @@
+package buildkite
+
+import (
+	"fmt"
+	"net/http"
+
+	"github.com/wtfutil/wtf/utils"
+)
+
+type Pipeline struct {
+	Slug string `json:"slug"`
+}
+
+type Build struct {
+	State    string   `json:"state"`
+	Pipeline Pipeline `json:"pipeline"`
+	Branch   string   `json:"branch"`
+	WebUrl   string   `json:"web_url"`
+}
+
+func (widget *Widget) getBuilds() ([]Build, error) {
+	builds := []Build{}
+
+	for _, pipeline := range widget.settings.pipelines {
+		buildsForPipeline, err := widget.recentBuilds(pipeline)
+
+		if err != nil {
+			return nil, err
+		}
+
+		mostRecent := mostRecentBuildForBranches(buildsForPipeline, pipeline.branches)
+		builds = append(builds, mostRecent...)
+	}
+
+	return builds, nil
+}
+
+func (widget *Widget) recentBuilds(pipeline PipelineSettings) ([]Build, error) {
+	url := fmt.Sprintf(
+		"https://api.buildkite.com/v2/organizations/%s/pipelines/%s/builds%s",
+		widget.settings.orgSlug,
+		pipeline.slug,
+		branchesQuery(pipeline.branches),
+	)
+
+	req, err := http.NewRequest("GET", url, nil)
+	if err != nil {
+		return nil, err
+	}
+	req.Header.Add("Authorization", fmt.Sprintf("Bearer %s", widget.settings.apiKey))
+
+	httpClient := &http.Client{Transport: &http.Transport{
+		Proxy: http.ProxyFromEnvironment,
+	}}
+
+	resp, err := httpClient.Do(req)
+	if err != nil {
+		return nil, err
+	}
+	defer func() { _ = resp.Body.Close() }()
+
+	if resp.StatusCode < 200 || resp.StatusCode > 299 {
+		return nil, fmt.Errorf(resp.Status)
+	}
+
+	builds := []Build{}
+	err = utils.ParseJSON(&builds, resp.Body)
+	if err != nil {
+		return nil, err
+	}
+
+	return builds, nil
+}
+
+func branchesQuery(branches []string) string {
+	if len(branches) == 0 {
+		return ""
+	}
+
+	if len(branches) == 1 {
+		return fmt.Sprintf("?branch=%s", branches[0])
+	}
+
+	queryString := fmt.Sprintf("?branch[]=%s", branches[0])
+	for _, branch := range branches[1:] {
+		queryString += fmt.Sprintf("&branch[]=%s", branch)
+	}
+
+	return queryString
+}
+
+func mostRecentBuildForBranches(builds []Build, branches []string) []Build {
+	recentBuilds := []Build{}
+
+	haveMostRecentBuildForBranch := map[string]bool{}
+	for _, branch := range branches {
+		haveMostRecentBuildForBranch[branch] = false
+	}
+
+	for _, build := range builds {
+		if !haveMostRecentBuildForBranch[build.Branch] {
+			haveMostRecentBuildForBranch[build.Branch] = true
+			recentBuilds = append(recentBuilds, build)
+		}
+	}
+
+	return recentBuilds
+}

modules/buildkite/keyboard.go

@@ -0,0 +1,6 @@
+package buildkite
+
+func (widget *Widget) initializeKeyboardControls() {
+	widget.InitializeHelpTextKeyboardControl(widget.ShowHelp)
+	widget.InitializeRefreshKeyboardControl(widget.Refresh)
+}

modules/buildkite/pipelines_display_data.go

@@ -0,0 +1,120 @@
+package buildkite
+
+import (
+	"fmt"
+	"sort"
+	"strings"
+)
+
+type pipelinesDisplayData struct {
+	buildsForPipeline map[string][]Build
+	orderedPipelines  []string
+}
+
+func (data *pipelinesDisplayData) Content() string {
+	maxPipelineLength := getLongestLength(data.orderedPipelines)
+
+	str := ""
+	for _, pipeline := range data.orderedPipelines {
+		str += fmt.Sprintf("[white]%s", padRight(pipeline, maxPipelineLength))
+		for _, build := range data.buildsForPipeline[pipeline] {
+			str += fmt.Sprintf("  [%s]%s[white]", buildColor(build.State), build.Branch)
+		}
+		str += "\n"
+	}
+
+	return str
+}
+
+func NewPipelinesDisplayData(builds []Build) pipelinesDisplayData {
+	grouped := make(map[string][]Build)
+
+	for _, build := range builds {
+		if _, ok := grouped[build.Pipeline.Slug]; ok {
+			grouped[build.Pipeline.Slug] = append(grouped[build.Pipeline.Slug], build)
+		} else {
+			grouped[build.Pipeline.Slug] = []Build{}
+			grouped[build.Pipeline.Slug] = append(grouped[build.Pipeline.Slug], build)
+		}
+	}
+
+	orderedPipelines := make([]string, len(grouped))
+	i := 0
+	for pipeline := range grouped {
+		orderedPipelines[i] = pipeline
+		i++
+	}
+	sort.Strings(orderedPipelines)
+
+	name := func(b1, b2 *Build) bool {
+		return b1.Branch < b2.Branch
+	}
+	for _, builds := range grouped {
+		ByBuild(name).Sort(builds)
+	}
+
+	return pipelinesDisplayData{
+		buildsForPipeline: grouped,
+		orderedPipelines:  orderedPipelines,
+	}
+}
+
+type ByBuild func(b1, b2 *Build) bool
+
+func (by ByBuild) Sort(builds []Build) {
+	sorter := &buildSorter{
+		builds: builds,
+		by:     by,
+	}
+	sort.Sort(sorter)
+}
+
+type buildSorter struct {
+	builds []Build
+	by     func(b1, b2 *Build) bool
+}
+
+func (bs *buildSorter) Len() int {
+	return len(bs.builds)
+}
+
+func (bs *buildSorter) Swap(i, j int) {
+	bs.builds[i], bs.builds[j] = bs.builds[j], bs.builds[i]
+}
+
+func (bs *buildSorter) Less(i, j int) bool {
+	return bs.by(&bs.builds[i], &bs.builds[j])
+}
+
+func getLongestLength(strs []string) int {
+	longest := 0
+
+	for _, str := range strs {
+		if len(str) > longest {
+			longest = len(str)
+		}
+	}
+
+	return longest
+}
+
+func padRight(text string, length int) string {
+	padLength := length - len(text)
+
+	if padLength <= 0 {
+		return text[:length]
+	}
+
+	return text + strings.Repeat(" ", padLength)
+}
+
+func buildColor(state string) string {
+	switch state {
+	case "passed":
+		return "green"
+	case "failed":
+		return "red"
+	default:
+		return "yellow"
+	}
+}

modules/buildkite/settings.go

@@ -0,0 +1,66 @@
+package buildkite
+
+import (
+	"os"
+
+	"github.com/olebedev/config"
+	"github.com/wtfutil/wtf/cfg"
+	"github.com/wtfutil/wtf/utils"
+)
+
+const (
+	defaultTitle     = "Buildkite"
+	defaultFocusable = true
+)
+
+// PipelineSettings defines the configuration properties for a pipeline
+type PipelineSettings struct {
+	slug     string
+	branches []string
+}
+
+// Settings defines the configuration properties for this module
+type Settings struct {
+	*cfg.Common
+
+	apiKey    string             `help:"Your Buildkite API Token"`
+	orgSlug   string             `help:"Organization Slug"`
+	pipelines []PipelineSettings `help:"An array of pipelines to get data from"`
+}
+
+// NewSettingsFromYAML creates a new settings instance from a YAML config block
+func NewSettingsFromYAML(name string, ymlConfig *config.Config, globalConfig *config.Config) *Settings {
+	settings := Settings{
+		Common: cfg.NewCommonSettingsFromModule(name, defaultTitle, defaultFocusable, ymlConfig, globalConfig),
+
+		apiKey:    ymlConfig.UString("apiKey", os.Getenv("WTF_BUILDKITE_TOKEN")),
+		orgSlug:   ymlConfig.UString("organizationSlug"),
+		pipelines: buildPipelineSettings(ymlConfig),
+	}
+
+	cfg.ModuleSecret(name, globalConfig, &settings.apiKey).Load()
+
+	return &settings
+}
+
+/* -------------------- Unexported Functions -------------------- */
+
+func buildPipelineSettings(ymlConfig *config.Config) []PipelineSettings {
+	pipelines := []PipelineSettings{}
+
+	for slug := range ymlConfig.UMap("pipelines") {
+		branches := utils.ToStrs(ymlConfig.UList("pipelines." + slug + ".branches"))
+		if len(branches) == 0 {
+			branches = []string{"master"}
+		}
+
+		pipeline := PipelineSettings{
+			slug:     slug,
+			branches: branches,
+		}
+
+		pipelines = append(pipelines, pipeline)
+	}
+
+	return pipelines
+}

modules/buildkite/widget.go

@@ -0,0 +1,63 @@
+package buildkite
+
+import (
+	"fmt"
+
+	"github.com/rivo/tview"
+	"github.com/wtfutil/wtf/view"
+)
+
+type Widget struct {
+	view.TextWidget
+	settings *Settings
+
+	builds []Build
+	err    error
+}
+
+func NewWidget(tviewApp *tview.Application, pages *tview.Pages, settings *Settings) *Widget {
+	widget := Widget{
+		TextWidget: view.NewTextWidget(tviewApp, pages, settings.Common),
+		settings:   settings,
+	}
+
+	widget.initializeKeyboardControls()
+	widget.View.SetScrollable(true)
+
+	return &widget
+}
+
+/* -------------------- Exported Functions -------------------- */
+
+func (widget *Widget) Refresh() {
+	builds, err := widget.getBuilds()
+
+	if err != nil {
+		widget.err = err
+		widget.builds = nil
+	} else {
+		widget.builds = builds
+		widget.err = nil
+	}
+
+	// The last call should always be to the display function
+	widget.display()
+}
+
+/* -------------------- Unexported Functions -------------------- */
+
+func (widget *Widget) display() {
+	widget.Redraw(widget.content)
+}
+
+func (widget *Widget) content() (string, string, bool) {
+	title := fmt.Sprintf("%s - [green]%s", widget.CommonSettings().Title, widget.settings.orgSlug)
+
+	if widget.err != nil {
+		return title, widget.err.Error(), true
+	}
+
+	displayData := NewPipelinesDisplayData(widget.builds)
+
+	return title, displayData.Content(), false
+}

modules/cds/favorites/display.go

@@ -0,0 +1,92 @@
+package cdsfavorites
+
+import (
+	"fmt"
+
+	"github.com/ovh/cds/sdk"
+)
+
+func (widget *Widget) display() {
+	widget.TextWidget.Redraw(widget.content)
+}
+
+func (widget *Widget) content() (string, string, bool) {
+	if len(widget.View.GetHighlights()) > 0 {
+		widget.View.ScrollToHighlight()
+	} else {
+		widget.View.ScrollToBeginning()
+	}
+
+	widget.Items = make([]int64, 0)
+
+	workflow := widget.currentCDSWorkflow()
+	if workflow == nil {
+		return "", " Workflow not selected ", false
+	}
+
+	_, _, width, _ := widget.View.GetRect()
+	str := widget.settings.PaginationMarker(len(widget.workflows), widget.Idx, width) + "\n"
+	title := fmt.Sprintf("%s - %s", widget.CommonSettings().Title, widget.title(workflow))
+
+	str += widget.displayWorkflowRuns(workflow)
+
+	return title, str, false
+}
+
+func (widget *Widget) title(workflow *sdk.Workflow) string {
+	return fmt.Sprintf(
+		"[%s]%s/%s[white]",
+		widget.settings.Colors.TextTheme.Title,
+		workflow.ProjectKey, workflow.Name,
+	)
+}
+
+func (widget *Widget) displayWorkflowRuns(workflow *sdk.Workflow) string {
+	runs, _ := widget.client.WorkflowRunList(workflow.ProjectKey, workflow.Name, 0, 16)
+
+	widget.SetItemCount(len(runs))
+
+	if len(runs) == 0 {
+		return " [grey]none[white]\n"
+	}
+
+	content := ""
+	for idx, run := range runs {
+		var tags string
+		for _, tag := range run.Tags {
+			toadd := true
+			for _, v := range widget.settings.hideTags {
+				if v == tag.Tag {
+					toadd = false
+					break
+				}
+			}
+			if toadd {
+				tags = fmt.Sprintf("%s%s:%s ", tags, tag.Tag, tag.Value)
+			}
+		}
+		content += fmt.Sprintf(`[%s]["%d"]%d %-6s[""][gray] %s`, getStatusColor(run.Status), idx, run.Number, run.Status, tags)
+		content += "\n"
+		widget.Items = append(widget.Items, run.Number)
+	}
+
+	return content
+}
+
+func getStatusColor(status string) string {
+	switch status {
+	case sdk.StatusSuccess:
+		return "green"
+	case sdk.StatusBuilding, sdk.StatusWaiting:
+		return "blue"
+	case sdk.StatusFail:
+		return "red"
+	case sdk.StatusStopped:
+		return "red"
+	case sdk.StatusSkipped:
+		return "grey"
+	case sdk.StatusDisabled:
+		return "grey"
+	}
+	return "red"
+}

modules/cds/favorites/keyboard.go

@@ -0,0 +1,23 @@
+package cdsfavorites
+
+import (
+	"github.com/gdamore/tcell"
+)
+
+func (widget *Widget) initializeKeyboardControls() {
+	widget.InitializeHelpTextKeyboardControl(widget.ShowHelp)
+	widget.InitializeRefreshKeyboardControl(widget.Refresh)
+
+	widget.SetKeyboardChar("j", widget.Next, "Select next workflow")
+	widget.SetKeyboardChar("k", widget.Prev, "Select previous workflow")
+	widget.SetKeyboardChar("l", widget.NextSource, "Select next source")
+	widget.SetKeyboardChar("h", widget.PrevSource, "Select previous source")
+	widget.SetKeyboardChar("o", widget.openWorkflow, "Open workflow in browser")
+
+	widget.SetKeyboardKey(tcell.KeyDown, widget.Next, "Select next workflow")
+	widget.SetKeyboardKey(tcell.KeyUp, widget.Prev, "Select previous workflow")
+	widget.SetKeyboardKey(tcell.KeyRight, widget.NextSource, "Select next source")
+	widget.SetKeyboardKey(tcell.KeyLeft, widget.PrevSource, "Select previous source")
+	widget.SetKeyboardKey(tcell.KeyEnter, widget.openWorkflow, "Open workflow in browser")
+	widget.SetKeyboardKey(tcell.KeyEsc, widget.Unselect, "Clear selection")
+}

modules/cds/favorites/settings.go

@@ -0,0 +1,39 @@
+package cdsfavorites
+
+import (
+	"os"
+
+	"github.com/olebedev/config"
+	"github.com/wtfutil/wtf/cfg"
+	"github.com/wtfutil/wtf/utils"
+)
+
+const (
+	defaultFocusable = true
+	defaultTitle     = "CDS Favorites"
+)
+
+// Settings defines the configuration properties for this module
+type Settings struct {
+	*cfg.Common
+
+	token    string `help:"Your CDS API token."`
+	apiURL   string `help:"Your CDS API URL."`
+	uiURL    string
+	hideTags []string `help:"Hide some workflow tags."`
+}
+
+// NewSettingsFromYAML creates a new settings instance from a YAML config block
+func NewSettingsFromYAML(name string, ymlConfig *config.Config, globalConfig *config.Config) *Settings {
+	settings := Settings{
+		Common: cfg.NewCommonSettingsFromModule(name, defaultTitle, defaultFocusable, ymlConfig, globalConfig),
+
+		token:    ymlConfig.UString("token", ymlConfig.UString("token", os.Getenv("CDS_TOKEN"))),
+		apiURL:   ymlConfig.UString("apiURL", os.Getenv("CDS_API_URL")),
+		hideTags: utils.ToStrs(ymlConfig.UList("hideTags")),
+	}
+
+	settings.SetDocumentationPath("cds/favorites")
+
+	return &settings
+}

modules/cds/favorites/widget.go

@@ -0,0 +1,143 @@
+package cdsfavorites
+
+import (
+	"fmt"
+	"strconv"
+
+	"github.com/ovh/cds/sdk"
+	"github.com/ovh/cds/sdk/cdsclient"
+	"github.com/rivo/tview"
+	"github.com/wtfutil/wtf/utils"
+	"github.com/wtfutil/wtf/view"
+)
+
+// Widget define wtf widget to register widget later
+type Widget struct {
+	view.MultiSourceWidget
+	view.TextWidget
+
+	workflows []sdk.Workflow
+
+	client cdsclient.Interface
+
+	settings *Settings
+	Selected int
+	maxItems int
+	Items    []int64
+}
+
+// NewWidget creates a new instance of the widget
+func NewWidget(tviewApp *tview.Application, pages *tview.Pages, settings *Settings) *Widget {
+	widget := Widget{
+		MultiSourceWidget: view.NewMultiSourceWidget(settings.Common, "workflow", "workflows"),
+		TextWidget:        view.NewTextWidget(tviewApp, pages, settings.Common),
+
+		settings: settings,
+	}
+
+	widget.initializeKeyboardControls()
+	widget.View.SetRegions(true)
+	widget.SetDisplayFunction(widget.display)
+
+	widget.Unselect()
+
+	widget.client = cdsclient.New(cdsclient.Config{
+		Host:                              settings.apiURL,
+		BuitinConsumerAuthenticationToken: settings.token,
+	})
+
+	config, _ := widget.client.ConfigUser()
+
+	if config.URLUI != "" {
+		widget.settings.uiURL = config.URLUI
+	}
+
+	widget.workflows = widget.buildWorkflowsCollection()
+	return &widget
+}
+
+/* -------------------- Exported Functions -------------------- */
+
+// SetItemCount sets the amount of workflows throughout the widgets display creation
+func (widget *Widget) SetItemCount(items int) {
+	widget.maxItems = items
+}
+
+// GetItemCount returns the amount of workflows calculated so far as an int
+func (widget *Widget) GetItemCount() int {
+	return widget.maxItems
+}
+
+// GetSelected returns the index of the currently highlighted item as an int
+func (widget *Widget) GetSelected() int {
+	if widget.Selected < 0 {
+		return 0
+	}
+	return widget.Selected
+}
+
+// Next cycles the currently highlighted text down
+func (widget *Widget) Next() {
+	widget.Selected++
+	if widget.Selected >= widget.maxItems {
+		widget.Selected = 0
+	}
+	widget.View.Highlight(strconv.Itoa(widget.Selected)).ScrollToHighlight()
+}
+
+// Prev cycles the currently highlighted text up
+func (widget *Widget) Prev() {
+	widget.Selected--
+	if widget.Selected < 0 {
+		widget.Selected = widget.maxItems - 1
+	}
+	widget.View.Highlight(strconv.Itoa(widget.Selected)).ScrollToHighlight()
+}
+
+// Unselect stops highlighting the text and jumps the scroll position to the top
+func (widget *Widget) Unselect() {
+	widget.Selected = -1
+	widget.View.Highlight()
+	widget.View.ScrollToBeginning()
+}
+
+// Refresh reloads the data
+func (widget *Widget) Refresh() {
+	widget.display()
+}
+
+/* -------------------- Unexported Functions -------------------- */
+
+func (widget *Widget) buildWorkflowsCollection() []sdk.Workflow {
+	workflows := []sdk.Workflow{}
+	data, _ := widget.client.Navbar()
+	for _, v := range data {
+		if v.Favorite && v.WorkflowName != "" {
+			workflows = append(workflows, sdk.Workflow{ProjectKey: v.Key, Name: v.WorkflowName})
+		}
+	}
+	return workflows
+}
+
+func (widget *Widget) currentCDSWorkflow() *sdk.Workflow {
+	if len(widget.workflows) == 0 {
+		return nil
+	}
+
+	if widget.Idx < 0 || widget.Idx >= len(widget.workflows) {
+		widget.Idx = 0
+	}
+
+	p := widget.workflows[widget.Idx]
+	return &p
+}
+
+func (widget *Widget) openWorkflow() {
+	currentSelection := widget.View.GetHighlights()
+	if widget.Selected >= 0 && currentSelection[0] != "" {
+		wf := widget.currentCDSWorkflow()
+		url := fmt.Sprintf("%s/project/%s/workflow/%s/run/%d",
+			widget.settings.uiURL, wf.ProjectKey, wf.Name, widget.Items[widget.Selected])
+		utils.OpenFile(url)
+	}
+}

modules/cds/queue/display.go

@@ -0,0 +1,113 @@
+package cdsqueue
+
+import (
+	"fmt"
+	"strings"
+	"time"
+
+	"github.com/ovh/cds/sdk"
+)
+
+func (widget *Widget) display() {
+	widget.TextWidget.Redraw(widget.content)
+}
+
+func (widget *Widget) content() (string, string, bool) {
+	if len(widget.View.GetHighlights()) > 0 {
+		widget.View.ScrollToHighlight()
+	} else {
+		widget.View.ScrollToBeginning()
+	}
+
+	widget.Items = make([]sdk.WorkflowNodeJobRun, 0)
+	filter := widget.currentFilter()
+	_, _, width, _ := widget.View.GetRect()
+
+	str := widget.settings.PaginationMarker(len(widget.filters), widget.Idx, width) + "\n"
+	str += widget.displayQueue(filter)
+
+	title := fmt.Sprintf("%s - %s", widget.CommonSettings().Title, widget.title(filter))
+
+	return title, str, false
+}
+
+func (widget *Widget) title(filter string) string {
+	return fmt.Sprintf(
+		"[%s]%d - %s[white]",
+		widget.settings.Colors.TextTheme.Title,
+		widget.maxItems,
+		filter,
+	)
+}
+
+func (widget *Widget) displayQueue(filter string) string {
+	runs, _ := widget.client.QueueWorkflowNodeJobRun(filter)
+
+	widget.SetItemCount(len(runs))
+
+	if len(runs) == 0 {
+		return " [grey]none[white]\n"
+	}
+
+	var content string
+	for idx, job := range runs {
+		content += fmt.Sprintf(`[grey]["%d"]%s`,
+			idx, widget.generateQueueJobLine(job.ID, job.Parameters, job.Job, time.Since(job.Queued), job.BookedBy, job.Status))
+
+		widget.Items = append(widget.Items, job)
+	}
+
+	return content
+}
+
+func (widget *Widget) generateQueueJobLine(id int64, parameters []sdk.Parameter, executedJob sdk.ExecutedJob,
+	duration time.Duration, bookedBy sdk.Service, status string) string {
+	prj := getVarsInPbj("cds.project", parameters)
+	workflow := getVarsInPbj("cds.workflow", parameters)
+	node := getVarsInPbj("cds.node", parameters)
+	run := getVarsInPbj("cds.run", parameters)
+	triggeredBy := getVarsInPbj("cds.triggered_by.username", parameters)
+
+	row := make([]string, 6)
+	row[0] = pad(sdk.Round(duration, time.Second).String(), 9)
+	row[2] = pad(run, 7)
+	row[3] = pad(prj+"/"+workflow+"/"+node, 40)
+
+	switch {
+	case status == sdk.StatusBuilding:
+		row[1] = pad(fmt.Sprintf(" %s.%s ", executedJob.WorkerName, executedJob.WorkerID), 27)
+	case bookedBy.ID != 0:
+		row[1] = pad(fmt.Sprintf(" %s.%d ", bookedBy.Name, bookedBy.ID), 27)
+	default:
+		row[1] = pad("", 27)
+	}
+
+	row[4] = fmt.Sprintf("➤ %s", pad(triggeredBy, 17))
+
+	c := "grey"
+	if status == sdk.StatusWaiting {
+		if duration > 120*time.Second {
+			c = "red"
+		} else if duration > 50*time.Second {
+			c = "yellow"
+		}
+	}
+
+	return fmt.Sprintf("[%s]%s [grey]%s %s %s %s\n", c, row[0], row[1], row[2], row[3], row[4])
+}
+
+func pad(t string, size int) string {
+	if len(t) > size {
+		return t[0:size-3] + "..."
+	}
+	return t + strings.Repeat(" ", size-len(t))
+}
+
+func getVarsInPbj(key string, ps []sdk.Parameter) string {
+	for _, p := range ps {
+		if p.Name == key {
+			return p.Value
+		}
+	}
+	return ""
+}

modules/cds/queue/keyboard.go

@@ -0,0 +1,23 @@
+package cdsqueue
+
+import (
+	"github.com/gdamore/tcell"
+)
+
+func (widget *Widget) initializeKeyboardControls() {
+	widget.InitializeHelpTextKeyboardControl(widget.ShowHelp)
+	widget.InitializeRefreshKeyboardControl(widget.Refresh)
+
+	widget.SetKeyboardChar("j", widget.Next, "Select next workflow")
+	widget.SetKeyboardChar("k", widget.Prev, "Select previous workflow")
+	widget.SetKeyboardChar("l", widget.NextSource, "Select next filter")
+	widget.SetKeyboardChar("h", widget.PrevSource, "Select previous filter")
+	widget.SetKeyboardChar("o", widget.openWorkflow, "Open workflow in browser")
+
+	widget.SetKeyboardKey(tcell.KeyDown, widget.Next, "Select next workflow")
+	widget.SetKeyboardKey(tcell.KeyUp, widget.Prev, "Select previous workflow")
+	widget.SetKeyboardKey(tcell.KeyRight, widget.NextSource, "Select next filter")
+	widget.SetKeyboardKey(tcell.KeyLeft, widget.PrevSource, "Select previous filter")
+	widget.SetKeyboardKey(tcell.KeyEnter, widget.openWorkflow, "Open workflow in browser")
+	widget.SetKeyboardKey(tcell.KeyEsc, widget.Unselect, "Clear selection")
+}

modules/cds/queue/settings.go

@@ -0,0 +1,36 @@
+package cdsqueue
+
+import (
+	"os"
+
+	"github.com/olebedev/config"
+	"github.com/wtfutil/wtf/cfg"
+)
+
+const (
+	defaultFocusable = true
+	defaultTitle     = "CDS Queue"
+)
+
+// Settings defines the configuration properties for this module
+type Settings struct {
+	*cfg.Common
+
+	token  string `help:"Your CDS API token."`
+	apiURL string `help:"Your CDS API URL."`
+	uiURL  string
+}
+
+// NewSettingsFromYAML creates a new settings instance from a YAML config block
+func NewSettingsFromYAML(name string, ymlConfig *config.Config, globalConfig *config.Config) *Settings {
+	settings := Settings{
+		Common: cfg.NewCommonSettingsFromModule(name, defaultTitle, defaultFocusable, ymlConfig, globalConfig),
+
+		token:  ymlConfig.UString("token", ymlConfig.UString("token", os.Getenv("CDS_TOKEN"))),
+		apiURL: ymlConfig.UString("apiURL", os.Getenv("CDS_API_URL")),
+	}
+
+	settings.SetDocumentationPath("cds/queue")
+
+	return &settings
+}

modules/cds/queue/widget.go

@@ -0,0 +1,134 @@
+package cdsqueue
+
+import (
+	"fmt"
+	"strconv"
+
+	"github.com/ovh/cds/sdk"
+	"github.com/ovh/cds/sdk/cdsclient"
+	"github.com/rivo/tview"
+	"github.com/wtfutil/wtf/utils"
+	"github.com/wtfutil/wtf/view"
+)
+
+// Widget define wtf widget to register widget later
+type Widget struct {
+	view.MultiSourceWidget
+	view.TextWidget
+
+	filters []string
+
+	client cdsclient.Interface
+
+	settings *Settings
+	Selected int
+	maxItems int
+	Items    []sdk.WorkflowNodeJobRun
+}
+
+// NewWidget creates a new instance of the widget
+func NewWidget(tviewApp *tview.Application, pages *tview.Pages, settings *Settings) *Widget {
+	widget := Widget{
+		MultiSourceWidget: view.NewMultiSourceWidget(settings.Common, "workflow", "workflows"),
+		TextWidget:        view.NewTextWidget(tviewApp, pages, settings.Common),
+
+		settings: settings,
+	}
+
+	widget.initializeKeyboardControls()
+	widget.View.SetRegions(true)
+	widget.SetDisplayFunction(widget.display)
+
+	widget.Unselect()
+	widget.filters = []string{sdk.StatusWaiting, sdk.StatusBuilding}
+
+	widget.client = cdsclient.New(cdsclient.Config{
+		Host:                              settings.apiURL,
+		BuitinConsumerAuthenticationToken: settings.token,
+	})
+
+	config, _ := widget.client.ConfigUser()
+
+	if config.URLUI != "" {
+		widget.settings.uiURL = config.URLUI
+	}
+
+	return &widget
+}
+
+/* -------------------- Exported Functions -------------------- */
+
+// SetItemCount sets the amount of workflows throughout the widgets display creation
+func (widget *Widget) SetItemCount(items int) {
+	widget.maxItems = items
+}
+
+// GetItemCount returns the amount of workflows calculated so far as an int
+func (widget *Widget) GetItemCount() int {
+	return widget.maxItems
+}
+
+// GetSelected returns the index of the currently highlighted item as an int
+func (widget *Widget) GetSelected() int {
+	if widget.Selected < 0 {
+		return 0
+	}
+	return widget.Selected
+}
+
+// Next cycles the currently highlighted text down
+func (widget *Widget) Next() {
+	widget.Selected++
+	if widget.Selected >= widget.maxItems {
+		widget.Selected = 0
+	}
+	widget.View.Highlight(strconv.Itoa(widget.Selected)).ScrollToHighlight()
+}
+
+// Prev cycles the currently highlighted text up
+func (widget *Widget) Prev() {
+	widget.Selected--
+	if widget.Selected < 0 {
+		widget.Selected = widget.maxItems - 1
+	}
+	widget.View.Highlight(strconv.Itoa(widget.Selected)).ScrollToHighlight()
+}
+
+// Unselect stops highlighting the text and jumps the scroll position to the top
+func (widget *Widget) Unselect() {
+	widget.Selected = -1
+	widget.View.Highlight()
+	widget.View.ScrollToBeginning()
+}
+
+// Refresh reloads the data
+func (widget *Widget) Refresh() {
+	widget.display()
+}
+
+/* -------------------- Unexported Functions -------------------- */
+
+func (widget *Widget) currentFilter() string {
+	if len(widget.filters) == 0 {
+		return sdk.StatusWaiting
+	}
+
+	if widget.Idx < 0 || widget.Idx >= len(widget.filters) {
+		widget.Idx = 0
+		return sdk.StatusWaiting
+	}
+
+	return widget.filters[widget.Idx]
+}
+
+func (widget *Widget) openWorkflow() {
+	currentSelection := widget.View.GetHighlights()
+	if widget.Selected >= 0 && currentSelection[0] != "" {
+		job := widget.Items[widget.Selected]
+		prj := getVarsInPbj("cds.project", job.Parameters)
+		workflow := getVarsInPbj("cds.workflow", job.Parameters)
+		runNumber := getVarsInPbj("cds.run.number", job.Parameters)
+		url := fmt.Sprintf("%s/project/%s/workflow/%s/run/%s", widget.settings.uiURL, prj, workflow, runNumber)
+		utils.OpenFile(url)
+	}
+}

modules/cds/status/display.go

@@ -0,0 +1,88 @@
+package cdsstatus
+
+import (
+	"fmt"
+	"strings"
+
+	"github.com/ovh/cds/sdk"
+)
+
+func (widget *Widget) display() {
+	widget.TextWidget.Redraw(widget.content)
+}
+
+func (widget *Widget) content() (string, string, bool) {
+	if len(widget.View.GetHighlights()) > 0 {
+		widget.View.ScrollToHighlight()
+	} else {
+		widget.View.ScrollToBeginning()
+	}
+
+	widget.Items = make([]sdk.MonitoringStatusLine, 0)
+	str := widget.displayStatus()
+	title := widget.CommonSettings().Title
+	return title, str, false
+}
+
+func (widget *Widget) displayStatus() string {
+	status, err := widget.client.MonStatus()
+
+	if err != nil || len(status.Lines) == 0 {
+		return fmt.Sprintf(" [red]Error: %v[white]\n", err.Error())
+	}
+
+	widget.SetItemCount(len(status.Lines))
+
+	var (
+		global     []string
+		globalWarn []string
+		globalRed  []string
+		ok         []string
+		warn       []string
+		red        []string
+	)
+
+	for _, line := range status.Lines {
+		switch {
+		case line.Status == sdk.MonitoringStatusWarn && strings.Contains(line.Component, "Global"):
+			globalWarn = append(globalWarn, line.String())
+		case line.Status != sdk.MonitoringStatusOK && strings.Contains(line.Component, "Global"):
+			globalRed = append(globalRed, line.String())
+		case strings.Contains(line.Component, "Global"):
+			global = append(global, line.String())
+		case line.Status == sdk.MonitoringStatusWarn:
+			warn = append(warn, line.String())
+		case line.Status == sdk.MonitoringStatusOK:
+			ok = append(ok, line.String())
+		default:
+			red = append(red, line.String())
+		}
+	}
+	var idx int
+	var content string
+	for _, v := range globalRed {
+		content += fmt.Sprintf("[grey][\"%d\"][red]%s\n", idx, v)
+		idx++
+	}
+	for _, v := range globalWarn {
+		content += fmt.Sprintf("[grey][\"%d\"][yellow]%s\n", idx, v)
+		idx++
+	}
+	for _, v := range global {
+		content += fmt.Sprintf("[grey][\"%d\"][grey]%s\n", idx, v)
+		idx++
+	}
+	for _, v := range red {
+		content += fmt.Sprintf("[grey][\"%d\"][red]%s\n", idx, v)
+		idx++
+	}
+	for _, v := range warn {
+		content += fmt.Sprintf("[grey][\"%d\"][yellow]%s\n", idx, v)
+		idx++
+	}
+	for _, v := range ok {
+		content += fmt.Sprintf("[grey][\"%d\"][grey]%s\n", idx, v)
+		idx++
+	}
+	return content
+}

modules/cds/status/keyboard.go

@@ -0,0 +1,19 @@
+package cdsstatus
+
+import (
+	"github.com/gdamore/tcell"
+)
+
+func (widget *Widget) initializeKeyboardControls() {
+	widget.InitializeHelpTextKeyboardControl(widget.ShowHelp)
+	widget.InitializeRefreshKeyboardControl(widget.Refresh)
+
+	widget.SetKeyboardChar("j", widget.Next, "Select next line")
+	widget.SetKeyboardChar("k", widget.Prev, "Select previous line")
+	widget.SetKeyboardChar("o", widget.openWorkflow, "Open status in browser")
+
+	widget.SetKeyboardKey(tcell.KeyDown, widget.Next, "Select next line")
+	widget.SetKeyboardKey(tcell.KeyUp, widget.Prev, "Select previous line")
+	widget.SetKeyboardKey(tcell.KeyEnter, widget.openWorkflow, "Open status in browser")
+	widget.SetKeyboardKey(tcell.KeyEsc, widget.Unselect, "Clear selection")
+}

modules/cds/status/settings.go

@@ -0,0 +1,36 @@
+package cdsstatus
+
+import (
+	"os"
+
+	"github.com/olebedev/config"
+	"github.com/wtfutil/wtf/cfg"
+)
+
+const (
+	defaultFocusable = true
+	defaultTitle     = "CDS Status"
+)
+
+// Settings defines the configuration properties for this module
+type Settings struct {
+	*cfg.Common
+
+	token  string `help:"Your CDS API token."`
+	apiURL string `help:"Your CDS API URL."`
+	uiURL  string
+}
+
+// NewSettingsFromYAML creates a new settings instance from a YAML config block
+func NewSettingsFromYAML(name string, ymlConfig *config.Config, globalConfig *config.Config) *Settings {
+	settings := Settings{
+		Common: cfg.NewCommonSettingsFromModule(name, defaultTitle, defaultFocusable, ymlConfig, globalConfig),
+
+		token:  ymlConfig.UString("token", ymlConfig.UString("token", os.Getenv("CDS_TOKEN"))),
+		apiURL: ymlConfig.UString("apiURL", os.Getenv("CDS_API_URL")),
+	}
+
+	settings.SetDocumentationPath("cds/status")
+
+	return &settings
+}

modules/cds/status/widget.go

@@ -0,0 +1,117 @@
+package cdsstatus
+
+import (
+	"fmt"
+	"strconv"
+
+	"github.com/ovh/cds/sdk"
+	"github.com/ovh/cds/sdk/cdsclient"
+	"github.com/rivo/tview"
+	"github.com/wtfutil/wtf/utils"
+	"github.com/wtfutil/wtf/view"
+)
+
+// Widget define wtf widget to register widget later
+type Widget struct {
+	view.MultiSourceWidget
+	view.TextWidget
+
+	filters []string
+
+	client cdsclient.Interface
+
+	settings *Settings
+	Selected int
+	maxItems int
+	Items    []sdk.MonitoringStatusLine
+}
+
+// NewWidget creates a new instance of the widget
+func NewWidget(tviewApp *tview.Application, pages *tview.Pages, settings *Settings) *Widget {
+	widget := Widget{
+		MultiSourceWidget: view.NewMultiSourceWidget(settings.Common, "workflow", "workflows"),
+		TextWidget:        view.NewTextWidget(tviewApp, pages, settings.Common),
+
+		settings: settings,
+	}
+
+	widget.initializeKeyboardControls()
+	widget.View.SetRegions(true)
+	widget.SetDisplayFunction(widget.display)
+
+	widget.Unselect()
+	widget.filters = []string{sdk.StatusWaiting, sdk.StatusBuilding}
+
+	widget.client = cdsclient.New(cdsclient.Config{
+		Host:                              settings.apiURL,
+		BuitinConsumerAuthenticationToken: settings.token,
+	})
+
+	config, _ := widget.client.ConfigUser()
+
+	if config.URLUI != "" {
+		widget.settings.uiURL = config.URLUI
+	}
+
+	return &widget
+}
+
+/* -------------------- Exported Functions -------------------- */
+
+// SetItemCount sets the amount of line throughout the widgets display creation
+func (widget *Widget) SetItemCount(items int) {
+	widget.maxItems = items
+}
+
+// GetItemCount returns the amount of line calculated so far as an int
+func (widget *Widget) GetItemCount() int {
+	return widget.maxItems
+}
+
+// GetSelected returns the index of the currently highlighted item as an int
+func (widget *Widget) GetSelected() int {
+	if widget.Selected < 0 {
+		return 0
+	}
+	return widget.Selected
+}
+
+// Next cycles the currently highlighted text down
+func (widget *Widget) Next() {
+	widget.Selected++
+	if widget.Selected >= widget.maxItems {
+		widget.Selected = 0
+	}
+	widget.View.Highlight(strconv.Itoa(widget.Selected)).ScrollToHighlight()
+}
+
+// Prev cycles the currently highlighted text up
+func (widget *Widget) Prev() {
+	widget.Selected--
+	if widget.Selected < 0 {
+		widget.Selected = widget.maxItems - 1
+	}
+	widget.View.Highlight(strconv.Itoa(widget.Selected)).ScrollToHighlight()
+}
+
+// Unselect stops highlighting the text and jumps the scroll position to the top
+func (widget *Widget) Unselect() {
+	widget.Selected = -1
+	widget.View.Highlight()
+	widget.View.ScrollToBeginning()
+}
+
+// Refresh reloads the data
+func (widget *Widget) Refresh() {
+	widget.display()
+}
+
+/* -------------------- Unexported Functions -------------------- */
+
+func (widget *Widget) openWorkflow() {
+	currentSelection := widget.View.GetHighlights()
+	if widget.Selected >= 0 && currentSelection[0] != "" {
+		url := fmt.Sprintf("%s/admin/services", widget.settings.uiURL)
+		utils.OpenFile(url)
+	}
+}

modules/circleci/client.go

@@ -2,12 +2,12 @@ package circleci
 
 import (
 	"bytes"
-	"encoding/json"
 	"fmt"
-	"io"
 	"io/ioutil"
 	"net/http"
 	"net/url"
+
+	"github.com/wtfutil/wtf/utils"
 )
 
 type Client struct {
@@ -30,7 +30,10 @@ func (client *Client) BuildsFor() ([]*Build, error) {
 		return builds, err
 	}
 
-	parseJson(&builds, resp.Body)
+	err = utils.ParseJSON(&builds, bytes.NewReader(resp))
+	if err != nil {
+		return builds, err
+	}
 
 	return builds, nil
 }
@@ -41,7 +44,7 @@ var (
 	circleAPIURL = &url.URL{Scheme: "https", Host: "circleci.com", Path: "/api/v1/"}
 )
 
-func (client *Client) circleRequest(path string) (*http.Response, error) {
+func (client *Client) circleRequest(path string) ([]byte, error) {
 	params := url.Values{}
 	params.Add("circle-token", client.apiKey)
 
@@ -60,26 +63,15 @@ func (client *Client) circleRequest(path string) (*http.Response, error) {
 		return nil, err
 	}
 
+	defer func() { _ = resp.Body.Close() }()
+
 	if resp.StatusCode < 200 || resp.StatusCode > 299 {
 		return nil, fmt.Errorf(resp.Status)
 	}
 
-	return resp, nil
-}
-
-func parseJson(obj interface{}, text io.Reader) {
-	jsonStream, err := ioutil.ReadAll(text)
+	body, err := ioutil.ReadAll(resp.Body)
 	if err != nil {
-		panic(err)
-	}
-
-	decoder := json.NewDecoder(bytes.NewReader(jsonStream))
-
-	for {
-		if err := decoder.Decode(obj); err == io.EOF {
-			break
-		} else if err != nil {
-			panic(err)
-		}
+		return nil, err
 	}
+	return body, nil
 }

modules/circleci/settings.go

@@ -7,21 +7,28 @@ import (
 	"github.com/wtfutil/wtf/cfg"
 )
 
-const defaultTitle = "CircleCI"
+const (
+	defaultFocusable = false
+	defaultTitle     = "CircleCI"
+)
 
 type Settings struct {
-	common *cfg.Common
+	*cfg.Common
 
-	apiKey string `help:"Your CircleCI API token."`
+	apiKey         string `help:"Your CircleCI API token."`
+	numberOfBuilds int    `help:"The number of build, 10 by default"`
 }
 
 func NewSettingsFromYAML(name string, ymlConfig *config.Config, globalConfig *config.Config) *Settings {
 
 	settings := Settings{
-		common: cfg.NewCommonSettingsFromModule(name, defaultTitle, ymlConfig, globalConfig),
+		Common: cfg.NewCommonSettingsFromModule(name, defaultTitle, defaultFocusable, ymlConfig, globalConfig),
 
-		apiKey: ymlConfig.UString("apiKey", os.Getenv("WTF_CIRCLE_API_KEY")),
+		apiKey:         ymlConfig.UString("apiKey", ymlConfig.UString("apikey", os.Getenv("WTF_CIRCLE_API_KEY"))),
+		numberOfBuilds: ymlConfig.UInt("numberOfBuilds", 10),
 	}
 
+	cfg.ModuleSecret(name, globalConfig, &settings.apiKey).Load()
+
 	return &settings
 }

modules/circleci/widget.go

@@ -14,9 +14,9 @@ type Widget struct {
 	settings *Settings
 }
 
-func NewWidget(app *tview.Application, settings *Settings) *Widget {
+func NewWidget(tviewApp *tview.Application, settings *Settings) *Widget {
 	widget := Widget{
-		TextWidget: view.NewTextWidget(app, settings.common, false),
+		TextWidget: view.NewTextWidget(tviewApp, nil, settings.Common),
 		Client:     NewClient(settings.apiKey),
 
 		settings: settings,
@@ -32,41 +32,38 @@ func (widget *Widget) Refresh() {
 		return
 	}
 
-	builds, err := widget.Client.BuildsFor()
-
-	title := fmt.Sprintf("%s - Builds", widget.CommonSettings().Title)
-	var content string
-	wrap := false
-	if err != nil {
-		wrap = true
-		content = err.Error()
-	} else {
-		content = widget.contentFrom(builds)
-	}
-
-	widget.Redraw(title, content, wrap)
+	widget.Redraw(widget.content)
 }
 
 /* -------------------- Unexported Functions -------------------- */
 
-func (widget *Widget) contentFrom(builds []*Build) string {
-	var str string
-	for idx, build := range builds {
-		if idx > 10 {
-			return str
-		}
+func (widget *Widget) content() (string, string, bool) {
+	builds, err := widget.Client.BuildsFor()
 
-		str += fmt.Sprintf(
-			"[%s] %s-%d (%s) [white]%s\n",
-			buildColor(build),
-			build.Reponame,
-			build.BuildNum,
-			build.Branch,
-			build.AuthorName,
-		)
+	title := fmt.Sprintf("%s - Builds", widget.CommonSettings().Title)
+	var str string
+	wrap := false
+	if err != nil {
+		wrap = true
+		str = err.Error()
+	} else {
+		for idx, build := range builds {
+			if idx > widget.settings.numberOfBuilds {
+				break
+			}
+
+			str += fmt.Sprintf(
+				"[%s] %s-%d (%s) [white]%s\n",
+				buildColor(build),
+				build.Reponame,
+				build.BuildNum,
+				build.Branch,
+				build.AuthorName,
+			)
+		}
 	}
 
-	return str
+	return title, str, wrap
 }
 
 func buildColor(build *Build) string {

modules/clocks/clock.go

@@ -1,6 +1,7 @@
 package clocks
 
 import (
+	"strings"
 	"time"
 )
 
@@ -18,6 +19,14 @@ func NewClock(label string, timeLoc *time.Location) Clock {
 	return clock
 }
 
+func BuildClock(label string, location string) (clock Clock, err error) {
+	timeLoc, err := time.LoadLocation(sanitizeLocation(location))
+	if err != nil {
+		return Clock{}, err
+	}
+	return NewClock(label, timeLoc), nil
+}
+
 func (clock *Clock) Date(dateFormat string) string {
 	return clock.LocalTime().Format(dateFormat)
 }
@@ -33,3 +42,7 @@ func (clock *Clock) ToLocal(t time.Time) time.Time {
 func (clock *Clock) Time(timeFormat string) string {
 	return clock.LocalTime().Format(timeFormat)
 }
+
+func sanitizeLocation(locStr string) string {
+	return strings.Replace(locStr, " ", "_", -1)
+}

modules/clocks/clock_collection.go

@@ -10,7 +10,9 @@ type ClockCollection struct {
 }
 
 func (clocks *ClockCollection) Sorted(sortOrder string) []Clock {
-	if sortOrder == "chronological" {
+	if sortOrder == "natural" {
+		//no-op
+	} else if sortOrder == "chronological" {
 		clocks.SortedChronologically()
 	} else {
 		clocks.SortedAlphabetically()

modules/clocks/display.go

@@ -1,32 +1,23 @@
 package clocks
 
-import (
-	"fmt"
-)
+import "fmt"
 
 func (widget *Widget) display(clocks []Clock, dateFormat string, timeFormat string) {
-	if len(clocks) == 0 {
-		title := fmt.Sprintf("\n%s", " no timezone data available")
-		widget.Redraw(widget.CommonSettings().Title, title, true)
-		return
-	}
-
 	str := ""
-	for idx, clock := range clocks {
-		rowColor := widget.settings.colors.rows.odd
 
-		if idx%2 == 0 {
-			rowColor = widget.settings.colors.rows.even
+	if len(clocks) == 0 {
+		str = fmt.Sprintf("\n%s", " no timezone data available")
+	} else {
+		for idx, clock := range clocks {
+			str += fmt.Sprintf(
+				" [%s]%-12s %-10s %7s[white]\n",
+				widget.CommonSettings().RowColor(idx),
+				clock.Label,
+				clock.Time(timeFormat),
+				clock.Date(dateFormat),
+			)
 		}
-
-		str += fmt.Sprintf(
-			" [%s]%-12s %-10s %7s[white]\n",
-			rowColor,
-			clock.Label,
-			clock.Time(timeFormat),
-			clock.Date(dateFormat),
-		)
 	}
 
-	widget.Redraw(widget.CommonSettings().Title, str, false)
+	widget.Redraw(func() (string, string, bool) { return widget.CommonSettings().Title, str, false })
 }

modules/clocks/settings.go

@@ -6,38 +6,62 @@ import (
 	"github.com/wtfutil/wtf/utils"
 )
 
-const defaultTitle = "Clocks"
-
-type colors struct {
-	rows struct {
-		even string
-		odd  string
-	}
-}
+const (
+	defaultFocusable = false
+	defaultTitle     = "Clocks"
+)
 
+// Settings defines the configuration properties for this module
 type Settings struct {
-	colors
-	common *cfg.Common
+	*cfg.Common
 
-	dateFormat string                 `help:"The format of the date string for all clocks." values:"Any valid Go date layout which is handled by Time.Format. Defaults to Jan 2."`
-	timeFormat string                 `help:"The format of the time string for all clocks." values:"Any valid Go time layout which is handled by Time.Format. Defaults to 15:04 MST."`
-	locations  map[string]interface{} `help:"Defines the timezones for the world clocks that you want to display. key is a unique label that will be displayed in the UI. value is a timezone name." values:"Any TZ database timezone."`
-	sort       string                 `help:"Defines the display order of the clocks in the widget." values:"'alphabetical' or 'chronological'. 'alphabetical' will sort in acending order by key, 'chronological' will sort in ascending order by date/time."`
+	dateFormat string  `help:"The format of the date string for all clocks." values:"Any valid Go date layout which is handled by Time.Format. Defaults to Jan 2."`
+	timeFormat string  `help:"The format of the time string for all clocks." values:"Any valid Go time layout which is handled by Time.Format. Defaults to 15:04 MST."`
+	locations  []Clock `help:"Defines the timezones for the world clocks that you want to display. key is a unique label that will be displayed in the UI. value is a timezone name." values:"Any TZ database timezone."`
+	sort       string  `help:"Defines the display order of the clocks in the widget." values:"'alphabetical', 'chronological', or 'natural. 'alphabetical' will sort in ascending order by key, 'chronological' will sort in ascending order by date/time, 'natural' will keep ordering as per the config."`
 }
 
+// NewSettingsFromYAML creates a new settings instance from a YAML config block
 func NewSettingsFromYAML(name string, ymlConfig *config.Config, globalConfig *config.Config) *Settings {
-
 	settings := Settings{
-		common: cfg.NewCommonSettingsFromModule(name, defaultTitle, ymlConfig, globalConfig),
+		Common: cfg.NewCommonSettingsFromModule(name, defaultTitle, defaultFocusable, ymlConfig, globalConfig),
 
 		dateFormat: ymlConfig.UString("dateFormat", utils.SimpleDateFormat),
 		timeFormat: ymlConfig.UString("timeFormat", utils.SimpleTimeFormat),
-		locations:  ymlConfig.UMap("locations"),
+		locations:  buildLocations(ymlConfig),
 		sort:       ymlConfig.UString("sort"),
 	}
 
-	settings.colors.rows.even = ymlConfig.UString("colors.rows.even", "white")
-	settings.colors.rows.odd = ymlConfig.UString("colors.rows.odd", "blue")
-
 	return &settings
 }
+
+func buildLocations(ymlConfig *config.Config) []Clock {
+	clocks := []Clock{}
+	locations, err := ymlConfig.Map("locations")
+	if err == nil {
+		for k, v := range locations {
+			name := k
+			zone := v.(string)
+			clock, err := BuildClock(name, zone)
+			if err == nil {
+				clocks = append(clocks, clock)
+			}
+		}
+		return clocks
+	}
+
+	listLocations := ymlConfig.UList("locations")
+	for _, location := range listLocations {
+		if location, ok := location.(map[string]interface{}); ok {
+			for k, v := range location {
+				name := k
+				zone := v.(string)
+				clock, err := BuildClock(name, zone)
+				if err == nil {
+					clocks = append(clocks, clock)
+				}
+			}
+		}
+	}
+	return clocks
+}