eryph-compute 0.1.1

data/lib/eryph/compute/generated/spec/spec_helper.rb

@@ -0,0 +1,111 @@
+=begin
+#Compute Api
+
+#Compute Api
+
+The version of the OpenAPI document: 1.0
+Contact: support@dbosoft.eu
+Generated by: https://openapi-generator.tech
+Generator version: 7.14.0
+
+=end
+
+# load the gem
+require 'compute_client'
+
+# The following  was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# The generated `.rspec` file contains `--require spec_helper` which will cause
+# this file to always be loaded, without a need to explicitly require it in any
+# files.
+#
+# Given that it is always loaded, you are encouraged to keep this file as
+# light-weight as possible. Requiring heavyweight dependencies from this file
+# will add to the boot time of your test suite on EVERY test run, even for an
+# individual file that may not need all of that loaded. Instead, consider making
+# a separate helper file that requires the additional dependencies and performs
+# the additional setup, and require it from the spec files that actually need
+# it.
+#
+# The `.rspec` file also contains a few flags that are not defaults but that
+# users commonly want.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text for helper methods
+    # defined using `chain`, e.g.:
+    #     be_bigger_than(2).and_smaller_than(4).description
+    #     # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #     # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+# The settings below are suggested to provide a good initial experience
+# with RSpec, but feel free to customize to your heart's content.
+=begin
+  # These two settings work together to allow you to limit a spec run
+  # to individual examples or groups you care about by tagging them with
+  # `:focus` metadata. When nothing is tagged with `:focus`, all examples
+  # get run.
+  config.filter_run :focus
+  config.run_all_when_everything_filtered = true
+
+  # Allows RSpec to persist some state between runs in order to support
+  # the `--only-failures` and `--next-failure` CLI options. We recommend
+  # you configure your source control system to ignore this file.
+  config.example_status_persistence_file_path = "spec/examples.txt"
+
+  # Limits the available syntax to the non-monkey patched syntax that is
+  # recommended. For more details, see:
+  #   - http://rspec.info/blog/2012/06/rspecs-new-expectation-syntax/
+  #   - http://www.teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+  #   - http://rspec.info/blog/2014/05/notable-changes-in-rspec-3/#zero-monkey-patching-mode
+  config.disable_monkey_patching!
+
+  # This setting enables warnings. It's recommended, but in some cases may
+  # be too noisy due to issues in dependencies.
+  config.warnings = true
+
+  # Many RSpec users commonly either run the entire suite or an individual
+  # file, and it's useful to allow more verbose output when running an
+  # individual spec file.
+  if config.files_to_run.one?
+    # Use the documentation formatter for detailed output,
+    # unless a formatter has already been configured
+    # (e.g. via a command-line flag).
+    config.default_formatter = 'doc'
+  end
+
+  # Print the 10 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  config.profile_examples = 10
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce
+  # test failures related to randomization by passing the same `--seed` value
+  # as the one that triggered the failure.
+  Kernel.srand config.seed
+=end
+end

data/lib/eryph/compute/generated.rb

