idrac 0.4.5 → 0.4.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ffcb1d99822a0e7d0015f018b6967e3977d7506438a3e2d917e0615f281aa0e3
-  data.tar.gz: 188a912ccdcdb5712ead6b5f181d59902f9b50718e3c3e39e2949f6fbc7ad606
+  metadata.gz: 7df39736fab2faa7b64224202408ac4a96034c0b2d8f21999b4c20a93f1e0bdf
+  data.tar.gz: 79d5162af8bb949440c2b10a3e1d7b5504ed982122595e4263c9da30128cb4f1
 SHA512:
-  metadata.gz: dfd1714f7a86b37991a7493be186043be14a400f6e36d7712c366c1007857eee7eb4ece8390187a56f7faa921f46ffdf9ad1250ff471daf3ad2ccd884c14cda2
-  data.tar.gz: 20d5a051050da7a5b75d08529d16e2806af72ac05161393dd1a5cca509f17b2ec497f7a9b2f9c3f0933af72394b81696ae88b48736b6de67bd8ab7ae43319b25
+  metadata.gz: 64265ea0635c641ec072bd3b6737c9e706998507dbffd6c28c3f364576655101412fadfedb9aa3aa9997957f95d85e9649c1a7c2cc5ed661935334ab556ceb0a
+  data.tar.gz: 3b758f2a38ec01b9c07812ed3464b603c77ee258411d74fb5e97f29183bbcec25cee29119a0e3a7e30fc2ef6fd76ec950938487731d04d3aa99c72babf0a08ba

data/README.md

@@ -15,6 +15,7 @@ A Ruby client for the Dell iDRAC API. This gem provides a command-line interface
 - Job queue management (clear, monitor, list)
 - Lifecycle log and System Event Log (SEL) management
 - Lifecycle Controller status management
+- Return values as RecursiveOpenStruct objects for convenient attribute access
 
 ## Installation
 
@@ -170,6 +171,25 @@ client.clear_lifecycle!
 # Clear System Event Logs
 client.clear_system_event_logs!
 
+# Working with RecursiveOpenStruct objects
+# Many methods return data as RecursiveOpenStruct objects for easier property access
+
+# Get memory information
+memory_modules = client.memory
+memory_modules.each do |dimm|
+  # Access properties directly as methods
+  puts "#{dimm.name}: #{dimm.capacity_bytes / (1024**3)}GB, Speed: #{dimm.speed_mhz}MHz"
+end
+
+# Get storage information
+controller = client.controller
+volumes = client.volumes(controller)
+volumes.each do |volume|
+  # Access properties via dot notation
+  puts "#{volume.name} (#{volume.raid_level}): #{volume.capacity_bytes / (1024**3)}GB"
+  puts "  Health: #{volume.health}, FastPath: #{volume.fastpath}"
+end
+
 # Create a client with auto_delete_sessions disabled
 client = IDRAC.new(
   host: '192.168.1.100',
@@ -187,6 +207,12 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 ## Changelog
 
+### Version 0.1.40
+- **Enhanced Return Values**: Methods that return system components now provide RecursiveOpenStruct objects
+  - Memory, drives, volumes, PSUs, and fans now support convenient dot notation for attribute access
+  - Improved object structure with consistent property naming across different component types
+  - Better code organization and readability when working with returned objects
+
 ### Version 0.1.39
 - **Added Job Management**: New methods for managing iDRAC jobs
   - List jobs using `jobs` and `jobs_detail`

data/bin/idrac

@@ -1103,6 +1103,28 @@ module IDRAC
       end
     end
 
+    desc "system_info", "Get detailed system identification information"
+    map "system:info" => :system_info
+    def system_info
+      with_idrac_client do |client|
+        info = client.system_info
+        
+        if info[:is_dell]
+          puts "Dell iDRAC System:".green.bold
+          puts "  Service Tag: #{info[:service_tag]}".cyan
+          puts "  Model: #{info[:model]}".cyan
+          puts "  iDRAC Version: #{info[:idrac_version]}".cyan
+          puts "  Firmware Version: #{info[:firmware_version]}".cyan
+        else
+          puts "Not a Dell iDRAC system".yellow
+          puts "  Product: #{info[:product]}".cyan
+          if info[:is_ancient_dell]
+            puts "  Ancient Dell System detected. Update firmware.".yellow
+          end
+        end
+      end
+    end
+
     # Test commands
     desc "test_live", "Test all major functionality of the gem on a real system"
     map "test:live" => :test_live

data/lib/idrac/system.rb

@@ -332,6 +332,67 @@ module IDRAC
       return nics_with_pci
     end
 
+    # Get system identification information
+    def system_info
+      response = authenticated_request(:get, "/redfish/v1")
+      
+      if response.status == 200
+        begin
+          data = JSON.parse(response.body)
+          
+          # Initialize return hash with defaults
+          info = {
+            is_dell: false,
+            is_ancient_dell: false,
+            product: data["Product"] || "Unknown",
+            service_tag: nil,
+            model: nil,
+            idrac_version: data["RedfishVersion"],
+            firmware_version: nil
+          }
+          
+          # Check if it's a Dell iDRAC
+          if data["Product"] == "Integrated Dell Remote Access Controller"
+            info[:is_dell] = true
+            
+            # Get service tag from Dell OEM data
+            info[:service_tag] = data.dig("Oem", "Dell", "ServiceTag")
+            
+            # Get firmware version - try both common locations
+            info[:firmware_version] = data["FirmwareVersion"] || data.dig("Oem", "Dell", "FirmwareVersion")
+            
+            # Get additional system information
+            system_response = authenticated_request(:get, "/redfish/v1/Systems/System.Embedded.1")
+            if system_response.status == 200
+              system_data = JSON.parse(system_response.body)
+              info[:model] = system_data["Model"]
+            end
+          else
+            # Check if it's an older Dell model
+            begin
+              chassis_response = authenticated_request(:get, "/redfish/v1/Chassis/System.Embedded.1")
+              if chassis_response.status == 200
+                chassis_data = JSON.parse(chassis_response.body)
+                if chassis_data["Manufacturer"] && chassis_data["Manufacturer"].include?("Dell")
+                  info[:is_ancient_dell] = true
+                  info[:model] = chassis_data["Model"]
+                  info[:service_tag] = chassis_data["SKU"] || chassis_data["SerialNumber"]
+                end
+              end
+            rescue
+              # Ignore errors while checking for ancient Dell
+            end
+          end
+          
+          return info
+        rescue JSON::ParserError
+          raise Error, "Failed to parse system info response: #{response.body}"
+        end
+      else
+        raise Error, "Failed to get system info. Status code: #{response.status}"
+      end
+    end
+
     # Get system event logs
     def system_event_logs
       response = authenticated_request(:get, "/redfish/v1/Managers/iDRAC.Embedded.1/Logs/Sel?$expand=*($levels=1)")

data/lib/idrac/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module IDRAC
-  VERSION = "0.4.5"
+  VERSION = "0.4.6"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: idrac
 version: !ruby/object:Gem::Version
-  version: 0.4.5
+  version: 0.4.6
 platform: ruby
 authors:
 - Jonathan Siegel