strelka 0.0.1pre4

data/spec/strelka/app/routing_spec.rb

@@ -0,0 +1,139 @@
+#!/usr/bin/env ruby
+
+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/app/plugins'
+require 'strelka/app/routing'
+
+require 'strelka/behavior/plugin'
+
+
+#####################################################################
+###	C O N T E X T S
+#####################################################################
+
+describe Strelka::App::Routing do
+
+	before( :all ) do
+		setup_logging( :fatal )
+	end
+
+	after( :all ) do
+		reset_logging()
+	end
+
+
+	it_should_behave_like( "A Strelka::App Plugin" )
+
+
+	describe "an including App" do
+
+		before( :each ) do
+			Strelka.log.debug "Creating a new Strelka::App"
+			@app = Class.new( Strelka::App ) do
+				plugin :routing
+			end
+			Strelka.log.debug "  new instance is: %p, routes array: 0x%016x" %
+				[ @app, @app.routes.object_id * 2 ]
+		end
+
+
+		it "has an Array of raw routes" do
+			@app.routes.should be_a( Array )
+		end
+
+		it "can declare a GET route" do
+			@app.routes.should be_empty()
+
+			@app.class_eval do
+				get do |req|
+				end
+			end
+
+			@app.routes.should == [[ :GET, [], @app.instance_method(:GET), {} ]]
+		end
+
+		it "allows a route to specify a path" do
+			@app.routes.should be_empty()
+
+			@app.class_eval do
+				get '/info' do |req|
+				end
+			end
+
+			@app.routes.should == [[ :GET, ['info'], @app.instance_method(:GET_info), {} ]]
+		end
+
+		it "allows a route to omit the leading '/' when specifying a path" do
+			@app.class_eval do
+				get 'info' do |req|
+				end
+			end
+
+			@app.routes.should == [[ :GET, ['info'], @app.instance_method(:GET_info), {} ]]
+		end
+
+
+		it "uses the Strelka::App::DefaultRouter as it's router by default" do
+			@app.routerclass.should equal( Strelka::App::DefaultRouter )
+		end
+
+		it "can specify a different Router class than the default" do
+			class MyRouter < Strelka::App::DefaultRouter; end
+			@app.class_eval do
+				router MyRouter
+			end
+			@app.routerclass.should equal( MyRouter )
+		end
+
+
+		describe "that also uses the :parameters plugin" do
+
+			before( :each ) do
+				@app.plugin( :parameters )
+			end
+
+			it "allows a route to have parameters in it" do
+				@app.class_eval do
+					param :username, /[a-z]\w+/i
+					post '/userinfo/:username' do |req|
+					end
+				end
+
+				@app.routes.should == 
+					[[ :POST, ['userinfo', /(?<username>(?i-mx:[a-z]\w+))/], 
+					   @app.instance_method(:POST_userinfo__username), {} ]]
+			end
+
+
+			it "raises a ScriptError if a route is defined with a param without it having first " +
+			   "been set up" do
+				# RSpec's expect {},to only rescues RuntimeErrors, so we have to do this ourselves.
+				begin
+					@app.get( '/userinfo/:username' ) {}
+				rescue ScriptError => err
+					Strelka.log.error "%p: %s" % [ err.class, err.message ]
+					:pass
+				rescue ::Exception => err
+					fail "Expected to raise a ScriptError, but raised a %p instead" % [ err ]
+				else
+					fail "Expected to raise a ScriptError, but nothing was raised."
+				end
+
+			end
+		end
+
+	end
+
+
+end
+

data/spec/strelka/app/templating_spec.rb

