RubyGems - mongrel2 - Versions diffs - 0.0.1 - Mend

mongrel2 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (70) hide show

data.tar.gz.sig +0 -0
data/.gemtest +0 -0
data/History.rdoc +4 -0
data/Manifest.txt +66 -0
data/README.rdoc +169 -0
data/Rakefile +77 -0
data/bin/m2sh.rb +600 -0
data/data/mongrel2/bootstrap.html +25 -0
data/data/mongrel2/config.sql +84 -0
data/data/mongrel2/mimetypes.sql +855 -0
data/examples/README.txt +6 -0
data/examples/config.rb +54 -0
data/examples/helloworld-handler.rb +31 -0
data/examples/request-dumper.rb +45 -0
data/examples/request-dumper.tmpl +71 -0
data/examples/run +17 -0
data/lib/mongrel2.rb +62 -0
data/lib/mongrel2/config.rb +212 -0
data/lib/mongrel2/config/directory.rb +78 -0
data/lib/mongrel2/config/dsl.rb +206 -0
data/lib/mongrel2/config/handler.rb +124 -0
data/lib/mongrel2/config/host.rb +88 -0
data/lib/mongrel2/config/log.rb +48 -0
data/lib/mongrel2/config/mimetype.rb +15 -0
data/lib/mongrel2/config/proxy.rb +15 -0
data/lib/mongrel2/config/route.rb +51 -0
data/lib/mongrel2/config/server.rb +58 -0
data/lib/mongrel2/config/setting.rb +15 -0
data/lib/mongrel2/config/statistic.rb +23 -0
data/lib/mongrel2/connection.rb +212 -0
data/lib/mongrel2/constants.rb +159 -0
data/lib/mongrel2/control.rb +165 -0
data/lib/mongrel2/exceptions.rb +59 -0
data/lib/mongrel2/handler.rb +309 -0
data/lib/mongrel2/httprequest.rb +51 -0
data/lib/mongrel2/httpresponse.rb +187 -0
data/lib/mongrel2/jsonrequest.rb +43 -0
data/lib/mongrel2/logging.rb +241 -0
data/lib/mongrel2/mixins.rb +143 -0
data/lib/mongrel2/request.rb +148 -0
data/lib/mongrel2/response.rb +74 -0
data/lib/mongrel2/table.rb +216 -0
data/lib/mongrel2/xmlrequest.rb +36 -0
data/spec/lib/constants.rb +237 -0
data/spec/lib/helpers.rb +246 -0
data/spec/lib/matchers.rb +50 -0
data/spec/mongrel2/config/directory_spec.rb +91 -0
data/spec/mongrel2/config/dsl_spec.rb +218 -0
data/spec/mongrel2/config/handler_spec.rb +118 -0
data/spec/mongrel2/config/host_spec.rb +30 -0
data/spec/mongrel2/config/log_spec.rb +95 -0
data/spec/mongrel2/config/proxy_spec.rb +30 -0
data/spec/mongrel2/config/route_spec.rb +83 -0
data/spec/mongrel2/config/server_spec.rb +84 -0
data/spec/mongrel2/config/setting_spec.rb +30 -0
data/spec/mongrel2/config/statistic_spec.rb +30 -0
data/spec/mongrel2/config_spec.rb +111 -0
data/spec/mongrel2/connection_spec.rb +172 -0
data/spec/mongrel2/constants_spec.rb +32 -0
data/spec/mongrel2/control_spec.rb +192 -0
data/spec/mongrel2/handler_spec.rb +261 -0
data/spec/mongrel2/httpresponse_spec.rb +232 -0
data/spec/mongrel2/logging_spec.rb +76 -0
data/spec/mongrel2/mixins_spec.rb +62 -0
data/spec/mongrel2/request_spec.rb +157 -0
data/spec/mongrel2/response_spec.rb +81 -0
data/spec/mongrel2/table_spec.rb +176 -0
data/spec/mongrel2_spec.rb +34 -0
metadata +294 -0
metadata.gz.sig +0 -0

data/examples/README.txt ADDED Viewed

@@ -0,0 +1,6 @@
+This is a directory that contains some example Mongrel2 handlers, and
+a configuration.
+To start the example server, run the 'run' file in this directory and
+point a browser to http://localhost:8113/.

data/examples/config.rb ADDED Viewed