@@ -0,0 +1,137 @@
+# Generated by OpenAPI Generator: https://openapi-generator.tech
+# Do not edit this file manually - it will be overwritten during regeneration
+
+# Add the generated lib directory to the load path
+# Try multiple path resolution strategies for different contexts (development vs gem)
+generated_lib_paths = [
+  File.expand_path('generated/lib', __dir__), # Development path
+  File.expand_path('generated/lib', File.dirname(__FILE__)), # From current file directory
+  File.expand_path('../compute/generated/lib', __dir__), # Alternative relative path
+  File.expand_path('../../../compute/generated/lib', __dir__), # From gem context
+]
+
+# Debug: print attempted paths in development mode
+if ENV['ERYPH_DEBUG'] || $DEBUG
+  puts 'DEBUG: Attempting to find generated client in:'
+  generated_lib_paths.each_with_index do |path, i|
+    exists = File.exist?(path)
+    puts "  #{i + 1}. #{path} (exists: #{exists})"
+  end
+end
+
+generated_lib_path = generated_lib_paths.find { |path| File.exist?(path) }
+
+if generated_lib_path
+  $LOAD_PATH.unshift(generated_lib_path) unless $LOAD_PATH.include?(generated_lib_path)
+
+  begin
+    require 'compute_client'
+  rescue LoadError => e
+    # More detailed error in debug mode
+    error_msg = "Failed to load compute_client from #{generated_lib_path}: #{e.message}"
+    if ENV['ERYPH_DEBUG'] || $DEBUG
+      error_msg += "\nLoad path: #{$LOAD_PATH.join(':')}"
+      if File.exist?(generated_lib_path)
+        error_msg += "\nFiles in #{generated_lib_path}: #{Dir.entries(generated_lib_path).join(', ')}"
+      end
+    end
+    raise LoadError, "#{error_msg}. Please run generate.rb to regenerate the client."
+  end
+else
+  raise LoadError,
+        'Generated compute client directory not found in any of: ' \
+        "#{generated_lib_paths.join(', ')}. Please run generate.rb to regenerate the client."
+end
+
+module Eryph
+  # Create ComputeClient namespace that mirrors the generated ComputeClient module
+  module ComputeClient
+    # Re-export all core classes
+    ApiClient = ::ComputeClient::ApiClient
+    Configuration = ::ComputeClient::Configuration
+    ApiError = ::ComputeClient::ApiError
+
+    # Re-export all API endpoint classes
+    CatletsApi = ::ComputeClient::CatletsApi
+    GenesApi = ::ComputeClient::GenesApi
+    OperationsApi = ::ComputeClient::OperationsApi
+    ProjectMembersApi = ::ComputeClient::ProjectMembersApi
+    ProjectsApi = ::ComputeClient::ProjectsApi
+    VersionApi = ::ComputeClient::VersionApi
+    VirtualDisksApi = ::ComputeClient::VirtualDisksApi
+    VirtualNetworksApi = ::ComputeClient::VirtualNetworksApi
+
+    # Re-export all model classes
+    ApiVersion = ::ComputeClient::ApiVersion
+    ApiVersionResponse = ::ComputeClient::ApiVersionResponse
+    Catlet = ::ComputeClient::Catlet
+    CatletConfigOperationResult = ::ComputeClient::CatletConfigOperationResult
+    CatletConfigValidationResult = ::ComputeClient::CatletConfigValidationResult
+    CatletConfiguration = ::ComputeClient::CatletConfiguration
+    CatletDrive = ::ComputeClient::CatletDrive
+    CatletDriveType = ::ComputeClient::CatletDriveType
+    CatletList = ::ComputeClient::CatletList
+    CatletNetwork = ::ComputeClient::CatletNetwork
+    CatletNetworkAdapter = ::ComputeClient::CatletNetworkAdapter
+    CatletStatus = ::ComputeClient::CatletStatus
+    CatletStopMode = ::ComputeClient::CatletStopMode
+    DiskStatus = ::ComputeClient::DiskStatus
+    ExpandCatletConfigRequestBody = ::ComputeClient::ExpandCatletConfigRequestBody
+    ExpandNewCatletConfigRequest = ::ComputeClient::ExpandNewCatletConfigRequest
+    FloatingNetworkPort = ::ComputeClient::FloatingNetworkPort
+    Gene = ::ComputeClient::Gene
+    GeneList = ::ComputeClient::GeneList
+    GeneType = ::ComputeClient::GeneType
+    GeneWithUsage = ::ComputeClient::GeneWithUsage
+    NewCatletRequest = ::ComputeClient::NewCatletRequest
+    NewProjectMemberBody = ::ComputeClient::NewProjectMemberBody
+    NewProjectRequest = ::ComputeClient::NewProjectRequest
+    NewVirtualDiskRequest = ::ComputeClient::NewVirtualDiskRequest
+    Operation = ::ComputeClient::Operation
+    OperationList = ::ComputeClient::OperationList
+    OperationLogEntry = ::ComputeClient::OperationLogEntry
+    OperationResource = ::ComputeClient::OperationResource
+    OperationResult = ::ComputeClient::OperationResult
+    OperationStatus = ::ComputeClient::OperationStatus
+    OperationTask = ::ComputeClient::OperationTask
+    OperationTaskReference = ::ComputeClient::OperationTaskReference
+    OperationTaskStatus = ::ComputeClient::OperationTaskStatus
+    PopulateCatletConfigVariablesRequest = ::ComputeClient::PopulateCatletConfigVariablesRequest
+    ProblemDetails = ::ComputeClient::ProblemDetails
+    Project = ::ComputeClient::Project
+    ProjectList = ::ComputeClient::ProjectList
+    ProjectMemberRole = ::ComputeClient::ProjectMemberRole
+    ProjectMemberRoleList = ::ComputeClient::ProjectMemberRoleList
+    ResourceType = ::ComputeClient::ResourceType
+    StopCatletRequestBody = ::ComputeClient::StopCatletRequestBody
+    TaskReferenceType = ::ComputeClient::TaskReferenceType
+    UpdateCatletRequestBody = ::ComputeClient::UpdateCatletRequestBody
+    UpdateProjectNetworksRequestBody = ::ComputeClient::UpdateProjectNetworksRequestBody
+    ValidateConfigRequest = ::ComputeClient::ValidateConfigRequest
+    ValidationIssue = ::ComputeClient::ValidationIssue
+    VirtualDisk = ::ComputeClient::VirtualDisk
+    VirtualDiskAttachedCatlet = ::ComputeClient::VirtualDiskAttachedCatlet
+    VirtualDiskGeneInfo = ::ComputeClient::VirtualDiskGeneInfo
+    VirtualDiskList = ::ComputeClient::VirtualDiskList
+    VirtualNetwork = ::ComputeClient::VirtualNetwork
+    VirtualNetworkConfiguration = ::ComputeClient::VirtualNetworkConfiguration
+    VirtualNetworkList = ::ComputeClient::VirtualNetworkList
+  end
+
+  # Keep the old Generated namespace for backward compatibility
+  module Generated
+    # Alias the main classes for backward compatibility
+    NewCatletRequest = ::ComputeClient::NewCatletRequest
+    StopCatletRequestBody = ::ComputeClient::StopCatletRequestBody
+    CatletStopMode = ::ComputeClient::CatletStopMode
+    ApiClient = ::ComputeClient::ApiClient
+    Configuration = ::ComputeClient::Configuration
+  end
+
+  module Compute
+    module Generated
+      # Re-export the generated client classes for easier access
+      Client = ::ComputeClient
+    end
+  end
+end

