latitude-api 0.2.0

data/lib/latitude/api/request_options.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module Latitude
+  module API
+    class RequestOptions
+      ALLOWED = %i[
+        api_key
+        api_version
+        api_base
+        open_timeout
+        read_timeout
+        write_timeout
+        max_network_retries
+        proxy
+        idempotency_key
+        headers
+      ].freeze
+
+      attr_reader :api_key, :api_version, :api_base,
+                  :open_timeout, :read_timeout, :write_timeout,
+                  :max_network_retries, :proxy,
+                  :idempotency_key, :headers
+
+      def initialize(opts = {})
+        opts ||= {}
+        validate!(opts)
+        @api_key              = opts[:api_key]
+        @api_version          = opts[:api_version]
+        @api_base             = opts[:api_base]
+        @open_timeout         = opts[:open_timeout]
+        @read_timeout         = opts[:read_timeout]
+        @write_timeout        = opts[:write_timeout]
+        @max_network_retries  = opts[:max_network_retries]
+        @proxy                = opts[:proxy]
+        @idempotency_key      = opts[:idempotency_key]
+        @headers              = opts[:headers] || {}
+      end
+
+      def self.wrap(opts)
+        return opts if opts.is_a?(RequestOptions)
+
+        new(opts || {})
+      end
+
+      def merge(other)
+        other = self.class.wrap(other)
+        merged = to_h.merge(other.to_h) { |_k, a, b| b.nil? ? a : b }
+        merged[:headers] = @headers.merge(other.headers || {})
+        self.class.new(merged)
+      end
+
+      def to_h
+        {
+          api_key: @api_key,
+          api_version: @api_version,
+          api_base: @api_base,
+          open_timeout: @open_timeout,
+          read_timeout: @read_timeout,
+          write_timeout: @write_timeout,
+          max_network_retries: @max_network_retries,
+          proxy: @proxy,
+          idempotency_key: @idempotency_key,
+          headers: @headers,
+        }
+      end
+
+      def apply_to(config)
+        overrides = to_h.compact
+        overrides.delete(:idempotency_key)
+        overrides.delete(:headers)
+        return config if overrides.empty?
+
+        config.dup_with(**overrides)
+      end
+
+      private
+
+      def validate!(opts)
+        extras = opts.keys.map(&:to_sym) - ALLOWED
+        return if extras.empty?
+
+        raise ArgumentError, "unknown request option(s): #{extras.join(', ')}"
+      end
+    end
+  end
+end

data/lib/latitude/api/request_params.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module Latitude
+  module API
+    module RequestParams
+      COMMA_JOIN_LEAVES = %w[tags extra_fields].freeze
+
+      module_function
+
+      def encode(params)
+        return "" if params.nil? || params.empty?
+
+        parts = []
+        flatten(params, nil, parts)
+        parts.map { |k, v| "#{URI.encode_www_form_component(k)}=#{URI.encode_www_form_component(v)}" }.join("&")
+      end
+
+      def flatten(value, parent_key, parts)
+        case value
+        when Hash
+          value.each do |k, v|
+            next if v.nil?
+
+            key = parent_key ? "#{parent_key}[#{k}]" : k.to_s
+            flatten(v, key, parts)
+          end
+        when Array
+          if comma_join?(parent_key, value)
+            parts << [parent_key, value.map(&:to_s).join(",")]
+          else
+            value.each_with_index do |v, _i|
+              flatten(v, "#{parent_key}[]", parts)
+            end
+          end
+        when nil
+          nil
+        when true, false
+          parts << [parent_key, value.to_s]
+        else
+          parts << [parent_key, scalar(value)]
+        end
+      end
+
+      def comma_join?(parent_key, value)
+        return false unless parent_key
+        return false unless value.all? { |v| v.is_a?(String) || v.is_a?(Symbol) || v.is_a?(Numeric) }
+
+        leaf = parent_key.split(/[\[\]]/).reject(&:empty?).last
+        COMMA_JOIN_LEAVES.include?(leaf)
+      end
+
+      def scalar(value)
+        case value
+        when Time, DateTime
+          value.utc.iso8601
+        when Date
+          value.iso8601
+        else
+          value.to_s
+        end
+      end
+
+      def encode_sort(value)
+        return nil if value.nil?
+
+        Array(value).map(&:to_s).reject(&:empty?).join(",")
+      end
+    end
+  end
+end