@@ -0,0 +1,169 @@
+#!/usr/bin/env ruby
+
+BEGIN {
+	require 'pathname'
+	basedir = Pathname.new( __FILE__ ).dirname.parent.parent.parent
+	$LOAD_PATH.unshift( basedir ) unless $LOAD_PATH.include?( basedir )
+}
+
+require 'rspec'
+require 'inversion'
+
+require 'spec/lib/helpers'
+
+require 'strelka'
+require 'strelka/app/plugins'
+require 'strelka/app/templating'
+
+require 'strelka/behavior/plugin'
+
+
+#####################################################################
+###	C O N T E X T S
+#####################################################################
+
+describe Strelka::App::Templating do
+
+	before( :all ) do
+		setup_logging( :fatal )
+		@request_factory = Mongrel2::RequestFactory.new( route: '/user' )
+	end
+
+	after( :all ) do
+		reset_logging()
+	end
+
+
+	it_should_behave_like( "A Strelka::App Plugin" )
+
+
+	describe "an including App" do
+
+		before( :each ) do
+			@app = Class.new( Strelka::App ) do
+				plugin :templating
+				templates :main => 'main.tmpl'
+
+				def initialize( appid=TEST_APPID, sspec=TEST_SEND_SPEC, rspec=TEST_RECV_SPEC )
+					super
+				end
+			end
+			@req = @request_factory.get( '/user/info' )
+		end
+
+
+		it "has a Hash of templates" do
+			@app.templates.should be_a( Hash )
+		end
+
+		it "can add templates that it wants to use to its templates hash" do
+			@app.class_eval do
+				templates :main => 'main.tmpl'
+			end
+
+			@app.templates.should == { :main => 'main.tmpl' }
+		end
+
+		it "can declare a layout template" do
+			@app.class_eval do
+				layout 'layout.tmpl'
+			end
+
+			@app.layout.should == 'layout.tmpl'
+		end
+
+		describe "instance" do
+
+			before( :all ) do
+				basedir = Pathname.new( __FILE__ ).dirname.parent.parent.parent
+				specdir = basedir + 'spec'
+				specdata = specdir + 'data'
+
+				tmpl_paths = [ specdata ]
+				Inversion::Template.configure( :template_paths => tmpl_paths )
+			end
+
+			before( :each ) do
+				@app.class_eval do
+					templates :main => 'main.tmpl'
+				end
+				@instance = @app.new( 'template-test', 'tcp://127.0.0.1:9999', 'tcp://127.0.0.1:9998' )
+			end
+
+
+			it "can load declared templates by mentioning the symbol" do
+				@instance.template( :main ).should be_a( Inversion::Template )
+			end
+
+			it "can respond with just a template name" do
+				@app.class_eval do
+					def handle_request( req )
+						super { :main }
+					end
+				end
+
+				res = @app.new.handle( @req )
+
+				res.body.should == "A template for testing the Templating plugin.\n"
+				res.status.should == 200
+			end
+
+			it "can respond with just a template instance" do
+				@app.class_eval do
+					def handle_request( req )
+						super { self.template(:main) }
+					end
+				end
+
+				res = @app.new.handle( @req )
+
+				res.body.should == "A template for testing the Templating plugin.\n"
+				res.status.should == 200
+			end
+
+			it "can respond with a Mongrel2::HTTPResponse with a template instance as its body" do
+				@app.class_eval do
+					def handle_request( req )
+						super do
+							res = req.response
+							res.body = self.template( :main )
+							res
+						end
+					end
+				end
+
+				res = @app.new.handle( @req )
+
+				res.body.should == "A template for testing the Templating plugin.\n"
+				res.status.should == 200
+			end
+
+
+			it "wraps the layout template around whatever gets returned if one is set" do
+				@app.class_eval do
+					layout 'layout.tmpl'
+
+					def handle_request( req )
+						# Super through the plugins and then load the template into the response
+						super do
+							res = req.response
+							res.body = self.template( :main )
+							res
+						end
+					end
+				end
+
+				res = @app.new.handle( @req )
+
+				res.body.should == "A minimal layout template.\n" +
+					"A template for testing the Templating plugin.\n\n"
+				res.status.should == 200
+			end
+
+		end
+
+	end
+
+
+end
+

data/spec/strelka/app_spec.rb

