milk_cap 0.5.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ZDFlZjMxMjY5YTE0NDYxZWRlNTdjYmE1MzlmOGZhMjU4NjA3NTZhNA==
+  data.tar.gz: !binary |-
+    YTI4MzI0NmJmMzg5ODk1MjAyNmJmMTU3OTExMjU0N2JhZTVjNjdkZg==
+SHA512:
+  metadata.gz: !binary |-
+    ZjljMjIwODA0YzJkMDc0OTEzOWMxMjJhY2Y3OWVkOTA2YzU3YzY0Njg2MTI3
+    N2I5ZjQ0ODliMGFkYTNmZWQwZWM4Y2NiYTBkYjEwZjQ4YTI0MTkyNDg4ODcz
+    NzQ3Y2JlMTQ2MWE4ZmI4MWM3MjViNmRkMzI0NjBlOTg1ZGU3Mzc=
+  data.tar.gz: !binary |-
+    NWJmOGJmYTRhM2ExODBjNGU4MTllOWI5OTJkMDgyYWE1YjM3OWQ5NzIyYzc4
+    NTA2MmNjODQ4ZThjOWM0Y2NiMjNkMTRiZDgzOTg2MzkxODk0NmJiYjM2ZTI1
+    OTEwZDBjODk3MGNhODA4ZmM3MTNkMDA2MjA5YjEyZTQ1NjRjY2Y=

data/CHANGELOG.txt

