gojira_apiops 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b6ec417813d73cf612a22ad5686c54994bb64174adeb82250766b47e9e2d9f93
+  data.tar.gz: 79a616a00c33bfce5cf97adeabeafeb093094976cb1d80ccdb54bd17ea2c98cc
+SHA512:
+  metadata.gz: 06e7ad585f278c500bfe88898bb69513c53d74437234e52ce3a4ca4b200c954b2f2da840bdabb486b0684909490e8d00afeda40e06e80fb27627cb69f956910b
+  data.tar.gz: 68eafc086dfe33681ee0b3d759c32615e64471dabe52beae44ffa57eef4541405ea2e0f092da0a1bdeeb3b3873c37f391e38a44bb4a9f8cc419be2f3f01cc030

data/.github/workflows/main.yml

@@ -0,0 +1,59 @@
+name: Gojira Pipeline
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs: 
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+    - uses: ruby/setup-ruby
+      with:
+        ruby-version: '3.3.1'
+    - run: bundle install
+    - run: bundle exec rspec
+
+  build:
+    name: Build + Publish
+    runs-on: ubuntu-latest
+    permissions:
+      packages: write
+      contents: read
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Ruby 3.3.1
+        uses: ruby/setup-ruby
+        with:
+          ruby-version: '3.3.1'
+      - run: bundle install
+
+      - name: Publish to GPR
+        run: |
+          mkdir -p $HOME/.gem
+          touch $HOME/.gem/credentials
+          chmod 0600 $HOME/.gem/credentials
+          printf -- "---\n:github: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
+          gem build *.gemspec
+          gem push --KEY github --host https://rubygems.pkg.github.com/${OWNER} *.gem
+        env:
+          GEM_HOST_API_KEY: "Bearer ${{secrets.GITHUB_TOKEN}}"
+          OWNER: ${{ github.repository_owner }}
+
+      - name: Publish to RubyGems
+        run: |
+          mkdir -p $HOME/.gem
+          touch $HOME/.gem/credentials
+          chmod 0600 $HOME/.gem/credentials
+          printf -- "---\n:rubygems_api_key: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
+          gem build *.gemspec
+          gem push *.gem
+        env:
+          GEM_HOST_API_KEY: "${{secrets.RUBYGEMS_AUTH_TOKEN}}"   

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+vendor/
+local/
+
+# rspec failure tracking
+.rspec_status
+test-files/

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.ruby-version

@@ -0,0 +1 @@
+3.3.1

data/Dockerfile

@@ -0,0 +1,13 @@
+FROM ruby:3.3.1
+
+RUN curl -sL https://github.com/Kong/deck/releases/download/v1.39.4/deck_1.39.4_linux_arm64.tar.gz -o deck.tar.gz
+RUN tar -xf deck.tar.gz -C /tmp
+RUN cp /tmp/deck /usr/local/bin/
+
+COPY . /app
+
+WORKDIR /app
+
+RUN bundle install
+RUN gem build gojira.gemspec
+RUN gem install *.gem

data/Gemfile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in gojira.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,75 @@
+PATH
+  remote: .
+  specs:
+    gojira (0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.2)
+    coderay (1.1.3)
+    diff-lcs (1.5.1)
+    json (2.7.2)
+    language_server-protocol (3.17.0.3)
+    method_source (1.1.0)
+    parallel (1.25.1)
+    parser (3.3.3.0)
+      ast (~> 2.4.1)
+      racc
+    pry (0.14.2)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    racc (1.8.0)
+    rainbow (3.1.1)
+    rake (10.5.0)
+    regexp_parser (2.9.2)
+    rexml (3.3.0)
+      strscan
+    rspec (3.13.0)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.0)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.1)
+    rubocop (1.64.1)
+      json (~> 2.3)
+      language_server-protocol (>= 3.17.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.31.3)
+      parser (>= 3.3.1.0)
+    ruby-progressbar (1.13.0)
+    strscan (3.1.0)
+    thor (1.3.1)
+    unicode-display_width (2.5.0)
+    yaml (0.3.0)
+
+PLATFORMS
+  arm64-darwin-23
+  ruby
+
+DEPENDENCIES
+  bundler (~> 2.5)
+  gojira!
+  pry
+  rake (~> 10.0)
+  rspec (~> 3.0)
+  rubocop (~> 1.64)
+  thor (~> 1.3.1)
+  yaml
+
+BUNDLED WITH
+   2.5.9

