cerca 0.1.0

data/lib/cerca/file_part.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Cerca
+  class FilePart
+    # @return [Pathname, StringIO, IO, String]
+    attr_reader :content
+
+    # @return [String, nil]
+    attr_reader :content_type
+
+    # @return [String, nil]
+    attr_reader :filename
+
+    # @api private
+    #
+    # @return [String]
+    private def read
+      case content
+      in Pathname
+        content.read(binmode: true)
+      in StringIO
+        content.string
+      in IO
+        content.read
+      in String
+        content
+      end
+    end
+
+    # @param a [Object]
+    #
+    # @return [String]
+    def to_json(*a) = read.to_json(*a)
+
+    # @param a [Object]
+    #
+    # @return [String]
+    def to_yaml(*a) = read.to_yaml(*a)
+
+    # @param content [Pathname, StringIO, IO, String]
+    # @param filename [Pathname, String, nil]
+    # @param content_type [String, nil]
+    def initialize(content, filename: nil, content_type: nil)
+      @content_type = content_type
+      @filename =
+        case [filename, (@content = content)]
+        in [String | Pathname, _]
+          ::File.basename(filename)
+        in [nil, Pathname]
+          content.basename.to_path
+        in [nil, IO]
+          content.to_path
+        else
+          filename
+        end
+    end
+  end
+end

data/lib/cerca/internal/agents_cursor_page.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Internal
+    # @generic Elem
+    #
+    # @example
+    #   if agents_cursor_page.has_next?
+    #     agents_cursor_page = agents_cursor_page.next_page
+    #   end
+    #
+    # @example
+    #   agents_cursor_page.auto_paging_each do |agent|
+    #     puts(agent)
+    #   end
+    class AgentsCursorPage
+      include Cerca::Internal::Type::BasePage
+
+      # @return [Array<generic<Elem>>, nil]
+      attr_accessor :agents
+
+      # @return [String, nil]
+      attr_accessor :cursor
+
+      # @return [Boolean]
+      attr_accessor :has_more
+
+      # @return [Boolean]
+      def next_page?
+        has_more
+      end
+
+      # @raise [Cerca::HTTP::Error]
+      # @return [self]
+      def next_page
+        unless next_page?
+          message = "No more pages available. Please check #next_page? before calling ##{__method__}"
+          raise RuntimeError.new(message)
+        end
+
+        req = Cerca::Internal::Util.deep_merge(@req, {query: {cursor: cursor}})
+        @client.request(req)
+      end
+
+      # @param blk [Proc]
+      #
+      # @yieldparam [generic<Elem>]
+      def auto_paging_each(&blk)
+        unless block_given?
+          raise ArgumentError.new("A block must be given to ##{__method__}")
+        end
+
+        page = self
+        loop do
+          page.agents&.each(&blk)
+
+          break unless page.next_page?
+          page = page.next_page
+        end
+      end
+
+      # @api private
+      #
+      # @param client [Cerca::Internal::Transport::BaseClient]
+      # @param req [Hash{Symbol=>Object}]
+      # @param headers [Hash{String=>String}]
+      # @param page_data [Hash{Symbol=>Object}]
+      def initialize(client:, req:, headers:, page_data:)
+        super
+
+        case page_data
+        in {agents: Array => agents}
+          @agents = agents.map { Cerca::Internal::Type::Converter.coerce(@model, _1) }
+        else
+        end
+        @cursor = page_data[:cursor]
+        @has_more = page_data[:hasMore]
+      end
+
+      # @api private
+      #
+      # @return [String]
+      def inspect
+        # rubocop:disable Layout/LineLength
+        model = Cerca::Internal::Type::Converter.inspect(@model, depth: 1)
+
+        "#<#{self.class}[#{model}]:0x#{object_id.to_s(16)} cursor=#{cursor.inspect} has_more=#{has_more.inspect}>"
+        # rubocop:enable Layout/LineLength
+      end
+    end
+  end
+end

