dam 0.1.0 → 0.2.0

data/.gitignore

@@ -0,0 +1 @@
+pkg/*

data/README.markdown

@@ -1,2 +1,52 @@
-== Dam
-A ruby framework for Activity Streams
+Dam
+===
+
+A ruby framework for Activity Streams, using Redis as a backend
+
+Assuming you have added gemcutter.org to your ruby gems sources, dam is easy to install using
+  
+    gem install dam
+
+Using Dam
+=========
+
+You need to configure dam to connect to your current redis installation. To do that, put this line somewhere in your code
+    Dam::Storage.database = Redis.new
+
+First, define your activities. You can use any attributes you wish, and give blocks or static values, as long as they are serializable to json
+
+    require 'dam'
+    Dam.activity :comment_posted do
+      author { "name" => params[:comment].user.name, "id" => params[:comment].user.id }
+      published { params[:comment].created_at.to_s }
+      comment { "id" => params[:comment].id, "excerpt" => params[:comment].excerpt }
+      action "post"
+    end
+    
+Then declare streams that will accepts these activities
+
+    require 'dam'
+    Dam.stream :activities_from_bob do
+      limit 10
+      accepts :action => "post", :author => {"name" => "bob"}
+    end
+  
+Finally, just post your activities:
+    Dam.post :comment_posted, :comment => my_comment
+    
+And access the stream's activities using:
+    Dam::Stream[:activities_from_bob].all.each {|activity| puts activity.comment["excerpt"] }
+    
+Further possibilities
+=====================
+
+You can create _templated_ streams, that is, streams who first have to be instantiated to start receiving activities. To do this, use a route-like name, such as
+
+    Dam.stream "project/:project" do
+      limit 15
+      accepts :project => {"id" => params[:project]}
+    end
+
+You can then instantiate these projects to start receiving events
+
+    Dam::Stream["project/12345"].instantiate!

data/Rakefile

@@ -28,6 +28,8 @@ begin
     gemspec.add_development_dependency "jeweler"
     gemspec.add_development_dependency "riot"
   end
+  
+  Jeweler::GemcutterTasks.new
 rescue LoadError
   puts "Jeweler not available. Install it with: "
   puts "gem install jeweler"

data/lib/dam.rb

@@ -13,9 +13,11 @@ module Dam
   end
   
   def self.post(type, params = {})
-    act = Activity.new(Dam::ActivityType.lookup(type.to_sym), params)
+    act = Dam::ActivityType.lookup(type.to_sym).apply(params)
 
-    act.submit!
+    act.post!
+    
+    act
   end
   
   def self.activity(name, &block)

data/lib/dam/stream.rb

@@ -65,7 +65,7 @@ module Dam
     
     def instances
       elems = Dam::Storage.database.keys("stream:" + @glob_pattern)
-      elems.each {|elem| streams << apply(elem) }
+      elems.collect {|elem| apply(elem) }
     end
     
     def matches? what
@@ -188,23 +188,23 @@ module Dam
       # match a nil element with a nil condition
       return condition.nil? if element.nil?
       
-      if condition.respond_to? :each_pair
+      if condition.respond_to? :each_pair # condition is a hash
         condition.all? do |key, value|
-          (element.respond_to?(key) ? element.send(key) : element[key]) == eval_arg(element)
+          eval_condition(value, element[key])
         end
       else
-        condition == eval_arg(element)
+        eval_condition(condition, element)
       end
     end
     
-    def eval_arg(arg)
+    def eval_condition(arg, val)
       case arg
       when ParamsProxy
-        @params[arg.key]
+        @params[arg.key] == val
       when Proc
-        arg.call
+        arg.call(val)
       else
-        arg
+        arg == val
       end
     end
   end

data/lib/dam/version.rb

@@ -1,3 +1,3 @@
 module Dam
-  Version = "0.1.0"
+  Version = "0.2.0"
 end

data/test/stream_test.rb

@@ -103,4 +103,17 @@ context "a parameterized stream" do
     topic.kind_of(Dam::Stream)
     asserts("matches a valid activity") { topic.matches? Dam::Activity[:comment].apply(:author => "bob") }
   end
+end
+
+context "a stream with a proc condition" do
+  setup do
+    Dam::Storage.clear!
+    Dam.stream :with_a_proc do
+      accepts :author => { "name" => Proc.new {|name| name.reverse == name} }
+    end
+  end
+  
+  topic.kind_of(Dam::Stream)
+  asserts("matches a valid activity") { topic.matches? Dam::Activity[:comment].apply(:author => "abcba") }
+  asserts("rejects an invalid activity") { !topic.matches? Dam::Activity[:comment].apply(:author => "not valid") }
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: dam
 version: !ruby/object:Gem::Version 
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Jean-Philippe Bougie
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-11-20 00:00:00 -05:00
+date: 2009-11-24 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -62,6 +62,7 @@ extra_rdoc_files:
 - LICENSE
 - README.markdown
 files: 
+- .gitignore
 - LICENSE
 - README.markdown
 - Rakefile