taskmeister 0.0.1 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a586411f621cb4f407507210138370a695cc47c1
-  data.tar.gz: 0b0ad5564af309017e0960f48ca5b744bdb65421
+  metadata.gz: 9765c5b79d2cce230bd4cdc78b11aba686f91adc
+  data.tar.gz: 7a1f828b681135fbedb8fc8209c6cd799fdf804d
 SHA512:
-  metadata.gz: 4cea1c245ba6fe4d21ef1f24fd3f6cbcb4fe11c132dd615a18104ebc997c6acf0cea80a237649d5f407a1fc11c99fdb8f626bcaf18844e9668958213faf0ca34
-  data.tar.gz: 39006a1aef684454313d598b7bbf4f3382ced4939209ed3e6932c61272e02fe04957a7057fea8f4164d01235644d63ba09db8014d722aca6eb42e618812f8acb
+  metadata.gz: 3e92cac2efc981db979f8723c8a0a4590f5e42674779e1393d234523846c1b23574d6f91ac1042821c58a08e94df5f15c49c7d147f47e4722571cb913a22507a
+  data.tar.gz: 193f0e2d6df20a5961622d1d4c0be8e5183773b4ba9a4b8ed149fa5fffd37cd85d0cc76567c46213731f9712e2066a56d72af97f8dfcb4f43fc22cf56680e7f7

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--warnings
+--require spec_helper

data/README.md

@@ -1,38 +1,79 @@
 # Taskmeister
 