@@ -0,0 +1,160 @@
+#!/usr/bin/env ruby
+
+BEGIN {
+	require 'pathname'
+	basedir = Pathname.new( __FILE__ ).dirname.parent.parent
+	$LOAD_PATH.unshift( basedir ) unless $LOAD_PATH.include?( basedir )
+}
+
+require 'rspec'
+require 'zmq'
+require 'mongrel2'
+
+require 'spec/lib/helpers'
+
+require 'strelka'
+require 'strelka/app'
+
+
+#####################################################################
+###	C O N T E X T S
+#####################################################################
+
+describe Strelka::App do
+
+	before( :all ) do
+		setup_logging( :fatal )
+		@request_factory = Mongrel2::RequestFactory.new( route: '/mail' )
+	end
+
+	before( :each ) do
+		@app = Class.new( Strelka::App ) do
+			def initialize( appid=TEST_APPID, sspec=TEST_SEND_SPEC, rspec=TEST_RECV_SPEC )
+				super
+			end
+		end
+		@req = @request_factory.get( '/mail/inbox' )
+	end
+
+	after( :all ) do
+		reset_logging()
+	end
+
+
+	it "returns a No Content response by default" do
+
+		res = @app.new.handle( @req )
+
+		res.should be_a( Mongrel2::HTTPResponse )
+		res.status_line.should == 'HTTP/1.1 204 No Content'
+		res.body.should == ''
+	end
+
+
+	it "provides a mechanism for aborting with a status" do
+
+		# make a plugin that always 304s and install it
+		not_modified_plugin = Module.new do
+			extend Strelka::App::Plugin
+			def handle_request( r )
+				finish_with( HTTP::NOT_MODIFIED, "Unchanged." )
+				fail "Shouldn't be reached."
+			end
+		end
+		@app.plugin( not_modified_plugin )
+
+		res = @app.new.handle( @req )
+
+		res.should be_a( Mongrel2::HTTPResponse )
+		res.status_line.should == 'HTTP/1.1 304 Not Modified'
+		res.body.should == ''
+	end
+
+
+	it "creates a simple response body for status responses that can have them" do
+		# make an auth plugin that always denies requests
+		forbidden_plugin = Module.new do
+			extend Strelka::App::Plugin
+			def handle_request( r )
+				finish_with( HTTP::FORBIDDEN, "You aren't allowed to look at that." )
+				fail "Shouldn't be reached."
+			end
+		end
+		@app.plugin( forbidden_plugin )
+
+		res = @app.new.handle( @req )
+
+		res.should be_a( Mongrel2::HTTPResponse )
+		res.status_line.should == 'HTTP/1.1 403 Forbidden'
+		res.content_type.should == 'text/plain'
+		res.body.should == "You aren't allowed to look at that.\n"
+	end
+
+
+	it "provides a declarative for setting the default content type of responses" do
+		@app.class_eval do
+			default_content_type 'text/css'
+			def handle_request( r )
+				r.response.puts( "body { font-family: monospace }" )
+				r.response
+			end
+		end
+
+		res = @app.new.handle( @req )
+
+		res.should be_a( Mongrel2::HTTPResponse )
+		res.content_type.should == 'text/css'
+	end
+
+
+	it "provides a plugin hook for plugins to manipulate the request before handling it" do
+		# make a fixup plugin that adds a custom x- header to the request
+		header_fixup_plugin = Module.new do
+			extend Strelka::App::Plugin
+			def fixup_request( r )
+				r.headers[:x_funted_by] = 'Cragnux/1.1.3'
+				super
+			end
+			def handle_request( r )
+				res = r.response
+				res.puts( "Request was funted by %s!" % [r.headers.x_funted_by] )
+				res.status = HTTP::OK
+				return res
+			end
+		end
+		@app.plugin( header_fixup_plugin )
+
+		res = @app.new.handle( @req )
+
+		res.should be_a( Mongrel2::HTTPResponse )
+		res.status_line.should == 'HTTP/1.1 200 OK'
+		res.body.should == "Request was funted by Cragnux/1.1.3!\n"
+	end
+
+
+	it "provides a plugin hook for plugins to manipulate the response before it's returned to Mongrel2" do
+		# make a fixup plugin that adds a custom x- header to the response
+		header_fixup_plugin = Module.new do
+			extend Strelka::App::Plugin
+			def fixup_response( req, res )
+				res.headers.x_funted_by = 'Cragnux/1.1.3'
+				super
+			end
+			def handle_request( r )
+				res = r.response
+				res.puts( "Funt this" )
+				res.status = HTTP::OK
+				return res
+			end
+		end
+		@app.plugin( header_fixup_plugin )
+
+		res = @app.new.handle( @req )
+
+		res.should be_a( Mongrel2::HTTPResponse )
+		res.status_line.should == 'HTTP/1.1 200 OK'
+		res.header_data.should =~ %r{X-Funted-By: Cragnux/1.1.3}
+	end
+
+end
+

