pangdudu-robots 0.1.1

data/README.rdoc

@@ -0,0 +1,27 @@
+= ROBOTS
+
+Start your clocks boys and girls, it's weekend coding time!
+
+On monday I want: working messaging, data-mapper/mysql memory agent, visualizer agent with agent introspection, slim agent that requests modules,classes over the net and evals them online.
+
+Let's try to built a nice easy to use multiagent framework
+based on all the cool stuff we can get for ruby.
+
+rObOts!
+
+== Installation
+
+  sudo apt-get install avahi-daemon avahi-utils libavahi-client-dev libavahi-common-dev libavahi-compat-libdnssd-dev libnss-mdns libdbus-1-dev libdbus-glib-1-dev
+  sudo gem install dnssd
+  sudo gem install pangdudu-ruby-dbus --source=http://gems.github.com
+  sudo gem install pangdudu-rofl --source=http://gems.github.com
+  
+== Usage
+
+== Rule the universe! 
+
+Robots are coming!
+
+== License
+
+GPL -> http://www.gnu.org/licenses/gpl.txt

data/bin/robots

@@ -0,0 +1,2 @@
+#!/usr/bin/ruby
+puts "ROBOTS!"

data/config/org.robots.service.conf

@@ -0,0 +1,33 @@
+ <!DOCTYPE busconfig PUBLIC "-//freedesktop//DTD D-BUS Bus Configuration 1.0//EN" "http://www.freedesktop.org/standards/dbus/1.0/busconfig.dtd">
+ <!-- place this file under /etc/dbus-1/system.d/ -->
+ <busconfig>
+   <policy user="root">
+      <allow own="org.robots.Service" />
+      <allow own="org.ruby.Service" />
+   </policy>
+   <policy group="netdev">
+      <allow own="org.robots.Service" />
+      <allow own="org.ruby.Service" />
+   </policy>
+   <policy group="robots">
+      <allow own="org.robots.Service" />
+      <allow own="org.ruby.Service" />
+   </policy>
+   <policy at_console="true">
+      <allow own="org.robots.Service" />
+      <allow own="org.ruby.Service" />
+    </policy>
+   <policy context="default">
+      <allow send_destination="org.robots.Service"/>
+      <allow receive_sender="org.robots.Service"/>
+      <allow send_destination="org.ruby.Service"/>
+      <allow receive_sender="org.ruby.Service"/>
+      <allow send_destination="org.robots.Service" send_interface="org.robots.Service.EmitterInterface" />
+      <allow send_destination="org.robots.Service" send_interface="org.robots.Service.SampleInterface" />
+      <allow send_destination="org.ruby.Service" send_interface="org.ruby.SampleInterface" />
+      <!-- introspection is allowed -->
+      <allow send_destination="org.robots.Service" send_interface="org.freedesktop.DBus.Introspectable" />
+      <allow send_destination="org.ruby.Service" send_interface="org.freedesktop.DBus.Introspectable" />
+   </policy>
+ </busconfig>
+

data/lib/robots.rb

@@ -0,0 +1,36 @@
+require 'rubygems'
+require 'rofl' #gem install pangdudu-rofl --source=http://gems.github.com
+#local requires, actually don't need them, just to let you know whats going on
+require 'robots_agent'
+
+module Robots
+  
+  attr_accessor :robotsagent,:haz_robots
+  
+  #release the robots
+  def release_robots
+    check_robotsagent
+  end
+  
+  #receives messages from the robots, should be overwritten in the implementing class
+  def receive_msg msg
+    ilog msg
+  end
+
+  #sends messages to the robots, should be overwritten in the implementing class
+  def send_msg msg
+    @robotsagent.send_msg msg if @haz_robots
+  end
+  
+  #check if robots are set up
+  def check_robotsagent
+    @haz_robots = @robotsagent.nil?
+    if @haz_robots
+      @robotsagent = Robot.new
+      @robotsagent.run
+      @robotsagent.add_listener self
+    end 
+    return @haz_robots
+  end
+  
+end

data/lib/robots_agent.rb

