Class: OmniFocus

Inherits:
Object show all
Defined in:
lib/omnifocus.rb,
lib/omnifocus.rb

Overview

Synchronizes bug tracking systems to omnifocus.

Some definitions:

bts: bug tracking system SYSTEM: a tag uniquely identifying the bts bts_id: a string uniquely identifying a task: SYSTEM(-projectname)?#id

Defined Under Namespace

Classes: Context, Project, Task, Thingy

Constant Summary collapse

VERSION = 
"2.7.1"

Class Attribute Summary collapse

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ OmniFocus

Returns a new instance of OmniFocus.



92
93
94
95
96
97
 
# File 'lib/omnifocus.rb', line 92

def initialize
  @bug_db   = Hash.new { |h,k| h[k] = {} }
  @existing = {}
  self.debug = false
  self.config = load_or_create_config
end

Class Attribute Details

.current_desc ⇒ Object

Returns the value of attribute current_desc.



36
37
38
 
# File 'lib/omnifocus.rb', line 36

def current_desc
  @current_desc
end

.description ⇒ Object

Returns the value of attribute description.



36
37
38
 
# File 'lib/omnifocus.rb', line 36

def description
  @description
end

Instance Attribute Details

#bug_db ⇒ Object (readonly)

bug_db = 

project => {
  bts_id => [task_name, url, due, defer], # only on BTS     = add to OF
  bts_id => {field=>value, ...,          # only on BTS     = OF and maybe BTS. Update fields
  bts_id => true,                         # both BTS and OF = don't touch
}

}



61
62
63
 
# File 'lib/omnifocus.rb', line 61

def bug_db
  @bug_db
end

#config ⇒ Object

Returns the value of attribute config.



72
73
74
 
# File 'lib/omnifocus.rb', line 72

def config
  @config
end

#debug ⇒ Object

Returns the value of attribute debug.



70
71
72
 
# File 'lib/omnifocus.rb', line 70

def debug
  @debug
end

#existing ⇒ Object (readonly)

existing = 

bts_id => project,




68
69
70
 
# File 'lib/omnifocus.rb', line 68

def existing
  @existing
end

Class Method Details

._load_plugins(filter = ARGV.shift) ⇒ Object

