strelka 0.0.1pre4 → 0.0.1.pre129

data/IDEAS.textile

@@ -1,174 +0,0 @@
-h1. Strelka Ideas
-
-h2. Leash
-
-The main command-line interface to Strelka. It is used to browse and edit Mongrel2 config
-databases, set up a Mongrel2 cluster, join an existing cluster, etc.
-
-h3. Browsing/Editing a Mongrel2 Config
-
-Running 'leash' with no sub-commands starts it up in shell
-mode:
-
-	$ leash config.sqlite
-	Opening shell for config DB: config.sqlite
-
-Create a new server:
-
-    config.sqlite> mkserver test
-    Creating a new server (2379AA53-9688-4831-9C8B-9E70FE8A7EB7)
-
-Show the list of Server configurations:
-
-    config.sqlite> ls
-   
-    -- Servers:
-    main {B5764D79-5BD5-4F43-8FCA-CBB7FD85C4EE}
-    test {2379AA53-9688-4831-9C8B-9E70FE8A7EB7}
-    admin {90A2890D-F386-4841-B664-5DD7FFE97C53}
-
-Now 'cd' into one of them and show its config, and any Hosts
-that live under it:
-    
-    config.sqlite> cd main
-    config.sqlite/main> ls
-
-    -- Server [main] {B5764D79-5BD5-4F43-8FCA-CBB7FD85C4EE}
-    Name:         'Arrow Bootstrap'
-    Chroot:       '/var/www'
-    Access log:   '/logs/access.log'
-    Error log:     '/logs/error.log'
-    Default Host: 'localhost'
-    PID File:     '/run/mongrel2.pid'
-    Port:         3667
-    
-	-- Hosts:
-    localhost
-    deveiate /(.*).deveiate.org/
-
-Change into one of the hosts and show it:
-
-    config.sqlite/main> cd localhost
-    config.sqlite/main/localhost> ls
-
-	-- Host [localhost]
-    
-	ID: 1
-	Matching Rule: /(.*).deveiate.org/
-	Maintenance Mode: no
-
-    -- Routes
-    dir     /          -> /public
-    dir     .png       -> /images (reverse)
-    dir     .css       -> /css (reverse)
-    dir     .js        -> /js (reverse)
-    proxy   /proxy     -> google.com:80
-    handler /admin     -> D613E7EE-E2EB-4699-A200-5C8ECAB45D5E
-              tcp://127.0.0.1:9998 - tcp://127.0.0.1:9997
-    handler @directory -> B7EFA46D-FEE4-432B-B80F-E8A9A2CC6FDB
-              tcp://127.0.0.1:9996 - tcp://127.0.0.1:9995
-    handler /directory -> B7EFA46D-FEE4-432B-B80F-E8A9A2CC6FDB
-              tcp://127.0.0.1:9996 - tcp://127.0.0.1:9995
-
-...etc...
-
-
-h3. Setting Up A Mongrel2 Cluster
-
-Leash also comes with subcommands for interacting with Mongrel2. You can start
-a new cluster using the 'setup' subcommand:
-
-	server1$ leash setup 
-	Creating bootstrap config...
-	Starting mongrel2...
-	Starting up control app...
-	Okay, point a browser at http://localhost:37772/
-
-At this point, you can either use further leash commands, or use the web
-interface:
-
-    server1$ open http://localhost:37772/
-
-
-
-h3. Join a Mongrel2 Cluster
-
-Once you have the first node set up, you need only point 'leash' to the admin
-server running on the first host to set up and automatically configure
-additional Mongrel2 front-ends:
-
-	server2$ leash join server1
-
-This uses a 0MQ service running from the admin server that publishes the
-config using Mongrel2's "config from anything" protocol, so when Mongrel2
-itself supports the 'zmq.so' plugin, you won't even need a local SQLite
-database.
-
-
-h2. Strelka Applications
-
-Strelka applications may be written in one of three styles: App, Process, or Service. Each of these can be mapped to one or more Mongrel2 'handler' routes, and may have one or more Filters applied to it to provide pre- and post-processing for requests and responses.
-
-An App is a stateless handler that contains routes that are matched against a requests's HTTP verb and URL, and an appropriate routine invoked.
-
-A Process is a stateful handler intended to make stateful processes with a lot of user interaction easy to write.
-
-A Service is an easy way of creating a REST-style service for one or more resources.
-
-
-h3. Routes
-
-Routed methods are given a Strelka::Request object, and are expected to return
-either a Strelka::Response or something that can be made into one.
-
-	class HelloWorld < Strelka::App
-		get do |req|
-			return req.response << 'Hello, World!'
-		end
-	end # class HelloWorld
-
-h3. Parameters
-
-Routes can accept parameters in two ways: via the URI path, and via the query
-string.
-
-_We may add other ways later, e.g., via structured entity bodies
-like JSON, XML, YAML, etc_.
-
-The application can declare parameters globally, and then override them on a
-per-route basis:
-
-	class UserManager < Strelka::App
-
-		param :username, /\w+/, :required, :untaint
-		param :id, /\d+/
-
-		# :username gets validated and merged into query args; URI parameters
-		# clobber query params
-		get '/info/:username', :params => { :id => /[XRT]\d{4}-\d{8}/ } do |req|
-			req.params_okay?
-			req[:username]
-			req.values_at( :id, :username )
-			req.params.username
-			req.matchdata[ :username ] # => MatchData object
-
-			req.validation_errors
-		end
-
-	end # class UserManager
-
-
-
-h3. Content-negotiation
-
-Application responses are set to be of @Content-type@ 'application/octet-stream'
-and no @Content-encoding@ by default. You can change this default via
-declaratives:
-
-    class BrowserApp < Strelka::App
-        content_type 'text/html'
-        content_encoding 'UTF-8'
-
-        ...
-    end
-

