latitude-api 0.2.0

data/lib/latitude/metadata/session.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+module Latitude
+  module Metadata
+    class Session
+      BASE_URL = "http://169.254.169.254/metadata/v1"
+      TOKEN_REFRESH_RATIO = 0.9
+
+      JSON_PATHS = %w[tags network storage ssh_keys vendor].freeze
+      UNAVAILABLE_EXCEPTIONS = [
+        Errno::ECONNREFUSED,
+        Errno::EHOSTUNREACH,
+        Errno::ENETUNREACH,
+        Errno::ETIMEDOUT,
+        Net::OpenTimeout,
+        Net::ReadTimeout,
+        SocketError,
+      ].freeze
+
+      def initialize(ttl: DEFAULT_TTL_SECONDS, open_timeout: 2, read_timeout: 3)
+        @ttl = Integer(ttl)
+        @open_timeout = open_timeout
+        @read_timeout = read_timeout
+        @mutex = Mutex.new
+        @token = nil
+        @token_expires_at = nil
+      end
+
+      def token
+        @mutex.synchronize { refresh_token_if_needed }
+      end
+
+      def refresh_token!
+        @mutex.synchronize { fetch_new_token }
+      end
+
+      def all
+        body = get("metadata.json")
+        wrap(JSON.parse(body))
+      rescue JSON::ParserError => e
+        raise RequestError.new("Invalid JSON from metadata service: #{e.message}")
+      end
+
+      def fetch(path)
+        path = path.to_s.sub(%r{\A/}, "")
+        body = get(path)
+        if JSON_PATHS.include?(path) || path == "metadata.json"
+          begin
+            wrap(JSON.parse(body))
+          rescue JSON::ParserError
+            body
+          end
+        else
+          body
+        end
+      end
+
+      private
+
+      def wrap(value)
+        Latitude::API::APIObject.wrap(value)
+      end
+
+      def get(path)
+        perform_request(:get, "#{BASE_URL}/#{path}", headers: { "X-Metadata-Token" => token })
+      end
+
+      def perform_request(method, url, headers: {}, body: nil)
+        options = {
+          headers: headers,
+          open_timeout: @open_timeout,
+          read_timeout: @read_timeout,
+          follow_redirects: false,
+          format: :plain,
+        }
+        options[:body] = body if body
+
+        response = HTTParty.send(method, url, options)
+
+        if response.code.between?(200, 299)
+          response.body
+        else
+          raise RequestError.new("metadata service returned #{response.code}", http_status: response.code,
+                                                                               http_body: response.body)
+        end
+      rescue *UNAVAILABLE_EXCEPTIONS => e
+        raise Unavailable, "metadata service unreachable (#{e.class}: #{e.message}). " \
+                           "This only works from within a Latitude.sh bare metal server."
+      end
+
+      def refresh_token_if_needed
+        fetch_new_token if @token.nil? || @token_expires_at.nil? || Time.now >= @token_expires_at
+        @token
+      end
+
+      def fetch_new_token
+        body = perform_request(:put, "#{BASE_URL}/api/token",
+                               headers: { "X-Metadata-Token-TTL-Seconds" => @ttl.to_s })
+        raise TokenError, "empty token response" if body.nil? || body.strip.empty?
+
+        @token = body.strip
+        @token_expires_at = Time.now + (@ttl * TOKEN_REFRESH_RATIO)
+        @token
+      rescue RequestError => e
+        raise TokenError, "could not obtain metadata token: #{e.message}"
+      end
+    end
+  end
+end

data/lib/latitude/metadata.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require "httparty"
+
+require "latitude/metadata/errors"
+require "latitude/metadata/session"
+
+module Latitude
+  module Metadata
+    DEFAULT_TTL_SECONDS = 3600
+    PATHS = %w[
+      instance_id hostname local_ipv4 public_ipv4 public_ipv6 region plan
+      operating_system userdata tags network storage ssh_keys vendor
+    ].freeze
+
+    module_function
+
+    def all(session: default_session)
+      session.all
+    end
+
+    PATHS.each do |p|
+      define_singleton_method(p) { default_session.fetch(p) }
+    end
+
+    def fetch(path, session: default_session)
+      session.fetch(path)
+    end
+
+    def refresh!
+      default_session.refresh_token!
+      self
+    end
+
+    def reset!
+      @default_session = nil
+    end
+
+    def default_session
+      @default_session ||= Session.new
+    end
+  end
+end

