checkoff 0.14.1 → 0.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa6999ea3bcde70f2cba0d6ecbf45102c85041d109e4d0d6ab55b92a941a1f3a
-  data.tar.gz: 52fe760413e0a8f559c42b9c0ac736e80f467d4d77578e77315fc0eea98b82ba
+  metadata.gz: 73dc8e8ee25d08cf3457dac6284c7a7ab5476db7d3e1fadbe66d75a1f0546297
+  data.tar.gz: 623ea9cd3331007bb831d72d14e063d9f92751eda5b1819270e69edb4ff7ca2e
 SHA512:
-  metadata.gz: 8ed9570ef12c90f3abb8ff8a19a8cf3678729c47785ab3bbfb1b000daab79a257f5df123ae4aa5b93fb9bb22bffb125c83552ee5168a59d4e5ae7ec36b57b31d
-  data.tar.gz: fad8749d150cddccdc7bab8baab9084bb63502d02874969113879f4607f02fa791f41444c70419218c45224053a4321a19e4f1c0bf53ac00f759e01d9789fe4d
+  metadata.gz: dd1155bea5724f05e4b1b6f12c172358ccb49d000bf1c22e77663df3b1239d442730c5879d116b4cca411a3a57f4acbf09fee5fa8b9b33c0537179e31601a8b3
+  data.tar.gz: d5e1f8a9aadaffbaf9cd18d8ba976d368b1eec6edd1e829bfa5b42780ee34cddbf661207c3554a9665eec07bce553db9b7a2c19e1e899f7e34df82efd9d7a64d

data/Gemfile.lock

@@ -1,9 +1,9 @@
 GIT
   remote: https://github.com/apiology/ruby-asana
-  revision: 83732f040728a4ef1cfc9ed61f65878dbee6aa23
+  revision: ab9393136d9ca59b75e42a661fdddc1c65c8f7c3
   branch: checkoff_fixes
   specs:
-    asana (0.10.4)
+    asana (0.10.6)
       faraday (~> 1.0)
       faraday_middleware (~> 1.0)
       faraday_middleware-multi_json (~> 0.0)
@@ -12,7 +12,7 @@ GIT
 PATH
   remote: .
   specs:
-    checkoff (0.14.1)
+    checkoff (0.15.0)
       activesupport
       asana (> 0.10.0)
       cache_method

data/Makefile

@@ -23,9 +23,11 @@ requirements_dev.txt.installed: requirements_dev.txt
 
 pip_install: requirements_dev.txt.installed ## Install Python dependencies
 
-Gemfile.lock:
-	bundle install
+# bundle install doesn't get run here so that we can catch it below in
+# fresh-checkout and fresh-rbenv cases
+Gemfile.lock: Gemfile
 
+# Ensure any Gemfile.lock changes ensure a bundle is installed.
 Gemfile.lock.installed: Gemfile.lock
 	bundle install
 	touch Gemfile.lock.installed
@@ -37,9 +39,11 @@ clear_metrics: ## remove or reset result artifacts created by tests and quality
 
 clean: clear_metrics ## remove all built artifacts
 
-quality: ## run precommit quality checks
+overcommit: ## run precommit quality checks
 	bundle exec overcommit --run
 
+quality: overcommit ## run precommit quality checks
+
 test: ## Run lower-level tests
 	@bundle exec rake test
 

data/README.md

@@ -4,12 +4,28 @@ Command-line and gem client for Asana (unofficial)
 
 ## Using
 
-```
+```sh
 $ checkoff --help
-View tasks:
-  checkoff view workspace project [section]
+NAME
+    checkoff - Command-line client for Asana (unofficial)
+
+
+SYNOPSIS
+    checkoff [global options] command [command options] [arguments...]
+
 
