murmur-rpc 0.0.1

data/README.rdoc

@@ -0,0 +1,83 @@
+h1. Ruby Murmur Manager
+
+This is a quick library and control script for managing a murmur daemon. It supports both DBus and ICE (though you should really use ICE).
+
+h3. Getting and installing
+
+pre. git clone git://github.com/cheald/murmur-manager.git
+git submodule init
+git submodule update
+
+h3. Commands
+
+pre. [server-id]                             List a server's config
+[server-id] set [key] [val]             Set a server's config value
+[server-id] start                       Start a server
+[server-id] stop                        Stop a server
+[server-id] destroy                     Permanently destroy a server
+new                                     Create a new server
+list                                    List existing servers
+
+h3. Example usage: Creating and configuring a new virtual server
+
+pre.. # ./manager.rb list
+
+Server ID       Running
+---------       ------
+1               true
+2               true
+
+# ./manager.rb new
+
+Server created. New ID is 2
+
+Server config:
+-------------
+allowhtml                               true
+obfuscate                               false
+registerhostname
+certificate                             ...
+port                                    64738
+registerurl
+timeout                                 30
+defaultchannel                          0
+textmessagelength                       5000
+username                                [-=\w\[\]\{\}\(\)\@\|\.]+
+welcometext                             <br />Welcome to this server running <b>Murmur</b>.<br />Enjoy your stay!<br />
+bonjour                                 true
+certrequired                            false
+channelname                             [ \-=\w\#\[\]\{\}\(\)\@\|]+
+registername
+bandwidth                               72000
+host                                    0:0:0:0:0:0:0:0
+registerpassword
+users                                   100
+key                                     ...
+password
+
+# ./manager.rb list
+
+Server ID       Running
+---------       ------
+1               true
+2               true
+3               false
+
+# ./manager.rb 3 set port 54321
+
+Server ID 3: port set to 612312
+Server restarted
+
+# ./manager.rb 3 set welcometext "Welcome to my Mumble server"
+
+Server ID 3: welcometext set to Welcome to my Mumble server
+Server restarted
+
+# ./manager.rb 3 set superuser_password mynewpassword
+
+Server ID 3: superuser_password set to mynewpassword
+Server restarted
+
+# ./manager.rb 3 start
+
+p. Tada! A new virtual server has been spawned.

data/Rakefile

@@ -0,0 +1,51 @@
+require "rake"
+require "rake/clean"
+require "rake/gempackagetask"
+require "rake/rdoctask"
+require "spec/rake/spectask"
+
+require 'lib/murmur-rpc'
+
+NAME = 'murmur-rpc'
+VERSION = MurmurRPC::VERSION
+TITLE = "Murmur RPC for Ruby"
+CLEAN.include ["*.gem", "rdoc"]
+RDOC_OPTS = [
+  "-U", "--title", TITLE,
+  "--op", "rdoc",
+  "--main", "README.rdoc"
+]
+
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = "rdoc"
+  rdoc.options += RDOC_OPTS
+  rdoc.rdoc_files.add %w(README.rdoc lib/**/*.rb)
+end
+
+desc "Package"
+task :package => [:clean] do |p|
+  sh "gem build #{NAME}.gemspec"
+end
+
+desc "Install gem"
+task :install => [:package] do
+  sh "sudo gem install ./#{NAME}-#{VERSION} --local"
+end
+
+desc "Uninstall gem"
+task :uninstall => [:clean] do
+  sh "sudo gem uninstall #{NAME}"
+end
+
+desc "Upload gem to gemcutter"
+task :release => [:package] do
+  sh "gem push ./#{NAME}-#{VERSION}.gem"
+end
+
+desc "Run all specs"
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.spec_files = Dir['spec/**/*_spec.rb']
+end
+
+task :default => [:clean, :spec]
+

data/lib/interfaces/ice.rb

@@ -0,0 +1,157 @@
+require 'timeout'
+require 'benchmark'
+require 'Glacier2'
+require File.join(File.expand_path(File.dirname(__FILE__)), "..", "..", "vendor", "ice", "Murmur.rb")
+module Murmur
+	module Ice
+		class ::InvalidMetaException < Exception; end
+		class ::Murmur::Ice::InvalidServerException < Exception; end
+		class Meta
+			def initialize(glacierHost = nil, glacierPort = nil, user = nil, pass = nil, host = "127.0.0.1", port = "6502", icesecret = nil)
+				ic = nil
+				if icesecret and icesecret != ""
+					props = ::Ice::createProperties
+					props.setProperty "Ice.ImplicitContext", "Shared"
+					idd = ::Ice::InitializationData.new
+					idd.properties = props
+					ic = ::Ice::initialize idd
+					ic.getImplicitContext.put("secret", icesecret)
+				else
+					ic = ::Ice::initialize
+				end
+				
+				if glacierHost and glacierHost != "" then
+					@glacierHost = glacierHost
+					@glacierPort = glacierPort
+					validate_connection(glacierHost, glacierPort)
+					prx = ic.stringToProxy("Glacier2/router:tcp -h #{glacierHost} -p #{glacierPort}")
+					@router = ::Glacier2::RouterPrx::uncheckedCast(prx).ice_router(nil)
+					@session = @router.createSession(user, pass)
+				end
+				
+				conn = "tcp -h #{host} -p #{port}"
+				@meta = add_proxy_router(Murmur::MetaPrx::checkedCast(ic.stringToProxy("Meta:#{conn}")))
+				raise "Invalid proxy" unless @meta
+				
+				@servers = {}
+			end
+			
+			def destroy
+				begin
+					@router.destroySession @session unless @router.nil?
+				rescue ::Ice::ConnectionLostException
+					# Expected - Ice raises this when the connection is terminated. Yay for exceptions as flow control?
+				end
+				return nil
+			end
+			
+			def add_proxy_router(prx)
+				@router ? prx.ice_router(@router) : prx
+			end
+			
+			def get_server(id)
+				@servers[id] ||= Server.new(self, @meta, id)
+			end
+			
+			def uncache_server(id)
+				@servers[id] = nil
+			end
+			
+			def list_servers(only_booted = false)
+				method = only_booted ? :getBootedServers : :getAllServers
+				@meta.send(method).collect do |server|
+					server = add_proxy_router(server)
+					@servers[server.id] ||= Server.new(self, @meta, nil, server)
+				end					
+			end
+				
+			def validate
+				@meta.getVersion
+				return true
+			end
+			
+			def new_server(port = nil)
+				server = @meta.newServer
+				@servers[server.id] = Server.new(self, @meta, nil, add_proxy_router(server))
+			end	
+			
+			def method_missing(method, *args)
+				method = method.to_s
+				method.gsub!(/_([a-z])/) { $1.upcase }
+				@meta.send method, *args
+			end
+			
+			def validate_connection(host, port)
+				Timeout::timeout(2) do
+					begin
+						s = TCPSocket.new(host, port)
+						s.close
+					rescue Errno::ECONNREFUSED, Errno::EHOSTUNREACH
+						raise InvalidMetaException
+					end						
+				end
+			rescue Timeout::Error
+				raise InvalidMetaException
+			end
+		end			
+		
+		class Server
+			def initialize(host, meta, id = nil, interface = nil)
+				@meta = meta
+				@host = host
+				if id.nil? and interface.nil? then
+					raise "Must pass either a server ID or a server interface instance"
+				end
+				@interface = interface || begin
+					server = @meta.getServer(id)
+					raise ::Murmur::Ice::InvalidServerException if server.nil?
+					host.add_proxy_router(server)
+				end
+			end
+			
+			def id
+				@interface.id
+			end
+			
+			def running?
+				@interface.isRunning
+			end
+			
+			def config
+				@config = @meta.getDefaultConf.merge(@interface.getAllConf)
+			end
+			
+			def destroy!
+				@interface.stop if running?
+				@host.uncache_server @interface.id
+				@interface.delete
+			end
+			alias :delete :destroy!
+			
+			def restart!
+				@interface.stop if running?
+				@interface.start
+				@running = nil
+			end
+			
+			def [](key)
+				config[key]
+			end
+			
+			def []=(key, val)
+				@interface.setConf(key, val.to_s)
+				@config = nil
+			end
+			
+			def setConf(key, val)
+				self[key] = val
+			end
+			
+			def method_missing(method, *args)
+				method = method.to_s
+				method.gsub!(/_([a-z])/) { $1.upcase }
+				ret = @interface.send method, *args
+			end
+		end
+	end
+end

data/lib/murmur-rpc.rb

@@ -0,0 +1,5 @@
+require File.dirname(__FILE__) + '/interfaces/ice.rb'
+
+module MurmurRPC
+  VERSION="0.0.1"
+end