LanGrove 0.0.1

data/.rspec

@@ -0,0 +1 @@
+--color

data/.rvmrc

@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+
+# This is an RVM Project .rvmrc file, used to automatically load the ruby
+# development environment upon cd'ing into the directory
+
+# First we specify our desired <ruby>[@<gemset>], the @gemset name is optional.
+environment_id="ruby-1.9.2-p0@langrove"
+
+#
+# Uncomment following line if you want options to be set only for given project.
+#
+# PROJECT_JRUBY_OPTS=( --1.9 )
+
+#
+# First we attempt to load the desired environment directly from the environment
+# file. This is very fast and efficient compared to running through the entire
+# CLI and selector. If you want feedback on which environment was used then
+# insert the word 'use' after --create as this triggers verbose mode.
+#
+if [[ -d "${rvm_path:-$HOME/.rvm}/environments" \
+  && -s "${rvm_path:-$HOME/.rvm}/environments/$environment_id" ]]
+then
+  \. "${rvm_path:-$HOME/.rvm}/environments/$environment_id"
+
+  if [[ -s "${rvm_path:-$HOME/.rvm}/hooks/after_use" ]]
+  then
+    . "${rvm_path:-$HOME/.rvm}/hooks/after_use"
+  fi
+else
+  # If the environment file has not yet been created, use the RVM CLI to select.
+  if ! rvm --create use  "$environment_id"
+  then
+    echo "Failed to create RVM environment '${environment_id}'."
+    return 1
+  fi
+fi
+
+#
+# If you use an RVM gemset file to install a list of gems (*.gems), you can have
+# it be automatically loaded. Uncomment the following and adjust the filename if
+# necessary.
+#
+# filename=".gems"
+# if [[ -s "$filename" ]]
+# then
+#   rvm gemset import "$filename" | grep -v already | grep -v listed | grep -v complete | sed '/^$/d'
+# fi
+
+# If you use bundler, this might be useful to you:
+# if command -v bundle && [[ -s Gemfile ]]
+# then
+#   bundle install
+# fi
+
+if [[ $- == *i* ]] # check for interactive shells
+then
+    echo "Using: $(tput setaf 2)$GEM_HOME$(tput sgr0)" # show the user the ruby and gemset they are using in green
+else 
+	echo "Using: $GEM_HOME" # don't use colors in interactive shells
+fi
+
+

data/.watchr

@@ -0,0 +1,19 @@
+def run_spec(file)
+  unless File.exist?(file)
+    puts "#{file} does not exist"
+    return
+  end
+
+  puts "Running #{file}"
+  system "rspec #{file}"
+  puts
+end
+
+watch("spec/.*/*_spec.rb") do |match|
+  run_spec match[0]
+end
+
+watch("lib/(.*/*).rb") do |match|
+  puts match
+  run_spec %{spec/#{match[1]}_spec.rb}
+end

data/Gemfile

@@ -0,0 +1,16 @@
+source :gemcutter
+source "http://rubygems.org"
+
+gem 'watchr'
+gem 'rspec'
+
+# daemon-kit
+gem 'daemon-kit'
+gem 'eventmachine'
+gem 'em-http-request'
+gem 'awesome_print'
+
+gem 'eventmachine_httpserver'
+
+gem 'resque'
+gem 'rake'

data/Gemfile.lock

@@ -0,0 +1,61 @@
+GEM
+  remote: http://rubygems.org/
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.2.7)
+    awesome_print (1.0.2)
+    daemon-kit (0.1.8.2)
+      eventmachine (>= 0.12.10)
+      safely (>= 0.3.1)
+    diff-lcs (1.1.3)
+    em-http-request (0.3.0)
+      addressable (>= 2.0.0)
+      escape_utils
+      eventmachine (>= 0.12.9)
+    escape_utils (0.2.4)
+    eventmachine (0.12.10)
+    eventmachine_httpserver (0.2.1)
+    multi_json (1.3.2)
+    rack (1.4.1)
+    rack-protection (1.2.0)
+      rack
+    rake (0.8.7)
+    redis (2.2.2)
+    redis-namespace (1.0.3)
+      redis (< 3.0.0)
+    resque (1.20.0)
+      multi_json (~> 1.0)
+      redis-namespace (~> 1.0.2)
+      sinatra (>= 0.9.2)
+      vegas (~> 0.1.2)
+    rspec (2.9.0)
+      rspec-core (~> 2.9.0)
+      rspec-expectations (~> 2.9.0)
+      rspec-mocks (~> 2.9.0)
+    rspec-core (2.9.0)
+    rspec-expectations (2.9.1)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.9.0)
+    safely (0.3.1)
+    sinatra (1.3.2)
+      rack (~> 1.3, >= 1.3.6)
+      rack-protection (~> 1.2)
+      tilt (~> 1.3, >= 1.3.3)
+    tilt (1.3.3)
+    vegas (0.1.11)
+      rack (>= 1.0.0)
+    watchr (0.7)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  awesome_print
+  daemon-kit
+  em-http-request
+  eventmachine
+  eventmachine_httpserver
+  rake
+  resque
+  rspec
+  watchr