-'project' can be set to a project name, or :my_tasks for your user task list.
+
+GLOBAL OPTIONS
+    --help - Show this message
+
+
+
+COMMANDS
+    help     - Shows a list of commands or help for one command
+    mv       - Move tasks from one section to another within a project
+    quickadd - Add a short task to Asana
+    view     - Output representation of Asana tasks
+$
 ```
 
 Let's say we have a project like this:
@@ -18,7 +34,7 @@ Let's say we have a project like this:
 
 Checkoff outputs things in JSON.  'jq' is a great tool to use in combination:
 
-```
+```sh
 $ checkoff view 'Personal Projects' 'Create demo'
 {"":[{"name":"This is a task that doesn't belong to any sections."}],"Write it:":[{"name":"Write something"}],"Publish to github:":[{"name":"git push!"}],"Make sure it looks OK!:":[{"name":"Looks it up in your browser..."}]}
 $
@@ -52,7 +68,7 @@ $ checkoff view 'Personal Projects' 'Create demo' | jq
 
 You can drill down into a section on the command line:
 
-```
+```sh
 $ checkoff view 'Personal Projects' 'Create demo' 'Publish to github:'
 [{"name":"git push!"}]
 ```
@@ -71,12 +87,21 @@ $ checkoff view 'Personal Projects' 'Create demo' | jq 'to_entries | map(.value)
 
 And even gather counts for project metrics:
 
-```bash
+```sh
 $ checkoff view 'Personal Projects' 'Create demo' | jq 'to_entries | map(.value) | flatten | map(.name) | length'
 4
 $
 ```
 
+## Naming things
+
+Since checkoff looks up things by their name, if you have two things
+with the same name, you're probably going to have a bad time.
+
+If you need to talk about the section of a project which contains
+tasks that don't have a section, use `Untitled section` as the name.
+This is a quirk of the Asana API which seemed as good as any other idea.
+
 ## Caching
 
 Note that I don't know of a way through the Asana API to target
@@ -94,7 +119,7 @@ clear the cache.
 
 This will work under OS X:
 
-```bash
+```sh
 brew install memcached
 ln -sfv /usr/local/opt/memcached/*.plist ~/Library/LaunchAgents
 launchctl load ~/Library/LaunchAgents/homebrew.mxcl.memcached.plist
@@ -103,7 +128,8 @@ gem install checkoff
 
 ## Configuring
 
-You'll need to create a file called `.asana.yml` in your home directory, that looks like this:
+You'll need to create a file called `.asana.yml` in your home
+directory, that looks like this:
 
 ```yaml
 ---
@@ -129,7 +155,7 @@ Alternately you can set environment variables to match - e.g., `ASANA__PERSONAL_
 
 ## Developing
 
-```bash
+```sh
 bundle install
 bundle exec exe/checkoff --help
 ```

data/coverage/.last_run.json

@@ -1,6 +1,6 @@
 {
   "result": {
-    "line": 99.75,
-    "branch": 95.0
+    "line": 99.78,
+    "branch": 95.34
   }
 }

data/fix.sh

