temper-rb 0.5.1

data/lib/temper/generated/models/restore_context_outcome.rb

@@ -0,0 +1,274 @@
+=begin
+#Temper Cloud API
+
+#Knowledge base management API for temper cloud
+
+The version of the OpenAPI document: 0.5.1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.23.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Temper::Generated
+  # What restore hands back — the reverse of [`RetireContextOutcome`], and the same four fields, plus `slug_changed`. Restore re-derives the address from the untouched `name` rather than trying to recover whatever retire mangled the slug to, so the returned slug can differ from the one the caller retired under (spec §2.4).
+  class RestoreContextOutcome < ApiModelBase
+    # A `kb_contexts.id` value.
+    attr_accessor :context_id
+
+    # The full decorated ref, `{owner_ref}/{slug}`.
+    attr_accessor :context_ref
+
+    # Unchanged by restore. The display label was never touched by retire either.
+    attr_accessor :name
+
+    # The address after restore — the name's canonical slug, suffixed only if something else has since taken it.
+    attr_accessor :slug
+
+    # True when the address this restore hands back differs from the address the context was retired under. That includes the case where the original address had been freed meanwhile and restore landed on it — the caller still moves off the ref they retired with, so it is still a change to report.  Reported rather than applied silently: handing back a different address without saying so is the failure mode `rename` explicitly refuses. The baseline is the `from_slug` recorded on the `context_retired` event; a context retired before that event existed has no recorded baseline and reports `true`, because nothing proves the address was preserved. Witness: `restore_reports_a_change_when_it_lands_on_a_freed_sibling_address`.
+    attr_accessor :slug_changed
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'context_id' => :'context_id',
+        :'context_ref' => :'context_ref',
+        :'name' => :'name',
+        :'slug' => :'slug',
+        :'slug_changed' => :'slug_changed'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'context_id' => :'String',
+        :'context_ref' => :'String',
+        :'name' => :'String',
+        :'slug' => :'String',
+        :'slug_changed' => :'Boolean'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Temper::Generated::RestoreContextOutcome` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Temper::Generated::RestoreContextOutcome`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'context_id')
+        self.context_id = attributes[:'context_id']
+      else
+        self.context_id = nil
+      end
+
+      if attributes.key?(:'context_ref')
+        self.context_ref = attributes[:'context_ref']
+      else
+        self.context_ref = nil
+      end
+
+      if attributes.key?(:'name')
+        self.name = attributes[:'name']
+      else
+        self.name = nil
+      end
+
+      if attributes.key?(:'slug')
+        self.slug = attributes[:'slug']
+      else
+        self.slug = nil
+      end
+
+      if attributes.key?(:'slug_changed')
+        self.slug_changed = attributes[:'slug_changed']
+      else
+        self.slug_changed = nil
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if @context_id.nil?
+        invalid_properties.push('invalid value for "context_id", context_id cannot be nil.')
+      end
+
+      if @context_ref.nil?
+        invalid_properties.push('invalid value for "context_ref", context_ref cannot be nil.')
+      end
+
+      if @name.nil?
+        invalid_properties.push('invalid value for "name", name cannot be nil.')
+      end
+
+      if @slug.nil?
+        invalid_properties.push('invalid value for "slug", slug cannot be nil.')
+      end
+
+      if @slug_changed.nil?
+        invalid_properties.push('invalid value for "slug_changed", slug_changed cannot be nil.')
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @context_id.nil?
+      return false if @context_ref.nil?
+      return false if @name.nil?
+      return false if @slug.nil?
+      return false if @slug_changed.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] context_id Value to be assigned
+    def context_id=(context_id)
+      if context_id.nil?
+        fail ArgumentError, 'context_id cannot be nil'
+      end
+
+      @context_id = context_id
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] context_ref Value to be assigned
+    def context_ref=(context_ref)
+      if context_ref.nil?
+        fail ArgumentError, 'context_ref cannot be nil'
+      end
+
+      @context_ref = context_ref
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] name Value to be assigned
+    def name=(name)
+      if name.nil?
+        fail ArgumentError, 'name cannot be nil'
+      end
+
+      @name = name
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] slug Value to be assigned
+    def slug=(slug)
+      if slug.nil?
+        fail ArgumentError, 'slug cannot be nil'
+      end
+
+      @slug = slug
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] slug_changed Value to be assigned
+    def slug_changed=(slug_changed)
+      if slug_changed.nil?
+        fail ArgumentError, 'slug_changed cannot be nil'
+      end
+
+      @slug_changed = slug_changed
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          context_id == o.context_id &&
+          context_ref == o.context_ref &&
+          name == o.name &&
+          slug == o.slug &&
+          slug_changed == o.slug_changed
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [context_id, context_ref, name, slug, slug_changed].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/temper/generated/models/retire_context_outcome.rb

