todo-curses 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2dd49a99988df6a2152060b4120949b41d8594f3
+  data.tar.gz: 54d30df0e6700095ba7603ff6846391124527a1c
+SHA512:
+  metadata.gz: 32d463bbd95f1c0cb53f9fe5e6b867d571fd665d9d76717ef50e324382591f037664058a0c77ff8898593f6069af8b4058c5fee086bfa07049cdd3564cb77b48
+  data.tar.gz: 84291c4338fae4c798d3c73b57ae18b031f42dcfc238b49a73e9f32a3fed4383b161481811300ed9de2714ad678a7a6e4ff6d22bf1c95102738979941c545b4c

data/.gitignore

@@ -0,0 +1,5 @@
+todo.txt
+todo.txt.bak
+done.txt
+log.txt
+*.gem

data/Gemfile

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+gemspec
+
+gem 'ncursesw'
+

data/Gemfile.lock

@@ -0,0 +1,49 @@
+PATH
+  remote: .
+  specs:
+    todo (0.0.1)
+      gli (= 2.13.4)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    aruba (0.6.1)
+      childprocess (>= 0.3.6)
+      cucumber (>= 1.1.1)
+      rspec-expectations (>= 2.7.0)
+    builder (3.2.2)
+    childprocess (0.5.5)
+      ffi (~> 1.0, >= 1.0.11)
+    cucumber (1.3.18)
+      builder (>= 2.1.2)
+      diff-lcs (>= 1.1.3)
+      gherkin (~> 2.12)
+      multi_json (>= 1.7.5, < 2.0)
+      multi_test (>= 0.1.1)
+    diff-lcs (1.2.5)
+    ffi (1.9.10)
+    gherkin (2.12.2)
+      multi_json (~> 1.3)
+    gli (2.13.4)
+    multi_json (1.11.2)
+    multi_test (0.1.1)
+    ncursesw (1.4.9)
+    rake (10.4.2)
+    rdoc (4.2.0)
+    rspec-expectations (3.3.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.3.0)
+    rspec-support (3.3.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  aruba
+  ncursesw
+  rake
+  rdoc
+  todo!
+
+BUNDLED WITH
+   1.11.2

data/README.rdoc

@@ -0,0 +1,69 @@
+= TODO-Curses
+
+This is a super crude first pass at a terminal application for
+todo.txt files. A lot of the features are based on how
+{todotxt.net}[todotxt.net] handles things. I really liked the overall
+design of the application, just not the fact that it didn't run in my
+linux terminal. To solve this, I decided to roll my own using Ruby and
+Ncurses. There was already a pretty robust library for handling todo.txt
+files, and Ncurses was something I'd been meaning to learn for a while.
+
+No doubt there's a ton of nasty code in here. Please help me along if you're
+interested. I'm sure there's a lot that can be refactored.
+
+== Current features
+
+- Open todo.txt files and view a scrollable list of items
+- Move to the next item with `j`
+- Move to the prev item with `k`
+- Create new items with `n`
+- Toggle done / not done state with `x`
+- Move priority down with `shift+j`
+- Move priority up with `shift+k`
+- Completed tasks are archived to done.txt on exit
+
+== Planned features
+
+- Use ctrl instead of shift for priority change
+- Color code priorities
+- Add a spacer between priority groups
+- Priority view with `ctrl+1`
+- Project view with `ctrl+2`
+- Strip out application wrapper; not needed
+- Prep for release as a gem
+- If no argument is given, open the default file. Default tbd.
+
+== Ideas for later
+
+    Shift+J: Cycle through displays (Priority, project, etc.)
+    F: filter tasks (free-text, one filter condition per line)
+    T: append text to selected tasks
+    O or Ctrl+O: open todo.txt file
+    C or Ctrl+N: new todo.txt file
+
+== Things not included
+
+    A: archive tasks
+    Ctrl+C: copy task to clipboard
+    Ctrl+Shift+C: copy task to edit field
+    Win+Alt+T: hide/unhide windows
+    0: clear filter
+    1-9: apply numbered filter preset
+
+== Keyboard shortcut ideas
+
+    N: new task
+    J: next task
+    K: prev task
+    X: toggle task completion
+    D or Del or Backspace: delete task (with confirmation)
+    E or F2: update task
+    I: set priority
+    . or F5: reload tasks from file
+    ?: show help
+    Shift+K: increase priority
+    Shift+J: decrease priority
+    Alt+Left/Right: clear priority
+    Ctrl+Alt+Up: increase due date by 1 day
+    Ctrl+Alt+Down: decrease due date by 1 day
+    Ctrl+Alt+Left/Right: remove due date

data/Rakefile

@@ -0,0 +1,44 @@
+require 'rake/clean'
+require 'rubygems'
+require 'rubygems/package_task'
+require 'rdoc/task'
+require 'cucumber'
+require 'cucumber/rake/task'
+Rake::RDocTask.new do |rd|
+  rd.main = "README.rdoc"
+  rd.rdoc_files.include("README.rdoc","lib/**/*.rb","bin/**/*")
+  rd.title = 'Your application title'
+end
+
+spec = eval(File.read('todo.gemspec'))
+
+Gem::PackageTask.new(spec) do |pkg|
+end
+CUKE_RESULTS = 'results.html'
+CLEAN << CUKE_RESULTS
+desc 'Run features'
+Cucumber::Rake::Task.new(:features) do |t|
+  opts = "features --format html -o #{CUKE_RESULTS} --format progress -x"
+  opts += " --tags #{ENV['TAGS']}" if ENV['TAGS']
+  t.cucumber_opts =  opts
+  t.fork = false
+end
+
+desc 'Run features tagged as work-in-progress (@wip)'
+Cucumber::Rake::Task.new('features:wip') do |t|
+  tag_opts = ' --tags ~@pending'
+  tag_opts = ' --tags @wip'
+  t.cucumber_opts = "features --format html -o #{CUKE_RESULTS} --format pretty -x -s#{tag_opts}"
+  t.fork = false
+end
+
+task :cucumber => :features
+task 'cucumber:wip' => 'features:wip'
+task :wip => 'features:wip'
+require 'rake/testtask'
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.test_files = FileList['test/*_test.rb']
+end
+
+task :default => [:test,:features]

data/bin/todo-curses

@@ -0,0 +1,55 @@
+#!/usr/bin/env ruby
+
+begin # XXX: Remove this begin/rescue before distributing your app
+  require 'todo'
+rescue LoadError
+  STDERR.puts "In development, you need to use `bundle exec bin/todo` to run your app"
+  STDERR.puts "At install-time, RubyGems will make sure lib, etc. are in the load path"
+  STDERR.puts "Feel free to remove this message from bin/todo now"
+  exit 64
+end
+
+include GLI::App
+include Ncurses
+include Ncurses::Form
+
+program_desc 'A simple interface for managing todo.txt files.'
+
+subcommand_option_handling :normal
+arguments :strict
+
+desc 'Starts an interactive editor for the given todo.txt list.'
+arg_name 'Describe arguments to list here'
+command :list do |c|
+  c.action do |global_options,options,args|
+    if args.size != 1 then
+      printf("usage: #{$0} file\n");
+      exit
+    end
+
+    TodoViewer.new(ARGV[0])
+  end
+end
+
+pre do |global,command,options,args|
+  # Pre logic here
+  # Return true to proceed; false to abort and not call the
+  # chosen command
+  # Use skips_pre before a command to skip this block
+  # on that command only
+  true
+end
+
+post do |global,command,options,args|
+  # Post logic here
+  # Use skips_post before a command to skip this
+  # block on that command only
+end
+
+on_error do |exception|
+  # Error logic here
+  # return false to skip default error handling
+  true
+end
+
+exit run(ARGV)

data/features/step_definitions/todo_steps.rb

@@ -0,0 +1,6 @@
+When /^I get help for "([^"]*)"$/ do |app_name|
+  @app_name = app_name
+  step %(I run `#{app_name} help`)
+end
+
+# Add more step definitions here

