RubyGems - siffer - Versions diffs - 0.0.4 - Mend

siffer 0.0.4

Files changed (91) hide show

data/LICENSE +20 -0
data/README.rdoc +65 -0
data/Rakefile +64 -0
data/bin/siffer +71 -0
data/doc/SIF ImplementationSpecification.pdf +0 -0
data/doc/rdoc/classes/Siffer.html +374 -0
data/doc/rdoc/classes/Siffer/Agent.html +296 -0
data/doc/rdoc/classes/Siffer/Container.html +286 -0
data/doc/rdoc/classes/Siffer/Messages.html +141 -0
data/doc/rdoc/classes/Siffer/Messages/Ack.html +216 -0
data/doc/rdoc/classes/Siffer/Messages/Acl.html +160 -0
data/doc/rdoc/classes/Siffer/Messages/Error.html +248 -0
data/doc/rdoc/classes/Siffer/Messages/Message.html +359 -0
data/doc/rdoc/classes/Siffer/Messages/Message/Header.html +181 -0
data/doc/rdoc/classes/Siffer/Messages/Register.html +257 -0
data/doc/rdoc/classes/Siffer/Messages/RequestBody.html +300 -0
data/doc/rdoc/classes/Siffer/Messages/Status.html +269 -0
data/doc/rdoc/classes/Siffer/Messaging.html +331 -0
data/doc/rdoc/classes/Siffer/Protocol.html +388 -0
data/doc/rdoc/classes/Siffer/Protocol/NonPostRequest.html +111 -0
data/doc/rdoc/classes/Siffer/Protocol/UnknownPath.html +111 -0
data/doc/rdoc/classes/Siffer/Registration.html +391 -0
data/doc/rdoc/classes/Siffer/Request.html +209 -0
data/doc/rdoc/classes/Siffer/RequestLogger.html +211 -0
data/doc/rdoc/classes/Siffer/Response.html +182 -0
data/doc/rdoc/classes/Siffer/Server.html +242 -0
data/doc/rdoc/created.rid +1 -0
data/doc/rdoc/files/LICENSE.html +129 -0
data/doc/rdoc/files/README_rdoc.html +184 -0
data/doc/rdoc/files/lib/agent_rb.html +101 -0
data/doc/rdoc/files/lib/container_rb.html +108 -0
data/doc/rdoc/files/lib/messages/ack_rb.html +101 -0
data/doc/rdoc/files/lib/messages/acl_rb.html +101 -0
data/doc/rdoc/files/lib/messages/error_rb.html +101 -0
data/doc/rdoc/files/lib/messages/message_rb.html +101 -0
data/doc/rdoc/files/lib/messages/register_rb.html +101 -0
data/doc/rdoc/files/lib/messages/request_body_rb.html +101 -0
data/doc/rdoc/files/lib/messages/status_rb.html +101 -0
data/doc/rdoc/files/lib/messages_rb.html +114 -0
data/doc/rdoc/files/lib/messaging_rb.html +101 -0
data/doc/rdoc/files/lib/protocol_rb.html +101 -0
data/doc/rdoc/files/lib/registration_rb.html +101 -0
data/doc/rdoc/files/lib/request_logger_rb.html +101 -0
data/doc/rdoc/files/lib/request_rb.html +101 -0
data/doc/rdoc/files/lib/response_rb.html +101 -0
data/doc/rdoc/files/lib/server_rb.html +101 -0
data/doc/rdoc/files/lib/siffer_rb.html +115 -0
data/doc/rdoc/fr_class_index.html +47 -0
data/doc/rdoc/fr_file_index.html +46 -0
data/doc/rdoc/fr_method_index.html +96 -0
data/doc/rdoc/index.html +24 -0
data/doc/rdoc/rdoc-style.css +208 -0
data/lib/agent.rb +43 -0
data/lib/container.rb +96 -0
data/lib/messages.rb +7 -0
data/lib/messages/ack.rb +43 -0
data/lib/messages/acl.rb +25 -0
data/lib/messages/error.rb +174 -0
data/lib/messages/message.rb +71 -0
data/lib/messages/register.rb +60 -0
data/lib/messages/request_body.rb +66 -0
data/lib/messages/status.rb +55 -0
data/lib/messaging.rb +96 -0
data/lib/protocol.rb +159 -0
data/lib/registration.rb +87 -0
data/lib/request.rb +25 -0
data/lib/request_logger.rb +31 -0
data/lib/response.rb +26 -0
data/lib/server.rb +40 -0
data/lib/siffer.rb +44 -0
data/spec/agent_spec.rb +53 -0
data/spec/cli_spec.rb +40 -0
data/spec/container_spec.rb +103 -0
data/spec/default_agent +6 -0
data/spec/default_server +5 -0
data/spec/message_specs/ack_spec.rb +28 -0
data/spec/message_specs/error_spec.rb +24 -0
data/spec/message_specs/header_spec.rb +25 -0
data/spec/message_specs/message_spec.rb +57 -0
data/spec/message_specs/register_spec.rb +86 -0
data/spec/message_specs/request_body_spec.rb +58 -0
data/spec/message_specs/status_spec.rb +25 -0
data/spec/messaging_spec.rb +88 -0
data/spec/protocol_spec.rb +49 -0
data/spec/registration_spec.rb +33 -0
data/spec/request_logger_spec.rb +15 -0
data/spec/request_spec.rb +10 -0
data/spec/response_spec.rb +24 -0
data/spec/server_spec.rb +35 -0
data/spec/spec_helper.rb +26 -0
metadata +191 -0

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd">
+<!--
+    Siffer == h3o(software) SIF
+  -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>Siffer == h3o(software) SIF</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+</head>
+<frameset rows="20%, 80%">
+    <frameset cols="25%,35%,45%">
+        <frame src="fr_file_index.html"   title="Files" name="Files" />
+        <frame src="fr_class_index.html"  name="Classes" />
+        <frame src="fr_method_index.html" name="Methods" />
+    </frameset>
+    <frame src="files/README_rdoc.html" name="docwin" />
+</frameset>
+</html>

