tmail_metas 0.1

data/README.rdoc

@@ -0,0 +1,35 @@
+=TMail Meta Data Functionality
+
+Allows you to include extra data within the body of e-mail messages for use in automated parsing through TMail.
+
+=Settings
+
+If you need to override the default scanner you can run this:
+
+  TMail::Metas.scanner = /Metas\((.*)\)/
+  TMail::Metas.scanner_options = {:seperator => ':', :group_seperator => ','}
+  
+  # which will look for this:
+  # Metas(project_id:12,type:message)
+
+=Example
+
+  %w{pp rubygems tmail tmail_metas}.each { |lib| require lib }
+
+  EMAIL = <<-end
+  To: you@example.com
+  From: me@example.com
+  Subject: This is my automated email
+
+  This is an email which will be automatically handled by a ruby script!
+  The body will be stripped of these meta tags while they are made available
+  in the mail.metas hash.
+
+  {{project_id=12345&category=Incoming Emails&create=message}}
+
+  end
+
+  mail = TMail::Mail.parse(EMAIL)
+
+  pp mail.metas # => {"category"=>"Incoming Emails", "project_id"=>"12345", "create"=>"message"}
+  pp mail.body  # => (body with the {{...}} metas stripped)

data/lib/tmail_metas.rb

@@ -0,0 +1,22 @@
+module TMail
+  module Metas
+    # Looks for {{key=value[&something=value]}} pairs within the mail's body by default
+    @@meta_tag_scanner = /\s*\{\{\s*(.*)\s*\}\}\s*/m
+    # group_seperator:: what break each key,value pair
+    # seperator:: what breaks keys and values apart
+    @@meta_scanner_options = {
+      :group_seperator => '&', 
+      :seperator => '='
+      }
+    def self.scanner=(scanner); @@meta_tag_scanner = scanner end
+    def self.scanner_options=(options); @@meta_scanner_options = options end
+    def metas
+      @metas ||= Hash[*$1.split(@@meta_scanner_options[:group_seperator]).map do |group| 
+        group.split(@@meta_scanner_options[:seperator]).map(&:strip)
+      end.flatten] if body =~ @@meta_tag_scanner
+      self.body = body.gsub(@@meta_tag_scanner, '')
+      @metas
+    end
+  end
+end
+TMail::Mail.send(:include, TMail::Metas)

metadata

@@ -0,0 +1,56 @@
+--- !ruby/object:Gem::Specification 
+name: tmail_metas
+version: !ruby/object:Gem::Version 
+  version: "0.1"
+platform: ruby
+authors: 
+- Rob Hurring
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-10-15 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: 
+email: rob@zerobased.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.rdoc
+- lib/tmail_metas.rb
+has_rdoc: true
+homepage: http://github.com/robhurring/tmail-metas
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Enables extra meta data options for TMail::Mail objects
+test_files: []
+