invoracle 0.0.3 → 0.0.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 430f4ef1a790bb55a8b3732adb355af3fc2bb863
+  data.tar.gz: 99b6db6f1d85f0568874f052b1bde9506b1141bb
+SHA512:
+  metadata.gz: 255dceda0c35ef7a1f3132da41a35d583f1059d07def38fb6c14ceec8a2bfb7ce0ac2588f0d6079e5ff20c5565940af50f5b989a1368c792d4cb42ff3b8c35aa
+  data.tar.gz: 519f0ce27cf247057644ed4bf5cd6b57a9b2feb4733702f34d307179706a3e2c572cb2352d763622b04dfc8f00926207a83914a4d774a5c8fa19c3a5d23b54fa

data/CHANGELOG.md

@@ -1,5 +1,8 @@
 CHANGELOG
 ---------
+- **2014-03-08**: 0.0.4
+  - Add Invoracle::SystemsSet to manage sets of systems
+
 - **2014-03-05**: 0.0.3
   - Retreive Systems from Cluster via SysRoles
   - Inflate System SysRoles

data/README.md

@@ -13,13 +13,16 @@ Primary use cases include use as a core document object that various parsers can
 Installing
 ----------
 
-To install SalesforceCache, use the following command:
+To install Invoracle, use the following command:
 
     $ gem install invoracle
 
 #Examples
 ---------
 
+System
+------
+
     require 'invoracle'
 
     system = Invoracle::System.new
@@ -32,6 +35,26 @@ To install SalesforceCache, use the following command:
     system_hash = system.asHash
     system_json = system.asJson
 
+Systems Set
+-----------
+
+    require 'invoracle'
+
+    systemsSet = Invoracle::SystemsSet.new
+
+    system = Invoracle::System.new
+    system.setAttr(:sSysUid,'foo.bar.com')      # System  UID
+    system.setAttr(:sCluUid,'foo-bar-cluster')  # Cluster UID
+
+    systemsSet.addSystem( system )
+
+    clusterCount = systemsSet.getClusterCount
+    clusterUids  = systemsSet.getClusterUids
+    systemCount  = systemsSet.getSystemCount
+
+    system  = systemsSet.getSystem( systemUid )
+    systems = systemsset.getSystemsForClusterUid( clusterUid )
+
 #Documentation
 --------------
 
@@ -49,16 +72,7 @@ Notes
 
 2. Schema Property Formats
 
-  The default properties, which can be overridden, use a short form of "Hungarian CamelCase" where properties are prefixed with type abbreviations including ['a','d','f','i','j','s','x'] for:
-
-    a = array,
-    d = dictionary / hash,
-    f = float / number,
-    h = html / string,
-    i = integer / number,
-    j = JSON / string,
-    s = string,
-    x = XML / string
+  The default properties, which can be overridden, use a short form of "Hungarian CamelCase" where properties are prefixed with type abbreviations including ['a','d','f','i','j','s','x'] for: a = array, d = dictionary / hash, f = float / number, h = html / string, i = integer / number, j = JSON / string, s = string, x = XML / string
 
 3. Subclassing
 
@@ -71,14 +85,14 @@ Notes
 #Change Log
 -----------
 
+- **2014-03-08**: 0.0.4
+  - Add Invoracle::SystemsSet to manage sets of systems
 - **2014-03-05**: 0.0.3
   - Retreive Systems from Cluster via SysRoles
   - Inflate System SysRoles
-
 - **2014-02-15**: 0.0.2
   - Invoracle::Cluster is now a JsonDoc subclass
   - Inforacle::Infra::IostatParser added
-
 - **2014-01-01**: 0.0.1
   - Initial release
   - JsonDoc subclass for Invoracle::System

data/VERSION

@@ -1 +1 @@
-0.0.3
+0.0.4

data/lib/invoracle.rb

@@ -1,4 +1,5 @@
 module Invoracle
