pulpcore_client 3.73.15 → 3.74.0

data/lib/pulpcore_client/models/artifact_distribution_response.rb

@@ -16,17 +16,6 @@ require 'time'
 module PulpcoreClient
   # A serializer for ArtifactDistribution.
   class ArtifactDistributionResponse
-    # Timestamp of the last time this resource was updated. Note: for immutable resources - like content, repository versions, and publication - pulp_created and pulp_last_updated dates will be the same.
-    attr_accessor :pulp_last_updated
-
-    # Whether this distribution should be shown in the content app.
-    attr_accessor :hidden
-
-    # An optional content-guard.
-    attr_accessor :content_guard
-
-    attr_accessor :pulp_labels
-
     # The Pulp Resource Name (PRN).
     attr_accessor :prn
 
@@ -35,32 +24,43 @@ module PulpcoreClient
 
     attr_accessor :pulp_href
 
-    # Timestamp since when the distributed content served by this distribution has not changed. If equals to `null`, no guarantee is provided about content changes.
-    attr_accessor :no_content_change_since
+    # Timestamp of the last time this resource was updated. Note: for immutable resources - like content, repository versions, and publication - pulp_created and pulp_last_updated dates will be the same.
+    attr_accessor :pulp_last_updated
 
-    # The URL for accessing the publication as defined by this distribution.
-    attr_accessor :base_url
+    attr_accessor :pulp_labels
 
     # Timestamp of creation.
     attr_accessor :pulp_created
 
+    # The URL for accessing the publication as defined by this distribution.
+    attr_accessor :base_url
+
+    # Timestamp since when the distributed content served by this distribution has not changed. If equals to `null`, no guarantee is provided about content changes.
+    attr_accessor :no_content_change_since
+
+    # Whether this distribution should be shown in the content app.
+    attr_accessor :hidden
+
     # The base (relative) path component of the published url. Avoid paths that                     overlap with other distribution base paths (e.g. \"foo\" and \"foo/bar\")
     attr_accessor :base_path
 
+    # An optional content-guard.
+    attr_accessor :content_guard
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
-        :'pulp_last_updated' => :'pulp_last_updated',
-        :'hidden' => :'hidden',
-        :'content_guard' => :'content_guard',
-        :'pulp_labels' => :'pulp_labels',
         :'prn' => :'prn',
         :'name' => :'name',
         :'pulp_href' => :'pulp_href',
-        :'no_content_change_since' => :'no_content_change_since',
-        :'base_url' => :'base_url',
+        :'pulp_last_updated' => :'pulp_last_updated',
+        :'pulp_labels' => :'pulp_labels',
         :'pulp_created' => :'pulp_created',
-        :'base_path' => :'base_path'
+        :'base_url' => :'base_url',
+        :'no_content_change_since' => :'no_content_change_since',
+        :'hidden' => :'hidden',
+        :'base_path' => :'base_path',
+        :'content_guard' => :'content_guard'
       }
     end
 
@@ -72,24 +72,24 @@ module PulpcoreClient
     # Attribute type mapping.
     def self.openapi_types
       {
-        :'pulp_last_updated' => :'Time',
-        :'hidden' => :'Boolean',
-        :'content_guard' => :'String',
-        :'pulp_labels' => :'Hash<String, String>',
         :'prn' => :'String',
         :'name' => :'String',
         :'pulp_href' => :'String',
-        :'no_content_change_since' => :'String',
-        :'base_url' => :'String',
+        :'pulp_last_updated' => :'Time',
+        :'pulp_labels' => :'Hash<String, String>',
         :'pulp_created' => :'Time',
-        :'base_path' => :'String'
+        :'base_url' => :'String',
+        :'no_content_change_since' => :'String',
+        :'hidden' => :'Boolean',
+        :'base_path' => :'String',
+        :'content_guard' => :'String'
       }
     end
 
     # List of attributes with nullable: true
     def self.openapi_nullable
       Set.new([
-        :'content_guard',
+        :'content_guard'
       ])
     end
 
