titi 0.0.1

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 mrflip
+
+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.textile

@@ -0,0 +1,17 @@
+= titi
+
+Description goes here.
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2010 mrflip. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,73 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name        = "titi"
+    gem.summary     = %Q{Emit and consume Activity Streams from a wide variety of sources}
+    gem.description = %Q{Facade adapting apis to activity streams spec}
+    gem.email       = "flip@infochimps.org"
+    gem.homepage    = "http://github.com/mrflip/titi"
+    gem.authors     = ["mrflip"]
+    gem.add_dependency "restclient",     ">= 0.0.0"
+    gem.add_dependency "wukong",         ">= 0.0.0"
+    gem.add_dependency "active_support", ">= 0.0.0"
+    gem.add_development_dependency "rspec", ">= 1.2.9"
+    gem.add_development_dependency "yard", ">= 0"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+begin
+  require 'reek/adapters/rake_task'
+  Reek::RakeTask.new do |t|
+    t.fail_on_error = true
+    t.verbose = false
+    t.source_files = 'lib/**/*.rb'
+  end
+rescue LoadError
+  task :reek do
+    abort "Reek is not available. In order to run reek, you must: sudo gem install reek"
+  end
+end
+
+begin
+  require 'roodi'
+  require 'roodi_task'
+  RoodiTask.new do |t|
+    t.verbose = false
+  end
+rescue LoadError
+  task :roodi do
+    abort "Roodi is not available. In order to run roodi, you must: sudo gem install roodi"
+  end
+end
+
+task :default => :spec
+
+begin
+  require 'yard'
+  YARD::Rake::YardocTask.new
+rescue LoadError
+  task :yardoc do
+    abort "YARD is not available. In order to run yardoc, you must: sudo gem install yard"
+  end
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/lib/titi.rb

@@ -0,0 +1,6 @@
+module Titi
+  autoload :Matcher,   'titi/matcher'
+  autoload :ParseTree, 'titi/parse_tree'
+  autoload :Provider,  'titi/provider'
+  autoload :Adaptor,   'titi/adaptor'
+end

data/lib/titi/adaptor.rb

@@ -0,0 +1,59 @@
+module Titi
+  module Adaptor
+    # for each key in hsh, sets that attribute to the corresponding value.
+    #
+    # @example
+    #    foo
+    #    # => #<Struct Simian name="Mojo Jojo" status="villain" nemesis=nil species='Chimpanzee'>
+    #    foo.attributes = { :nemesis => 'Powerpuff girls', :species => 'Pan Troglodytes' }
+    #    foo
+    #    # => #<Struct Simian name="Mojo Jojo" status="villain" nemesis='Powerpuff Girls' species='Pan Troglodytes'>
+    def attributes= hsh
+      hsh.each do |attr, val|
+        setter = "#{attr}="
+        self.send(setter, val) if respond_to?(setter)
+      end
+    end
+
+    # Adopt attributes from given hash, and programatically-set attributes from block
+    #
+    # @example
+    # ActivityStreams::Entry.adapt(
+    #   :id        => status.id,
+    #   :title     => status.text,
+    #   :content   => status.text,
+    #   :verb      => :post
+    #   ) do |entry|
+    #   status_time     = Time.parse(status.created_at) rescue nil
+    #   entry.published = status_time
+    #   entry.author    = ActivityStreams::Author.new(:name => status.user.name, :url => status.user.url)
+    #   entry.object    = ActivityStreams::Object.adapt do |activity_obj|
+    #     activity_obj.id        = status.id
+    #     activity_obj.title     = status.text
+    #     activity_obj.published = status_time
+    #     activity_obj.updated   = status_time
+    #     activity_obj.author    = ActivityStreams::Author.new(:name => status.user.name, :url => status.user.url)
+    #   end
+    # end
+    def adapt hsh={}, &block
+      self.attributes = hsh
+      yield self if block
+    end
+
+    # The standard hack to construct class methods on a class that #include's this model
+    module ClassMethods
+      # created an object and then adopts from the given hash and block
+      def adapt hsh={}, &block
+        obj = self.new
+        obj.adapt(hsh, &block)
+        obj
+      end
+    end
+
+    def self.included base
+      base.class_eval do
+        extend Titi::Adaptor::ClassMethods
+      end
+    end
+  end
+end

data/lib/titi/matcher.rb