data/lib/cerca/internal/approval_requests_cursor_page.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Internal
+    # @generic Elem
+    #
+    # @example
+    #   if approval_requests_cursor_page.has_next?
+    #     approval_requests_cursor_page = approval_requests_cursor_page.next_page
+    #   end
+    #
+    # @example
+    #   approval_requests_cursor_page.auto_paging_each do |approval_request|
+    #     puts(approval_request)
+    #   end
+    class ApprovalRequestsCursorPage
+      include Cerca::Internal::Type::BasePage
+
+      # @return [Array<generic<Elem>>, nil]
+      attr_accessor :approvals
+
+      # @return [String, nil]
+      attr_accessor :cursor
+
+      # @return [Boolean]
+      attr_accessor :has_more
+
+      # @return [Boolean]
+      def next_page?
+        has_more
+      end
+
+      # @raise [Cerca::HTTP::Error]
+      # @return [self]
+      def next_page
+        unless next_page?
+          message = "No more pages available. Please check #next_page? before calling ##{__method__}"
+          raise RuntimeError.new(message)
+        end
+
+        req = Cerca::Internal::Util.deep_merge(@req, {query: {cursor: cursor}})
+        @client.request(req)
+      end
+
+      # @param blk [Proc]
+      #
+      # @yieldparam [generic<Elem>]
+      def auto_paging_each(&blk)
+        unless block_given?
+          raise ArgumentError.new("A block must be given to ##{__method__}")
+        end
+
+        page = self
+        loop do
+          page.approvals&.each(&blk)
+
+          break unless page.next_page?
+          page = page.next_page
+        end
+      end
+
+      # @api private
+      #
+      # @param client [Cerca::Internal::Transport::BaseClient]
+      # @param req [Hash{Symbol=>Object}]
+      # @param headers [Hash{String=>String}]
+      # @param page_data [Hash{Symbol=>Object}]
+      def initialize(client:, req:, headers:, page_data:)
+        super
+
+        case page_data
+        in {approvals: Array => approvals}
+          @approvals = approvals.map { Cerca::Internal::Type::Converter.coerce(@model, _1) }
+        else
+        end
+        @cursor = page_data[:cursor]
+        @has_more = page_data[:hasMore]
+      end
+
+      # @api private
+      #
+      # @return [String]
+      def inspect
+        # rubocop:disable Layout/LineLength
+        model = Cerca::Internal::Type::Converter.inspect(@model, depth: 1)
+
+        "#<#{self.class}[#{model}]:0x#{object_id.to_s(16)} cursor=#{cursor.inspect} has_more=#{has_more.inspect}>"
+        # rubocop:enable Layout/LineLength
+      end
+    end
+  end
+end

