RubyGems - siffer - Versions diffs - 0.0.4 - Mend

siffer 0.0.4

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 (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

data/doc/rdoc/index.html ADDED

@@ -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