ardekantur-taskomaly 0.0.8

data/LICENSE

@@ -0,0 +1,8 @@
+taskomaly: access tasko and taskpaper files in ruby
+Copyright (C) 2008 Ardekantur
+
+This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
+
+Please see <http://www.gnu.org/licenses/> for the full version of this license.

data/README.rdoc

@@ -0,0 +1,54 @@
+= taskomaly
+
+access your Tasko or TaskPaper papers. in ruby.
+
+== you need to clean your room
+
+=== make it a project
+
+ proj = Taskomaly::Project.new 'Room Cleaning'
+
+=== add some tasks to it
+
+ proj.add 'put away clean laundry'
+ proj.add 'wash dirty dishes'
+
+=== tag those suckas up
+
+ proj.add 'file taxes @april @15'
+ proj.tasks.last.tags 			# [:april, :"15"]
+ 
+ proj.add 'organize shelf'
+ proj.tasks.last.tag :knickknacks, 1000, 'september'
+ proj.tasks.last.tags 			# [:knickknacks, :"1000", :september]
+
+== working with tasko
+
+ t = Taskomaly::With :user => 9999, :key => 'd9cca721a735dac4efe709e0f3518373' 
+ 
+or, create this file:
+
+ # ~/.tasks.yml
+ user: 9999
+ key: d9cca721a735dac4efe709e0f3518373
+
+and do this:
+
+ t = Taskomaly::From '~/.tasks.yml'
+
+=== getting your papers
+
+ t.get :papers # ['Paper One', 'Paper Two']
+ p = t.papers.first
+
+ puts p.name # 'Paper One'
+ puts p.body # duh
+
+=== change + upload
+
+ p.body["@today"] = "@tomorrow"
+ p.save # true if groovy, false if failed
+
+=== made a mistake? refresh from the server
+
+ p.refresh # true if groovy, false if failed

data/Rakefile