@@ -127,10 +127,33 @@ ensure_bundle() {
   bundler_version=$(bundle --version | cut -d ' ' -f3)
   bundler_version_major=$(cut -d. -f1 <<< "${bundler_version}")
   bundler_version_minor=$(cut -d. -f2 <<< "${bundler_version}")
+  bundler_version_patch=$(cut -d. -f3 <<< "${bundler_version}")
   # Version 2.1 of bundler seems to have some issues with nokogiri:
   #
   # https://app.asana.com/0/1107901397356088/1199504270687298
-  if [ "${bundler_version_major}" == 2 ] && [ "${bundler_version_minor}" -lt 2 ]
+
+  # Version 2.2.22 of bundler comes with a fix to ensure the 'bundle
+  # update --conservative' flag works as expected - important when
+  # doing a 'bundle update' on a about-to-be-published gem after
+  # bumping a gem version.
+  need_better_bundler=false
+  if [ "${bundler_version_major}" -lt 2 ]
+  then
+    need_better_bundler=true
+  elif [ "${bundler_version_major}" -eq 2 ]
+  then
+    if [ "${bundler_version_minor}" -lt 2 ]
+    then
+      need_better_bundler=true
+    elif [ "${bundler_version_minor}" -eq 2 ]
+    then
+      if [ "${bundler_version_patch}" -lt 22 ]
+      then
+        need_better_bundler=true
+      fi
+    fi
+  fi
+  if [ "${need_better_bundler}" = true ]
   then
     gem install --no-document bundler
   fi
@@ -143,7 +166,13 @@ ensure_bundle() {
   # re-resolve and consider the new platform when picking gems, all
   # without needing to have a machine that matches PLATFORM handy to
   # install those platform-specific gems on.'
-  grep x86_64-darwin-20 Gemfile.lock >/dev/null 2>&1 || bundle lock --add-platform x86_64-darwin-20 x86_64-linux
+  #
+  # This affects nokogiri, which will try to reinstall itself in
+  # Docker builds where it's already installed if this is not run.
+  for platform in x86_64-darwin-20 x86_64-linux
+  do
+    grep "${platform:?}" Gemfile.lock >/dev/null 2>&1 || bundle lock --add-platform "${platform:?}"
+  done
 }
 
 set_ruby_local_version() {

data/lib/checkoff.rb

@@ -6,3 +6,5 @@ require 'checkoff/projects'
 require 'checkoff/sections'
 require 'checkoff/subtasks'
 require 'checkoff/tasks'
+require 'checkoff/custom_fields'
+require 'checkoff/tags'

data/lib/checkoff/clients.rb

@@ -0,0 +1,55 @@
+#!/usr/bin/env ruby
+
+# frozen_string_literal: true
+
+require 'forwardable'
+require_relative 'config_loader'
+require 'asana'
+
+# https://developers.asana.com/docs/clients
+
+module Checkoff
+  # Pulls a configured Asana client object which can be used to access the API
+  class Clients
+    MINUTE = 60
+    HOUR = MINUTE * 60
+    DAY = 24 * HOUR
+    REALLY_LONG_CACHE_TIME = HOUR * 1
+    LONG_CACHE_TIME = MINUTE * 15
+    SHORT_CACHE_TIME = MINUTE
+
+    def initialize(config: Checkoff::ConfigLoader.load(:asana),
+                   asana_client_class: Asana::Client)
+      @config = config
+      @asana_client_class = asana_client_class
+    end
+
+    def client
+      @client ||= @asana_client_class.new do |c|
+        c.authentication :access_token, @config.fetch(:personal_access_token)
+        c.default_headers 'asana-enable' => 'string_ids,new_sections'
+        c.default_headers 'asana-disable' => 'new_user_task_lists'
+      end
+    end
+
+    private
+
+    attr_reader :workspaces
+
+    # bundle exec ./clients.rb
+    # :nocov:
+    class << self
+      def run
+        clients = Checkoff::Clients.new
+        client = clients.client
+        puts "Results: #{client}"
+      end
+    end
+    # :nocov:
+  end
+end
+
+# :nocov:
+abs_program_name = File.expand_path($PROGRAM_NAME)
+Checkoff::Clients.run if abs_program_name == __FILE__
+# :nocov:

data/lib/checkoff/create-entity.sh

@@ -0,0 +1,85 @@
+#!/bin/bash -eu
+
+set -o pipefail
+
+underscored_plural_name="${1:?underscored plural name of entities minus .rb}"
+# Sorry, shellcheck, I can't express 'end of line' in a simple variable search and replace
+# shellcheck disable=SC2001
+underscored_singular_name=$(sed -e 's/s$//g' <<< "${underscored_plural_name}")
+kabob_case_plural_name=${underscored_plural_name/_/-}
+class_name="${2:?class name without Checkoff:: prefix}"
+
+cat > "${underscored_plural_name}.rb" << EOF
+#!/usr/bin/env ruby
+
+# frozen_string_literal: true
+
+require 'forwardable'
+require 'cache_method'
+require_relative 'config_loader'
+require_relative 'workspaces'
+require_relative 'clients'
+
+# https://developers.asana.com/docs/${kabob_case_plural_name}
+
+module Checkoff
+  class ${class_name}
+    MINUTE = 60
+    HOUR = MINUTE * 60
+    DAY = 24 * HOUR
+    REALLY_LONG_CACHE_TIME = HOUR * 1
+    LONG_CACHE_TIME = MINUTE * 15
+    SHORT_CACHE_TIME = MINUTE
+
+    def initialize(config: Checkoff::ConfigLoader.load(:asana),
+                   workspaces: Checkoff::Workspaces.new(config: config),
+                   clients: Checkoff::Clients.new(config: config),
+                   client: clients.client)
+      @workspaces = workspaces
+      @client = client
+    end
+
+    def ${underscored_singular_name}_or_raise(workspace_name, ${underscored_singular_name}_name)
+      ${underscored_singular_name} = ${underscored_singular_name}(workspace_name, ${underscored_singular_name}_name)
+      raise "Could not find ${underscored_singular_name} #{${underscored_singular_name}_name} under workspace #{workspace_name}." if ${underscored_singular_name}.nil?
+
+      ${underscored_singular_name}
+    end
+    cache_method :${underscored_singular_name}_or_raise, LONG_CACHE_TIME
+
+    def ${underscored_singular_name}(workspace_name, ${underscored_singular_name}_name)
+      workspace = workspaces.workspace_by_name(workspace_name)
+      ${underscored_plural_name} = client.${underscored_plural_name}.get_${underscored_plural_name}_for_workspace(workspace_gid: workspace.gid)
+      ${underscored_plural_name}.find { |${underscored_singular_name}| ${underscored_singular_name}.name == ${underscored_singular_name}_name }
+    end
+    cache_method :${underscored_singular_name}, LONG_CACHE_TIME
+
+    private
+
+    attr_reader :workspaces, :client
+
+    # bundle exec ./${underscored_plural_name}.rb
+    # :nocov:
+    class << self
+      def run
+        workspace_name = ARGV[0] || raise('Please pass workspace name as first argument')
+        ${underscored_singular_name}_name = ARGV[1] || raise('Please pass ${underscored_singular_name} name as second argument')
+        ${underscored_plural_name} = Checkoff::${class_name}.new
+        ${underscored_singular_name} = ${underscored_plural_name}.${underscored_singular_name}_or_raise(workspace_name, ${underscored_singular_name}_name)
+        puts "Results: #{${underscored_singular_name}}"
+      end
+    end
+    # :nocov:
+  end
+end
+
+# :nocov:
+abs_program_name = File.expand_path(\$PROGRAM_NAME)
+Checkoff::${class_name}.run if abs_program_name == __FILE__
+# :nocov:
+EOF
+
+chmod +x "${underscored_plural_name}.rb"
+git add "${underscored_plural_name}.rb"
+
+echo "You can start by running 'bundle exec ./${underscored_plural_name}.rb' and tweaking from there"

data/lib/checkoff/custom_fields.rb

@@ -0,0 +1,68 @@
+#!/usr/bin/env ruby
+
+# frozen_string_literal: true
+
+require 'forwardable'
+require 'cache_method'
+require_relative 'config_loader'
+require_relative 'workspaces'
+require_relative 'clients'
+
+# https://developers.asana.com/docs/custom-fields
+
+module Checkoff
+  # Work with custom fields in Asana
+  class CustomFields
+    MINUTE = 60
+    HOUR = MINUTE * 60
+    DAY = 24 * HOUR
+    REALLY_LONG_CACHE_TIME = HOUR * 1
+    LONG_CACHE_TIME = MINUTE * 15
+    SHORT_CACHE_TIME = MINUTE
+
+    def initialize(config: Checkoff::ConfigLoader.load(:asana),
+                   workspaces: Checkoff::Workspaces.new(config: config),
+                   clients: Checkoff::Clients.new(config: config),
+                   client: clients.client)
+      @workspaces = workspaces
+      @client = client
+    end
+
+    def custom_field_or_raise(workspace_name, custom_field_name)
+      custom_field = custom_field(workspace_name, custom_field_name)
+      raise "Could not find custom_field #{custom_field_name} under workspace #{workspace_name}." if custom_field.nil?
+
+      custom_field
+    end
+    cache_method :custom_field_or_raise, LONG_CACHE_TIME
+
+    def custom_field(workspace_name, custom_field_name)
+      workspace = workspaces.workspace_by_name(workspace_name)
+      custom_fields = client.custom_fields.get_custom_fields_for_workspace(workspace_gid: workspace.gid)
+      custom_fields.find { |custom_field| custom_field.name == custom_field_name }
+    end
+    cache_method :custom_field, LONG_CACHE_TIME
+
+    private
+
+    attr_reader :workspaces, :client
+
+    # bundle exec ./custom_fields.rb
+    # :nocov:
+    class << self
+      def run
+        workspace_name = ARGV[0] || raise('Please pass workspace name as first argument')
+        custom_field_name = ARGV[1] || raise('Please pass custom_field name as second argument')
+        custom_fields = Checkoff::CustomFields.new
+        custom_field = custom_fields.custom_field_or_raise(workspace_name, custom_field_name)
+        puts "Results: #{custom_field}"
+      end
+    end
+    # :nocov:
+  end
+end
+
+# :nocov:
+abs_program_name = File.expand_path($PROGRAM_NAME)
+Checkoff::CustomFields.run if abs_program_name == __FILE__
+# :nocov:

data/lib/checkoff/projects.rb

@@ -1,7 +1,8 @@
 # frozen_string_literal: true
 
 require_relative 'config_loader'
-
+require_relative 'workspaces'
+require_relative 'clients'
 require 'cache_method'
 require 'asana'
 
@@ -23,16 +24,12 @@ module Checkoff
     SHORT_CACHE_TIME = MINUTE * 5
 
     def initialize(config: Checkoff::ConfigLoader.load(:asana),
-                   asana_client: Asana::Client,
-                   workspaces: Checkoff::Workspaces.new(config: config))
+                   workspaces: Checkoff::Workspaces.new(config: config),
+                   clients: Checkoff::Clients.new(config: config),
+                   client: clients.client)
       @config = config
-      @asana_client = asana_client
       @workspaces = workspaces
-    end
-
-    # Returns Asana Ruby API Client object
-    def client
-      @workspaces.client
+      @client = client
     end
 
     # Default options used in Asana API to pull taskso
@@ -84,6 +81,8 @@ module Checkoff
 
     private
 
+    attr_reader :client
+
     def projects
       client.projects
     end

data/lib/checkoff/sections.rb

@@ -1,6 +1,9 @@
 # frozen_string_literal: true
 
 require 'forwardable'
+require_relative 'projects'
+require_relative 'workspaces'
+require_relative 'clients'
 
 module Checkoff
   # Query different sections of Asana projects
@@ -16,10 +19,13 @@ module Checkoff
     def initialize(config: Checkoff::ConfigLoader.load(:asana),
                    projects: Checkoff::Projects.new(config: config),
                    workspaces: Checkoff::Workspaces.new(config: config),
+                   clients: Checkoff::Clients.new(config: config),
+                   client: clients.client,
                    time: Time)
       @projects = projects
       @workspaces = workspaces
       @time = time
+      @client = client
     end
 
     # Returns a list of Asana API section objects for a given project
@@ -72,6 +78,8 @@ module Checkoff
 
     private
 
+    attr_reader :client
+
     # Given a project object, pull all tasks, then provide a Hash of
     # tasks with section name -> task list of the uncompleted tasks
     def tasks_by_section_for_project(project)
@@ -80,8 +88,6 @@ module Checkoff
       by_section(active_tasks, project.gid)
     end
 
-    def_delegators :@projects, :client
-
     # Given a list of tasks, pull a Hash of tasks with section name -> task list
     def by_section(tasks, project_gid)
       by_section = {}

data/lib/checkoff/subtasks.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 require 'forwardable'
+require_relative 'config_loader'
+require_relative 'projects'
 
 module Checkoff
   # Query different subtasks of Asana tasks

data/lib/checkoff/tags.rb

@@ -0,0 +1,68 @@
+#!/usr/bin/env ruby
+
+# frozen_string_literal: true
+
+require 'forwardable'
+require 'cache_method'
+require_relative 'config_loader'
+require_relative 'workspaces'
+require_relative 'clients'
+
+# https://developers.asana.com/docs/tags
+
+module Checkoff
+  # Work with tags in Asana
+  class Tags
+    MINUTE = 60
+    HOUR = MINUTE * 60
+    DAY = 24 * HOUR
+    REALLY_LONG_CACHE_TIME = HOUR * 1
+    LONG_CACHE_TIME = MINUTE * 15
+    SHORT_CACHE_TIME = MINUTE
+
+    def initialize(config: Checkoff::ConfigLoader.load(:asana),
+                   workspaces: Checkoff::Workspaces.new(config: config),
+                   clients: Checkoff::Clients.new(config: config),
+                   client: clients.client)
+      @workspaces = workspaces
+      @client = client
+    end
+
+    def tag_or_raise(workspace_name, tag_name)
+      tag = tag(workspace_name, tag_name)
+      raise "Could not find tag #{tag_name} under workspace #{workspace_name}." if tag.nil?
+
+      tag
+    end
+    cache_method :tag_or_raise, LONG_CACHE_TIME
+
+    def tag(workspace_name, tag_name)
+      workspace = workspaces.workspace_by_name(workspace_name)
+      tags = client.tags.get_tags_for_workspace(workspace_gid: workspace.gid)
+      tags.find { |tag| tag.name == tag_name }
+    end
+    cache_method :tag, LONG_CACHE_TIME
+
+    private
+
+    attr_reader :workspaces, :client
+
+    # bundle exec ./tags.rb
+    # :nocov:
+    class << self
+      def run
+        workspace_name = ARGV[0] || raise('Please pass workspace name as first argument')
+        tag_name = ARGV[1] || raise('Please pass tag name as second argument')
+        tags = Checkoff::Tags.new
+        tag = tags.tag_or_raise(workspace_name, tag_name)
+        puts "Results: #{tag}"
+      end
+    end
+    # :nocov:
+  end
+end
+
+# :nocov:
+abs_program_name = File.expand_path($PROGRAM_NAME)
+Checkoff::Tags.run if abs_program_name == __FILE__
+# :nocov:

data/lib/checkoff/version.rb

@@ -2,5 +2,5 @@
 
 module Checkoff
   # Version of library
-  VERSION = '0.14.1'
+  VERSION = '0.15.0'
 end

data/lib/checkoff/workspaces.rb

@@ -1,32 +1,47 @@
 # frozen_string_literal: true
 
+require 'forwardable'
+require 'cache_method'
+require_relative 'config_loader'
+require_relative 'clients'
+
+# https://developers.asana.com/docs/workspaces
+
 module Checkoff
   # Query different workspaces of Asana projects
   class Workspaces
+    MINUTE = 60
+    HOUR = MINUTE * 60
+    DAY = 24 * HOUR
+    REALLY_LONG_CACHE_TIME = HOUR * 1
+    LONG_CACHE_TIME = MINUTE * 15
+    SHORT_CACHE_TIME = MINUTE
+
     def initialize(config: Checkoff::ConfigLoader.load(:asana),
-                   asana_client: Asana::Client)
+                   clients: Checkoff::Clients.new(config: config),
+                   client: clients.client)
       @config = config
