twmail 0.0.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c9c8cc0d210afa5b81ffa554fbc6a388eba8091e
+  data.tar.gz: fa0467db33a102d55a4edd2f3b01870b9f91e20f
+SHA512:
+  metadata.gz: d88406f8e40b40ff64dc0e23de7ef0bcff22567036dc259907e723c502c0f90b302d1fc0780b1693963b2405bc3ffbb3d9b41d59d6b07849472ed07838c6b065
+  data.tar.gz: 01652de31f8ec363506076e6796bd1aaad78714bf45d92bb3747bf97f2810e738b583d4ba4b3288767a77d0819d5c446573da8df62bf2f521e1ac938f2fbe7a8

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,7 @@
+source 'https://rubygems.org'
+
+# use local twtest while developing
+# gem "twtest", :path => "../twtest"
+
+# Specify your gem's dependencies in twmail.gemspec
+gemspec

data/Guardfile

@@ -0,0 +1,11 @@
+guard 'bundler' do
+  watch('Gemfile')
+  watch(/^.+\.gemspec/)
+end
+
+guard :test, :test_paths => ['test/unit'] do
+  watch(%r{^lib/(.+)\.rb$}){|m| "test/#{m[1]}_test.rb"}
+  watch(%r{^test/unit/test_(.+)\.rb$})
+  watch('test/test_helper.rb'){"test"}
+  watch('test/helpers/**/*'){"test"}
+end

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Nicholas E. Rabenau
+
+MIT License
+
+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.md

