activefunction 0.3.5 → 0.4.1

data/lib/active_function.rb

@@ -1,12 +1,63 @@
 # frozen_string_literal: true
 
 require "active_function_core"
+require "active_function/version"
+require "active_function/base"
 
 RubyNext::Language.setup_gem_load_path(transpile: true)
 
 module ActiveFunction
-  class Error < StandardError; end
+  class << self
+    # Configure ActiveFunction through DSL method calls.
+    # Setups {ActiveFunction::Base} with provided internal and custom plugins.
+    # Also freezes plugins and {ActiveFunction::Base}.
+    #
+    # @example
+    #  ActiveFunction.config do
+    #    plugin :callbacks
+    #  end
+    #
+    # @param block [Proc] class_eval'ed block in ActiveFunction module.
+    # @return [void]
+    def config(&block)
+      class_eval(&block)
+      @_plugins.freeze
+      self::Base.freeze
+    end
 
-  require "active_function/version"
-  require "active_function/base"
+    # List of registered internal plugins.
+    def plugins = @_plugins ||= {}
+
+    # Register internal Symbol'ed plugin.
+    #
+    # @param [Symbol] symbol name of internal plugin,
+    #   should match file name in ./lib/active_function/functions/*.rb
+    # @param [Module] mod module to register.
+    def register_plugin(symbol, mod)
+      plugins[symbol] = mod
+    end
+
+    # Add plugin to ActiveFunction::Base.
+    #
+    # @example
+    #  ActiveFunction.plugin :callbacks
+    #  ActiveFunction.plugin CustomPlugin
+    #
+    # @param [Symbol, Module] mod
+    # @return [void]
+    def plugin(mod)
+      if mod.is_a? Symbol
+        begin
+          require "active_function/functions/#{mod}"
+          mod = plugins.fetch(mod)
+        rescue LoadError
+          raise ArgumentError, "Unknown plugin #{mod}"
+        end
+      end
+
+      self::Base.include(mod)
+    end
+  end
+
+  plugin :response
 end

metadata

@@ -1,43 +1,57 @@
 --- !ruby/object:Gem::Specification
 name: activefunction
 version: !ruby/object:Gem::Version
