virtop 0.0.3 → 0.0.4

data/README

@@ -0,0 +1,15 @@
+== Installation ==
+
+Add gems.github.com as a source for gems and install elliottcable-ncurses from
+this mirror, because there is no version on rubygems.org which works with ruby
+1.9.
+
+ * gem sources -a http://gems.github.com
+ * gem install elliottcable-ncurses
+
+Build the virtop gem and install it. Do not build ri and rdoc documentation for
+this would throw nasty errors.
+
+ * gem build virtop.gemspec
+ * gem install --no-ri --no-rdoc virtop-*.gem
+

data/bin/virtop

@@ -1,13 +1,17 @@
 #!/usr/bin/env ruby
 
+# Require libvirt and uri modules and print out exception message if they could
+# not be loaded.
 begin
-	require 'libvirt'
-	require 'uri'
+	require( 'libvirt' )
+	require( 'uri' )
 rescue LoadError => e
 	$stderr.puts( e.message )
 	exit( 1 )
 end
 
+# Require ncurses module and print out instructions howto install it if it could
+# not be loaded.
 begin
 	require 'ncurses'
 rescue LoadError
@@ -23,6 +27,16 @@ EOF
 	exit( 1 )
 end
 
+# Require virtop module. If not installed as gem, try it in the source's
+# directory.
+begin
+	require( 'virtop' )
+rescue LoadError
+	require( File.dirname( __FILE__ ) + '/../lib/virtop' )
+end
+
+# Connection URL will be qemu:///system if nothing else is given as the first
+# parameter.
 if( ARGV.size < 1 )
 	url = 'qemu:///system'
 else
@@ -35,58 +49,7 @@ else
 	end
 end
 
-class LetsExit < Exception
-end
-
-module Libvirt
-	class Connect
-		def domains
-			ret = Array.new
-
-			self.list_domains.each do |id|
-				ret.push( 
-					self.lookup_domain_by_id( id )
-				)
-			end
-
-			ret
-		end
-	end
-
-	class Domain
-		def to_s
-			self.name
-		end
-
-		def state
-			case( self.info.state )
-				when 1
-					">"
-				when 3
-					"||"
-				else
-					"?"
-			end
-		end
-
-		def mem
-			( self.info.memory / 1024 ).to_s + "M"
-		end
-
-		def mem_max
-			( self.info.max_mem / 1024 ).to_s + "M"
-		end
-
-		def cpu_num
-			self.info.nr_virt_cpu.to_s
-		end
-
-		def cpu_time
-			self.info.cpu_time.to_s
-		end
-	end
-end
-
+# Open the connection to the libvirt ressource or print out error message.
 begin
 	c = Libvirt::open( url )
 rescue Libvirt::ConnectionError
@@ -94,6 +57,8 @@ rescue Libvirt::ConnectionError
 	exit( 1 )
 end
 
+# Initialize ncurses context. Clear and print details for each domain in a 10s
+# interval. Quit on keypress of 'q'.
 begin
 	n = Ncurses.initscr
 

data/lib/virtop/letsexit.rb

@@ -0,0 +1,3 @@
+# This exception should be thrown, if an exit is triggered.
+class LetsExit < Exception
+end

data/lib/virtop/libvirt/connect.rb

@@ -0,0 +1,17 @@
+# Extend Libvirt::Connect with a method which returns all available domains as
+# an array.
+module Libvirt
+	class Connect
+		def domains
+			ret = Array.new
+
+			self.list_domains.each do |id|
+				ret.push( 
+					self.lookup_domain_by_id( id )
+				)
+			end
+
+			ret
+		end
+	end
+end

data/lib/virtop/libvirt/domain.rb

@@ -0,0 +1,36 @@
+# Extend Libvirt::Domain with different methods for human readable display of
+# the domain state.
+module Libvirt
+	class Domain
+		def to_s
+			self.name
+		end
+
+		def state
+			case( self.info.state )
+				when 1
+					">"
+				when 3
+					"||"
+				else
+					"?"
+			end
+		end
+
+		def mem
+			( self.info.memory / 1024 ).to_s + "M"
+		end
+
+		def mem_max
+			( self.info.max_mem / 1024 ).to_s + "M"
+		end
+
+		def cpu_num
+			self.info.nr_virt_cpu.to_s
+		end
+
+		def cpu_time
+			self.info.cpu_time.to_s
+		end
+	end
+end

data/lib/virtop.rb

@@ -0,0 +1,5 @@
+$:.unshift( File.dirname( __FILE__ ) )
+
+Dir.glob( $:.first + '/**/*.rb' ).each do |file|
+	require( file )
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: virtop
 version: !ruby/object:Gem::Version 
-  hash: 25
+  hash: 23
   prerelease: false
   segments: 
   - 0
   - 0
-  - 3
-  version: 0.0.3
+  - 4
+  version: 0.0.4
 platform: ruby
 authors: 
 - henning mueller
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-05-28 00:00:00 +02:00
+date: 2010-05-30 00:00:00 +02:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -44,6 +44,11 @@ extra_rdoc_files: []
 
 files: 
 - bin/virtop
+- lib/virtop/letsexit.rb
+- lib/virtop/libvirt/domain.rb
+- lib/virtop/libvirt/connect.rb
+- lib/virtop.rb
+- README
 has_rdoc: true
 homepage: 
 licenses: []