data/Rakefile

@@ -0,0 +1,17 @@
+$LOAD_PATH.unshift 'lib'
+
+desc "Publish a new version to ruby-gems.org"
+task :publish do
+  require 'langrove/version'
+
+  sh "gem build langrove.gemspec"
+  sh "gem push langrove-#{LanGrove::Version}.gem"
+
+  #sh "git tag v#{LanGrove::Version}"
+  #sh "git push origin v#{Resque::Version}"
+  #sh "git push origin master"
+  #sh "git clean -fd"
+  
+#  exec "rake documentation"
+
+end

data/bin/datagram_example

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+DAEMON_NAME = File.basename $0
+require File.expand_path('../../config/environment',  __FILE__)
+DaemonKit::Application.exec( DAEMON_ROOT + '/libexec/daemon.rb' )

data/config/boot.rb

@@ -0,0 +1,64 @@
+# Don't change this file!
+# Configure your daemon in config/environment.rb
+
+DAEMON_ROOT = "#{File.expand_path(File.dirname(__FILE__))}/.." unless defined?( DAEMON_ROOT )
+
+require "rubygems"
+require "bundler/setup"
+
+module DaemonKit
+  class << self
+    def boot!
+      unless booted?
+        pick_boot.run
+      end
+    end
+
+    def booted?
+      defined? DaemonKit::Initializer
+    end
+
+    def pick_boot
+      (vendor_kit? ? VendorBoot : GemBoot).new
+    end
+
+    def vendor_kit?
+      File.exists?( "#{DAEMON_ROOT}/vendor/daemon-kit" )
+    end
+  end
+
+  class Boot
+    def run
+      load_initializer
+      DaemonKit::Initializer.run
+    end
+  end
+
+  class VendorBoot < Boot
+    def load_initializer
+      require "#{DAEMON_ROOT}/vendor/daemon-kit/lib/daemon_kit/initializer"
+    end
+  end
+
+  class GemBoot < Boot
+    def load_initializer
+      begin
+        require 'rubygems' unless defined?( ::Gem )
+        gem 'daemon-kit'
+        require 'daemon_kit/initializer'
+      rescue ::Gem::LoadError => e
+        msg = <<EOF
+
+You are missing the daemon-kit gem. Please install the following gem:
+
+sudo gem install daemon-kit
+
+EOF
+        $stderr.puts msg
+        exit 1
+      end
+    end
+  end
+end
+
+DaemonKit.boot!

data/config/daemons.yml.tmpl

@@ -0,0 +1,78 @@
+#
+# Using the daemon stubs in bin/ to spawn daemons from this
+# config file with the following guidelines.
+#
+# 1. Each daemon stub name should correspond to a sub-branch in 
+#    the daemons branch of the config.
+#
+# 2. The daemons are spawned through a generic DaemonKit based 
+#    spawner. 
+#
+# 3. Daemons log to the log/<daemon_name>.log where daemon_name
+#    exactly corresponds to the stub name.
+#
+# 4. Daemons keep a pidfile at log/<daemon_name>.pid, these are
+#    used by DaemonKit for init.d style stop|start|restart etc.
+#
+# 5. Daemons are spawned through a generic executer which late 
+#    binds the daemon runner class. Therefore, each daemon with
+#    a stub at 
+#
+#    bin/<daemon_name> 
+#  
+#    should also have a runner class defined at 
+# 
+#    lib/<daemon_name>.rb
+#
+#    which defines the class <DaemonName> with the following:
+#
+#    Mandatory
+#    =========
+#
+#    - initialize( entire_config_hash, daemon_name, logger )
+#
+#      To load up and initialize as required.
+# 
+#      It will be provided with
+#
+#      <entire_config_hash> - This entire file as a Hash
+#      <daemon_name>        - From the stub name in bin/
+#      <logger>             - An initialized logger
+# 
+#    - run()
+#
+#      The daemons 'main' loop
+#
+#    Optional
+#    ========
+# 
+#    - stop_daemon()
+#
+#      To properly handle daemon shutdown when the server gets
+#      rebooted or daemon gets restarted
+#
+#      PENDING 
+#      PENDING - reload_daemon()
+#      PENDING 
+#      PENDING   To reload the daemon after a config change without taking
+#      PENDING   down any currently connected sockets and such.
+#      PENDING 
+# 
+# 6. Each daemon config should contain reference to a Handler class.
+#  
+#    PENDING explain that later.
+# 
+#
+
+daemons:
+    datagram_example:
+        periodic: 5
+        adaptor:
+          connection: Datagram
+          iface: 127.0.0.1
+          port: 12701
+        handler: 
+            collection: Base
+            protocol: Base
+
+