@@ -0,0 +1,157 @@
+module Titi
+  module Matcher
+    class Base
+      attr_accessor :selector
+      attr_accessor :matcher
+      def initialize selector, matcher=nil
+        self.selector = selector
+        self.matcher  = matcher
+      end
+      def match doc
+        raise "Abstract class #{self.class}"
+      end
+    end
+
+    class MatchFirstElement < Base
+      # return the inner_html of the given element
+      #
+      # eg.
+      #   m = MatchFirstElement.new('span#bio/a.homepage')
+      #   m.match('<span id="bio"><a class="homepage" href="http://foo.bar">My Homepage</a></span>')
+      #   # => 'My Homepage'
+      #
+      def match doc
+        el = doc.at(selector) or return nil
+        matcher ? matcher.match(el) : el.inner_html
+      end
+    end
+
+    class MatchArray < Base
+      # return the given element
+      #
+      # eg.
+      #   m = MatchAttribute.new('span#bio/a.homepage', 'href')
+      #   m.match('<span id="bio"><a class="homepage" href="http://foo.bar">My Homepage</a></span>')
+      #   # => 'http://foo.bar'
+      #
+      def match doc
+        subdoc = (doc/selector) or return nil
+        if matcher
+          subdoc.map{|el| matcher.match(el)}
+        else
+          subdoc.map{|el| el.inner_html}
+        end
+      end
+    end
+
+    class MatchAttribute < Base
+      attr_accessor :attribute
+      def initialize selector, attribute, matcher=nil
+        super selector, matcher
+        self.attribute = attribute.to_s
+      end
+      # return the given attribute on the first matching path
+      #
+      # eg.
+      #   m = MatchAttribute.new('span#bio/a.homepage', 'href')
+      #   m.match('<span id="bio"><a class="homepage" href="http://foo.bar">My Homepage</a></span>')
+      #   # => 'http://foo.bar'
+      #
+      def match doc
+        val = doc.path_attr(selector, attribute)
+        matcher ? matcher.match(val) : val
+      end
+    end
+
+    #
+    # map html elements -- or any HTMLParser tree -- to attributes in a hash.
+    #   HTMLParser.new([ {
+    #       :name     => 'li/span.fn',
+    #       :location => 'li/span.adr',
+    #       :url      => HTMLParser.attr('li/a.url[@href]', 'href'),
+    #       :bio      => 'li#bio/span.bio',
+    #     }
+    #   ])
+    #
+    class MatchHash
+      attr_accessor :match_hash
+      def initialize match_hash
+        # Kludge? maybe.
+        raise "MatchHash requires a hash of :attributes => matchers." unless match_hash.is_a?(Hash)
+        self.match_hash = match_hash
+      end
+      # Returns a hash mapping each attribute in match_hash
+      # to the result of its matcher on the current doc tree
+      def match doc
+        hsh = { }
+        match_hash.each do |attr, m|
+          val = m.match(doc)
+          case attr
+          when Array then hsh.merge!(Hash.zip(attr, val).reject{|k,v| v.nil? }) if val
+          else            hsh[attr] = val  end
+        end
+        self.class.scrub!(hsh)
+      end
+      # kill off keys with nil values
+      def self.scrub! hsh
+        hsh # .reject{|k,v| v.nil? }
+      end
+    end
+
+    class MatchProc < MatchFirstElement
+      attr_accessor :proc
+      attr_accessor :options
+      def initialize selector, proc, matcher=nil, options={}
+        super selector, matcher
+        self.options = options
+        self.proc = proc
+      end
+      def match doc
+        val = super doc
+        self.proc.call(val) if val
+      end
+    end
+
+    class MatchRegexp < Base
+      attr_accessor :re
+      attr_accessor :options
+      def initialize selector, re, matcher=nil, options={}
+        super selector, matcher
+        self.options = options
+        self.re = re
+      end
+      def match doc
+        # apply selector, if any
+        el = selector ? doc.contents_of(selector) : doc
+        m = re.match(el.to_s)
+        val = case
+        when m.nil? then nil
+        when self.options[:one] then m.captures.first
+        else m.captures
+        end
+        # pass to matcher, if any
+        matcher ? matcher.match(val) : val
+      end
+    end
+
+    class MatchRegexpRepeatedly < Base
+      attr_accessor :re
+      def initialize selector, re, matcher=nil
+        super selector, matcher
+        self.re = re
+      end
+      def match doc
+        # apply selector, if any
+        el = selector ? doc.contents_of(selector) : doc
+        return unless el
+        # get all matches
+        val = el.to_s.scan(re)
+        # if there's only one capture group, flatten the array
+        val = val.flatten if val.first && val.first.length == 1
+        # pass to matcher, if any
+        matcher ? matcher.match(val) : val
+      end
+    end
+
+  end
+end