data/features/support/env.rb

@@ -0,0 +1,15 @@
+require 'aruba/cucumber'
+
+ENV['PATH'] = "#{File.expand_path(File.dirname(__FILE__) + '/../../bin')}#{File::PATH_SEPARATOR}#{ENV['PATH']}"
+LIB_DIR = File.join(File.expand_path(File.dirname(__FILE__)),'..','..','lib')
+
+Before do
+  # Using "announce" causes massive warnings on 1.9.2
+  @puts = true
+  @original_rubylib = ENV['RUBYLIB']
+  ENV['RUBYLIB'] = LIB_DIR + File::PATH_SEPARATOR + ENV['RUBYLIB'].to_s
+end
+
+After do
+  ENV['RUBYLIB'] = @original_rubylib
+end

data/features/todo.feature

@@ -0,0 +1,8 @@
+Feature: My bootstrapped app kinda works
+  In order to get going on coding my awesome app
+  I want to have aruba and cucumber setup
+  So I don't have to do it myself
+
+  Scenario: App just runs
+    When I get help for "todo"
+    Then the exit status should be 0

data/lib/todo/todo_viewer.rb

@@ -0,0 +1,283 @@
+# TODO: Refactor into proper size functions
+# A curses based todo.txt file viewer
+class TodoViewer
+
+  # Run the ncurses application
+  def interact
+    while true
+      result = true
+      c = Ncurses.getch
+      case c
+      when 'J'.ord
+        result = priority_down
+      when 'K'.ord
+        result = priority_up
+      when 'x'.ord
+        toggle_item_completion
+      when 'n'.ord
+        new_item
+      when 'j'.ord
+        result = scroll_down
+      when 'k'.ord
+        result = scroll_up
+      # when '\s'.ord # white space
+      #   for i in 0..(@screen.getmaxy - 2)
+      #     if( ! scroll_down )
+      #       if( i == 0 )
+      #         result = false
+      #       end
+      #       break
+      #     end
+      #   end
+      # when Ncurses::KEY_PPAGE
+      #   for i in 0..(@screen.getmaxy - 2)
+      #     if( ! scroll_up )
+      #       if( i == 0 )
+      #         result = false
+      #       end
+      #       break
+      #     end
+      #   end
+      when 'h'.ord
+        while( scroll_up )
+        end
+      when 'l'.ord
+        while( scroll_down )
+        end
+      when 'q'.ord
+        break
+      else
+        @screen.mvprintw(0,0, "[unknown key `#{Ncurses.keyname(c)}'=#{c}] ")
+      end
+      if( !result )
+        Ncurses.beep
+      end
+      # TODO: Catch ctrl+c for graceful exit
+    end
+
+    # TODO: Confirm exit
+    clean_done_tasks
+    close_ncurses
+  end
+
+  private
+
+  # Create a new fileviewer, and view the file.
+  def initialize(filename)
+    @log = Logger.new 'log.txt'
+    @log.debug 'Run Started'
+    init_curses
+    load_file(filename)
+    interact
+    # TODO: Save a copy of the todo.txt list to backup file.
+  end
+
+  # Perform the curses setup
+  def init_curses
+    @screen = Ncurses.initscr
+    Ncurses.nonl
+    Ncurses.cbreak
+    Ncurses.noecho
+    @screen.scrollok(true)
+  end
+
+  # Loads the given file as a todo.txt array. Sets the view to the top
+  # and redraws the list view.
+  # @param filename [String] path to the text file to be loaded
+  def load_file(filename)
+    @done_file = File.dirname(filename) + '/done.txt'
+    @list = Todo::List.new filename
+    @list.sort! { |x,y| y <=> x } # Reverse sort
+    items = []
+    last_priority = nil
+    last_selection = @menu.current_item.user_object if @menu
+    current_selection = nil
+
+    # Build the menu item list
+    @list.each do |item|
+      # Insert dividers on priority change
+      if item.priority != last_priority
+        divider_priority = item.priority.nil? ? 'N/A' : item.priority.to_s
+        divider = Ncurses::Menu::ITEM.new(divider_priority, '')
+        items << divider
+        last_priority = item.priority
+      end
+
+      # Build the todo menu item
+      menu_item = Ncurses::Menu::ITEM.new(item.to_s, '') # name, description
+      menu_item.user_object = item
+      items << menu_item
+
+      # Set the current selection
+      current_selection = menu_item if item.to_s == last_selection.to_s
+    end
+
+    # Build the final menu object
+    # TODO: Possible memory leak from resetting object over top?
+    @menu = Ncurses::Menu::MENU.new items
+    @menu.set_menu_win(@screen)
+    @menu.set_menu_sub(@screen.derwin(@screen.getmaxx, @screen.getmaxy, 0, 0))
+    @menu.set_menu_format(@screen.getmaxy, 1)
+
+    # Set dividers to non-interactive
+    @menu.menu_items.select{ |i| i.user_object.nil? }.each do |divider|
+      divider.item_opts_off Menu::O_SELECTABLE
+    end
+
+    # Show the menu
+    @screen.clear
+    @menu.post_menu
+
+    # Set selection position
+    @menu.set_current_item current_selection if current_selection
+    @menu.menu_driver(Ncurses::Menu::REQ_DOWN_ITEM) if @menu.current_item.user_object.nil?
+
+    # Refresh
+    @screen.refresh
+  end
+
+  # Moves the current selection's priority up by one unless it is at Z.
+  def priority_up
+    item = @menu.current_item.user_object
+    item.priority_inc
+    save_list
+  end
+
+  # Moves the current selection's priority down by one unless it is at A.
+  def priority_down
+    item = @menu.current_item.user_object
+    item.priority_dec
+    save_list
+  end
+
+  # Scroll the display up by one line
+  # @return [Boolean] true if the action completed successfully.
+  def scroll_up
+    # Move to the next item if it's not the first in the list
+    unless @menu.menu_items[0].user_object.nil? &&
+           @menu.current_item.item_index < 2
+      result = @menu.menu_driver(Ncurses::Menu::REQ_UP_ITEM)
+    end
+    # Move to the next item if it's not a divider
+    result = @menu.menu_driver(Ncurses::Menu::REQ_UP_ITEM) unless @menu.current_item.user_object
+    return true if result == E_OK
+    false
+  end
+
+  # Scroll the display down by one line
+  # @return [Boolean] true if the action completed successfully.
+  def scroll_down
+    result = @menu.menu_driver(Ncurses::Menu::REQ_DOWN_ITEM)
+    result = @menu.menu_driver(Ncurses::Menu::REQ_DOWN_ITEM) unless @menu.current_item.user_object
+    return true if result == E_OK
+    false
+  end
+
+  # Collects a new todo item from the user and saves
+  # it to the text file.
+  def new_item
+    field = FIELD.new(1, @screen.getmaxx-1, 2, 1, 0, 0)
+    field.set_field_back(A_UNDERLINE)
+    fields = [field]
+    my_form = FORM.new(fields);
+    my_form.user_object = "My identifier"
+
+    # Calculate the area required for the form
+    rows = Array.new()
+    cols = Array.new()
+    my_form.scale_form(rows, cols);
+
+    # Create the window to be associated with the form
+    my_form_win = WINDOW.new(rows[0] + 3, cols[0] + 14, 1, 1);
+    my_form_win.keypad(TRUE);
+
+    # Set main window and sub window
+    my_form.set_form_win(my_form_win);
+    my_form.set_form_sub(my_form_win.derwin(rows[0], cols[0], 2, 12));
+
+    my_form.post_form();
+
+    # Print field types
+    my_form_win.mvaddstr(4, 2, "New item")
+    my_form_win.wrefresh();
+
+    stdscr.refresh();
+
+    new_item_text = capture_text_field_input(my_form_win, my_form, field)
+
+    # Save results
+    save_new_item(new_item_text)
+
+    # Clean up
+    my_form.unpost_form
+    my_form.free_form
+
+    field.free_field
+    # fields.each {|f| f.free_field()}
+  end
+
+  # Adds a new item to the list and saves the file
+  # @param task [String] the task to be added
+  # @return [Todo::List] the updated list
+  def save_new_item(task)
+    @list << Todo::Task.new(task)
+    save_list
+    @list
+  end
+
+  # Saves the current state of the list. Overrides the current file.
+  # Reloads the newly saved file.
+  def save_list
+    File.open(@list.path, 'w') { |file| file << @list.join("\n") }
+    load_file @list.path
+  end
+
+  # Marks the currently selected menu item as complete and saves the list.
+  def toggle_item_completion
+    @menu.current_item.user_object.toggle!
+    save_list
+  end
+
+  # Saves done tasks to done.txt and removes them from todo.txt
+  def clean_done_tasks
+    done_tasks = @list.select { |task| !task.completed_on.nil? }
+    File.open(@done_file, 'a') { |file|
+      file << "\n"
+      file << done_tasks.join("\n")
+    }
+    remaining_tasks = @list.select { |task| task.completed_on.nil? }
+    File.open(@list.path, 'w') { |file| file << remaining_tasks.join("\n") }
+  end
+
+  # put the screen back in its normal state
+  def close_ncurses
+    Ncurses.echo()
+    Ncurses.nocbreak()
+    Ncurses.nl()
+    Ncurses.endwin()
+  end
+
+  # Captures text input into a form and returns the resulting string.
+  # @param window [Window] the form window
+  # @param form [FORM] the form to be captured
+  # @param field [FIELD] the form to be captured
+  # @return [String] the captured input
+  def capture_text_field_input(window, form, field)
+    # Capture typing...
+    while((ch = window.getch()) != 13) # return is ascii 13
+      case ch
+      when KEY_LEFT
+        form.form_driver(REQ_PREV_CHAR);
+      when KEY_RIGHT
+        form.form_driver(REQ_NEXT_CHAR);
+      when KEY_BACKSPACE
+        form.form_driver(REQ_DEL_PREV);
+      else
+        # If this is a normal character, it gets Printed
+        form.form_driver(ch);
+      end
+    end
+    form.form_driver REQ_NEXT_FIELD # Request next to set 0 buffer in field
+    Ncurses::Form.field_buffer(field, 0)
+  end
+end