data/doc/rdoc/rdoc-style.css ADDED

@@ -0,0 +1,208 @@
+body {
+    font-family: Verdana,Arial,Helvetica,sans-serif;
+    font-size:   90%;
+    margin: 0;
+    margin-left: 40px;
+    padding: 0;
+    background: white;
+}
+h1,h2,h3,h4 { margin: 0; color: #efefef; background: transparent; }
+h1 { font-size: 150%; }
+h2,h3,h4 { margin-top: 1em; }
+a { background: #eef; color: #039; text-decoration: none; }
+a:hover { background: #039; color: #eef; }
+/* Override the base stylesheet's Anchor inside a table cell */
+td > a {
+  background: transparent;
+  color: #039;
+  text-decoration: none;
+}
+/* and inside a section title */
+.section-title > a {
+  background: transparent;
+  color: #eee;
+  text-decoration: none;
+}
+/* === Structural elements =================================== */
+div#index {
+    margin: 0;
+    margin-left: -40px;
+    padding: 0;
+    font-size: 90%;
+}
+div#index a {
+    margin-left: 0.7em;
+}
+div#index .section-bar {
+   margin-left: 0px;
+   padding-left: 0.7em;
+   background: #ccc;
+   font-size: small;
+}
+div#classHeader, div#fileHeader {
+    width: auto;
+    color: white;
+    padding: 0.5em 1.5em 0.5em 1.5em;
+    margin: 0;
+    margin-left: -40px;
+    border-bottom: 3px solid #006;
+}
+div#classHeader a, div#fileHeader a {
+    background: inherit;
+    color: white;
+}
+div#classHeader td, div#fileHeader td {
+    background: inherit;
+    color: white;
+}
+div#fileHeader {
+    background: #057;
+}
+div#classHeader {
+    background: #048;
+}
+.class-name-in-header {
+  font-size:  180%;
+  font-weight: bold;
+}
+div#bodyContent {
+    padding: 0 1.5em 0 1.5em;
+}
+div#description {
+    padding: 0.5em 1.5em;
+    background: #efefef;
+    border: 1px dotted #999;
+}
+div#description h1,h2,h3,h4,h5,h6 {
+    color: #125;;
+    background: transparent;
+}
+div#validator-badges {
+    text-align: center;
+}
+div#validator-badges img { border: 0; }
+div#copyright {
+    color: #333;
+    background: #efefef;
+    font: 0.75em sans-serif;
+    margin-top: 5em;
+    margin-bottom: 0;
+    padding: 0.5em 2em;
+}
+/* === Classes =================================== */
+table.header-table {
+    color: white;
+    font-size: small;
+}
+.type-note {
+    font-size: small;
+    color: #DEDEDE;
+}
+.xxsection-bar {
+    background: #eee;
+    color: #333;
+    padding: 3px;
+}
+.section-bar {
+   color: #333;
+   border-bottom: 1px solid #999;
+    margin-left: -20px;
+}
+.section-title {
+    background: #79a;
+    color: #eee;
+    padding: 3px;
+    margin-top: 2em;
+    margin-left: -30px;
+    border: 1px solid #999;
+}
+.top-aligned-row {  vertical-align: top }
+.bottom-aligned-row { vertical-align: bottom }
+/* --- Context section classes ----------------------- */
+.context-row { }
+.context-item-name { font-family: monospace; font-weight: bold; color: black; }
+.context-item-value { font-size: small; color: #448; }
+.context-item-desc { color: #333; padding-left: 2em; }
+/* --- Method classes -------------------------- */
+.method-detail {
+    background: #efefef;
+    padding: 0;
+    margin-top: 0.5em;
+    margin-bottom: 1em;
+    border: 1px dotted #ccc;
+}
+.method-heading {
+  color: black;
+  background: #ccc;
+  border-bottom: 1px solid #666;
+  padding: 0.2em 0.5em 0 0.5em;
+}
+.method-signature { color: black; background: inherit; }
+.method-name { font-weight: bold; }
+.method-args { font-style: italic; }
+.method-description { padding: 0 0.5em 0 0.5em; }
+/* --- Source code sections -------------------- */
+a.source-toggle { font-size: 90%; }
+div.method-source-code {
+    background: #262626;
+    color: #ffdead;
+    margin: 1em;
+    padding: 0.5em;
+    border: 1px dashed #999;
+    overflow: hidden;
+}
+div.method-source-code pre { color: #ffdead; overflow: hidden; }
+/* --- Ruby keyword styles --------------------- */
+.standalone-code { background: #221111; color: #ffdead; overflow: hidden; }
+.ruby-constant  { color: #7fffd4; background: transparent; }
+.ruby-keyword { color: #00ffff; background: transparent; }
+.ruby-ivar    { color: #eedd82; background: transparent; }
+.ruby-operator  { color: #00ffee; background: transparent; }
+.ruby-identifier { color: #ffdead; background: transparent; }
+.ruby-node    { color: #ffa07a; background: transparent; }
+.ruby-comment { color: #b22222; font-weight: bold; background: transparent; }
+.ruby-regexp  { color: #ffa07a; background: transparent; }
+.ruby-value   { color: #7fffd4; background: transparent; }

data/lib/agent.rb ADDED

@@ -0,0 +1,43 @@
+module Siffer
+  class Agent
+    include Siffer::Protocol
+    attr_reader :name, :host, :port, :admin, :server
+    def initialize(options = {})
+      raise "Server URL(s) required" unless options.include? "servers"
+      @server = options["servers"]
+      raise "Administration URL required" unless options.include? "admin"
+      @admin = options["admin"]
+      @name = options["name"] || "Default Agent"
+      @host = options["host"] || "localhost"
+      @port = options["port"] || 8300
+      @registered = false
+    end
+    def call(env)
+      with_each_request(env) do
+      end
+    end
+    def wake_up
+      self_register unless registered?
+    end
+    def self_register
+      registration = Siffer::Messages::Register.new(name, name)
+      response = Response.from(server,registration)
+      # OOOOH BAAAAD ====> Check the ACL please ! Make a parser !
+      @registered = response.ok?
+    end
+    def registered?
+      @registered
+    end
+  end
+end

data/lib/container.rb ADDED

@@ -0,0 +1,96 @@
+module Siffer
+  class Container
+    attr_reader :environment, :component, :name, :host, :port, :log, :pid
+    def initialize(options = {})
+      raise "Component Configuration missing" if options[:config].nil?
+      raise "Environment missing" if options[:environment].nil?
+      @environment = options[:environment]
+      config = options[:config]
+      type = config.include?("agent") ? "agent" : "server"
+      @component = (type == "agent") ?
+                  Siffer::Agent.new(config["agent"]) :
+                  Siffer::Server.new(config["server"])
+      @name = config[type]["name"]
+      @host = config[type]["host"]
+      @port = config[type]["port"]
+      @daemonize = options[:daemonize]
+      @pid = options[:pid]
+      @log = options[:log]
+    end
+    def daemonized?
+      @daemonize
+    end
+    def run
+      daemonize
+      server = best_available_server
+      options = {
+        :Host => host,
+        :Port => port
+      }
+      component.wake_up if component.respond_to?("wake_up")
+      app = component_wrapped_in_environment
+      server.run app, options
+    end
+    def stop
+      pid_id = open("#{@pid}").read.to_i
+      Process.kill(15,pid_id)
+      File.delete(@pid) if File.exist?(@pid)
+    end
+    private
+      def best_available_server
+        begin
+          server = Rack::Handler::Mongrel
+        rescue
+          server = Rack::Handler::WEBrick
+        end
+      end
+      def component_wrapped_in_environment
+        case environment
+        when "development"
+          builder = Rack::Builder.new
+          builder.use(Siffer::RequestLogger)
+          builder.use(Rack::CommonLogger)
+          builder.run(@component)
+          builder
+        when "deployment"
+          builder = Rack::Builder.new
+          builder.use(Rack::CommonLogger)
+          builder.run(@component)
+          builder
+        when "test": component
+        when "none": component
+        end
+      end
+      def daemonize
+        if daemonized?
+          if RUBY_PLATFORM !~ /mswin/
+            require 'daemons/daemonize'
+            Daemonize.daemonize(@log)
+          else
+            # How to tell about the problem of no Daemon on WINDOWS
+          end
+          write_pid_file
+        end
+      end
+      def write_pid_file
+        if RUBY_PLATFORM !~ /mswin/
+          open(@pid,"w") do |f|
+            f.write(Process.pid)
+            File.chmod(0644, @pid)
+          end
+        end
+      end
+  end
+end

data/lib/messages.rb ADDED

@@ -0,0 +1,7 @@
+require 'messages/error'
+require 'messages/status'
+require 'messages/acl'
+require 'messages/request_body'
+require 'messages/message'
+require 'messages/ack'
+require 'messages/register'

data/lib/messages/ack.rb ADDED

@@ -0,0 +1,43 @@
+module Siffer
+  module Messages
+    # Acknowledge Message
+    # Used by Server and Agent to "acknowledge" receipt of a message. Allows
+    # Erorr and Status messages to be injected into the body.
+    class Ack < Message
+      attr_reader :original_msg
+      #
+      def initialize(source, original, options = {})
+        raise ArgumentError, "Original message is required" unless original
+        super(source, options)
+        @original_msg = original
+        @error = options[:error] || nil
+        @status = options[:status] || nil
+      end
+      def content
+        body do |ack|
+          ack.SIF_Ack() { |xml|
+            put_header_into xml
+            if @original_msg.source_id.nil? or @original_msg.source_id == ""
+              xml.SIF_OriginalSourceId
+            else
+              xml.SIF_OriginalSourceId(@original_msg.source_id)
+            end
+            if @original_msg.msg_id.nil? or @original_msg.msg_id == ""
+              xml.SIF_OriginalMsgId
+            else
+              xml.SIF_OriginalMsgId(@original_msg.msg_id)
+            end
+            xml << @error.read unless @error.nil?
+            xml << @status.read unless @status.nil?
+          }
+        end
+      end
+    end
+  end
+end

data/lib/messages/acl.rb ADDED

@@ -0,0 +1,25 @@
+module Siffer
+  module Messages
+    class Acl
+      # This class roles through all the objects in all the contexts in
+      # the zone to provide a list of allowed actions on each object per
+      # registered agent
+      def read
+        xml = Builder::XmlMarkup.new
+        xml.SIF_AgentAcl { |xml|
+          # each one of these would collect all objects for each context
+          xml.SIF_ProvideAccess
+          xml.SIF_SubscribeAccess
+          xml.SIF_PublishAddAccess
+          xml.SIF_PublishChangeAccess
+          xml.SIF_PublishDeleteAccess
+          xml.SIF_RequestAccess
+          xml.SIF_RespondAccess
+        }
+      end
+    end
+  end
+end