data/lib/latitude/api/resources/api_key.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Latitude
+  module API
+    module Resources
+      # @!attribute [rw] name
+      #   @return [String]
+      # @!attribute [rw] token
+      #   @return [String]
+      # @!attribute [rw] token_last_slice
+      #   @return [String]
+      # @!attribute [rw] api_version
+      #   @return [String]
+      # @!attribute [rw] read_only
+      #   @return [Boolean]
+      # @!attribute [rw] allowed_ips
+      #   @return [String]
+      # @!attribute [r] created_at
+      #   @return [Time]
+      # @!attribute [r] updated_at
+      #   @return [Time]
+      # @!attribute [rw] last_used_at
+      #   @return [Time]
+      # @!attribute [rw] user
+      #   @return [Latitude::API::Objects::User]
+      class APIKey < APIResource
+        attribute :name, :string
+        attribute :token, :string
+        attribute :token_last_slice, :string
+        attribute :api_version, :string
+        attribute :read_only, :boolean
+        attribute :allowed_ips, :string
+        attribute :created_at, :time, read_only: true
+        attribute :updated_at, :time, read_only: true
+        attribute :last_used_at, :time
+        attribute :user, Objects::User
+
+        resource_type "api_keys"
+        resource_path "/auth/api_keys"
+        id_prefix     "tok_"
+
+        extend Operations::List
+        extend Operations::Create
+        extend Operations::Update
+        extend Operations::Delete
+
+        class << self
+          def rotate(id, params = {}, opts = {})
+            body = JSONAPI.encode(type: resource_type, id: id, attributes: params)
+            parsed = execute_request(method: :put, path: instance_url(id), body: body, opts: opts)
+            construct_from(parsed, opts: opts)
+          end
+        end
+
+        def rotate(params = {}, opts = {})
+          self.class.rotate(id, params, opts)
+        end
+      end
+    end
+  end
+end

data/lib/latitude/api/resources/billing_usage.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Latitude
+  module API
+    module Resources
+      # @!attribute [rw] project
+      #   @return [Latitude::API::Objects::Project]
+      # @!attribute [rw] period
+      #   @return [Period]
+      # @!attribute [rw] available_credit_balance
+      #   @return [Integer]
+      # @!attribute [rw] amount
+      #   @return [Integer]
+      # @!attribute [rw] price
+      #   @return [Integer]
+      # @!attribute [rw] products
+      #   @return [Array]
+      # @!attribute [rw] threshold
+      #   @return [Integer]
+      class BillingUsage < SingletonAPIResource
+          # @!attribute [r] start
+          #   @return [Time]
+          # @!attribute [r] end
+          #   @return [Time]
+        class Period < APIObject
+          attribute :start, :time, read_only: true
+          attribute :end, :time, read_only: true
+        end
+
+        attribute :project, Objects::Project
+        attribute :period, Period
+        attribute :available_credit_balance, :integer
+        attribute :amount, :integer
+        attribute :price, :integer
+        attribute :products, :array
+        attribute :threshold, :integer
+
+        resource_type "billing_usage"
+        resource_path "/billing/usage"
+
+        class << self
+          def retrieve(params = {}, opts = {})
+            query = RequestParams.encode(params)
+            parsed = execute_request(method: :get, path: resource_path, query: query, opts: opts)
+            construct_from(parsed, opts: opts)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/latitude/api/resources/elastic_ip.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+module Latitude
+  module API
+    module Resources
+      # @!attribute [rw] address
+      #   @return [String]
+      # @!attribute [rw] family
+      #   @return [String]
+      # @!attribute [rw] prefix_length
+      #   @return [Integer]
+      # @!attribute [rw] mode
+      #   @return [String]
+      # @!attribute [rw] status
+      #   @return [String]
+      # @!attribute [r] created_at
+      #   @return [Time]
+      # @!attribute [rw] server
+      #   @return [Server]
+      # @!attribute [rw] project
+      #   @return [Latitude::API::Objects::Project]
+      # @!attribute [rw] region
+      #   @return [Region]
+      class ElasticIP < APIResource
+          # @!attribute [r] id
+          #   @return [String]
+          # @!attribute [r] hostname
+          #   @return [String]
+          # @!attribute [r] primary_ipv4
+          #   @return [String]
+          # @!attribute [r] operating_system
+          #   @return [String]
+        class Server < APIObject
+          attribute :id, :string, read_only: true
+          attribute :hostname, :string, read_only: true
+          attribute :primary_ipv4, :string, read_only: true
+          attribute :operating_system, :string, read_only: true
+        end
+
+          # @!attribute [r] id
+          #   @return [String]
+          # @!attribute [r] name
+          #   @return [String]
+          # @!attribute [r] slug
+          #   @return [String]
+        class Location < APIObject
+          attribute :id, :string, read_only: true
+          attribute :name, :string, read_only: true
+          attribute :slug, :string, read_only: true
+        end
+
+          # @!attribute [r] id
+          #   @return [String]
+          # @!attribute [r] name
+          #   @return [String]
+          # @!attribute [r] location
+          #   @return [Location]
+        class Region < APIObject
+          attribute :id, :string, read_only: true
+          attribute :name, :string, read_only: true
+          attribute :location, Location, read_only: true
+        end
+
+        attribute :address, :string
+        attribute :family, :string
+        attribute :prefix_length, :integer
+        attribute :mode, :string
+        attribute :status, :string
+        attribute :created_at, :time, read_only: true
+        attribute :server, Server
+        attribute :project, Objects::Project
+        attribute :region, Region
+
+        resource_type "elastic_ips"
+        resource_path "/elastic_ips"
+        id_prefix     "eip_"
+
+        extend Operations::List
+        extend Operations::Create
+        extend Operations::Retrieve
+        extend Operations::Update
+        extend Operations::Delete
+
+        class << self
+          def move(id, server_id:, opts: {})
+            update(id, { server_id: server_id }, opts)
+          end
+        end
+
+        def move_to(server_id, opts = {})
+          self.class.move(id, server_id: server_id, opts: opts)
+        end
+      end
+    end
+  end
+end