@@ -0,0 +1,21 @@
+
+= milk_cap CHANGELOG.txt
+
+== milk_cap - 0.5.0     released 2014/01/02
+
+- rufus-rtm is now milk_cap: updated docs, contacts, gemspec, etc
+- module Rufus is now MilkCap
+- no functional changes
+
+
+== rufus-rtm - 0.1.3    released 2010/01/24
+
+- removed ugly World.include(Rufus::Verbs) (shame on me)
+- ruby 1.9.x friendly
+- removed evil "require 'rubygems'" from rufus/rtm/base.rb
+- can now pass rtm key and secret via method params (Giorgio's request)
+
+
+== rufus-rtm - 0.1    released 2008/02/14
+
+- initial release

data/LICENSE.txt

@@ -0,0 +1,20 @@
+
+Copyright (c) 2008-2013, John Mettraux, Jeff Leverenz
+
+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.

data/README.rdoc

@@ -0,0 +1,147 @@
+
+= milk_cap
+
+
+== getting it
+
+  gem install milk_cap
+
+or at
+
+https://github.com/jleverenz/milk_cap
+
+
+== credentials
+
+'milk_cap' expects to find RTM credentials in the environment. It will look for:
+
+* RTM_API_KEY
+* RTM_SHARED_SECRET
+* RTM_FROB
+* RTM_AUTH_TOKEN
+
+(Note since version 0.2, it's OK to not set these environment variables and to pass their values for each method with :api_key, :shared_secret, :frob and :auth_token optional parameters (see test_2 of test/tasks_test.rb))
+
+You have to apply for the first two ones at http://www.rememberthemilk.com/services/api/keys.rtm
+
+Once you have the API key and the shared secret, you have to get the frob and the auth token. Fire your 'irb' and
+
+  >> require 'rubygems'
+  >> require 'milk_cap/rtm'
+
+  please visit this URL with your browser and then hit 'enter' :
+
+  http://www.rememberthemilk.com/services/auth/?api_sig=70036e47c38da170fee431f04e29e8f0&frob=fa794036814b78fddf3e5641fe7c37f80e7d91fc&perms=delete&api_key=7f07e4fc5a944bf8c02a7d1e45c79346
+
+visit, the given URL, you should finally be greeted by a message like "You have successfully authorized the application API Application. You may now close this window and continue the authentication process with the application that sent you here.", hit enter...
+
+  ok, now getting auth token...
+
+  here are your RTM_FROB and RTM_AUTH_TOKEN, make sure to place them
+  in your environment :
+
+  export RTM_FROB=3cef465718317b837eec2faeb5340fe777d55c7c
+  export RTM_AUTH_TOKEN=ca0022d705ea1831543b7cdd2d7e3d707a0e1efb
+
+make then sure that all the 4 variables are set in the environment you use for running 'milk_cap'.
+
+
+== usage
+
+  require 'rubygems'
+  require 'milk_cap/rtm'
+
+  include MilkCap::RTM
+
+  #
+  # listing tasks
+
+  tasks = Task.find
+    # finding all the tasks
+
+  tasks = Task.find :filter => "status:incomplete"
+    # finding all the incomplete tasks
+
+  tasks.each do |task|
+
+    puts "task id #{task.task_id}"
+    puts "   #{task.name} (#{task.tags.join(",")})"
+    puts
+  end
+
+  #
+  # adding a task
+
+  task = Task.add! "study this milk_cap gem"
+    # gets added to the 'Inbox' by default
+
+  puts "task id is #{task.task_id}"
+
+  #
+  # enumerating lists
+
+  lists = List.find
+
+  w = lists.find { |l| l.name == 'Work' }
+
+  puts "my Work list id is #{w.list_id}"
+
+  #
+  # adding a task to a list
+
+  task = Task.add! "work, more work", :list_id => w.list_id
+
+  #
+  # completing a task
+
+  task.complete!
+
+  #
+  # deleting a task
+
+  task.delete!
+
+
+Note that the methods that change the state of the Remember The Milk dataset have names ending with an exclamation mark.
+
+Note as well that, there is a 1 second delay before any request to the RTM server, in order to respect their conditions. This may change in future releases.
+
+
+= features yet to implement
+
+* tags modifications
+* smart lists
+* ...
+
+
+= dependencies
+
+The gem 'rufus-verbs' (http://rufus.rubyforge.org/rufus-verbs)
+
+
+== issue tracker
+
+https://github.com/jleverenz/milk_cap/issues
+
+
+== source
+
+https://github.com/jleverenz/milk_cap
+
+  git clone git://github.com/jleverenz/milk_cap.git
+
+
+== contributors
+
+* John Mettraux, jmettraux@gmail.com
+* Jeff Leverenz, jeff.leverenz@gmail.com (maintainer)
+
+
+== origin
+
+milk_cap is the successor gem to rufus-rtm[https://github.com/jmettraux/rufus-rtm], originally authored by John Mettraux (jmettraux@gmail.com, http://jmettraux.wordpress.com). rufus-rtm is no longer actively supported.
+
+
+== license
+
+MIT

data/Rakefile

@@ -0,0 +1,64 @@
+
+
+$: << File.join( File.dirname(__FILE__), "lib" )
+require 'milk_cap/rtm/base'
+
+require 'rubygems'
+require 'rake'
+
+
+#
+# CLEAN
+
+require 'rake/clean'
+CLEAN.include('pkg', 'tmp', 'html')
+task :default => [ :clean ]
+
+
+#
+# GEM
+
+require 'jeweler'
+
+Jeweler::Tasks.new do |gem|
+
+  gem.version = MilkCap::RTM::VERSION
+  gem.name = 'milk_cap'
+  gem.summary = 'Yet another RememberTheMilk wrapper, successor to rufus-rtm.'
+
+  gem.description = %{
+    Yet another RememberTheMilk wrapper, successor to rufus-rtm.
+  }
+  gem.email = 'jeff.leverenz@gmail.com'
+  gem.homepage = 'http://github.com/jleverenz/milk_cap/'
+  gem.authors = [ 'John Mettraux', 'Jeff Leverenz' ]
+  gem.licenses = 'MIT'
+
+  gem.test_file = 'test/test.rb'
+
+  gem.add_dependency 'rufus-verbs', '>= 1.0.0'
+  gem.add_development_dependency 'yard', '>= 0'
+end
+Jeweler::GemcutterTasks.new
+
+
+#
+# DOC
+
+begin
+
+  require 'yard'
+
+  YARD::Rake::YardocTask.new do |doc|
+    doc.options = [
+      '-o', 'html/milk_cap', '--title',
+      "milk_cap #{MilkCap::RTM::VERSION}"
+    ]
+  end
+
+rescue LoadError
+
+  task :yard do
+    abort "YARD is not available : sudo gem install yard"
+  end
+end

data/lib/milk_cap/rtm/base.rb

@@ -0,0 +1,105 @@
+#--
+# 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.
+#
+# Made in Japan.
+#++
+
+
+require 'rufus/verbs'
+
+require 'json' # gem install 'json' or 'json_pure'
+
+begin
+
+  require 'md5'
+
+  def md5 (s)
+    MD5.md5(s).to_s
+  end
+
+rescue LoadError # ruby 1.9.x
+
+  require 'digest/md5'
+
+  def md5 (s)
+    Digest::MD5.hexdigest(s)
+  end
+end
+
+
+module MilkCap
+module RTM
+
+  VERSION = '0.5.0'
+
+  AUTH_ENDPOINT = "http://www.rememberthemilk.com/services/auth/"
+  REST_ENDPOINT = "http://api.rememberthemilk.com/services/rest/"
+
+  # Signs the RTM request (sets the 'api_sig' parameter).
+  #
+  def self.sign (params, secret) #:nodoc:
+
+    params['api_sig'] = md5(secret + params.sort.flatten.join)
+
+    params
+  end
+
+  # Calls an API method (milk the cow).
+  #
+  def self.milk (params={}) #:nodoc:
+
+    sleep 1
+
+    endpoint = params.delete(:endpoint)
+    endpoint = AUTH_ENDPOINT if endpoint == :auth
+    endpoint = endpoint || REST_ENDPOINT
+
+    ps = params.inject({}) { |r, (k, v)| r[k.to_s] = v; r }
+
+    ps['api_key'] = params[:api_key] || ENV['RTM_API_KEY']
+
+    raise 'API_KEY missing from environment or parameters, cannot proceed' \
+      unless ps['api_key']
+
+    ps['frob'] = params[:frob] || ENV['RTM_FROB']
+    ps.delete('frob') if ps['frob'] == nil
+
+    ps['auth_token'] = params[:auth_token] || ENV['RTM_AUTH_TOKEN']
+    ps.delete('auth_token') if ps['auth_token'] == nil
+
+    ps['format'] = 'json'
+
+    secret = params[:shared_secret] || ENV['RTM_SHARED_SECRET']
+
+    sign(ps, secret)
+
+    res = Rufus::Verbs.get(endpoint, :query => ps)
+
+    JSON.parse(res.body)['rsp']
+  end
+
+  # Requests a timeline from RTM.
+  #
+  def self.get_timeline #:nodoc:
+
+    milk(:method => 'rtm.timelines.create')['timeline']
+  end
+
+end
+end

data/lib/milk_cap/rtm/credentials.rb

@@ -0,0 +1,100 @@
+#--
+# 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.
+#
+# Made in Japan.
+#++
+
+
+module MilkCap::RTM
+
+  def self.auth_get_frob #:nodoc:
+
+    r = milk(:method => 'rtm.auth.getFrob')
+    r['frob']
+  end
+
+  def self.auth_get_frob_and_url #:nodoc:
+
+    frob = auth_get_frob
+
+    p = {}
+    p['api_key'] = ENV['RTM_API_KEY']
+    p['perms'] = 'delete'
+    p['frob'] = frob
+    sign(p, ENV['RTM_SHARED_SECRET'])
+
+    [
+      frob,
+      AUTH_ENDPOINT + '?' + p.collect { |k, v| "#{k}=#{v}" }.join("&")
+    ]
+  end
+
+  def self.auth_get_token (frob) #:nodoc:
+
+    begin
+      milk(:method => 'rtm.auth.getToken', :frob => frob)['auth']['token']
+    rescue Exception => e
+      nil
+    end
+  end
+
+  #
+  # ensuring the credentials are present...
+
+  unless ENV['RTM_FROB']
+
+    frob, auth_url = auth_get_frob_and_url
+
+    puts <<-EOS
+
+please visit this URL with your browser and then hit 'enter' :
+
+#{auth_url}
+
+    EOS
+
+    STDIN.gets
+    puts "ok, now getting auth token...\n"
+
+    auth_token = auth_get_token frob
+
+    if auth_token
+
+      puts <<-EOS
+
+here are your RTM_FROB and RTM_AUTH_TOKEN, make sure to place them
+in your environment :
+
+export RTM_FROB=#{frob}
+export RTM_AUTH_TOKEN=#{auth_token}
+
+      EOS
+    else
+
+      puts <<-EOS
+
+couldn't get auth token, please retry...
+
+      EOS
+    end
+
+    exit 0
+  end
+
+end

data/lib/milk_cap/rtm/resources.rb

@@ -0,0 +1,326 @@
+#--
+# 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.
+#
+# Made in Japan.
+#++
+
+
+module MilkCap::RTM
+
+  #
+  # A parent class for Task, List and co.
+  #
+  # Never use directly.
+  #
+  class MilkResource
+
+    def initialize (hsh)
+
+      @hsh = hsh
+      @operations = []
+    end
+
+    # Saves the instance back to RTM.
+    #
+    def save!
+
+      # TODO : compact !
+
+      @operations.reverse.each do |method_name, args|
+
+        self.class.execute method_name, args
+      end
+      @operations = []
+    end
+
+    protected
+
+    # a class method for listing attributes that can be found
+    # in the hash reply coming from RTM...
+    #
+    def self.milk_attr (*att_names) #:nodoc:
+
+      att_names.each do |att_name|
+        class_eval %{
+          def #{att_name}
+            @hsh['#{att_name}']
+          end
+        }
+      end
+    end
+
+    # Calls the milk() method (interacts with the RTM API).
+    #
+    def self.execute (method_name, args={})
+
+      args[:method] = "rtm.#{resource_name}.#{method_name}"
+
+      MilkCap::RTM.milk(args)
+    end
+
+    # Returns the name of the resource as the API knows it
+    # (for example 'tasks' or 'lists').
+    #
+    def self.resource_name
+
+      self.to_s.split('::')[-1].downcase + 's'
+    end
+
+    # Simply calls the timeline() class method.
+    #
+    def timeline
+
+      MilkResource.timeline
+    end
+
+    # Returns the current timeline (fetches one if none has yet
+    # been prepared).
+    #
+    def self.timeline
+
+      @timeline ||= MilkCap::RTM.get_timeline
+    end
+
+    def queue_operation (method_name, args)
+
+      @operations << [ method_name, args ]
+    end
+  end
+
+  #
+  # The RTM Task class.
+  #
+  class Task < MilkResource
+
+    def self.task_attr (*att_names) #:nodoc:
+
+      att_names.each do |att_name|
+        class_eval %{
+          def #{att_name}
+            @hsh['task']['#{att_name}']
+          end
+        }
+      end
+    end
+
+    attr_reader \
+      :list_id,
+      :taskseries_id,
+      :task_id,
+      :tags
+
+    milk_attr \
+      :name,
+      :modified,
+      :participants,
+      :url,
+      :notes,
+      :location_id,
+      :created,
+      :source
+
+    task_attr \
+      :completed,
+      :added,
+      :postponed,
+      :priority,
+      :deleted,
+      :has_due_time,
+      :estimate,
+      :due
+
+    def initialize (list_id, h)
+
+      super(h)
+
+      t = h['task']
+
+      @list_id = list_id
+      @taskseries_id = h['id']
+      @task_id = t['id']
+
+      @tags = TagArray.new(self, h['tags'])
+    end
+
+    # Deletes the task.
+    #
+    def delete!
+
+      self.class.execute('delete', prepare_api_args)
+    end
+
+    # Marks the task as completed.
+    #
+    def complete!
+
+      self.class.execute('complete', prepare_api_args)
+    end
+
+    # Sets the tags for the task.
+    #
+    def tags= (tags)
+
+      tags = tags.split(',') if tags.is_a?(String)
+
+      @tags = TagArray.new(list_id, tags)
+
+      queue_operation('setTasks', tags.join(','))
+    end
+
+    def self.find (params={})
+
+      parse_tasks(execute('getList', params))
+    end
+
+    # Adds a new task (and returns it).
+    #
+    def self.add! (name, opts = {})
+      opts = { list_id: nil, parse: true }.merge(opts)
+
+      args = {}
+      args[:name] = name
+      args[:list_id] = opts[:list_id] if opts[:list_id]
+      args[:timeline] = MilkCap::RTM.get_timeline
+      args[:parse] = 1 unless !opts[:parse]
+
+      h = execute('add', args)
+
+      parse_tasks(h)[0]
+    end
+
+    protected
+
+    def prepare_api_args
+      {
+        :timeline => timeline,
+        :list_id => list_id,
+        :taskseries_id => taskseries_id,
+        :task_id => task_id
+      }
+    end
+
+    def self.parse_tasks (o)
+
+      o = if o.is_a?(Hash)
+
+        r = o[resource_name]
+        o = r if r
+        o['list']
+      end
+
+      o = [ o ] unless o.is_a?(Array)
+        # Nota bene : not the same thing as  o = Array(o)
+
+      o.inject([]) do |r, h|
+
+        list_id = h['id']
+        s = h['taskseries']
+        r += parse_taskseries(list_id, s) if s
+        r
+      end
+    end
+
+    def self.parse_taskseries (list_id, o)
+
+      o = [ o ] unless o.is_a?(Array)
+      o.collect { |s| self.new(list_id, s) }
+    end
+  end
+
+  class List < MilkResource
+
+    attr \
+      :list_id
+
+    milk_attr \
+      :name, :sort_order, :smart, :archived, :deleted, :position, :locked
+
+    def initialize (h)
+
+      super
+      @list_id = h['id']
+    end
+
+    def self.find (params={})
+
+      execute('getList', params)[resource_name]['list'].collect do |h|
+        self.new(h)
+      end
+    end
+  end
+
+  #
+  # An array of tasks.
+  #
+  class TagArray #:nodoc:
+    include Enumerable
+
+    def initialize (task, tags)
+
+      @task = task
+
+      @tags = if tags.is_a?(Array)
+        tags
+      else
+        tags['tag']
+      end
+    end
+
+    def << (tag)
+
+      @tags << tag
+
+      args = prepare_api_args
+      args[:tags] = tag
+
+      @task.queue_operation('addTags', args)
+    end
+
+    def delete (tag)
+
+      @tags.delete tag
+
+      args = prepare_api_args
+      args[:tags] = tag
+
+      @task.queue_operation('removeTags', args)
+    end
+
+    def clear
+
+      @tags.clear
+
+      args = prepare_api_args
+      args[:tags] = ''
+
+      @task.queue_operation('setTags', args)
+    end
+
+    def join (s)
+
+      @tags.join(s)
+    end
+
+    def each
+
+      @tags.each { |e| yield e }
+    end
+  end
+
+end

data/lib/milk_cap/rtm.rb

@@ -0,0 +1,25 @@
+# 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.
+#
+# Made in Japan.
+#++
+
+
+require 'milk_cap/rtm/base'
+require 'milk_cap/rtm/credentials'
+require 'milk_cap/rtm/resources'

data/lib/milk_cap.rb

@@ -0,0 +1,2 @@
+
+require 'milk_cap/rtm'

data/milk_cap.gemspec

@@ -0,0 +1,56 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+# stub: milk_cap 0.5.0 ruby lib
+
+Gem::Specification.new do |s|
+  s.name = "milk_cap"
+  s.version = "0.5.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["John Mettraux", "Jeff Leverenz"]
+  s.date = "2014-01-02"
+  s.description = "\n    Yet another RememberTheMilk wrapper, successor to rufus-rtm.\n  "
+  s.email = "jeff.leverenz@gmail.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    "CHANGELOG.txt",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "lib/milk_cap.rb",
+    "lib/milk_cap/rtm.rb",
+    "lib/milk_cap/rtm/base.rb",
+    "lib/milk_cap/rtm/credentials.rb",
+    "lib/milk_cap/rtm/resources.rb",
+    "milk_cap.gemspec",
+    "test/tasks_test.rb",
+    "test/test.rb"
+  ]
+  s.homepage = "http://github.com/jleverenz/milk_cap/"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "2.1.11"
+  s.summary = "Yet another RememberTheMilk wrapper, successor to rufus-rtm."
+  s.test_files = ["test/test.rb"]
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 4
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<rufus-verbs>, [">= 1.0.0"])
+      s.add_development_dependency(%q<yard>, [">= 0"])
+    else
+      s.add_dependency(%q<rufus-verbs>, [">= 1.0.0"])
+      s.add_dependency(%q<yard>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rufus-verbs>, [">= 1.0.0"])
+    s.add_dependency(%q<yard>, [">= 0"])
+  end
+end
+

data/test/tasks_test.rb

@@ -0,0 +1,113 @@
+require 'rubygems'
+
+require 'test/unit'
+
+$: << File.dirname(__FILE__) + '/../lib'
+
+require 'milk_cap/rtm'
+
+include MilkCap::RTM
+
+
+class TasksTest < Test::Unit::TestCase
+
+  #def setup
+  #end
+
+  #def teardown
+  #end
+
+  def test_0
+
+    taskname = "milk the cow #{Time.now.to_i}"
+
+    t0 = Task.add!(taskname)
+
+    assert_kind_of Task, t0
+    assert_equal taskname, t0.name
+
+    ts = Task.find
+
+    #puts "tasks : #{ts.size}"
+
+    t1 = ts.find { |t| t.task_id == t0.task_id }
+    assert_equal taskname, t1.name
+    assert_equal '', t1.tags.join(',')
+
+    ts = Task.find :filter => "status:incomplete"
+
+    #puts "incomplete tasks : #{ts.size}"
+
+    t1 = ts.find { |t| t.task_id == t0.task_id }
+    assert_equal taskname, t1.name
+
+    t1.delete!
+
+    ts = Task.find :filter => "status:incomplete"
+
+    t1 = ts.find { |t| t.task_id == t0.task_id }
+    assert_nil t1
+  end
+
+  def test_1
+
+    lists = List.find
+    assert_not_nil(lists.find { |e| e.name == 'Inbox' })
+
+    work = lists.find { |e| e.name == 'Work' }
+
+    taskname = "more work #{Time.now.to_i}"
+
+    t0 = Task.add! taskname, :list_id => work.list_id
+
+    tasks = Task.find :list_id => work.list_id, :filer => 'status:incomplete'
+
+    assert_not_nil(tasks.find { |t| t.task_id == t0.task_id })
+
+    t0.complete!
+
+    tasks = Task.find :list_id => work.list_id, :filer => 'status:completed'
+    assert_not_nil(tasks.find { |t| t.task_id == t0.task_id })
+
+    t0.delete!
+  end
+
+  def test_2
+
+    key = ENV.delete('RTM_API_KEY')
+    secret = ENV.delete('RTM_SHARED_SECRET')
+
+    assert_raise RuntimeError do
+      lists = List.find
+    end
+
+    assert_not_nil List.find(:api_key => key, :shared_secret => secret)
+
+    ENV['RTM_API_KEY'] = key
+    ENV['RTM_SHARED_SECRET'] = secret
+  end
+
+  def test_smart_add
+    taskname = "more work #{Time.now.to_i}"
+    smart_add_string = "#{taskname} tomorrow"
+    task = Task.add! smart_add_string
+
+    tasks = Task.find
+
+    task_created = tasks.find { |t| t.task_id == task.task_id }
+    assert !task_created.due.empty?
+    assert_equal taskname, task_created.name  # 'tomorrow' is stripped as due date
+  end
+
+  def test_turn_smart_add_off
+    taskname = "more work #{Time.now.to_i} tomorrow"
+    task = Task.add! taskname, :parse => false
+
+    tasks = Task.find
+
+    task_created = tasks.find { |t| t.task_id == task.task_id }
+    assert task_created.due.empty?
+    assert_equal taskname, task_created.name
+  end
+
+end

data/test/test.rb

@@ -0,0 +1,3 @@
+
+Dir["#{File.dirname(__FILE__)}/*_test.rb"].each { |path| load(path) }
+

metadata

@@ -0,0 +1,88 @@
+--- !ruby/object:Gem::Specification
+name: milk_cap
+version: !ruby/object:Gem::Version
+  version: 0.5.0
+platform: ruby
+authors:
+- John Mettraux
+- Jeff Leverenz
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-01-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rufus-verbs
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: yard
+  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'
+description: ! "\n    Yet another RememberTheMilk wrapper, successor to rufus-rtm.\n
+  \ "
+email: jeff.leverenz@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+files:
+- CHANGELOG.txt
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- lib/milk_cap.rb
+- lib/milk_cap/rtm.rb
+- lib/milk_cap/rtm/base.rb
+- lib/milk_cap/rtm/credentials.rb
+- lib/milk_cap/rtm/resources.rb
+- milk_cap.gemspec
+- test/tasks_test.rb
+- test/test.rb
+homepage: http://github.com/jleverenz/milk_cap/
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- 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.1.11
+signing_key: 
+specification_version: 4
+summary: Yet another RememberTheMilk wrapper, successor to rufus-rtm.
+test_files:
+- test/test.rb