anachronic 0.42.2 → 0.43.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 324d2c9426f10fa8877399b5de9f2c4e8a2786e68aea018ceda2577ed5c9e023
-  data.tar.gz: f9a0e10c27f49c5a6f19dc07fad6194b4f45d5af676943f1bd57c77fb761f05e
+  metadata.gz: 258ec036a2fdc3a3ef100b6e77b9db95f09b640138297cdefe8eb8120cb18bc7
+  data.tar.gz: f71aa8121e0a373044026d82b3ea654c67f47816aaca3645a99df8cfcac6d941
 SHA512:
-  metadata.gz: '0953f4299299681079a375c4b8cb0bc1ccf02f5cc38a0fbc7135043ea1af9dc7e88a694c51f07dd75d7af641a343c266a181eac4915e969ab88bae2143d63811'
-  data.tar.gz: 82fa513525cd19a4ddbc934eeff5ee59f22db3fbbf4d2df24a07b8f4b539b5a2642732b0c39705195d003c375e11c007526ebc32c7175603192d0080448fa884
+  metadata.gz: 707d67121db58d16bfd44f504ebfd7d5ee234cab4824d1e42d71ede2cbe96649898c21404f8e21480e0d0a1a8f02a3415e214f2fffd03cde9b7ccd2ca1364e6f
+  data.tar.gz: 461deb146099ef7e3f97b9369be8f66229bd3503acc9fc6391257decc123f7d14c9626bd4bef291529ec33403bd6d278934166b427625f3d1d365003fe041c32

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    anachronic (0.42.2)
+    anachronic (0.43.0)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -24,6 +24,8 @@ HumanJob.perform_later(Human.new)
 ### You can now write:
 ```ruby
 class Human
+  extend Anachronic
+
   async def speak
     puts('Truth!')
   end
@@ -48,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
 
@@ -70,3 +84,6 @@ The gem is available as open source under the terms of the [MIT License](https:/
 ## Code of Conduct
 
 Everyone interacting in the Anachronic project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/dvisockas/anachronic/blob/master/CODE_OF_CONDUCT.md).
+
+## Inspired by
+- [Memoist](https://github.com/matthewrudy/memoist)

data/lib/anachronic.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require 'anachronic/version'
+require 'anachronic/background_executor'
+require 'anachronic/error'
+require 'anachronic/override'
+require 'anachronic/configuration'
+
+module Anachronic
+  include Override
+  include Configuration
+end

data/lib/anachronic/background_executor.rb

@@ -3,6 +3,7 @@
 require_relative './error.rb'
 
 module Anachronic
+  # Class for deciding a background execution backend
   class BackgroundExecutor
     class << self
       def call(instance, method, *args)
@@ -15,14 +16,18 @@ module Anachronic
 
       def executor
         @executor ||= begin
-          return Executors::ApplicationJob if defined?(ApplicationJob)
-          return Executors::ApplicationJob if defined?(Sidekiq)
-          return Executors::Resque if defined?(Resque)
+          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
 
+      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

@@ -1,13 +1,15 @@
 # frozen_string_literal: true
 
 module Anachronic
-    module Executors
-      class ApplicationJob
-        def self.call(instance, method, *args)
+  module Executors
+    # Default executor for ApplicationJob backend
+    class ApplicationJob
+      class << self
+        def call(instance, method, *args)
           default_executor.perform_later(instance, method, *args)
         end
 
-        def self.default_executor
+        def default_executor
           @default_executor ||= begin
             Class.new(ApplicationJob) do
               def perform_later(instance, method, *args)

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,3 +1,5 @@
+# frozen_string_literal: true
+
 module Anachronic
-  VERSION = '0.42.2'
+  VERSION = '0.43.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: anachronic
 version: !ruby/object:Gem::Version
-  version: 0.42.2
+  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:
@@ -30,11 +30,12 @@ files:
 - anachronic.gemspec
 - bin/console
 - bin/setup
-- lib/.keep
-- lib/anachronic/anachronic.rb
+- 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:
@@ -59,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

data/lib/anachronic/anachronic.rb

@@ -1,16 +0,0 @@
-# frozen_string_literal: true
-
-require "anachronic/version"
-require "anachronic/background_executor"
-require "anachronic/error"
-
-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
-end