radfish 0.1.0

data/lib/radfish/vendor_detector.rb

@@ -0,0 +1,199 @@
+# frozen_string_literal: true
+
+require 'net/http'
+require 'json'
+require 'uri'
+require 'openssl'
+
+module Radfish
+  class VendorDetector
+    
+    attr_reader :host, :username, :password, :port, :use_ssl, :verify_ssl
+    attr_accessor :verbosity
+    
+    def initialize(host:, username:, password:, port: 443, use_ssl: true, verify_ssl: false)
+      @host = host
+      @username = username
+      @password = password
+      @port = port
+      @use_ssl = use_ssl
+      @verify_ssl = verify_ssl
+      @verbosity = 0
+    end
+    
+    def detect
+      puts "Detecting vendor for #{host}..." if @verbosity && @verbosity > 0
+      
+      # Try to get the Redfish service root
+      service_root = fetch_service_root
+      return nil unless service_root
+      
+      vendor = identify_vendor(service_root)
+      puts "Detected vendor: #{vendor || 'Unknown'}" if @verbosity && @verbosity > 0
+      
+      vendor
+    end
+    
+    private
+    
+    def fetch_service_root
+      uri = URI("#{base_url}/redfish/v1")
+      
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = use_ssl
+      http.verify_mode = OpenSSL::SSL::VERIFY_NONE unless verify_ssl
+      http.open_timeout = 5
+      http.read_timeout = 10
+      
+      req = Net::HTTP::Get.new(uri)
+      req.basic_auth(username, password)
+      req['Accept'] = 'application/json'
+      
+      begin
+        res = http.request(req)
+        
+        if res.code.to_i == 200
+          JSON.parse(res.body)
+        else
+          puts "Failed to fetch service root: HTTP #{res.code}" if @verbosity && @verbosity > 0
+          nil
+        end
+      rescue => e
+        puts "Error fetching service root: #{e.message}" if @verbosity && @verbosity > 0
+        nil
+      end
+    end
+    
+    def identify_vendor(service_root)
+      # Check explicit vendor field
+      vendor = service_root['Vendor'] || service_root['Oem']&.keys&.first
+      
+      if vendor
+        return normalize_vendor(vendor)
+      end
+      
+      # Try to identify by product name
+      product = service_root['Product']
+      if product
+        case product
+        when /dell/i, /poweredge/i, /idrac/i
+          return 'dell'
+        when /supermicro/i, /smc/i
+          return 'supermicro'
+        when /hpe/i, /hewlett/i, /proliant/i, /ilo/i
+          return 'hpe'
+        when /lenovo/i, /thinkserver/i, /thinksystem/i
+          return 'lenovo'
+        when /asrockrack/i, /asrock/i
+          return 'asrockrack'
+        end
+      end
+      
+      # Check manager endpoint for more clues
+      managers_url = service_root.dig('Managers', '@odata.id')
+      if managers_url
+        vendor_from_managers = detect_from_managers(managers_url)
+        return vendor_from_managers if vendor_from_managers
+      end
+      
+      # Default to generic if we can't determine
+      'generic'
+    end
+    
+    def detect_from_managers(managers_path)
+      uri = URI("#{base_url}#{managers_path}")
+      
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = use_ssl
+      http.verify_mode = OpenSSL::SSL::VERIFY_NONE unless verify_ssl
+      http.open_timeout = 5
+      http.read_timeout = 10
+      
+      req = Net::HTTP::Get.new(uri)
+      req.basic_auth(username, password)
+      req['Accept'] = 'application/json'
+      
+      begin
+        res = http.request(req)
+        
+        if res.code.to_i == 200
+          data = JSON.parse(res.body)
+          
+          # Check first manager
+          if data['Members'] && data['Members'].first
+            manager_url = data['Members'].first['@odata.id']
+            
+            # Dell uses iDRAC.Embedded.1
+            return 'dell' if manager_url.include?('iDRAC')
+            
+            # HPE uses numbered managers like /redfish/v1/Managers/1
+            # Supermicro also uses /redfish/v1/Managers/1
+            # Need to fetch actual manager data
+            
+            manager_data = fetch_manager(manager_url)
+            if manager_data
+              # Check manager model/description
+              model = manager_data['Model'] || ''
+              description = manager_data['Description'] || ''
+              # firmware = manager_data['FirmwareVersion'] || ''  # Reserved for future use
+              
+              return 'dell' if model.match?(/idrac/i) || description.match?(/idrac/i)
+              return 'hpe' if model.match?(/ilo/i) || description.match?(/ilo/i)
+              return 'supermicro' if model.match?(/supermicro/i) || description.match?(/smc/i)
+              return 'lenovo' if model.match?(/lenovo/i) || description.match?(/xcc/i)
+              return 'asrockrack' if model.match?(/asrock/i)
+            end
+          end
+        end
+      rescue => e
+        puts "Error detecting from managers: #{e.message}" if @verbosity && @verbosity > 1
+      end
+      
+      nil
+    end
+    
+    def fetch_manager(manager_path)
+      uri = URI("#{base_url}#{manager_path}")
+      
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = use_ssl
+      http.verify_mode = OpenSSL::SSL::VERIFY_NONE unless verify_ssl
+      http.open_timeout = 5
+      http.read_timeout = 10
+      
+      req = Net::HTTP::Get.new(uri)
+      req.basic_auth(username, password)
+      req['Accept'] = 'application/json'
+      
+      begin
+        res = http.request(req)
+        JSON.parse(res.body) if res.code.to_i == 200
+      rescue => e
+        puts "Error fetching manager: #{e.message}" if @verbosity && @verbosity > 1
+        nil
+      end
+    end
+    
+    def normalize_vendor(vendor_string)
+      case vendor_string.to_s.downcase
+      when /dell/i, /idrac/i
+        'dell'
+      when /supermicro/i, /smc/i
+        'supermicro'
+      when /hpe/i, /hewlett/i, /hp/i, /ilo/i
+        'hpe'
+      when /lenovo/i
+        'lenovo'
+      when /asrock/i
+        'asrockrack'
+      else
+        vendor_string.to_s.downcase
+      end
+    end
+    
+    def base_url
+      protocol = use_ssl ? 'https' : 'http'
+      "#{protocol}://#{host}:#{port}"
+    end
+  end
+end