data/lib/cerca/internal/connections_cursor_page.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Internal
+    # @generic Elem
+    #
+    # @example
+    #   if connections_cursor_page.has_next?
+    #     connections_cursor_page = connections_cursor_page.next_page
+    #   end
+    #
+    # @example
+    #   connections_cursor_page.auto_paging_each do |connection|
+    #     puts(connection)
+    #   end
+    class ConnectionsCursorPage
+      include Cerca::Internal::Type::BasePage
+
+      # @return [Array<generic<Elem>>, nil]
+      attr_accessor :connections
+
+      # @return [String, nil]
+      attr_accessor :cursor
+
+      # @return [Boolean]
+      attr_accessor :has_more
+
+      # @return [Boolean]
+      def next_page?
+        has_more
+      end
+
+      # @raise [Cerca::HTTP::Error]
+      # @return [self]
+      def next_page
+        unless next_page?
+          message = "No more pages available. Please check #next_page? before calling ##{__method__}"
+          raise RuntimeError.new(message)
+        end
+
+        req = Cerca::Internal::Util.deep_merge(@req, {query: {cursor: cursor}})
+        @client.request(req)
+      end
+
+      # @param blk [Proc]
+      #
+      # @yieldparam [generic<Elem>]
+      def auto_paging_each(&blk)
+        unless block_given?
+          raise ArgumentError.new("A block must be given to ##{__method__}")
+        end
+
+        page = self
+        loop do
+          page.connections&.each(&blk)
+
+          break unless page.next_page?
+          page = page.next_page
+        end
+      end
+
+      # @api private
+      #
+      # @param client [Cerca::Internal::Transport::BaseClient]
+      # @param req [Hash{Symbol=>Object}]
+      # @param headers [Hash{String=>String}]
+      # @param page_data [Hash{Symbol=>Object}]
+      def initialize(client:, req:, headers:, page_data:)
+        super
+
+        case page_data
+        in {connections: Array => connections}
+          @connections = connections.map { Cerca::Internal::Type::Converter.coerce(@model, _1) }
+        else
+        end
+        @cursor = page_data[:cursor]
+        @has_more = page_data[:hasMore]
+      end
+
+      # @api private
+      #
+      # @return [String]
+      def inspect
+        # rubocop:disable Layout/LineLength
+        model = Cerca::Internal::Type::Converter.inspect(@model, depth: 1)
+
+        "#<#{self.class}[#{model}]:0x#{object_id.to_s(16)} cursor=#{cursor.inspect} has_more=#{has_more.inspect}>"
+        # rubocop:enable Layout/LineLength
+      end
+    end
+  end
+end

data/lib/cerca/internal/entries_cursor_page.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Internal
+    # @generic Elem
+    #
+    # @example
+    #   if entries_cursor_page.has_next?
+    #     entries_cursor_page = entries_cursor_page.next_page
+    #   end
+    #
+    # @example
+    #   entries_cursor_page.auto_paging_each do |context|
+    #     puts(context)
+    #   end
+    class EntriesCursorPage
+      include Cerca::Internal::Type::BasePage
+
+      # @return [Array<generic<Elem>>, nil]
+      attr_accessor :entries
+
+      # @return [String, nil]
+      attr_accessor :cursor
+
+      # @return [Boolean]
+      attr_accessor :has_more
+
+      # @return [Boolean]
+      def next_page?
+        has_more
+      end
+
+      # @raise [Cerca::HTTP::Error]
+      # @return [self]
+      def next_page
+        unless next_page?
+          message = "No more pages available. Please check #next_page? before calling ##{__method__}"
+          raise RuntimeError.new(message)
+        end
+
+        req = Cerca::Internal::Util.deep_merge(@req, {query: {cursor: cursor}})
+        @client.request(req)
+      end
+
+      # @param blk [Proc]
+      #
+      # @yieldparam [generic<Elem>]
+      def auto_paging_each(&blk)
+        unless block_given?
+          raise ArgumentError.new("A block must be given to ##{__method__}")
+        end
+
+        page = self
+        loop do
+          page.entries&.each(&blk)
+
+          break unless page.next_page?
+          page = page.next_page
+        end
+      end
+
+      # @api private
+      #
+      # @param client [Cerca::Internal::Transport::BaseClient]
+      # @param req [Hash{Symbol=>Object}]
+      # @param headers [Hash{String=>String}]
+      # @param page_data [Hash{Symbol=>Object}]
+      def initialize(client:, req:, headers:, page_data:)
+        super
+
+        case page_data
+        in {entries: Array => entries}
+          @entries = entries.map { Cerca::Internal::Type::Converter.coerce(@model, _1) }
+        else
+        end
+        @cursor = page_data[:cursor]
+        @has_more = page_data[:hasMore]
+      end
+
+      # @api private
+      #
+      # @return [String]
+      def inspect
+        # rubocop:disable Layout/LineLength
+        model = Cerca::Internal::Type::Converter.inspect(@model, depth: 1)
+
+        "#<#{self.class}[#{model}]:0x#{object_id.to_s(16)} cursor=#{cursor.inspect} has_more=#{has_more.inspect}>"
+        # rubocop:enable Layout/LineLength
+      end
+    end
+  end
+end

