zzamboni-things2thl 0.3.0 → 0.4.0

data/ChangeLog

@@ -0,0 +1,150 @@
+2009-05-19  Diego Zamboni <diego@zzamboni.org>
+
+	* VERSION, lib/Things2THL.rb: Version bump to 0.4.0
+
+2009-05-19  Diego Zamboni <diego@zzamboni.org>
+
+	* lib/Things2THL.rb: Removed per-node type display from progress
+	printout
+
+2009-05-18  Diego Zamboni <diego@zzamboni.org>
+
+	* bin/things2thl: Fetch only completed projects/tasks using
+	Applescript (unless --completed is specified), which drastically
+	improves performance.
+
+2009-05-18  Diego Zamboni <diego@zzamboni.org>
+
+	* bin/things2thl: Improved help text by showing actual options
+
+2009-05-18  Diego Zamboni <diego@zzamboni.org>
+
+	* bin/things2thl, lib/Things2THL.rb: Moved default options
+	generation to Things2THL.default_options.
+
+2009-05-18  Diego Zamboni <diego@zzamboni.org>
+
+	* VERSION, lib/Things2THL.rb, things2thl.gemspec: Version bump to
+	0.3.0
+
+2009-05-18  Diego Zamboni <diego@zzamboni.org>
+
+	* bin/things2thl, lib/Things2THL.rb: Added option
+	--context-tags-regex (-C) for specifying which Things tags should be
+	considered as contexts when moving to THL. By default its value is
+	"^@", which means any tag starting with @ will be entered into THL
+	as a context. Any regular expression can be used.  If any of the
+	tags matched by this regex contains spaces, the spaces will be
+	converted to underscores, since THL does not allow spaces in context
+	names.
+
+2009-05-18  Diego Zamboni <diego@zzamboni.org>
+
+	* bin/things2thl: Code cleanup.
+
+2009-05-18  Diego Zamboni <diego@zzamboni.org>
+
+	* VERSION, things2thl.gemspec: Version bump to 0.2.2
+
+2009-05-18  Diego Zamboni <diego@zzamboni.org>
+
+	* lib/Things2THL.rb: Fixed typo in version number code. Oops
+
+2009-05-18  Diego Zamboni <diego@zzamboni.org>
+
+	* VERSION, lib/Things2THL.rb, things2thl.gemspec: Version bump to
+	0.2.1
+
+2009-05-18  Diego Zamboni <diego@zzamboni.org>
+
+	* VERSION, things2thl.gemspec: Version bump to 0.2.0
+
+2009-05-18  Diego Zamboni <diego@zzamboni.org>
+
+	* Rakefile: Modified Rakefile to use Jeweler
+
+2009-05-18  Diego Zamboni <diego@zzamboni.org>
+
+	* lib/Things2THL.rb: Removed debug message
+
+2009-05-18  Diego Zamboni <diego@zzamboni.org>
+
+	* VERSION: Version bump to 0.1.0
+
+2009-05-18  Diego Zamboni <diego@zzamboni.org>
+
+	* VERSION: Version bump to 0.0.0
+
+2009-05-18  Diego Zamboni <diego@zzamboni.org>
+
+	* lib/Things2THL.rb: Added value caching for ThingsNode, drastically
+	reducing the number of Apple events that have to be generated
+
+2009-05-18  Diego Zamboni <diego@zzamboni.org>
+
+	* lib/Things2THL.rb: Eliminated unnecessary (and extremely frequent)
+	redefinition of ThingsNode methods, which made the script much
+	slower by invoking eval_class thousands of times.
+
+2009-05-17  Diego Zamboni <diego@zzamboni.org>
+
+	* Manifest, Rakefile, things2thl.gemspec: Added Rakefile, Manifest
+	and gemspec file
+
+2009-05-17  Diego Zamboni <diego@zzamboni.org>
+
+	* lib/Things2THL.rb: Added cache of focusnames, and avoid computing
+	the task cache for "Logbook" (which can be pretty big) unless
+	--completed was specified.
+
+2009-05-16  Diego Zamboni <diego@zzamboni.org>
+
+	* README, bin/things2thl, lib/Things2THL.rb: Fully functional
+	version! All the essential functionality is there.  Projects, areas
+	and foci are handled appropriately, as are completed tasks and
+	projects, suspended areas, etc.
+
+2009-05-14  Diego Zamboni <diego@zzamboni.org>
+
+	* lib/Things2THL.rb: - Handle project due dates when --projects-as-lists by creating a
+	  new task within the list, with the appropriate due date.  - Mark fake "notes" task when --projects-as-lists as completed if   the enclosing project is completed or canceled.  - Added project- and area-tag inheritance into individual tasks   when the project/area is a list (THL lists can't have tags) - Added generic internal mechanism for creating additional nodes,
+	  used both for the due dates tasks and the notes tasks.
+
+2009-05-14  Diego Zamboni <diego@zzamboni.org>
+
+	* lib/Things2THL.rb: - Inherit project tags into the corresponding tasks - Base support for putting tasks in the proper focus. So far, only   Today tasks are properly flagged.
+
+2009-05-13  Diego Zamboni <diego@zzamboni.org>
+
+	* lib/Things2THL.rb: Simplified postproc blocks in STRUCTURE by
+	passing the Things2THL object to it, which allows calling methods in
+	the object (the postproc block itself cannot access anything from
+	Things2THL because it is not defined as part of the Things2THL
+	class).
+
+2009-05-13  Diego Zamboni <diego@zzamboni.org>
+
+	* lib/Things2THL.rb: Fixed bug when --projects-as-tasks was used
+
+2009-05-13  Diego Zamboni <diego@zzamboni.org>
+
+	* README, bin/things2thl, lib/Things2THL.rb: Added proper handling
+	of most node attributes, including rudimentary transfering of the
+	tags (not contexts vs tags yet).  Updated README with some usage notes and warnings.
+
+2009-05-12  Diego Zamboni <diego@zzamboni.org>
+
+	* bin/things2thl, lib/Things2THL.rb: - Modified to use Applescript to get stuff out of Things instead   of the things-rb library (needs Things 1.1.1 or later) - Simplified the algorithm to a multiple-pass one (areas, projects,
+	  tasks) using memoization to do the nesting, instead of trying to do
+	  a hierarchical traversal.  - Tasks are also now imported, but those not in projects or areas
+	  are still not divided properly (e.g. in Inbox, Scheduled, etc.)
+
+2009-05-05  Diego Zamboni <diego@zzamboni.org>
+
+	* README: Updated URLs
+
+2009-05-05  Diego Zamboni <diego@zzamboni.org>
+
+	* First commit - partially-working code. Able to transfer some tasks
+	from Things to THL, but not all attributes are preserved yet
+

data/README

@@ -1,6 +1,7 @@
 Things2THL
+http://zzamboni.github.com/things2thl/
 
-Conversion program to transfer all tasks from Things
+Conversion program to transfer data from Things
 (http://culturedcode.com/things/ ) to The Hit List
 (http://www.potionfactory.com/thehitlist/ ).
 
@@ -15,28 +16,41 @@ support.
 You need to install rb-appscript from
 http://appscript.sourceforge.net/rb-appscript/install.html
 
-Run things2thl by changing into the base directory of this
-distribution and running:
-	     ./bin/things2thl [options]
+Then install things2thl by running:
+     $ sudo gem install zzamboni-things2thl --source http://gems.github.com/
 
 
 USAGE:
 -----
 
-To see a usage message:
-
-   ./bin/things2thl -h
-
+Usage: things2thl [options]
+
+Options:
+        --projects-as-lists          Convert projects in Things to lists in THL (default)
+        --projects-as-tasks          Convert projects in Things to tasks in THL
+        --[no-]areas                 Transfer areas from Things (default: yes)
+    -C, --context-tags-regex REGEX   Regular expression to identify tags that should be interpreted as contexts.
+                                       (default: ^@)
+        --top-level-folder FOLDER    If specified, do the import inside the named folders, instead of the top level
+                                      (Inbox, etc. will also be created there instead of their corresponding places)
+        --projects-folder FOLDER     If specified, the named folder will be created to contain all projects when
+                                       --projects-as-lists is used (otherwise they will be put in the top folders group).
+                                       If --projects-as-tasks is used, a 'Projects' list is always created, but this option
+                                       can be used to specify its name.
+    -c, --completed                  Transfer also completed/canceled tasks and projects (default: no)
+        --[no-]archive-completed     If transferring completed/canceled tasks, also mark them as archived (default: yes)
+    -q, --quiet                      Do not print items as they are processed
+    -h, --help                       Shows this help message
+    -v, --version                    Shows version
+
+Options you should seldom need:
+        --things THINGSAPP           Location of the Things application (default: /Applications/Things.app)
+        --thl THLAPP                 Location of the The Hit List application (default: /Applications/The Hit List.app)
 
 
 Functionality still missing:
 ---------------------------
 
-- Handling contexts vs tags
-
-  Plan: make it a user option which Things tasks should be considered
-  as contexts.
-
 - Handle rich-text notes (with attachments, links, etc.) properly
 
   Plan: not sure yet. Need to investigate how notes are stored in
@@ -46,6 +60,12 @@ Functionality still missing:
 
   Not sure how to transfer this to THL. Ideas are welcome.
 
+- Handle "time estimate" tags.
+
+  Plan: Allow specifying certain Things tags (e.g. I use "10min",
+  "30min", "60min") that should be used to set the time estimate for
+  the task in THL.
+
 Known issues:
 -------------
 

data/VERSION

@@ -1 +1 @@
-0.3.0
+0.4.0

data/bin/things2thl

@@ -5,16 +5,7 @@ require File.join(File.dirname(__FILE__), *%w".. lib Things2THL")
 require "optparse"
 require "ostruct"
 
-# Command line options and defaults    
-options=OpenStruct.new
-options.completed = false
-options.database = nil
-options.structure = :projects_as_lists
-options.areas = true
-options.quiet = false
-options.archivecompleted = true
-options.projectsfolder = nil
-options.contexttagsregex = '^@'
+options=Things2THL.default_options
 opts = OptionParser.new do |opts|
   opts.separator ''
   opts.separator 'Options:'
@@ -26,9 +17,9 @@ opts = OptionParser.new do |opts|
     exit  
   end
   
-  opts.on("--projects-as-lists", "Convert projects in Things to lists in THL (default)") { options.structure = :projects_as_lists }
-  opts.on("--projects-as-tasks", "Convert projects in Things to tasks in THL") { options.structure = :projects_as_tasks }
-  opts.on("--no-areas", "Ignore areas in Things") { options.areas = false }
+  opts.on("--projects-as-lists", "Convert projects in Things to lists in THL" + ((options.structure == :projects_as_lists) ? " (default)" : "") ) { options.structure = :projects_as_lists }
+  opts.on("--projects-as-tasks", "Convert projects in Things to tasks in THL" + ((options.structure == :projects_as_tasks) ? " (default)" : "") ) { options.structure = :projects_as_tasks }
+  opts.on("--[no-]areas", "Transfer areas from Things (default: #{options.areas ? 'yes' : 'no'})") { |v| options.areas = v }
   opts.on('-C REGEX', '--context-tags-regex REGEX', 'Regular expression to identify tags that should be interpreted as contexts.',
           "  (default: #{options.contexttagsregex})") do |regex|
     options.contexttagsregex = regex
@@ -45,8 +36,8 @@ opts = OptionParser.new do |opts|
     options.projectsfolder = projfolder
   end
 
-  opts.on("-c", "--completed", 'Transfer also completed/canceled tasks and projects (default: no)') { options.completed = true }
-  opts.on("--no-archive-completed", 'If transferring completed/canceled tasks, also mark them as archived (default: yes)') {options.archivecompleted = false }
+  opts.on("-c", "--completed", "Transfer also completed/canceled tasks and projects (default: #{options.completed ? 'yes' : 'no'})") { options.completed = true }
+  opts.on("--[no-]archive-completed", "If transferring completed/canceled tasks, also mark them as archived (default: #{options.archivecompleted ? 'yes' : 'no'})") {|v| options.archivecompleted = v }
   opts.on("-q", "--quiet", "Do not print items as they are processed") { options.quiet = true }
 #  opts.on("-n", "--dry-run", "Do not create anything in THL, just print the items that would be created") { options.dryrun = true }
 #  opts.on("-n", "--notes", "Shows only tasks with notes") { options[:tasks] = { :onlynotes => true } }
@@ -84,13 +75,22 @@ thl = converter.thl
 
 # First, traverse all areas
 if options.areas
+  puts "Processing Areas of Responsibility" unless options.quiet
   things.areas.get.each do |area|
     converter.process(Things2THL::ThingsNode.new(area))
   end
 end
 
 # Next, traverse all projects, putting each one inside its corresponding area
-things.projects.get.each do |project|
+puts "Processing Projects" unless options.quiet
+if options.completed
+  puts "   (fetching all projects - this may take a while)" unless options.quiet
+  projlist=things.projects.get
+else
+  puts "   (fetching only open projects - this may take a while)" unless options.quiet
+  projlist=things.projects[its.status.eq(:open)].get
+end
+projlist.each do |project|
   converter.process(Things2THL::ThingsNode.new(project))
 end
 
@@ -99,7 +99,15 @@ end
 # - to_dos returns not only tasks, also projects (not areas)
 # - to-dos returns tasks from all the views: Inbox, Today, Scheduled, Someday, and Next, so we have
 #   to separate them and create the appropriate containers as needed
-things.to_dos.get.each do |t|
+puts "Processing tasks" unless options.quiet
+if options.completed
+  puts "   (fetching all tasks - this may take a while)" unless options.quiet
+  tasklist=things.to_dos.get
+else
+  puts "   (fetching only open tasks - this may take a while)" unless options.quiet
+  tasklist=things.to_dos[its.status.eq(:open)].get
+end
+tasklist.each do |t|
   task=Things2THL::ThingsNode.new(t)
   next if task.type != :selected_to_do
   converter.process(task)

data/lib/Things2THL.rb

@@ -11,7 +11,7 @@ require 'appscript'; include Appscript
 module Things2THL
   module Version
     MAJOR  = 0
-    MINOR  = 3
+    MINOR  = 4
     PATCH  = 0
 
     STRING = [MAJOR, MINOR, PATCH].join(".")
@@ -217,7 +217,7 @@ module Things2THL
     attr_accessor :options, :things, :thl
 
     def initialize(opt_struct = nil, things_location = nil, thl_location = nil)
-      @options=opt_struct || OpenStruct.new
+      @options=opt_struct || Things2THL.default_options
       thingsappname=things_location || 'Things'
       thlappname=thl_location || 'The Hit List'
       begin
@@ -539,7 +539,7 @@ module Things2THL
       
       unless (options.quiet) 
         bullet  = (node.type == :area) ? "*" : ((node.status == :completed) ? "✓" : (node.status == :canceled) ? "×" : "-")
-        puts bullet + " " + node.name + " (#{node.type})" 
+        puts bullet + " " + node.name
       end
 
       newnode=create_in_thl(node, container)
@@ -704,6 +704,20 @@ module Things2THL
 
   ####################################################################
 
+  # Return a structure with the default option values
+  def Things2THL.default_options
+    options=OpenStruct.new
+    options.completed = false
+    options.database = nil
+    options.structure = :projects_as_lists
+    options.areas = true
+    options.quiet = false
+    options.archivecompleted = true
+    options.projectsfolder = nil
+    options.contexttagsregex = '^@'
+    return options
+  end
+
   def Things2THL.new(opt_struct = nil, things_db = nil, thl_location = nil)
     Converter.new(opt_struct, things_db, thl_location)
   end

data/things2thl.gemspec

@@ -2,20 +2,22 @@
 
 Gem::Specification.new do |s|
   s.name = %q{things2thl}
-  s.version = "0.3.0"
+  s.version = "0.4.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Diego Zamboni"]
-  s.date = %q{2009-05-18}
+  s.date = %q{2009-05-19}
   s.default_executable = %q{things2thl}
   s.description = %q{Library and command-line tool for migrating Things data to The Hit List}
   s.email = %q{diego@zzamboni.org}
   s.executables = ["things2thl"]
   s.extra_rdoc_files = [
-    "README"
+    "ChangeLog",
+     "README"
   ]
   s.files = [
-    "Manifest",
+    "ChangeLog",
+     "Manifest",
      "README",
      "Rakefile",
      "VERSION",

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: zzamboni-things2thl
 version: !ruby/object:Gem::Version 
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors: 
 - Diego Zamboni
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-05-18 00:00:00 -07:00
+date: 2009-05-19 00:00:00 -07:00
 default_executable: things2thl
 dependencies: []
 
@@ -20,8 +20,10 @@ executables:
 extensions: []
 
 extra_rdoc_files: 
+- ChangeLog
 - README
 files: 
+- ChangeLog
 - Manifest
 - README
 - Rakefile