data/lib/radfish/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Radfish
+  VERSION = "0.1.0"
+end

data/lib/radfish.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+require 'httparty'
+require 'faraday'
+require 'faraday/multipart'
+require 'base64'
+require 'uri'
+require 'json'
+require 'colorize'
+require 'active_support'
+require 'active_support/core_ext'
+
+module Radfish
+  class Error < StandardError; end
+  class AuthenticationError < Error; end
+  class ConnectionError < Error; end
+  class NotFoundError < Error; end
+  class TimeoutError < Error; end
+  class UnsupportedVendorError < Error; end
+
+  module Debuggable
+    def debug(message, level = 1, color = :light_cyan)
+      return unless respond_to?(:verbosity) && verbosity >= level
+      color_method = color.is_a?(Symbol) && String.method_defined?(color) ? color : :to_s
+      puts message.send(color_method)
+      
+      if respond_to?(:verbosity) && verbosity >= 3 && caller.length > 1
+        puts "  Called from:".light_yellow
+        caller[1..3].each do |call|
+          puts "    #{call}".light_yellow
+        end
+      end
+    end
+  end
+
+  class << self
+    def new(options = {})
+      Client.new(options)
+    end
+    
+    def connect(**options, &block)
+      Client.connect(**options, &block)
+    end
+
+    def detect_vendor(host:, username:, password:, **options)
+      VendorDetector.new(host: host, username: username, password: password, **options).detect
+    end
+
+    def register_adapter(vendor, adapter_class)
+      @adapters ||= {}
+      @adapters[vendor.to_s.downcase] = adapter_class
+    end
+
+    def get_adapter(vendor)
+      @adapters ||= {}
+      @adapters[vendor.to_s.downcase]
+    end
+
+    def supported_vendors
+      @adapters&.keys || []
+    end
+  end
+end
+
+require 'radfish/version'
+require 'radfish/core/base_client'
+require 'radfish/core/session'
+require 'radfish/core/power'
+require 'radfish/core/system'
+require 'radfish/core/storage'
+require 'radfish/core/virtual_media'
+require 'radfish/core/boot'
+require 'radfish/core/jobs'
+require 'radfish/core/utility'
+require 'radfish/vendor_detector'
+require 'radfish/client'
+
+# Auto-load adapters if available
+begin
+  require 'radfish/idrac_adapter'
+rescue LoadError
+  # radfish-idrac gem not installed
+end
+
+begin
+  require 'radfish/supermicro_adapter'
+rescue LoadError
+  # radfish-supermicro gem not installed
+end