data/lib/todo/version.rb

@@ -0,0 +1,3 @@
+module Todo
+  VERSION = '0.0.1'
+end

data/lib/todo-txt/list.rb

@@ -0,0 +1,87 @@
+module Todo
+  class List < Array
+    # Initializes a Todo List object with a path to the corresponding todo.txt
+    # file. For example, if your todo.txt file is located at:
+    #
+    #   /home/sam/Dropbox/todo/todo.txt
+    #
+    # You would initialize this object like:
+    #
+    #   list = Todo::List.new "/home/sam/Dropbox/todo/todo-txt"
+    #
+    # Alternately, you can initialize this object with an array of strings or
+    # tasks. If the array is of strings, the strings will be converted into
+    # tasks. You can supply a mixed list of string and tasks if you wish.
+    #
+    # Example:
+    #
+    #   array = Array.new
+    #   array.push "(A) A string task!"
+    #   array.push Todo::Task.new("(A) An actual task!")
+    #
+    #   list = Todo::List.new array
+    def initialize list
+      if list.is_a? Array
+        # No file path was given.
+        @path = nil
+
+        # If path is an array, loop over it, adding to self.
+        list.each do |task|
+          # If it's a string, make a new task out of it.
+          if task.is_a? String
+            self.push Todo::Task.new task
+          # If it's a task, just add it.
+          elsif task.is_a? Todo::Task
+            self.push task
+          end
+        end
+      elsif list.is_a? String
+        @path = list
+
+        # Read in lines from file, create Todo::Tasks out of them and push them
+        # onto self.
+        File.open(list) do |file|
+          file.each_line { |line| self.push Todo::Task.new line }
+        end
+      end
+    end
+
+    # The path to the todo.txt file that you supplied when you created the
+    # Todo::List object.
+    def path
+      @path
+    end
+
+    # Filters the list by priority and returns a new list.
+    #
+    # Example:
+    #
+    #   list = Todo::List.new "/path/to/list"
+    #   list.by_priority "A" #=> Will be a new list with only priority A tasks
+    def by_priority priority
+      Todo::List.new self.select { |task| task.priority == priority }
+    end
+
+    # Filters the list by context and returns a new list.
+    #
+    # Example:
+    #
+    #   list = Todo::List.new "/path/to/list"
+    #   list.by_context "@context" #=> Will be a new list with only tasks
+    #                                  containing "@context"
+    def by_context context
+      Todo::List.new self.select { |task| task.contexts.include? context }
+    end
+
+    # Filters the list by project and returns a new list.
+    #
+    # Example:
+    #
+    #   list = Todo::List.new "/path/to/list"
+    #   list.by_project "+project" #=> Will be a new list with only tasks
+    #                                  containing "+project"
+    def by_project project
+      Todo::List.new self.select { |task| task.projects.include? project }
+    end
+  end
+end