data/lib/latitude.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require "latitude/api"
+require "latitude/metadata"

metadata

@@ -0,0 +1,132 @@
+--- !ruby/object:Gem::Specification
+name: latitude-api
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Josh Brody
+bindir: exe
+cert_chain: []
+date: 2026-09-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+description: A Ruby library for the Latitude.sh REST API. Covers servers, projects,
+  virtual machines, Kubernetes clusters, storage, networking, firewalls, elastic IPs,
+  SSH keys, teams, and more. Includes a client for the on-instance metadata service.
+email:
+- git@josh.mn
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".yardopts"
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/latitude.rb
+- lib/latitude/api.rb
+- lib/latitude/api/api_object.rb
+- lib/latitude/api/api_resource.rb
+- lib/latitude/api/attributes.rb
+- lib/latitude/api/client.rb
+- lib/latitude/api/configuration.rb
+- lib/latitude/api/errors.rb
+- lib/latitude/api/json_api.rb
+- lib/latitude/api/list_object.rb
+- lib/latitude/api/objects.rb
+- lib/latitude/api/operations/action.rb
+- lib/latitude/api/operations/create.rb
+- lib/latitude/api/operations/delete.rb
+- lib/latitude/api/operations/list.rb
+- lib/latitude/api/operations/nested.rb
+- lib/latitude/api/operations/retrieve.rb
+- lib/latitude/api/operations/update.rb
+- lib/latitude/api/request_executor.rb
+- lib/latitude/api/request_options.rb
+- lib/latitude/api/request_params.rb
+- lib/latitude/api/resources/api_key.rb
+- lib/latitude/api/resources/billing_usage.rb
+- lib/latitude/api/resources/elastic_ip.rb
+- lib/latitude/api/resources/event.rb
+- lib/latitude/api/resources/firewall.rb
+- lib/latitude/api/resources/ip.rb
+- lib/latitude/api/resources/kubernetes_cluster.rb
+- lib/latitude/api/resources/plan.rb
+- lib/latitude/api/resources/project.rb
+- lib/latitude/api/resources/region.rb
+- lib/latitude/api/resources/role.rb
+- lib/latitude/api/resources/server.rb
+- lib/latitude/api/resources/ssh_key.rb
+- lib/latitude/api/resources/storage_filesystem.rb
+- lib/latitude/api/resources/storage_object.rb
+- lib/latitude/api/resources/storage_volume.rb
+- lib/latitude/api/resources/tag.rb
+- lib/latitude/api/resources/team.rb
+- lib/latitude/api/resources/traffic.rb
+- lib/latitude/api/resources/user_data.rb
+- lib/latitude/api/resources/user_profile.rb
+- lib/latitude/api/resources/user_team.rb
+- lib/latitude/api/resources/virtual_machine.rb
+- lib/latitude/api/resources/virtual_network.rb
+- lib/latitude/api/resources/vpn_session.rb
+- lib/latitude/api/singleton_api_resource.rb
+- lib/latitude/api/util.rb
+- lib/latitude/api/version.rb
+- lib/latitude/metadata.rb
+- lib/latitude/metadata/errors.rb
+- lib/latitude/metadata/session.rb
+homepage: https://github.com/joshmn/latitude-api
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/joshmn/latitude-api
+  source_code_uri: https://github.com/joshmn/latitude-api
+  changelog_uri: https://github.com/joshmn/latitude-api/blob/main/CHANGELOG.md
+  documentation_uri: https://rubydoc.info/gems/latitude-api
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: Ruby client for the Latitude.sh API
+test_files: []