data/lib/cerca/internal/events_cursor_page.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Internal
+    # @generic Elem
+    #
+    # @example
+    #   if events_cursor_page.has_next?
+    #     events_cursor_page = events_cursor_page.next_page
+    #   end
+    #
+    # @example
+    #   events_cursor_page.auto_paging_each do |event|
+    #     puts(event)
+    #   end
+    class EventsCursorPage
+      include Cerca::Internal::Type::BasePage
+
+      # @return [Array<generic<Elem>>, nil]
+      attr_accessor :events
+
+      # @return [String, nil]
+      attr_accessor :cursor
+
+      # @return [Boolean]
+      attr_accessor :has_more
+
+      # @return [Boolean]
+      def next_page?
+        has_more
+      end
+
+      # @raise [Cerca::HTTP::Error]
+      # @return [self]
+      def next_page
+        unless next_page?
+          message = "No more pages available. Please check #next_page? before calling ##{__method__}"
+          raise RuntimeError.new(message)
+        end
+
+        req = Cerca::Internal::Util.deep_merge(@req, {query: {cursor: cursor}})
+        @client.request(req)
+      end
+
+      # @param blk [Proc]
+      #
+      # @yieldparam [generic<Elem>]
+      def auto_paging_each(&blk)
+        unless block_given?
+          raise ArgumentError.new("A block must be given to ##{__method__}")
+        end
+
+        page = self
+        loop do
+          page.events&.each(&blk)
+
+          break unless page.next_page?
+          page = page.next_page
+        end
+      end
+
+      # @api private
+      #
+      # @param client [Cerca::Internal::Transport::BaseClient]
+      # @param req [Hash{Symbol=>Object}]
+      # @param headers [Hash{String=>String}]
+      # @param page_data [Hash{Symbol=>Object}]
+      def initialize(client:, req:, headers:, page_data:)
+        super
+
+        case page_data
+        in {events: Array => events}
+          @events = events.map { Cerca::Internal::Type::Converter.coerce(@model, _1) }
+        else
+        end
+        @cursor = page_data[:cursor]
+        @has_more = page_data[:hasMore]
+      end
+
+      # @api private
+      #
+      # @return [String]
+      def inspect
+        # rubocop:disable Layout/LineLength
+        model = Cerca::Internal::Type::Converter.inspect(@model, depth: 1)
+
+        "#<#{self.class}[#{model}]:0x#{object_id.to_s(16)} cursor=#{cursor.inspect} has_more=#{has_more.inspect}>"
+        # rubocop:enable Layout/LineLength
+      end
+    end
+  end
+end

data/lib/cerca/internal/fleets_cursor_page.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Internal
+    # @generic Elem
+    #
+    # @example
+    #   if fleets_cursor_page.has_next?
+    #     fleets_cursor_page = fleets_cursor_page.next_page
+    #   end
+    #
+    # @example
+    #   fleets_cursor_page.auto_paging_each do |auth|
+    #     puts(auth)
+    #   end
+    class FleetsCursorPage
+      include Cerca::Internal::Type::BasePage
+
+      # @return [Array<generic<Elem>>, nil]
+      attr_accessor :fleets
+
+      # @return [String, nil]
+      attr_accessor :cursor
+
+      # @return [Boolean]
+      attr_accessor :has_more
+
+      # @return [Boolean]
+      def next_page?
+        has_more
+      end
+
+      # @raise [Cerca::HTTP::Error]
+      # @return [self]
+      def next_page
+        unless next_page?
+          message = "No more pages available. Please check #next_page? before calling ##{__method__}"
+          raise RuntimeError.new(message)
+        end
+
+        req = Cerca::Internal::Util.deep_merge(@req, {query: {cursor: cursor}})
+        @client.request(req)
+      end
+
+      # @param blk [Proc]
+      #
+      # @yieldparam [generic<Elem>]
+      def auto_paging_each(&blk)
+        unless block_given?
+          raise ArgumentError.new("A block must be given to ##{__method__}")
+        end
+
+        page = self
+        loop do
+          page.fleets&.each(&blk)
+
+          break unless page.next_page?
+          page = page.next_page
+        end
+      end
+
+      # @api private
+      #
+      # @param client [Cerca::Internal::Transport::BaseClient]
+      # @param req [Hash{Symbol=>Object}]
+      # @param headers [Hash{String=>String}]
+      # @param page_data [Hash{Symbol=>Object}]
+      def initialize(client:, req:, headers:, page_data:)
+        super
+
+        case page_data
+        in {fleets: Array => fleets}
+          @fleets = fleets.map { Cerca::Internal::Type::Converter.coerce(@model, _1) }
+        else
+        end
+        @cursor = page_data[:cursor]
+        @has_more = page_data[:hasMore]
+      end
+
+      # @api private
+      #
+      # @return [String]
+      def inspect
+        # rubocop:disable Layout/LineLength
+        model = Cerca::Internal::Type::Converter.inspect(@model, depth: 1)
+
+        "#<#{self.class}[#{model}]:0x#{object_id.to_s(16)} cursor=#{cursor.inspect} has_more=#{has_more.inspect}>"
+        # rubocop:enable Layout/LineLength
+      end
+    end
+  end
+end