data/lib/eryph/compute/operation_result.rb

@@ -0,0 +1,255 @@
+require 'cgi'
+require 'json'
+
+module Eryph
+  module Compute
+    # Typed result for CatletConfig operations
+    CatletConfigResult = Struct.new(:result_type, :configuration, keyword_init: true) do
+      def self.from_raw_json(raw_json)
+        parsed = JSON.parse(raw_json)
+        new(
+          result_type: 'CatletConfig',
+          configuration: parsed.dig('result', 'configuration')
+        )
+      rescue JSON::ParserError
+        new(result_type: 'CatletConfig', configuration: nil)
+      end
+
+      # Convenience methods
+      def configuration?
+        !configuration.nil?
+      end
+
+      def name
+        configuration['name'] if configuration
+      end
+
+      def parent
+        configuration['parent'] if configuration
+      end
+    end
+
+    # Wrapper class for operation results that provides convenient access
+    # to operation state and resources
+    class OperationResult
+      attr_reader :operation, :client
+
+      def initialize(operation, client, raw_operation_json = nil)
+        @operation = operation
+        @client = client
+        @fetched_resources = {}
+        @cached_collections = {}
+        @raw_operation_json = raw_operation_json # Cache the raw JSON if provided
+      end
+
+      def id
+        @operation.id
+      end
+
+      def status
+        @operation.status
+      end
+
+      def completed?
+        @operation.status == 'Completed'
+      end
+
+      def failed?
+        @operation.status == 'Failed'
+      end
+
+      def running?
+        @operation.status == 'Running'
+      end
+
+      def queued?
+        @operation.status == 'Queued'
+      end
+
+      def status_message
+        @operation.status_message
+      end
+
+      # Get the raw resource references from the operation
+      def resources
+        @operation.resources || []
+      end
+
+      # Get the raw tasks from the operation
+      def tasks
+        @operation.tasks || []
+      end
+
+      # Get the raw log entries from the operation
+      def log_entries
+        @operation.log_entries || []
+      end
+
+      # Get the projects from the operation
+      def projects
+        @operation.projects || []
+      end
+
+      # Get the raw operation result object
+      # @return [Object, nil] the raw result object from the operation
+      def result
+        @operation.result
+      end
+
+      # Check if the operation has a result
+      # @return [Boolean] true if the operation has a result
+      def result?
+        !@operation.result.nil?
+      end
+
+      # Get the result type discriminator
+      # @return [String, nil] the result type or nil if no result
+      def result_type
+        return nil unless result?
+
+        @operation.result.result_type
+      end
+
+      # Get typed result based on result_type
+      # @return [Struct, nil] typed result or nil
+      def typed_result
+        return @typed_result if defined?(@typed_result)
+
+        return nil unless result?
+
+        @typed_result = case result_type
+                        when 'CatletConfig'
+                          if @raw_operation_json
+                            @client.logger.info 'Creating typed CatletConfigResult from raw JSON'
+                            CatletConfigResult.from_raw_json(@raw_operation_json)
+                          else
+                            @client.logger.warn 'No raw JSON available for typed result creation'
+                            CatletConfigResult.new(result_type: 'CatletConfig', configuration: nil)
+                          end
+                        else
+                          @client.logger.warn "Unknown operation result type: #{result_type}" if result_type
+                          nil
+                        end
+      end
+
+      # Fetch actual resource objects (lazy loading with caching)
+      # @return [Array] array of fetched resource objects
+      def fetch_resources
+        resources.map do |resource|
+          fetch_resource(resource)
+        end.compact
+      end
+
+      # Fetch a specific resource by its reference
+      # @param resource_ref [Object] the resource reference from operation.resources
+      # @return [Object, nil] the fetched resource object or nil if failed
+      def fetch_resource(resource_ref)
+        cache_key = "#{resource_ref.resource_type}:#{resource_ref.resource_id}"
+
+        return @fetched_resources[cache_key] if @fetched_resources.key?(cache_key)
+
+        @fetched_resources[cache_key] = begin
+          case resource_ref.resource_type
+          when 'Catlet'
+            @client.catlets.catlets_get(resource_ref.resource_id)
+          when 'VirtualDisk'
+            @client.virtual_disks.virtual_disks_get(resource_ref.resource_id)
+          when 'VirtualNetwork'
+            @client.virtual_networks.virtual_networks_get(resource_ref.resource_id)
+          else
+            @client.logger.warn "Unknown resource type: #{resource_ref.resource_type}"
+            nil
+          end
+        rescue StandardError => e
+          @client.logger.error "Error fetching #{resource_ref.resource_type.downcase} " \
+                               "#{resource_ref.resource_id}: #{e.message}"
+          nil
+        end
+      end
+
+      # Find raw resource references by type
+      # @param type [String] the resource type to filter by
+      # @return [Array] array of resource references
+      def find_resources_by_type(type)
+        resources.select { |r| r.resource_type == type }
+      end
+
+      # Get all catlet objects created by this operation
+      # @return [Array] array of catlet objects
+      def catlets
+        @cached_collections[:catlets] ||= find_resources_by_type('Catlet').map { |r| fetch_resource(r) }.compact
+      end
+
+      # Get all virtual disk objects created by this operation
+      # @return [Array] array of virtual disk objects
+      def virtual_disks
+        @cached_collections[:virtual_disks] ||= find_resources_by_type('VirtualDisk').map do |r|
+          fetch_resource(r)
+        end.compact
+      end
+
+      # Get all virtual network objects created by this operation
+      # @return [Array] array of virtual network objects
+      def virtual_networks
+        @cached_collections[:virtual_networks] ||= find_resources_by_type('VirtualNetwork').map do |r|
+          fetch_resource(r)
+        end.compact
+      end
+
+
+      # Get the first catlet if this operation created one
+      # @return [Object, nil] the first catlet or nil
+      def catlet
+        catlets.first
+      end
+
+      # Get the first virtual disk if this operation created one
+      # @return [Object, nil] the first virtual disk or nil
+      def virtual_disk
+        virtual_disks.first
+      end
+
+      # Get the first virtual network if this operation created one
+      # @return [Object, nil] the first virtual network or nil
+      def virtual_network
+        virtual_networks.first
+      end
+
+      # Get the first project from the operation
+      # @return [Object, nil] the first project or nil
+      def project
+        projects.first
+      end
+
+      # Get operation summary with counts and resource type breakdown
+      # @return [Hash] summary hash with operation details
+      def summary
+        resource_counts = Hash.new(0)
+        resources.each do |resource|
+          resource_counts[resource.resource_type] += 1
+        end
+
+        {
+          operation_id: id,
+          status: status,
+          status_message: status_message,
+          log_entries_count: log_entries.size,
+          tasks_count: tasks.size,
+          resources_count: resources.size,
+          resource_types: resource_counts,
+          has_result: result?,
+          result_type: result_type,
+        }
+      end
+
+      # String representation
+      def to_s
+        "#<OperationResult id=#{id} status=#{status} resources=#{resources.size}>"
+      end
+
+      def inspect
+        to_s
+      end
+    end
+  end
+end