k8y 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4af0d1dcdd836cab3430faa1d86ebad78e6aa9ed4d935a86a11ba0f4cc11f245
+  data.tar.gz: f79b384ede82574419718223ab399ca2b4b1ee778d001433a4c0e721529cac69
+SHA512:
+  metadata.gz: 3048c108fb78383700dbfbb3527645cde925ad2cd56dbe01f36d2728642240e9ce93ad6555150a519f16605f1c6d5337019e7dff6548fc416ec887bdf58f3390
+  data.tar.gz: 0af26a9f575cbbe9b785c6ecb761df8d1cd97f731905b33f98a5d462562a0d2117f69fbe235c4dae311d05d3b281854c3121480bae3ffe3d9164c6419c2fc16a

data/.github/workflows/main.yml

@@ -0,0 +1,34 @@
+name: Ruby
+
+on: [push,pull_request]
+
+jobs:
+  ruby:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: 2.7.2
+        bundler-cache: true
+    - name: Run the default task
+      run: bundle exec rake
+    - name: Lint
+      run: bundle exec rubocop
+  kind:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@master
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 2.7.2
+          bundler-cache: true
+      - name: Set up KinD
+        uses: engineerd/setup-kind@v0.5.0
+        with:
+          version: "v0.11.1"
+      - name: In-cluster tests
+        run: |
+          bundle exec rake test_integration

data/.gitignore

@@ -0,0 +1,24 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/.DS_Store
+
+# Rake-able scratch working directory
+/scratch
+
+# Ignore lockfile for gem
+Gemfile.lock
+
+# debug logs
+.byebug_history
+
+# development kubeconfig
+/kubeconfig
+
+# A handy file for keeping scraps around
+/scratch

data/.rubocop.yml

@@ -0,0 +1,8 @@
+inherit_gem:
+  rubocop-shopify: rubocop.yml
+
+Naming/AccessorMethodName:
+  Enabled: false
+
+AllCops:
+  SuggestExtensions: false

data/CHANGELOG.md

@@ -0,0 +1 @@
+## next

data/Gemfile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in k8y.gemspec
+gemspec
+
+gem "rake", "~> 13.0"

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Kir Shatrov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1 @@
+Kubernetes client for Ruby