data/lib/titi/parse_tree.rb

@@ -0,0 +1,34 @@
+module Titi
+  module ParseTree
+
+    #
+    # construct the downstream part of a hash matcher
+    #
+    def self.build_match_hash spec_hash
+      hsh = { }
+      spec_hash.each do |attr, spec|
+        hsh[attr] = build_parse_tree(spec)
+      end
+      hsh
+    end
+
+    #
+    # recursively build a tree of matchers
+    #
+    def self.build_parse_tree spec
+      case spec
+      when nil            then nil
+      when Matcher        then spec
+      when Hash           then MatchHash.new(build_match_hash(spec))
+      when Array          then
+        return nil if spec.empty?
+        raise "Array spec must be a single selector or a selector and another match specification" unless (spec.length <= 2)
+        MatchArray.new(spec[0].to_s, build_parse_tree(spec[1]))
+      when String         then MatchFirstElement.new(spec)
+      when Proc           then MatchProc.new(nil, spec)
+      when Regexp         then MatchRegexp.new(nil, spec, nil, :one => true)
+      else raise "Don't know how to parse #{spec.inspect}"
+      end
+    end
+  end
+end

data/lib/titi/provider.rb

@@ -0,0 +1,39 @@
+module Titi
+  module Provider
+    autoload :ActivityStreams, 'titi/provider/activity_streams'
+    #
+    autoload :Twitter   , 'titi/provider/twitter'
+    # autoload :Gowalla   , 'titi/provider/gowalla'
+    # autoload :Foursquare, 'titi/provider/foursquare'
+    # autoload :Tripit    , 'titi/provider/tripit'
+    # autoload :Facebook  , 'titi/provider/facebook'
+    # autoload :Myspace   , 'titi/provider/myspace'
+    # autoload :LinkedIn  , 'titi/provider/linked_in'
+    # autoload :Digg      , 'titi/provider/digg'
+    # autoload :Last_fm   , 'titi/provider/last_fm'
+    # autoload :Flickr    , 'titi/provider/flickr'
+    # autoload :WordPress , 'titi/provider/word_press'
+  end
+end
+
+# # from Rob Dolin, a list:
+# {
+# :text_status => %w[ Twitter         StatusNet       Plurk           AIM             WlMessenger                                            ],
+# :location    => %w[ Gowalla         Foursquare      Tripit          Yelp            Qype            UrbanSpoon      Brightkite      Whirl  ],
+# :social      => %w[ Facebook        MySpace         LinkedIn        Xing            Plaxo                                                  ],
+# :music       => %w[ LastFm          Pandora         Zune            iLike                                                                  ],
+# :bookmarking => %w[ Digg            StumbleUpon     Delicious       Facebook                                                               ],
+# :video       => %w[ YouTube         DailyMotion     Hulu            BuddyTv         SkyDrive                                               ],
+# :gaming      => %w[ Zynga           Playdom         MsgrGames                                                                              ],
+# :photos      => %w[ Flickr          Photobucket     MetroFlog       Fotolog         Picasa          WlSkyDrive                             ],
+# :blogging    => %w[ Blogger         WordPress       TypePad         MySpace         MoveableType    WlSpaces                               ],
+# }
+#
+# # See also: http://feedproxy.cliqset.com/feed/selection
+# {
+# Social       => %w[ AvatarsUnited Bebo BrightKite Friendster FriendFeed GamerDNA Gather hi5 Hyves Identica Jaiku Multiply Netlog Plurk Raptr Skyrock Twitter ],
+# Blogging     => %w[ Ameba Baidu Blogger CustomFeed Douban LiveJournal Posterous Tumblr WordPress Xanga ],
+# Bookmarking  => %w[ Delicious Digg Diigo GoogleReader Hatena Meneame Mixx Newsvine Propeller Reddit StumbleUpon Twine ],
+# Media        => %w[ 12seconds BlipFm BlipTv Buzznet Cinchcast Dailymotion DeviantArt Flickr Fotolog FunnyOrDie Hulu iLike Joost LastFm MetaCafe MobyPicture Pandora Photobucket Photocase Picasa Qik Revver SlideShare Smotri SmugMug VisualizeUs Vimeo YouTube Zooomr ],
+# Reviews      => %w[ Blippr Corkd Flixster Goodreads LibraryThing Qype Readernaut Yelp  ],
+# }