data/lib/todo-txt/logger.rb

@@ -0,0 +1,21 @@
+require 'logger'
+
+module Todo
+  module Logger
+    def self.included base
+      base.extend(self)
+    end
+
+    def self.logger= new_logger
+      @@logger = new_logger
+    end
+
+    def self.logger
+      @@logger ||= ::Logger.new(STDOUT)
+    end
+
+    def logger
+      Todo::Logger.logger
+    end
+  end
+end

data/lib/todo-txt/task.rb

@@ -0,0 +1,339 @@
+require 'date'
+
+module Todo
+  class Task
+    include Comparable
+    include Todo::Logger
+
+    # The regular expression used to match contexts.
+    def self.contexts_regex
+       /(?:\s+|^)@\w+/
+    end
+
+    # The regex used to match projects.
+    def self.projects_regex
+       /(?:\s+|^)\+\w+/
+    end
+
+    # The regex used to match priorities.
+    def self.priority_regex
+      /(?:^|\s+)\(([A-Za-z])\)\s+/
+    end
+
+    # The regex used to match creation date.
+    def self.created_on_regex
+      /(?:^|-\d{2}\s|\)\s)(\d{4}-\d{2}-\d{2})\s/
+    end
+
+    # The regex used to match completion.
+    def self.done_regex
+      /^x\s+(\d{4}-\d{2}-\d{2})\s+/
+    end
+
+    # The regex used to match due date.
+    def self.due_on_regex
+      /(?:due:)(\d{4}-\d{2}-\d{2})(?:\s+|$)/i
+    end
+
+    # Creates a new task. The argument that you pass in must be the string
+    # representation of a task.
+    #
+    # Example:
+    #
+    #   task = Todo::Task.new("(A) A high priority task!")
+    def initialize task
+      @orig = task
+      @completed_on = get_completed_date #orig.scan(self.class.done_regex)[1] ||= nil
+      @priority, @created_on = orig_priority, orig_created_on
+      @due_on = get_due_on_date
+      @contexts ||= orig.scan(self.class.contexts_regex).map { |item| item.strip }
+      @projects ||= orig.scan(self.class.projects_regex).map { |item| item.strip }
+    end
+
+    # Returns the original content of the task.
+    #
+    # Example:
+    #
+    #   task = Todo::Task.new "(A) @context +project Hello!"
+    #   task.orig #=> "(A) @context +project Hello!"
+    attr_reader :orig
+
+    # Returns the task's creation date, if any.
+    #
+    # Example:
+    #
+    #   task = Todo::Task.new "(A) 2012-03-04 Task."
+    #   task.created_on
+    #   #=> <Date: 2012-03-04 (4911981/2,0,2299161)>
+    #
+    # Dates _must_ be in the YYYY-MM-DD format as specified in the todo.txt
+    # format. Dates in any other format will be classed as malformed and this
+    # attribute will be nil.
+    attr_reader :created_on
+
+    # Returns the task's completion date if task is done.
+    #
+    # Example:
+    #
+    #   task = Todo::Task.new "x 2012-03-04 Task."
+    #   task.completed_on
+    #   #=> <Date: 2012-03-04 (4911981/2,0,2299161)>
+    #
+    # Dates _must_ be in the YYYY-MM-DD format as specified in the todo.txt
+    # format. Dates in any other format will be classed as malformed and this
+    # attribute will be nil.
+    attr_reader :completed_on
+
+    # Returns the task's due date, if any.
+    #
+    # Example:
+    #
+    #   task = Todo::Task.new "(A) This is a task. due:2012-03-04"
+    #   task.due_on
+    #   #=> <Date: 2012-03-04 (4911981/2,0,2299161)>
+    #
+    # Dates _must_ be in the YYYY-MM-DD format as specified in the todo.txt
+    # format. Dates in any other format will be classed as malformed and this
+    # attribute will be nil.
+    attr_reader :due_on
+
+    # Returns the priority, if any.
+    #
+    # Example:
+    #
+    #   task = Todo::Task.new "(A) Some task."
+    #   task.priority #=> "A"
+    #
+    #   task = Todo::Task.new "Some task."
+    #   task.priority #=> nil
+    attr_reader :priority
+
+    # Returns an array of all the @context annotations.
+    #
+    # Example:
+    #
+    #   task = Todo:Task.new "(A) @context Testing!"
+    #   task.context #=> ["@context"]
+    attr_reader :contexts
+
+    # Returns an array of all the +project annotations.
+    #
+    # Example:
+    #
+    #   task = Todo:Task.new "(A) +test Testing!"
+    #   task.projects #=> ["+test"]
+    attr_reader :projects
+
+    # Gets just the text content of the todo, without the priority, contexts
+    # and projects annotations.
+    #
+    # Example:
+    #
+    #   task = Todo::Task.new "(A) @test Testing!"
+    #   task.text #=> "Testing!"
+    def text
+      @text ||= orig.
+        gsub(self.class.done_regex, '').
+        gsub(self.class.priority_regex, '').
+        gsub(self.class.created_on_regex, '').
+        gsub(self.class.contexts_regex, '').
+        gsub(self.class.projects_regex, '').
+        gsub(self.class.due_on_regex, '').
+        strip
+    end
+
+    # Returns the task's creation date, if any.
+    #
+    # Example:
+    #
+    #   task = Todo::Task.new "(A) 2012-03-04 Task."
+    #   task.date
+    #   #=> <Date: 2012-03-04 (4911981/2,0,2299161)>
+    #
+    # Dates _must_ be in the YYYY-MM-DD format as specified in the todo.txt
+    # format. Dates in any other format will be classed as malformed and this
+    # method will return nil.
+    #
+    # Deprecated
+    def date
+      logger.warn("Task#date is deprecated, use created_on instead.")
+
+      @created_on
+    end
+
+    # Returns whether a task's due date is in the past.
+    #
+    # Example:
+    #
+    #   task = Todo::Task.new("This task is overdue! due:#{Date.today - 1}")
+    #   task.overdue?
+    #   #=> true
+    def overdue?
+      return true if !due_on.nil? && due_on < Date.today
+      false
+    end
+
+    # Returns if the task is done.
+    #
+    # Example:
+    #
+    #   task = Todo::Task.new "x 2012-12-08 Task."
+    #   task.done?
+    #   #=> true
+    #
+    #   task = Todo::Task.new "Task."
+    #   task.done?
+    #   #=> false
+    def done?
+      !@completed_on.nil?
+    end
+
+    # Completes the task on the current date.
+    #
+    # Example:
+    #
+    #   task = Todo::Task.new "2012-12-08 Task."
+    #   task.done?
+    #   #=> false
+    #
+    #   task.do!
+    #   task.done?
+    #   #=> true
+    #   task.created_on
+    #   #=> <Date: 2012-12-08 (4911981/2,0,2299161)>
+    #   task.completed_on
+    #   #=> # the current date
+    def do!
+      @completed_on = Date.today
+      @priority = nil
+    end
+
+    # Marks the task as incomplete and resets its original priority.
+    #
+    # Example:
+    #
+    #   task = Todo::Task.new "x 2012-12-08 2012-03-04 Task."
+    #   task.done?
+    #   #=> true
+    #
+    #   task.undo!
+    #   task.done?
+    #   #=> false
+    #   task.created_on
+    #   #=> <Date: 2012-03-04 (4911981/2,0,2299161)>
+    #   task.completed_on
+    #   #=> nil
+    def undo!
+      @completed_on = nil
+      @priority = orig_priority
+    end
+
+    # Toggles the task from complete to incomplete or vice versa.
+    #
+    # Example:
+    #
+    #   task = Todo::Task.new "x 2012-12-08 Task."
+    #   task.done?
+    #   #=> true
+    #
+    #   task.toggle!
+    #   task.done?
+    #   #=> false
+    #
+    #   task.toggle!
+    #   task.done?
+    #   #=> true
+    def toggle!
+      done? ? undo! : do!
+    end
+
+    # Returns this task as a string.
+    #
+    # Example:
+    #
+    #   task = Todo::Task.new "(A) 2012-12-08 Task"
+    #   task.to_s
+    #   #=> "(A) 2012-12-08 Task"
+    def to_s
+      priority_string = priority ? "(#{priority}) " : ""
+      done_string = done? ? "x #{completed_on} " : ""
+      created_on_string = created_on ? "#{created_on} " : ""
+      contexts_string = contexts.empty? ? "" : " #{contexts.join ' '}"
+      projects_string = projects.empty? ? "" : " #{projects.join ' '}"
+      due_on_string = due_on.nil? ? "" : " due:#{due_on}"
+      "#{done_string}#{priority_string}#{created_on_string}#{text}#{contexts_string}#{projects_string}#{due_on_string}"
+    end
+
+    # Compares the priorities of two tasks.
+    #
+    # Example:
+    #
+    #   task1 = Todo::Task.new "(A) Priority A."
+    #   task2 = Todo::Task.new "(B) Priority B."
+    #
+    #   task1 > task2
+    #   # => true
+    #
+    #   task1 == task2
+    #   # => false
+    #
+    #   task2 > task1
+    #   # => false
+    def <=> other_task
+      if self.priority.nil? and other_task.priority.nil?
+        0
+      elsif other_task.priority.nil?
+        1
+      elsif self.priority.nil?
+        -1
+      else
+        other_task.priority <=> self.priority
+      end
+    end
+
+    # Decreases the priority until Z.
+    def priority_dec
+      return if @priority.nil?
+      @priority = @priority.next if @priority.ord < 90
+    end
+
+    # Increases the priority until A. If it's nil, it sets it to A.
+    def priority_inc
+      if @priority.nil?
+        @priority = 'A'
+      else
+        @priority = (@priority.ord-1).chr if @priority.ord > 65
+      end
+    end
+
+    private
+
+    def orig_priority
+      @orig.match(self.class.priority_regex)[1] if @orig =~ self.class.priority_regex
+    end
+
+    def orig_created_on
+      begin
+        if @orig =~ self.class.created_on_regex
+          date = @orig.match self.class.created_on_regex
+          return Date.parse(date[1]) unless date.nil?
+        end
+      rescue; end
+      nil
+    end
+
+    def get_completed_date
+      begin
+        return Date.parse(self.class.done_regex.match(@orig)[1])
+      rescue; end
+      nil
+    end
+
+    def get_due_on_date
+      begin
+        return Date.parse(self.class.due_on_regex.match(@orig)[1])
+      rescue; end
+      nil
+    end
+  end
+end