-Simple task management modelled after [t](http://stevelosh.com/projects/t/).
+Simple command line task management modelled after [t](http://stevelosh.com/projects/t/).
 
-## Installation
+I like the simplicity of t but there are a couple of changes I wanted.
+
+First: I like to have separate task lists per project. So I infer the task list
+name from the current project directory. It finds a project directory by walking
+up from the current directory until it finds a `.git` or `.hg` directory in it.
+
+Second: I like to have a short list of notes accompanying my tasks. You can add
+notes beneath your task. They can be edited via Vim with `taskmeister -e` or
+`taskmeister -e id` to seek to a specific task.
 
-Add this line to your application's Gemfile:
+Third: I format my task files in Markdown so that when I open them on my phone
+via a Markdown-enabled editor they look nice. The format is still simple:
 
-    gem 'taskmeister'
+```markdown
+Add authorisation - [id](aaf83a9b-02f7-4cc0-8ee1-4d98b98903b8)
 
-And then execute:
+> Some notes to go with the task above.
+>
+> Maybe paste in some links or other interesting information for later.
 
-    $ bundle
+Refactor the task model - [id](ae0cce15-456d-48c0-a2e2-69d5f567e092)
+Update the README - [id](a5d4d3a9-2b9a-427a-9047-b47c6aec8f93)
+```
 
-Or install it yourself as:
+## Installation
+
+Install via Rubygems:
 
-    $ gem install taskmeister
+```sh
+$ gem install taskmeister
+```
 
 ## Usage
 
-TODO: Write usage instructions here
+```sh
+$ taskmeister --help
+Usage: taskmeister [options] TASK TEXT
+
+Specific options:
+  If no options are specified TASK TEXT is added as a new task.
 
-## Notes
+    -t, --task-dir DIRECTORY         The DIRECTORY where your task lists are stored. (Defaults to pwd)
+    -l, --list NAME                  The task list to use.
+                                       Will use a list named after your current project directory if not supplied.
+                                       A project directory is found by walking up from the current directory and stopping if a .git or .hg directory is found.
+    -d, --done TASK_ID               Finish a task
+    -s, --show TASK_ID               Show a task list item and its notes
+    -e, --edit TASK_ID               Edit a task in Vim
+    -r, --replace TASK_ID            Replace a task description
 
-Just trigger vim to edit the file in place with the following commands
+Common options:
+    -h, --help                       Show this message
+        --version                    Show version
+```
 
-    "${EDITOR:-vi}" file.txt
-    vim +4 README.md
-    vim +/killproc file.md
-    vim +/guid file.md
+I store my task files in Dropbox so I have the following shell alias set:
+
+```sh
+alias t='taskmeister -t ~/Dropbox/Tasks'
+```
+
+I let Taskmeister determine the task list name from my current directory. If
+you want a set a specific task list you could add that to your alias.
+
+```sh
+alias t='taskmeister -t ~/Dropbox/Tasks -l mytasks.md'
+```
 
 ## Contributing
 
-1. Fork it ( https://github.com/[my-github-username]/taskmeister/fork )
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create a new Pull Request
+Fork the project on Github, add tests for your changes, and submit a well described pull request.
+
+## Copyright
+
+Copyright (c) 2014 Ray Grasso. See LICENSE.txt for further details.

data/Rakefile

@@ -1,2 +1,12 @@
 require "bundler/gem_tasks"
 
+$:.unshift(File.dirname(__FILE__) + '/../../lib')
+require 'cucumber/rake/task'
+
+Cucumber::Rake::Task.new
+
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/taskmeister

@@ -1,7 +1,10 @@
 #!/usr/bin/env ruby
 
-$LOAD_PATH << File.expand_path('../../lib', __FILE__)
+$LOAD_PATH << File.expand_path("../../lib", __FILE__)
 
-require 'taskmeister'
+# Exit cleanly from an early interrupt
+Signal.trap("INT") { exit 1 }
 
-puts "Coming soon..."
+require "taskmeister"
+
+Taskmeister::Cli::Main.new(ARGV.dup).execute!

data/features/add.feature

@@ -0,0 +1,17 @@
+Feature: taskmeister adds a task to the list
+
+  Scenario: Project directory with task list
+    Given a file named "mylist.md" with:
+      """
+Task one - [id](aaf83a9b-02f7-4cc0-8ee1-4d98b98903b8)
+
+> Notes line one
+> Notes line two
+
+Task two - [id](ae0cce15-456d-48c0-a2e2-69d5f567e092)
+Task three - [id](a5d4d3a9-2b9a-427a-9047-b47c6aec8f93)
+      """
+    When I successfully run `taskmeister --list mylist.md A new task`
+    And I successfully run `taskmeister --list mylist.md`
+    Then the output should contain "A new task"
+

data/features/done.feature

@@ -0,0 +1,17 @@
+Feature: taskmeister removes finished tasks from the list
+
+  Scenario: Project directory with task list
+    Given a file named "mylist.md" with:
+      """
+Task one - [id](aaf83a9b-02f7-4cc0-8ee1-4d98b98903b8)
+
+> Notes line one
+> Notes line two
+
+Task two - [id](ae0cce15-456d-48c0-a2e2-69d5f567e092)
+Task three - [id](a5d4d3a9-2b9a-427a-9047-b47c6aec8f93)
+      """
+    When I successfully run `taskmeister --list mylist.md --done a`
+    And I successfully run `taskmeister --list mylist.md`
+    Then the output should not contain "Task one"
+

data/features/list.feature

@@ -0,0 +1,18 @@
+Feature: taskmeister lists the contents of a task list
+
+  Scenario: Normal directory with explicit task list
+    Given a file named "mylist.md" with:
+      """
+Task one - [id](aaf83a9b-02f7-4cc0-8ee1-4d98b98903b8)
+
+> Notes line one
+> Notes line two
+
+Task two - [id](ae0cce15-456d-48c0-a2e2-69d5f567e092)
+Task three - [id](a5d4d3a9-2b9a-427a-9047-b47c6aec8f93)
+      """
+    When I successfully run `taskmeister --list mylist.md`
+    Then the output should contain "a  - Task one »"
+    And  the output should contain "ae - Task two"
+    And  the output should contain "a5 - Task three"
+

data/features/project_dir.feature

@@ -0,0 +1,22 @@
+Feature: taskmeister infers the name of your task list from your current project directory
+
+  Scenario: Project directory with task list
+    Given a directory named "project"
+    And a directory named "project/.git"
+    And a directory named "project/child"
+    And a file named "project.md" with:
+      """
+Task one - [id](aaf83a9b-02f7-4cc0-8ee1-4d98b98903b8)
+
+> Notes line one
+> Notes line two
+
+Task two - [id](ae0cce15-456d-48c0-a2e2-69d5f567e092)
+Task three - [id](a5d4d3a9-2b9a-427a-9047-b47c6aec8f93)
+      """
+    And I cd to "project/child"
+    When I successfully run `taskmeister --task-dir ../../`
+    Then the output should contain "a  - Task one »"
+    And  the output should contain "ae - Task two"
+    And  the output should contain "a5 - Task three"
+

data/features/replace.feature

@@ -0,0 +1,17 @@
+Feature: taskmeister replaces a task in the list
+
+  Scenario: Project directory with task list
+    Given a file named "mylist.md" with:
+      """
+Task one - [id](aaf83a9b-02f7-4cc0-8ee1-4d98b98903b8)
+
+> Notes line one
+> Notes line two
+
+Task two - [id](ae0cce15-456d-48c0-a2e2-69d5f567e092)
+Task three - [id](a5d4d3a9-2b9a-427a-9047-b47c6aec8f93)
+      """
+    When I successfully run `taskmeister --list mylist.md -r a A new task`
+    And I successfully run `taskmeister --list mylist.md`
+    Then the output should contain "a  - A new task"
+

data/features/show.feature

@@ -0,0 +1,18 @@
+Feature: taskmeister shows the details of a task in the list
+
+  Scenario: Project directory with task list
+    Given a file named "mylist.md" with:
+      """
+Task one - [id](aaf83a9b-02f7-4cc0-8ee1-4d98b98903b8)
+
+> Notes line one
+> Notes line two
+
+Task two - [id](ae0cce15-456d-48c0-a2e2-69d5f567e092)
+Task three - [id](a5d4d3a9-2b9a-427a-9047-b47c6aec8f93)
+      """
+    When I successfully run `taskmeister --list mylist.md --show a`
+    Then the output should contain "Task one - [id](aaf83a9b-02f7-4cc0-8ee1-4d98b98903b8)"
+    And the output should contain "> Notes line one"
+    And the output should contain "> Notes line two"
+

data/features/support/env.rb

@@ -0,0 +1,14 @@
+require 'rubygems'
+require 'bundler/setup'
+
+require 'aruba/cucumber'
+
+$LOAD_PATH << File.expand_path('../../../lib', __FILE__)
+require 'taskmeister'
+require 'fileutils'
+
+require 'aruba'
+require 'aruba/in_process'
+
+Aruba::InProcess.main_class = Taskmeister::Cli::Main
+Aruba.process = Aruba::InProcess

data/lib/taskmeister.rb

@@ -1,5 +1,8 @@
 require "taskmeister/version"
-
-module Taskmeister
-  # Your code goes here...
-end
+require "taskmeister/task"
+require "taskmeister/task_list"
+require "taskmeister/task_list_reader"
+require "taskmeister/task_list_writer"
+require "taskmeister/cli/task_list_name"
+require "taskmeister/cli/main"
+require "taskmeister/cli/options"

data/lib/taskmeister/cli/main.rb

@@ -0,0 +1,77 @@
+require "pathname"
+
+module Taskmeister
+  module Cli
+    class Main
+      def initialize(argv, stdin=STDIN, stdout=STDOUT, stderr=STDERR, kernel=Kernel)
+        @argv, @stdin, @stdout, @stderr, @kernel = argv, stdin, stdout, stderr, kernel
+      end
+
+      def execute!
+        options = Options.new(@stdout, @kernel).parse(@argv)
+
+        task_list_path = Pathname.new(options.task_dir) + task_list_name(options)
+
+        task_list = Taskmeister::TaskListReader.from_markdown_file(task_list_path)
+
+        run_command(options, task_list_path, task_list)
+      end
+
+      private
+
+      def task_list_name(options)
+        task_list_name = options.list || TaskListName.from_project_dir(Pathname.getwd)
+
+        unless task_list_name
+          @stdout.puts "Could not find a project directory. Please specify a task list."
+          @kernel.exit 1
+        end
+
+        task_list_name
+      end
+
+      def run_command(options, task_list_path, task_list)
+        case options.command
+        when Commands::LIST
+          @stdout.puts task_list.to_short_list
+
+        when Commands::SHOW
+
+          @stdout.puts task_list.details(options.task_id)
+
+        when Commands::EDIT
+
+          task = task_list[options.task_id]
+
+          search_path = task ? "+/#{task.id} " : ""
+          system "vim #{search_path}#{task_list_path}"
+
+        when Commands::ADD
+
+          update_task_list(task_list, task_list_path) {
+            task_list.add(Taskmeister::Task.create(options.task_text))
+          }
+
+        when Commands::DONE
+
+          update_task_list(task_list, task_list_path) {
+            task_list.complete options.task_id
+          }
+
+        when Commands::REPLACE
+
+          update_task_list(task_list, task_list_path) {
+            task_list.replace options.task_id, options.task_text
+          }
+
+        end
+
+        @kernel.exit 0
+      end
+
+      def update_task_list(task_list, file_path)
+        Taskmeister::TaskListWriter.to_markdown_file(task_list, file_path) if yield
+      end
+    end
+  end
+end

data/lib/taskmeister/cli/options.rb

@@ -0,0 +1,108 @@
+require "optparse"
+require "ostruct"
+require "pathname"
+
+module Taskmeister
+  module Cli
+    module Commands
+      ADD     = "add"
+      LIST    = "list"
+      REPLACE = "replace"
+      EDIT    = "edit"
+      SHOW    = "show"
+      DONE    = "done"
+    end
+
+    class Options
+      def initialize(stdout = STDOUT, kernel = Kernel)
+        @stdout = stdout
+        @kernel = kernel
+      end
+
+      def parse(args)
+        options = default_options
+
+        opt_parser = OptionParser.new do |opts|
+          opts.program_name = "taskmeister"
+          opts.banner = "Usage: taskmeister [options] TASK TEXT"
+
+          opts.separator ""
+          opts.separator "Specific options:"
+          opts.separator "  If no options are specified TASK TEXT is added as a new task."
+          opts.separator ""
+
+          opts.on("-t", "--task-dir DIRECTORY",
+                  "The DIRECTORY where your task lists are stored. (Defaults to pwd)") do |dir|
+            options.task_dir = Pathname.new(dir)
+          end
+
+          opts.on("-l", "--list NAME",
+                  "The task list to use.",
+                  "  Will use a list named after your current project directory if not supplied.",
+                  "  A project directory is found by walking up from the current directory and stopping if a .git or .hg directory is found.") do |list|
+            options.list = Pathname.new(list)
+          end
+
+          opts.on("-d", "--done TASK_ID",
+                  "Finish a task") do |task_id|
+            options.command = Commands::DONE
+            options.task_id = task_id
+          end
+
+          opts.on("-s", "--show TASK_ID",
+                  "Show a task list item and its notes") do |task_id|
+            options.command = Commands::SHOW
+            options.task_id = task_id
+          end
+
+          opts.on("-e", "--edit [TASK_ID]",
+                  "Edit task list in Vim",
+                  "  Will search for a specific task if TASK_ID is provided") do |task_id|
+            options.command = Commands::EDIT
+            options.task_id = task_id
+          end
+
+          opts.on("-r", "--replace TASK_ID",
+                  "Replace a task description") do |task_id|
+            options.command = Commands::REPLACE
+            options.task_id = task_id
+          end
+
+          opts.separator ""
+          opts.separator "Common options:"
+
+          opts.on_tail("-h", "--help", "Show this message") do
+            @stdout.puts opts
+            @kernel.exit
+          end
+
+          opts.on_tail("--version", "Show version") do
+            @stdout.puts Taskmeister::VERSION
+            @kernel.exit
+          end
+        end
+
+        task_text = opt_parser.parse!(args)
+
+        options.task_text = task_text.join(" ") unless task_text.empty?
+
+        # If there is task text and the default command hasn't been overwritten
+        # by the user, make the command add
+        if !task_text.empty? and options.command == Commands::LIST
+          options.command = Commands::ADD
+        end
+
+        options
+      end
+
+      private
+
+      def default_options
+        OpenStruct.new.tap do |o|
+          o.command  = Commands::LIST
+          o.task_dir = Pathname.getwd
+        end
+      end
+    end
+  end
+end

data/lib/taskmeister/cli/task_list_name.rb

@@ -0,0 +1,28 @@
+require "pathname"
+
+module Taskmeister
+  module Cli
+    class TaskListName
+      def self.from_project_dir(dir)
+        project_dir = find_project_dir(dir)
+
+        return project_dir.basename.to_s + ".md" if project_dir
+      end
+
+      def self.find_project_dir(dir)
+        return dir if dir.children.any? { |child| is_project_dir?(child) }
+
+        return nil if dir == Pathname.new("/") || dir.parent.nil?
+
+        return self.find_project_dir(dir.parent)
+      end
+
+      def self.is_project_dir?(dir)
+        dir.directory? && (
+          dir.basename == Pathname.new(".git") ||
+          dir.basename == Pathname.new(".hg")
+        )
+      end
+    end
+  end
+end

data/lib/taskmeister/task.rb

@@ -0,0 +1,48 @@
+require 'securerandom'
+
+module Taskmeister
+  class Task
+    attr_reader :text, :notes, :id
+
+    def initialize(text, id, notes)
+      @text, @id, @notes = text, id, notes
+    end
+
+    def notes?
+      notes && !notes.empty?
+    end
+
+    def to_markdown
+      [ "#{text} - [id](#{id})" ].tap do |a|
+        return a unless notes.match(/\S/)
+        a << ""
+        a.concat notes.split("\n").map { |n|
+          n.size > 0 ? "> #{n}" : ">"
+        }
+        a << ""
+      end
+    end
+
+    def self.create(text)
+      self.new(text, SecureRandom.uuid, "")
+    end
+
+    def self.from_markdown(lines)
+      task, *notes = *lines
+
+      text, id = task_attributes(task)
+
+      notes = notes.map { |l| l.gsub(/\A> ?/, "") }.join("\n")
+
+      self.new(text, id, notes)
+    end
+
+    def self.task_attributes(line)
+      matches = line.match(/\A(.+) - \[id\]\(([\w-]+)\)\z/)
+
+      fail "Invalid task: #{line}" unless matches
+
+      [matches[1], matches[2]]
+    end
+  end
+end

data/lib/taskmeister/task_list.rb

@@ -0,0 +1,58 @@
+module Taskmeister
+  class TaskList
+    def initialize(tasks)
+      @hash = {}
+
+      tasks.each do |t|
+        add(t)
+      end
+    end
+
+    def to_short_list
+      longest_id = @hash.keys.max_by(&:length)
+      @hash.map { |id, task|
+        marker = task.notes? ? " »" : ""
+        "%-#{longest_id.length}s - %s%s" % [id, task.text, marker]
+      }
+    end
+
+    def tasks
+      @hash.values
+    end
+
+    def [](key)
+      @hash[key]
+    end
+
+    def add(task)
+      prefix = assign_short_code_to_task(task)
+      @hash[prefix] = task
+    end
+
+    def complete(short_id)
+      @hash.delete(short_id)
+    end
+
+    def replace(short_id, new_text)
+      task = self[short_id]
+      return unless task
+
+      @hash[short_id] = Task.new(new_text, task.id, task.notes)
+    end
+
+    def details(short_id)
+      return [] unless @hash.has_key?(short_id)
+
+      self[short_id].to_markdown
+    end
+
+    private
+
+    def assign_short_code_to_task(task)
+      task.id.length.times do |i|
+        prefix = task.id.slice(0, i + 1)
+        return prefix unless @hash.has_key?(prefix)
+      end
+    end
+  end
+end

data/lib/taskmeister/task_list_reader.rb

@@ -0,0 +1,25 @@
+module Taskmeister
+  class TaskListReader
+    def self.from_markdown(file_lines)
+      grouped_lines = \
+        file_lines.map(&:chomp)
+                  .reject(&:empty?)
+                  .reduce([]) do |acc, l|
+                    acc << [l]    if l.match(/\A[^\s>]/) # A new task
+                    acc.last << l if l.match(/\A>/)      # A line of note for the latest task
+                    acc
+                  end
+
+      tasks = grouped_lines.map do |l|
+        Task.from_markdown(l)
+      end
+
+      TaskList.new tasks
+    end
+
+    def self.from_markdown_file(path)
+      lines = File.exist?(path) ? File.readlines(path) : []
+      from_markdown lines
+    end
+  end
+end

data/lib/taskmeister/task_list_writer.rb

@@ -0,0 +1,14 @@
+module Taskmeister
+  class TaskListWriter
+    def self.to_markdown(task_list)
+      task_list.tasks.map(&:to_markdown).flatten
+    end
+
+    def self.to_markdown_file(task_list, file_path)
+      lines = self.to_markdown(task_list)
+      File.open(file_path, "w") do |f|
+        f.puts lines
+      end
+    end
+  end
+end

data/lib/taskmeister/version.rb

@@ -1,3 +1,3 @@
 module Taskmeister
-  VERSION = "0.0.1"
+  VERSION = "0.9.0"
 end

data/spec/lib/taskmeister/task_list_reader_spec.rb

@@ -0,0 +1,77 @@
+require "taskmeister/task_list_reader"
+require "taskmeister/task_list"
+require "taskmeister/task"
+
+module Taskmeister
+  RSpec.describe TaskListReader do
+    describe ".from_markdown" do
+
+      before do
+        allow(Task).to receive(:from_markdown).and_return(double(Task))
+        allow(TaskList).to receive(:new).and_return(double(TaskList))
+      end
+
+      let(:it) { described_class.from_markdown(lines) }
+
+      describe "passed an empty list of lines" do
+        let(:lines) { [] }
+
+        it "creates an empty task list" do
+          expect(Task).not_to receive(:from_markdown)
+          expect(TaskList).to receive(:new).with([])
+          it
+        end
+      end
+
+      describe "passed a list of simple tasks" do
+        let(:lines) { [
+          "Task number 1\n",
+          "Task number 2\n"
+          ]
+        }
+
+        it "creates a task for each line, stripping new lines" do
+          expect(Task).to receive(:from_markdown).with([ "Task number 1" ])
+          expect(Task).to receive(:from_markdown).with([ "Task number 2" ])
+          it
+        end
+      end
+
+      describe "passed a list of tasks with notes" do
+        let(:lines) { [
+          "Task number 1\n",
+          "\n",
+          "> note line 1\n",
+          "> note line 2\n",
+          "\n",
+          "Task number 2\n",
+          "Task number 3\n",
+          "\n",
+          "> note line 3\n",
+          "> note line 4\n",
+          "",
+          "",
+          ]
+        }
+
+        it "creates a task for each line with their associated notes, stripping newlines" do
+          expect(Task).to receive(:from_markdown).with([
+            "Task number 1",
+            "> note line 1",
+            "> note line 2",
+          ])
+          expect(Task).to receive(:from_markdown).with([
+            "Task number 2"
+          ])
+          expect(Task).to receive(:from_markdown).with([
+            "Task number 3",
+            "> note line 3",
+            "> note line 4",
+          ])
+
+          it
+        end
+      end
+    end
+  end
+end

data/spec/lib/taskmeister/task_list_spec.rb

@@ -0,0 +1,106 @@
+require "taskmeister/task_list"
+require "taskmeister/task"
+
+module Taskmeister
+  RSpec.describe TaskList do
+
+    let(:task1) { Task.new("task 1", "78dc2561-8c9a-4780-a560-56e1e14f2ed3", nil) }
+    let(:task2) { Task.new("task 2", "b2110029-ffa0-4e54-985a-2aa6d1bed53b", nil) }
+    let(:task3) { Task.new("task 3", "1c890df0-97a5-4310-9b01-374983416af7", "a note") }
+    let(:task4) { Task.new("task 4", "1c891df0-97a5-4310-9b01-374983416af7", nil) }
+    let(:task5) { Task.new("task 5", "ef0915ee-3d11-4358-b12c-15a4ab0d1d26", nil) }
+    let(:task6) { Task.new("task 6", "f2a0d281-f323-4909-8547-d4af5315a295", nil) }
+    let(:task7) { Task.new("task 7", "f2a0d281-4323-4909-8547-d4af5315a295", nil) }
+
+    let(:tasks) { [
+      task1, task2, task3, task4, task5, task6, task7
+    ]}
+
+    let(:list) { described_class.new(tasks) }
+
+    describe "#[]" do
+      it "uses the shortest common prefix to index a task" do
+        expect(list["7"]).to eq task1
+        expect(list["b"]).to eq task2
+        expect(list["1"]).to eq task3
+        expect(list["1c"]).to eq task4
+        expect(list["e"]).to eq task5
+        expect(list["f"]).to eq task6
+        expect(list["f2"]).to eq task7
+      end
+    end
+
+    describe "#to_short_list" do
+      subject { list.to_short_list }
+
+      it "returns an array of short ids and task texts with markers for those that have notes" do
+        expect(subject).to eq([
+          "7  - task 1",
+          "b  - task 2",
+          "1  - task 3 »",
+          "1c - task 4",
+          "e  - task 5",
+          "f  - task 6",
+          "f2 - task 7"
+        ])
+      end
+    end
+
+    describe "#complete" do
+      it "removes the identified task" do
+        expect(list["7"]).to eq task1
+        result = list.complete("7")
+        expect(result).to be_truthy
+        expect(list["7"]).to be_nil
+      end
+
+      it "ignores non-existent tasks" do
+        result = list.complete("345")
+        expect(result).to be_falsy
+        expect(list.tasks.size).to eq tasks.size
+      end
+    end
+
+    describe "#replace" do
+      it "replaces the text of the specified task" do
+        result = list.replace("7", "A new task text")
+        expect(result).to be_truthy
+        task = list["7"]
+        expect(task.text).to eq "A new task text"
+      end
+
+      it "ignores a non-existent task" do
+        result = list.replace("345", "A new task text")
+        expect(result).to be_falsy
+        expect(list.tasks.size).to eq tasks.size
+      end
+    end
+
+    describe "#details" do
+      before do
+        allow_any_instance_of(Task).to receive(:to_markdown).and_return([
+          "line 1",
+          "line 2"
+        ])
+      end
+
+      it "returns an empty list if the id doesn't exist" do
+        expect(list.details("34")).to eq []
+      end
+
+      it "returns the lines of a task" do
+        expect(list.details("7")).to eq ["line 1", "line 2"]
+      end
+    end
+
+    describe "#add" do
+      it "adds the task and assigns it a short id" do
+        task8 = Task.new("task 8", "f23891df0-97a5-4310-9b01-374983416af7", nil)
+        result = list.add(task8)
+        expect(result).to be_truthy
+        expect(list.tasks.size).to eq 8
+        expect(list["f23"]).to eq task8
+      end
+    end
+  end
+end

data/spec/lib/taskmeister/task_list_writer_spec.rb

@@ -0,0 +1,25 @@
+require "taskmeister/task_list_writer"
+require "taskmeister/task_list"
+require "taskmeister/task"
+
+module Taskmeister
+  RSpec.describe TaskListWriter do
+    describe ".to_markdown" do
+      let(:task1) { double(Task, to_markdown: ["line1", "line2"]) }
+      let(:task2) { double(Task, to_markdown: ["line3", "line4"]) }
+      let(:task_list) { double(TaskList, tasks: [ task1, task2 ]) }
+
+      subject { described_class.to_markdown(task_list) }
+
+      it "returns a concatenated list of all the underlying task markdown" do
+        expect(subject).to eq [
+          "line1",
+          "line2",
+          "line3",
+          "line4"
+        ]
+      end
+    end
+  end
+end
+

data/spec/lib/taskmeister/task_spec.rb

@@ -0,0 +1,81 @@
+require "taskmeister/task"
+
+module Taskmeister
+  RSpec.describe Task do
+    describe ".from_markdown" do
+      subject { described_class.from_markdown(lines) }
+
+      describe "passed a single valid line" do
+        let(:lines) { [
+          "A task name - [id](78dc2561-8c9a-4780-a560-56e1e14f2ed3)"
+        ]}
+
+        it "sets the name and id of the task" do
+          expect(subject.id).to eq "78dc2561-8c9a-4780-a560-56e1e14f2ed3"
+          expect(subject.text).to eq "A task name"
+          expect(subject.notes).to eq ""
+        end
+      end
+
+      describe "passed a single valid line and notes" do
+        let(:lines) { [
+          "A task name - [id](78dc2561-8c9a-4780-a560-56e1e14f2ed3)",
+          "> line one of a note",
+          ">",
+          "> line two of a note"
+        ]}
+
+        it "sets the name and id of the task" do
+          expect(subject.id).to eq "78dc2561-8c9a-4780-a560-56e1e14f2ed3"
+          expect(subject.text).to eq "A task name"
+        end
+
+        it "concatenates together the notes of the task" do
+          expect(subject.notes).to eq "line one of a note\n\nline two of a note"
+        end
+      end
+
+      describe "passed a single invalid line" do
+        let(:lines) { [
+          "A task name"
+        ]}
+
+        it "raises an error" do
+          expect{ subject }.to raise_error
+        end
+      end
+    end
+
+    describe ".create" do
+      it "returns a task with the specified text and a new id" do
+        task = described_class.create("My task text")
+        expect(task.text).to eq "My task text"
+        expect(task.id).to match(/[\w-]+/)
+        expect(task.notes).to eq ""
+      end
+    end
+
+    describe "#to_markdown" do
+      it "returns a list of markdown-formatted lines" do
+        task = described_class.new("task 8", "f23891df0-97a5-4310-9b01-374983416af7", " ")
+        expect(task.to_markdown).to eq [
+          "task 8 - [id](f23891df0-97a5-4310-9b01-374983416af7)"
+        ]
+      end
+
+      it "returns a list of markdown-formatted lines including notes" do
+        task = described_class.new("task 8", "f23891df0-97a5-4310-9b01-374983416af7",
+                        "First line of a note\nsecond line\n\nthird line")
+        expect(task.to_markdown).to eq [
+          "task 8 - [id](f23891df0-97a5-4310-9b01-374983416af7)",
+          "",
+          "> First line of a note",
+          "> second line",
+          ">",
+          "> third line",
+          ""
+        ]
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,46 @@
+RSpec.configure do |config|
+
+=begin
+  # These two settings work together to allow you to limit a spec run
+  # to individual examples or groups you care about by tagging them with
+  # `:focus` metadata. When nothing is tagged with `:focus`, all examples
+  # get run.
+  config.filter_run :focus
+  config.run_all_when_everything_filtered = true
+
+  # Many RSpec users commonly either run the entire suite or an individual
+  # file, and it's useful to allow more verbose output when running an
+  # individual spec file.
+
+  # Print the 10 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  config.profile_examples = 10
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce
+  # test failures related to randomization by passing the same `--seed` value
+  # as the one that triggered the failure.
+  Kernel.srand config.seed
+=end
+
+  if config.files_to_run.one?
+    config.default_formatter = 'doc'
+  end
+
+  config.expect_with :rspec do |expectations|
+    expectations.syntax = :expect
+  end
+
+  config.mock_with :rspec do |mocks|
+    mocks.syntax = :expect
+
+    mocks.verify_partial_doubles = true
+  end
+end

data/taskmeister.gemspec

@@ -8,8 +8,8 @@ Gem::Specification.new do |spec|
   spec.version       = Taskmeister::VERSION
   spec.authors       = ["Ray Grasso"]
   spec.email         = ["ray.grasso@gmail.com"]
-  spec.summary       = %q{A simple command line task manager.}
-  spec.description   = %q{Another command line task manager. You know, for the heck of it.}
+  spec.summary       = %q{Another command line task manager.}
+  spec.description   = %q{Another command line task manager. You know, because I'm special.}
   spec.homepage      = "https://www.github.com/grassdog/taskmeister"
   spec.license       = "MIT"
 
@@ -19,5 +19,8 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_development_dependency "bundler", "~> 1.6"
-  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rake", "~> 10"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "aruba", "~> 0.6"
+  spec.add_development_dependency "pry-byebug", "~> 1.3"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: taskmeister
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.9.0
 platform: ruby
 authors:
 - Ray Grasso
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-07-28 00:00:00.000000000 Z
+date: 2014-07-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -28,17 +28,59 @@ dependencies:
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: aruba
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
-description: Another command line task manager. You know, for the heck of it.
+        version: '1.3'
+description: Another command line task manager. You know, because I'm special.
 email:
 - ray.grasso@gmail.com
 executables:
@@ -47,14 +89,34 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".rspec"
 - ".ruby-version"
 - Gemfile
 - LICENSE.txt
 - README.md
 - Rakefile
 - bin/taskmeister
+- features/add.feature
+- features/done.feature
+- features/list.feature
+- features/project_dir.feature
+- features/replace.feature
+- features/show.feature
+- features/support/env.rb
 - lib/taskmeister.rb
+- lib/taskmeister/cli/main.rb
+- lib/taskmeister/cli/options.rb
+- lib/taskmeister/cli/task_list_name.rb
+- lib/taskmeister/task.rb
+- lib/taskmeister/task_list.rb
+- lib/taskmeister/task_list_reader.rb
+- lib/taskmeister/task_list_writer.rb
 - lib/taskmeister/version.rb
+- spec/lib/taskmeister/task_list_reader_spec.rb
+- spec/lib/taskmeister/task_list_spec.rb
+- spec/lib/taskmeister/task_list_writer_spec.rb
+- spec/lib/taskmeister/task_spec.rb
+- spec/spec_helper.rb
 - taskmeister.gemspec
 homepage: https://www.github.com/grassdog/taskmeister
 licenses:
@@ -79,5 +141,17 @@ rubyforge_project:
 rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
-summary: A simple command line task manager.
-test_files: []
+summary: Another command line task manager.
+test_files:
+- features/add.feature
+- features/done.feature
+- features/list.feature
+- features/project_dir.feature
+- features/replace.feature
+- features/show.feature
+- features/support/env.rb
+- spec/lib/taskmeister/task_list_reader_spec.rb
+- spec/lib/taskmeister/task_list_spec.rb
+- spec/lib/taskmeister/task_list_writer_spec.rb
+- spec/lib/taskmeister/task_spec.rb
+- spec/spec_helper.rb