laterbox 0.0.0.alpha

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d72734a944f185b6651c5edb64c655b4f364dc5a5653aa3b399c5ef3f7c4d701
+  data.tar.gz: fcbf6d42c2b28114fb0b8f984def77d87317fbd02665e298473d5e6649bdaecc
+SHA512:
+  metadata.gz: 93651564b4be33f872fca5f33e438bb2bcf24c8d6b51f343411febaa48575cbdda31db86acfc5328a3a6dbd7a9c9207e4205169e227b4ab4e7c2741485606c82
+  data.tar.gz: 2fed57a9d2c47d7a2f8a515af39a6ecafd739a93654dc69d2fef60fca5c6647448d2637584e8c448d4bc1191bc786beb87a3477867c54e0405a066d76c12e920

data/README.md

@@ -0,0 +1,25 @@
+# Laterbox
+
+## Installation
+
+Install the gem and add to the application's Gemfile by executing:
+
+    $ bundle add UPDATE_WITH_YOUR_GEM_NAME_PRIOR_TO_RELEASE_TO_RUBYGEMS_ORG
+
+If bundler is not being used to manage dependencies, install the gem by executing:
+
+    $ gem install UPDATE_WITH_YOUR_GEM_NAME_PRIOR_TO_RELEASE_TO_RUBYGEMS_ORG
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/ryancyq/laterbox.

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: :rubocop

data/exe/laterbox

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/laterbox"
+
+begin
+  Laterbox::Command.run
+rescue StandardError => ex
+  raise e if $DEBUG
+
+  warn ex.message
+  warn ex.backtrace.join("\n")
+  exit 1
+end

data/laterbox.gemspec

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require_relative "lib/laterbox/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "laterbox"
+  spec.version = Laterbox::VERSION::STRING
+  spec.authors = ["Ryan Chang"]
+  spec.email = ["ryancyq@gmail.com"]
+
+  spec.summary = "A transactional outbox implementation for event publishing in Ruby."
+  spec.description = "A transactional outbox implementation for event publishing in Ruby."
+  spec.homepage = "https://github.com/ryancyq/laterbox"
+  spec.required_ruby_version = ">= 3.0.0"
+
+  spec.metadata["allowed_push_host"] = "https://rubygems.org"
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/ryancyq/laterbox"
+  spec.metadata["changelog_uri"] = "https://github.com/ryancyq/laterbox/blob/main/CHANGELOG.md"
+  spec.metadata["github_repo"] = "ssh://github.com/ryancyq/laterbox"
+
+  # 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(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[bin/ examples/ test/ spec/ features/ .git appveyor Gemfile])
+    end
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'rubocop'
+
+  # For more information and examples about making a new gem, check out our
+  # guide at: https://bundler.io/guides/creating_gem.html
+end

data/lib/laterbox/bootloader.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Laterbox
+  class Bootloader
+    def initialize(config)
+    end
+
+    def start
+    end
+  end
+end

data/lib/laterbox/command.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+$stdout.sync = true
+
+require "optparse"
+
+module Laterbox
+  class Command
+    INTERRUPT_SIGNALS = %w[INT TERM]
+
+    def self.run(args = ARGV.dup)
+      new(args).run
+    end
+
+    def initialize(args)
+      @action = options_parser.parse!(args)
+    end
+
+    def run
+      config = setup_config
+
+      INTERRUPT_SIGNALS.each do |signal|
+        Signal.trap(signal) do
+          puts "Exiting due to #{signal}"
+        end
+      end
+
+      app = ::Laterbox::Bootloader.new(config)
+      app.start
+    end
+
+private
+
+    def setup_config
+      config = ::Laterbox::Config.new.to_hash
+
+      if @config_file
+        config.merge!(file_config(@config_file)) 
+      else
+        default_config_file = File.join("config", "laterbox.yml")
+        config.merge!(file_config(default_config_file)) if File.exist?(default_config_file)
+      end
+      config.merge!(command_config)
+      config
+    end
+
+    def file_config(path)
+      return {} unless File.exist?(path)
+
+      ::Laterbox::Config.from_file(path).to_hash 
+    end
+
+    def command_config
+      {
+        boxes: @box_names,
+        concurrency: @concurrency
+      }.compact
+    end
+
+    def options_parser
+      @options_parser ||= OptionParser.new do |opt|
+        opt.banner = "Usage: laterbox [options] start|stop|restart|run"
+        opt.on('-h', '--help', 'show help') do
+          $stdout.puts opt
+          exit(0)
+        end
+        opt.on "-v", "--version", "print version" do |_arg|
+          puts "Laterbox #{Laterbox::VERSION::STRING}"
+          exit(0)
+        end
+        opt.on "-C", "--config PATH", "path to YAML config file" do |config_file|
+          raise ArgumentError.new("No such file #{config_file}") unless File.exist?(config_file)
+          @config_file = config_file 
+        end
+        opt.on('-c', '--concurrency=2', 'number of worker threads to spawn') do |concurrency|
+          @concurrency = concurrency.to_i rescue nil
+        end
+        opt.on('-b', '--box=box_name_1,box_name_2', 'specify the box names') do |box_names|
+          @box_names = box_names.split(',')
+        end
+      end
+    end
+  end
+end