@@ -108,18 +108,22 @@ module PulpcoreClient
         h[k.to_sym] = v
       }
 
-      if attributes.key?(:'pulp_last_updated')
-        self.pulp_last_updated = attributes[:'pulp_last_updated']
+      if attributes.key?(:'prn')
+        self.prn = attributes[:'prn']
       end
 
-      if attributes.key?(:'hidden')
-        self.hidden = attributes[:'hidden']
+      if attributes.key?(:'name')
+        self.name = attributes[:'name']
       else
-        self.hidden = false
+        self.name = nil
       end
 
-      if attributes.key?(:'content_guard')
-        self.content_guard = attributes[:'content_guard']
+      if attributes.key?(:'pulp_href')
+        self.pulp_href = attributes[:'pulp_href']
+      end
+
+      if attributes.key?(:'pulp_last_updated')
+        self.pulp_last_updated = attributes[:'pulp_last_updated']
       end
 
       if attributes.key?(:'pulp_labels')
@@ -128,30 +132,22 @@ module PulpcoreClient
         end
       end
 
-      if attributes.key?(:'prn')
-        self.prn = attributes[:'prn']
-      end
-
-      if attributes.key?(:'name')
-        self.name = attributes[:'name']
-      else
-        self.name = nil
+      if attributes.key?(:'pulp_created')
+        self.pulp_created = attributes[:'pulp_created']
       end
 
-      if attributes.key?(:'pulp_href')
-        self.pulp_href = attributes[:'pulp_href']
+      if attributes.key?(:'base_url')
+        self.base_url = attributes[:'base_url']
       end
 
       if attributes.key?(:'no_content_change_since')
         self.no_content_change_since = attributes[:'no_content_change_since']
       end
 
-      if attributes.key?(:'base_url')
-        self.base_url = attributes[:'base_url']
-      end
-
-      if attributes.key?(:'pulp_created')
-        self.pulp_created = attributes[:'pulp_created']
+      if attributes.key?(:'hidden')
+        self.hidden = attributes[:'hidden']
+      else
+        self.hidden = false
       end
 
       if attributes.key?(:'base_path')
@@ -159,6 +155,10 @@ module PulpcoreClient
       else
         self.base_path = nil
       end
+
+      if attributes.key?(:'content_guard')
+        self.content_guard = attributes[:'content_guard']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -191,17 +191,17 @@ module PulpcoreClient
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
-          pulp_last_updated == o.pulp_last_updated &&
-          hidden == o.hidden &&
-          content_guard == o.content_guard &&
-          pulp_labels == o.pulp_labels &&
           prn == o.prn &&
           name == o.name &&
           pulp_href == o.pulp_href &&
-          no_content_change_since == o.no_content_change_since &&
-          base_url == o.base_url &&
+          pulp_last_updated == o.pulp_last_updated &&
+          pulp_labels == o.pulp_labels &&
           pulp_created == o.pulp_created &&
-          base_path == o.base_path
+          base_url == o.base_url &&
+          no_content_change_since == o.no_content_change_since &&
+          hidden == o.hidden &&
+          base_path == o.base_path &&
+          content_guard == o.content_guard
     end
 
     # @see the `==` method
@@ -213,7 +213,7 @@ module PulpcoreClient
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [pulp_last_updated, hidden, content_guard, pulp_labels, prn, name, pulp_href, no_content_change_since, base_url, pulp_created, base_path].hash
+      [prn, name, pulp_href, pulp_last_updated, pulp_labels, pulp_created, base_url, no_content_change_since, hidden, base_path, content_guard].hash
     end
 
     # Builds the object from hash

data/lib/pulpcore_client/models/orphans_cleanup.rb

@@ -80,6 +80,14 @@ module PulpcoreClient
     def list_invalid_properties
       warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
       invalid_properties = Array.new