@@ -0,0 +1,203 @@
+require 'rubygems'
+require 'dbus' #gem install sdague-ruby-dbus --source=http://gems.github.com
+require 'rofl' #gem install pangdudu-rofl --source=http://gems.github.com
+#local requires, actually don't need them, just to let you know whats going on
+require 'robots_infrastructure'
+
+class Robot
+  attr_accessor :avahi
+  attr_accessor :emitters,:infrastructure,:listeners
+  
+  def initialize
+    dlog "new Robot initialized."
+    @robotsservice = "org.robots.Service"
+    @emitterpath = "/org/robots/Service/Emitter"
+    @emitterinterface = "org.ruby.Service.EmitterInterface"
+    @coreservice = nil
+    @listeners = [] # listeners for incoming messages are here
+    @emitters = {} #holds emitters we use
+    @infrastructure = {} #holds infrastructure objects
+    @servicetypes = fill_servicetypes
+  end
+  
+  #start the mojo
+  def run
+    setup_robots_service
+    register_callbacks
+    #test_messages; #main_loop;
+  end
+
+  #setup the robots service
+  def setup_robots_service
+    robots_running = running? @robotsservice
+    dlog "robots service has already been started." if robots_running
+    unless robots_running
+      ilog "will now setup robots service infrastructure."
+      start_core_service @robotsservice
+      init_robots_infrastructure
+    end
+    get_robots_infrastructure
+  end    
+
+#ROBOTS SERVICE INIT START
+
+=begin
+  the following methods are only called, if the robots service is not already running 
+=end 
+ 
+  #setup the infrastructure objects for communication
+  def init_robots_infrastructure
+    emitter = Emitter.new(@emitterpath,self)
+    @coreservice.export(emitter)
+    @infrastructure["emitter"] = emitter
+  end
+
+  #get instances of our infrastructure objects
+  def get_robots_infrastructure
+    emitter = get_object_from_service @robotsservice,@emitterpath,@emitterinterface
+    @emitters["robots"] = emitter
+  end
+  
+  #start a service
+  def start_core_service service_name=@robotsservice
+    bus = DBus::system_bus
+    #first of all check if the service we want to launch is already started
+    dlog "skipping service: #{service_name} has already been started." if running? service_name 
+    unless running? service_name
+      begin
+        @coreservice = bus.request_service(service_name)
+      rescue
+        elog "service request for #{service_name} denied."
+      end
+    end
+  end
+
+#ROBOTS SERVICE INIT END
+  
+  #get a dbus object from a service
+  def get_object_from_service service_name,obj_path,default_iface
+    begin
+      if running? service_name
+        bus = DBus::system_bus
+        ruby_service = bus.service(service_name)
+        obj = ruby_service.object(obj_path)
+        obj.introspect
+        obj.default_iface = default_iface
+        return obj
+      end
+      return nil
+    rescue
+      elog "could not get object:#{obj_path} from service: #{service_name}"
+      return nil
+    end
+  end 
+  
+  #register callback methods
+  def register_callbacks
+    bus = DBus::system_bus
+    #setup callbacks for infrastructure emitters
+    @emitters.each { |name,emitter| register_emitter_callback name,emitter }
+    #setup service browser
+    proxy = bus.introspect("org.freedesktop.Avahi","/")
+    @avahi = proxy["org.freedesktop.Avahi.Server"]  
+    @servicetypes.each { |name,type| register_service_callback name,type }
+  end
+  
+  #register an emitter callback
+  def register_emitter_callback name,emitter
+    bus = DBus::system_bus
+    dlog "registering callback for #{name} on path #{emitter.path}"
+    mr = DBus::MatchRule.new
+    mr.type = "signal"
+    mr.interface = "org.ruby.Service.EmitterInterface"
+    mr.path = emitter.path
+    bus.add_match(mr) { |msg| emitter_proxy_callback msg }
+  end
+  
+  #get called when receiving an remote emitter message
+  def emitter_proxy_callback msg
+    @listeners.each { |l| l.receive_msg msg.params[0] } unless msg.params[0].nil?
+  end
+  
+  #gets called from the exported emitter object
+  def emitter_callback msg
+     #when other agents use the send_message of the proxy, it will only reach the
+     #local non proxy object, so we need to emit a signal and tell everyone 
+     @infrastructure["emitter"].newMessage(msg) if  @infrastructure.has_key? "emitter"
+  end
+  
+  #builds a service type specific callback
+  def register_service_callback name,type
+    bus = DBus::system_bus
+    sb = @avahi.ServiceBrowserNew(-1,-1,"_#{type}._tcp","local",0)
+    #now we start the match rule definition
+    mr = DBus::MatchRule.new
+    mr.type = "signal"
+    mr.interface = "org.freedesktop.Avahi.ServiceBrowser"
+    mr.path = sb.first
+    bus.add_match(mr) { |msg| service_callback name,msg }
+  end
+ 
+  #gets called on a service change
+  def service_callback name,msg
+    if msg.member.eql? "ItemNew"
+      dlog "new #{name}: #{msg.params[2]}"
+    end
+    if msg.member.eql? "ItemRemoved"
+      dlog "removed #{name}: #{msg.params[2]}"
+    end
+  end
+  
+  #check if a service is running
+  def running? service_name
+    bus = DBus::system_bus
+    return bus.proxy.ListNames[0].include? service_name
+  end
+
+#functions used by the module
+
+  #send
+  def send_msg msg
+    @emitters["robots"].send_message(msg) unless @emitters["robots"].nil?
+  end
+  
+  #add a listener
+  def add_listener listener
+    #check if the method is implemented
+    impcheck = defined? listener.receive_msg 
+    #if it is add to listeners
+    @listeners << listener if impcheck.eql? "method"
+    #if not inform dev
+    unless impcheck.eql? "method" 
+      elog "Method 'receive_msg string' needs to be implemented! Example:"
+      puts "def receive_msg msg\n  puts msg\nend"  
+    end
+  end
+
+#functions used by the module end here 
+  
+  #dbus main loop
+  def main_loop
+    dlog "going into main loop..."
+    loop do 
+      sleep 1
+    end
+  end
+  
+  def test_messages
+     Thread.new do 
+      loop do
+        msg = "it worx from alpha!"
+        send_msg msg
+        sleep 1
+      end
+    end 
+  end
+  
+  #list names of a proxy object
+  def list_names proxy=@dbus.proxy
+    dlog "listnames:"
+    proxy.ListNames[0].each { |name| dlog name }
+    @services.each { |name,service| dlog "service introspection for #{name} introspection: #{service.introspect}" }
+  end
+end

