pomo 0.0.1

data/History.md

@@ -0,0 +1,5 @@
+
+0.0.1 / 2009-10-15
+==================
+
+  * Initial release

data/Manifest

@@ -0,0 +1,16 @@
+History.md
+Manifest
+Rakefile
+Readme.md
+bin/pomo
+lib/pomo.rb
+lib/pomo/list.rb
+lib/pomo/task.rb
+lib/pomo/version.rb
+pomo.gemspec
+spec/pomo_spec.rb
+spec/spec.opts
+spec/spec_helper.rb
+tasks/docs.rake
+tasks/gemspec.rake
+tasks/spec.rake

data/Rakefile

@@ -0,0 +1,17 @@
+
+$:.unshift 'lib'
+require 'pomo'
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+Echoe.new "pomo", Pomo::VERSION do |p|
+  p.author = "TJ Holowaychuk"
+  p.email = "tj@vision-media.ca"
+  p.summary = "Pomodoro time management for the command-line"
+  p.url = "http://github.com/visionmedia/pomo"
+  p.runtime_dependencies << 'commander >=4.0.0'
+  p.runtime_dependencies << 'growl >=1.0.3'
+end
+
+Dir['tasks/**/*.rake'].sort.each { |f| load f }

data/Readme.md

@@ -0,0 +1,35 @@
+
+# Pomo  
+
+  Command-line application for the [Pomodoro](http://www.pomodorotechnique.com/) time management technique.
+  
+## Features
+
+  * Communicates via Growl 
+
+## Examples
+
+## License
+
+(The MIT License)
+
+Copyright (c) 2009 TJ Holowaychuk <tj@vision-media.ca>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, an d/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/bin/pomo

@@ -0,0 +1,89 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.dirname(__FILE__) + '/../lib' 
+require 'rubygems'
+require 'commander/import'
+require 'pomo'
+
+program :version, Pomo::VERSION
+program :description, 'Pomodoro time management'
+program :int_message, "\nTerminated pomodoro; any tasks which were running will not be marked as complete"
+
+list = Pomo::List.new '~/.pomo'
+ 
+command :start do |c|
+  c.syntax = 'pomo start [number] [options]'
+  c.summary = 'Start a task'
+  c.description = 'Start a task, given the task [number] or the first task'
+  c.action do |args, options|
+    task = list.tasks.at(args.first ? args.first.to_i : 0)
+    abort 'task already completed' if task.complete?
+    say "Started #{task}, you have #{task.length} minutes :)"
+    task.start
+    list.save
+  end
+end
+alias_command :'start first', :start, '0'
+alias_command :'start last', :start, list.tasks.length - 1
+ 
+command :add do |c|
+  c.syntax = 'pomo add <task> [options]'
+  c.summary = 'Add a task'
+  c.description = 'Add a task to the current list of tasks'
+  c.example 'Adds the task "fix IE styling issues"', 'pomo add "fix IE styling issues"'
+  c.example 'Add a task with 60 minute limit', 'pomo add "create executable" --length 60'
+  c.option '-d', '--description string', 'Add verbose task description'
+  c.option '-l', '--length minutes', Integer, 'Change the default length in minutes'
+  c.action do |args, options|
+   task = Pomo::Task.new(args.shift, options.__hash__)
+   list << task
+   list.save
+   say "Task #{task} added"
+  end
+end
+
+command :remove do |c|
+  c.syntax = 'pomo [remove|rm] <number> [options]'
+  c.summary = 'Remove a task'
+  c.description = 'Remove a task, given the task <number>'
+  c.action do |args, options|
+   list.tasks.each_with_index do |task, i|
+     if i == args.first.to_i
+       list.tasks.delete_at i
+       say "Removed #{task}"
+     end
+   end
+   list.save
+  end
+end
+alias_command :rm, :remove
+alias_command :'remove first', :remove, '0'
+alias_command :'remove last', :remove, list.tasks.length - 1
+
+command :view do |c|
+  c.syntax = 'pomo view [number] [options]'
+  c.summary = 'View a task'
+  c.description = 'View verbose information for the given task [number] or the first task'
+  c.action do |args, options|
+    if task = list.tasks.at(args.first ? args.first.to_i : 0)
+      format = "%15s : %s\n"
+      say format % ['name', task.name]
+      say format % ['length', "#{task.length} minutes"]
+      say format % ['description', task.description || '...']
+    end
+  end
+end
+alias_command :'view first', :view, '0'
+alias_command :'view last', :view, list.tasks.length - 1
+
+command :list do |c|
+  c.syntax = 'pomo list [options]'
+  c.description = 'List all tasks'
+  c.action do |args, options|
+   list.tasks.each_with_index do |task, i|
+     say ' %s %2d. %-35s : %d minutes' % [task.complete? ? '√' : ' ', i, task.to_s, task.length]
+   end
+  end
+end
+
+

data/lib/pomo/list.rb

@@ -0,0 +1,51 @@
+
+module Pomo
+  class List
+    
+    ##
+    # List path.
+    
+    attr_reader :path
+    
+    ##
+    # Task array.
+    
+    attr_reader :tasks
+    
+    ##
+    # Initialize with _path_.
+    
+    def initialize path
+      @path = File.expand_path path
+      @tasks = []
+      load rescue save
+    end
+    
+    ##
+    # Add _task_ to the list in memory (requires saving).
+    
+    def add task
+      @tasks << task
+    end
+    alias :<< :add
+    
+    ##
+    # Save the list.
+    
+    def save
+      File.open(path, 'w') do |file|
+        file.write YAML.dump(tasks)
+      end
+      self
+    end
+    
+    ##
+    # Load the list.
+    
+    def load
+      @tasks = YAML.load_file path
+      self
+    end
+    
+  end
+end

data/lib/pomo/task.rb

@@ -0,0 +1,63 @@
+
+module Pomo
+  class Task
+    
+    #--
+    # Mixins
+    #++
+    
+    include Growl
+    
+    ##
+    # Task name.
+    
+    attr_reader :name
+    alias :to_s :name
+    
+    ##
+    # Length in minutes.
+    
+    attr_reader :length
+    
+    ##
+    # Verbose task description.
+    
+    attr_reader :description
+    
+    ##
+    # Initialize with _name_ and _options_.
+    
+    def initialize name = nil, options = {}
+      @name = name or raise '<task> required'
+      @description = options.delete :description
+      @length = options.fetch :length, 25
+      @complete = false
+    end
+    
+    ##
+    # Check if the task has been completed.
+    
+    def complete?
+      @complete
+    end
+    
+    ##
+    # Start timing the task.
+    
+    def start
+      complete_message = "time is up, complete #{self} yet?"
+      progress (0..length).to_a.reverse, :format => "(:progress_bar) :remaining minutes remaining", :complete_message => complete_message do |remaining|
+        if remaining == length / 2
+          notify_info "#{remaining} minutes remaining, half way there!"
+        elsif remaining == 5
+          notify_info "5 minutes remaining"
+        end
+        sleep 60
+        { :remaining => remaining }
+      end
+      @complete = true
+      notify_warning complete_message
+    end
+    
+  end
+end

data/lib/pomo/version.rb

@@ -0,0 +1,4 @@
+
+module Pomo
+  VERSION = '0.0.1'
+end

data/lib/pomo.rb

@@ -0,0 +1,28 @@
+#--
+# Copyright (c) 2009 TJ Holowaychuk <tj@vision-media.ca>
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#++
+
+require 'yaml'
+require 'growl'
+require 'pomo/list'
+require 'pomo/task'
+require 'pomo/version'

data/pomo.gemspec

@@ -0,0 +1,38 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{pomo}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["TJ Holowaychuk"]
+  s.date = %q{2009-10-15}
+  s.default_executable = %q{pomo}
+  s.description = %q{Pomodoro time management for the command-line}
+  s.email = %q{tj@vision-media.ca}
+  s.executables = ["pomo"]
+  s.extra_rdoc_files = ["bin/pomo", "lib/pomo.rb", "lib/pomo/list.rb", "lib/pomo/task.rb", "lib/pomo/version.rb", "tasks/docs.rake", "tasks/gemspec.rake", "tasks/spec.rake"]
+  s.files = ["History.md", "Manifest", "Rakefile", "Readme.md", "bin/pomo", "lib/pomo.rb", "lib/pomo/list.rb", "lib/pomo/task.rb", "lib/pomo/version.rb", "pomo.gemspec", "spec/pomo_spec.rb", "spec/spec.opts", "spec/spec_helper.rb", "tasks/docs.rake", "tasks/gemspec.rake", "tasks/spec.rake"]
+  s.homepage = %q{http://github.com/visionmedia/pomo}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Pomo", "--main", "Readme.md"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{pomo}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Pomodoro time management for the command-line}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<commander>, [">= 4.0.0"])
+      s.add_runtime_dependency(%q<growl>, [">= 1.0.3"])
+    else
+      s.add_dependency(%q<commander>, [">= 4.0.0"])
+      s.add_dependency(%q<growl>, [">= 1.0.3"])
+    end
+  else
+    s.add_dependency(%q<commander>, [">= 4.0.0"])
+    s.add_dependency(%q<growl>, [">= 1.0.3"])
+  end
+end

data/spec/pomo_spec.rb

@@ -0,0 +1,8 @@
+
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe Pomo do
+  it "should description" do
+    
+  end
+end

data/spec/spec.opts

@@ -0,0 +1,2 @@
+--color
+--format specdoc

data/spec/spec_helper.rb

@@ -0,0 +1,3 @@
+
+$:.unshift File.dirname(__FILE__) + '/../lib'
+require 'pomo'

data/tasks/docs.rake

@@ -0,0 +1,13 @@
+
+namespace :docs do
+  
+  desc 'Remove rdoc products'
+  task :remove => [:clobber_docs]
+  
+  desc 'Build docs, and open in browser for viewing (specify BROWSER)'
+  task :open do
+    browser = ENV["BROWSER"] || "safari"
+    sh "open -a #{browser} doc/index.html"
+  end
+  
+end

data/tasks/gemspec.rake

@@ -0,0 +1,3 @@
+
+desc 'Build gemspec file'
+task :gemspec => [:build_gemspec]

data/tasks/spec.rake

@@ -0,0 +1,25 @@
+
+require 'spec/rake/spectask'
+  
+desc "Run all specifications"
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.libs << "lib"
+  t.spec_opts = ["--color", "--require", "spec/spec_helper.rb"]
+end
+  
+namespace :spec do
+
+  desc "Run all specifications verbosely"
+  Spec::Rake::SpecTask.new(:verbose) do |t|
+    t.libs << "lib"
+    t.spec_opts = ["--color", "--format", "specdoc", "--require", "spec/spec_helper.rb"]
+  end
+  
+  desc "Run specific specification verbosely (specify SPEC)"
+  Spec::Rake::SpecTask.new(:select) do |t|
+    t.libs << "lib"
+    t.spec_files = [ENV["SPEC"]]
+    t.spec_opts = ["--color", "--format", "specdoc", "--require", "spec/spec_helper.rb"]
+  end
+  
+end

metadata

@@ -0,0 +1,101 @@
+--- !ruby/object:Gem::Specification 
+name: pomo
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- TJ Holowaychuk
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-10-15 00:00:00 -07:00
+default_executable: pomo
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: commander
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 4.0.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: growl
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.0.3
+    version: 
+description: Pomodoro time management for the command-line
+email: tj@vision-media.ca
+executables: 
+- pomo
+extensions: []
+
+extra_rdoc_files: 
+- bin/pomo
+- lib/pomo.rb
+- lib/pomo/list.rb
+- lib/pomo/task.rb
+- lib/pomo/version.rb
+- tasks/docs.rake
+- tasks/gemspec.rake
+- tasks/spec.rake
+files: 
+- History.md
+- Manifest
+- Rakefile
+- Readme.md
+- bin/pomo
+- lib/pomo.rb
+- lib/pomo/list.rb
+- lib/pomo/task.rb
+- lib/pomo/version.rb
+- pomo.gemspec
+- spec/pomo_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- tasks/docs.rake
+- tasks/gemspec.rake
+- tasks/spec.rake
+has_rdoc: true
+homepage: http://github.com/visionmedia/pomo
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Pomo
+- --main
+- Readme.md
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: pomo
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Pomodoro time management for the command-line
+test_files: []
+