@@ -0,0 +1,117 @@
+# twmail
+
+`twmail` allows you to mail new tasks to your TaskWarrior inbox.
+
+## Installation
+
+    $ gem install twmail
+
+## Usage
+
+1. Install ruby and this gem
+1. If you don't have a `~/.fetchmailrc` yet, copy `doc/fetchmailrc.sample` to `~/.fetchmailrc`
+1. Edit `~/.fetchmailrc` and adjust mail account settings (the example was made for Google Mail account). If in doubt, consult the `fetchmail` documentation, e.g. by executing `man fetchmailconf` in a terminal.
+
+## Motivation
+I would like to add new tasks to my TaskWarrior inbox from remote places where I don't have immediate access to my personal TaskWarrior database; e.g. from my iPhone, from work (where I don't have access to my personal TaskWarrior installation) or from another computer.
+
+Using eMail for this looks like a great candidate:
+
+1. I don't want to (or cannot) install TaskWarrior on all the places and machines where I would like to add tasks from. Sending a note as eMail is pretty much universally available.
+1. Many applications were not made for integration with TaskWarrior. But even the dumbest iPhone app can forward text or a URL via eMail.
+1. eMail is asynchronous by design (fire and forget). Even if disconnected from the net, I can send eMail and the system will deliver it on the very next occassion.
+
+What is missing from a TaskWarrior perspective right now is a way to add these mails to a TaskWarrior installation automatically.
+
+## Architecture
+The simplest solution I could come up with is this:
+
+1. A dedicated email account is used to collect the tasks.
+1. A script that imports all eMails as new tasks.
+
+As a prerequisite, TaskWarrior is assumed to be installed and configured. With this architecture in place, the functionality is rather simple to implement:
+
+    For each mail{
+      Transaction{
+        * Fetch mail from mailbox
+        * Store mail as new task in Taskwarrior
+        * Delete mail from mailbox
+      }
+    }
+
+  As the word `Transaction` implies, the whole operation needs to be atomic per mail. No task must be added if fetching a mail went wrong, and no mail must be deleted if storing the task in TaskWarrior failed.
+
+The solution presented here maintains a one-to-one relation between the INBOX of an mail account and the TaskWarrior database.
+
+TODO Describe how to use fetchmail's daemon mode
+
+TODO Describe how to use fetchmail's IMAP IDLE flag
+
+## Components
+Mail fetching is done with `fetchmail`, a proven solution available on all major Unices incl. MacOS. It will be configured to use the `twmail` script as a mail delivery agent (mda), which means nothing more than that `fetchmail` fetches the mail from the configured account and hands it over to our script. There is no further storage of the received mails except in TaskWarrior.
+
+## Error Handling
+If our MDA returns non-zero, `fetchmail` will not assume the message to be processed and it will try again.
+
+TODO Do we need a dedicated dead-letter queue for all mails fetched, but not successfully processed?
+
+## Alternatives
+One might think of more elaborate applications that do more clever things, but I wanted to create this solution with as few external dependencies as possible. `fetchmail` is available on all Unices, and who can afford to live without TaskWarrior anyway? I also played with the thought of a central tasks server that receives mail from services like CloudMailIn and auto-adds them to the server, but the result would not be much different (besides being more complex) to the solution presented here: No task will be fetched into TaskWarrior until the machine with the TaskWarrior database is online.
+
+Another alternative would be to convert the email to JSON and use TaskWarrior's import command. This would allow to create and annotate a new task in one step without the `bin/task-uuid` workaround.
+
+## Advanced Usage
+### Filtering and Routing
+Many more advanced use cases like filtering and routing can be implemented on the mail server side. There are plenty of user interfaces for routing eMails based on their subject, sender, body text, etc. The simplest way to integrate these features with `twmail` is to use IMAP folders. After all filtering and routing, each eMail must end up in a dedicated IMAP folder (by default, all tasks are fetched from the INBOX folder). `twmail` can then be configured to do different things depending on which IMAP folder a mail came from.
+
+As an example, here is a simple way to route eMails to different projects in TaskWarrior, based on their subject line:
+
+1. Set up a dedicated IMAP folder for every project you work on, e.g. "Build Bikeshed", "Reading List", "Get Rich Fast"
+1. Configure the mail server to move every mail from INBOX to the
+  1. "Build Bikeshed" folder if the mail subject contains "project:Bikeshed"
+  1. "Reading List" folder if the mail subject contains "project:Reading"
+  1. "Get Rich Fast" folder if the mail subject contains "project:GetRichFast"
+1. Tell `twmail` to fetch mails from the "Build Bikeshed", "Reading List", and "Get Rich Fast" IMAP folders (in addition to the INBOX):
+
+TODO Continue description ... may need tracepolls for it.
+
+The approach chosen for `twmail` also addresses SPAM filtering. Handling that remains the responsibility of the mail server. Anything that makes it to the INBOX is treated as task.
+
+### Hooks
+`twmail` comes with an advanced implementation that supports hooks. This makes handling incoming mail very simple for someone familiar with shell scripting, and there is no need to edit the `twmail` scripts in order to customize its behavior.
+
+When `fetchmail` is configured to use `twmail_hooks` instead of `twmail`, the script will call the `twmail_hook` command (must be in the user's `$PATH`). Within the hook script, the fields of the parsed email are available as environment variables:
+
+    TWMAIL_DATE
+    TWMAIL_MESSAGE_ID
+    TWMAIL_FROM
+    TWMAIL_TO
+    TWMAIL_SUBJECT
+    TWMAIL_BODY
+
+Have a look at test/helpers/test_hook for a very simple implementation.
+
+If you prefer a hook with a different name, specify it in the `TWMAIL_HOOK` environment variable in your `.fetchmailrc`. For example, if your home directory contains a script called `taskwarrior-import.sh`, edit the `mda` line to look like this:
+
+    mda TWMAIL_HOOK=~/taskwarrior-import.sh twmail_hooks
+
+## Housekeeping
+By default `fetchmail` will mark retrieved messages as read, but leave them on the server. For housekeeping purposes, it may be desirable to delete messages from the server once they were successfully imported into TaskWarrior.
+
+There are two ways to achieve this:
+
+1. Create a filter on the server side that deletes all read mail to a dedicated folder (perhaps "Archive" or "Trash"), or simply deletes it.
+1. Run `fetchmail` with the `--nokeep` option, which will delete retrieved messages from the server.
+
+Which option to choose depends on the capabilities of your mail server (Google Mail cannot handle mails based on their read status), and on your level of trust in `twmail`. I recommend leaving mails on the server until you are confident that everything works as expected.
+
+## Testing
+`twmail` comes with a basic set of tests. Execute them by running `rake` in the cloned source repo.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,10 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test' << 'test/helpers'
+  test.test_files = FileList['test/**/test_*.rb']
+end
+
+task :default => :test

data/bin/task-uuid

@@ -0,0 +1,22 @@
+#!/usr/bin/env ruby
+require 'securerandom'
+
+#
+# Creates a new task using TaskWarrior and prints its UUID to STDOUT.
+#
+
+# 1. Make a temporary tag that unlikely to exist yet.
+# To avoid shell troubles, we have it start with a character.
+tag = "T#{SecureRandom.hex}"
+
+# 2. Create the new task tagged with our temporary tag
+%x|task rc.verbose=nothing add +#{tag} #{ARGV.join(' ')}|
+
+# 3. Remember the UUID generated by TaskWarrior
+task_uuid = %x|task "+#{tag}" uuid|
+
+# 4. Remove the temporary tag from the new task
+%x|task rc.verbose=nothing '#{task_uuid}' modify -#{tag}|
+
+# 5. Print the UUID to STDOUT
+puts task_uuid

data/bin/twmail

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+
+# This script is a dead-simple Mail Delivery Agent (MDA) that parses the received email
+# and creates a new TaskWarrior task from the subject of the mail.
+mail = Mail.new(ARGF.read)
+task_uuid = %x[task-uuid \"#{mail.subject}\"]
+
+body = mail.text? ? mail.body.decoded : mail.text_part.body.decoded
+
+SEPARATOR = '-- '
+body = body.split(SEPARATOR)[0] if (body.include?(SEPARATOR))
+
+%x[task '#{task_uuid}' annotate \"#{body}\"]

data/bin/twmail_hooks

@@ -0,0 +1,21 @@
+#!/usr/bin/env ruby
+
+# This script is a dead-simple Mail Delivery Agent (MDA) that exports the parts of the received email as
+# environment variables and calls a shell script that can make use of these variables to further process
+# the mail.
+mail = Mail.new(ARGF.read)
+
+# Expose mail properties as environment variables
+%w[date message_id from to subject body].each{|field|
+  value = mail.send(field.to_sym)
+  value = value.join(',') if value.respond_to?(:join)
+  ENV["TWMAIL_#{field.upcase}"] = Shellwords.escape(value.to_s)
+}
+
+# The hook to be executed is read from the environment variable TWMAIL_HOOK
+# If none is set, this script will assume that twmail_on_new_mail is in the
+# $PATH and executable.
+cmd = ENV["TWMAIL_HOOK"] || 'twmail_hook'
+
+# Call hook script
+%x[#{cmd}]

data/lib/twmail.rb

@@ -0,0 +1,7 @@
+require 'mail'
+
+require "twmail/version"
+
+module TaskWarriorMail
+  # Your code goes here...
+end

data/lib/twmail/version.rb

@@ -0,0 +1,3 @@
+module TaskWarriorMail
+  VERSION = "0.0.3"
+end

data/test/fixtures/mail_multipart.txt

@@ -0,0 +1,39 @@
+Delivered-To: tasks@example.com
+Received: by 10.114.10.161 with SMTP id j1csp21288ldb;
+        Mon, 18 Jun 2012 13:14:55 -0700 (PDT)
+Received: by 10.14.127.78 with SMTP id c54mr3708525eei.8.1340050495549;
+        Mon, 18 Jun 2012 13:14:55 -0700 (PDT)
+Return-Path: <me@example.com>
+Received: from mail-ey0-f169.google.com (mail-ey0-f169.google.com [209.85.215.169])
+        by mx.google.com with ESMTPS id x56si9033076eea.113.2012.06.18.13.14.55
+        (version=TLSv1/SSLv3 cipher=OTHER);
+        Mon, 18 Jun 2012 13:14:55 -0700 (PDT)
+Received-SPF: neutral (google.com: 209.85.215.169 is neither permitted nor denied by best guess record for domain of me@example.com) client-ip=209.85.215.169;
+Authentication-Results: mx.google.com; spf=neutral (google.com: 209.85.215.169 is neither permitted nor denied by best guess record for domain of me@example.com) smtp.mail=me@example.com
+Received: by mail-ey0-f169.google.com with SMTP id n1so2188326eaa.14
+        for <tasks@example.com>; Mon, 18 Jun 2012 13:14:55 -0700 (PDT)
+MIME-Version: 1.0
+Received: by 10.14.101.144 with SMTP id b16mr3667426eeg.225.1340050495077;
+ Mon, 18 Jun 2012 13:14:55 -0700 (PDT)
+Received: by 10.14.188.4 with HTTP; Mon, 18 Jun 2012 13:14:54 -0700 (PDT)
+In-Reply-To: <-4460535785096073142@unknownmsgid>
+References: <-4460535785096073142@unknownmsgid>
+Date: Mon, 18 Jun 2012 22:14:54 +0200
+Message-ID: <CAB-EwyF1hqX-mxUbWJhnoSUJEujDcrKxMLniu1A3bcwXcOu+FQ@mail.gmail.com>
+Subject: MenTaLguY: Atomic Operations in Ruby
+From: "Manager, Task" <me@example.com>
+To: tasks@example.com
+Content-Type: multipart/alternative; boundary=bcaec52159cbbd7c5604c2c4d12e
+
+--bcaec52159cbbd7c5604c2c4d12e
+Content-Type: text/plain; charset=ISO-8859-1
+
+http://moonbase.rydia.net/mental/blog/programming/atomic-operations-in-ruby.html
+
+--bcaec52159cbbd7c5604c2c4d12e
+Content-Type: text/html; charset=ISO-8859-1
+
+<div class="gmail_quote"><a href="http://moonbase.rydia.net/mental/blog/programming/atomic-operations-in-ruby.html" target="_blank">http://moonbase.rydia.net/mental/blog/programming/atomic-operations-in-ruby.html</a><br><br>
+</div>
+
+--bcaec52159cbbd7c5604c2c4d12e--

data/test/fixtures/mail_regular.txt

@@ -0,0 +1,26 @@
+Date: Sat, 09 Jun 2012 21:09:29 +0200
+From: king.crown@nigerian-lottery.com
+To: you@example.com
+Message-ID: <4fd39f695c947_827580443948558fd@example.com>
+Subject: Send some test mails
+Mime-Version: 1.0
+Content-Type: text/plain;
+ charset=UTF-8
+Content-Transfer-Encoding: 7bit
+
+Hi there,
+I am writing to you in order to inform you that you have
+won the Nigerian Lottery.
+
+In order to claim your win, please transfer the handling
+fee to the following account:
+
+AMOUNT: EUR 1234,56
+IBAN: AT571234500234573201
+BIC: ATBAATWWXXX
+
+Sincerely
+
+Toast Bread
+King Crown
+Head of The Nigerian Lottery

data/test/fixtures/mail_separator.txt

@@ -0,0 +1,46 @@
+Delivered-To: task@example.com
+Received: by 10.152.29.4 with SMTP id f4csp2763lah;
+        Sat, 13 Jul 2013 13:33:13 -0700 (PDT)
+X-Received: by 10.14.177.196 with SMTP id d44mr52014105eem.35.1373747593216;
+        Sat, 13 Jul 2013 13:33:13 -0700 (PDT)
+Return-Path: <john.doe@example.com>
+Received: from mail-ee0-f45.google.com (mail-ee0-f45.google.com [74.125.83.45])
+        by mx.google.com with ESMTPS id 47si37216650eeu.98.2013.07.13.13.33.12
+        for <task@example.com>
+        (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128);
+        Sat, 13 Jul 2013 13:33:13 -0700 (PDT)
+Received-SPF: neutral (google.com: 74.125.83.45 is neither permitted nor denied by best guess record for domain of john.doe@example.com) client-ip=74.125.83.45;
+Authentication-Results: mx.google.com;
+       spf=neutral (google.com: 74.125.83.45 is neither permitted nor denied by best guess record for domain of john.doe@example.com) smtp.mail=john.doe@example.com
+Received: by mail-ee0-f45.google.com with SMTP id c1so6851062eek.32
+        for <task@example.com>; Sat, 13 Jul 2013 13:33:12 -0700 (PDT)
+MIME-Version: 1.0
+X-Received: by 10.14.183.135 with SMTP id q7mr51321537eem.97.1373747592866;
+ Sat, 13 Jul 2013 13:33:12 -0700 (PDT)
+Received: by 10.14.136.203 with HTTP; Sat, 13 Jul 2013 13:33:12 -0700 (PDT)
+Date: Sat, 13 Jul 2013 22:33:12 +0200
+Message-ID: <CAM4tTWv5Jd--NTSTGRvLeO+0vGHjPdm0W7Z36PuN1KPvL4+q=A@mail.gmail.com>
+Subject: Try IFTTT / PinReadable +kindle
+From: "Doe, John" <john.doe@example.com>
+To: "task@example.com" <task@example.com>
+Content-Type: multipart/alternative; boundary=047d7b34385e48d21704e16a89ba
+
+--047d7b34385e48d21704e16a89ba
+Content-Type: text/plain; charset=UTF-8
+Content-Transfer-Encoding: quoted-printable
+
+https://ifttt.com/recipes/20357
+
+--=20
+Mit freundlichen Gr=C3=BCssen
+
+John Doe
+
+--047d7b34385e48d21704e16a89ba
+Content-Type: text/html; charset=UTF-8
+Content-Transfer-Encoding: quoted-printable
+
+<a href=3D"https://ifttt.com/recipes/20357">https://ifttt.com/recipes/20357=
+</a><br><br>-- <br>Mit freundlichen Gr=C3=BCssen<p>John Doe<br></p>
+
+--047d7b34385e48d21704e16a89ba--

data/test/fixtures/mail_with_signature.txt

@@ -0,0 +1,29 @@
+Date: Sat, 09 Jun 2012 21:09:29 +0200
+From: king.crown@nigerian-lottery.com
+To: you@example.com
+Message-ID: <4fd39f695c947_827580443948558fd@example.com>
+Subject: Send some test mails
+Mime-Version: 1.0
+Content-Type: text/plain;
+ charset=UTF-8
+Content-Transfer-Encoding: 7bit
+
+Hi there,
+I am writing to you in order to inform you that you have
+won the Nigerian Lottery.
+
+In order to claim your win, please transfer the handling
+fee to the following account:
+
+AMOUNT: EUR 1234,56
+IBAN: AT571234500234573201
+BIC: ATBAATWWXXX
+
+Sincerely
+
+Toast Bread
+King Crown
+Head of The Nigerian Lottery
+
+-- 
+Foo

data/test/fixtures/task01.json

@@ -0,0 +1 @@
+{"id":1,"description":"Import standard JSON with annotation","entry":"20120610T090557Z","status":"pending","uuid":"4c0be862-1f5f-4fc5-bd25-8a704c1207d2","annotations":[{"entry":"20120610T090617Z","description":"And here is somemulti-line annotation"}]}

data/test/fixtures/task02.json

@@ -0,0 +1 @@
+{"description":"Import minimal JSON","annotations":[{"entry":"20120610T090617Z","description":"And here is some annotation"}]}

data/test/helpers/assertions

@@ -0,0 +1,4 @@
+function assert_equal()
+{
+  diff <(echo "$2" ) <(echo "$1") || [ "$?" -eq 0 ] || exit 1
+}

data/test/helpers/test_hook

@@ -0,0 +1,16 @@
+#!/bin/bash
+#
+# twmail hook script that is called for every mail.
+#
+# The environment variables available to a hook are:
+#
+# TWMAIL_DATE
+# TWMAIL_MESSAGE_ID
+# TWMAIL_FROM
+# TWMAIL_TO
+# TWMAIL_SUBJECT
+# TWMAIL_BODY
+#
+# This script assumes that task-uuid is in the path.
+#
+task $(task-uuid $TWMAIL_SUBJECT) annotate $TWMAIL_BODY > /dev/null

data/test/test_helper.rb

@@ -0,0 +1,8 @@
+require 'bundler'
+#Bundler.require
+
+require 'twtest'
+require 'test/unit'
+
+module TaskWarriorMailTest
+end

data/test/unit/test_mail.rb

@@ -0,0 +1,15 @@
+require 'test_helper'
+require 'mail'
+
+class TestMail < Test::Unit::TestCase
+  def test_signature
+    m = Mail.new(File.read(fixture('mail_with_signature.txt')))
+    assert(m)
+    assert(m.body.include?('-- '))
+    assert_false(m.body.decoded.split('-- ').include?('-- '))
+  end
+
+  def fixture(name)
+    File.join(File.dirname(__FILE__), '..', 'fixtures', name)
+  end
+end

data/test/unit/test_task_uuid.rb

@@ -0,0 +1,120 @@
+require 'open3'
+require 'test/unit'
+
+class Command
+  def exec(cmd = '', args = {})
+    env.each{|k,v| ENV[k.to_s] = v.to_s}
+    line = build_line(cmd, args)
+    Open3.capture3(line)
+  end
+
+  def env
+    {}
+  end
+
+  def default_args
+    {}
+  end
+
+  def executable
+    raise 'Subclasses must override this method'
+  end
+
+  private
+
+  def build_line(cmd = '', args = {})
+    [].tap{|line|
+      line << executable
+      line << default_args.merge(args).map{|k,v| "#{Shellwords.escape(k.strip)}=#{Shellwords.escape(v.strip)}"}.join(' ')
+      line << cmd.strip
+      line.reject!{|part| part.empty?}
+    }.join(' ')
+  end
+
+  def overrides(env)
+    intersection = env.keys.to_set & ENV.keys.to_set
+    ENV.select{|k,v| intersection.include?(k)}
+  end
+end
+
+class TaskWarriorCommand < Command
+  attr_accessor :data_dir
+
+  def version
+    exec('_version')
+  end
+
+  def count
+    exec('count')
+  end
+
+  def env
+    raise "data_dir must not be empty for '#{executable}'" if @data_dir.nil? || data_dir.empty?
+    {TASKDATA: @data_dir}
+  end
+
+  def default_args
+    {'rc.verbose' => 'off', 'rc.json.array' => 'on'}
+  end
+
+  def executable
+    'task'
+  end
+end
+
+class TaskUUID < TaskWarriorCommand
+  def create(description)
+    exec(description)
+  end
+
+  def executable
+    # The gem version that uses the binstub fails if the script is not Ruby
+    #'task-uuid'
+
+    # The local version, called directly, works fine even if it's a Bash script
+    File.join(File.dirname(__FILE__), '..', '..', 'bin', 'task-uuid')
+  end
+
+  def default_args
+    {}
+  end
+end
+
+class TestTaskUUID < Test::Unit::TestCase#Minitest::Test
+  def setup
+    @tw = TaskWarriorCommand.new
+    @tw.data_dir = Dir.mktmpdir(name)
+
+    raise "TASKRC must not be set, but it is #{ENV['TASKRC']}" if ENV['TASKRC']
+
+  end
+
+  def teardown
+    FileUtils.rm_rf(@tw.data_dir)
+  end
+
+  def test_version
+    out, err, status = @tw.version
+    assert(status.success?)
+    assert_empty(err)
+    assert_not_empty(out)
+    assert_equal('2.3.0', out.chomp)
+  end
+
+  def test_empty
+    out, err, status = @tw.count
+    assert(status.success?)
+    assert_empty(err)
+    assert_not_empty(out)
+    assert_equal('0', out.chomp)
+  end
+
+  def test_task_uuid
+    task_uuid = TaskUUID.new
+    task_uuid.data_dir = Dir.mktmpdir(name)
+    out, err, status = task_uuid.create('foo bar')
+    assert_empty(err)
+    assert_not_empty(out)
+    assert_match(/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}/, out.chomp)
+  end
+end

data/test/unit/test_twmail.rb

@@ -0,0 +1,78 @@
+require 'test_helper'
+
+class TestHelpers < TaskWarrior::Test::Integration::TestCase
+  def teardown
+    ENV['TASKRC'] = nil
+    super
+  end
+
+  def test_regular
+    result = deliver_fixture(0, fixture('mail_regular.txt'))
+    assert_empty(result)
+    assert_equal(1, task('count').to_i)
+
+    tasks = export_tasks
+    assert_equal(1, tasks.size)
+    assert_equal('Send some test mails', tasks.first['description'])
+
+    assert_equal(1, tasks.first['annotations'].size)
+    assert(tasks.first['annotations'].first.to_s =~ /Nigeria/)
+  end
+
+  def test_regular_with_signature
+    result = deliver_fixture(0, fixture('mail_with_signature.txt'))
+    assert_empty(result)
+    assert_equal(1, task('count').to_i)
+
+    tasks = export_tasks
+    assert_equal(1, tasks.size)
+    assert_equal('Send some test mails', tasks.first['description'])
+
+    assert_equal(1, tasks.first['annotations'].size)
+    assert(tasks.first['annotations'].first.to_s =~ /Nigeria/)
+  end
+
+  def test_multipart
+    result = deliver_fixture(0, fixture('mail_multipart.txt'))
+    assert_empty(result)
+    assert_equal(1, task('count').to_i)
+
+    tasks = export_tasks
+    assert_equal(1, tasks.size)
+    assert_equal('MenTaLguY: Atomic Operations in Ruby', tasks.first['description'])
+
+    assert_equal(1, tasks.first['annotations'].size)
+    assert(tasks.first['annotations'].first.to_s =~ /atomic/)
+  end
+
+  def test_separator
+    result = deliver_fixture(0, fixture('mail_separator.txt'))
+    assert_empty(result)
+    assert_equal(1, task('count').to_i)
+
+    tasks = export_tasks
+    assert_equal(1, tasks.size)
+    task = tasks.first
+    assert_equal('Try IFTTT / PinReadable', task['description'])
+    assert_true(task['tags'].include?('kindle'))
+  end
+
+  def test_missing_fixture
+    result = deliver_fixture(1, 'missing fixture')
+    assert_empty(result)
+  end
+
+  protected
+
+  def deliver_fixture(status, fixture)
+    twmail = File.join(File.dirname(__FILE__), '..', '..', 'bin', 'twmail')
+    ENV['TASKRC'] = @taskrc_file
+    output = %x[cat #{fixture} | #{twmail}]
+    assert_equal(status, $?.exitstatus)
+    output
+  end
+
+  def fixture(name)
+    File.join(File.dirname(__FILE__), '..', 'fixtures', name)
+  end
+end

data/test/unit/test_twmail_hooks

@@ -0,0 +1,35 @@
+#!/bin/bash
+
+#
+# Unit test for twmail_hooks
+#
+
+# Data locations
+DIRNAME=$(cd $(dirname $0);pwd)
+DATA_DIR=$(mktemp -dt $(basename $0))
+export TASKRC=$(mktemp -t taskrc)
+
+source $DIRNAME/../helpers/assertions
+
+# Create custom taskrc
+cat > $TASKRC <<HERE
+data.location=$DATA_DIR
+json.array=on
+verbose=off
+HERE
+
+# Canonical path to test_hook
+export TWMAIL_HOOK=$DIRNAME/../helpers/test_hook
+
+# Create new task using mail fixture
+cat $DIRNAME/../fixtures/mail01.txt | $DIRNAME/../../bin/twmail_hooks
+
+# Read back and run assertions
+SUBJECT=$(task export | ruby -r json -e "puts JSON[ARGF.read].first['description']")
+
+assert_equal "Send some test mails" "$SUBJECT"
+
+# Clean up
+rm -Rf $DATA_DIR
+rm -Rf $TASKRC
+export TASKRC=

data/twmail.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/twmail/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Nicholas E. Rabenau"]
+  gem.email         = ["nerab@gmx.net"]
+  gem.description   = %q{Mail new tasks to your TaskWarrior inbox}
+  gem.summary       = %q{Use fetchmail and the scripts in this project to mail tasks to your local TaskWarrior installation}
+  gem.homepage      = 'https://github.com/nerab/TaskWarriorMail'
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "twmail"
+  gem.require_paths = ["lib"]
+  gem.version       = TaskWarriorMail::VERSION
+
+  gem.add_dependency 'twtest'
+  gem.add_dependency 'mail'
+  gem.add_dependency 'multi_json'
+
+  gem.add_development_dependency 'guard-test'
+  gem.add_development_dependency 'guard-bundler'
+  gem.add_development_dependency 'pry'
+end

metadata

@@ -0,0 +1,171 @@
+--- !ruby/object:Gem::Specification
+name: twmail
+version: !ruby/object:Gem::Version
+  version: 0.0.3
+platform: ruby
+authors:
+- Nicholas E. Rabenau
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-11-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: twtest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mail
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard-test
+  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'
+- !ruby/object:Gem::Dependency
+  name: guard-bundler
+  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'
+- !ruby/object:Gem::Dependency
+  name: pry
+  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: Mail new tasks to your TaskWarrior inbox
+email:
+- nerab@gmx.net
+executables:
+- task-uuid
+- twmail
+- twmail_hooks
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- Guardfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/task-uuid
+- bin/twmail
+- bin/twmail_hooks
+- lib/twmail.rb
+- lib/twmail/version.rb
+- test/fixtures/mail_empty.txt
+- test/fixtures/mail_multipart.txt
+- test/fixtures/mail_regular.txt
+- test/fixtures/mail_separator.txt
+- test/fixtures/mail_with_signature.txt
+- test/fixtures/task01.json
+- test/fixtures/task02.json
+- test/helpers/assertions
+- test/helpers/test_hook
+- test/test_helper.rb
+- test/unit/test_mail.rb
+- test/unit/test_task_uuid.rb
+- test/unit/test_twmail.rb
+- test/unit/test_twmail_hooks
+- twmail.gemspec
+homepage: https://github.com/nerab/TaskWarriorMail
+licenses: []
+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.0.14
+signing_key: 
+specification_version: 4
+summary: Use fetchmail and the scripts in this project to mail tasks to your local
+  TaskWarrior installation
+test_files:
+- test/fixtures/mail_empty.txt
+- test/fixtures/mail_multipart.txt
+- test/fixtures/mail_regular.txt
+- test/fixtures/mail_separator.txt
+- test/fixtures/mail_with_signature.txt
+- test/fixtures/task01.json
+- test/fixtures/task02.json
+- test/helpers/assertions
+- test/helpers/test_hook
+- test/test_helper.rb
+- test/unit/test_mail.rb
+- test/unit/test_task_uuid.rb
+- test/unit/test_twmail.rb
+- test/unit/test_twmail_hooks