-  autoload :System, 'invoracle/system'
-  autoload :Cluster, 'invoracle/cluster'
+  autoload :Cluster   , 'invoracle/cluster'
+  autoload :System    , 'invoracle/system'
+  autoload :SystemsSet, 'invoracle/systems_set'
 end

data/lib/invoracle/system.rb

@@ -1,6 +1,10 @@
 require 'jsondoc'
 
 module Invoracle
+
+  # The Invoracle::System object is a JsonDoc::Document subclass with a default schema
+  # included in the #getDefaultSchema method and some systems specific methods.
+
   class System < JsonDoc::Document
     attr_accessor :dSchema
     def initialize(dSchema=nil,bDefaultifyDoc=true,bIsStrict=true)
@@ -18,6 +22,7 @@ module Invoracle
 
           :sSysUid             => { :default => '', :type => 'string', :description => 'System UID'  },
           :sSysFqdn            => { :default => '', :type => 'string', :description => 'FQDN' },
+          :sSysHostFqdn        => { :default => '', :type => 'string', :description => 'FQDN Host' },
           :sSysIpAddress       => { :default => '', :type => 'string', :description => 'IP'   },
 
           :aSysRoles           => { :default => [], :type => 'array' , :description => 'Roles' },
@@ -79,6 +84,11 @@ module Invoracle
       return dSchema
     end
 
+    def inflate()
+      self.inflateFqdn
+      self.inflateSysRoles
+    end
+
     def inflateSysRoles()
       sSysRoles = self.getAttr(:sSysRoles)
       aSysRoles = self.getAttr(:aSysRoles)
@@ -101,5 +111,12 @@ module Invoracle
       end
       return false
     end
+
+    def inflateFqdn()
+      sVirHostFqdn = self.getAttr(:sVirHostFqdn)
+      sVirHostFqdn.strip!
+      sSysHostFqdn = sVirHostFqdn.length > 0 ? sVirHostFqdn : self.getAttr(:sSysFqdn)
+      self.setAttr(:sSysHostFqdn,sSysHostFqdn)
+    end
   end
 end

data/lib/invoracle/systems_set.rb