data/lib/titi/provider/README.textile

@@ -0,0 +1,3 @@
+
+
+

data/lib/titi/provider/activity_streams.rb

@@ -0,0 +1,87 @@
+module Titi
+
+  module Provider
+    #
+    module ActivityStreams
+      # Some methods common to all ActivityStreams classes
+      module Common
+        def to_hash *args
+          hsh = super(*args)
+          hsh.each do |attr, val|
+            hsh[attr] = val.to_hash if val.respond_to?(:to_hash)
+          end
+          hsh
+        end
+
+        def to_xml *args
+          hsh = self.to_hash
+          hsh.to_xml :root => self.class.to_s.underscore.gsub(%r{.*/},'')
+        end
+      end
+
+      # An ActivityStream entry
+      #   http://activitystrea.ms/spec/1.0/atom-activity-01.html#activityentries
+      Entry = Struct.new(
+        :id,                # ???
+        :title,             # title
+        :content,           # content
+        :link,              # link             {"href"=>"http://x.myspacecdn.com/modules/common/static/img/photo.gif", "rel"=>"icon", "type"=>"image/gif"}
+        :published,         # date published
+        :updated,           # date updated
+        #
+        :category,          # type of entry
+        :verb,              # action it implies
+        :sync,              # sync
+        :rank,              # rank
+        #
+        :actor,             # actor
+        :author,            # author           {"name"=>["misterflip"], "uri"=>["http://profile.myspace.com/index.cfm?fuseaction=user.viewprofile&friendid=24601"]}
+        :mood,              #
+        :source,
+        :object,            # object
+        :target             # target
+        )
+      Entry.class_eval do
+        include Titi::Adaptor
+        include Titi::Provider::ActivityStreams::Common
+        def published= date_time
+          self[:published] = DateTime.parse(date_time) rescue nil
+        end
+        def updated= date_time
+          self[:updated] = DateTime.parse(date_time) rescue nil
+        end
+      end
+
+      # ActivityStream author
+      #  http://activitystrea.ms/spec/1.0/atom-activity-01.html#activityactor
+      Actor = Struct.new(
+        :name,
+        :uri
+        )
+      Actor.class_eval do
+        include Titi::Adaptor
+        include Titi::Provider::ActivityStreams::Common
+      end
+      Author = Actor
+
+      # ActivityStream object
+      #   http://activitystrea.ms/spec/1.0/atom-activity-01.html#activityobjectelement
+      ActivityObject = Struct.new(
+        :id,
+        :title,
+        :content,
+        :link,
+        :published,
+        :updated,
+        #
+        :author,
+        :object_type,
+        :vevent
+        )
+      ActivityObject.class_eval do
+        include Titi::Adaptor
+        include Titi::Provider::ActivityStreams::Common
+      end
+    end
+  end
+end

data/lib/titi/provider/tripit.rb

@@ -0,0 +1,7 @@
+module Titi::Provider
+  module Tripit
+
+    VERBS = %w[ install connect planning returning about_to_leave made_changes is_planning ].map(&:to_sym)
+
+  end
+end

data/lib/titi/provider/twitter.rb

