strelka 0.0.1.pre129 → 0.0.1.pre148

data/spec/strelka/mixins_spec.rb

@@ -1,4 +1,6 @@
-#!/usr/bin/env ruby
+# -*- ruby -*-
+# vim: set nosta noet ts=4 sw=4:
+# encoding: utf-8
 
 BEGIN {
 	require 'pathname'
@@ -95,5 +97,127 @@ describe Strelka, "mixins" do
 	end
 
 
+	describe Strelka::Delegation do
+
+		before( :all ) do
+			setup_logging( :fatal )
+		end
+		after( :all ) do
+			reset_logging()
+		end
+
+		describe "method delegation" do
+			before( :all ) do
+				@testclass = Class.new do
+					extend Strelka::Delegation
+
+					def initialize( obj )
+						@obj = obj
+					end
+
+					def_method_delegators :demand_loaded_object, :delegated_method
+					def_method_delegators :nonexistant_method, :erroring_delegated_method
+
+					def demand_loaded_object
+						return @obj
+					end
+				end
+			end
+
+			before( :each ) do
+				@subobj = mock( "delegate" )
+				@obj = @testclass.new( @subobj )
+			end
+
+
+			it "can be used to set up delegation through a method" do
+				@subobj.should_receive( :delegated_method )
+				@obj.delegated_method
+			end
+
+			it "passes any arguments through to the delegate object's method" do
+				@subobj.should_receive( :delegated_method ).with( :arg1, :arg2 )
+				@obj.delegated_method( :arg1, :arg2 )
+			end
+
+			it "allows delegation to the delegate object's method with a block" do
+				@subobj.should_receive( :delegated_method ).with( :arg1 ).
+					and_yield( :the_block_argument )
+				blockarg = nil
+				@obj.delegated_method( :arg1 ) {|arg| blockarg = arg }
+				blockarg.should == :the_block_argument
+			end
+
+			it "reports errors from its caller's perspective", :ruby_1_8_only => true do
+				begin
+					@obj.erroring_delegated_method
+				rescue NoMethodError => err
+					err.message.should =~ /nonexistant_method/
+					err.backtrace.first.should =~ /#{__FILE__}/
+				rescue ::Exception => err
+					fail "Expected a NoMethodError, but got a %p (%s)" % [ err.class, err.message ]
+				else
+					fail "Expected a NoMethodError, but no exception was raised."
+				end
+			end
+
+		end
+
+		describe "instance variable delegation (ala Forwardable)" do
+			before( :all ) do
+				@testclass = Class.new do
+					extend Strelka::Delegation
+
+					def initialize( obj )
+						@obj = obj
+					end
+
+					def_ivar_delegators :@obj, :delegated_method
+					def_ivar_delegators :@glong, :erroring_delegated_method
+
+				end
+			end
+
+			before( :each ) do
+				@subobj = mock( "delegate" )
+				@obj = @testclass.new( @subobj )
+			end
+
+
+			it "can be used to set up delegation through a method" do
+				@subobj.should_receive( :delegated_method )
+				@obj.delegated_method
+			end
+
+			it "passes any arguments through to the delegate's method" do
+				@subobj.should_receive( :delegated_method ).with( :arg1, :arg2 )
+				@obj.delegated_method( :arg1, :arg2 )
+			end
+
+			it "allows delegation to the delegate's method with a block" do
+				@subobj.should_receive( :delegated_method ).with( :arg1 ).
+					and_yield( :the_block_argument )
+				blockarg = nil
+				@obj.delegated_method( :arg1 ) {|arg| blockarg = arg }
+				blockarg.should == :the_block_argument
+			end
+
+			it "reports errors from its caller's perspective", :ruby_1_8_only => true do
+				begin
+					@obj.erroring_delegated_method
+				rescue NoMethodError => err
+					err.message.should =~ /`erroring_delegated_method' for nil/
+					err.backtrace.first.should =~ /#{__FILE__}/
+				rescue ::Exception => err
+					fail "Expected a NoMethodError, but got a %p (%s)" % [ err.class, err.message ]
+				else
+					fail "Expected a NoMethodError, but no exception was raised."
+				end
+			end
+
+		end
+
+	end
+
 end
 

data/spec/strelka/{app/paramvalidator_spec.rb → paramvalidator_spec.rb}

@@ -13,13 +13,13 @@ require 'rspec'
 require 'spec/lib/helpers'
 
 require 'strelka'
-require 'strelka/app/paramvalidator'
+require 'strelka/paramvalidator'
 
 
 #####################################################################
 ###	C O N T E X T S
 #####################################################################
-describe Strelka::App::ParamValidator do
+describe Strelka::ParamValidator do
 
 	TEST_PROFILE = {
 		:required		=> [ :required ],
@@ -55,7 +55,7 @@ describe Strelka::App::ParamValidator do
 	end
 
 	before(:each) do
-		@validator = Strelka::App::ParamValidator.new( TEST_PROFILE )
+		@validator = Strelka::ParamValidator.new( TEST_PROFILE )
 	end
 
 	after( :all ) do
@@ -83,7 +83,7 @@ describe Strelka::App::ParamValidator do
 					required: $stderr,
 				}
 			}
-			val = Strelka::App::ParamValidator.new( profile )
+			val = Strelka::ParamValidator.new( profile )
 
 			expect {
 				val.validate( required: '1' )

data/spec/strelka/{app/defaultrouter_spec.rb → router/default_spec.rb}

@@ -1,4 +1,6 @@
-#!/usr/bin/env ruby
+# -*- ruby -*-
+# vim: set nosta noet ts=4 sw=4:
+# encoding: utf-8
 
 BEGIN {
 	require 'pathname'
@@ -11,14 +13,14 @@ require 'rspec'
 require 'spec/lib/helpers'
 
 require 'strelka'
-require 'strelka/app/defaultrouter'
+require 'strelka/router/default'
 
 
 #####################################################################
 ###	C O N T E X T S
 #####################################################################
 
-describe Strelka::App::DefaultRouter do
+describe Strelka::Router::Default do
 
 	before( :all ) do
 		setup_logging( :fatal )
@@ -26,7 +28,7 @@ describe Strelka::App::DefaultRouter do
 	end
 
 	before( :each ) do
-		@router = Strelka::App::Router.create( 'default' )
+		@router = Strelka::Router.create( 'default' )
 	end
 
 	after( :all ) do

data/spec/strelka/{app/exclusiverouter_spec.rb → router/exclusive_spec.rb}

@@ -1,4 +1,6 @@
-#!/usr/bin/env ruby
+# -*- ruby -*-
+# vim: set nosta noet ts=4 sw=4:
+# encoding: utf-8
 
 BEGIN {
 	require 'pathname'
@@ -11,14 +13,14 @@ require 'rspec'
 require 'spec/lib/helpers'
 
 require 'strelka'
-require 'strelka/app/exclusiverouter'
+require 'strelka/router/exclusive'
 
 
 #####################################################################
 ###	C O N T E X T S
 #####################################################################
 
-describe Strelka::App::ExclusiveRouter do
+describe Strelka::Router::Exclusive do
 
 	before( :all ) do
 		setup_logging( :fatal )
@@ -26,7 +28,7 @@ describe Strelka::App::ExclusiveRouter do
 	end
 
 	before( :each ) do
-		@router = Strelka::App::ExclusiveRouter.new
+		@router = Strelka::Router::Exclusive.new
 	end
 
 	after( :all ) do

data/spec/strelka/{app/router_spec.rb → router_spec.rb}

@@ -1,8 +1,10 @@
-#!/usr/bin/env ruby
+# -*- ruby -*-
+# vim: set nosta noet ts=4 sw=4:
+# encoding: utf-8
 
 BEGIN {
 	require 'pathname'
-	basedir = Pathname.new( __FILE__ ).dirname.parent.parent.parent
+	basedir = Pathname.new( __FILE__ ).dirname.parent.parent
 	$LOAD_PATH.unshift( basedir ) unless $LOAD_PATH.include?( basedir )
 }
 
@@ -11,14 +13,14 @@ require 'rspec'
 require 'spec/lib/helpers'
 
 require 'strelka'
-require 'strelka/app/router'
+require 'strelka/router'
 
 
 #####################################################################
 ###	C O N T E X T S
 #####################################################################
 
-describe Strelka::App::Router do
+describe Strelka::Router do
 
 	before( :all ) do
 		setup_logging( :fatal )
@@ -30,14 +32,14 @@ describe Strelka::App::Router do
 	end
 
 
-	it "looks for plugins under strelka/app" do
-		Strelka::App::Router.derivative_dirs.should include( 'strelka/app' )
+	it "looks for plugins under strelka/router" do
+		Strelka::Router.derivative_dirs.should include( 'strelka/router' )
 	end
 
 
 	it "is abstract" do
 		expect {
-			Strelka::App::Router.new
+			Strelka::Router.new
 		}.to raise_error()
 	end
 

data/spec/strelka/session/default_spec.rb

@@ -0,0 +1,210 @@
+# -*- rspec -*-
+# vim: set nosta noet ts=4 sw=4:
+
+BEGIN {
+	require 'pathname'
+	basedir = Pathname.new( __FILE__ ).dirname.parent.parent.parent
+	$LOAD_PATH.unshift( basedir ) unless $LOAD_PATH.include?( basedir )
+}
+
+require 'rspec'
+
+require 'spec/lib/helpers'
+
+require 'strelka'
+require 'strelka/session/default'
+
+
+#####################################################################
+###	C O N T E X T S
+#####################################################################
+
+describe Strelka::Session::Default do
+
+	before( :all ) do
+		@request_factory = Mongrel2::RequestFactory.new( route: '/hungry' )
+		setup_logging( :fatal )
+	end
+
+	before( :each ) do
+		described_class.cookie_name = described_class::DEFAULT_COOKIE_NAME
+	end
+
+	after( :each ) do
+		described_class.sessions.clear
+	end
+
+	after( :all ) do
+		reset_logging()
+	end
+
+	it "has distinct duplicates" do
+		original = Strelka::Session.create( 'default', 'the_session_id' )
+		copy = original.dup
+		copy[:foom] = 1
+		original[:foom].should == {}
+	end
+
+
+	it "can be configured to store its session ID in a different cookie" do
+		described_class.configure( :cookie_name => 'buh-mahlon' )
+		described_class.cookie_name.should == 'buh-mahlon'
+	end
+
+	it "can load sessions from and save sessions to its in-memory store" do
+		session_data = { :namespace => {'the' => 'stuff'} }
+		described_class.save_session_data( 'the_key', session_data )
+
+		loaded = described_class.load_session_data( 'the_key' )
+		loaded.should_not equal( session_data )
+		loaded.should == session_data
+	end
+
+	it "generates a session-id if one isn't available in the request" do
+		req = @request_factory.get( '/hungry/what-is-in-a-fruit-bowl?' )
+		described_class.get_session_id( req ).should =~ /^[[:xdigit:]]+$/
+	end
+
+	it "rejects invalid session-ids" do
+		session_cookie = 'strelka-sessionid=gibberish'
+		req = @request_factory.get( '/hungry/what-is-in-a-fruit-bowl?', :cookie => session_cookie )
+		described_class.get_session_id( req ).should =~ /^[[:xdigit:]]+$/
+	end
+
+	it "accepts and reuses an existing valid session-id" do
+		session_id = '3422067061a5790be374c81118d9ed3f'
+		session_cookie = "strelka-sessionid=%s" % [ session_id ]
+		req = @request_factory.get( '/hungry/what-is-in-a-fruit-bowl?', :cookie => session_cookie )
+		described_class.get_session_id( req ).should == session_id
+	end
+
+
+	it "can save itself to the store and set the response's session ID" do
+		req          = @request_factory.get( '/hungry/hungry/hippos' )
+		response     = req.response
+		session_id   = '3422067061a5790be374c81118d9ed3f'
+		session_data = { :namespace => {'fruit' => 'bowl'} }
+		session      = described_class.new( session_id, session_data )
+
+		session.save( response )
+
+		described_class.sessions.should == { session_id => session_data }
+		response.header_data.should =~ /Set-Cookie: #{described_class::DEFAULT_COOKIE_NAME}=#{session_id}/i
+	end
+
+	describe "with no namespace set (the 'nil' namespace)" do
+
+		subject { Strelka::Session.create('default', 'the_session_id') }
+
+		before( :each ) do
+			subject.namespace = nil
+		end
+
+		after( :each ) do
+			subject.namespace = nil
+			subject.clear
+		end
+
+		it "accesses the hash of namespaces" do
+			subject.namespace = :foo
+			subject[:number] = 18
+			subject.namespace = 'bar'
+			subject[:number] = 28
+
+			subject.namespace = nil
+
+			subject.keys.should have( 2 ).members
+			subject.keys.should include( :foo, :bar )
+			subject.values.should all_be_a( Hash )
+			subject[:foo][:number].should == 18
+			subject[:bar][:number].should == 28
+		end
+
+		it "accesses namespaces via a struct-like interface" do
+			subject.namespace = :meat
+			subject.testkey = true
+			subject.namespace = :greet
+			subject.testkey = true
+			subject.namespace = nil
+
+			subject.meat[ :testkey ].should be_true
+			subject.greet[ :testkey ].should be_true
+			subject.pork[ :testkey ].should be_nil
+		end
+
+		it "is Enumerable (over the hash of namespaces)" do
+			subject.namespace = :meta
+			subject.create_me = :yes
+			subject.namespace = :tetra
+			subject.create_me = :yes
+			subject.namespace = nil
+
+			subject.map {|k,v| k }.should include( :meta, :tetra )
+		end
+
+		it "can merge namespaces into the session" do
+			subject.merge!( :app1 => {:foom => 88}, :app2 => {:foom => 188} )
+			subject.app1[:foom].should == 88
+			subject.app2[:foom].should == 188
+		end
+
+	end
+
+
+	describe "with a namespace set" do
+
+		subject { Strelka::Session.create('default', 'the_session_id') }
+
+		before( :each ) do
+			subject.namespace = :meat
+		end
+
+		after( :each ) do
+			subject.namespace = nil
+			subject.clear
+		end
+
+		it "accesses the namespaced hash" do
+			subject[:number] = 18
+			subject[:not_a_number] = 'woo'
+
+			subject.keys.should have( 2 ).members
+			subject.keys.should include( :number, :not_a_number )
+			subject[:number].should == 18
+			subject[:not_a_number].should == 'woo'
+		end
+
+		it "accesses values via a struct-like interface" do
+			subject.testkey = true
+
+			subject.testkey.should be_true
+			subject.i_do_not_exist.should be_nil
+		end
+
+		it "is Enumerable (over the namespaced hash)" do
+			subject.namespace = :meta
+			subject.create_me = :yes
+			subject.destroy_me = :yes
+			subject.whip_me = :definitely
+			subject.beat_me = :indubitably
+
+			banner = subject.each_with_object('Hey!') do |(k,v),accum|
+				accum << "#{k} "
+			end
+
+			banner.should =~ /create_me/
+			banner.should =~ /destroy_me/
+			banner.should =~ /whip_me/
+			banner.should =~ /beat_me/
+		end
+
+		it "can merge a hash into the namespace" do
+			subject.merge!( :app1 => {:foom => 88}, :app2 => {:foom => 188} )
+			subject.app1[:foom].should == 88
+			subject.app2[:foom].should == 188
+		end
+
+	end
+
+end
+

data/spec/strelka/session_spec.rb

@@ -0,0 +1,101 @@
+# -*- rspec -*-
+# vim: set nosta noet ts=4 sw=4:
+
+BEGIN {
+	require 'pathname'
+	basedir = Pathname.new( __FILE__ ).dirname.parent.parent
+	$LOAD_PATH.unshift( basedir ) unless $LOAD_PATH.include?( basedir )
+}
+
+require 'rspec'
+
+require 'spec/lib/helpers'
+
+require 'strelka'
+require 'strelka/session'
+
+
+#####################################################################
+###	C O N T E X T S
+#####################################################################
+
+describe Strelka::Session do
+
+	before( :all ) do
+		setup_logging( :fatal )
+		@request_factory = Mongrel2::RequestFactory.new( route: '/user' )
+	end
+
+	after( :all ) do
+		reset_logging()
+	end
+
+
+	it "looks for plugins under strelka/session" do
+		described_class.derivative_dirs.should include( 'strelka/session' )
+	end
+
+
+	it "is abstract" do
+		expect {
+			described_class.new
+		}.to raise_error( /private method/i )
+	end
+
+
+	it "accepts configuration options" do
+		described_class.configure( :cookie_name => 'animal-crackers' )
+	end
+
+
+	it "can be asked to load an instance of itself by session ID" do
+		# By default, loading always fails
+		described_class.load( 'the_session_id' ).should be_nil()
+	end
+
+
+	describe "a concrete subclass with no method overrides" do
+
+		subject { Class.new(described_class).new('an_id') }
+
+		it "raises NotImplementedErrors when #[] is called" do
+			expect {
+				subject[ :foo ]
+			}.to raise_error(NotImplementedError)
+		end
+
+		it "raises NotImplementedErrors if they don't implement #[]=" do
+			expect {
+				subject[ :foo ] = 1
+			}.to raise_error(NotImplementedError)
+		end
+
+		it "raises NotImplementedErrors if they don't implement #key?" do
+			expect {
+				subject.key?( :foo )
+			}.to raise_error(NotImplementedError)
+		end
+
+		it "raises NotImplementedErrors if they don't implement #delete" do
+			expect {
+				subject.delete( :foo )
+			}.to raise_error(NotImplementedError)
+		end
+
+		it "raises NotImplementedErrors if they don't implement #namepace=" do
+			expect {
+				subject.namespace = :myapp
+			}.to raise_error(NotImplementedError)
+		end
+
+		it "raises NotImplementedErrors if they don't implement #namepace" do
+			expect {
+				subject.namespace
+			}.to raise_error(NotImplementedError)
+		end
+
+	end
+
+
+end
+

data.tar.gz.sig

@@ -1 +1 @@
-L:HH0�ˢ���3Z��g�'Ĕ<\G��W���T+�x�	�4�ɼFm+���s.��O%�,_`�
+Hy?�8�x�v�x���>��=魝_4�9��X�%	�/<�E[0