data/Rakefile

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+task default: ["test"]
+
+desc("Run test suite")
+Rake::TestTask.new(:test) do |task|
+  task.libs << "test"
+  task.libs << "lib"
+  task.test_files = FileList["test/unit/**/*_test.rb"]
+end
+
+desc("Run in-cluster integrations tests")
+Rake::TestTask.new(:test_integration) do |task|
+  ENV["PARALLELIZE_ME"] = ENV.fetch("PARALLELIZE_ME", "1")
+  ENV["MT_CPU"] = ENV.fetch("MT_CPU", "8")
+  task.libs << "test"
+  task.libs << "lib"
+  task.test_files = FileList["test/integration/**/*_test.rb"]
+  task.warning = false
+end

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "k8y"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/k8y.gemspec

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require_relative "lib/k8y/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "k8y"
+  spec.version       = K8y::VERSION
+  spec.authors       = ["Timothy Smith"]
+  spec.email         = ["tsontario@gmail.com"]
+
+  spec.summary       = "Ruby client for interacting with kubernetes clusters"
+  spec.description   = "Ruby client for interacting with kubernetes clusters"
+  spec.homepage      = "https://github.com/tsontario/k8y"
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.7.0")
+
+  # spec.metadata["allowed_push_host"] = "TODO: Set to 'http://mygemserver.com'"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = spec.homepage
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    %x(git ls-files -z).split("\x0").reject { |f| f.match(%r{\A(?:test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency("faraday", "~> 1.6")
+  spec.add_dependency("recursive-open-struct", "~>1.1")
+  spec.add_dependency("railties", "~> 6.0")
+  spec.add_dependency("activesupport", "~> 6.0")
+
+  spec.add_development_dependency("byebug", "~> 11")
+  spec.add_development_dependency("minitest", "~> 5")
+  spec.add_development_dependency("minitest-reporters")
+  spec.add_development_dependency("mocha", "~> 1")
+  spec.add_development_dependency("rubocop", "~> 1")
+  spec.add_development_dependency("rubocop-shopify", "~> 2")
+  spec.add_development_dependency("simplecov")
+  spec.add_development_dependency("webmock", "~> 3.0")
+end

data/lib/k8y/client/api.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require "forwardable"
+
+module K8y
+  module Client
+    class API
+      extend Forwardable
+
+      attr_reader :group_version
+
+      def_delegators(:@group_version, :group, :version)
+
+      def initialize(group_version:)
+        @group_version = group_version
+        @discovered = false
+        @api_methods = {}
+      end
+
+      def discovered?
+        discovered
+      end
+
+      def has_api_method?(method)
+        api_methods.dig(method)
+      end
+
+      # Core/v1 resources are in `/api/#{version}`. In general, all other resources are found in `/apis/GROUP/VERSION`
+      def path
+        @path ||= if group == "core"
+          "/api/#{version}"
+        else
+          "/apis/#{group}/#{version}"
+        end
+      end
+
+      private
+
+      attr_accessor :api_methods, :discovered
+
+      def register_method(method)
+        api_methods[method] = true
+      end
+    end
+  end
+end

data/lib/k8y/client/api_builder.rb

@@ -0,0 +1,162 @@
+# frozen_string_literal: true
+
+require_relative "api"
+require_relative "resource_description"
+
+require "json"
+
+module K8y
+  module Client
+    class APIBuilder < Module
+      attr_reader :api, :config, :context
+
+      VERBS_TO_METHODS = {
+        create: :define_create_resource,
+        delete: :define_delete_resource,
+        get: :define_get_resource,
+        list: :define_get_resources,
+        patch: :define_patch_and_apply_resource,
+        update: :define_update_resource,
+      }
+
+      def initialize(api:, config:, context:)
+        super()
+        @api = api
+        @config = config
+        @context = context
+      end
+
+      def build!
+        rest_client = RESTClient.new(config: config, context: context, path: api.path)
+        response = rest_client.get(as: :raw)
+        resource_descriptions = JSON.parse(response.body)["resources"].map do |resource_description|
+          ResourceDescription.from_hash(resource_description)
+        end
+
+        resource_descriptions.each do |resource_description|
+          next if resource_description.subresource?
+
+          VERBS_TO_METHODS
+            .filter { |verb, _| resource_description.has_verb?(verb) }
+            .each_value { |method| send(method, api, rest_client, resource_description) }
+          api.instance_eval { self.discovered = true }
+        end
+      end
+
+      private
+
+      def define_create_resource(api, rest_client, resource_description)
+        method_name = "create_#{resource_description.singular_name}".to_sym
+        json_content_type = { "Content-Type": "application/json" }
+        api.instance_eval do
+          define_singleton_method(method_name) do |kwargs = {}|
+            namespace = kwargs.fetch(:namespace) if resource_description.namespaced
+            data = kwargs.fetch(:data)
+            headers = kwargs.fetch(:headers, {}).merge(json_content_type)
+            rest_client.post(resource_description.path_for_resources(namespace: namespace),
+              data: JSON.dump(data), headers: headers)
+          end
+          register_method(method_name)
+        end
+      end
+
+      def define_delete_resource(api, rest_client, resource_description)
+        method_name = "delete_#{resource_description.singular_name}".to_sym
+        api.instance_eval do
+          define_singleton_method(method_name) do |kwargs = {}|
+            namespace = kwargs.fetch(:namespace) if resource_description.namespaced
+            name = kwargs.fetch(:name)
+            headers = kwargs.fetch(:headers, {})
+            rest_client.delete(resource_description.path_for_resource(namespace: namespace, name: name),
+              headers: headers)
+          end
+          register_method(method_name)
+        end
+      end
+
+      def define_get_resource(api, rest_client, resource_description)
+        method_name = "get_#{resource_description.singular_name}".to_sym
+        api.instance_eval do
+          define_singleton_method(method_name) do |kwargs = {}|
+            namespace = kwargs.fetch(:namespace) if resource_description.namespaced
+            name = kwargs.fetch(:name)
+            headers = kwargs.fetch(:headers, {})
+            rest_client.get(resource_description.path_for_resource(namespace: namespace, name: name), headers: headers)
+          end
+          register_method(method_name)
+        end
+      end
+
+      def define_get_resources(api, rest_client, resource_description)
+        method_name = "get_#{resource_description.plural_name}".to_sym
+        api.instance_eval do
+          define_singleton_method(method_name) do |kwargs = {}|
+            namespace = kwargs.fetch(:namespace) if resource_description.namespaced
+            headers = kwargs.fetch(:headers, {})
+            rest_client.get(resource_description.path_for_resources(namespace: namespace), headers: headers)
+          end
+          register_method(method_name)
+        end
+      end
+
+      def define_patch_and_apply_resource(api, rest_client, resource_description)
+        define_patch_resource(api, rest_client, resource_description)
+        define_apply_resource(api, rest_client, resource_description)
+      end
+
+      def define_patch_resource(api, rest_client, resource_description)
+        method_name = "patch_#{resource_description.singular_name}".to_sym
+        # Lexically scope this method in the block to make it available inside the closure when invoked by client
+        scoped_content_type_for_patch_strategy = proc { |strategy| content_type_for_patch_strategy(strategy) }
+        api.instance_eval do
+          define_singleton_method(method_name) do |kwargs = {}|
+            namespace = kwargs.fetch(:namespace) if resource_description.namespaced
+            name = kwargs.fetch(:name)
+            data = kwargs.fetch(:data)
+            strategy = kwargs.fetch(:strategy)
+            headers = kwargs.fetch(:headers, {}).merge(scoped_content_type_for_patch_strategy.call(strategy))
+            rest_client.patch(resource_description.path_for_resource(namespace: namespace, name: name),
+              strategy: strategy, data: JSON.dump(data), headers: headers)
+          end
+          register_method(method_name)
+        end
+      end
+
+      def define_apply_resource(api, rest_client, resource_description)
+        # method_name = TODO method name
+        # # TODO: apply is really a special-case of patch, but requires a bit more effort to implement...
+        # api.register_method(method_name)
+      end
+
+      def define_update_resource(api, rest_client, resource_description)
+        method_name = "update_#{resource_description.singular_name}".to_sym
+        json_content_type = { "Content-Type": "application/json" }
+        api.instance_eval do
+          api.define_singleton_method(method_name) do |kwargs = {}|
+            namespace = kwargs.fetch(:namespace) if resource_description.namespaced
+            name = kwargs.fetch(:name)
+            data = kwargs.fetch(:data)
+            headers = kwargs.fetch(:headers, {}).merge(json_content_type)
+            rest_client.put(resource_description.path_for_resource(namespace: namespace, name: name),
+              data: JSON.dump(data), headers: headers)
+          end
+          register_method(method_name)
+        end
+      end
+
+      def content_type_for_patch_strategy(strategy)
+        case strategy
+        when :json
+          { "Content-Type": "application/json-patch+json" }
+        when :merge
+          { "Content-Type": "application/merge-patch+json" }
+        when :strategic_merge
+          { "Content-Type": "application/strategic-merge-patch+json" }
+        else
+          raise ArgumentError, "unknown patch strategy: #{strategy}. Acceptable strategies are" \
+            " :json, :merge, or :strategic_merge"
+        end
+      end
+    end
+  end
+end

data/lib/k8y/client/apis.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require_relative "api"
+
+module K8y
+  module Client
+    class APIs
+      include Enumerable
+      def initialize(group_versions:)
+        @apis = group_versions.each_with_object({}) do |gv, acc|
+          api = API.new(group_version: gv)
+          acc[gv.to_s] = api
+          define_singleton_method(gv.to_method_name) { api }
+        end
+      end
+
+      def each(&block)
+        apis.each { |_, api| yield(api) }
+      end
+
+      def apis_for_method(method)
+        select { |api| api.has_api_method?(method) }
+      end
+
+      private
+
+      attr_reader :apis
+    end
+  end
+end

data/lib/k8y/client/client.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require_relative "rest_client"
+require_relative "api_builder"
+require_relative "apis"
+
+module K8y
+  module Client
+    class Client
+      ContextNotFoundError = Class.new(Error)
+      APINameConflictError = Class.new(Error)
+
+      attr_reader :config, :context, :apis
+
+      def initialize(config:, context:, group_versions: DEFAULT_GROUP_VERSIONS)
+        @config = config
+        @context = config.context(context)
+        @apis = APIs.new(group_versions: group_versions)
+      end
+
+      def discover!
+        apis.each { |api| APIBuilder.new(api: api, config: config, context: context.name).build! }
+      end
+
+      def set_context(context_name)
+        @context = config.context(context_name)
+      end
+
+      def method_missing(method_name, *args, &block)
+        candidate_apis = apis.apis_for_method(method_name)
+        case candidate_apis.length
+        when 0
+          super
+        when 1
+          candidate_apis.first.public_send(method_name, *args, &block)
+        else
+          raise APINameConflictError, "#{method_name} is defined in multiple group versions: " \
+            "#{candidate_apis.map(&:group_version).join(", ")}. You can access a specific GroupVersion " \
+            "by declaring it explicitly. E.g. client.apis.core_v1.get_pods"
+        end
+      end
+
+      def respond_to_missing?(method_name, include_private = false)
+        apis.apis_for_method(method_name).present? || super
+      end
+    end
+  end
+end

data/lib/k8y/client/resource_description.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module K8y
+  module Client
+    class ResourceDescription
+      attr_reader :name, :kind, :namespaced, :verbs
+      alias_method(:plural_name, :name)
+
+      def self.from_hash(hash)
+        new(
+          name: hash.fetch("name"),
+          kind: hash.fetch("kind"),
+          singular_name: hash.fetch("singularName"),
+          namespaced: hash.fetch("namespaced"),
+          verbs: hash.fetch("verbs").map(&:to_sym),
+        )
+      end
+
+      def initialize(name:, kind:, singular_name:, namespaced:, verbs:)
+        @name = name
+        @kind = kind
+        @singular_name = singular_name
+        @namespaced = namespaced
+        @verbs = verbs
+      end
+
+      def singular_name
+        if @singular_name.empty?
+          kind.downcase
+        else
+          @singular_name
+        end
+      end
+
+      def subresource?
+        name.include?("/") # E.g. namespaces/status, deployments/scale, etc.
+      end
+
+      def has_verb?(verb)
+        verbs.include?(verb)
+      end
+
+      def path_for_resources(namespace: nil)
+        if namespace
+          "namespaces/#{namespace}/#{plural_name}"
+        else
+          plural_name
+        end
+      end
+
+      def path_for_resource(namespace: nil, name:)
+        "#{path_for_resources(namespace: namespace)}/#{name}"
+      end
+    end
+  end
+end

data/lib/k8y/client/response_formatter.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+module K8y
+  module Client
+    class ResponseFormatter
+      UnsupportedResponseTypeError = Class.new(Error)
+
+      attr_reader :response
+
+      def initialize(response)
+        @response = response
+      end
+
+      def format(as: :ros)
+        case as
+        when :ros
+          build_recursive_open_struct_response(response.body)
+        when :raw
+          response
+        else
+          raise UnsupportedResponseTypeError, as.to_s
+        end
+      end
+
+      private
+
+      def build_recursive_open_struct_response(body)
+        data = JSON.parse(body)
+        if item_list?(data)
+          data.fetch("items").map { |item| RecursiveOpenStruct.new(item, recurse_over_arrays: true) }
+        elsif resources_list?(data)
+          data.fetch("resources").map { |item| RecursiveOpenStruct.new(item, recurse_over_arrays: true) }
+        else
+          RecursiveOpenStruct.new(data, recurse_over_arrays: true)
+        end
+      end
+
+      def item_list?(data)
+        data["kind"] =~ /List$/ && data["items"]
+      end
+
+      def resources_list?(data)
+        data["kind"] =~ /List$/ && data["resources"]
+      end
+    end
+  end
+end

data/lib/k8y/client/rest_client.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+require "faraday"
+require "base64"
+require "recursive_open_struct"
+
+require_relative "response_formatter"
+
+module K8y
+  module Client
+    class RESTClient
+      attr_reader :context, :path
+
+      def initialize(config:, context:, path: "")
+        @config = config
+        @context = context
+        @path = path
+
+        # TODO: generically handle auth depending on provided config
+        hardcoded_auth
+      end
+
+      def get(sub_path = "", headers: {}, as: :ros)
+        response = connection.get(formatted_uri(host, path, sub_path))
+        format_response(response, as: as)
+      end
+
+      def post(sub_path = "", data:, headers: {}, as: :ros)
+        response = connection.post(formatted_uri(host, path, sub_path), data, headers)
+        format_response(response, as: as)
+      end
+
+      def put(sub_path = "", data:, headers: {}, as: :ros)
+        response = connection.put(formatted_uri(host, path, sub_path), data, headers)
+        format_response(response, as: as)
+      end
+
+      def patch(sub_path = "", strategy:, data:, headers: {}, as: :ros)
+        response = connection.patch(formatted_uri(host, path, sub_path), data, headers)
+        format_response(response, as: as)
+      end
+
+      def delete(sub_path = "", headers: {}, as: :ros)
+        response = connection.delete(formatted_uri(host, path, sub_path))
+        format_response(response, as: as)
+      end
+
+      private
+
+      attr_reader :config, :connection
+
+      def hardcoded_auth
+        cert_store = OpenSSL::X509::Store.new
+        cert_store.add_cert(OpenSSL::X509::Certificate.new(Base64.decode64(cluster.certificate_authority_data)))
+        @connection = Faraday.new(
+          host,
+          ssl: {
+            client_cert: OpenSSL::X509::Certificate.new(Base64.decode64(user.auth_info.client_certificate_data)),
+            client_key: OpenSSL::PKey::RSA.new(Base64.decode64(user.auth_info.client_key_data)),
+            cert_store: cert_store,
+          }
+        )
+      end
+
+      def host
+        cluster.server
+      end
+
+      def cluster
+        config.cluster_for_context(context)
+      end
+
+      def user
+        config.user_for_context(context)
+      end
+
+      def formatted_uri(host, path, sub_path = "")
+        if !sub_path.empty? && !path.end_with?("/")
+          URI.join(host, "#{path}/", sub_path)
+        else
+          URI.join(host, path, sub_path)
+        end
+      end
+
+      def format_response(response, as: :ros)
+        ResponseFormatter.new(response).format(as: as)
+      end
+    end
+  end
+end

data/lib/k8y/client.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+require_relative "client/client"
+
+module K8y
+  module Client
+    Error = Class.new(Error)
+
+    DEFAULT_GROUP_VERSIONS = [
+      GroupVersion.new(group: "core", version: "v1"),
+      GroupVersion.new(group: "apps", version: "v1"),
+    ]
+
+    def self.from_config(config, context: nil, group_versions: DEFAULT_GROUP_VERSIONS)
+      Client.new(config: config, context: context || config.current_context, group_versions: group_versions)
+    end
+  end
+end

data/lib/k8y/error.rb

@@ -0,0 +1,2 @@
+# frozen_string_literal: true
+class Error < StandardError; end

data/lib/k8y/group_version.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+module K8y
+  class GroupVersion
+    attr_reader :group, :version
+
+    def initialize(group:, version:)
+      @group = group
+      @version = version
+    end
+
+    def to_s
+      "#{group}/#{version}"
+    end
+
+    def to_method_name
+      "#{group}_#{version}"
+    end
+  end
+end

data/lib/k8y/kubeconfig/auth_info.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+module K8y
+  module Kubeconfig
+    class AuthInfo
+      attr_reader :client_certificate, :client_certificate_data, :client_key, :client_key_data, :token, :token_file,
+        :as, :as_groups, :as_user_extra, :username, :password, :auth_provider, :exec_options, :extensions,
+
+        def self.from_hash(hash)
+          new(
+            client_certificate: hash.fetch("client-certificate", nil),
+            client_certificate_data: hash.fetch("client-certificate-data", nil),
+            client_key: hash.fetch("client-key", nil),
+            client_key_data: hash.fetch("client-key-data", nil),
+            token: hash.fetch("token", nil),
+            token_file: hash.fetch("tokenFile", nil),
+            as: hash.fetch("as", nil),
+            as_groups: hash.fetch("as-groups", nil),
+            as_user_extra: hash.fetch("as-user-extra", nil),
+            username: hash.fetch("username", nil),
+            password: hash.fetch("password", nil),
+            # TODO: this needs something like polymorphic classes, not just raw hash, eventually
+            auth_provider: hash.fetch("auth-provider", nil),
+            # TODO: This will likely benefit from actual domain models eventually, as well.
+            exec_options: hash.fetch("exec", nil),
+            extensions: hash.fetch("extensions", nil)
+          )
+        end
+
+      def initialize(client_certificate: nil, client_certificate_data: nil, client_key: nil, client_key_data: nil,
+        token: nil, token_file: nil, as: nil, as_groups: nil, as_user_extra: nil, username: nil, password: nil,
+        auth_provider: nil, exec_options: nil, extensions: nil)
+        @client_certificate = client_certificate
+        @client_certificate_data = client_certificate_data
+        @client_key = client_key
+        @client_key_data = client_key_data
+        @token = token
+        @token_file = token_file
+        @as = as
+        @as_groups = as_groups
+        @as_user_extra = as_user_extra
+        @username = username
+        @password = password
+        @auth_provider = auth_provider
+        @exec_options = exec_options
+        @extensions = extensions
+      end
+    end
+  end
+end

data/lib/k8y/kubeconfig/cluster.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module K8y
+  module Kubeconfig
+    class Cluster
+      attr_reader :name, :insecure_skip_tls_verify, :certificate_authority, :certificate_authority_data, :server
+
+      def self.from_hash(hash)
+        cluster = hash.fetch("cluster")
+        new(
+          insecure_skip_tls_verify: cluster.fetch("insecure-skip-tls-verify", false),
+          certificate_authority: cluster.fetch("certificate-authority", nil),
+          certificate_authority_data: cluster.fetch("certificate-authority-data", nil),
+          server: cluster.fetch("server"),
+          name: hash.fetch("name")
+        )
+      rescue Psych::Exception, KeyError => e
+        raise Error, e
+      end
+
+      def initialize(name:, insecure_skip_tls_verify:, certificate_authority:, certificate_authority_data:, server:)
+        @name = name
+        @insecure_skip_tls_verify = insecure_skip_tls_verify
+        @certificate_authority = certificate_authority
+        @certificate_authority_data = certificate_authority_data
+        @server = URI.parse(server)
+      end
+    end
+  end
+end

data/lib/k8y/kubeconfig/config.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+require "yaml"
+require_relative "cluster"
+require_relative "context"
+require_relative "user"
+
+module K8y
+  module Kubeconfig
+    class Config
+      ContextNotFoundError = Class.new(Error)
+      ClusterNotFoundError = Class.new(Error)
+      UserNotFoundError = Class.new(Error)
+
+      attr_reader :api_version, :kind, :preferences, :clusters, :contexts, :users, :current_context
+
+      def self.from_hash(hash)
+        new(
+          api_version: hash.fetch("apiVersion"),
+          kind: hash.fetch("kind"),
+          preferences: hash.fetch("preferences"),
+          clusters: hash.fetch("clusters").map { |cluster| Cluster.from_hash(cluster) },
+          contexts: hash.fetch("contexts").map { |context| Context.from_hash(context) },
+          current_context: hash.fetch("current-context"),
+          users: hash.fetch("users").map { |user| User.from_hash(user) },
+        )
+      rescue Psych::Exception, KeyError => e
+        raise Error, e
+      end
+
+      def initialize(api_version:, kind:, preferences:, clusters:, contexts:, users:, current_context:)
+        @api_version = api_version
+        @kind = kind
+        @preferences = preferences
+        @clusters = clusters
+        @contexts = contexts
+        @users = users
+        @current_context = current_context
+      end
+
+      def context(name)
+        context = contexts.find { |c| c.name == name }
+        raise ContextNotFoundError, "Could not find context #{name} in config" unless context
+        context
+      end
+
+      def cluster(name)
+        cluster = clusters.find { |c| c.name == name }
+        raise ClusterNotFoundError, "Could not find cluster #{name} in config" unless cluster
+        cluster
+      end
+
+      def user(name)
+        user = users.find { |user| user.name == name }
+        raise UserNotFoundError, "User #{name} not found in config" unless user
+        user
+      end
+
+      def cluster_for_context(context_name)
+        cluster_name = context(context_name).cluster
+        cluster(cluster_name)
+      end
+
+      def user_for_context(context_name)
+        user(context(context_name).user)
+      end
+    end
+  end
+end

data/lib/k8y/kubeconfig/context.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module K8y
+  module Kubeconfig
+    class Context
+      attr_reader :name, :cluster, :namespace, :user
+
+      def self.from_hash(hash)
+        context = hash.fetch("context")
+        new(
+          name: hash.fetch("name"),
+          cluster: context.fetch("cluster"),
+          namespace: context.fetch("namespace", nil),
+          user: context.fetch("user")
+        )
+      rescue Psych::Exception, KeyError => e
+        raise Error, e
+      end
+
+      def initialize(name:, cluster:, namespace:, user:)
+        @name = name
+        @cluster = cluster
+        @namespace = namespace
+        @user = user
+      end
+    end
+  end
+end

data/lib/k8y/kubeconfig/user.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+require_relative "auth_info"
+
+module K8y
+  module Kubeconfig
+    class User
+      attr_reader :name, :auth_info
+
+      def self.from_hash(hash)
+        user = hash.fetch("user")
+        new(
+          name: hash.fetch("name"),
+          auth_info: AuthInfo.from_hash(user)
+        )
+      end
+
+      def initialize(name:, auth_info:)
+        @name = name
+        @auth_info = auth_info
+      end
+    end
+  end
+end

data/lib/k8y/kubeconfig.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require_relative "kubeconfig/config"
+
+module K8y
+  module Kubeconfig
+    Error = Class.new(Error)
+
+    KUBECONFIG = ENV["KUBECONFIG"]
+
+    def self.from_file(file = File.open(KUBECONFIG))
+      hash = YAML.safe_load(file.read, permitted_classes: [Date, Time])
+      Config.from_hash(hash)
+    end
+  end
+end

data/lib/k8y/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module K8y
+  VERSION = "0.1.0"
+end

data/lib/k8y.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require "active_support/core_ext/object/blank"
+
+require_relative "k8y/error"
+require_relative "k8y/version"
+require_relative "k8y/kubeconfig"
+require_relative "k8y/group_version"
+require_relative "k8y/client"

metadata

@@ -0,0 +1,242 @@
+--- !ruby/object:Gem::Specification
+name: k8y
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Timothy Smith
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2021-09-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  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'
+- !ruby/object:Gem::Dependency
+  name: recursive-open-struct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '11'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5'
+- !ruby/object:Gem::Dependency
+  name: minitest-reporters
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: rubocop-shopify
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Ruby client for interacting with kubernetes clusters
+email:
+- tsontario@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/main.yml"
+- ".gitignore"
+- ".rubocop.yml"
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- k8y.gemspec
+- lib/k8y.rb
+- lib/k8y/client.rb
+- lib/k8y/client/api.rb
+- lib/k8y/client/api_builder.rb
+- lib/k8y/client/apis.rb
+- lib/k8y/client/client.rb
+- lib/k8y/client/resource_description.rb
+- lib/k8y/client/response_formatter.rb
+- lib/k8y/client/rest_client.rb
+- lib/k8y/error.rb
+- lib/k8y/group_version.rb
+- lib/k8y/kubeconfig.rb
+- lib/k8y/kubeconfig/auth_info.rb
+- lib/k8y/kubeconfig/cluster.rb
+- lib/k8y/kubeconfig/config.rb
+- lib/k8y/kubeconfig/context.rb
+- lib/k8y/kubeconfig/user.rb
+- lib/k8y/version.rb
+homepage: https://github.com/tsontario/k8y
+licenses: []
+metadata:
+  homepage_uri: https://github.com/tsontario/k8y
+  source_code_uri: https://github.com/tsontario/k8y
+  changelog_uri: https://github.com/tsontario/k8y
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.4
+signing_key:
+specification_version: 4
+summary: Ruby client for interacting with kubernetes clusters
+test_files: []