+      if !@orphan_protection_time.nil? && @orphan_protection_time > 4294967295
+        invalid_properties.push('invalid value for "orphan_protection_time", must be smaller than or equal to 4294967295.')
+      end
+
+      if !@orphan_protection_time.nil? && @orphan_protection_time < 0
+        invalid_properties.push('invalid value for "orphan_protection_time", must be greater than or equal to 0.')
+      end
+
       invalid_properties
     end
 
@@ -87,9 +95,25 @@ module PulpcoreClient
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if !@orphan_protection_time.nil? && @orphan_protection_time > 4294967295
+      return false if !@orphan_protection_time.nil? && @orphan_protection_time < 0
       true
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] orphan_protection_time Value to be assigned
+    def orphan_protection_time=(orphan_protection_time)
+      if !orphan_protection_time.nil? && orphan_protection_time > 4294967295
+        fail ArgumentError, 'invalid value for "orphan_protection_time", must be smaller than or equal to 4294967295.'
+      end
+
+      if !orphan_protection_time.nil? && orphan_protection_time < 0
+        fail ArgumentError, 'invalid value for "orphan_protection_time", must be greater than or equal to 0.'
+      end
+
+      @orphan_protection_time = orphan_protection_time
+    end
+
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(o)

data/lib/pulpcore_client/version.rb

@@ -11,5 +11,5 @@ Generator version: 7.10.0
 =end
 
 module PulpcoreClient
-  VERSION = '3.73.15'
+  VERSION = '3.74.0'
 end

data/pulpcore_client.gemspec

@@ -28,6 +28,7 @@ Gem::Specification.new do |s|
   s.required_ruby_version = ">= 2.7"
   s.metadata    = {}
 
+  s.add_runtime_dependency 'faraday-net_http', '>= 2.0', '< 3.1'
   s.add_runtime_dependency 'faraday', '>= 1.0.1', '< 2.9'
   s.add_runtime_dependency 'faraday-multipart'
   s.add_runtime_dependency 'marcel'

data/spec/api/distributions_api_spec.rb

@@ -40,6 +40,7 @@ describe 'DistributionsApi' do
   # @option opts [String] :base_path__contains Filter results where base_path contains value
   # @option opts [String] :base_path__icontains Filter results where base_path contains value
   # @option opts [Array<String>] :base_path__in Filter results where base_path is in a comma-separated list of values
+  # @option opts [Boolean] :checkpoint Filter results where checkpoint matches value
   # @option opts [Integer] :limit Number of results to return per page.
   # @option opts [String] :name Filter results where name matches value
   # @option opts [String] :name__contains Filter results where name contains value
@@ -51,7 +52,7 @@ describe 'DistributionsApi' do
   # @option opts [String] :name__regex Filter results where name matches regex value
   # @option opts [String] :name__startswith Filter results where name starts with value
   # @option opts [Integer] :offset The initial index from which to return the results.