-      @asana_client = asana_client
-    end
-
-    # Returns Asana Ruby API Client object
-    def client
-      @client ||= @asana_client.new do |c|
-        c.authentication :access_token, @config.fetch(:personal_access_token)
-        c.default_headers 'asana-enable' => 'string_ids,new_sections'
-        c.default_headers 'asana-disable' => 'new_user_task_lists'
-      end
+      @client = client
     end
 
     # Pulls an Asana workspace object
-    def workspace_by_name(workspace_name)
+    def workspace(workspace_name)
       client.workspaces.find_all.find do |workspace|
         workspace.name == workspace_name
-      end || raise("Could not find workspace named [#{workspace_name}]")
+      end
+    end
+
+    def workspace_or_raise(workspace_name)
+      workspace = workspace(workspace_name)
+      raise "Could not find workspace #{workspace_name}" if workspace.nil?
+
+      workspace
     end
 
     private
 
+    attr_reader :client
+
     def default_workspace_gid
       @config.fetch(:default_workspace_gid)
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: checkoff
 version: !ruby/object:Gem::Version
-  version: 0.14.1
+  version: 0.15.0
 platform: ruby
 authors:
 - Vince Broz
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-08-08 00:00:00.000000000 Z
+date: 2021-08-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -299,10 +299,14 @@ files:
 - fix.sh
 - lib/checkoff.rb
 - lib/checkoff/cli.rb
+- lib/checkoff/clients.rb
 - lib/checkoff/config_loader.rb
+- lib/checkoff/create-entity.sh
+- lib/checkoff/custom_fields.rb
 - lib/checkoff/projects.rb
 - lib/checkoff/sections.rb
 - lib/checkoff/subtasks.rb
+- lib/checkoff/tags.rb
 - lib/checkoff/tasks.rb
 - lib/checkoff/version.rb
 - lib/checkoff/workspaces.rb