outboxer 0.1.9 → 0.1.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 15a242cddf0a5a417ce73dd0c1efcc3154838eed44fb175bb9fc2e558f189d12
-  data.tar.gz: 56cdd168249595290e1046f34b6bc12d49402b8a7ea23979ff3638f2f9e8b3f9
+  metadata.gz: f881a119f2c2123b34c0a7153590c2eab9907b44045e64d51e16ce914e731bb6
+  data.tar.gz: d30a09f38f02fea3bce19895922d294e40dfb25555e1fcf4fd06b33560d1e2db
 SHA512:
-  metadata.gz: 7fa08d4b955fd0d2aad7f73e1e43851ba1f65a23da80220e9b8345fad9651503bef7170523a65efa028b13243e57b8caaabcbaf9ba1d2c22d2ea98eb12e67137
-  data.tar.gz: e32aabee5228d8ab6a25965a1e393258a15db09948ee7f451bf3001eb9b29dfe53009d485ce837c67e74bb32800fbfd2947bad11a53136b422739667ab389fcc
+  metadata.gz: df0a95d0f24b7ff85038711be1acd4aec4dc5760accb390fb40fdf07342d911b5b07373c4eacbc2e05e25a7a89137ef26c20e201b556c6e07973469806eddaff
+  data.tar.gz: 1d329faae4668703b51cd5becdce8215e4251e1217d9c8311795ab602d71e140511b79874908963a947c24939025bd2dbcd8af0497aa985d9478f7919d7602d7

data/README.md

@@ -1,5 +1,8 @@
 # Outboxer
 