data/radfish.gemspec

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require_relative "lib/radfish/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "radfish"
+  spec.version = Radfish::VERSION
+  spec.authors = ["Jonathan Siegel"]
+  spec.email = ["248302+usiegj00@users.noreply.github.com"]
+
+  spec.summary = "Unified Redfish API Client for Server Management"
+  spec.description = "A Ruby client library that provides a unified interface for managing servers via Redfish API across multiple hardware vendors (Dell, HPE, Supermicro, etc.) with automatic vendor detection and adaptation"
+  spec.homepage = "https://github.com/buildio/radfish"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 2.7.0"
+
+  spec.metadata["allowed_push_host"] = "https://rubygems.org"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/buildio/radfish"
+  spec.metadata["changelog_uri"] = "https://github.com/buildio/radfish/blob/main/CHANGELOG.md"
+
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    Dir["{exe,lib}/**/*", "LICENSE", "Rakefile", "README.md", "*.gemspec"]
+  end
+
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "thor", "~> 1.2"
+  spec.add_dependency "httparty", "~> 0.21"
+  spec.add_dependency "faraday", "~> 2.0"
+  spec.add_dependency "faraday-multipart", "~> 1.0"
+  spec.add_dependency "nokogiri", "~> 1.14"
+  spec.add_dependency "colorize", ">= 0.8"
+  spec.add_dependency "activesupport", "~> 7.0"
+  
+  # Include common vendor adapters by default
+  spec.add_dependency "radfish-supermicro", "~> 0.1"
+  spec.add_dependency "radfish-idrac", "~> 0.1"
+  
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "webmock", "~> 3.0"
+  spec.add_development_dependency "debug", "~> 1.0"
+end

metadata

@@ -0,0 +1,238 @@
+--- !ruby/object:Gem::Specification
+name: radfish
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jonathan Siegel
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-08-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.21'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.21'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: faraday-multipart
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: radfish-supermicro
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: radfish-idrac
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: debug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description: A Ruby client library that provides a unified interface for managing
+  servers via Redfish API across multiple hardware vendors (Dell, HPE, Supermicro,
+  etc.) with automatic vendor detection and adaptation
+email:
+- 248302+usiegj00@users.noreply.github.com
+executables:
+- radfish
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- Rakefile
+- exe/radfish
+- lib/radfish.rb
+- lib/radfish/cli.rb
+- lib/radfish/cli/base.rb
+- lib/radfish/client.rb
+- lib/radfish/core/base_client.rb
+- lib/radfish/core/boot.rb
+- lib/radfish/core/jobs.rb
+- lib/radfish/core/power.rb
+- lib/radfish/core/session.rb
+- lib/radfish/core/storage.rb
+- lib/radfish/core/system.rb
+- lib/radfish/core/utility.rb
+- lib/radfish/core/virtual_media.rb
+- lib/radfish/vendor_detector.rb
+- lib/radfish/version.rb
+- radfish.gemspec
+homepage: https://github.com/buildio/radfish
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/buildio/radfish
+  source_code_uri: https://github.com/buildio/radfish
+  changelog_uri: https://github.com/buildio/radfish/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.26
+signing_key:
+specification_version: 4
+summary: Unified Redfish API Client for Server Management
+test_files: []