thunderchunk 0.2.0

data/lib/thunderchunk/registries/base.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module ThunderChunk
+  class Registries
+    class Base
+      def self.kind(value = nil)
+        return @kind = value if value
+
+        @kind || raise(NotImplementedError, "#{name} must declare `kind`")
+      end
+
+      def self.path(value = nil)
+        return @path = value if value
+
+        @path || @kind.to_s.pluralize || raise(NotImplementedError, "#{name} must declare `kind` or `path`")
+      end
+
+      def initialize(chunk)
+        @chunk = chunk
+        @items = {}
+        @loader = Loader.new(@chunk.name, @chunk.root_path)
+      end
+
+      attr_reader :items
+
+      def add_constant(constant)
+        return false unless constant.is_a?(Class)
+
+        key = key_for(constant)
+        return false unless key
+
+        add(key, constant)
+        true
+      end
+
+      def key_for(_constant)
+        raise NotImplementedError
+      end
+
+      def add(path, object)
+        @items[path] = object
+      end
+
+      def get(path)
+        @items[path]
+      end
+
+      def clear
+        @items.clear
+      end
+
+      def load
+        @items = {}
+
+        @loader.load(["app/internal/#{self.class.path}"])
+
+        @loader.each do |_parent, _name, constant|
+          add_constant(constant)
+        end
+
+        @loader.unload
+      end
+
+      private
+
+      def key_from_name(constant, *namespace)
+        segments = constant.name.split('::')
+        index = segments.each_index.find { |i| segments[i, namespace.size] == namespace }
+        return unless index
+
+        rest = segments.drop(index + namespace.size)
+        rest.map(&:underscore).join('.') unless rest.empty?
+      end
+    end
+  end
+end

data/lib/thunderchunk/registries/models.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module ThunderChunk
+  class Registries
+    class Models < Base
+      kind :model
+
+      def key_for(constant)
+        key_from_name(constant, 'Internal', 'Models')&.tap do |key|
+          unless constant < ThunderChunk::Model
+            raise RegistryRequirementError, "#{constant.name} must inherit from ThunderChunk::Model"
+          end
+        end
+      end
+
+      def add(path, object)
+        object.chunk_key = path
+        object.chunk_registry = self
+
+        # WARN: Test checkin that when is not a model class (dont respond to chunk key),
+        # raise error and dont save in registry
+        super
+      end
+    end
+  end
+end

data/lib/thunderchunk/registries/operations.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module ThunderChunk
+  class Registries
+    class Operations < Base
+      kind :operation
+
+      def key_for(constant)
+        key_from_name(constant, 'Internal', 'Operations')&.tap do |key|
+          unless constant < ThunderChunk::Operations::Internal
+            raise RegistryRequirementError, "#{constant.name} must inherit from ThunderChunk::Operations::Internal"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/thunderchunk/registry.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module ThunderChunk
+  class Registry
+    def initialize(chunk = nil)
+      @chunk = chunk
+      @registries = chunk.configuration['boot.registries'].to_h do |klass|
+        [klass.kind, klass.new(chunk)]
+      end
+    end
+
+    def load
+      @registries.each_value(&:load)
+    end
+
+    def unload
+      @registries.each_value(&:unload)
+    end
+
+    def hash
+      @registries.transform_values(&:items)
+    end
+
+    def get(kind, path)
+      @registries[kind.to_sym]&.get(path.to_s)
+    end
+
+    def get!(kind, path)
+      get(kind, path) || raise(Error, "#{kind} #{path} is not registered")
+    end
+
+    def each_constant(*, &)
+      hash.each_value do |items|
+        items.each_value(*, &)
+      end
+    end
+
+    def clear
+      @registries.each_value(&:clear)
+    end
+
+    def create_kind(registry)
+      kind = registry.class.kind
+
+      raise ArgumentError, 'This registry already has a kind' if @registries.has_value?(registry)
+      raise ArgumentError, 'This kind already has a registry' if @registries.has_key?(kind)
+
+      @registries[kind] = registry
+    end
+
+    def [](value)
+      hash[value]
+    end
+  end
+end

data/lib/thunderchunk/rubocop.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+# Entry point for `require: thunderchunk/rubocop` in a chunk's .rubocop.yml.
+require 'rubocop'
+
+require_relative '../rubocop/cop/thunderchunk/restricted_access'

data/lib/thunderchunk/sender_dock.rb