data/lib/laterbox/config.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require "yaml"
+
+module Laterbox
+  class Config
+
+    DEFAULT_LOG_LEVEL = 'info'.freeze
+    DEFAULT_BOXES = [].freeze
+    DEFAULT_CONCURRENCY = 3
+    DEFAULT_BUFFER_SIZE = 1
+
+    attr_accessor :default_log_level, :boxes, :concurrency, :buffer_size
+
+    def initialize(options = {})
+      set_defaults
+      @default_log_level = options[:default_log_level] if options.key?(:default_log_level)
+      @boxes             = options[:boxes] if options.key?(:boxes)
+      @concurrency        = options[:concurrency] if options.key?(:concurrency)
+      @buffer_size       = options[:buffer_size] if options.key?(:buffer_size)
+    end
+
+    def to_hash
+      {
+        default_log_level: @default_log_level,
+        boxes:             @boxes,
+        concurrency:       @concurrency,
+        buffer_size:       @buffer_size
+      }
+    end
+
+    def self.from_file(file_path)
+      raise ArgumentError.new("No such config file #{file_path}") unless File.exist?(file_path)
+
+      file_content = File.read(file_path)
+      options = YAML.safe_load(file_content, permitted_classes: [Symbol], aliases: true) || {}
+      
+      if options.respond_to?(:deep_symbolize_keys!)
+        options.deep_symbolize_keys!
+      else
+        symbolize_keys_deep!(options)
+      end
+
+      new(options)
+    end
+
+  private
+
+    def set_defaults
+      @default_log_level = DEFAULT_LOG_LEVEL
+      @boxes             = DEFAULT_BOXES
+      @concurrency        = DEFAULT_CONCURRENCY
+      @buffer_size       = DEFAULT_BUFFER_SIZE
+    end
+
+    def symbolize_keys_deep!(hash)
+      hash.keys.each do |key|
+        symkey = key.respond_to?(:to_sym) ? key.to_sym : key
+        hash[symkey] = hash.delete(key)
+        symbolize_keys_deep!(hash[symkey]) if hash[symkey].is_a? Hash
+      end
+    end
+  end
+end

data/lib/laterbox/version.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Laterbox
+  module VERSION
+    MAJOR = 0
+    MINOR = 0
+    BUILD  = 0
+    PRE   = "alpha"
+
+    STRING = [MAJOR, MINOR, BUILD, PRE].compact.join(".")
+  end
+end

data/lib/laterbox.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require_relative "laterbox/command"
+require_relative "laterbox/bootloader"
+require_relative "laterbox/config"
+require_relative "laterbox/version"
+
+module Laterbox
+  class Error < StandardError; end
+end

data/sig/laterbox

@@ -0,0 +1,4 @@
+module Laterbox
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,100 @@
+--- !ruby/object:Gem::Specification
+name: laterbox
+version: !ruby/object:Gem::Version
+  version: 0.0.0.alpha
+platform: ruby
+authors:
+- Ryan Chang
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2023-12-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  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: rspec
+  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: rubocop
+  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 transactional outbox implementation for event publishing in Ruby.
+email:
+- ryancyq@gmail.com
+executables:
+- laterbox
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- Rakefile
+- exe/laterbox
+- laterbox.gemspec
+- lib/laterbox.rb
+- lib/laterbox/bootloader.rb
+- lib/laterbox/command.rb
+- lib/laterbox/config.rb
+- lib/laterbox/version.rb
+- sig/laterbox
+homepage: https://github.com/ryancyq/laterbox
+licenses: []
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/ryancyq/laterbox
+  source_code_uri: https://github.com/ryancyq/laterbox
+  changelog_uri: https://github.com/ryancyq/laterbox/blob/main/CHANGELOG.md
+  github_repo: ssh://github.com/ryancyq/laterbox
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">"
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubygems_version: 3.4.10
+signing_key: 
+specification_version: 4
+summary: A transactional outbox implementation for event publishing in Ruby.
+test_files: []