-  # @option opts [Array<String>] :ordering Ordering  * &#x60;pulp_id&#x60; - Pulp id * &#x60;-pulp_id&#x60; - Pulp id (descending) * &#x60;pulp_created&#x60; - Pulp created * &#x60;-pulp_created&#x60; - Pulp created (descending) * &#x60;pulp_last_updated&#x60; - Pulp last updated * &#x60;-pulp_last_updated&#x60; - Pulp last updated (descending) * &#x60;pulp_type&#x60; - Pulp type * &#x60;-pulp_type&#x60; - Pulp type (descending) * &#x60;name&#x60; - Name * &#x60;-name&#x60; - Name (descending) * &#x60;pulp_labels&#x60; - Pulp labels * &#x60;-pulp_labels&#x60; - Pulp labels (descending) * &#x60;base_path&#x60; - Base path * &#x60;-base_path&#x60; - Base path (descending) * &#x60;hidden&#x60; - Hidden * &#x60;-hidden&#x60; - Hidden (descending) * &#x60;pk&#x60; - Pk * &#x60;-pk&#x60; - Pk (descending)
+  # @option opts [Array<String>] :ordering Ordering  * &#x60;pulp_id&#x60; - Pulp id * &#x60;-pulp_id&#x60; - Pulp id (descending) * &#x60;pulp_created&#x60; - Pulp created * &#x60;-pulp_created&#x60; - Pulp created (descending) * &#x60;pulp_last_updated&#x60; - Pulp last updated * &#x60;-pulp_last_updated&#x60; - Pulp last updated (descending) * &#x60;pulp_type&#x60; - Pulp type * &#x60;-pulp_type&#x60; - Pulp type (descending) * &#x60;name&#x60; - Name * &#x60;-name&#x60; - Name (descending) * &#x60;pulp_labels&#x60; - Pulp labels * &#x60;-pulp_labels&#x60; - Pulp labels (descending) * &#x60;base_path&#x60; - Base path * &#x60;-base_path&#x60; - Base path (descending) * &#x60;hidden&#x60; - Hidden * &#x60;-hidden&#x60; - Hidden (descending) * &#x60;checkpoint&#x60; - Checkpoint * &#x60;-checkpoint&#x60; - Checkpoint (descending) * &#x60;pk&#x60; - Pk * &#x60;-pk&#x60; - Pk (descending)
   # @option opts [Array<String>] :prn__in Multiple values may be separated by commas.
   # @option opts [Array<String>] :pulp_href__in Multiple values may be separated by commas.
   # @option opts [Array<String>] :pulp_id__in Multiple values may be separated by commas.

data/spec/api/distributions_artifacts_api_spec.rb

@@ -40,6 +40,7 @@ describe 'DistributionsArtifactsApi' do
   # @option opts [String] :base_path__contains Filter results where base_path contains value
   # @option opts [String] :base_path__icontains Filter results where base_path contains value
   # @option opts [Array<String>] :base_path__in Filter results where base_path is in a comma-separated list of values
+  # @option opts [Boolean] :checkpoint Filter results where checkpoint matches value
   # @option opts [Integer] :limit Number of results to return per page.
   # @option opts [String] :name Filter results where name matches value
   # @option opts [String] :name__contains Filter results where name contains value
@@ -51,7 +52,7 @@ describe 'DistributionsArtifactsApi' do
   # @option opts [String] :name__regex Filter results where name matches regex value
   # @option opts [String] :name__startswith Filter results where name starts with value
   # @option opts [Integer] :offset The initial index from which to return the results.
-  # @option opts [Array<String>] :ordering Ordering  * &#x60;pulp_id&#x60; - Pulp id * &#x60;-pulp_id&#x60; - Pulp id (descending) * &#x60;pulp_created&#x60; - Pulp created * &#x60;-pulp_created&#x60; - Pulp created (descending) * &#x60;pulp_last_updated&#x60; - Pulp last updated * &#x60;-pulp_last_updated&#x60; - Pulp last updated (descending) * &#x60;pulp_type&#x60; - Pulp type * &#x60;-pulp_type&#x60; - Pulp type (descending) * &#x60;name&#x60; - Name * &#x60;-name&#x60; - Name (descending) * &#x60;pulp_labels&#x60; - Pulp labels * &#x60;-pulp_labels&#x60; - Pulp labels (descending) * &#x60;base_path&#x60; - Base path * &#x60;-base_path&#x60; - Base path (descending) * &#x60;hidden&#x60; - Hidden * &#x60;-hidden&#x60; - Hidden (descending) * &#x60;pk&#x60; - Pk * &#x60;-pk&#x60; - Pk (descending)
+  # @option opts [Array<String>] :ordering Ordering  * &#x60;pulp_id&#x60; - Pulp id * &#x60;-pulp_id&#x60; - Pulp id (descending) * &#x60;pulp_created&#x60; - Pulp created * &#x60;-pulp_created&#x60; - Pulp created (descending) * &#x60;pulp_last_updated&#x60; - Pulp last updated * &#x60;-pulp_last_updated&#x60; - Pulp last updated (descending) * &#x60;pulp_type&#x60; - Pulp type * &#x60;-pulp_type&#x60; - Pulp type (descending) * &#x60;name&#x60; - Name * &#x60;-name&#x60; - Name (descending) * &#x60;pulp_labels&#x60; - Pulp labels * &#x60;-pulp_labels&#x60; - Pulp labels (descending) * &#x60;base_path&#x60; - Base path * &#x60;-base_path&#x60; - Base path (descending) * &#x60;hidden&#x60; - Hidden * &#x60;-hidden&#x60; - Hidden (descending) * &#x60;checkpoint&#x60; - Checkpoint * &#x60;-checkpoint&#x60; - Checkpoint (descending) * &#x60;pk&#x60; - Pk * &#x60;-pk&#x60; - Pk (descending)
   # @option opts [Array<String>] :prn__in Multiple values may be separated by commas.
   # @option opts [Array<String>] :pulp_href__in Multiple values may be separated by commas.
   # @option opts [Array<String>] :pulp_id__in Multiple values may be separated by commas.

