teneo_microservice 1.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 18cb01bcee051c684f6526d7ebad58897f65350fa6cbf1cb88ed8d401a9750ee
+  data.tar.gz: 578d8002f4d79b85d6494a729a426a2351b3b64688cf0887b96abf319c7a902d
+SHA512:
+  metadata.gz: 456e6546a5060982d17daba9c04d0051340cbaeaae005a4b73c375b963df3d6f804c0f28c7b72a125cfc825a5c2201d784f00d7dea2aa9f910f4242c65ce4d6e
+  data.tar.gz: ba90af2daa768b9b74eff78d686bd76b3da30ab5f475b631406a1423a571c20d622e65fc7b6e0a0f8af5f716241b2652a88be70c64a71b5bd89be73913975acf

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2025-01-21
+
+- Initial release

data/Gemfile

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gem 'debug', require: false # requires libyaml-dev to be installed on system (Ubuntu)
+gem 'dotenv', groups: %i[development test]
+gem 'grpc'
+gem 'grpc-tools'
+gem 'protobuf'
+gem 'rake', '~> 13.0'
+gem 'rspec', '~> 3.0'
+gem 'rubocop', '~> 1.21'
+gem 'rubocop-rake', require: false
+gem 'securerandom'

data/Gemfile.lock

@@ -0,0 +1,132 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (7.1.5.1)
+      base64
+      benchmark (>= 0.3)
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      connection_pool (>= 2.2.5)
+      drb
+      i18n (>= 1.6, < 2)
+      logger (>= 1.4.2)
+      minitest (>= 5.1)
+      mutex_m
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0)
+    ast (2.4.2)
+    base64 (0.2.0)
+    benchmark (0.4.0)
+    bigdecimal (3.1.9)
+    concurrent-ruby (1.3.5)
+    connection_pool (2.5.0)
+    date (3.4.1)
+    debug (1.10.0)
+      irb (~> 1.10)
+      reline (>= 0.3.8)
+    diff-lcs (1.5.1)
+    dotenv (3.1.7)
+    drb (2.2.1)
+    google-protobuf (4.29.3)
+      bigdecimal
+      rake (>= 13)
+    google-protobuf (4.29.3-x86_64-linux)
+      bigdecimal
+      rake (>= 13)
+    googleapis-common-protos-types (1.18.0)
+      google-protobuf (>= 3.18, < 5.a)
+    grpc (1.69.0)
+      google-protobuf (>= 3.25, < 5.0)
+      googleapis-common-protos-types (~> 1.0)
+    grpc (1.69.0-x86_64-linux)
+      google-protobuf (>= 3.25, < 5.0)
+      googleapis-common-protos-types (~> 1.0)
+    grpc-tools (1.69.0)
+    i18n (1.14.7)
+      concurrent-ruby (~> 1.0)
+    io-console (0.8.0)
+    irb (1.14.3)
+      rdoc (>= 4.0.0)
+      reline (>= 0.4.2)
+    json (2.9.1)
+    language_server-protocol (3.17.0.3)
+    logger (1.6.5)
+    middleware (0.1.0)
+    minitest (5.25.4)
+    mutex_m (0.3.0)
+    parallel (1.26.3)
+    parser (3.3.7.0)
+      ast (~> 2.4.1)
+      racc
+    protobuf (3.10.9)
+      activesupport (>= 3.2)
+      middleware
+      thor
+      thread_safe
+    psych (5.2.3)
+      date
+      stringio
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.2.1)
+    rdoc (6.11.0)
+      psych (>= 4.0.0)
+    regexp_parser (2.10.0)
+    reline (0.6.0)
+      io-console (~> 0.5)
+    rspec (3.13.0)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.2)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.3)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.2)
+    rubocop (1.70.0)
+      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 (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.36.2, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.37.0)
+      parser (>= 3.3.1.0)
+    rubocop-rake (0.6.0)
+      rubocop (~> 1.0)
+    ruby-progressbar (1.13.0)
+    securerandom (0.3.2)
+    stringio (3.1.2)
+    thor (1.3.2)
+    thread_safe (0.3.6)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    unicode-display_width (3.1.4)
+      unicode-emoji (~> 4.0, >= 4.0.4)
+    unicode-emoji (4.0.4)
+
+PLATFORMS
+  ruby
+  x86_64-linux
+
+DEPENDENCIES
+  debug
+  dotenv
+  grpc
+  grpc-tools
+  protobuf
+  rake (~> 13.0)
+  rspec (~> 3.0)
+  rubocop (~> 1.21)
+  rubocop-rake
+  securerandom
+
+BUNDLED WITH
+   2.5.23

