comet_backup_ruby_sdk 2.41.0 → 2.42.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c972fed511fa56a76cf96c42f8559faddcc003fc4378616bb5b91ec0d45ef210
-  data.tar.gz: 945063cd41af3fb4b56728e2374e99c4463c18e7ca68ee6a916829d31c406959
+  metadata.gz: b1ce12d259b4709b8f945a3ab03c5aaa3affa2bf686d8db13a579efa734352ca
+  data.tar.gz: dccfbf9c48da859196a0ea45fd546e48869c696860b19b9e0e17275a9ad00ff1
 SHA512:
-  metadata.gz: 4d84b541b325ded6b7f1ee7b111a2ef8110b2774b3097c1e1aa26d282543ece740fc6ec5eefaa14a6393f737c3525f4bc316f65b9ddbd135a3b664b3d3890d56
-  data.tar.gz: d5e8829fe4a04d7f792f4a982f9fe2ae4296de440845d494ccae9d644c8c3743bf7300db0460ba7015355cc821b862b7a28de7ce75d124822923e77b5624cb42
+  metadata.gz: ca9afca76f9b80e1f66e22c05bacd2615be2f644f8b3d6db2caf5eb8f25736bb2e4afa73648dd6eaae0985ec2a92626edbba4a523edc43a410733ae7c2ab7f17
+  data.tar.gz: 9e6c3ce78d176e8c37966a00e2a33e835da5ed4e32295223d8e4fb9a07530d4a593288732b2a2c714690948ea3a3c4d5f7bf13455abce00ed2f791766e0cd825

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # CHANGELOG
 
+## 2025-08-15 v2.42.0
+
+- Based on Comet 25.6.8
+- Add support for Proxmox
+- Add profile hash to some API endpoints
+
 ## 2025-02-17 v2.41.0
 Update to 24.12.5
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    comet_backup_ruby_sdk (2.41.0)
+    comet_backup_ruby_sdk (2.42.0)
 
 GEM
   remote: https://rubygems.org/

data/comet_backup_ruby_sdk.gemspec

@@ -12,7 +12,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |spec|
   spec.name          = 'comet_backup_ruby_sdk'
-  spec.version       = '2.41.0'
+  spec.version       = '2.42.0'
   spec.authors       = ['Comet Licensing Ltd.']
   spec.email         = ['hello@cometbackup.com']
 

data/lib/comet/comet_server.rb

@@ -1749,6 +1749,87 @@ module Comet
       ret
     end
 