data/config/environment.rb

@@ -0,0 +1,28 @@
+ENV["TZ"] = "ZA"
+#ENV['DAEMON_ENV'] ||= 'production'
+
+# Boot up
+require File.join(File.dirname(__FILE__), 'boot')
+
+# Auto-require default libraries.
+Bundler.require :default, DaemonKit.env
+
+DaemonKit::Initializer.run do |config|
+  
+  config.daemon_name = DAEMON_NAME
+
+  # Force the daemon to be killed after X seconds from asking it to
+  # config.force_kill_wait = 30
+
+  # Log backraces when a thread/daemon dies (Recommended)
+  config.backtraces = true
+  
+  #
+  # TODO: move log level into per daemon config
+  #
+     #config.log_level = :debug
+  config.log_level = :info
+     #config.log_level = :warn
+     #config.log_level = :error
+  
+end

data/lib/adaptor/base.rb

@@ -0,0 +1 @@
+require 'adaptor_base'

data/lib/adaptor/datagram.rb

@@ -0,0 +1,20 @@
+require 'adaptor/base'
+
+module Adaptor 
+  
+  class Datagram < Base
+    
+    def listen( collection )
+    
+      @logger.info "starting listen at UDP #{@iface}:#{@port}"
+      
+      EventMachine::open_datagram_socket( @iface, @port, 
+      
+        @connector ) do |connection|
+          
+          connection.handler = collection
+          
+      end
+    end
+  end
+end

data/lib/adaptor/socket_handler.rb

@@ -0,0 +1,27 @@
+require 'eventmachine'
+
+module Adaptor 
+  
+  class SocketHandler < EM::Connection
+
+    #
+    # The handler collection specified in config
+    # is bound to this attribute after connect.
+    #
+    attr_accessor :handler
+    attr_accessor :protocol
+
+    def receive_data(data)
+
+      #@handler.message( @protocol.decode( data ) )
+      @handler.message( data )
+
+      #
+      # sort out application layer ACKs later
+      # currently only datagrams arriving here
+      # so it's not necessary
+      #
+
+    end
+  end
+end

data/lib/adaptor_base.rb

@@ -0,0 +1,39 @@
+require 'eventmachine'
+
+require 'adaptor/socket_handler'
+
+module Adaptor
+  
+  class Base 
+  
+    def initialize( config, logger )
+    
+      @config = config
+      @logger = logger
+    
+      @iface     = '127.0.0.1'
+      @port      = 12701
+      @connector = Adaptor::SocketHandler
+      
+      @iface   = @config['iface'] if @config.has_key? 'iface'
+      @port    = @config['port']  if @config.has_key? 'port'
+      
+      if @config.has_key? 'connector' then
+        
+        #
+        # TODO: may need to override default connection handler
+        #
+        
+      end
+    
+    end
+  
+    def listen( collection ) # ---> handler
+    
+      raise DaemonConfigException.new( "NotYetExtended: undefined listen()" )
+    
+    end
+  
+  end
+  
+end

data/lib/client/base.rb

@@ -0,0 +1 @@
+require 'client_base'

data/lib/client/puppet_state.rb

