anachronic 0.42.7 → 0.43.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4461c6dcc692bc00a5a1206887182c095be2fc081ed065d58b8cb463750f2c21
-  data.tar.gz: c1ce7c68f61900edb534d3e76ec78fff67a0cd86bcb99e1a8743a69b4320deb1
+  metadata.gz: 258ec036a2fdc3a3ef100b6e77b9db95f09b640138297cdefe8eb8120cb18bc7
+  data.tar.gz: f71aa8121e0a373044026d82b3ea654c67f47816aaca3645a99df8cfcac6d941
 SHA512:
-  metadata.gz: df8e237a8230c563be2654cf506d54c51b725ec041274fd9f68e032cb1c6c57af04fc091fc3a8d2b5484b12ee55e98a9c263d8d31eaec24aa34ff56384aca3c6
-  data.tar.gz: 45cdbf8e69e75da8481205adaefc84a45e3801e3cd177e552d67764a36082e87cd857a290c622738a22596001aec71a146bd0fa96c1e08a938fbe7f1503c9ca8
+  metadata.gz: 707d67121db58d16bfd44f504ebfd7d5ee234cab4824d1e42d71ede2cbe96649898c21404f8e21480e0d0a1a8f02a3415e214f2fffd03cde9b7ccd2ca1364e6f
+  data.tar.gz: 461deb146099ef7e3f97b9369be8f66229bd3503acc9fc6391257decc123f7d14c9626bd4bef291529ec33403bd6d278934166b427625f3d1d365003fe041c32

data/Gemfile.lock

@@ -1,26 +1,26 @@
 PATH
   remote: .
   specs:
-    anachronic (0.42.7)
+    anachronic (0.43.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    diff-lcs (1.4.4)
+    diff-lcs (1.3)
     rake (12.3.3)
-    rspec (3.9.0)
-      rspec-core (~> 3.9.0)
-      rspec-expectations (~> 3.9.0)
-      rspec-mocks (~> 3.9.0)
-    rspec-core (3.9.2)
-      rspec-support (~> 3.9.3)
-    rspec-expectations (3.9.2)
+    rspec (3.8.0)
+      rspec-core (~> 3.8.0)
+      rspec-expectations (~> 3.8.0)
+      rspec-mocks (~> 3.8.0)
+    rspec-core (3.8.0)
+      rspec-support (~> 3.8.0)
+    rspec-expectations (3.8.3)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-mocks (3.9.1)
+      rspec-support (~> 3.8.0)
+    rspec-mocks (3.8.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-support (3.9.3)
+      rspec-support (~> 3.8.0)
+    rspec-support (3.8.0)
 
 PLATFORMS
   ruby

data/README.md

@@ -50,9 +50,21 @@ Or install it yourself as:
 
     $ gem install anachronic
 
-## Usage
+## Configuration
+
+To configure, run this or add to an initializers file (in case of Rails)
+
+```ruby
+Anachronic.configure do |config|
+  config.default_executor = Sidekiq
+end
+```
+
+In case no `default_exeucutor` is configured, the gem will use the first one that is available (defined) from the list:
+- ApplicationJob
+- Sidekiq
+- Resque
 
-TODO: Write usage instructions here
 
 ## Development
 

data/Rakefile

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

data/lib/anachronic.rb

@@ -1,17 +1,12 @@
 # frozen_string_literal: true
 
 require 'anachronic/version'
-require 'anachronic/error'
 require 'anachronic/background_executor'
-require 'anachronic/executors/application_job'
+require 'anachronic/error'
+require 'anachronic/override'
+require 'anachronic/configuration'
 
 module Anachronic
-  def async(method_name)
-    new_name = "anachronic__#{method_name}".to_sym
-    alias_method new_name, method_name
-
-    define_method(method_name) do |*args|
-      BackgroundExecutor.call(self, new_name, *args)
-    end
-  end
+  include Override
+  include Configuration
 end

data/lib/anachronic/background_executor.rb

@@ -1,6 +1,9 @@
 # frozen_string_literal: true
 
+require_relative './error.rb'
+
 module Anachronic
+  # Class for deciding a background execution backend
   class BackgroundExecutor
     class << self
       def call(instance, method, *args)
@@ -12,14 +15,19 @@ module Anachronic
       private
 
       def executor
-        return Executors::ApplicationJob if defined?(ApplicationJob)
-        return Executors::ApplicationJob if defined?(Sidekiq)
+        @executor ||= begin
+          return Executors::ApplicationJob if default_or_defined?(ApplicationJob)
+          return Executors::Sidekiq if default_or_defined?(Sidekiq)
+          return Executors::Resque if default_or_defined?(Resque)
+        end
+      end
 
-        Executors::Resque if defined?(Resque)
+      def default_or_defined?(name)
+        defined?(name) || config.default_executor == name
       end
 
       def no_executor
-        raise Anachronic::Error, 'No background executor defined, async methods will be executed synchronously'
+        raise Anachronic::Error('No background executor found')
       end
     end
   end

data/lib/anachronic/configuration.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require 'ostruct'
+
+module Anachronic
+  module Configuration
+    def self.configure
+      @config ||= OpenStruct.new
+      yield(@config) if block_given?
+      @config
+    end
+
+    def self.config
+      @config || configure
+    end
+  end
+end

data/lib/anachronic/executors/application_job.rb

@@ -2,16 +2,19 @@
 
 module Anachronic
   module Executors
+    # Default executor for ApplicationJob backend
     class ApplicationJob
-      def self.call(instance, method, *args)
-        default_executor.perform_later(instance, method, *args)
-      end
+      class << self
+        def call(instance, method, *args)
+          default_executor.perform_later(instance, method, *args)
+        end
 
-      def self.default_executor
-        @default_executor ||= begin
-          Class.new(ApplicationJob) do
-            def self.perform_later(instance, method, *args)
-              instance.public_send(method, *args)
+        def default_executor
+          @default_executor ||= begin
+            Class.new(ApplicationJob) do
+              def perform_later(instance, method, *args)
+                instance.public_send(method, *args)
+              end
             end
           end
         end

data/lib/anachronic/override.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Anachronic
+  # Takes over a method and renames original method for later use
+  module Override
+    def async(method_name)
+      new_name = "anachronic__#{method_name}".to_sym
+      alias_method new_name, method_name
+
+      undef_method method_name
+
+      define_method(method_name) do |*args|
+        BackgroundExecutor.call(self, new_name, *args)
+      end
+    end
+  end
+end

data/lib/anachronic/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Anachronic
-  VERSION = '0.42.7'
+  VERSION = '0.43.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: anachronic
 version: !ruby/object:Gem::Version
-  version: 0.42.7
+  version: 0.43.0
 platform: ruby
 authors:
 - Danielius Visockas
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-08-10 00:00:00.000000000 Z
+date: 2020-12-27 00:00:00.000000000 Z
 dependencies: []
 description: Removing boilerplate from async code
 email:
@@ -32,8 +32,10 @@ files:
 - bin/setup
 - lib/anachronic.rb
 - lib/anachronic/background_executor.rb
+- lib/anachronic/configuration.rb
 - lib/anachronic/error.rb
 - lib/anachronic/executors/application_job.rb
+- lib/anachronic/override.rb
 - lib/anachronic/version.rb
 homepage: https://github.com/dvisockas/anachronic
 licenses:
@@ -58,8 +60,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.8
+rubygems_version: 3.1.4
 signing_key: 
 specification_version: 4
 summary: Moving your method execution to the world of asynchronity