data/lib/robots_infrastructure.rb

@@ -0,0 +1,52 @@
+=begin
+this includes all the necessary dbus objects we need for the robots infrastructure
+=end
+require 'rubygems'
+require 'dbus' #gem install sdague-ruby-dbus --source=http://gems.github.com
+require 'rofl' #gem install pangdudu-rofl --source=http://gems.github.com 
+
+#basic emitter class
+class Emitter < DBus::Object
+  
+  attr_accessor :listener
+  
+  def initialize path,listener
+    super path
+    @listener = listener
+    dlog "new Emitter initialized at #{path}"
+  end
+  
+  #create an dbus interface
+  dbus_interface "org.ruby.Service.EmitterInterface" do
+    #creates a signal in the interface:
+    dbus_signal :newMessage, "msgbody:s"
+    #creates an emit method in the interface:
+    dbus_method :send_message, "in msg:s" do |msg|
+      send_message_callback msg
+    end
+  end #end of the dbus interface
+  
+  #this method gets called by remote proxy objects calling send_message
+  def send_message_callback msg
+    @listener.emitter_callback msg
+  end
+end
+
+
+#hardcoding i don't want in the agent file
+def fill_servicetypes
+  types = {}
+  types["Workstation"] = "workstation"
+  types["SSH Remote Terminal"] = "ssh"
+  types["Website"] = "http"
+  types["Secure Website"] = "https"
+  types["iChat Presence"] = "presence"
+  types["PulseAudio Sound Server"] = "pulse-server"
+  types["Subversion Revision Control"] = "svn"
+  types["GIT"] = "git"
+  types["APT Package Repository"] = "apt"
+  types["WebDAV"] = "webdav"
+  types["Secure WebDAV"] = "webdavs"
+  types["Samba"] = "smb"
+  return types
+end

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification 
+name: pangdudu-robots
+version: !ruby/object:Gem::Version 
+  version: 0.1.1
+platform: ruby
+authors: 
+- pangdudu
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-07-17 00:00:00 -07:00
+default_executable: robots
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: dbus
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: robots!
+email: pangdudu@github
+executables: 
+- robots
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- README.rdoc
+- bin/robots
+- lib/robots.rb
+- lib/robots_agent.rb
+- lib/robots_infrastructure.rb
+- config/org.robots.service.conf
+has_rdoc: true
+homepage: http://github.com/pangdudu/robots
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: http://github.com/pangdudu/robots
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: more robots!
+test_files: []
+