-  version: 0.3.5
+  version: 0.4.1
 platform: ruby
 authors:
 - Nerbyk
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-08-20 00:00:00.000000000 Z
+date: 2024-01-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activefunction-core
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.0.1
+        version: 0.2.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.0.1
+        version: 0.2.2
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: ruby-next
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -66,11 +80,30 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 1.4.3
-description: "\n    rails/action_controller like gem which provides lightweight callbacks,\n
-  \   strong parameters & rendering features. It's designed to be used with\n    AWS
-  Lambda functions, but can be also used with any Ruby application.\n\n    Implemented
-  with some of ruby 3.x features, but also supports\n    ruby 2.6.x thanks to RubyNext
-  transpiler. Type safety achieved\n    by RBS and Steep.\n  "
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+description: "\n    ActiveFunction is a collection of gems designed to be used with
+  Function as a Service (FaaS) computing instances. Inspired by aws-sdk v3 gem structure
+  and rails/activesupport.\n\n    Features:\n    - Ruby Version Compatibility: Implemented
+  with most of Ruby 3.2+ features, with support for Ruby versions >= 2.6 through the
+  RubyNext transpiler (CI'ed).\n    - Type Safety: Achieves type safety through the
+  use of RBS and Steep (CI'ed) [Note: disabled due to the presence of Ruby::UnsupportedSyntax
+  errors].\n    - Plugins System: Provides a simple Plugin system inspired by Polishing
+  Ruby Programming by Jeremy Evans to load gem plugins and self-defined plugins.\n
+  \   - Gem Collection: Offers a collection of gems designed for use within ActiveFunction
+  or as standalone components.\n  "
 email:
 - danil.maximov2000@gmail.com
 executables: []
@@ -80,18 +113,14 @@ files:
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
-- bin/console
-- bin/rake
-- bin/rubocop
-- bin/ruby-next
-- bin/setup
 - lib/.rbnext/2.7/active_function/functions/strong_parameters.rb
-- lib/.rbnext/3.0/active_function/functions/core.rb
+- lib/.rbnext/3.0/active_function.rb
+- lib/.rbnext/3.0/active_function/base.rb
 - lib/.rbnext/3.0/active_function/functions/response.rb
+- lib/.rbnext/3.1/active_function/functions/response.rb
 - lib/active_function.rb
 - lib/active_function/base.rb
 - lib/active_function/functions/callbacks.rb
-- lib/active_function/functions/core.rb
 - lib/active_function/functions/rendering.rb
 - lib/active_function/functions/response.rb
 - lib/active_function/functions/strong_parameters.rb
@@ -105,7 +134,7 @@ metadata:
   homepage_uri: https://github.com/DanilMaximov/activefunction
   source_code_uri: https://github.com/DanilMaximov/activefunction
   changelog_uri: https://github.com/DanilMaximov/activefunction/CHANGELOG.md
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -120,9 +149,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
-signing_key:
+rubygems_version: 3.5.4
+signing_key: 
 specification_version: 4
-summary: rails/action_controller like gem which provides callbacks, strong parameters
-  & rendering features.
+summary: Playground gem for Ruby 3.2+ features and more, designed for FaaS computing
+  instances, but mostly used for experiments.
 test_files: []

data/bin/console

@@ -1,15 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require "bundler/setup"
-require "active_function"
-
-# 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.
-
-# (If you use this, don't forget to add pry to your Gemfile!)
-# require "pry"
-# Pry.start
-
-require "irb"
-IRB.start(__FILE__)

data/bin/rake

@@ -1,27 +0,0 @@
-#!/usr/bin/env ruby
-# 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) =~ /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/rubocop

@@ -1,27 +0,0 @@
-#!/usr/bin/env ruby
-# 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-next

@@ -1,16 +0,0 @@
-#!/usr/bin/env ruby
-
-lib_path = File.expand_path("../lib", __dir__)
-$LOAD_PATH.unshift(lib_path) unless $LOAD_PATH.include?(lib_path)
-
-require "ruby-next/cli"
-
-begin
-  cli = RubyNext::CLI.new
-  cli.run(ARGV)
-rescue => e
-  raise e if $DEBUG
-  STDERR.puts e.message
-  STDERR.puts e.backtrace.join("\n") if ENV["RUBY_NEXT_DEBUG"] == "1"
-  exit 1
-end

data/bin/setup

@@ -1,8 +0,0 @@
-#!/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/lib/.rbnext/3.0/active_function/functions/core.rb

@@ -1,49 +0,0 @@
-# frozen_string_literal: true
-
-module ActiveFunction
-  class MissingRouteMethod < Error
-    MESSAGE_TEMPLATE = "Missing function route: %s"
-
-    attr_reader :message
-
-    def initialize(context)
-      @message = MESSAGE_TEMPLATE % context
-    end
-  end
-
-  class NotRenderedError < Error
-    MESSAGE_TEMPLATE = "render was not called: %s"
-
-    attr_reader :message
-
-    def initialize(context)
-      @message = MESSAGE_TEMPLATE % context
-    end
-  end
-
-  module Functions
-    module Core
-      attr_reader :action_name, :request, :response
-
-      def dispatch(action_name, request, response)
-        @action_name = action_name
-        @request     = request
-        @response    = response
-
-        raise MissingRouteMethod, @action_name unless respond_to?(action_name)
-
-        process(@action_name)
-
-        raise NotRenderedError, @action_name unless performed?
-
-        @response.to_h
-      end
-
-      private
-
-      def process(action) ;  public_send(action); end
-
-      def performed? ;  @response.committed?; end
-    end
-  end
-end

data/lib/active_function/functions/core.rb

@@ -1,49 +0,0 @@
-# frozen_string_literal: true
-
-module ActiveFunction
-  class MissingRouteMethod < Error
-    MESSAGE_TEMPLATE = "Missing function route: %s"
-
-    attr_reader :message
-
-    def initialize(context)
-      @message = MESSAGE_TEMPLATE % context
-    end
-  end
-
-  class NotRenderedError < Error
-    MESSAGE_TEMPLATE = "render was not called: %s"
-
-    attr_reader :message
-
-    def initialize(context)
-      @message = MESSAGE_TEMPLATE % context
-    end
-  end
-
-  module Functions
-    module Core
-      attr_reader :action_name, :request, :response
-
-      def dispatch(action_name, request, response)
-        @action_name = action_name
-        @request     = request
-        @response    = response
-
-        raise MissingRouteMethod, @action_name unless respond_to?(action_name)
-
-        process(@action_name)
-
-        raise NotRenderedError, @action_name unless performed?
-
-        @response.to_h
-      end
-
-      private
-
-      def process(action) = public_send(action)
-
-      def performed? = @response.committed?
-    end
-  end
-end