@@ -0,0 +1,54 @@
+#!/usr/bin/env ruby
+# The Mongrel config used by the examples.
+BEGIN {
+	require 'pathname'
+	basedir = Pathname( __FILE__ ).dirname.parent
+	libdir = basedir + 'lib'
+	$LOAD_PATH.unshift( libdir.to_s )
+}
+require 'rubygems'
+require 'fileutils'
+require 'mongrel2'
+require 'mongrel2/config'
+include FileUtils::Verbose
+Mongrel2.log.level = Logger::INFO
+Mongrel2::Config.configure( :configdb => 'examples.sqlite' )
+include Mongrel2::Config::DSL
+Mongrel2::Config.init_database!
+# the server to run them all
+server '34D8E57C-3E91-4F24-9BBE-0B53C1827CB4' do
+    access_log   "/logs/access.log"
+    error_log    "/logs/error.log"
+    chroot       "./"
+    pid_file     "/run/mongrel2.pid"
+    default_host "localhost"
+    name         "main"
+    port         8113
+	# your main host
+	host "localhost" do
+		route '/', directory( 'data/mongrel2/', 'bootstrap.html', 'text/html' )
+		route '/source', directory( 'examples/', 'README.txt', 'text/plain' )
+		# Handlers
+    	route '/hello', handler( 'tcp://127.0.0.1:9999',  'helloworld-handler' )
+    	route '/dump', handler( 'tcp://127.0.0.1:9997', 'request-dumper' )
+	end
+end
+setting "zeromq.threads", 2
+mkdir_p 'run'
+mkdir_p 'logs'

data/examples/helloworld-handler.rb ADDED Viewed

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby
+require 'logger'
+require 'mongrel2/config'
+require 'mongrel2/handler'
+# A dumb, dead-simple example that just returns a plaintext 'Hello' document.
+class HelloWorldHandler < Mongrel2::Handler
+	### The main method to override -- accepts requests and returns responses.
+	def handle( request )
+		response = request.response
+		response.status = 200
+		response.headers.content_type = 'text/plain'
+		response.puts "Hello, world, it's #{Time.now}!"
+		return response
+	end
+end # class HelloWorldHandler
+# Log to a file instead of STDERR for a bit more speed.
+Mongrel2.log = Logger.new( 'hello-world.log' )
+Mongrel2.log.level = Logger::INFO
+# Point to the config database, which will cause the handler to use
+# its ID to look up its own socket info.
+Mongrel2::Config.configure( :configdb => 'examples.sqlite' )
+HelloWorldHandler.run( 'helloworld-handler' )

data/examples/request-dumper.rb ADDED Viewed

@@ -0,0 +1,45 @@
+#!/usr/bin/env ruby
+require 'pathname'
+require 'logger'
+require 'mongrel2/config'
+require 'mongrel2/handler'
+require 'inversion'
+# A handler that just dumps the request it gets from Mongrel2
+class RequestDumper < Mongrel2::Handler
+	TEMPLATE_DIR = Pathname( __FILE__ ).dirname
+	Inversion::Template.configure( :template_paths => [TEMPLATE_DIR] )
+	### Pre-load the template before running.
+	def initialize( * )
+		super
+		@template = Inversion::Template.load( 'request-dumper.tmpl' )
+	end
+	### Handle a request
+	def handle( request )
+		response = request.response
+		template = @template.dup
+		template.request = request
+		response.status = 200
+		response.headers.content_type = 'text/html'
+		response.puts( template )
+		return response
+	end
+end # class HelloWorldHandler
+Mongrel2.log.level = Logger::INFO
+# Point to the config database, which will cause the handler to use
+# its ID to look up its own socket info.
+Mongrel2::Config.configure( :configdb => 'examples.sqlite' )
+RequestDumper.run( 'request-dumper' )

data/examples/request-dumper.tmpl ADDED Viewed

@@ -0,0 +1,71 @@
+<!doctype html>
+<head>
+  <meta charset="utf-8">
+  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
+  <title><?attr title ?></title>
+  <meta name="description" content="Ruby-Mongrel2 request introspection handler">
+  <meta name="author" content="Michael Granger">
+  <meta name="viewport" content="width=device-width,initial-scale=1">
+</head>
+<body>
+  <header>
+	<h1>Request Dump (0x<?call "%0x" % request.object_id ?>)</h1>
+  </header>
+  <section id="dump">
+		<table>
+			<tr>
+				<th>Sender ID</th>
+				<td><?escape request.sender_id ?></td>
+			</tr>
+			<tr>
+				<th>Connection ID</th>
+				<td><?escape request.conn_id.to_s ?></td>
+			</tr>
+		</table>
+		<section id="headers">
+			<header>
+				<h1>Headers</h1>
+			</header>
+			<table>
+				<?for name, val in request.headers.each_header.each ?>
+				<tr>
+					<th><?attr name ?></th>
+					<td><?attr val ?></td>
+				</tr>
+				<?end for ?>
+			</table>
+		</section>
+		<section id="body">
+			<header>
+				<h1>Body</h1>
+			</header>
+			<p><code><?escape request.body.dump ?></code></p>
+		</section>
+		<section id="inspect">
+			<header>
+				<h1>Inspected Request</h1>
+				<p><tt>
+					<?pp request ?>
+				</tt></p>
+			</header>
+		</section>
+  </section>
+  <footer>
+	<p><tt>$Id$</tt></p>
+  </footer>
+</body>
+</html>