data/README.md

@@ -0,0 +1,116 @@
+# Gojira
+
+**Maintaining order within the Kong realm** [[ref](https://en.wikipedia.org/wiki/Gojira)]
+
+<img src="docs/gojira.png" alt="drawing" width="500"/>
+
+## Documentation
+
+This post on my blog was the starting point of it all: [Gojira: Building Multi-Region APIOps with Kong](https://www.kumarabhijeet.me/building-multi-region-kong-apiops)
+
+More detailed docs about the conventions of the framework are yet to follow.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'gojira'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install gojira
+
+## Usage
+
+### Top-Level Commands
+```
+commands:
+  gojira cluster         # Commands interacting with Kong cluster
+  gojira env             # Commands interacting with Gateway env directory
+  gojira help [COMMAND]  # Describe available commands or one specific command
+  gojira version         # Print Gojira gem version
+
+Options:
+  [--kong-addr=KONG_ADDR]                        # Kong Host & Port
+  [--config=CONFIG]                              # decK config file
+  [--ca-cert-file=CA_CERT_FILE]                  # CA Cert File
+  [--tls-client-key-file=TLS_CLIENT_KEY_FILE]    # TLS Client Key file
+  [--tls-client-cert-file=TLS_CLIENT_CERT_FILE]  # TLS Client Cert file
+  [--tls-server-name=TLS_SERVER_NAME]            # TLS Server Name
+```
+
+### Cluster commands
+
+These commands are used to interact with the Kong Control Plane
+
+```
+Commands:
+  gojira cluster diff            # diff output for kong config in a cluster
+  gojira cluster dump            # takes dump of resources from a kong cluster
+  gojira cluster help [COMMAND]  # Describe subcommands or one specific subcommand
+  gojira cluster sync            # syncs kong config to a cluster
+  gojira cluster validate        # validates kong config for a cluster
+
+```
+
+```
+Usage:
+  gojira cluster sync
+
+Options:
+  -s, [--kong-state-file=KONG_STATE_FILE]  # Kong State File
+  -n, [--env-name=ENV_NAME]                # Environment identifier name
+  -c, [--compliance-type=COMPLIANCE_TYPE]  # Compliance Type
+                                           # Possible values: pci, non-pci
+  -f, [--cluster-file=CLUSTER_FILE]        # Cluster file path
+  -d, [--dc-name=DC_NAME]                  # DC Name
+
+syncs kong config to a cluster
+```
+
+### Env Commands
+
+These commands are used to lint and generate configurations based on environments and tags defined a/c Gojira's opinionated conventions
+
+```
+Commands:
+  gojira env generate        # generates kong state for the env repo
+  gojira env help [COMMAND]  # Describe subcommands or one specific subcommand
+  gojira env lint            # lints env repo and validates against conventions
+```
+
+```
+Usage:
+  gojira env generate
+
+Options:
+  -f, [--gateway-folder=GATEWAY_FOLDER]    # Gateway configs folder path
+  -n, [--env-name=ENV_NAME]                # Environment identifier name
+  -f, [--cluster-file=CLUSTER_FILE]        # Path to Cluster definition file
+  -c, [--compliance-type=COMPLIANCE_TYPE]  # Compliance Type(pci/non-pci)
+  -d, [--dc-name=DC_NAME]                  # DC Name
+
+generates kong state for the env repo
+```
+
+### TODO:
+
+* Lint: 
+  * Searches through env directory 
+  * get list of all products/services
+  * checks if their upstream info is available across all clusters of that env 
+  * service level validations(PCI/NPCI service tags, no route with tags)
+  * Gives out errors of each validation level in JSON
+
+* Generate: 
+  * Merge product services files into one config
+  * Substitute kong upstreams for respective compliance type and DC
+  * Merge all product configs into one file
+  * Not to interfere and merge global conf and certs, they will be passed with -s
+  * Can include local config here later

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'gojira'
+
+# 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
+
+

data/exe/gojira

@@ -0,0 +1,20 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+lib_path = File.expand_path('../lib', __dir__)
+$LOAD_PATH.unshift(lib_path) unless $LOAD_PATH.include?(lib_path)
+
+begin
+  require 'pry-byebug' if ENV['GOJIRA_ENV'] == 'debug'
+rescue LoadError
+  # do nothing
+end
+
+require 'gojira'
+
+Signal.trap('INT') do
+  warn("\n#{caller.join("\n")}: interrupted")
+  exit(1)
+end
+
+Gojira::CLI.start(ARGV)

data/gojira.gemspec

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'gojira/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'gojira_apiops'
+  spec.version       = Gojira::VERSION
+  spec.authors       = ['Kumar Abhijeet']
+  spec.email         = ['kumarabhijeet1202@gmail.com']
+
+  spec.summary       = 'A ruby gem to generate Kong configs across multiple clusters to achieve service equivalence'
+  spec.description   = 'A ruby gem to generate Kong configs across multiple clusters to achieve service equivalence'
+  spec.homepage      = 'https://github.com/kumar1202/gojira/tree/main'
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    spec.metadata['allowed_push_host'] = "https://rubygems.org"
+
+    spec.metadata['homepage_uri'] = spec.homepage
+    spec.metadata['source_code_uri'] = 'https://github.com/kumar1202/gojira/tree/main'
+    spec.metadata['changelog_uri'] = 'https://github.com/kumar1202/gojira/tree/main'
+  else
+    raise 'RubyGems 2.0 or newer is required to protect against ' \
+      'public gem pushes.'
+  end
+
+  # 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
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 2.5'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'rubocop', '~> 1.64'
+  spec.add_development_dependency 'thor', '~> 1.3.1'
+  spec.add_development_dependency 'yaml'
+
+  spec.add_development_dependency 'pry'
+end

data/lib/gojira/apiops/merge.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Gojira
+  module APIOps
+    class Merge
+      attr_accessor :errors
+      attr_reader :gateway_folder, :env_dir, :cluster_file
+
+      def initialize
+        @gateway_folder = gateway_folder
+        @env_dir = env_dir
+        @cluster_file = cluster_file
+        @errors = []
+      end
+
+      def execute
+      end
+    end
+  end
+end

data/lib/gojira/apiops/validations.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Gojira
+  module APIOps
+    class Validations
+      attr_accessor :errors
+      attr_reader :gateway_folder, :env_dir, :cluster_file
+
+      def initialize(gateway_folder, env_dir, cluster_file)
+        @gateway_folder = gateway_folder
+        @env_dir = env_dir
+        @cluster_file = cluster_file
+        @errors = []
+      end
+
+      def execute
+        validate_env
+        validate_cluster_file
+        validate_env_dir
+        validate_service
+        validate_upstreams
+      end
+
+      def validate_env
+        Dir.open(@gateway_folder + @env_dir)
+        # Check env name if is allowed
+      end
+
+      def validate_cluster_file
+        # Check if all env have defined DCs and each DC have pci and npci control planes
+      end
+
+      def validate_env_dir
+        # check the structure of the env dir:
+          # product_group -> one or more services
+          # product_group has a valid upstreams file
+        # figure out if any unknown files are present
+      end
+
+      def validate_service(service_file)
+        # Check if only one service is defined per file
+        # Check if the correct pci/non-pci tag is present on the service
+        # Check if routes don't have tags
+        # Check if 
+      end
+
+      def validate_upstreams(upstreams_file)
+        # Check if upstreams for all services in the product_group is present or not
+        # Check if both pci and non-pci upstreams for a service are defined
+        # Check if all targets of a given upstream add up to 100
+      end
+    end
+  end
+end

data/lib/gojira/cli.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require 'thor'
+require 'gojira/command/base'
+require 'gojira/command/cluster'
+require 'gojira/command/env'
+
+module Gojira
+  class CLI < Thor
+    check_unknown_options!
+
+    def self.exit_on_failure?
+      true
+    end
+
+    desc 'version', 'Print Gojira gem version'
+    def version
+      puts Gojira::VERSION
+    end
+
+    desc 'cluster', 'Commands interacting with Kong cluster'
+    class_option :kong_addr, type: :string, desc: 'Kong Host & Port'
+    class_option :config, type: :string, desc: 'decK config file'
+    class_option :ca_cert_file, type: :string, desc: 'CA Cert File'
+    class_option :tls_client_key_file, type: :string, desc: 'TLS Client Key file'
+    class_option :tls_client_cert_file, type: :string, desc: 'TLS Client Cert file'
+    class_option :tls_server_name, type: :string, desc: 'TLS Server Name'
+    subcommand 'cluster', Gojira::Command::Cluster
+
+    desc 'env', 'Commands interacting with Gateway env directory'
+    subcommand 'env', Gojira::Command::Env
+  end
+end

data/lib/gojira/command/base.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Gojira
+  module Command
+    class Base < Thor
+      def self.banner(command, _namespace = nil, _subcommand = false)
+        "#{basename} #{subcommand_prefix} #{command.usage}"
+      end
+
+      def self.subcommand_prefix
+        name.split('::').last.gsub(/([A-Z]+)([A-Z][a-z])/, '\1-\2').gsub(/([a-z\d])([A-Z])/, '\1-\2').downcase
+      end
+    end
+  end
+end

data/lib/gojira/command/cluster.rb

@@ -0,0 +1,91 @@
+require 'gojira/command/base'
+require 'gojira/errors'
+require 'yaml'
+
+module Gojira
+  module Command
+    class Cluster < Gojira::Command::Base
+      REQUIRED_CLASS_OPTIONS = %i[tls_enabled]
+
+      desc "validate", "validates kong config for a cluster"
+      method_option :kong_state_file, aliases: '-s', type: :string, desc: 'Kong State File', required: false
+      method_option :env_name, aliases: '-n', type: :string, desc: 'Environment identifier name', required: false
+      method_option :compliance_type, aliases: '-c', type: :string, desc: 'Compliance Type', enum: ['pci', 'non-pci'], required: false
+      method_option :cluster_file, aliases: '-f', type: :string, desc: 'Cluster file path', required: false
+      method_option :dc_name, aliases: '-d', type: :string, desc: 'DC Name', required: false
+      def validate
+        validate_options
+        deck = Gojira::Deck::Gateway.new('deck', get_control_plane)
+        deck.validate(options[:kong_state_file])
+        raise Thor::Error, deck.error if deck.error.any?
+
+        print("Kong state file validated successfully")
+      end
+  
+      desc "diff", "diff output for kong config in a cluster"
+      method_option :kong_state_file, aliases: '-s', type: :string, desc: 'Kong State File', required: false
+      method_option :env_name, aliases: '-n', type: :string, desc: 'Environment identifier name', required: false
+      method_option :compliance_type, aliases: '-c', type: :string, desc: 'Compliance Type', enum: ['pci', 'non-pci'], required: false
+      method_option :cluster_file, aliases: '-f', type: :string, desc: 'Cluster file path', required: false
+      method_option :dc_name, aliases: '-d', type: :string, desc: 'DC Name', required: false
+      def diff
+        validate_options
+        deck = Gojira::Deck::Gateway.new('deck', get_control_plane)
+        deck.diff(options[:kong_state_file])
+        raise Thor::Error, deck.error if deck.error.any?
+
+        print(deck.output.first)
+      end
+
+      desc "sync", "syncs kong config to a cluster"
+      method_option :kong_state_file, aliases: '-s', type: :string, desc: 'Kong State File', required: false
+      method_option :env_name, aliases: '-n', type: :string, desc: 'Environment identifier name', required: false
+      method_option :compliance_type, aliases: '-c', type: :string, desc: 'Compliance Type', enum: ['pci', 'non-pci'], required: false
+      method_option :cluster_file, aliases: '-f', type: :string, desc: 'Cluster file path', required: false
+      method_option :dc_name, aliases: '-d', type: :string, desc: 'DC Name', required: false
+      def sync
+        require 'pry'; binding.pry
+        validate_options
+        deck = Gojira::Deck::Gateway.new('deck', get_control_plane)
+        deck.sync(options[:kong_state_file])
+        raise Thor::Error, deck.error if deck.error.any?
+
+        print(deck.output.first)
+      end
+
+      desc "dump", "takes dump of resources from a kong cluster"
+      method_option :env_name, aliases: '-n', type: :string, desc: 'Environment identifier name'
+      method_option :compliance_type, aliases: '-c', type: :string, desc: 'Compliance Type'
+      method_option :cluster_file, aliases: '-f', type: :string, desc: 'Cluster file path'
+      method_option :dc_name, aliases: '-d', type: :string, desc: 'DC Name'
+      def dump
+        validate_options
+        deck = Gojira::Deck::Gateway.new('deck', get_control_plane)
+        deck.dump(options[:kong_state_file])
+        raise Thor::Error, deck.error if deck.error.any?
+
+        print(deck.output.first)
+      end
+
+      no_commands do
+        def validate_options
+          raise Thor::Error, Gojira::Errors.required_options(REQUIRED_CLASS_OPTIONS) unless REQUIRED_CLASS_OPTIONS.all? {|option| @parent_options.key? option}
+          raise Thor::Error, Gojira::Errors.dc_type_invalid(dc_list) unless dc_list.include?(options['dc_name'])
+        end
+
+        def get_control_plane
+          clusters = YAML.load_file(options[:cluster_file])[options['env_name']]['control_plane']
+
+          required_cluster = clusters.select { |cluster| cluster['compliance_type'] == options['compliance_type'] and cluster['dc'] == options['dc_name']  }
+          required_cluster.first['address']
+        end
+
+        def dc_list
+          YAML.load_file(options[:cluster_file])[options['env_name']]['dc']
+        end
+
+        #TODO: Check if env_name is invalid
+      end
+    end
+  end
+end

data/lib/gojira/command/env.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require 'gojira/command/base'
+require 'gojira/apiops/validations'
+require 'gojira/apiops/merge'
+require 'gojira/errors'
+
+module Gojira
+  module Command
+    class Env < Gojira::Command::Base
+      desc 'lint', 'lints env repo and validates against conventions'
+      method_option :gateway_folder, aliases: '-f', type: :string, desc: 'Gateway configs folder path'
+      method_option :env_name, aliases: '-n', type: :string, desc: 'Environment identifier name'
+      method_option :cluster_file, aliases: '-c', type: :string, desc: 'Path to cluster definition file'
+      def lint
+        validation_engine = APIOps::Validations.new(options[:gateway_folder], options[:env_name], options[:cluster_file])
+        validation_engine.execute
+
+        raise Thor::Error, Gojira::Errors.lint_failed(validation_engine.errors) if validation_engine.errors.any?
+        print("Env successfully validated")
+      end
+
+      desc 'generate', 'generates kong state for the env repo'
+      method_option :gateway_folder, aliases: '-f', type: :string, desc: 'Gateway configs folder path'
+      method_option :env_name, aliases: '-n', type: :string, desc: 'Environment identifier name'
+      method_option :cluster_file, aliases: '-f', type: :string, desc: 'Path to Cluster definition file'
+      method_option :compliance_type, aliases: '-c', type: :string, desc: 'Compliance Type(pci/non-pci)'
+      method_option :dc_name, aliases: '-d', type: :string, desc: 'DC Name'
+      def generate
+        merge_engine = APIOps::Merge.new()
+        merge_engine.execute
+
+        raise Thor::Error, Gojira::Errors.merge_failed(merge_engine.errors) if merge_engine.errors.any?
+        print("Merge config validated at")
+      end
+    end
+  end
+end

data/lib/gojira/deck/base.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require 'open3'
+
+module Gojira
+  module Deck
+    class Base
+      attr_reader :binary_path, :params
+      attr_accessor :output, :error
+
+      def initialize(binary_path, kong_addr = nil, config_file = nil, timeout = 10, tls_params = {})
+        @binary_path = binary_path
+        @params = {
+          kong_addr: kong_addr,
+          config_file: config_file,
+          timeout: timeout,
+          tls_params: tls_params
+        }
+        @output = []
+        @error = []
+      end
+
+      def execute(command)
+        stdout_str, stderr_str, status = Open3.capture3("#{@binary_path} #{command} #{param_string}")
+        @output << stdout_str.chomp and return if status.success?
+
+        @error << "Error executing command: #{stderr_str}"
+      end
+
+      protected
+
+      def param_string
+        "#{generate_param_string(params.except(:tls_params))} #{generate_param_string(params[:tls_params])}"
+      end
+
+      def generate_param_string(params)
+        params.map { |key, value| "--#{key.to_s.gsub('_', '-')} #{value}" unless value.nil? }.join(' ').strip
+      end
+    end
+  end
+end

data/lib/gojira/deck/file.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Gojira
+  module Deck
+    class File < Gojira::Deck::Base
+      def initialize(binary_path, kong_addr = nil, config_file = nil, timeout = nil, tls_params = {})
+        super
+      end
+
+      def lint(state_file, ruleset_file)
+        command = "file lint -s #{state_file} #{ruleset_file}"
+        execute(command)
+      end
+
+      def render(state_file_list, output_file)
+        command = "file render #{state_file_list.join(' ')} -o #{output_file}"
+        execute(command)
+      end
+
+      def merge(state_file_list, output_file)
+        command = "file merge -o #{output_file} #{state_file_list.join(' ')}"
+        execute(command)
+      end
+
+      def validate(state_file)
+        command = "file validate -o #{state_file}"
+        execute(command)
+      end
+    end
+  end
+end

data/lib/gojira/deck/gateway.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Gojira
+  module Deck
+    class Gateway < Gojira::Deck::Base
+      def initialize(binary_path = 'deck', kong_addr = nil, config_file = nil, timeout = nil, tls_params = {})
+        super
+      end
+
+      def sync(state_file)
+        command = "gateway sync #{state_file}"
+        execute(command)
+      end
+
+      def diff(state_file)
+        command = "gateway diff #{state_file}"
+        execute(command)
+      end
+
+      def dump
+        command = 'gateway dump'
+        execute(command)
+      end
+
+      def validate(state_file)
+        command = "gateway validate #{state_file}"
+        execute(command)
+      end
+    end
+  end
+end

data/lib/gojira/errors.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require 'thor'
+
+module Gojira
+  class Errors
+    class << self
+      def required_options(required_options_list)
+        "Pass all the required options as arguments #{required_options_list}"
+      end
+
+      def lint_failed(lint_output)
+        "Lint process failed, the env directory is not correctly formatted.\nCorrect these errors:\n#{lint_output}"
+      end
+
+      def merge_failed(merge_output)
+        "Merge process failed, the env directory is not correctly formatted. Run lint stage again!\nErrors:\n#{merge_output}"
+      end
+
+      def dc_type_invalid(dc_list)
+        "The passed dc_name is not a valid DC name in this environment. Please pass a DC name from this list: #{dc_list}"
+      end
+    end
+  end
+end

data/lib/gojira/version.rb

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

data/lib/gojira.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'thor'
+require_relative 'gojira/version'
+require_relative 'gojira/deck/base'
+require_relative 'gojira/deck/gateway'
+require_relative 'gojira/deck/file'
+require_relative 'gojira/cli'
+
+module Gojira
+  class << self
+    attr_writer :config
+
+    def config
+      @config ||= Config.new
+    end
+
+    def configure
+      yield(config)
+    end
+
+    def reset!
+      @config = nil
+    end
+  end
+end

metadata

@@ -0,0 +1,174 @@
+--- !ruby/object:Gem::Specification
+name: gojira_apiops
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Kumar Abhijeet
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2024-09-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  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'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.64'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.64'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.3.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.3.1
+- !ruby/object:Gem::Dependency
+  name: yaml
+  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: pry
+  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'
+description: A ruby gem to generate Kong configs across multiple clusters to achieve
+  service equivalence
+email:
+- kumarabhijeet1202@gmail.com
+executables:
+- gojira
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/main.yml"
+- ".gitignore"
+- ".rspec"
+- ".ruby-version"
+- Dockerfile
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- docs/gojira.png
+- exe/gojira
+- gojira.gemspec
+- lib/gojira.rb
+- lib/gojira/apiops/merge.rb
+- lib/gojira/apiops/validations.rb
+- lib/gojira/cli.rb
+- lib/gojira/command/base.rb
+- lib/gojira/command/cluster.rb
+- lib/gojira/command/env.rb
+- lib/gojira/deck/base.rb
+- lib/gojira/deck/file.rb
+- lib/gojira/deck/gateway.rb
+- lib/gojira/errors.rb
+- lib/gojira/version.rb
+- rubocop.yml
+homepage: https://github.com/kumar1202/gojira/tree/main
+licenses: []
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/kumar1202/gojira/tree/main
+  source_code_uri: https://github.com/kumar1202/gojira/tree/main
+  changelog_uri: https://github.com/kumar1202/gojira/tree/main
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.9
+signing_key:
+specification_version: 4
+summary: A ruby gem to generate Kong configs across multiple clusters to achieve service
+  equivalence
+test_files: []