@@ -0,0 +1,247 @@
+=begin
+#Temper Cloud API
+
+#Knowledge base management API for temper cloud
+
+The version of the OpenAPI document: 0.5.1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.23.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Temper::Generated
+  # What retire hands back. The caller needs BOTH halves to undo it: the read floor hides the context and the slug moved, so the ref they arrived with no longer names the row (spec §2.4.1).
+  class RetireContextOutcome < ApiModelBase
+    # A `kb_contexts.id` value.
+    attr_accessor :context_id
+
+    # The full decorated ref, `{owner_ref}/{slug}`, which is what `restore` accepts.
+    attr_accessor :context_ref
+
+    # Unchanged by retirement. The display label is not an address.
+    attr_accessor :name
+
+    # The address after mangling — `<slug>-retired`, suffixed if that was taken.
+    attr_accessor :slug
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'context_id' => :'context_id',
+        :'context_ref' => :'context_ref',
+        :'name' => :'name',
+        :'slug' => :'slug'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'context_id' => :'String',
+        :'context_ref' => :'String',
+        :'name' => :'String',
+        :'slug' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Temper::Generated::RetireContextOutcome` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Temper::Generated::RetireContextOutcome`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'context_id')
+        self.context_id = attributes[:'context_id']
+      else
+        self.context_id = nil
+      end
+
+      if attributes.key?(:'context_ref')
+        self.context_ref = attributes[:'context_ref']
+      else
+        self.context_ref = nil
+      end
+
+      if attributes.key?(:'name')
+        self.name = attributes[:'name']
+      else
+        self.name = nil
+      end
+
+      if attributes.key?(:'slug')
+        self.slug = attributes[:'slug']
+      else
+        self.slug = nil
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if @context_id.nil?
+        invalid_properties.push('invalid value for "context_id", context_id cannot be nil.')
+      end
+
+      if @context_ref.nil?
+        invalid_properties.push('invalid value for "context_ref", context_ref cannot be nil.')
+      end
+
+      if @name.nil?
+        invalid_properties.push('invalid value for "name", name cannot be nil.')
+      end
+
+      if @slug.nil?
+        invalid_properties.push('invalid value for "slug", slug cannot be nil.')
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @context_id.nil?
+      return false if @context_ref.nil?
+      return false if @name.nil?
+      return false if @slug.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] context_id Value to be assigned
+    def context_id=(context_id)
+      if context_id.nil?
+        fail ArgumentError, 'context_id cannot be nil'
+      end
+
+      @context_id = context_id
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] context_ref Value to be assigned
+    def context_ref=(context_ref)
+      if context_ref.nil?
+        fail ArgumentError, 'context_ref cannot be nil'
+      end
+
+      @context_ref = context_ref
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] name Value to be assigned
+    def name=(name)
+      if name.nil?
+        fail ArgumentError, 'name cannot be nil'
+      end
+
+      @name = name
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] slug Value to be assigned
+    def slug=(slug)
+      if slug.nil?
+        fail ArgumentError, 'slug cannot be nil'
+      end
+
+      @slug = slug
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          context_id == o.context_id &&
+          context_ref == o.context_ref &&
+          name == o.name &&
+          slug == o.slug
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [context_id, context_ref, name, slug].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/temper/generated/models/return_spec.rb

@@ -0,0 +1,189 @@
+=begin
+#Temper Cloud API
+
+#Knowledge base management API for temper cloud
+
+The version of the OpenAPI document: 0.5.1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.23.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Temper::Generated
+  # One stage whose rows come back, and how much of each row.
+  class ReturnSpec < ApiModelBase
+    # A stage's name, and — because [`StageName::parse`] is the only constructor — a proof that the name is a safe SQL identifier.  The compiler (beat C, Task 9) emits stage names as CTE identifiers. Parse-don't-validate is the whole design: a name that cannot be constructed cannot reach SQL, so there is deliberately no `new_unchecked`. The accepted shape is `[a-z][a-z0-9_]{0,62}` — a leading lowercase letter, then up to 62 more lowercase-alphanumeric-or-underscore characters (63 total).
+    attr_accessor :stage
+
+    # Which sections to hydrate onto each row, in the SAME vocabulary `temper resource show --with` uses. Empty means the kind's default projection.  Replaces `fields: Vec<String>`, which promised field-level subselection over a projection, had nothing implementing it, and duplicated a vocabulary that already works.  **This door admits a subset, and the rest are REFUSED rather than unsupported** — see [`Self::ADMITTED_SECTIONS`]. The refusal lands at validation rather than at deserialization on purpose: `/api/query` promises every refusal in one response, and a serde failure short-circuits before validation runs, so a caller with four problems would learn about one of them in a deserializer's vocabulary.
+    attr_accessor :with
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'stage' => :'stage',
+        :'with' => :'with'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'stage' => :'String',
+        :'with' => :'Array<ResourceSection>'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Temper::Generated::ReturnSpec` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Temper::Generated::ReturnSpec`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'stage')
+        self.stage = attributes[:'stage']
+      else
+        self.stage = nil
+      end
+
+      if attributes.key?(:'with')
+        if (value = attributes[:'with']).is_a?(Array)
+          self.with = value
+        end
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if @stage.nil?
+        invalid_properties.push('invalid value for "stage", stage cannot be nil.')
+      end
+
+      pattern = Regexp.new(/^[a-z][a-z0-9_]{0,62}$/)
+      if @stage !~ pattern
+        invalid_properties.push("invalid value for \"stage\", must conform to the pattern #{pattern}.")
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @stage.nil?
+      return false if @stage !~ Regexp.new(/^[a-z][a-z0-9_]{0,62}$/)
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] stage Value to be assigned
+    def stage=(stage)
+      if stage.nil?
+        fail ArgumentError, 'stage cannot be nil'
+      end
+
+      pattern = Regexp.new(/^[a-z][a-z0-9_]{0,62}$/)
+      if stage !~ pattern
+        fail ArgumentError, "invalid value for \"stage\", must conform to the pattern #{pattern}."
+      end
+
+      @stage = stage
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          stage == o.stage &&
+          with == o.with
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [stage, with].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end