+[![Gem Version](https://badge.fury.io/rb/outboxer.svg)](https://badge.fury.io/rb/outboxer)
+![Ruby](https://github.com/fast-programmer/outboxer/actions/workflows/master.yml/badge.svg)
+
 ## Background
 
 Typically in event driven Ruby on Rails applications:
@@ -50,12 +53,11 @@ end
 #### 2. Update the generated bin/publish block e.g.
 
 ```ruby
-Outboxer::Publisher.publish do |args|
-  logger = args.logger
-  message = args.message
-
+Outboxer::Publisher.publish do |message:, logger:|
   logger.info("[#{message.id}] publishing")
+
   HardJob.perform_async({ "message_id" => message.id })
+
   logger.info("[#{message.id}] published")
 end
 ```
@@ -85,11 +87,13 @@ To see all the parts working together in a single place, check out the [publishe
 
 ## Motivation
 
-Outboxer was created with 4 key benefits in mind:
+Outboxer was created to help high growth SAAS companies transition to event driven architecture quickly.
+
+Specifically this means:
 
-1. speed of integration into existing Ruby on Rails applications (< 1 hour)
-2. comprehensive documentation that is easy to understand
-3. high reliability in production environments (100% code coverage)
+1. fast integration into existing Ruby on Rails applications (< 1 hour)
+2. comprehensive documentation
+3. high reliability in production environments
 4. forever free to use in commerical applications (MIT licence)
 
 ## Contributing

data/Rakefile

@@ -1,5 +1,3 @@
-# require "bundler/gem_tasks"
-# require "bundler/setup"
 require "rspec/core/rake_task"
 
 RSpec::Core::RakeTask.new(:spec)

data/generators/outboxer/templates/bin/publisher.rb

@@ -2,11 +2,10 @@
 
 require_relative "../config/environment"
 
-Outboxer::Publisher.publish do |args|
-  logger = args.logger
-  message = args.message
-
+Outboxer::Publisher.publish do |message:, logger:|
   logger.info("[#{message.id}] publishing")
+
   HardJob.perform_async({ "message_id" => message.id })
+
   logger.info("[#{message.id}] published")
 end

data/lib/outboxer/publisher.rb

@@ -7,19 +7,36 @@ module Outboxer
     @publishing = false
     @logger = Logger.new($stdout)
 
-    Args = Struct.new(:message, :logger)
-
-    # This method initiates the publishing process. It dequeues the messages one by one
-    # and yields to a block that should contain the publishing logic.
+    # Publishes messages from the Outboxer queue.
+    #
+    # This method will continue to publish messages from the queue as long
+    # as @publishing is set to true. It uses an ActiveRecord connection to
+    # handle database interactions.
+    #
+    # @param poll [Integer] the interval (in seconds) at which the method
+    #   should poll the database for new messages.
+    # @param backoff [Proc] a callable object that defines how to increase the
+    #   backoff time when an error occurs. It should accept the current backoff
+    #   time as a parameter and return the new backoff time.
+    #
+    # @yield [Hash] once a message is dequeued, the method yields a hash to
+    #   the given block. The hash contains the :message (the dequeued message)
+    #   and :logger (the logger object).
+    #
+    # @yieldparam message [Message] the dequeued message from the Outboxer queue.
+    # @yieldparam logger [Logger] the logger instance to log any information or errors.
     #
-    # @param [Integer] poll
-    #   Sleep time in seconds between polling the queue when it's empty.
+    # @raise [StandardError] if an error occurs during the yield, it is rescued,
+    #   logged, and then the failed method is invoked to handle the error. The
+    #   method then moves on to the next message in the queue.
     #
-    # @param [Proc] backoff
-    #   A Proc that takes the current backoff time and returns the new backoff time.
+    # @return [void] This method does not have a meaningful return value.
     #
-    # @yieldparam [Args] args
-    #   An Args object containing the message to publish and a logger.
+    # @example Basic usage
+    #   Outboxer::Publisher.publish(poll: 1) do |hash|
+    #     puts hash[:message]
+    #     puts hash[:logger]
+    #   end
     def publish(poll: 1, backoff: ->(current_backoff) { [current_backoff * 2, 5 * 60].min })
       @publishing = true
 
@@ -34,7 +51,7 @@ module Outboxer
           end
 
           begin
-            yield Args.new(outboxer_message.message, @logger)
+            yield message: outboxer_message.message, logger: @logger
           rescue StandardError => exception
             failed(
               outboxer_message: outboxer_message,

data/lib/outboxer/version.rb

@@ -1,3 +1,3 @@
 module Outboxer
-  VERSION = "0.1.9".freeze
+  VERSION = "0.1.11".freeze
 end

data/lib/tasks/gem.rake

@@ -0,0 +1,58 @@
+require "rake/packagetask"
+
+namespace :gem do
+  desc "Bump version number"
+  task :bump, [:type] do |_t, args|
+    args.with_defaults(type: "patch")
+
+    unless %w[major minor patch].include?(args[:type])
+      raise "Invalid version type - choose from major/minor/patch"
+    end
+
+    version_file = File.expand_path("../../lib/outboxer/version.rb", __dir__)
+    version = ""
+    File.open(version_file, "r") do |file|
+      version = file.read.match(/VERSION = "(.*)"/)[1]
+    end
+
+    version_parts = version.split(".").map(&:to_i)
+    case args[:type]
+    when "major"
+      version_parts[0] += 1
+      version_parts[1] = 0
+      version_parts[2] = 0
+    when "minor"
+      version_parts[1] += 1
+      version_parts[2] = 0
+    when "patch"
+      version_parts[2] += 1
+    end
+
+    new_version = version_parts.join(".")
+    File.write(version_file, "module Outboxer\n  VERSION = \"#{new_version}\".freeze\nend\n")
+
+    puts "Gem version bumped to #{new_version}"
+  end
+
+  desc "Build the gem"
+  task :build do
+    Outboxer.send(:remove_const, :VERSION) if Outboxer.const_defined?(:VERSION)
+    load "lib/outboxer/version.rb"
+    sh "gem build outboxer.gemspec"
+
+    puts "Gem built successfully."
+  end
+
+  desc "Push the gem to RubyGems"
+  task :push do
+    Outboxer.send(:remove_const, :VERSION) if Outboxer.const_defined?(:VERSION)
+    load "lib/outboxer/version.rb"
+    version = Outboxer::VERSION
+    sh "gem push outboxer-#{version}.gem"
+
+    puts "Gem pushed to RubyGems."
+  end
+
+  desc "Bump, build and push the gem to RubyGems"
+  task release: %i[bump build push]
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: outboxer
 version: !ruby/object:Gem::Version
-  version: 0.1.9
+  version: 0.1.11
 platform: ruby
 authors:
 - Adam Mikulasev
@@ -49,6 +49,7 @@ files:
 - lib/outboxer/publisher.rb
 - lib/outboxer/railtie.rb
 - lib/outboxer/version.rb
+- lib/tasks/gem.rake
 - outboxer.gemspec
 - sig/outboxer.rbs
 homepage: https://github.com/fast-programmer/outboxer