@@ -0,0 +1,49 @@
+module ThunderChunk
+  class SenderDock
+    # WARN: AI MADE
+    class << self
+      attr_accessor :resolver
+    end
+    # WARN: ---
+
+    def initialize(chunk)
+      @chunk = chunk
+      @senders = Hash.new { |a, k| a[k] = {} }
+    end
+
+    def sender_for(chunk_identifier, wire)
+      get(chunk_identifier, wire) || begin
+        remote = "remotes.chunk.#{chunk_identifier}.external_import.#{wire}"
+        url = @chunk.config["#{remote}.url"]
+
+        raise(Error, "Remote #{chunk_identifier} does not set a configured url") if url.blank?
+
+        protocol = @chunk.config["#{remote}.protocol"] || :http
+        sender_class = load_class(wire, protocol)
+
+        set(chunk_identifier, wire, sender_class.new(chunk_identifier, url))
+      end
+    end
+
+    private
+
+    def get(chunk_identifier, wire)
+      @senders.dig(
+        wire.to_s.underscore.to_sym,
+        chunk_identifier.to_s.underscore.to_sym
+      )
+    end
+
+    def set(chunk_identifier, wire, sender)
+      @senders[wire.to_s.underscore.to_sym][chunk_identifier.to_s.underscore.to_sym] = sender
+    end
+
+    # WARN: AI MADE
+    def load_class(wire, protocol)
+      resolver = self.class.resolver || raise(Error, "no sender for #{protocol} #{wire}: require 'thunderwire'")
+
+      resolver.call(protocol, wire)
+    end
+    # WARN: ---
+  end
+end

data/lib/thunderchunk/type_names.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+# WARN: AI MADE
+module ThunderChunk
+  # Types written by name in params and returns (`param :supplier, 'Models::Supplier'`), resolved at boot to the
+  # models the chunk registered: a class body cannot reach a model by constant before `use` injects it, and a name
+  # keeps the class the registry holds. 'Models::Supplier::Relation' is the class of Supplier.all.
+  module TypeNames
+    module_function
+
+    def resolve(chunk, klass)
+      parameters = [
+        (klass.base_parameter if klass.respond_to?(:base_parameter)),
+        (klass.returns if klass.respond_to?(:returns))
+      ]
+      parameters.grep(ThunderOperation::Parameters::Base).each do |parameter|
+        parameter.resolve_types! { |name| model_for(chunk, klass, name) }
+      end
+    end
+
+    def model_for(chunk, klass, name)
+      segments = name.delete_prefix('::').split('::')
+      relation = segments.last == 'Relation' && segments.size > 2 && segments.pop
+      unless segments.first == 'Models' && segments.size > 1
+        raise Error, "#{klass.name}: type '#{name}' must name a model of the chunk, as 'Models::Supplier'"
+      end
+
+      key = segments.drop(1).map(&:underscore).join('.')
+      model = chunk.registry.get(:model, key) ||
+              raise(Error, "#{klass.name}: type '#{name}' names no model; chunk #{chunk.identifier} has no model #{key}")
+
+      relation ? model.relation_delegate_class(ActiveRecord::Relation) : model
+    end
+  end
+end

data/lib/thunderchunk/usage_importer/kinds/model.rb

@@ -0,0 +1,14 @@
+
+# frozen_string_literal: true
+
+module ThunderChunk
+  module UsageImporter
+    module Kinds
+      class Model
+        def self.use(klass, path, options = {})
+          klass.
+        end
+      end
+    end
+  end
+end

data/lib/thunderchunk/usage_importer/use.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module ThunderChunk
+  module UsageImporter
+    module Use
+      module_function
+
+      def use(kind, key, options = {})
+        "UsageImporter::Kinds::#{kind.classify}".constantize.use(self)
+      end
+    end
+  end
+end

data/lib/thunderchunk/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module ThunderChunk
+  VERSION = '0.2.0'
+end