@@ -0,0 +1,126 @@
+module Invoracle
+
+  # Invoracle::SystemsSet maintains a group of Invoracle::System objects and
+  # their associated cluster UIDs.
+  #
+  # Initial use case is to create sets of Invoracle::Systems and then retrieve
+  # them by Cluster UID.
+  #
+  # Examples
+  #
+  #    systemsSet = Invoracle::SystemsSet.new
+  #    systemsSet.addSystem( system )
+  #    systemsSet.getSystem( systemUid )
+  #    systemsSet.exists?(   system )
+  #
+  #    systemsSet.getClusterCount
+  #    systemsSet.getSystemCount
+  #
+  #    systemsSet.getClusterUids
+  #
+  #    systemsSet.inflateSystems
+  #
+  #    systemsSet.getSystemsForClusterUid( clusterUid )
+
+  class SystemsSet
+    attr_reader :dSystemsBySysUid
+    attr_reader :dSysUidsbyCluUid
+    def initialize()
+      @dSystemsBySysUid = {}
+      @dSysUidsbyCluUid = {}
+    end
+
+    def getClusterCount()
+      return @dSysUidsbyCluUid.keys.length
+    end
+
+    def getSystemCount()
+      return @dSystemsBySysUid.keys.length
+    end
+
+    def getClusterUids()
+      aClusterUids = @dSysUidsbyCluUid.keys
+      aClusterUids.sort!
+      return aClusterUids
+    end
+
+    # Given an Invoracle::System, returns true or false if the system is 
+    # within the set
+
+    def exists?(oSystem=nil)
+      unless oSystem.is_a?(Invoracle::System)
+        raise ArgumentError, "E_BAD_SYSTEM_OBJECT #{oSystem.class}]"
+      end
+
+      sSysUid = oSystem.getAttr(:sSysUid)
+      unless sSysUid.kind_of?(String) && sSysUid.length > 0
+        raise ArgumentError, 'E_BAD_SYSTEM_UID'
+      end
+
+      bHasSys = @dSystemsBySysUid.has_key?(sSysUid) ? true : false
+
+      return bHasSys
+    end
+
+    def getSystem(sSysUid=nil)
+      unless sSysUid.kind_of?(String) && sSysUid.length > 0
+        raise ArgumentError, 'E_BAD_SYSTEM_UID'
+      end
+
+      oSystem = @dSystemsBySysUid.has_key( sSysUid ) \
+        ? @dSystemsBySysUid[ sSysUid ] : nil
+
+      return oSystem
+    end
+
+    def setSystem(oSystem=nil)
+      unless oSystem.is_a?(Invoracle::System)
+        raise ArgumentError, 'E_BAD_SYSTEM_OBJECT'
+      end
+
+      sSysUid = oSystem.getAttr(:sSysUid)
+      unless sSysUid.kind_of?(String)
+        raise ArgumentError, 'E_BAD_SYSTEM_UID'
+      end
+
+      sSysUid.strip!
+      unless sSysUid.length > 0
+        raise ArgumentError, 'E_BAD_SYSTEM_UID'
+      end
+
+      @dSystemsBySysUid[ sSysUid ] = oSystem
+
+      sCluUid = oSystem.getAttr(:sCluUid)
+      if sCluUid.kind_of?(String) && sCluUid.length > 0
+        @dSysUidsbyCluUid[ sCluUid ] ||= {}
+        @dSysUidsbyCluUid[ sCluUid ][ sSysUid ] = 1
+      end
+    end
+
+    # Calls the #inflate method on each system in the set.
+
+    def inflateSystems()
+      @dSystemsBySysUid.keys.each do |sSysUid|
+        @dSystemsBySysUid[ sSysUid ].inflate
+      end
+    end
+
+    def getSystemsForClusterUid(sCluUid=nil)
+      unless sCluUid.kind_of?(String) && sCluUid.length > 0
+        raise ArgumentError, 'E_BAD_CLUSTER_UID'
+      end
+
+      aSystems = []
+      if @dSysUidsbyCluUid.has_key?( sCluUid )
+        @dSysUidsbyCluUid[ sCluUid ].keys.each do |sSysUid|
+          if @dSystemsBySysUid.has_key?( sSysUid )
+            oSystem = @dSystemsBySysUid[ sSysUid ]
+            aSystems.push( oSystem )
+          end
+        end
+      end
+      return aSystems
+    end
+
+  end
+end

metadata

@@ -1,27 +1,21 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: invoracle
-version: !ruby/object:Gem::Version 
-  prerelease: 
-  version: 0.0.3
+version: !ruby/object:Gem::Version
+  version: 0.0.4
 platform: ruby
-authors: 
+authors:
 - John Wang
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2014-03-05 00:00:00 Z
+date: 2014-03-08 00:00:00.000000000 Z
 dependencies: []
-
 description: A simple generic inventory system for managing computer systems.
 email: john@johnwang.com
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
 - CHANGELOG.md
 - LICENSE
 - README.md
@@ -29,36 +23,33 @@ files:
 - VERSION
 - lib/invoracle.rb
 - lib/invoracle/cluster.rb
-- lib/invoracle/system.rb
 - lib/invoracle/infra.rb
 - lib/invoracle/infra/iostat_parser.rb
+- lib/invoracle/system.rb
+- lib/invoracle/systems_set.rb
 - test/test_setup.rb
 homepage: http://johnwang.com/
-licenses: 
+licenses:
 - MIT
+metadata: {}
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
   - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
   - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.8.11
+rubygems_version: 2.2.1
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Inventory Oracle - inventory management system
 test_files: []
-