data/lib/cerca/internal/grants_cursor_page.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Internal
+    # @generic Elem
+    #
+    # @example
+    #   if grants_cursor_page.has_next?
+    #     grants_cursor_page = grants_cursor_page.next_page
+    #   end
+    #
+    # @example
+    #   grants_cursor_page.auto_paging_each do |approval_grant|
+    #     puts(approval_grant)
+    #   end
+    class GrantsCursorPage
+      include Cerca::Internal::Type::BasePage
+
+      # @return [Array<generic<Elem>>, nil]
+      attr_accessor :grants
+
+      # @return [String, nil]
+      attr_accessor :cursor
+
+      # @return [Boolean]
+      attr_accessor :has_more
+
+      # @return [Boolean]
+      def next_page?
+        has_more
+      end
+
+      # @raise [Cerca::HTTP::Error]
+      # @return [self]
+      def next_page
+        unless next_page?
+          message = "No more pages available. Please check #next_page? before calling ##{__method__}"
+          raise RuntimeError.new(message)
+        end
+
+        req = Cerca::Internal::Util.deep_merge(@req, {query: {cursor: cursor}})
+        @client.request(req)
+      end
+
+      # @param blk [Proc]
+      #
+      # @yieldparam [generic<Elem>]
+      def auto_paging_each(&blk)
+        unless block_given?
+          raise ArgumentError.new("A block must be given to ##{__method__}")
+        end
+
+        page = self
+        loop do
+          page.grants&.each(&blk)
+
+          break unless page.next_page?
+          page = page.next_page
+        end
+      end
+
+      # @api private
+      #
+      # @param client [Cerca::Internal::Transport::BaseClient]
+      # @param req [Hash{Symbol=>Object}]
+      # @param headers [Hash{String=>String}]
+      # @param page_data [Hash{Symbol=>Object}]
+      def initialize(client:, req:, headers:, page_data:)
+        super
+
+        case page_data
+        in {grants: Array => grants}
+          @grants = grants.map { Cerca::Internal::Type::Converter.coerce(@model, _1) }
+        else
+        end
+        @cursor = page_data[:cursor]
+        @has_more = page_data[:hasMore]
+      end
+
+      # @api private
+      #
+      # @return [String]
+      def inspect
+        # rubocop:disable Layout/LineLength
+        model = Cerca::Internal::Type::Converter.inspect(@model, depth: 1)
+
+        "#<#{self.class}[#{model}]:0x#{object_id.to_s(16)} cursor=#{cursor.inspect} has_more=#{has_more.inspect}>"
+        # rubocop:enable Layout/LineLength
+      end
+    end
+  end
+end