data/lib/latitude/api/resources/event.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Latitude
+  module API
+    module Resources
+      # @!attribute [r] created_at
+      #   @return [Time]
+      # @!attribute [rw] action
+      #   @return [String]
+      # @!attribute [rw] target
+      #   @return [Target]
+      # @!attribute [rw] project
+      #   @return [Latitude::API::Objects::Project]
+      # @!attribute [rw] team
+      #   @return [Latitude::API::Objects::Team]
+      # @!attribute [rw] author
+      #   @return [Author]
+      class Event < APIResource
+          # @!attribute [r] id
+          #   @return [String]
+          # @!attribute [r] name
+          #   @return [String]
+        class Target < APIObject
+          attribute :id, :string, read_only: true
+          attribute :name, :string, read_only: true
+        end
+
+          # @!attribute [r] id
+          #   @return [String]
+          # @!attribute [r] name
+          #   @return [String]
+          # @!attribute [r] email
+          #   @return [String]
+        class Author < APIObject
+          attribute :id, :string, read_only: true
+          attribute :name, :string, read_only: true
+          attribute :email, :string, read_only: true
+        end
+
+        attribute :created_at, :time, read_only: true
+        attribute :action, :string
+        attribute :target, Target
+        attribute :project, Objects::Project
+        attribute :team, Objects::Team
+        attribute :author, Author
+
+        resource_type "events"
+        resource_path "/events"
+        id_prefix     "evt_"
+
+        extend Operations::List
+      end
+    end
+  end
+end

data/lib/latitude/api/resources/firewall.rb