+    # AdminDispatcherRequestBrowseProxmox
+    #
+    # Request a list of Proxmox virtual machines and containers.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] target_id The live connection GUID
+    # @param [Comet::ProxmoxConnection] credentials The Proxmox connection settings
+    # @return [Comet::BrowseProxmoxResponse]
+    def admin_dispatcher_request_browse_proxmox(target_id, credentials)
+      submit_params = {}
+      raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
+
+      submit_params['TargetID'] = target_id
+      raise TypeError, "'credentials' expected Comet::ProxmoxConnection, got #{credentials.class}" unless credentials.is_a? Comet::ProxmoxConnection
+
+      submit_params['Credentials'] = credentials.to_json
+
+      body = perform_request('api/v1/admin/dispatcher/request-browse-proxmox', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::BrowseProxmoxResponse.new
+      ret.from_hash(json_body)
+      ret
+    end
+
+    # AdminDispatcherRequestBrowseProxmoxNodes
+    #
+    # Request a list of Proxmox nodes.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] target_id The live connection GUID
+    # @param [Comet::SSHConnection] credentials The SSH connection settings
+    # @return [Comet::BrowseProxmoxNodesResponse]
+    def admin_dispatcher_request_browse_proxmox_nodes(target_id, credentials)
+      submit_params = {}
+      raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
+
+      submit_params['TargetID'] = target_id
+      raise TypeError, "'credentials' expected Comet::SSHConnection, got #{credentials.class}" unless credentials.is_a? Comet::SSHConnection
+
+      submit_params['Credentials'] = credentials.to_json
+
+      body = perform_request('api/v1/admin/dispatcher/request-browse-proxmox/nodes', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::BrowseProxmoxNodesResponse.new
+      ret.from_hash(json_body)
+      ret
+    end
+
+    # AdminDispatcherRequestBrowseProxmoxStorage
+    #
+    # Request a list of configured Proxmox storage.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] target_id The live connection GUID
+    # @param [Comet::SSHConnection] credentials The SSH connection settings
+    # @return [Comet::BrowseProxmoxStorageResponse]
+    def admin_dispatcher_request_browse_proxmox_storage(target_id, credentials)
+      submit_params = {}
+      raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
+
+      submit_params['TargetID'] = target_id
+      raise TypeError, "'credentials' expected Comet::SSHConnection, got #{credentials.class}" unless credentials.is_a? Comet::SSHConnection
+
+      submit_params['Credentials'] = credentials.to_json
+
+      body = perform_request('api/v1/admin/dispatcher/request-browse-proxmox/storage', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::BrowseProxmoxStorageResponse.new
+      ret.from_hash(json_body)
+      ret
+    end
+
     # AdminDispatcherRequestBrowseVmware
     #
     # Request a list of VMware vSphere virtual machines.
@@ -2413,8 +2494,9 @@ module Comet
     #
     # @param [String] target_id The live connection GUID
     # @param [String] destination The Storage Vault GUID
+    # @param [Boolean] allow_unsafe (Optional) Allow legacy Storage Vault unlocking, which is unsafe in some cases.
     # @return [Comet::CometAPIResponseMessage]
-    def admin_dispatcher_unlock(target_id, destination)
+    def admin_dispatcher_unlock(target_id, destination, allow_unsafe = nil)
       submit_params = {}
       raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
 
@@ -2422,6 +2504,9 @@ module Comet
       raise TypeError, "'destination' expected String, got #{destination.class}" unless destination.is_a? String
 
       submit_params['Destination'] = destination
+      unless allow_unsafe.nil?
+        submit_params['AllowUnsafe'] = (allow_unsafe ? 1 : 0)
+      end
 
       body = perform_request('api/v1/admin/dispatcher/unlock', submit_params)
       json_body = JSON.parse body
@@ -4231,8 +4316,9 @@ module Comet
     # @param [String] storage_provider ID for the storage template destination
     # @param [String] self_address (Optional) The external URL for this server. Used to resolve conflicts
     # @param [String] device_id (Optional) The ID of the device to be added as a associated device of the Storage Vault
+    # @param [String] profile_hash (Optional) The profile hash of the user profile
     # @return [Comet::RequestStorageVaultResponseMessage]
-    def admin_request_storage_vault(target_user, storage_provider, self_address = nil, device_id = nil)
+    def admin_request_storage_vault(target_user, storage_provider, self_address = nil, device_id = nil, profile_hash = nil)
       submit_params = {}
       raise TypeError, "'target_user' expected String, got #{target_user.class}" unless target_user.is_a? String
 
@@ -4252,6 +4338,11 @@ module Comet
 
         submit_params['DeviceID'] = device_id
       end
+      unless profile_hash.nil?
+        raise TypeError, "'profile_hash' expected String, got #{profile_hash.class}" unless profile_hash.is_a? String
+
+        submit_params['ProfileHash'] = profile_hash
+      end
 
       body = perform_request('api/v1/admin/request-storage-vault', submit_params)
       json_body = JSON.parse body
@@ -4413,7 +4504,7 @@ module Comet
     # @param [Comet::UserProfileConfig] profile_data Modified user profile
     # @param [String] require_hash Previous hash parameter
     # @param [Comet::AdminOptions] admin_options (Optional) Instructions for modifying user profile
-    # @return [Comet::CometAPIResponseMessage]
+    # @return [Comet::GetProfileAndHashResponseMessage]
     def admin_set_user_profile_hash(target_user, profile_data, require_hash, admin_options = nil)
       submit_params = {}
       raise TypeError, "'target_user' expected String, got #{target_user.class}" unless target_user.is_a? String
@@ -4434,7 +4525,7 @@ module Comet
       body = perform_request('api/v1/admin/set-user-profile-hash', submit_params)
       json_body = JSON.parse body
       check_status json_body
-      ret = Comet::CometAPIResponseMessage.new
+      ret = Comet::GetProfileAndHashResponseMessage.new
       ret.from_hash(json_body)
       ret
     end

data/lib/comet/definitions.rb

@@ -7,13 +7,13 @@
 
 module Comet
 
-  APPLICATION_VERSION = '24.12.5'
+  APPLICATION_VERSION = '25.6.8'
 
-  APPLICATION_VERSION_MAJOR = 24
+  APPLICATION_VERSION_MAJOR = 25
 
-  APPLICATION_VERSION_MINOR = 12
+  APPLICATION_VERSION_MINOR = 6
 
-  APPLICATION_VERSION_REVISION = 5
+  APPLICATION_VERSION_REVISION = 8
 
   # AutoRetentionLevel: The system will automatically choose how often to run an automatic Retention Pass after each backup job.
   BACKUPJOBAUTORETENTION_AUTOMATIC = 0
@@ -105,6 +105,9 @@ module Comet
 
   DESTINATIONTYPE___INVALID = 0
 
+  # Storage type that is applied when Storage Gateway fails to launch correctly
+  DESTINATIONTYPE_ERROR = 1
+
   # S3-compatible, or a specific S3 service such as AWS S3, Wasabi, or iDrive e2
   DESTINATIONTYPE_S3 = 1000
 
@@ -236,6 +239,9 @@ module Comet
   # VMware
   ENGINE_BUILTIN_VMWARE = 'engine1/vmware'
 
+  # Proxmox (PVE)
+  ENGINE_BUILTIN_PROXMOX = 'engine1/proxmox'
+
   # FtpsModeType: Use plain FTP, do not use FTPS.
   FTPS_MODE_PLAINTEXT = 0
 
@@ -433,6 +439,8 @@ New code should explicitly use OBJECT_LOCK_ON / OBJECT_LOCK_OFF instead.
 
   OFFICE365_REGION_US_DOD = 'USGovtGccDoDCloud'
 
+  OFFICE365_REGION_PUBLIC_TEST = 'GlobalPublicCloudTest'
+
   # ExtraFileExclusionOSRestriction: Applies to any device
   OS_ANY = 0
 
@@ -466,6 +474,10 @@ New code should explicitly use OBJECT_LOCK_ON / OBJECT_LOCK_OFF instead.
   # OidcProvider
   PROVIDER_DASHBOARD = 'dashboard'
 
+  PROXMOX_TYPE_VM = 'qemu'
+
+  PROXMOX_TYPE_CONTAINER = 'lxc'
+
   # PSAType
   PSA_TYPE_GENERIC = 0
 
@@ -475,6 +487,14 @@ New code should explicitly use OBJECT_LOCK_ON / OBJECT_LOCK_OFF instead.
   # PSAType
   PSA_TYPE_SYNCRO = 2
 
+  PVE_BACKUP_METHOD_STOP = 'stop'
+
+  PVE_BACKUP_METHOD_SUSPEND = 'suspend'
+
+  PVE_BACKUP_METHOD_SNAPSHOT = 'snapshot'
+
+  PVE_BACKUP_METHOD_DEFAULT = PVE_BACKUP_METHOD_SNAPSHOT
+
   RELEASE_CODENAME = 'Voyager'
 
   # RemoteServerType: Comet Server
@@ -619,7 +639,7 @@ New code should explicitly use OBJECT_LOCK_ON / OBJECT_LOCK_OFF instead.
   # RetentionRangeType: Uses Timestamp
   RETENTIONRANGE_NEWER_THAN_X = 901
 
-  # RetentionRangeType: Uses Days, Weeks, Months
+  # RetentionRangeType: Uses Days, Weeks, Months, Years
   RETENTIONRANGE_JOBS_SINCE = 902
 
   # RetentionRangeType: Uses Days
@@ -644,11 +664,19 @@ New code should explicitly use OBJECT_LOCK_ON / OBJECT_LOCK_OFF instead.
   # RetentionRangeType: Uses Jobs
   RETENTIONRANGE_LAST_X_BACKUPS_ONE_FOR_EACH_MONTH = 909
 
+  # RetentionRangeType: Uses Jobs
+  RETENTIONRANGE_LAST_X_BACKUPS_ONE_FOR_EACH_YEAR = 910
+
+  # RetentionRangeType: Uses Years, YearOffset
+  RETENTIONRANGE_FIRST_JOB_FOR_LAST_X_YEARS = 911
+
   # RetentionRangeType
-  RETENTIONRANGE__HIGHEST = 909
+  RETENTIONRANGE__HIGHEST = 911
 
   RETENTIONRANGE_MAXINT = 1_125_899_906_842_624
 
+  ROTATE_STORAGE_VAULT_KEYS_DEFAULT = 48
+
   SCHEDULE_FREQUENCY_LOWEST = 8010
 
   # SecondsPast should be a Unix timestamp, in seconds
@@ -669,7 +697,10 @@ New code should explicitly use OBJECT_LOCK_ON / OBJECT_LOCK_OFF instead.
   # SecondsPast is the number of seconds per period. Offset: Shunt seconds after unix epoch
   SCHEDULE_FREQUENCY_PERIODIC = 8015
 
-  SCHEDULE_FREQUENCY_HIGHEST = 8015
+  # SecondsPast is the number of seconds past 00:00 1st, in the device's local timezone.
+  SCHEDULE_FREQUENCY_YEARLY = 8016
+
+  SCHEDULE_FREQUENCY_HIGHEST = 8016
 
   # Maximum random delay (5 hours)
   SCHEDULE_MAX_RANDOM_DELAY_SECS = 18_000
@@ -1021,6 +1052,9 @@ New code should explicitly use OBJECT_LOCK_ON / OBJECT_LOCK_OFF instead.
   # StoredObjectType
   STOREDOBJECTTYPE_VMDK_SYMLINK = 'vmdksymlink'
 
+  # StoredObjectType
+  STOREDOBJECTTYPE_VMDK_WINDEDUP = 'vmdkwindedup'
+
   # StoredObjectType
   STOREDOBJECTTYPE_VIRTUALIMAGE_DISK = 'virtualimagedisk'
 

data/lib/comet/models/backup_job_detail.rb

@@ -99,6 +99,10 @@ module Comet
     # @type [Number] total_unlicensed_mails_count
     attr_accessor :total_unlicensed_mails_count
 
+    # The CRC32 of the billing data for this job.
+    # @type [Number] billing_crc_32
+    attr_accessor :billing_crc_32
+
     # If this field is present, this job did not perform some work because the Storage Vault is
     # currently busy.
     # This field is available in Comet 24.9.2 and later.
@@ -155,6 +159,7 @@ module Comet
       @total_accounts_count = 0
       @total_licensed_mails_count = 0
       @total_unlicensed_mails_count = 0
+      @billing_crc_32 = 0
       @conflicting_job_id = ''
       @cancellation_id = ''
       @progress = Comet::BackupJobProgress.new
@@ -276,6 +281,10 @@ module Comet
           raise TypeError, "'v' expected Numeric, got #{v.class}" unless v.is_a? Numeric
 
           @total_unlicensed_mails_count = v
+        when 'BillingCrc32'
+          raise TypeError, "'v' expected Numeric, got #{v.class}" unless v.is_a? Numeric
+
+          @billing_crc_32 = v
         when 'ConflictingJobID'
           raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
 
@@ -343,6 +352,9 @@ module Comet
       unless @total_unlicensed_mails_count.nil?
         ret['TotalUnlicensedMailsCount'] = @total_unlicensed_mails_count
       end
+      unless @billing_crc_32.nil?
+        ret['BillingCrc32'] = @billing_crc_32
+      end
       unless @conflicting_job_id.nil?
         ret['ConflictingJobID'] = @conflicting_job_id
       end

data/lib/comet/models/block_info.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2020-2025 Comet Licensing Ltd.
+# Please see the LICENSE file for usage information.
+#
+# SPDX-License-Identifier: MIT
+
+require 'json'
+
+module Comet
+
+  # BlockInfo is a typed class wrapper around the underlying Comet Server API data structure.
+  class BlockInfo
+
+    # @type [String] device_id
+    attr_accessor :device_id
+
+    # @type [String] disk_node_name
+    attr_accessor :disk_node_name
+
+    # @type [Hash] Hidden storage to preserve future properties for non-destructive roundtrip operations
+    attr_accessor :unknown_json_fields
+
+    def initialize
+      clear
+    end
+
+    def clear
+      @device_id = ''
+      @disk_node_name = ''
+      @unknown_json_fields = {}
+    end
+
+    # @param [String] json_string The complete object in JSON format
+    def from_json(json_string)
+      raise TypeError, "'json_string' expected String, got #{json_string.class}" unless json_string.is_a? String
+
+      from_hash(JSON.parse(json_string))
+    end
+
+    # @param [Hash] obj The complete object as a Ruby hash
+    def from_hash(obj)
+      raise TypeError, "'obj' expected Hash, got #{obj.class}" unless obj.is_a? Hash
+
+      obj.each do |k, v|
+        case k
+        when 'DeviceID'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @device_id = v
+        when 'DiskNodeName'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @disk_node_name = v
+        else
+          @unknown_json_fields[k] = v
+        end
+      end
+    end
+
+    # @return [Hash] The complete object as a Ruby hash
+    def to_hash
+      ret = {}
+      ret['DeviceID'] = @device_id
+      ret['DiskNodeName'] = @disk_node_name
+      @unknown_json_fields.each do |k, v|
+        ret[k] = v
+      end
+      ret
+    end
+
+    # @return [Hash] The complete object as a Ruby hash
+    def to_h
+      to_hash
+    end
+
+    # @return [String] The complete object as a JSON string
+    def to_json(options = {})
+      to_hash.to_json(options)
+    end
+  end
+end

data/lib/comet/models/browse_proxmox_nodes_response.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2020-2025 Comet Licensing Ltd.
+# Please see the LICENSE file for usage information.
+#
+# SPDX-License-Identifier: MIT
+
+require 'json'
+
+module Comet
+
+  # BrowseProxmoxNodesResponse is a typed class wrapper around the underlying Comet Server API data structure.
+  class BrowseProxmoxNodesResponse
+
+    # If the operation was successful, the status will be in the 200-299 range.
+    # @type [Number] status
+    attr_accessor :status
+
+    # @type [String] message
+    attr_accessor :message
+
+    # @type [Array<String>] nodes
+    attr_accessor :nodes
+
+    # @type [Hash] Hidden storage to preserve future properties for non-destructive roundtrip operations
+    attr_accessor :unknown_json_fields
+
+    def initialize
+      clear
+    end
+
+    def clear
+      @status = 0
+      @message = ''
+      @nodes = []
+      @unknown_json_fields = {}
+    end
+
+    # @param [String] json_string The complete object in JSON format
+    def from_json(json_string)
+      raise TypeError, "'json_string' expected String, got #{json_string.class}" unless json_string.is_a? String
+
+      from_hash(JSON.parse(json_string))
+    end
+
+    # @param [Hash] obj The complete object as a Ruby hash
+    def from_hash(obj)
+      raise TypeError, "'obj' expected Hash, got #{obj.class}" unless obj.is_a? Hash
+
+      obj.each do |k, v|
+        case k
+        when 'Status'
+          raise TypeError, "'v' expected Numeric, got #{v.class}" unless v.is_a? Numeric
+
+          @status = v
+        when 'Message'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @message = v
+        when 'Nodes'
+          if v.nil?
+            @nodes = []
+          else
+            @nodes = Array.new(v.length)
+            v.each_with_index do |v1, i1|
+              raise TypeError, "'v1' expected String, got #{v1.class}" unless v1.is_a? String
+
+              @nodes[i1] = v1
+            end
+          end
+        else
+          @unknown_json_fields[k] = v
+        end
+      end
+    end
+
+    # @return [Hash] The complete object as a Ruby hash
+    def to_hash
+      ret = {}
+      ret['Status'] = @status
+      ret['Message'] = @message
+      ret['Nodes'] = @nodes
+      @unknown_json_fields.each do |k, v|
+        ret[k] = v
+      end
+      ret
+    end
+
+    # @return [Hash] The complete object as a Ruby hash
+    def to_h
+      to_hash
+    end
+
+    # @return [String] The complete object as a JSON string
+    def to_json(options = {})
+      to_hash.to_json(options)
+    end
+  end
+end

data/lib/comet/models/browse_proxmox_response.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2020-2025 Comet Licensing Ltd.
+# Please see the LICENSE file for usage information.
+#
+# SPDX-License-Identifier: MIT
+
+require 'json'
+
+module Comet
+
+  # BrowseProxmoxResponse is a typed class wrapper around the underlying Comet Server API data structure.
+  class BrowseProxmoxResponse
+
+    # If the operation was successful, the status will be in the 200-299 range.
+    # @type [Number] status
+    attr_accessor :status
+
+    # @type [String] message
+    attr_accessor :message
+
+    # @type [Array<Comet::PVEVM>] vms
+    attr_accessor :vms
+
+    # @type [Hash] Hidden storage to preserve future properties for non-destructive roundtrip operations
+    attr_accessor :unknown_json_fields
+
+    def initialize
+      clear
+    end
+
+    def clear
+      @status = 0
+      @message = ''
+      @vms = []
+      @unknown_json_fields = {}
+    end
+
+    # @param [String] json_string The complete object in JSON format
+    def from_json(json_string)
+      raise TypeError, "'json_string' expected String, got #{json_string.class}" unless json_string.is_a? String
+
+      from_hash(JSON.parse(json_string))
+    end
+
+    # @param [Hash] obj The complete object as a Ruby hash
+    def from_hash(obj)
+      raise TypeError, "'obj' expected Hash, got #{obj.class}" unless obj.is_a? Hash
+
+      obj.each do |k, v|
+        case k
+        when 'Status'
+          raise TypeError, "'v' expected Numeric, got #{v.class}" unless v.is_a? Numeric
+
+          @status = v
+        when 'Message'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @message = v
+        when 'VMs'
+          if v.nil?
+            @vms = []
+          else
+            @vms = Array.new(v.length)
+            v.each_with_index do |v1, i1|
+              @vms[i1] = Comet::PVEVM.new
+              @vms[i1].from_hash(v1)
+            end
+          end
+        else
+          @unknown_json_fields[k] = v
+        end
+      end
+    end
+
+    # @return [Hash] The complete object as a Ruby hash
+    def to_hash
+      ret = {}
+      ret['Status'] = @status
+      ret['Message'] = @message
+      ret['VMs'] = @vms
+      @unknown_json_fields.each do |k, v|
+        ret[k] = v
+      end
+      ret
+    end
+
+    # @return [Hash] The complete object as a Ruby hash
+    def to_h
+      to_hash
+    end
+
+    # @return [String] The complete object as a JSON string
+    def to_json(options = {})
+      to_hash.to_json(options)
+    end
+  end
+end