data/spec/strelka/httprequest_spec.rb

@@ -0,0 +1,54 @@
+#!/usr/bin/env ruby
+
+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/httprequest'
+
+
+#####################################################################
+###	C O N T E X T S
+#####################################################################
+
+describe Strelka::HTTPRequest do
+
+	before( :all ) do
+		setup_logging( :fatal )
+		@request_factory = Mongrel2::RequestFactory.new( route: '/directory' )
+	end
+
+	after( :all ) do
+		reset_logging()
+	end
+
+
+	before( :each ) do
+		@req = @request_factory.get( '/directory/userinfo/ged' )
+	end
+
+	it "knows what the request's parsed URI is" do
+		@req.uri.should be_a( URI )
+		@req.uri.path.should == '/directory/userinfo/ged'
+		@req.uri.query.should be_nil()
+	end
+
+	it "knows what Mongrel2 route it followed" do
+		@req.pattern.should == '/directory'
+	end
+
+	it "knows what the path of the request past its route is" do
+		@req.app_path.should == '/userinfo/ged'
+	end
+
+	it "knows what HTTP verb the request used" do
+		@req.verb.should == :GET
+	end
+
+end
+

data/spec/strelka/logging_spec.rb

@@ -0,0 +1,72 @@
+#!/usr/bin/env ruby
+
+BEGIN {
+	require 'pathname'
+	basedir = Pathname.new( __FILE__ ).dirname.parent.parent
+	$LOAD_PATH.unshift( basedir ) unless $LOAD_PATH.include?( basedir )
+}
+
+require 'rspec'
+require 'stringio'
+
+require 'spec/lib/helpers'
+
+require 'strelka'
+require 'strelka/logging'
+
+
+#####################################################################
+###	C O N T E X T S
+#####################################################################
+
+describe Strelka::Logging, "-extended module" do
+
+	before( :each ) do
+		@extended_module = Module.new do
+			extend Strelka::Logging
+		end
+	end
+
+	it "should have a default Logger" do
+		@extended_module.logger.should be_a( Logger )
+		@extended_module.default_logger.should equal( @extended_module.logger )
+	end
+
+	it "should know if its default logger is replaced" do
+		@extended_module.should be_using_default_logger
+		@extended_module.logger = Logger.new( $stderr )
+		@extended_module.should_not be_using_default_logger
+	end
+
+	it "has the default logger instance after being reset" do
+		@extended_module.reset_logger
+		@extended_module.logger.should equal( @extended_module.default_logger )
+	end
+
+	it "has the default log formatter instance after being reset" do
+		@extended_module.reset_logger
+		@extended_module.logger.formatter.should equal( @extended_module.default_log_formatter )
+	end
+
+
+	context "with new defaults" do
+
+		before( :each ) do
+			@sink = StringIO.new
+			@logger = Logger.new( @sink )
+			@formatter = Strelka::Logging::ColorFormatter.new( @logger )
+
+			@extended_module.default_logger = @logger
+			@extended_module.default_log_formatter = @formatter
+		end
+
+		it "uses the new defaults when the logging subsystem is reset" do
+			@extended_module.reset_logger
+			@extended_module.logger.should equal( @logger )
+		end
+
+	end
+
+
+end
+

data/spec/strelka_spec.rb

@@ -0,0 +1,27 @@
+#!/usr/bin/env rspec -cfd -b
+
+BEGIN {
+	require 'pathname'
+	basedir = Pathname( __FILE__ ).dirname.parent
+	$LOAD_PATH.unshift( basedir.to_s ) unless $LOAD_PATH.include?( basedir.to_s )
+}
+
+require 'rspec'
+require 'spec/lib/helpers'
+require 'strelka'
+
+describe Strelka do
+
+	describe "version methods" do
+		it "returns a version string if asked" do
+			described_class.version_string.should =~ /\w+ [\d.]+/
+		end
+
+
+		it "returns a version string with a build number if asked" do
+			described_class.version_string(true).should =~ /\w+ [\d.]+ \(build [[:xdigit:]]+\)/
+		end
+	end
+
+end
+