@@ -0,0 +1,129 @@
+# frozen_string_literal: true
+
+module Latitude
+  module API
+    module Resources
+      # @!attribute [rw] name
+      #   @return [String]
+      # @!attribute [rw] project
+      #   @return [Latitude::API::Objects::Project]
+      # @!attribute [rw] rules
+      #   @return [Array<Rule>]
+      class Firewall < APIResource
+          # @!attribute [r] from
+          #   @return [String]
+          # @!attribute [r] to
+          #   @return [String]
+          # @!attribute [r] port
+          #   @return [String]
+          # @!attribute [r] protocol
+          #   @return [String]
+          # @!attribute [r] default
+          #   @return [Boolean]
+        class Rule < APIObject
+          attribute :from, :string, read_only: true
+          attribute :to, :string, read_only: true
+          attribute :port, :string, read_only: true
+          attribute :protocol, :string, read_only: true
+          attribute :default, :boolean, read_only: true
+        end
+
+        attribute :name, :string
+        attribute :project, Objects::Project
+        attribute :rules, [Rule]
+
+        resource_type "firewalls"
+        resource_path "/firewalls"
+        id_prefix     "firewall_"
+
+        extend Operations::List
+        extend Operations::Create
+        extend Operations::Retrieve
+        extend Operations::Update
+        extend Operations::Delete
+
+        class << self
+          def assignments
+            Assignment
+          end
+        end
+
+        # @!attribute [rw] server
+
+        #   @return [Server]
+
+        # @!attribute [rw] firewall
+
+        #   @return [Firewall]
+
+        # @!attribute [rw] firewall_id
+
+        #   @return [String]
+
+        class Assignment < APIResource
+
+            # @!attribute [r] id
+
+            #   @return [String]
+
+            # @!attribute [r] hostname
+
+            #   @return [String]
+
+            # @!attribute [r] primary_ipv4
+
+            #   @return [String]
+
+          class Server < APIObject
+
+            attribute :id, :string, read_only: true
+
+            attribute :hostname, :string, read_only: true
+
+            attribute :primary_ipv4, :string, read_only: true
+
+          end
+
+
+            # @!attribute [r] id
+
+            #   @return [String]
+
+            # @!attribute [r] name
+
+            #   @return [String]
+
+          class Firewall < APIObject
+
+            attribute :id, :string, read_only: true
+
+            attribute :name, :string, read_only: true
+
+          end
+
+
+          attribute :server, Server
+
+          attribute :firewall, Firewall
+
+          attribute :firewall_id, :string
+
+          resource_type "firewall_assignments"
+          resource_path "/firewalls/:firewall_id/assignments"
+
+          extend Operations::List
+          extend Operations::Create
+          extend Operations::Delete
+
+          class << self
+            def list_all(params = {}, opts = {})
+              query = RequestParams.encode(params)
+              parsed = execute_request(method: :get, path: "/firewalls/assignments", query: query, opts: opts)
+              ListObject.new(resource_class: self, parsed: parsed, request_params: params, request_opts: opts)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/latitude/api/resources/ip.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+module Latitude
+  module API
+    module Resources
+      # @!attribute [rw] address
+      #   @return [String]
+      # @!attribute [rw] cidr
+      #   @return [String]
+      # @!attribute [rw] family
+      #   @return [String]
+      # @!attribute [rw] gateway
+      #   @return [String]
+      # @!attribute [rw] netmask
+      #   @return [String]
+      # @!attribute [rw] type
+      #   @return [String]
+      # @!attribute [rw] public
+      #   @return [Boolean]
+      # @!attribute [rw] management
+      #   @return [Boolean]
+      # @!attribute [rw] additional
+      #   @return [Boolean]
+      # @!attribute [rw] project
+      #   @return [Latitude::API::Objects::Project]
+      # @!attribute [rw] region
+      #   @return [Region]
+      # @!attribute [rw] available
+      #   @return [Boolean]
+      # @!attribute [rw] assignment
+      #   @return [Assignment]
+      # @!attribute [rw] elastic
+      #   @return [Elastic]
+      # @!attribute [r] created_at
+      #   @return [Time]
+      class IP < APIResource
+          # @!attribute [r] id
+          #   @return [String]
+          # @!attribute [r] name
+          #   @return [String]
+          # @!attribute [r] slug
+          #   @return [String]
+        class Location < APIObject
+          attribute :id, :string, read_only: true
+          attribute :name, :string, read_only: true
+          attribute :slug, :string, read_only: true
+        end
+
+          # @!attribute [r] id
+          #   @return [String]
+          # @!attribute [r] name
+          #   @return [String]
+          # @!attribute [r] location
+          #   @return [Location]
+        class Region < APIObject
+          attribute :id, :string, read_only: true
+          attribute :name, :string, read_only: true
+          attribute :location, Location, read_only: true
+        end
+
+          # @!attribute [r] server_id
+          #   @return [String]
+          # @!attribute [r] hostname
+          #   @return [String]
+          # @!attribute [r] assigned_at
+          #   @return [String]
+        class Assignment < APIObject
+          attribute :server_id, :string, read_only: true
+          attribute :hostname, :string, read_only: true
+          attribute :assigned_at, :string, read_only: true
+        end
+
+          # @!attribute [r] id
+          #   @return [String]
+          # @!attribute [r] mode
+          #   @return [String]
+          # @!attribute [r] status
+          #   @return [String]
+        class Elastic < APIObject
+          attribute :id, :string, read_only: true
+          attribute :mode, :string, read_only: true
+          attribute :status, :string, read_only: true
+        end
+
+        attribute :address, :string
+        attribute :cidr, :string
+        attribute :family, :string
+        attribute :gateway, :string
+        attribute :netmask, :string
+        attribute :type, :string
+        attribute :public, :boolean
+        attribute :management, :boolean
+        attribute :additional, :boolean
+        attribute :project, Objects::Project
+        attribute :region, Region
+        attribute :available, :boolean
+        attribute :assignment, Assignment
+        attribute :elastic, Elastic
+        attribute :created_at, :time, read_only: true
+
+        resource_type "ip_addresses"
+        resource_path "/ips"
+        id_prefix     "ip_"
+
+        extend Operations::List
+        extend Operations::Retrieve
+      end
+    end
+  end
+end