ruby-wmi 0.2.0

data/History.txt

@@ -0,0 +1,5 @@
+== 1.0.0 / 2007-07-19
+
+* 1 major enhancement
+  * Birthday!
+

data/Manifest.txt

@@ -0,0 +1,15 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/ruby-wmi.rb
+lib/ruby-wmi/base.rb
+lib/ruby-wmi/cim.rb
+lib/ruby-wmi/core_ext.rb
+lib/ruby-wmi/core_ext/time_ext.rb
+lib/ruby-wmi/core_ext/win32ole_ext.rb
+lib/ruby-wmi/win32.rb
+samples/disk.rb
+samples/logoff.rb
+samples/memory.rb
+test/test_ruby-wmi.rb

data/README.txt

@@ -0,0 +1,50 @@
+ruby-wmi
+    by Gordon Thiesfeld
+    http://ruby-wmi.rubyforge.org/
+
+== DESCRIPTION:
+  
+    ruby-wmi is an ActiveRecord style interface for Microsoft's Windows Management Instrumentation provider.
+
+== SYNOPSIS:
+
+  # The following code sample kills all processes of a given name, except the oldest (in this case, Notepad)
+
+    require 'ruby-wmi'
+
+    processes = Win32::Process.find(:all, :conditions => { :name => 'Notepad.exe' })
+    morituri = processes.sort_by{|p| p.CreationDate } #those who are about to die
+    morituri.shift 
+    morituri.each{|p| p.terminate }
+
+== REQUIREMENTS:
+
+
+== INSTALL:
+
+  gem install ruby-wmi
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2007 Gordon Thiesfeld
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,18 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/ruby-wmi.rb'
+
+Hoe.new('ruby-wmi', Ruby_wmi::VERSION) do |p|
+  p.rubyforge_name = 'ruby-wmi'
+  p.author = 'Gordon Thiesfeld'
+  p.email = 'gthiesfeld@gmail.com'
+  p.summary = "ruby-wmi is an ActiveRecord style interface for Microsoft\'s Windows Management Instrumentation provider."
+  # p.description = p.paragraphs_of('README.txt', 2..5).join("\n\n")
+  # p.url = p.paragraphs_of('README.txt', 0).first.split(/\n/)[1..-1]
+  p.changes = p.paragraphs_of('History.txt', 0..1).join("\n\n")
+  p.need_tar = false
+end
+
+# vim: syntax=Ruby

data/lib/ruby-wmi.rb

@@ -0,0 +1,11 @@
+class Ruby_wmi
+  VERSION = '0.2.0'
+end
+
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+require 'ruby-wmi/core_ext'
+require 'ruby-wmi/base'
+require 'ruby-wmi/cim'
+require 'ruby-wmi/win32'

data/lib/ruby-wmi/base.rb