data/examples/run ADDED Viewed

@@ -0,0 +1,17 @@
+#!/bin/sh
+examplesdir=$(dirname $0)
+echo "Creating the config database..."
+ruby -rubygems -Ilib $examplesdir/config.rb
+echo "Starting Mongrel2..."
+m2sh start -db examples.sqlite -host localhost &
+echo "Starting the 'helloworld' handler..."
+ruby -rubygems -Ilib $examplesdir/helloworld-handler.rb &
+echo "Starting the request dumper..."
+ruby -rubygems -Ilib $examplesdir/request-dumper.rb &
+echo "Okay, now point a browser to http://localhost:8113/."

data/lib/mongrel2.rb ADDED Viewed

@@ -0,0 +1,62 @@
+#!/usr/bin/env ruby
+#
+# A Mongrel2 connector and configuration library for Ruby.
+#
+# == Author/s
+#
+# * Michael Granger <ged@FaerieMUD.org>
+#
+module Mongrel2
+	abort "\n\n>>> Mongrel2 requires Ruby 1.9.2 or later. <<<\n\n" if RUBY_VERSION < '1.9.2'
+	# Library version constant
+	VERSION = '0.0.1'
+	# Version-control revision constant
+	REVISION = %q$Revision: be362e9b6bc8 $
+	require 'mongrel2/logging'
+	extend Mongrel2::Logging
+	require 'mongrel2/constants'
+	include Mongrel2::Constants
+	### Get the library version. If +include_buildnum+ is true, the version string will
+	### include the VCS rev ID.
+	def self::version_string( include_buildnum=false )
+		vstring = "Ruby-Mongrel2 %s" % [ VERSION ]
+		vstring << " (build %s)" % [ REVISION[/: ([[:xdigit:]]+)/, 1] || '0' ] if include_buildnum
+		return vstring
+	end
+	# ZMQ::Context (lazy-loaded)
+	@zmq_ctx = nil
+	### Fetch the ZMQ::Context for sockets, creating it if necessary.
+	def self::zmq_context
+		if @zmq_ctx.nil?
+			Mongrel2.log.info "Using 0MQ %d.%d.%d" % ZMQ.version
+			@zmq_ctx = ZMQ::Context.new
+		end
+		return @zmq_ctx
+	end
+	require 'mongrel2/exceptions'
+	require 'mongrel2/connection'
+	require 'mongrel2/handler'
+	require 'mongrel2/request'
+	require 'mongrel2/httprequest'
+	require 'mongrel2/jsonrequest'
+	require 'mongrel2/xmlrequest'
+	require 'mongrel2/response'
+	require 'mongrel2/control'
+end # module Mongrel2

data/lib/mongrel2/config.rb ADDED Viewed