@@ -0,0 +1,74 @@
+require 'client/abstract/syslog_state_machine'
+
+class PuppetState < SyslogStateMachine
+  
+  def initialize( hostname, config, logger )
+    super
+    
+    @state[:exit_code] = nil
+    @state[:last_run_at] = nil
+    @state[:revision] = ''
+    @state[:last_run_duration_seconds] = nil
+    
+  end
+  
+  def change_state( date, tag, message )
+    
+    #
+    # return true if state changed
+    #
+    
+    ### last_started_at
+    #
+    # run_puppet: obtained lock: beginning run
+    #
+    if /obtained lock: beginning run/.match( message ) then
+      
+      @state[:last_run_at] = date
+      return true
+      
+    end
+    
+    def reset
+      
+      @state[:exit_code] = nil
+      
+    end
+    
+    ### revision
+    #
+    # puppet-git-rev: 0acbf0a78ed813e31dcc3fe58f9c6e9a30219da4
+    #
+    if tag == 'puppet-git-rev' then
+      
+      @state[:revision] = message
+      return true
+      
+    end
+
+    ### success
+    ### last_run_duration_seconds
+    #
+    # run_puppet: completed, releasing lock (exit code : 2)
+    # 
+
+    if /completed, releasing lock/.match( message ) then
+      
+      @state[:exit_code] = /[\d]+/.match(message)[0]
+      @state[:running] = false
+      
+      if @state[:last_run_at] then
+        @state[:last_run_duration_seconds] = date - @state[:last_run_at]
+      else
+        @state[:last_run_duration_seconds] = -1
+      end
+
+      return true
+      
+    end
+    
+    return false
+    
+  end
+  
+end

data/lib/client/radio_state.rb

@@ -0,0 +1,81 @@
+require 'client/abstract/syslog_state_machine'
+
+class RadioState < SyslogStateMachine
+  
+  def persist_change_state( data )
+   
+    #
+    # default product will override with Nano *
+    #
+    @state[:vendor] = "BST"
+    @state[:product] = "Subscriber"
+   
+    @state.merge!( data )  
+    @state[:last_seen_at] = data[:timestamp].clone
+    @state[:last_seen] = data[:timestamp].strftime( '%Y/%m/%d %H:%M:%S')
+    
+    
+    new_min :rx, :rx_min, :rx_min_at
+    new_max :rx, :rx_max, :rx_max_at
+    
+    new_min :tx, :tx_min, :tx_min_at
+    new_max :tx, :tx_max, :tx_max_at
+    
+    #
+    # flag to store
+    #
+    @stored = false
+    
+    return true
+    
+  end
+  
+  
+  def new_min( val, min_val, at )
+    
+    newval = @state[val].to_i
+    
+    if @state.has_key? min_val then
+
+      minval = @state[min_val]
+      begin
+        
+        @state[min_val] = newval 
+        @state[at] = @state[:timestamp].clone
+        
+      end if minval > newval
+      
+    else
+      
+      @state[min_val] = newval
+      @state[at] = @state[:timestamp].clone
+      
+    end
+    
+  end
+  
+  
+  def new_max( val, max_val, at )
+    
+    newval = @state[val].to_i
+    
+    if @state.has_key? max_val then
+
+      maxval = @state[max_val]
+      begin
+        
+        @state[max_val] = newval 
+        @state[at] = @state[:timestamp].clone
+        
+      end if maxval < newval
+      
+    else
+      
+      @state[max_val] = newval
+      @state[at] = @state[:timestamp].clone
+      
+    end
+
+  end
+  
+end

data/lib/client_base.rb

@@ -0,0 +1,24 @@
+require 'ext/persistable'
+
+module Client class Base < Persistable
+    
+    #
+    # Misnomer.
+    #
+    # 
+    # This is not the client,
+    # 
+    # 
+    # It is the server's perspective of the client,
+    # 
+    # These are generally stored in the daemon's
+    # handler collection, 
+    # 
+    # Which contains this and all similar clients,
+    # 
+    # Each bonded through the daemon's connection
+    # adaptor to the socket that couples them to 
+    # their actual client..
+    # 
+    
+end; end

data/lib/daemon/base.rb

@@ -0,0 +1 @@
+require 'daemon_base'

data/lib/daemon/datagram_example.rb

@@ -0,0 +1,12 @@
+require 'daemon/base'
+
+class DatagramExample < Daemon::Base
+  
+  #
+  # Consider tossing this dependancy.
+  # 
+  # Not entirely certain this layer in 
+  # the abstraction will be useful.
+  #
+  
+end