@@ -0,0 +1,73 @@
+require 'rake'
+require 'hanna/rdoctask'
+require 'spec/rake/spectask'
+require 'rake/gempackagetask'
+require 'rubygems/specification'
+require 'date'
+
+GEM = "taskomaly"
+GEM_VERSION = "0.0.8"
+AUTHOR = "Ardekantur"
+EMAIL = "greystone@ardekantur.com"
+HOMEPAGE = "http://github.com/ardekantur/taskomaly"
+SUMMARY = "use taskpaper papers and tasko in ruby"
+
+spec = Gem::Specification.new do |s|
+  s.name = GEM
+  s.version = GEM_VERSION
+  s.platform = Gem::Platform::RUBY
+  s.has_rdoc = true
+  s.extra_rdoc_files = ["README.rdoc", "LICENSE"]
+  s.summary = SUMMARY
+  s.description = s.summary
+  s.author = AUTHOR
+  s.email = EMAIL
+  s.homepage = HOMEPAGE
+  
+  # Uncomment this to add a dependency
+  # s.add_dependency "foo"
+  
+  s.require_path = 'lib'
+  s.files = %w(LICENSE README.rdoc Rakefile) + Dir.glob("{lib,specs}/**/*")
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+desc "install the gem locally"
+task :install => [:package] do
+  sh %{sudo gem install pkg/#{GEM}-#{GEM_VERSION}}
+end
+
+desc "create a gemspec file"
+task :make_spec do
+  File.open("#{GEM}.gemspec", "w") do |file|
+    file.puts spec.to_ruby
+  end
+end
+
+desc "Run all specs"
+Spec::Rake::SpecTask.new(:spec) do |t|
+   t.spec_files = FileList['spec/*.rb']
+   t.spec_opts = ['--color']
+end
+ 
+desc "generate rdoc documentation"
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_files.include('README.rdoc', 'LICENSE' ).
+    include('lib/**/*.rb')
+
+  rdoc.main = "README.rdoc"
+  rdoc.rdoc_dir = 'doc' # rdoc output folder
+end
+
+desc "run rspec + rcov"
+Spec::Rake::SpecTask.new("spec:rcov") do |t|
+  t.spec_files = FileList['spec/**/*_spec.rb']
+  t.rcov_opts = ['--exclude', "spec/,rcov.rb,rspec.rb,spec*,gems*"]
+  t.rcov = true
+  t.rcov_dir = 'doc/coverage'
+end
+ 
+task :default => :spec

data/lib/api.rb

@@ -0,0 +1,125 @@
+require 'yaml'
+require 'rest_client'
+require 'rexml/document'
+
+module Taskomaly
+    
+  def self.From file
+    return API.new(:config => file)
+  end
+  
+  def self.With hash
+    return API.new(hash)
+  end
+  
+  class API
+    
+    SERVICE = 'http://taskodone.com/api'
+    SUPPORTED_ACTIONS = [ :papers, :paper, :rename, :edit, :new, :delete ]
+    
+    attr_reader :response
+    attr_reader :papers
+        
+    # Creates an instance of the API processor with +hash+ passed a set of configuration
+    # options in a hash. +hash+ should either be a Tasko user ID and API key (in this case
+    # +:user+ and +:key+), or a file where those keys are located in YAML format (in this case
+    # +:config+).
+    def initialize hash
+      @config = {}
+      
+      raise ArgumentError, 
+        'please specify either :user and :key or :config' unless (hash.has_key? :user and hash.has_key? :key) or (hash.has_key? :config)
+      
+      @config['user'] = hash[:user] if hash.has_key? :user
+      @config['key']  = hash[:key]  if hash.has_key? :key
+      
+      if hash.has_key? :config
+        begin
+          @config = parse_config(File.expand_path(hash[:config]))
+        rescue
+          raise ArgumentError, "unable to load from file #{hash[:config]}"
+        end
+      end
+      
+    end
+    
+    # The user ID specified in the API configuration.
+    def user; @config['user']; end
+    
+    # The API key specified in the API configuration.
+    def key;  @config['key'];  end
+        
+    # Request something from the server. See SUPPORTED_ACTIONS for what is possible to retrieve
+    # and send. A brief summary follows:
+    #
+    # <tt>api.request :papers</tt>:: retrieve a list of all papers the user has saved to Tasko.
+    # <tt>api.request :paper, 'Paper Name'</tt>:: return the single paper with the name passed to +request+.
+    # <tt>api.request :rename, 'Old Paper Name', 'New Paper Name'</tt>:: rename one of the papers in the account.
+    # <tt>api.request :edit, 'Paper Name', 'Paper Body'</tt>:: save a new version of the document to Tasko.
+    def request type, *args
+      raise ArgumentError, "invalid send request type #{type}" unless SUPPORTED_ACTIONS.include? type
+
+      begin
+        @req = request_generator
+        @response = @req.send :post, (base_payload type, *args)
+      rescue SocketError
+        raise 'the site appears to be unavailable'
+      rescue
+        raise 'there was an error processing your request'
+      end
+
+      return handle_response(type, *args)
+    end
+    
+    alias :get :request
+
+    private
+    
+    def handle_response type, *args
+      doc = REXML::Document.new @response
+      case type
+      when :papers
+        @papers = doc.elements.to_a('//string').map { |m| m.text }
+        return @papers
+      when :paper
+        @data  = doc.elements.to_a('//string').map { |m| m.text }
+        return Taskomaly::Paper.new( args.first, @data.last, self )
+      when :edit
+        @data = doc.elements.to_a('//string').map { |m| m.text }
+        return true if @data.size > 0
+      end
+      
+      return false
+
+    end
+    
+    def request_generator
+      RestClient::Resource.new SERVICE
+    end
+    
+    def parse_config config_filepath
+      YAML::load_file config_filepath
+    end
+    
+    def base_payload method_name, *args
+      params = ''
+      extra_data = ([] << args).flatten.compact
+      if extra_data
+        extra_data.each do |data|
+          type = (data.class == Fixnum) ? 'integer' : 'string'
+          params += "<param><value><#{type}>#{data}</#{type}></value></param>\n"          
+        end
+      end
+      <<-XML
+      <methodCall><methodName>#{method_name}</methodName>
+      <params>
+      <param><value><int>#{user}</int></value></param>
+      <param><value><string>#{key}</string></value></param>
+      #{params}
+      </params></methodCall> 
+      XML
+    end
+    
+  end
+  
+end

data/lib/paper.rb

@@ -0,0 +1,52 @@
+module Taskomaly
+  
+  class Paper
+    
+    attr_accessor :name, :body
+    
+    def self.From file
+      raise ArgumentError, "file #{file} does not exist" unless File.exist? file
+      return Paper.new(
+        file.gsub(/\.\w+$/, '').gsub(/^.*\//, '').gsub(/[-_]/, ' ').split(' ').each{|word| word.capitalize! }.join(' '),
+        File.open(file, "r").readlines.join
+        )
+    end
+    
+    def initialize name, body = "", api = nil
+      @name = name
+      @body = body
+      @api  = api
+      parse_body
+    end
+    
+    def api
+      return @api
+    end
+    
+    def save
+      return false unless @api
+      return @api.request(:edit, @name, @body)
+    end
+    
+    def refresh
+      return false unless @api
+      @body = (@api.request :paper, @name).body
+      return true
+    end
+    
+    def projects
+      @projects
+    end
+    
+    private
+    
+    def parse_body
+      @projects = []
+      @body.split("\n").each do |line|
+        @projects << line.gsub(/:\s*$/, '').gsub(/ /, '_').downcase.to_sym if line =~ /^.*:\s*$/
+      end
+    end
+    
+  end
+  
+end

data/lib/project.rb

@@ -0,0 +1,19 @@
+module Taskomaly
+  
+  class Project
+    
+    attr_accessor :name, :tasks
+    
+    def initialize name
+      @name = name
+      @tasks = []
+    end
+    
+    def add task
+      @tasks << Task.new(task) if task.class == String
+      @tasks << task if task.class == Taskomaly::Task
+    end
+    
+  end
+  
+end

data/lib/task.rb

@@ -0,0 +1,80 @@
+module Taskomaly
+  
+  TAG_REGEX = /\@\w+/
+  
+  def self.Do task
+    return Task.new(task)
+  end
+  
+  class Task
+    
+    attr_accessor :desc, :tags
+    
+    def initialize description
+      @desc, @tags = parse(description)
+      @delimiter = nil
+    end
+    
+    # Tag a task. Duplicate tags are ignored.
+    # 
+    #  t = Taskomaly::Do 'wash the dishes'
+    #  t.tag :kitchen
+    #  puts t.tags  # [:kitchen]
+    #  t.tag :sink, :july, 4
+    #  puts t.tags  # [:kitchen, :sink, :july, :"4"]
+    #
+    def tag *args
+      @tags = [] unless @tags
+      @tags = (@tags + args.map { |tag| tag.to_s.to_sym } ).uniq
+    end
+    
+    # Remove tags from a task.
+    # 
+    #  t = Taskomaly::Do 'wash the dishes @kitchen'
+    #  t.untag :kitchen
+    #  puts t.display    # "wash the dishes"
+    def untag *args
+      return unless @tags
+      @tags = (@tags - args)
+    end
+    
+    # Display the task, with tags appended to the end.
+    # 
+    #  t = Taskomaly::Do 'wash the dishes'
+    #  t.tag :kitchen
+    #  puts t.display     # "wash the dishes @kitchen"
+    def display
+      "#{@desc} #{@tags.collect { |tag| '@' + tag.to_s }.join(@delimiter || ' ')}"
+    end
+    
+    # Change how listing tags are delimited. +delimiter+ is a string, like <tt>','</tt>,
+    # that will be used to join tags. +symmetric_spacing+ is a boolean value
+    # that determines whether or not the delimiter should be separated by tags
+    # on both sides, or just the right side.
+    # Some examples:
+    # 
+    #  t = Taskomaly::Do 'wash the dishes @dishes @sink @other'
+    #  t.display # 'wash the dishes @dishes @sink @other'
+    #  
+    #  t.delimit_with ','
+    #  t.display # 'wash the dishes @dishes, @sink, @other'
+    #  
+    #  t.delimit_with '/'
+    #  t.display # 'wash the dishes @dishes/ @sink/ @other'
+    #  t.delimit_with '/', true
+    #  t.display # 'wash the dishes @dishes / @sink / @other'
+    #
+    def delimit_with delimiter, symmetric_spacing = false
+      @delimiter = (symmetric_spacing ? ' ' : '') + delimiter + ' '
+      return true
+    end
+    
+    private
+    
+    def parse description
+      return description.gsub(TAG_REGEX, '').strip.squeeze(' '), description.scan(TAG_REGEX).map { |tag| tag.to_s.gsub(/^\@/, '').to_sym }.uniq
+    end
+    
+  end
+  
+end

data/lib/taskomaly.rb

@@ -0,0 +1 @@
+%w/ api paper project task /.each { |x| require x }

metadata

@@ -0,0 +1,61 @@
+--- !ruby/object:Gem::Specification 
+name: ardekantur-taskomaly
+version: !ruby/object:Gem::Version 
+  version: 0.0.8
+platform: ruby
+authors: 
+- Ardekantur
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-07-16 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: use taskpaper papers and tasko in ruby
+email: greystone@ardekantur.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+- LICENSE
+files: 
+- LICENSE
+- README.rdoc
+- Rakefile
+- lib/api.rb
+- lib/paper.rb
+- lib/project.rb
+- lib/task.rb
+- lib/taskomaly.rb
+has_rdoc: true
+homepage: http://github.com/ardekantur/taskomaly
+post_install_message: 
+rdoc_options: []
+
+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: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: use taskpaper papers and tasko in ruby
+test_files: []
+