Load any file matching “omnifocus/*.rb”



77
78
79
80
81
82
83
84
85
86
87
88
89
90
 
# File 'lib/omnifocus.rb', line 77

def self._load_plugins filter = ARGV.shift
  @__loaded__ ||=
    begin
      loaded = {}
      Gem.find_files("omnifocus/*.rb").each do |path|
        name = File.basename path
        next if loaded[name]
        next unless path.index filter if filter
        require path
        loaded[name] = true
      end
      true
    end
end

._plugins ⇒ Object

Return all the plugin modules that have been loaded.



283
284
285
286
287
288
289
290
 
# File 'lib/omnifocus.rb', line 283

def self._plugins
  _load_plugins

  constants.
    reject { |mod| mod =~ /^[A-Z_]+$/ }.
    map    { |mod| const_get mod }.
    reject { |mod| Class === mod }
end

.desc(str) ⇒ Object 



48
49
50
 
# File 'lib/omnifocus.rb', line 48

def self.desc str
  @current_desc = str
end

.method_added(name) ⇒ Object 



42
43
44
45
46
 
# File 'lib/omnifocus.rb', line 42

def self.method_added name
  return unless name =~ /^cmd_/
  description[name] = current_desc || "UNKNOWN"
  self.current_desc = nil
end

.method_missing(msg, *args) ⇒ Object 



330
331
332
333
 
# File 'lib/omnifocus.rb', line 330

def self.method_missing(msg, *args)
  of = OmniFocus.new
  of.send("cmd_#{msg}", *args)
end

Instance Method Details

#_context(name) ⇒ Object 



1007
1008
1009
1010
1011
 
# File 'lib/omnifocus.rb', line 1007

def _context name
  context   = self.omnifocus.flattened_tags[name].get     rescue nil
  context ||= self.omnifocus.flattened_contexts[name].get rescue nil
  context
end

#_flattened_contexts ⇒ Object 



1001
1002
1003
1004
1005
 
# File 'lib/omnifocus.rb', line 1001

def _flattened_contexts
  contexts   = self.omnifocus.flattened_tags.get     rescue nil
  contexts ||= self.omnifocus.flattened_contexts.get rescue nil
  contexts
end

#active ⇒ Object 



981
982
983
 
# File 'lib/omnifocus.rb', line 981

def active
  its.completed.eq(false)
end

#active_project ⇒ Object 



977
978
979
 
# File 'lib/omnifocus.rb', line 977

def active_project
  its.status.eq(:active)
end

#active_projects ⇒ Object 



1029
1030
1031
1032
1033
 
# File 'lib/omnifocus.rb', line 1029

def active_projects
  self.omnifocus.flattened_projects[active_project].get.map { |p|
    Project.new omnifocus, p
  }
end

#add_hours(t, n) ⇒ Object 



378
379
380
 
# File 'lib/omnifocus.rb', line 378

def add_hours t, n
  t + (n * 3600).to_i
end

#aggregate(collection) ⇒ Object 



894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
 
# File 'lib/omnifocus.rb', line 894

def aggregate collection
  h = Hash.new { |h1,k1| h1[k1] = Hash.new { |h2,k2| h2[k2] = [] } }
  p = Hash.new 0

  collection.each do |thing|
    name = thing.name
    ri   = case thing
           when Project then
             thing.review_interval
           when Task then
             thing.repetition
           else
             raise "unknown type: #{thing.class}"
           end
    date = case thing
           when Project then
             thing.next_review_date
           when Task then
             thing.due_date
           else
             raise "unknown type: #{thing.class}"
           end

    date = if date then
             date.strftime("%Y-%m-%d %a")
           else
             "unscheduled"
           end

    time = ri ? "#{ri[:steps]}#{ri[:unit].to_s[0,1]}" : "NR"

    p[time] += 1
    h[date][time] << name
  end

  return h, p
end

#aggregate_releases ⇒ Object 



558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
 
# File 'lib/omnifocus.rb', line 558

def aggregate_releases
  rels = context "Releasing"

  tasks = Hash.new { |h,k| h[k] = [] } # name => tasks
  projs = Hash.new { |h,k| h[k] = [] } # step => projs

  rels.tasks.each do |task|
    proj = task.project
    tasks[proj.name] << task
    projs[proj.review_interval[:steps]] << proj
  end

  projs.each do |k, a|
    # helps stabilize and prevent random shuffling
    projs[k] = a.uniq_by { |p| p.name }.sort_by { |p|
      tasks[p.name].map(&:name).min
    }
  end

  return rels, tasks, projs
end

#all_active_tasks ⇒ Object 



141
142
143
 
# File 'lib/omnifocus.rb', line 141

def all_active_tasks
  omnifocus.flattened_projects.tasks[active].get.flatten.map{|t| all_subtasks(t, active) }.flatten
end

#all_contexts ⇒ Object 



1013
1014
1015
1016
1017
 
# File 'lib/omnifocus.rb', line 1013

def all_contexts
  _flattened_contexts.map { |c|
    Context.new omnifocus, c
  }
end

#all_projects ⇒ Object 



989
990
991
992
993
 
# File 'lib/omnifocus.rb', line 989

def all_projects
  self.omnifocus.flattened_projects.get.map { |p|
    Project.new omnifocus, p
  }
end

#all_subtasks(task, filter = nil) ⇒ Object 



127
128
129
130
131
132
133
 
# File 'lib/omnifocus.rb', line 127

def all_subtasks task, filter = nil
  if filter then
    [task] + task.tasks[filter].get.flatten.map{ |t| all_subtasks t, filter }
  else
    [task] + task.tasks.get.flatten.map{ |t| all_subtasks t }
  end
end

#all_tasks ⇒ Object 



135
136
137
138
139
 
# File 'lib/omnifocus.rb', line 135

def all_tasks
  # how to filter on active projects. note, this causes sync problems
  # omnifocus.flattened_projects[its.status.eq(:active)].tasks.get.flatten
  omnifocus.flattened_projects.tasks.get.flatten.map{|t| all_subtasks(t) }.flatten
end

#calculate_schedule(projs) ⇒ Object 



523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
 
# File 'lib/omnifocus.rb', line 523

def calculate_schedule projs
  all = [
         distribute(projs[1].size, 1),
         distribute(projs[2].size, 2),
         distribute(projs[3].size, 3),
         distribute(projs[5].size, 5),
         distribute(projs[7].size, 7),
        ]

  # [[1, 1, 1, 1, 1],
  #  [2, 2, 2, 2, 2, nil, 2, 2, 2, 2],
  #  [3, nil, 3, 3, nil, 3, 3, nil, 3, 3, nil, 3, 3, nil, 3],
  #  ...

  all.map! { |a|
    a.concat [nil] * (35-a.size)
    a.each_slice(5).to_a
  }

  # [[[1, 1, 1, 1, 1],     [nil, nil, nil, nil, nil], ...
  #  [[2, 2, 2, 2, 2],     [nil, 2, 2, 2, 2],         ...
  #  [[3, nil, 3, 3, nil], [3, 3, nil, 3, 3],         ...
  #  ...

  weeks = all.transpose.map { |a, *r|
    a.zip(*r).map(&:compact)
  }

  # [[[1, 2, 3, 5, 7], [1, 2], [1, 2, 3], [1, 2, 3], [1, 2, 5]],
  #  [[3], [2, 3, 7], [2], [2, 3, 5], [2, 3]],
  #  ...

  weeks
end

#cmd_fix_review_dates(args) ⇒ Object

TODO: merge into reschedule



481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
 
# File 'lib/omnifocus.rb', line 481

def cmd_fix_review_dates args # TODO: merge into reschedule
  skip = ARGV.first == "-n"

  projs = all_projects.group_by { |proj| proj.review_interval[:steps] }

  projs.each do |k, a|
    # helps stabilize and prevent random shuffling
    projs[k] = a.sort_by { |p| [p.next_review_date, p.name] }
  end

  now = hour 0
  fri = if now.wday == 5 then
          now
        else
          now - 86400 * (now.wday-5)
        end

  no_autosave_during do
    projs.each do |unit, a|
      day = fri

      steps = (a.size.to_f / unit).ceil

      a.each_with_index do |proj, i|
        if proj.next_review_date != day then
          warn "Fixing #{unit} #{proj.name} to #{day}"
          proj.thing.next_review_date.set day unless skip
        end

        day += 86400 * 7 if (i+1) % steps == 0
      end
    end
  end
end

#cmd_help(args) ⇒ Object 



456
457
458
459
460
461
462
463
464
465
466
467
 
# File 'lib/omnifocus.rb', line 456

def cmd_help args
  methods = OmniFocus.public_instance_methods(false).grep(/^cmd_/)
  methods.map! { |s| s[4..-1] }
  width = methods.map(&:length).max

  puts "Available subcommands:"

  methods.sort.each do |m|
    desc = self.class.description["cmd_#{m}".to_sym]
    puts "  %-#{width}s : %s." % [m, desc]
  end
end

#cmd_neww(args) ⇒ Object 



342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
 
# File 'lib/omnifocus.rb', line 342

def cmd_neww args
  project_name = args.shift
  title = ($stdin.tty? ? args.join(" ") : $stdin.read).strip

  unless project_name && ! title.empty? then
    cmd = File.basename $0
    projects = omnifocus.flattened_projects.name.get.sort_by(&:downcase)

    warn "usage: #{cmd} new project_name title        - create a project task"
    warn "       #{cmd} new nil          title        - create an inbox task"
    warn "       #{cmd} new project      project_name - create a new project"
    warn ""
    warn "project_names = #{projects.join ", "}"
    exit 1
  end

  case project_name.downcase
  when "nil" then
    omnifocus.make :new => :inbox_task, :with_properties => {:name => title}
  when "project" then
    new_or_repair_project title
  else
    project = omnifocus.flattened_projects[its.name.eq(project_name)].first.get
    make project, :task, title
    puts "created task in #{project_name}: #{title}"
  end
end

#cmd_projects(args) ⇒ Object 



390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
 
# File 'lib/omnifocus.rb', line 390

def cmd_projects args
  h = Hash.new 0
  n = 0

  # FIX: this seems broken
  self.active_projects.each do |project|
    name  = project.name
    count = project.unscheduled_tasks.size
    ri    = project.review_interval
    time  = "#{ri[:steps]}#{ri[:unit].to_s[0,1]}"

    next unless count > 0

    n += count
    h["#{name} (#{time})"] = count
  end

  puts "%5d: %3d%%: %s" % [n, 100, "Total"]
  puts
  h.sort_by { |name, count| -count }.each do |name, count|
    puts "%5d: %3d%%: %s" % [count, 100 * count / n, name]
  end
end

#cmd_reschedule(args) ⇒ Object 



748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
 
# File 'lib/omnifocus.rb', line 748

def cmd_reschedule args
  skip = ARGV.first == "-n"

  rels, tasks, projs = aggregate_releases

  no_autosave_during do
    warn "Checking project review intervals..."
    fix_project_review_intervals rels, skip

    warn "Checking releasing task numeric prefixes (if any)"
    fix_release_task_names projs, tasks, skip

    warn "Checking releasing task schedules"
    fix_release_task_schedule projs, tasks, skip

    warn "Repairing any missing release or triage tasks"
    fix_missing_tasks skip
  end
end

#cmd_review(args) ⇒ Object 



783
784
785
 
# File 'lib/omnifocus.rb', line 783

def cmd_review args
  print_aggregate_report live_projects
end

#cmd_schedule(args) ⇒ Object 



470
471
472
473
474
475
476
477
478
 
# File 'lib/omnifocus.rb', line 470

def cmd_schedule args
  name = args.shift or abort "need a context or project name"

  cp = context(name) || project(name)

  abort "Context/Project not found: #{name}" unless cp

  print_aggregate_report cp.tasks, :long
end

#cmd_sync(args) ⇒ Object 



293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
 
# File 'lib/omnifocus.rb', line 293

def cmd_sync args
  self.debug = args.delete("-d")
  plugins = self.class._plugins

  # do this all up front so we can REALLY fuck shit up with plugins
  plugins.each do |plugin|
    extend plugin
  end

  prepopulate_existing_tasks

  plugins.each do |plugin|
    name = plugin.name.split(/::/).last.downcase
    warn "scanning #{name}"
    send "populate_#{name}_tasks"
  end

  if debug then
    require 'pp'
    p :existing
    pp existing
    p :bug_db
    pp bug_db
  end

  create_missing_projects
  update_tasks
end

#cmd_time(args) ⇒ Object 



769
770
771
772
773
774
775
776
777
778
779
780
 
# File 'lib/omnifocus.rb', line 769

def cmd_time args
  m = 0

  all_tasks.map { |task|
    task.estimated_minutes.get
  }.grep(Numeric).each { |t|
    m += t
  }

  puts "all tasks = #{m} minutes"
  puts "          = %.2f hours" % (m / 60.0)
end

#cmd_version(args) ⇒ Object 



440
441
442
443
444
445
446
447
448
449
450
451
452
453
 
# File 'lib/omnifocus.rb', line 440

def cmd_version args
  plugins = self.class._plugins

  width = plugins.map(&:name).map(&:length).max
  fmt = "  %-#{width}s = v%s"

  puts "Versions:"
  puts

  puts fmt % ["Omnifocus", VERSION]
  plugins.each do |klass|
    puts fmt % [klass, klass::VERSION]
  end
end

#cmd_wtf(args) ⇒ Object 



414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
 
# File 'lib/omnifocus.rb', line 414

def cmd_wtf args
  filter = its.completed.eq(false).and(its.repetition.eq(:missing_value))

  h1 = Hash.new 0
  _flattened_contexts.each do |context|
    context.tasks[filter].get.each do |task|
      h1[[task.containing_project.name.get, context.name.get].join(": ")] += 1
    end
  end

  h2 = Hash.new 0
  _flattened_contexts.each do |context|
    h2[context.name.get] += context.tasks[filter].count
  end

  h3 = Hash.new 0
  omnifocus.flattened_projects.get.each do |project|
    h3[project.name.get] += project.tasks[filter].count
  end

  top(h1).zip(top(h2), top(h3)).each do |a|
    puts "%-26s%-26s%-26s" % a
  end
end

#context(name) ⇒ Object 



1019
1020
1021
1022
 
# File 'lib/omnifocus.rb', line 1019

def context name
  context = _context name
  Context.new omnifocus, context if context
end

#create_missing_projects ⇒ Object

Create any projects in bug_db that aren’t in omnifocus, add under the nerd folder.



218
219
220
221
222
223
224
 
# File 'lib/omnifocus.rb', line 218

def create_missing_projects
  (bug_db.keys - nerd_projects.projects.name.get).each do |name|
    warn "creating project #{name}"
    next if debug
    make nerd_projects, :project, name
  end
end

#distribute(count, weeks) ⇒ Object 



516
517
518
519
520
521
 
# File 'lib/omnifocus.rb', line 516

def distribute count, weeks
  count = count.to_f
  d = 5 * weeks
  hits = (1..d).step(d/count).map(&:round)
  (1..d).map { |n| hits.include?(n) ? weeks : nil }
end

#excluded_projects ⇒ Object 



115
116
117
 
# File 'lib/omnifocus.rb', line 115

def excluded_projects
  config[:exclude]
end

#fix_missing_tasks(skip) ⇒ Object 



722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
 
# File 'lib/omnifocus.rb', line 722

def fix_missing_tasks skip
  q_rel = its.completed.eq(false).and(its.name.begins_with("Release"))
  q_tri = its.completed.eq(false).and(its.name.begins_with("Triage"))

  nerd_projects.projects.get.each do |proj|
    name = proj.name.get

    rel = proj.tasks[q_rel].first.get rescue nil
    tri = proj.tasks[q_tri].first.get rescue nil

    case [!!rel, !!tri]
    when [true, true] then
      # do nothing
    when [false, false] then
      # do nothing?
    when [true, false] then # create triage
      warn "  Repairing triage for #{name}"
      new_or_repair_project name unless skip
    when [false, true] then # create release
      warn "  Repairing release for #{name}"
      new_or_repair_project name unless skip
    end
  end
end

#fix_project_review_intervals(rels, skip) ⇒ Object 



636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
 
# File 'lib/omnifocus.rb', line 636

def fix_project_review_intervals rels, skip
  rels.tasks.each do |task|
    begin
      proj = task.project

      t_ri = task.repetition[:steps]
      p_ri = proj.review_interval[:steps]

      if t_ri != p_ri then
        warn "Fixing #{task.name} to #{p_ri} weeks"

        rep = {
               :recurrence        => "FREQ=WEEKLY;INTERVAL=#{p_ri}",
               :repetition_method => :fixed_repetition,
              }

        task.thing.repetition_rule.set :to => rep unless skip
      end
    rescue => e
      warn "ERROR: skipping '#{task.name}' in '#{proj.name}': #{e.message}"
    end
  end
end

#fix_release_task_names(projs, tasks, skip) ⇒ Object 



660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
 
# File 'lib/omnifocus.rb', line 660

def fix_release_task_names projs, tasks, skip
  projs.each do |step, projects|
    projects.each do |project|
      tasks[project.name].each do |task|
        if task.name =~ /^(\d+(\.\d+)?)/ then
          if $1.to_i != step then
            new_name = task.name.sub(/^(\d+(\.\d+)?)/, step.to_s)
            puts "renaming to #{new_name}"
            task.thing.name.set new_name unless skip
          end
        end
      end
    end
  end
end

#fix_release_task_schedule(projs, tasks, skip) ⇒ Object 



676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
 
# File 'lib/omnifocus.rb', line 676

def fix_release_task_schedule projs, tasks, skip
  weeks = calculate_schedule projs

  now = hour 0
  mon = if now.wday == 1 then
          now
        else
          now - 86400 * (now.wday-1)
        end

  weeks.each_with_index do |week, wi|
    week.each_with_index do |day, di|
      next if day.empty?
      delta = wi*7 + di
      date = mon + 86400 * delta

      day.each do |rank|
        p = projs[rank].shift
        t = tasks[p.name]

        t.each do |task|
          if task.start_date != date then
            due_date1  = add_hours date, 16
            due_date2  = add_hours date, 16.5

            warn "Fixing #{p.name} to #{date.strftime "%Y-%m-%d"}"

            next if skip

            case task.name
            when /Release/ then
              task.start_date = date
              task.due_date = due_date1
            when /Triage/ then
              task.start_date = date
              task.due_date = due_date2
            else
              warn "Unknown task name: #{task.name}"
            end
          end
        end
      end
    end
  end
end

#hour(n) ⇒ Object 



382
383
384
385
386
387
 
# File 'lib/omnifocus.rb', line 382

def hour n
  t = Time.now
  midnight = Time.gm t.year, t.month, t.day
  midnight -= t.utc_offset
  midnight + (n * 3600).to_i
end

#its ⇒ Object

:nodoc:



119
120
121
 
# File 'lib/omnifocus.rb', line 119

def its # :nodoc:
  Appscript.its
end

#live_projects ⇒ Object 



995
996
997
998
999
 
# File 'lib/omnifocus.rb', line 995

def live_projects
  self.omnifocus.flattened_projects[non_dropped_project].get.map { |p|
    Project.new omnifocus, p
  }
end

#load_or_create_config ⇒ Object 



99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
 
# File 'lib/omnifocus.rb', line 99

def load_or_create_config
  path = File.expand_path "~/.omnifocus.yml"

  unless File.exist? path then
    config = { :exclude => %w[proj_a proj_b proj_c] }

    File.open path, "w" do |f|
      YAML.dump config, f
    end

    abort "Created default config in #{path}. Go fill it out."
  end

  YAML.load File.read path
end

#make(target, type, name, extra = {}) ⇒ Object

Utility shortcut to make a new thing with a name via appscript.



148
149
150
 
# File 'lib/omnifocus.rb', line 148

def make target, type, name, extra = {}
  target.make :new => type, :with_properties => { :name => name }.merge(extra)
end

#mechanize ⇒ Object

Returns the mechanize agent



209
210
211
212
 
# File 'lib/omnifocus.rb', line 209

def mechanize
  require 'mechanize'
  @mechanize ||= Mechanize.new
end

#nerd_projects ⇒ Object

Get all projects under the nerd folder



155
156
157
158
159
160
161
162
163
164
165
166
167
 
# File 'lib/omnifocus.rb', line 155

def nerd_projects
  unless defined? @nerd_projects then
    @nerd_projects = omnifocus.folders[NERD_FOLDER]

    begin
      @nerd_projects.get
    rescue
      make omnifocus, :folder, NERD_FOLDER
    end
  end

  @nerd_projects
end

#new_or_repair_project(name) ⇒ Object 



580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
 
# File 'lib/omnifocus.rb', line 580

def new_or_repair_project name
  warn "project #{name}"

  rep          = weekly
  start_date   = hour 0
  rel_due_date = hour 16
  tri_due_date = hour 16.5
  props = {
    :repetition        => rep,
    :defer_date        => start_date,
    :estimated_minutes => 10,
  }

  min30 = 30 * 60

  rel_q = its.completed.eq(false).and(its.name.begins_with("Release"))
  tri_q = its.completed.eq(false).and(its.name.begins_with("Triage"))

  rel_tag = context("Releasing").thing
  tri_tag = context("Triaging").thing

  proj = nerd_projects.projects[name].get rescue nil

  unless proj then
    warn "creating #{name} project"
    proj = make nerd_projects, :project, name, :review_interval => rep
  end

  rel_task = proj.tasks[rel_q].first.get rescue nil
  tri_task = proj.tasks[tri_q].first.get rescue nil

  if rel_task || tri_task then # repair
    new_task_from proj, tri_task, "Release #{name}", rel_tag, -min30 unless rel_task
    new_task_from proj, rel_task, "Triage #{name}",  tri_tag, +min30 unless tri_task
  else
    make proj, :task, "Release #{name}", props.merge(:due_date => rel_due_date,
                                                     :primary_tag => rel_tag)
    make proj, :task, "Triage #{name}",  props.merge(:due_date => tri_due_date,
                                                     :primary_tag => tri_tag)
  end
end

#new_task_from(proj, task, name, tag, offset) ⇒ Object 



622
623
624
625
626
627
628
629
630
631
632
633
634
 
# File 'lib/omnifocus.rb', line 622

def new_task_from proj, task, name, tag, offset
  warn "  + #{name} task"

  props = {
    :estimated_minutes => 10,
    :due_date          => task.due_date.get + offset,
    :defer_date        => task.defer_date.get,
    :repetition        => task.repetition.get,
    :primary_tag       => tag,
  }

  make proj, :task, name, props
end

#no_autosave_during ⇒ Object 



1049
1050
1051
1052
1053
1054
 
# File 'lib/omnifocus.rb', line 1049

def no_autosave_during
  self.omnifocus.will_autosave.set false
  yield
ensure
  self.omnifocus.will_autosave.set true
end

#non_dropped_project ⇒ Object 



985
986
987
 
# File 'lib/omnifocus.rb', line 985

def non_dropped_project
  its.status.eq(:dropped_status).not
end

#omnifocus ⇒ Object 



123
124
125
 
# File 'lib/omnifocus.rb', line 123

def omnifocus
  @omnifocus ||= Appscript.app('OmniFocus').default_document
end

#prepopulate_existing_tasks ⇒ Object

Walk all omnifocus tasks under the nerd folder and add them to the bug_db hash if they match a bts_id.



173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
 
# File 'lib/omnifocus.rb', line 173

def prepopulate_existing_tasks
  prefixen = self.class._plugins.map { |klass| klass::PREFIX rescue nil }
  of_tasks = nil

  prefix_re = /^(#{Regexp.union prefixen}(?:-[\p{L}\d_\s.-]+)?\#\d+)/

  if prefixen.all? then
    of_tasks = all_tasks.find_all { |task|
      task.name.get =~ prefix_re
    }
  else
    warn "WA"+"RN: Older plugins installed. Falling back to The Old Ways"

    of_tasks = all_tasks.find_all { |task|
      task.name.get =~ /^([A-Z]+(?:-[\w-]+)?\#\d+)/
    }
  end

  of_tasks.each do |of_task|
    ticket_id                  = of_task.name.get[prefix_re, 1]
    project                    = of_task.containing_project.name.get

    if existing.key? ticket_id
      warn "Duplicate task! #{ticket_id}"
      warn "  deleting: #{of_task.id_.get}"
      omnifocus.flattened_projects.tasks.delete of_task
    end

    existing[ticket_id]        = project
    bug_db[project][ticket_id] = false
  end
end

#print_aggregate_report(collection, long = false) ⇒ Object 



884
885
886
887
888
889
890
891
892
 
# File 'lib/omnifocus.rb', line 884

def print_aggregate_report collection, long = false
  h, p = self.aggregate collection

  self.print_occurrence_table h, p

  puts

  self.print_details h, long
end

#print_details(h, long = false) ⇒ Object 



961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
 
# File 'lib/omnifocus.rb', line 961

def print_details h, long = false
  h.sort.each do |date, plan|
    puts date
    plan.sort.each do |period, things|
      next if things.empty?
      if long then
        things.sort.each do |thing|
          puts "  #{period}: #{thing}"
        end
      else
        puts "  #{period}: #{things.sort.join ', '}"
      end
    end
  end
end

#print_occurrence_table(h, p) ⇒ Object 



932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
 
# File 'lib/omnifocus.rb', line 932

def print_occurrence_table h, p
  p = p.sort_by { |priority, _|
    case priority
    when /(\d+)(.)/ then
      n, u = $1.to_i, $2
      n *= {"d" => 1, "w" => 7, "m" => 28, "y" => 365}[u]
    when "NR" then
      1/0.0
    else
      warn "unparsed: #{priority.inspect}"
      0
    end
  }

  units = p.map(&:first)

  total = 0
  hdr = "%14s%s %3s " + "%2s " * units.size
  fmt = "%14s: %3d " + "%2s " * units.size
  puts hdr % ["date", "\\", "tot", *units]
  h.sort.each do |date, plan|
    counts = units.map { |n| plan[n].size  }
    subtot = counts.inject(&:+)
    total += subtot
    puts fmt % [date, subtot, *counts]
  end
  puts hdr % ["total", ":", total, *p.map(&:last)]
end

#project(name) ⇒ Object 



1024
1025
1026
1027
 
# File 'lib/omnifocus.rb', line 1024

def project name
  project = self.omnifocus.flattened_projects[name].get
  Project.new omnifocus, project if project
end

#regular_tasks ⇒ Object 



1035
1036
1037
 
# File 'lib/omnifocus.rb', line 1035

def regular_tasks
  (its.value.class_.eq(:item).not).and(its.value.class_.eq(:folder).not)
end

#selected_tasks ⇒ Object 



1043
1044
1045
1046
1047
 
# File 'lib/omnifocus.rb', line 1043

def selected_tasks
  window.content.selected_trees[regular_tasks].value.get.map { |t|
    Task.new self, t
  }
end

#top(hash, n = 10) ⇒ Object 



335
336
337
338
339
 
# File 'lib/omnifocus.rb', line 335

def top hash, n=10
  hash.sort_by { |k,v| [-v, k] }.first(n).map { |k,v|
    "%4d %s" % [v,k[0,21]]
  }
end

#update_tasks ⇒ Object

Synchronize the contents of bug_db with omnifocus, creating missing tasks and marking tasks completed as needed. See the doco for bug_db for more info on how you should populate it.



231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
 
# File 'lib/omnifocus.rb', line 231

def update_tasks
  bug_db.each do |name, tickets|
    project = nerd_projects.projects[name]

    tickets.each do |bts_id, value|
      case value
      when true
        project.tasks[its.name.contains(bts_id)].get.each do |task|
          if task.completed.get
            puts "Re-opening #{name} # #{bts_id}"
            next if debug

            begin
              task.completed.set false
            rescue
              task.mark_incomplete
            end
          end
        end
      when false
        project.tasks[its.name.contains(bts_id)].get.each do |task|
          next if task.completed.get
          puts "Removing #{name} # #{bts_id}"
          next if debug

          begin
            task.completed.set true
          rescue
            task.mark_complete
          end
        end
      when Array
        puts "Adding #{name} # #{bts_id}"
        next if debug
        title, url = *value
        make project, :task, title, :note => url
      when Hash
        puts "Adding Detail #{name} # #{bts_id}"
        next if debug
        properties = value.clone
        title = properties.delete(:title)
        make project, :task, title, properties
      else
        abort "ERROR: Unknown value in bug_db #{bts_id}: #{value.inspect}"
      end
    end
  end
end

#weekly(n = 1) ⇒ Object 



370
371
372
373
374
375
376
 
# File 'lib/omnifocus.rb', line 370

def weekly n=1
  {
    :unit => :week,
    :steps => n,
    :fixed_ => true,
  }
end

#window ⇒ Object 



1039
1040
1041
 
# File 'lib/omnifocus.rb', line 1039

def window
  self.omnifocus.document_windows[1]
end