data/lib/thunderchunk.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+
+require 'active_support/all'
+require 'active_record'
+# WARN: AI MADE
+require 'console'
+# WARN: ---
+require 'thunderoperation'
+
+require_relative 'thunderchunk/version'
+
+# Manages a single chunk. Depends on thunderfoundation, never on thunderbolt.
+module ThunderChunk
+  class Error < StandardError; end
+
+  # A class sits in the folder of a registry but does not meet what that registry requires.
+  class RegistryRequirementError < Error; end
+
+  # A chunk file does not define the constant its path names.
+  class FileConstantMismatchError < Error; end
+end
+
+require_relative 'thunderchunk/configuration'
+require_relative 'thunderchunk/loader'
+require_relative 'thunderchunk/loader/namespace'
+require_relative 'thunderchunk/loader/load'
+require_relative 'thunderchunk/model'
+require_relative 'thunderchunk/outbox'
+require_relative 'thunderchunk/dependency'
+require_relative 'thunderchunk/dependency_injector'
+require_relative 'thunderchunk/operations/adapters/use_dependecy'
+require_relative 'thunderchunk/operations/base'
+require_relative 'thunderchunk/operations/internal'
+require_relative 'thunderchunk/operations/external'
+require_relative 'thunderchunk/operations/subscriber'
+require_relative 'thunderchunk/operation'
+require_relative 'thunderchunk/chunk'
+# WARN: AI MADE
+require_relative 'thunderchunk/type_names'
+require_relative 'thunderchunk/registries/base'
+require_relative 'thunderchunk/registries/models'
+require_relative 'thunderchunk/registries/operations'
+require_relative 'thunderchunk/registry'
+require_relative 'thunderchunk/database'
+require_relative 'thunderchunk/exporter'
+require_relative 'thunderchunk/exporters/base'
+require_relative 'thunderchunk/operations/remote'
+require_relative 'thunderchunk/event'
+require_relative 'thunderchunk/sender_dock'
+require_relative 'thunderchunk/external_importer'
+require_relative 'thunderchunk/external_importers/base'
+require_relative 'thunderchunk/external_importers/operations'
+require_relative 'thunderchunk/external_importers/events'
+
+
+ThunderOperation.config.transaction = lambda do |&block|
+  next block.call if ActiveRecord::Base.connection_handler.connection_pool_list.empty?
+
+  ActiveRecord::Base.transaction(&block)
+end

metadata

@@ -0,0 +1,132 @@
+--- !ruby/object:Gem::Specification
+name: thunderchunk
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Albert Alef
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.1'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.1'
+- !ruby/object:Gem::Dependency
+  name: console
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.29'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.29'
+- !ruby/object:Gem::Dependency
+  name: thunderoperation
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/rubocop/cop/thunderchunk/restricted_access.rb
+- lib/thunderchunk.rb
+- lib/thunderchunk/chunk.rb
+- lib/thunderchunk/configuration.rb
+- lib/thunderchunk/database.rb
+- lib/thunderchunk/default_configuration.rb
+- lib/thunderchunk/dependency.rb
+- lib/thunderchunk/dependency_injector.rb
+- lib/thunderchunk/event.rb
+- lib/thunderchunk/exporter.rb
+- lib/thunderchunk/exporters/base.rb
+- lib/thunderchunk/exporters/events.rb
+- lib/thunderchunk/exporters/operations.rb
+- lib/thunderchunk/external_importer.rb
+- lib/thunderchunk/external_importers/base.rb
+- lib/thunderchunk/external_importers/events.rb
+- lib/thunderchunk/external_importers/operations.rb
+- lib/thunderchunk/loader.rb
+- lib/thunderchunk/loader/load.rb
+- lib/thunderchunk/loader/namespace.rb
+- lib/thunderchunk/model.rb
+- lib/thunderchunk/operation.rb
+- lib/thunderchunk/operations/adapters/use_dependecy.rb
+- lib/thunderchunk/operations/base.rb
+- lib/thunderchunk/operations/external.rb
+- lib/thunderchunk/operations/internal.rb
+- lib/thunderchunk/operations/remote.rb
+- lib/thunderchunk/operations/subscriber.rb
+- lib/thunderchunk/outbox.rb
+- lib/thunderchunk/registries/base.rb
+- lib/thunderchunk/registries/models.rb
+- lib/thunderchunk/registries/operations.rb
+- lib/thunderchunk/registry.rb
+- lib/thunderchunk/rubocop.rb
+- lib/thunderchunk/sender_dock.rb
+- lib/thunderchunk/type_names.rb
+- lib/thunderchunk/usage_importer/kinds/model.rb
+- lib/thunderchunk/usage_importer/use.rb
+- lib/thunderchunk/version.rb
+licenses: []
+metadata:
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.4'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: 'Manages a chunk: operations engine, surfaces, schema and migrations'
+test_files: []