data/data/strelka/apps/strelka-admin

@@ -1,65 +0,0 @@
-#!/usr/bin/env ruby
-
-require 'pathname'
-require 'inversion'
-require 'strelka'
-
-# The Strelka admin web console.
-class Strelka::AdminConsole < Strelka::App
-	plugins :templating, :routing
-
-	default_content_type 'text/html'
-
-	layout 'layout.tmpl'
-	templates \
-		:console => 'admin/console.tmpl'
-
-
-	### Initialize some application data.
-	def initialize( * )
-		super
-
-		Mongrel2.logger = Strelka.logger
-		Inversion.logger = Strelka.logger
-		Configurability.logger = Strelka.logger
-
-		@control = Mongrel2::Control.new
-	end
-
-
-	# GET / -- console view
-	get do |req|
-		tmpl = self.template( :console )
-		tmpl.control = @control
-		tmpl.servers = Mongrel2::Config.servers
-
-		tmpl.strelka_version = Strelka.version_string( true )
-		tmpl.mongrel2_version = Mongrel2.version_string( true )
-		tmpl.inversion_version = Inversion.version_string( true )
-
-		return tmpl
-	end
-
-end # class Strelka::AdminConsole
-
-if __FILE__ == $0
-	datadir = Pathname( __FILE__ ).dirname.parent
-	templatedir = datadir + 'templates'
-
-	# Log to the screen if STDERR is opened to one
-	if $stderr.tty?
-		Strelka.logger = Logger.new( $stderr )
-	else
-		Strelka.logger = Logger.new( 'admin-console.log' )
-	end
-
-	Strelka.logger.level = $VERBOSE ? Logger::DEBUG : Logger::INFO
-
-	Inversion::Template.configure( :template_paths => [templatedir] )
-	Mongrel2::Config.configure( :configdb => Strelka::Constants::DEFAULT_CONFIG_URI )
-
-	Strelka::AdminConsole.run( 'admin-console' )
-end
-
-
-

data/data/strelka/apps/strelka-setup

@@ -1,26 +0,0 @@
-#!/usr/bin/env ruby
-
-require 'inversion'
-require 'strelka'
-
-# The Strelka setup web application.
-class Strelka::SetupProcess < Strelka::Process
-
-	layout 'setup/layout.tmpl'
-
-	views :step1 => 'setup/step1',
-	      :step2 => 'setup/step2'
-
-
-	### Progress through the setup process.
-	def main( req )
-		params = show( :step1 )
-		params = show( :step2, params )
-		
-	end
-
-end # class Strelka::AdminConsole
-
-
-Strelka::SetupProcess.run( 'strelka-setup' )
-

data/data/strelka/bootstrap-config.rb

@@ -1,34 +0,0 @@
-#!/usr/bin/env ruby
-
-require 'mongrel2/config'
-include Mongrel2::Config::DSL
-
-require 'strelka/constants'
-include Strelka::Constants
-
-# This is the config that's loaded by 'leash setup' to get the admin server
-# up and running.
-
-server 'admin' do
-    name 'adminserver'
-	port DEFAULT_ADMIN_PORT
-	access_log '/logs/admin-access.log'
-	error_log '/logs/admin-error.log'
-	pid_file '/run/admin.pid'
-
-	default_host 'localhost'
-
-    host 'localhost' do
-        route '/', handler( 'tcp://127.0.0.1:19999', 'admin-console' )
-
-		route '/css',    directory( 'data/strelka/static/css/', 'base.css', 'text/css' )
-		route '/images', directory( 'data/strelka/static/images/' )
-		route '/fonts',  directory( 'data/strelka/static/fonts/' )
-		route '/js',     directory( 'data/strelka/static/js/', 'index.js', 'text/javascript' )
-    end
-end
-
-setting "control_port", 'ipc://run/admin-control'
-
-mkdir_p 'logs'
-mkdir_p 'run'

data/data/strelka/templates/admin/console.tmpl

@@ -1,21 +0,0 @@
-<?publish title ?>Admin Console<?end publish ?>
-
-<p>The admin console. Is you is, or is you isn't?</p>
-
-<ul>
-	<li>Strelka: <?attr strelka_version ?></li>
-	<li>Mongrel2: <?attr mongrel2_version ?></li>
-	<li>Inversion: <?attr inversion_version ?></li>
-</ul>
-
-
-<section id="mongrel2-status">
-	<header>
-		<h1>Mongrel Status</h1>
-	</header>
-
-	<table>
-		
-	</table>
-</section>
-

data/data/strelka/templates/layout.tmpl

@@ -1,30 +0,0 @@
-<!doctype html>
-<head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
-
-  <title>Strelka: <?subscribe title ?></title>
-  <meta name="author" content="Michael Granger">
-
-  <meta name="viewport" content="width=device-width,initial-scale=1">
-
-	<link rel="stylesheet" href="/css/master.css" type="text/css" media="screen"
-		title="no title" charset="utf-8" />
-</head>
-
-<body>
-
-  <header>
-		<h1><?subscribe title ?></h1>
-  </header>
-
-  <section id="dump">
-		<?attr body ?>
-  </section>
-
-  <footer>
-		<p><tt>$Id$</tt></p>
-  </footer>
-
-</body>
-</html>

data/lib/strelka/process.rb

@@ -1,19 +0,0 @@
-#!/usr/bin/env ruby
-
-require 'mongrel2/handler'
-require 'strelka' unless defined?( Strelka )
-
-
-# The process-style handler base class.
-class Strelka::Process < Mongrel2::Handler
-	include Strelka::Loggable,
-	        Strelka::Constants
-
-	### Create a new Process.
-	def initialize( * )
-		@
-	end
-
-
-end # class Strelka::Process
-