data/lib/todo-txt.rb

@@ -0,0 +1,7 @@
+lib = File.dirname(__FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'logger'
+require 'todo-txt/logger'
+require 'todo-txt/list'
+require 'todo-txt/task'

data/lib/todo.rb

@@ -0,0 +1,6 @@
+require 'gli'
+require 'todo-txt'
+require 'ncursesw'
+require 'todo/version.rb'
+require 'todo/todo_viewer.rb'
+require 'logger'

data/reset.sh

@@ -0,0 +1,2 @@
+#!/bin/bash
+cp todo.txt.bak todo.txt

data/run.sh

@@ -0,0 +1,2 @@
+#!/bin/bash
+bundle exec bin/todo-curses list todo.txt

data/test/default_test.rb

@@ -0,0 +1,14 @@
+require 'test_helper'
+
+class DefaultTest < Test::Unit::TestCase
+
+  def setup
+  end
+
+  def teardown
+  end
+
+  def test_the_truth
+    assert true
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,9 @@
+require 'test/unit'
+
+# Add test libraries you want to use here, e.g. mocha
+
+class Test::Unit::TestCase
+
+  # Add global extensions to the test case class here
+  
+end

data/todo-curses.gemspec

@@ -0,0 +1,23 @@
+# Ensure we require the local version and not one we might have installed already
+require File.join([File.dirname(__FILE__),'lib','todo','version.rb'])
+spec = Gem::Specification.new do |s|
+  s.name = 'todo-curses'
+  s.version = Todo::VERSION
+  s.author = 'Loren Rogers'
+  s.email = 'loren@lorentrogers.com'
+  s.homepage = 'http://www.lorentrogers.com'
+  s.platform = Gem::Platform::RUBY
+  s.summary = 'An interactive terminal application for managing todo.txt files.'
+  s.files = `git ls-files`.split("
+")
+  s.require_paths << 'lib'
+  s.has_rdoc = true
+  s.extra_rdoc_files = ['README.rdoc','todo.rdoc']
+  s.rdoc_options << '--title' << 'todo-curses' << '--main' << 'README.rdoc' << '-ri'
+  s.bindir = 'bin'
+  s.executables << 'todo-curses'
+  s.add_development_dependency('rake')
+  s.add_development_dependency('rdoc')
+  s.add_development_dependency('aruba')
+  s.add_runtime_dependency('gli','2.13.4')
+end

data/todo.rdoc

@@ -0,0 +1,5 @@
+= todo
+
+Generate this with
+    todo rdoc
+After you have described your command line interface

metadata

@@ -0,0 +1,130 @@
+--- !ruby/object:Gem::Specification
+name: todo-curses
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Loren Rogers
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-01-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: aruba
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: gli
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.13.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.13.4
+description: 
+email: loren@lorentrogers.com
+executables:
+- todo-curses
+extensions: []
+extra_rdoc_files:
+- README.rdoc
+- todo.rdoc
+files:
+- ".gitignore"
+- Gemfile
+- Gemfile.lock
+- README.rdoc
+- Rakefile
+- bin/todo-curses
+- features/step_definitions/todo_steps.rb
+- features/support/env.rb
+- features/todo.feature
+- lib/todo-txt.rb
+- lib/todo-txt/list.rb
+- lib/todo-txt/logger.rb
+- lib/todo-txt/task.rb
+- lib/todo.rb
+- lib/todo/todo_viewer.rb
+- lib/todo/version.rb
+- reset.sh
+- run.sh
+- test/default_test.rb
+- test/test_helper.rb
+- todo-curses.gemspec
+- todo.rdoc
+homepage: http://www.lorentrogers.com
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options:
+- "--title"
+- todo-curses
+- "--main"
+- README.rdoc
+- "-ri"
+require_paths:
+- lib
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: An interactive terminal application for managing todo.txt files.
+test_files: []
+has_rdoc: true