data/spec/api/distributions_openpgp_api_spec.rb

@@ -62,7 +62,7 @@ describe 'DistributionsOpenpgpApi' do
   # @param [Hash] opts the optional parameters
   # @option opts [Integer] :limit Number of results to return per page.
   # @option opts [Integer] :offset The initial index from which to return the results.
-  # @option opts [Array<String>] :ordering Ordering  * &#x60;pulp_id&#x60; - Pulp id * &#x60;-pulp_id&#x60; - Pulp id (descending) * &#x60;pulp_created&#x60; - Pulp created * &#x60;-pulp_created&#x60; - Pulp created (descending) * &#x60;pulp_last_updated&#x60; - Pulp last updated * &#x60;-pulp_last_updated&#x60; - Pulp last updated (descending) * &#x60;pulp_type&#x60; - Pulp type * &#x60;-pulp_type&#x60; - Pulp type (descending) * &#x60;name&#x60; - Name * &#x60;-name&#x60; - Name (descending) * &#x60;pulp_labels&#x60; - Pulp labels * &#x60;-pulp_labels&#x60; - Pulp labels (descending) * &#x60;base_path&#x60; - Base path * &#x60;-base_path&#x60; - Base path (descending) * &#x60;hidden&#x60; - Hidden * &#x60;-hidden&#x60; - Hidden (descending) * &#x60;pk&#x60; - Pk * &#x60;-pk&#x60; - Pk (descending)
+  # @option opts [Array<String>] :ordering Ordering  * &#x60;pulp_id&#x60; - Pulp id * &#x60;-pulp_id&#x60; - Pulp id (descending) * &#x60;pulp_created&#x60; - Pulp created * &#x60;-pulp_created&#x60; - Pulp created (descending) * &#x60;pulp_last_updated&#x60; - Pulp last updated * &#x60;-pulp_last_updated&#x60; - Pulp last updated (descending) * &#x60;pulp_type&#x60; - Pulp type * &#x60;-pulp_type&#x60; - Pulp type (descending) * &#x60;name&#x60; - Name * &#x60;-name&#x60; - Name (descending) * &#x60;pulp_labels&#x60; - Pulp labels * &#x60;-pulp_labels&#x60; - Pulp labels (descending) * &#x60;base_path&#x60; - Base path * &#x60;-base_path&#x60; - Base path (descending) * &#x60;hidden&#x60; - Hidden * &#x60;-hidden&#x60; - Hidden (descending) * &#x60;checkpoint&#x60; - Checkpoint * &#x60;-checkpoint&#x60; - Checkpoint (descending) * &#x60;pk&#x60; - Pk * &#x60;-pk&#x60; - Pk (descending)
   # @option opts [Array<String>] :prn__in Multiple values may be separated by commas.
   # @option opts [Array<String>] :pulp_href__in Multiple values may be separated by commas.
   # @option opts [Array<String>] :pulp_id__in Multiple values may be separated by commas.