@@ -0,0 +1,114 @@
+require 'win32ole'
+
+module WMI
+
+    def subclasses(options ={})
+      Base.set_connection(options)
+      b = Base.connection
+      b.SubclassesOf.map { |subclass| class_name = subclass.Path_.Class }
+    end
+    
+    alias :subclasses_of :subclasses
+
+    def const_missing(name)
+      self.const_set(name, Class.new(self::Base))
+    end
+    extend self
+    
+  class Base
+      
+    class << self
+      def subclass_name
+        self.name.split('::').last
+      end
+
+      def connection
+        c = WIN32OLE.new("WbemScripting.SWbemLocator")
+        c.ConnectServer(@host,@klass,@credentials[:user],@credentials[:passwd])
+      end
+      
+      def set_connection(options)
+        @host = options[:host] || nil
+        @klass = options[:class] || 'root/cimv2'
+        @credentials = options[:credentials] || {:user => nil,:passwd => nil}
+      end
+      
+      def find_by_wql(query)
+        d = connection.ExecQuery(query)
+        d.count # needed to check for errors.  Weird, but it works.
+        d.to_a
+      end
+
+      def find(arg=:all, options={})
+        set_connection options
+        case arg
+          when :all; find_all(options)
+          when :first; find_first(options)
+        end
+      end
+      
+      def find_first(options={})
+        find_all(options).first
+      end
+
+      def find_all(options={})
+        find_by_wql(construct_finder_sql(options))
+      end
+      
+      def construct_finder_sql(options)
+        #~ scope = scope(:find)
+        sql  = "SELECT #{options[:select] || '*'} "
+        sql << "FROM #{options[:from] || subclass_name} "
+
+        #~ add_joins!(sql, options, scope)
+        add_conditions!(sql, options[:conditions], nil)
+
+        sql << " GROUP BY #{options[:group]} " if options[:group]
+
+        #~ add_order!(sql, options[:order], scope)
+        #~ add_limit!(sql, options, scope)
+        #~ add_lock!(sql, options, scope)
+
+        sql
+      end
+      
+      def add_conditions!(sql, conditions, scope = :auto)
+        #~ scope = scope(:find) if :auto == scope
+        segments = []
+        segments << sanitize_sql(conditions)  unless conditions.nil?
+        #~ segments << conditions unless conditions.nil?
+        #~ segments << type_condition unless descends_from_active_record?
+        segments.compact!
+        sql << "WHERE (#{segments.join(") AND (")}) " unless segments.empty?
+        sql.gsub!("\\","\\\\\\")
+      end
+      
+      # Accepts an array, hash, or string of sql conditions and sanitizes
+      # them into a valid SQL fragment.
+      #   ["name='%s' and group_id='%s'", "foo'bar", 4]  returns  "name='foo''bar' and group_id='4'"
+      #   { :name => "foo'bar", :group_id => 4 }  returns "name='foo''bar' and group_id='4'"
+      #   "name='foo''bar' and group_id='4'" returns "name='foo''bar' and group_id='4'"
+      def sanitize_sql(condition)
+        case condition
+          when Array; sanitize_sql_array(condition)
+          when Hash;  sanitize_sql_hash(condition)
+          else        condition
+        end
+      end
+
+      # Sanitizes a hash of attribute/value pairs into SQL conditions.
+      #   { :name => "foo'bar", :group_id => 4 }
+      #     # => "name='foo''bar' and group_id= 4"
+      #   { :status => nil, :group_id => [1,2,3] }
+      #     # => "status IS NULL and group_id IN (1,2,3)"
+      def sanitize_sql_hash(attrs)
+        conditions = attrs.map do |attr, value|
+          #~ "#{table_name}.#{connection.quote_column_name(attr)} #{attribute_condition(value)}"
+          "#{attr} = '#{value}'"
+        end.join(' AND ')
+
+        #~ replace_bind_variables(conditions, attrs.values)
+      end 
+    end
+  end
+end

data/lib/ruby-wmi/cim.rb

@@ -0,0 +1,12 @@
+module CIM
+  extend WMI
+  
+  class Base < WMI::Base
+    class << self
+      def subclass_name
+        self.name.gsub('::', '_')
+      end
+    end
+  end
+  
+end

data/lib/ruby-wmi/core_ext.rb

@@ -0,0 +1 @@
+Dir[File.dirname(__FILE__) + "/core_ext/*.rb"].each { |file| require(file) }

data/lib/ruby-wmi/core_ext/time_ext.rb

@@ -0,0 +1,9 @@
+class Time
+  
+  def to_swebmDateTime
+    t = strftime("%Y%m%d%H%M%S")
+    o = gmt_offset/60
+    "#{t}.000000#{o}" 
+  end
+
+end

data/lib/ruby-wmi/core_ext/win32ole_ext.rb

@@ -0,0 +1,5 @@
+require 'win32ole'
+
+class WIN32OLE
+  include Enumerable
+end

data/lib/ruby-wmi/win32.rb

@@ -0,0 +1,11 @@
+module Win32 
+  extend WMI
+  
+  class Base < WMI::Base
+    class << self
+      def subclass_name
+        self.name.gsub('::', '_')
+      end
+    end
+  end
+end

data/samples/disk.rb

@@ -0,0 +1,9 @@
+require 'wmi'
+
+disks = WMI::Win32_LogicalDisk.find(:all)
+
+disks.each do |disk|
+ disk.properties_.each do |p|
+    puts "#{p.name}: #{disk[p.name]}"
+  end
+end

data/samples/logoff.rb

@@ -0,0 +1,14 @@
+#~ 'active_wmi'
+#~ 'wmi_rb'
+#~ 'ruby-wmi'
+#~ 'rWMI'
+#~ 'wmi4r'
+
+require 'wmi'
+
+LOGOFF = 0
+
+host = 'computername'
+host = WMI::Win32_OperatingSystem.find(:first, :conditions => {:primary => true}, :host => host)
+host.win32shutdown(LOGOFF)
+

data/samples/memory.rb

@@ -0,0 +1,14 @@
+require 'wmi'
+
+properties = ['Description','MaxCapacity','MemoryDevices','MemoryErrorCorrection'] 
+
+
+mem = WMI::Win32_PhysicalMemoryArray.find(:all, :host => 'server1')
+mem.each{|i| puts properties.map{|p| "#{p}: #{i[p]}"}}
+
+mem2 = WMI::Win32_PhysicalMemoryArray.find(:all, {:host => 'server2', :credentials => 
+  {:user => 'domain\\gordon', :passwd => 'password'} 
+  }
+ )
+mem2.each{|i| puts properties.map{|p| "#{p}: #{i[p]}"}}
+

data/test/test_ruby-wmi.rb

@@ -0,0 +1,2 @@
+# stub file, not sure how to test this stuff yet.
+# Mocks, maybe?

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification 
+name: ruby-wmi
+version: !ruby/object:Gem::Version 
+  version: 0.2.0
+platform: ruby
+authors: 
+- Gordon Thiesfeld
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-01-10 00:00:00 -06:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.4.0
+    version: 
+description: The author was too lazy to write a description
+email: gthiesfeld@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- lib/ruby-wmi.rb
+- lib/ruby-wmi/base.rb
+- lib/ruby-wmi/cim.rb
+- lib/ruby-wmi/core_ext.rb
+- lib/ruby-wmi/core_ext/time_ext.rb
+- lib/ruby-wmi/core_ext/win32ole_ext.rb
+- lib/ruby-wmi/win32.rb
+- samples/disk.rb
+- samples/logoff.rb
+- samples/memory.rb
+- test/test_ruby-wmi.rb
+has_rdoc: true
+homepage: http://www.zenspider.com/ZSS/Products/ruby-wmi/
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+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: ruby-wmi
+rubygems_version: 1.0.1
+signing_key: 
+specification_version: 2
+summary: ruby-wmi is an ActiveRecord style interface for Microsoft's Windows Management Instrumentation provider.
+test_files: 
+- test/test_ruby-wmi.rb