@@ -0,0 +1,54 @@
+module Titi::Provider
+  module Twitter
+    autoload :User,   'titi/provider/twitter/models'
+    autoload :Status, 'titi/provider/twitter/models'
+
+    Status.class_eval do
+      # @example
+      #     <entry>
+      #       <title>ciberch: thanks to /Jerry @robdolin , @daveman692, @chrismessina, @apparentlymart and @jsmarr for a very produtive activitystrea.ms session</title>
+      #       <content type="html">ciberch: thanks to /Jerry  @robdolin , @daveman692, @chrismessina, @apparentlymart and @jsmarr for a very produtive activitystrea.ms session</content>
+      #       <id>tag:twitter.com,2007:http://twitter.com/ciberch/statuses/2396395271</id>
+      #       <published>2009-06-30T00:59:54+00:00</published>
+      #       <updated>2009-06-30T00:59:54+00:00</updated>
+      #       <link type="text/html" rel="alternate" href="http://twitter.com/ciberch/statuses/2396395271"/>
+      #       <link type="image/pjpeg" rel="image" href="http://s3.amazonaws.com/twitter_production/profile_images/81481539/180653_normal.jpg"/>
+      #       <author>
+      #         <name>Monica Keller</name>
+      #         <uri>http://www.myspace.com/ciberch</uri>
+      #       </author>
+      #       <activity:verb>http://activitystrea.ms/schema/1.0/post</activity:verb>
+      #       <activity:object>
+      #           <id>tag:twitter.com,2007:http://twitter.com/ciberch/statuses/2396395271/object</id>
+      #           <title>thanks to /Jerry  @robdolin , @daveman692, @chrismessina, @apparentlymart and @jsmarr for a very produtive activitystrea.ms session</title>
+      #           <link type="text/html" rel="alternate" href="http://twitter.com/ciberch/statuses/2396395271"/>
+      #           <published>2009-06-30T00:59:54+00:00</published>
+      #           <updated>2009-06-30T00:59:54+00:00</updated>
+      #           <author>
+      #               <name>Monica Keller</name>
+      #               <uri>http://www.myspace.com/ciberch</uri>
+      #           </author>
+      #       </activity:object>
+      #     </entry>
+      #
+      def to_activity_stream_entry
+        ActivityStreams::Entry.adapt(
+          :id        => %Q{tag:twitter.com,2007:http://twitter.com/#{user.screen_name}/statuses/#{id}},
+          :title     => text,
+          :content   => text,
+          :published => created_at,
+          :verb      => :post
+          ) do |entry|
+          entry.author    = ActivityStreams::Author.new(user.name, user.url)
+          entry.object    = ActivityStreams::ActivityObject.adapt do |activity_obj|
+            activity_obj.id        = id
+            activity_obj.title     = text
+            activity_obj.published = created_at
+            activity_obj.updated   = created_at
+            activity_obj.author    = entry.author
+          end
+        end
+      end
+    end
+  end
+end

data/lib/titi/provider/twitter/example.rb

@@ -0,0 +1,11 @@
+require 'restclient'
+require 'json'
+require 'titi'
+require 'wukong'
+require 'active_support'
+
+# Dir['./**/*.rb'].each{|req| load req }^
+# $raw_json_str = RestClient.get 'http://twitter.com/users/show/mrflip.json'
+$raw_json_str = %q{{"created_at":"Mon Mar 19 21:08:24 +0000 2007","profile_sidebar_fill_color":"ffffff","description":"Founder, http://infochimps.org - Building tools to Organize, Explore and Comprehend massive data sources","verified":false,"time_zone":"Central Time (US & Canada)","status":{"in_reply_to_status_id":null,"created_at":"Sat Apr 17 05:47:28 +0000 2010","favorited":false,"in_reply_to_user_id":null,"source":"<a href=\"http://www.atebits.com/\" rel=\"nofollow\">Tweetie</a>","id":12327261220,"in_reply_to_screen_name":null,"truncated":false,"text":"Hacking Activity Streams yay"},"following":null,"profile_sidebar_border_color":"f0edd8","url":"http://infochimps.org","profile_image_url":"http://a3.twimg.com/profile_images/377919497/FlipCircle-2009-900-trans_normal.png","notifications":null,"followers_count":1061,"profile_background_color":"BCC0C8","location":"iPhone: 30.316122,-97.733817","screen_name":"mrflip","profile_background_image_url":"http://a3.twimg.com/profile_background_images/2348065/2005Mar-AustinTypeTour-075_-_Rappers_Delight_Raindrop.jpg","friends_count":754,"statuses_count":1744,"profile_text_color":"000000","protected":false,"profile_background_tile":false,"favourites_count":98,"name":"Philip Flip Kromer","contributors_enabled":false,"profile_link_color":"0000ff","id":1554031,"lang":"en","geo_enabled":true,"utc_offset":-21600}}
+$raw_user     = JSON.load($raw_json_str.to_s)
+$user         = Titi::Provider::Twitter::User.from_hash $raw_user

data/lib/titi/provider/twitter/models.rb

@@ -0,0 +1,102 @@
+module Titi::Provider
+  module Twitter
+
+    #
+    #
+    # {
+    #   "id"                                => 1554031,
+    #   "screen_name"                       => "mrflip",
+    #   "protected"                         => false,
+    #   "followers_count"                   => 1060,
+    #   "friends_count"                     => 754,
+    #   "statuses_count"                    => 1744,
+    #   "favourites_count"                  => 98,
+    #   "created_at"                        => "Mon Mar 19 21:08:24 +0000 2007",
+    #   #
+    #   "name"                              => "Philip Flip Kromer",
+    #   "url"                               => "http://infochimps.org",
+    #   "location"                          => "iPhone: 30.316122,-97.733817",
+    #   "description"                       => "Founder, http://infochimps.org - Building tools to Organize, Explore and Comprehend massive data sources",
+    #   "time_zone"                         => "Central Time (US & Canada)",
+    #   "utc_offset"                        => -21600,
+    #   "lang"                              => "en",
+    #   #
+    #   "profile_background_color"          => "BCC0C8",
+    #   "profile_text_color"                => "000000",
+    #   "profile_link_color"                => "0000ff",
+    #   "profile_sidebar_border_color"      => "f0edd8",
+    #   "profile_sidebar_fill_color"        => "ffffff",
+    #   "profile_background_tile"           => false,
+    #   "profile_background_image_url"      => "http://a3.twimg.com/profile_background_images/2348065/2005Mar-AustinTypeTour-075_-_Rappers_Delight_Raindrop.jpg",
+    #   "profile_image_url"                 => "http://a3.twimg.com/profile_images/377919497/FlipCircle-2009-900-trans_normal.png",
+    #   #
+    #   "geo_enabled"                       => true,
+    #   "contributors_enabled"              => false,
+    #   "following"                         => nil,
+    #   "notifications"                     => nil,
+    #   "verified"                          => false,
+    #   #
+    #   "status"                            => #<Twitter::Status>
+    # }
+    #
+    User = Struct.new(
+      :id,
+      :screen_name, :protected, :followers_count, :friends_count, :statuses_count, :favourites_count, :created_at,
+      :name, :url, :location, :description, :time_zone, :utc_offset,
+      :profile_background_color, :profile_text_color, :profile_link_color,
+      :profile_sidebar_border_color, :profile_sidebar_fill_color,
+      :profile_background_tile, :profile_background_image_url, :profile_image_url
+      )
+    User.class_eval do
+      include Titi::Provider
+      include Titi::Adaptor
+      # def status= new_status
+      #   new_status = Twitter::Status.from_hash(new_status) unless new_status.is_a?(Twitter::Status)
+      #   self[:status] = new_status
+      # end
+
+      def created_at= date_time
+        p [:created_at, date_time]
+        unless date_time.is_a?(DateTime)
+          dt = DateTime.parse(date_time) rescue nil
+          p dt
+        end
+        self[:created_at] = dt
+      end
+    end
+
+    # {
+    #   "id"                              => 12327261220,
+    #   "created_at"                      => "Sat Apr 17 05:47:28 +0000 2010",
+    #   "user"                            => #<Twitter::User>
+    #   "text"                            => "Hacking Activity Streams yay",
+    #   "favorited"                       => false,
+    #   "truncated"                       => false,
+    #   "in_reply_to_user_id"             => nil,
+    #   "in_reply_to_status_id"           => nil
+    #   "in_reply_to_screen_name"         => nil,
+    #   "source"                          => "<a href='http://www.atebits.com/' rel='nofollow'>Tweetie</a>",
+    # }
+    Status =  Struct.new(
+      :id,
+      :created_at,
+      :user,
+      :favorited,
+      :truncated,
+      :in_reply_to_user_id,
+      :in_reply_to_status_id,
+      :text,
+      :source,
+      :in_reply_to_screen_name
+      )
+    Status.class_eval do
+      include Titi::Provider
+      include Titi::Adaptor
+
+      def user= new_user
+        new_user  = Twitter::User.from_hash(new_user.to_hash) unless new_user.is_a?(Twitter::User)
+        self[:user] = new_user
+      end
+    end
+  end
+end

data/notes/jeweler-gen.sh

@@ -0,0 +1,12 @@
+jeweler  \
+  --summary     'Emit and consume Activity Streams from a wide variety of sources' \
+  --description 'Facade adapting apis to activity streams spec' \
+  --rspec --reek --roodi  --yard \
+  --gemcutter --create-repo --user-name=mrflip --user-email=flip@infochimps.org --github-username=mrflip \
+  titi
+
+
+  bloom filter:
+    n ln(p)          n log10(1/p)     
+  - -------- =     ---------------  = 0.9 n log10(1/p)  ...
+    (ln 2)^2       (ln 2)^2 ln(10)     

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'titi'
+require 'spec'
+require 'spec/autorun'
+
+Spec::Runner.configure do |config|
+  
+end

data/spec/titi_spec.rb

@@ -0,0 +1,7 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "Titi" do
+  it "fails" do
+    fail "hey buddy, you should probably rename this file and start specing for real"
+  end
+end

data/titi.gemspec

@@ -0,0 +1,78 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{titi}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["mrflip"]
+  s.date = %q{2010-04-17}
+  s.description = %q{Facade adapting apis to activity streams spec}
+  s.email = %q{flip@infochimps.org}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.textile"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.textile",
+     "Rakefile",
+     "VERSION",
+     "lib/titi.rb",
+     "lib/titi/adaptor.rb",
+     "lib/titi/matcher.rb",
+     "lib/titi/parse_tree.rb",
+     "lib/titi/provider.rb",
+     "lib/titi/provider/README.textile",
+     "lib/titi/provider/activity_streams.rb",
+     "lib/titi/provider/tripit.rb",
+     "lib/titi/provider/twitter.rb",
+     "lib/titi/provider/twitter/example.rb",
+     "lib/titi/provider/twitter/models.rb",
+     "notes/jeweler-gen.sh",
+     "spec/spec.opts",
+     "spec/spec_helper.rb",
+     "spec/titi_spec.rb",
+     "titi.gemspec"
+  ]
+  s.homepage = %q{http://github.com/mrflip/titi}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{Emit and consume Activity Streams from a wide variety of sources}
+  s.test_files = [
+    "spec/spec_helper.rb",
+     "spec/titi_spec.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<restclient>, [">= 0.0.0"])
+      s.add_runtime_dependency(%q<wukong>, [">= 0.0.0"])
+      s.add_runtime_dependency(%q<active_support>, [">= 0.0.0"])
+      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_development_dependency(%q<yard>, [">= 0"])
+    else
+      s.add_dependency(%q<restclient>, [">= 0.0.0"])
+      s.add_dependency(%q<wukong>, [">= 0.0.0"])
+      s.add_dependency(%q<active_support>, [">= 0.0.0"])
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_dependency(%q<yard>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<restclient>, [">= 0.0.0"])
+    s.add_dependency(%q<wukong>, [">= 0.0.0"])
+    s.add_dependency(%q<active_support>, [">= 0.0.0"])
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    s.add_dependency(%q<yard>, [">= 0"])
+  end
+end
+

metadata

@@ -0,0 +1,152 @@
+--- !ruby/object:Gem::Specification 
+name: titi
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- mrflip
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-04-17 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: restclient
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 0
+        - 0
+        version: 0.0.0
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: wukong
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 0
+        - 0
+        version: 0.0.0
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: active_support
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 0
+        - 0
+        version: 0.0.0
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 2
+        - 9
+        version: 1.2.9
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: yard
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id005
+description: Facade adapting apis to activity streams spec
+email: flip@infochimps.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.textile
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.textile
+- Rakefile
+- VERSION
+- lib/titi.rb
+- lib/titi/adaptor.rb
+- lib/titi/matcher.rb
+- lib/titi/parse_tree.rb
+- lib/titi/provider.rb
+- lib/titi/provider/README.textile
+- lib/titi/provider/activity_streams.rb
+- lib/titi/provider/tripit.rb
+- lib/titi/provider/twitter.rb
+- lib/titi/provider/twitter/example.rb
+- lib/titi/provider/twitter/models.rb
+- notes/jeweler-gen.sh
+- spec/spec.opts
+- spec/spec_helper.rb
+- spec/titi_spec.rb
+- titi.gemspec
+has_rdoc: true
+homepage: http://github.com/mrflip/titi
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Emit and consume Activity Streams from a wide variety of sources
+test_files: 
+- spec/spec_helper.rb
+- spec/titi_spec.rb