data/spec/api/publications_api_spec.rb

@@ -36,11 +36,12 @@ describe 'PublicationsApi' do
   # List publications
   # A base class for any publication viewset.
   # @param [Hash] opts the optional parameters
+  # @option opts [Boolean] :checkpoint Filter results where checkpoint matches value
   # @option opts [String] :content Content Unit referenced by HREF/PRN
   # @option opts [Array<String>] :content__in Multiple values may be separated by commas.
   # @option opts [Integer] :limit Number of results to return per page.
   # @option opts [Integer] :offset The initial index from which to return the results.
-  # @option opts [Array<String>] :ordering Ordering  * &#x60;pulp_id&#x60; - Pulp id * &#x60;-pulp_id&#x60; - Pulp id (descending) * &#x60;pulp_created&#x60; - Pulp created * &#x60;-pulp_created&#x60; - Pulp created (descending) * &#x60;pulp_last_updated&#x60; - Pulp last updated * &#x60;-pulp_last_updated&#x60; - Pulp last updated (descending) * &#x60;pulp_type&#x60; - Pulp type * &#x60;-pulp_type&#x60; - Pulp type (descending) * &#x60;complete&#x60; - Complete * &#x60;-complete&#x60; - Complete (descending) * &#x60;pass_through&#x60; - Pass through * &#x60;-pass_through&#x60; - Pass through (descending) * &#x60;pk&#x60; - Pk * &#x60;-pk&#x60; - Pk (descending)
+  # @option opts [Array<String>] :ordering Ordering  * &#x60;pulp_id&#x60; - Pulp id * &#x60;-pulp_id&#x60; - Pulp id (descending) * &#x60;pulp_created&#x60; - Pulp created * &#x60;-pulp_created&#x60; - Pulp created (descending) * &#x60;pulp_last_updated&#x60; - Pulp last updated * &#x60;-pulp_last_updated&#x60; - Pulp last updated (descending) * &#x60;pulp_type&#x60; - Pulp type * &#x60;-pulp_type&#x60; - Pulp type (descending) * &#x60;complete&#x60; - Complete * &#x60;-complete&#x60; - Complete (descending) * &#x60;pass_through&#x60; - Pass through * &#x60;-pass_through&#x60; - Pass through (descending) * &#x60;checkpoint&#x60; - Checkpoint * &#x60;-checkpoint&#x60; - Checkpoint (descending) * &#x60;pk&#x60; - Pk * &#x60;-pk&#x60; - Pk (descending)
   # @option opts [Array<String>] :prn__in Multiple values may be separated by commas.
   # @option opts [Time] :pulp_created Filter results where pulp_created matches value
   # @option opts [Time] :pulp_created__gt Filter results where pulp_created is greater than value

data/spec/models/artifact_distribution_response_spec.rb

@@ -27,43 +27,43 @@ describe PulpcoreClient::ArtifactDistributionResponse do
     end
   end
 
-  describe 'test attribute "pulp_last_updated"' do
+  describe 'test attribute "prn"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  describe 'test attribute "hidden"' do
+  describe 'test attribute "name"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  describe 'test attribute "content_guard"' do
+  describe 'test attribute "pulp_href"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  describe 'test attribute "pulp_labels"' do
+  describe 'test attribute "pulp_last_updated"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  describe 'test attribute "prn"' do
+  describe 'test attribute "pulp_labels"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  describe 'test attribute "name"' do
+  describe 'test attribute "pulp_created"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  describe 'test attribute "pulp_href"' do
+  describe 'test attribute "base_url"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
@@ -75,19 +75,19 @@ describe PulpcoreClient::ArtifactDistributionResponse do
     end
   end
 
-  describe 'test attribute "base_url"' do
+  describe 'test attribute "hidden"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  describe 'test attribute "pulp_created"' do
+  describe 'test attribute "base_path"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  describe 'test attribute "base_path"' do
+  describe 'test attribute "content_guard"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end