data/README.md

@@ -0,0 +1 @@
+# Teneo Microservice Base for Ruby Projects

data/Rakefile

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require 'bundler/setup' # Required to use gems from local vendor dir
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+
+Bundler::GemHelper.install_tasks
+
+RSpec::Core::RakeTask.new(:spec)
+
+RuboCop::RakeTask.new
+
+task default: %w[spec rubocop]
+
+task :proto do
+  sh 'grpc_tools_ruby_protoc -I proto --ruby_out=lib/teneo/proto --grpc_out=lib/teneo/proto proto/*.proto'
+end

data/bin/bundle

@@ -0,0 +1,109 @@
+#!/usr/bin/env ruby3.0
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'bundle' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "rubygems"
+
+m = Module.new do
+  module_function
+
+  def invoked_as_script?
+    File.expand_path($0) == File.expand_path(__FILE__)
+  end
+
+  def env_var_version
+    ENV["BUNDLER_VERSION"]
+  end
+
+  def cli_arg_version
+    return unless invoked_as_script? # don't want to hijack other binstubs
+    return unless "update".start_with?(ARGV.first || " ") # must be running `bundle update`
+    bundler_version = nil
+    update_index = nil
+    ARGV.each_with_index do |a, i|
+      if update_index && update_index.succ == i && a.match?(Gem::Version::ANCHORED_VERSION_PATTERN)
+        bundler_version = a
+      end
+      next unless a =~ /\A--bundler(?:[= ](#{Gem::Version::VERSION_PATTERN}))?\z/
+      bundler_version = $1
+      update_index = i
+    end
+    bundler_version
+  end
+
+  def gemfile
+    gemfile = ENV["BUNDLE_GEMFILE"]
+    return gemfile if gemfile && !gemfile.empty?
+
+    File.expand_path("../Gemfile", __dir__)
+  end
+
+  def lockfile
+    lockfile =
+      case File.basename(gemfile)
+      when "gems.rb" then gemfile.sub(/\.rb$/, ".locked")
+      else "#{gemfile}.lock"
+      end
+    File.expand_path(lockfile)
+  end
+
+  def lockfile_version
+    return unless File.file?(lockfile)
+    lockfile_contents = File.read(lockfile)
+    return unless lockfile_contents =~ /\n\nBUNDLED WITH\n\s{2,}(#{Gem::Version::VERSION_PATTERN})\n/
+    Regexp.last_match(1)
+  end
+
+  def bundler_requirement
+    @bundler_requirement ||=
+      env_var_version ||
+      cli_arg_version ||
+      bundler_requirement_for(lockfile_version)
+  end
+
+  def bundler_requirement_for(version)
+    return "#{Gem::Requirement.default}.a" unless version
+
+    bundler_gem_version = Gem::Version.new(version)
+
+    bundler_gem_version.approximate_recommendation
+  end
+
+  def load_bundler!
+    ENV["BUNDLE_GEMFILE"] ||= gemfile
+
+    activate_bundler
+  end
+
+  def activate_bundler
+    gem_error = activation_error_handling do
+      gem "bundler", bundler_requirement
+    end
+    return if gem_error.nil?
+    require_error = activation_error_handling do
+      require "bundler/version"
+    end
+    return if require_error.nil? && Gem::Requirement.new(bundler_requirement).satisfied_by?(Gem::Version.new(Bundler::VERSION))
+    warn "Activating bundler (#{bundler_requirement}) failed:\n#{gem_error.message}\n\nTo install the version of bundler this project requires, run `gem install bundler -v '#{bundler_requirement}'`"
+    exit 42
+  end
+
+  def activation_error_handling
+    yield
+    nil
+  rescue StandardError, LoadError => e
+    e
+  end
+end
+
+m.load_bundler!
+
+if m.invoked_as_script?
+  load Gem.bin_path("bundler", "bundle")
+end

data/bin/console

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "teneo/microservice_ruby"
+
+# 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.
+
+require "irb"
+IRB.start(__FILE__)

data/bin/dotenv

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby3.0
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'dotenv' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("dotenv", "dotenv")

data/bin/grpc_tools_ruby_protoc

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby3.0
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'grpc_tools_ruby_protoc' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("grpc-tools", "grpc_tools_ruby_protoc")

data/bin/grpc_tools_ruby_protoc_plugin

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby3.0
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'grpc_tools_ruby_protoc_plugin' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("grpc-tools", "grpc_tools_ruby_protoc_plugin")

data/bin/htmldiff

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby3.0
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'htmldiff' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("diff-lcs", "htmldiff")

data/bin/irb

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby3.0
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'irb' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("irb", "irb")

data/bin/ldiff

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby3.0
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'ldiff' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("diff-lcs", "ldiff")

data/bin/protoc-gen-ruby

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby3.0
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'protoc-gen-ruby' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("protobuf", "protoc-gen-ruby")

data/bin/racc

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby3.0
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'racc' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("racc", "racc")

data/bin/rake

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby3.0
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rake' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rake", "rake")

data/bin/rdbg

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby3.0
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rdbg' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("debug", "rdbg")

data/bin/rdoc

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby3.0
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rdoc' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rdoc", "rdoc")

data/bin/ri

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby3.0
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'ri' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rdoc", "ri")

data/bin/rpc_server

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby3.0
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rpc_server' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("protobuf", "rpc_server")

data/bin/rspec

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby3.0
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rspec' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rspec-core", "rspec")

data/bin/rubocop

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby3.0
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rubocop' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rubocop", "rubocop")

data/bin/ruby-parse

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby3.0
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'ruby-parse' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("parser", "ruby-parse")

data/bin/ruby-rewrite

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby3.0
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'ruby-rewrite' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("parser", "ruby-rewrite")

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/bin/thor

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby3.0
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'thor' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("thor", "thor")

data/lib/teneo_microservice/client.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require_relative 'util/env'
+require_relative 'util/convert'
+require_relative 'grpc_services/cloud_event_enum'
+require_relative 'proto/cloud_event_services_pb'
+
+# Sends data to gRPC services
+class Client
+  attr_accessor :socket, :stub
+
+  def initialize(socket:)
+    Env.valid_settings?
+
+    @socket = socket
+    @stub = CloudEvents::Stub.new(@socket, :this_channel_is_insecure)
+  end
+end

data/lib/teneo_microservice/error_classes/env_settings_error.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# This error should get raised when the environment does not provide
+# the required attributes.
+class EnvSettingsError < StandardError
+  def initialize(msg = 'ERROR: invalid settings in .env file')
+    super(msg)
+  end
+end

data/lib/teneo_microservice/error_classes/socket_format_error.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+# This error should get raised when a socket string has an invalid format
+class SocketFormatError < StandardError
+  def initialize(msg = 'invalid socket')
+    super(msg)
+  end
+end

data/lib/teneo_microservice/grpc_services/cloud_event_enum.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require 'securerandom'
+
+require_relative '../util/convert'
+
+# CloudEventEnum provides an Enumerator of cloud events
+class CloudEventEnum
+  def initialize(array:)
+    @array = array
+  end
+
+  def each
+    return enum_for(:each) unless block_given?
+
+    @array.each do |element|
+      yield Convert.json_to_cloudevent(data: element)
+    end
+  end
+end

data/lib/teneo_microservice/proto/cloud_event_pb.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: cloud_event.proto
+
+require 'google/protobuf'
+
+require 'google/protobuf/any_pb'
+require 'google/protobuf/timestamp_pb'
+
+
+descriptor_data = "\n\x11\x63loud_event.proto\x1a\x19google/protobuf/any.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\x8c\x04\n\nCloudEvent\x12\n\n\x02id\x18\x01 \x02(\t\x12\x0e\n\x06source\x18\x02 \x02(\t\x12\x14\n\x0cspec_version\x18\x03 \x02(\t\x12\x0c\n\x04type\x18\x04 \x02(\t\x12/\n\nattributes\x18\x05 \x03(\x0b\x32\x1b.CloudEvent.AttributesEntry\x12\x15\n\x0b\x62inary_data\x18\x06 \x01(\x0cH\x00\x12\x13\n\ttext_data\x18\x07 \x01(\tH\x00\x12*\n\nproto_data\x18\x08 \x01(\x0b\x32\x14.google.protobuf.AnyH\x00\x1aW\n\x0f\x41ttributesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x33\n\x05value\x18\x02 \x01(\x0b\x32$.CloudEvent.CloudEventAttributeValue:\x02\x38\x01\x1a\xd3\x01\n\x18\x43loudEventAttributeValue\x12\x14\n\nce_boolean\x18\x01 \x01(\x08H\x00\x12\x14\n\nce_integer\x18\x02 \x01(\x05H\x00\x12\x13\n\tce_string\x18\x03 \x01(\tH\x00\x12\x12\n\x08\x63\x65_bytes\x18\x04 \x01(\x0cH\x00\x12\x10\n\x06\x63\x65_uri\x18\x05 \x01(\tH\x00\x12\x14\n\nce_uri_ref\x18\x06 \x01(\tH\x00\x12\x32\n\x0c\x63\x65_timestamp\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x42\x06\n\x04\x61ttrB\x06\n\x04\x64\x61ta\".\n\x0f\x43loudEventBatch\x12\x1b\n\x06\x65vents\x18\x01 \x03(\x0b\x32\x0b.CloudEvent2\xc3\x01\n\x0b\x43loudEvents\x12+\n\rGetCloudEvent\x12\x0b.CloudEvent\x1a\x0b.CloudEvent\"\x00\x12.\n\x0eGetCloudEvents\x12\x0b.CloudEvent\x1a\x0b.CloudEvent\"\x00(\x01\x12/\n\x0fSendCloudEvents\x12\x0b.CloudEvent\x1a\x0b.CloudEvent\"\x00\x30\x01\x12&\n\x04\x43hat\x12\x0b.CloudEvent\x1a\x0b.CloudEvent\"\x00(\x01\x30\x01"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+pool.add_serialized_file(descriptor_data)
+
+CloudEvent = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("CloudEvent").msgclass
+CloudEvent::CloudEventAttributeValue = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("CloudEvent.CloudEventAttributeValue").msgclass
+CloudEventBatch = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("CloudEventBatch").msgclass

data/lib/teneo_microservice/proto/cloud_event_services_pb.rb

@@ -0,0 +1,27 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: cloud_event.proto for package ''
+
+require 'grpc'
+require_relative 'cloud_event_pb'
+
+module CloudEvents
+  class Service
+
+    include ::GRPC::GenericService
+
+    self.marshal_class_method = :encode
+    self.unmarshal_class_method = :decode
+    self.service_name = 'CloudEvents'
+
+    # Obtains a cloud event
+    rpc :GetCloudEvent, ::CloudEvent, ::CloudEvent
+    # Obtains a series of cloud events
+    rpc :GetCloudEvents, stream(::CloudEvent), ::CloudEvent
+    # Sends a series of cloud events
+    rpc :SendCloudEvents, ::CloudEvent, stream(::CloudEvent)
+    # Send and receive cloud events
+    rpc :Chat, stream(::CloudEvent), stream(::CloudEvent)
+  end
+
+  Stub = Service.rpc_stub_class
+end

data/lib/teneo_microservice/server.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require_relative 'client'
+require_relative 'service_orchestrator'
+require_relative 'util/env'
+
+# Encapsulating class for all gRPC communication
+class Server
+  attr_accessor :socket, :remote_hosts, :clients
+
+  def initialize
+    Env.valid_settings?
+
+    @socket = "#{ENV["LISTEN_ADDRESS"]}:#{ENV["PORT"]}"
+    @remote_hosts = ENV['REMOTE_HOSTS'].split('|') unless ENV['REMOTE_HOSTS'].nil?
+
+    @clients = []
+    @remote_hosts&.each do |remote|
+      client = Client.new(socket: remote)
+      @clients.push(client)
+    end
+
+    @orchestrator = ServiceOrchestrator.new(socket: @socket)
+    @orchestrator.initialize_listener
+  end
+
+  def register_service(service:)
+    @orchestrator.add(service)
+  end
+
+  def start_listening_for_data
+    @orchestrator.start
+  end
+end

data/lib/teneo_microservice/service_orchestrator.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require 'grpc'
+
+require_relative 'error_classes/socket_format_error'
+
+# Listener for gRPC data
+class ServiceOrchestrator
+  attr_accessor :socket
+
+  def initialize(socket:)
+    @socket = socket
+  end
+
+  def initialize_listener
+    puts 'initializing gRPC service'
+
+    raise SocketFormatError unless @socket =~ /^(?:[0-9]{1,3}\.){3}[0-9]{1,3}:\d{1,5}$/
+
+    @listener = GRPC::RpcServer.new
+    @listener.add_http2_port(@socket, :this_port_is_insecure)
+    GRPC.logger.info("... running insecurely on #{@socket}")
+  end
+
+  def add(service)
+    @listener.handle(service)
+  end
+
+  def start
+    puts "listening insecurely on #{@socket}"
+    @listener.run_till_terminated_or_interrupted([1, 'int', 'SIGQUIT'])
+  end
+
+  def wait_till_running
+    @listener.wait_till_running
+  end
+
+  def running?
+    @listener.running?
+  end
+
+  def stop
+    puts 'shutting down gRPC server'
+    @listener.stop if running?
+  end
+end

data/lib/teneo_microservice/util/convert.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'securerandom'
+
+require_relative '../proto/cloud_event_services_pb'
+require_relative '../grpc_services/cloud_event_enum'
+
+# The Convert module provides functionality on custom data conversion operations.
+module Convert
+  def self.json_to_cloudevent(data:)
+    raise JSON::ParserError, "invalid JSON: '#{data}'" unless valid_json?(json: data)
+
+    source = ENV['CLOUDEVENTS_SOURCE']
+    source = "#{ENV["LISTEN_ADDRESS"]}:#{ENV["PORT"]}" if source.nil?
+
+    CloudEvent.new(
+      id: SecureRandom.uuid,
+      source: source,
+      spec_version: ENV['CLOUDEVENTS_SPEC_VERSION'],
+      type: ENV['CLOUDEVENTS_TYPE_PREFIX'],
+      text_data: data,
+      attributes: generate_attributes,
+    )
+  end
+
+  def self.generate_attributes
+    now = Time.now
+
+    {
+      datacontenttype: {
+        ce_string: "application/json"
+      },
+      time: {
+        ce_timestamp: {
+          seconds: now.to_i,
+          nanos: now.nsec
+        }
+      }
+    }
+  end
+
+  def self.array_to_cloudevent_enum(array:)
+    CloudEventEnum.new(array: array)
+  end
+
+  def self.valid_json?(json:)
+    JSON.parse(json)
+    true
+  rescue JSON::ParserError, TypeError
+    false
+  end
+end

data/lib/teneo_microservice/util/env.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require 'securerandom'
+
+require_relative '../error_classes/env_settings_error'
+require_relative '../error_classes/socket_format_error'
+
+# The Env module provides functionality for env variable settings.
+module Env
+  def self.valid_settings?
+    mandatory_settings = %w[LISTEN_ADDRESS PORT CLOUDEVENTS_SPEC_VERSION CLOUDEVENTS_TYPE_PREFIX]
+    mandatory_settings.each do |setting|
+      raise EnvSettingsError, "environment variable '#{setting}' not found" if ENV[setting].nil?
+    end
+
+    socket = "#{ENV["LISTEN_ADDRESS"]}:#{ENV["PORT"]}"
+    raise SocketFormatError unless socket =~ /^(?:[0-9]{1,3}\.){3}[0-9]{1,3}:\d{1,5}$/
+  end
+end

data/lib/teneo_microservice.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require_relative 'teneo_microservice/client'
+require_relative 'teneo_microservice/server'

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification
+name: teneo_microservice
+version: !ruby/object:Gem::Version
+  version: 1.0.1
+platform: ruby
+authors:
+- Ruben Vanoverschelde
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2025-03-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: grpc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: This gem can be used to implement gRPC and CloudEvents communication
+  between microservices.
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- bin/bundle
+- bin/console
+- bin/dotenv
+- bin/grpc_tools_ruby_protoc
+- bin/grpc_tools_ruby_protoc_plugin
+- bin/htmldiff
+- bin/irb
+- bin/ldiff
+- bin/protoc-gen-ruby
+- bin/racc
+- bin/rake
+- bin/rdbg
+- bin/rdoc
+- bin/ri
+- bin/rpc_server
+- bin/rspec
+- bin/rubocop
+- bin/ruby-parse
+- bin/ruby-rewrite
+- bin/setup
+- bin/thor
+- lib/teneo_microservice.rb
+- lib/teneo_microservice/client.rb
+- lib/teneo_microservice/error_classes/env_settings_error.rb
+- lib/teneo_microservice/error_classes/socket_format_error.rb
+- lib/teneo_microservice/grpc_services/cloud_event_enum.rb
+- lib/teneo_microservice/proto/cloud_event_pb.rb
+- lib/teneo_microservice/proto/cloud_event_services_pb.rb
+- lib/teneo_microservice/server.rb
+- lib/teneo_microservice/service_orchestrator.rb
+- lib/teneo_microservice/util/convert.rb
+- lib/teneo_microservice/util/env.rb
+homepage: https://github.com/libis/teneo-microservice-ruby
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/libis/teneo-microservice-ruby
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.5
+signing_key: 
+specification_version: 4
+summary: Provides communication logic using the gRPC protocol and CloudEvents format.
+test_files: []