@@ -0,0 +1,212 @@
+#!/usr/bin/ruby
+require 'pathname'
+require 'uri'
+require 'sequel'
+begin
+	require 'configurability'
+rescue LoadError
+	# No-op: it's optional
+end
+begin
+	require 'amalgalite'
+	# Rude hack to stop Sequel::Model from complaining if it's subclassed before
+	# the first database connection is established. Ugh.
+	Sequel::Model.db = Sequel.amalgalite if Sequel::DATABASES.empty?
+rescue LoadError
+	require 'sqlite3'
+	Sequel::Model.db = Sequel.sqlite if Sequel::DATABASES.empty?
+end
+require 'mongrel2' unless defined?( Mongrel2 )
+require 'mongrel2/mixins'
+module Mongrel2
+	# The base Mongrel2 database-backed configuration class. It's a subclass of Sequel::Model, so
+	# you'll first need to be familiar with Sequel (http://sequel.rubyforge.org/) and
+	# especially its Sequel::Model ORM.
+	#
+	# You will also probably want to refer to the Sequel::Plugins documentation for the
+	# validation_helpers[http://sequel.rubyforge.org/rdoc-plugins/classes/Sequel/Plugins/ValidationHelpers.html]
+	# and
+	# subclasses[http://sequel.rubyforge.org/rdoc-plugins/classes/Sequel/Plugins/Subclasses.html]
+	# plugins.
+	#
+	# == References
+	# * http://mongrel2.org/static/mongrel2-manual.html#x1-250003.4
+	#
+	class Config < Sequel::Model
+		include Mongrel2::Loggable
+		plugin :validation_helpers
+		plugin :subclasses
+		# Configuration defaults
+		DEFAULTS = {
+			:configdb => Mongrel2::DEFAULT_CONFIG_URI,
+		}
+		# The Pathname of the data directory
+		DATA_DIR = if Gem.datadir( 'mongrel2' )
+				Pathname( Gem.datadir('mongrel2') )
+			else
+				Pathname( __FILE__ ).dirname.parent.parent + 'data/mongrel2'
+			end
+		# The Pathname of the SQL file used to create the config database
+		CONFIG_SQL    = DATA_DIR + 'config.sql'
+		# The Pathname of the SQL file used to add default mimetypes mappings to the config
+		# database
+		MIMETYPES_SQL = DATA_DIR + 'mimetypes.sql'
+		# Register this class as configurable if Configurability is loaded.
+		if defined?( Configurability )
+			extend Configurability
+			config_key :mongrel2
+		end
+		### Return a bound Method object to the Sequel constructor of choice for the
+		### config DB. This is used to choose either 'amalgalite' or 'sqlite3', preferring
+		### the former.
+		def self::adapter_method
+			if defined?( ::Amalgalite )
+				return Sequel.method( :amalgalite )
+			else
+				return Sequel.method( :sqlite )
+			end
+		end
+		### Return a Sequel::Database for an in-memory database via the available SQLite library
+		def self::in_memory_db
+			# Just calling either .amalgalite or .sqlite returns an in-memory DB
+			return self.adapter_method.call
+		end
+		### Configurability API -- called when the configuration is loaded with the
+		### 'mongrel2' section of the config file if there is one. This method can also be used
+		### without Configurability by passing an object that can be merged with
+		### Mongrel2::Config::DEFAULTS.
+		def self::configure( config={} )
+			config = DEFAULTS.merge( config )
+			if config[ :configdb ]
+				self.db = self.adapter_method.call( config[:configdb] )
+			end
+		end
+		### Reset the database connection that all model objects will use to +newdb+, which should
+		### be a Sequel::Database.
+		def self::db=( newdb )
+			super
+			if self == Mongrel2::Config
+				Mongrel2.log.debug "Resetting database connection for %d config classes to: %p" %
+					[ self.descendents.length, newdb ]
+				self.descendents.each {|subclass| subclass.db = newdb }
+			end
+		end
+		### Return the Array of currently-configured servers in the config database as
+		### Mongrel2::Config::Server objects.
+		def self::servers
+			return Mongrel2::Config::Server.all
+		end
+		### Return the contents of the configuration schema SQL file.
+		def self::load_config_schema
+			return CONFIG_SQL.read
+		end
+		### Return the contents of the mimetypes SQL file.
+		def self::load_mimetypes_sql
+			return MIMETYPES_SQL.read
+		end
+		### Returns +true+ if the config database has been installed. This currently only
+		### checks to see if the 'server' table exists for the sake of speed.
+		def self::database_initialized?
+			return self.db.table_exists?( :server )
+		end
+		### Initialize the currently-configured database (if it hasn't been already)
+		def self::init_database
+			return if self.database_initialized?
+			return self.init_database!
+		end
+		### Initialize the currently-configured database, dropping any existing tables.
+		def self::init_database!
+			sql = self.load_config_schema
+			mimetypes_sql = self.load_mimetypes_sql
+			Mongrel2.log.warn "Installing config schema."
+			self.db.execute_ddl( sql )
+			self.db.run( mimetypes_sql )
+			# Force the associations to reset
+			self.db = db
+		end
+		### Return a Pathname object for the current database, or nil if the current
+		### database is an in-memory one.
+		def self::pathname
+			dburi = URI( self.db.uri )
+			pathname = dburi.path
+			pathname.slice!( 0, 1 ) if pathname.start_with?( '/' )
+			return nil if pathname.empty?
+			return Pathname( pathname )
+		end
+	end # class Config
+	### Factory method that creates subclasses of Mongrel2::Config.
+	def self::Config( source )
+		unless Sequel::Model::ANONYMOUS_MODEL_CLASSES.key?( source )
+			anonclass = nil
+		 	if source.is_a?( Sequel::Database )
+				anonclass = Class.new( Mongrel2::Config )
+				anonclass.db = source
+			else
+				anonclass = Class.new( Mongrel2::Config ).set_dataset( source )
+			end
+			Sequel::Model::ANONYMOUS_MODEL_CLASSES[ source ] = anonclass
+		end
+		return Sequel::Model::ANONYMOUS_MODEL_CLASSES[ source ]
+	end
+	require 'mongrel2/config/directory'
+	require 'mongrel2/config/handler'
+	require 'mongrel2/config/host'
+	require 'mongrel2/config/proxy'
+	require 'mongrel2/config/route'
+	require 'mongrel2/config/server'
+	require 'mongrel2/config/setting'
+	require 'mongrel2/config/mimetype'
+	require 'mongrel2/config/log'
+	require 'mongrel2/config/statistic'
+	require 'mongrel2/config/dsl'
+end # module Mongrel2