smart_core 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b7867022eeaee9e4538e85a8daa448b0906cae19bf54bdeb1d527699de3934d3
-  data.tar.gz: ba755bf600dfd06a1cf82f318dc48a5e6ed1955e703073757ca35ecba711d803
+  metadata.gz: 19dd6183688e0576100f7178ad66764ca76d1461c459eaeb239815c1b75a2d30
+  data.tar.gz: 34419b8bac8cc0e409c823282320fadf14f562225a5c4dd62545c4270b298919
 SHA512:
-  metadata.gz: 745b23e80f8eaa5799cc538ee470f6fcd8bea122fe421b1baf719655f33c0fba4b838f5a985f5a3180247aa5e1b0f07e7e16266c1b0ac0ac22ce975fc336db06
-  data.tar.gz: 70de948e0cc48516091af87cf194ed2564544c3d2586aaee5d7c97daaee96eee593a1426102461c36d76bd1add72ceb4bd1557b2746084ede695beccefdaef71
+  metadata.gz: '06718cef684bec320e3fa67d83e9486df6c991571fcabe6fad48a2a7063f554499e46a7c231bc37edb8dcb2325daf9004ae293f3e736e85f73a6eb6c791d7a74'
+  data.tar.gz: d13ec368c4bed72a132f1de1963c322383e8ad7d5168c3da188a13b649f7ec1cc27da080cc917b0c5c30c344436847229dd7bf92b429d6cd499dc77557274070

data/.rspec

@@ -1,3 +1,3 @@
+--format documentation
 --color
---format progress
 --require spec_helper

data/.rubocop.yml

@@ -5,7 +5,7 @@ inherit_gem:
 
 AllCops:
   UseCache: true
-  TargetRubyVersion: 2.6.3
+  TargetRubyVersion: 2.6.5
   Include:
     - bin/console
     - lib/**/*.rb

data/.travis.yml

@@ -1,20 +1,17 @@
 language: ruby
 sudo: false
-before_install: gem install bundler
 cache: bundler
+before_install: gem install bundler
+script: bundle exec rspec
 matrix:
   fast_finish: true
   include:
   - rvm: 2.3.8
-  - rvm: 2.4.7
-  - rvm: 2.5.6
-  - rvm: 2.6.4
+  - rvm: 2.4.9
+  - rvm: 2.5.7
+  - rvm: 2.6.5
   - rvm: ruby-head
   - rvm: jruby-head
   allow_failures:
   - rvm: ruby-head
   - rvm: jruby-head
-script: bundle exec rspec
-notifications:
-  slack:
-    secure: CUM3xnSJvn/y6Z+epQrO5uSk1EUuP4S+ugcS+48nlWD6eEzhYZwcBAK9tvD6kYGOPzoWyKSbW6Is1kzSunNr6f8ICc8HtrVHzoHE8UCzwZ7FpjgD0JgMgC4+xLLBO6lV0Hc7dNh4KLAhy4Zvbr09DPjcG8UW9/QgUdn+wBf9LHMgA+2SpBPEzMwz6pMbWW/+kkoCz2KU877kEfuFFGfvoOEFWTxUUhuCYi5a1SmTjm9A7CFTEWNkX8yHJwdgVgONjvm9lnhTeV0DvMeEOhk8Kx/hzQ2OGIicXZXWyZFkzNzpQm5xE12Hs4rY7mGPbo3bsYRDH9Ys6yf4fpNf0oZ/1agzl/gnDzacA2wL2b+eq1uZblE/fdwrNp+GIH0R+Ec2rsVKM7kh71sA6Xp1pzFb2DnHj5O4QFaPMsLyIZqD0BkVt4pNfwi4ZUB56sWkYeRQGm8x2Beh02IyFfxI65lY5kZrW6GjXx5eFeOHcmzQzeADWLSBf4iw01G/A/QqwZzlZ3fm0fRJi8BKDh3Jj0IrGndE9Bl+E7uOClKKngTPxOVLOLo/vY5mfI8M94f99kr0J45XkoAdc0SQfi3hDa/tHaakI5GJsmByjgOQwV7OU/2wzJoXAg/RPYjsYcwnTgzm9bLXPhQzfM8rUS5vLTOWIW+N0QKmWml7eWVtiedcwXA=

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 # Changelog
 All notable changes to this project will be documented in this file.
 
+## [0.7.0] - 2019-11-10
+### Changed
+- `SmartCore::Operation::Custom` result type is renamed to `SmartCore::Operation::Callback`;
+- Full reimplementation of `SmartCore::Container`;
+
 ## [0.6.0] - 2019-09-18
 ### Added
 - New result type: `SmartCore::Operation::Custom` with custom logic provided as a proc;

data/README.md

@@ -1,4 +1,4 @@
-# SmartCore · [![Gem Version](https://badge.fury.io/rb/smart_core.svg)](https://badge.fury.io/rb/smart_core) [![Build Status](https://travis-ci.org/0exp/smart_core.svg?branch=master)](https://travis-ci.org/0exp/smart_core) [![Coverage Status](https://coveralls.io/repos/github/0exp/smart_core/badge.svg?branch=master)](https://coveralls.io/github/0exp/smart_core?branch=master)
+# SmartCore · [![Gem Version](https://badge.fury.io/rb/smart_core.svg)](https://badge.fury.io/rb/smart_core) [![Build Status](https://travis-ci.org/0exp/smart_core.svg?branch=master)](https://travis-ci.org/0exp/smart_core)
 
 In active development (**Coming Soon**: Powerful documentaion :))
 > Meetup Slides: [link](docs/SmartCore.pdf)
@@ -26,10 +26,20 @@ require 'smart_core'
 #### Completed abstractions:
 
 - Service Object (Operation, Functional Object);
+- IoC Container (Dependency Container);
 - Initializer (DSL);
 - Validator (Validation Layer);
-- Dependency Container;
-- (Soon) Schema;
+
+---
+
+#### Roadmap
+
+- Value Object (`SmartCore::ValueObject` (`DTO`) (truely immutable and comparable objects 😈));
+- Schema Structure Validator (`SmartCore::Schema`);
+- Saga (`SmartCore::Saga`);
+- External Type System (`SmartCore::Types`);
+- Step-like execution behavior for `SmartCore::Operation` (`.step`);
+- Automatic result instantiation and handling for `SmartCore::Operation`;
 
 ---
 
@@ -37,7 +47,7 @@ require 'smart_core'
 
 - Fork it ( https://github.com/0exp/smart_core/fork )
 - Create your feature branch (`git checkout -b feature/my-new-feature`)
-- Commit your changes (`git commit -am 'Add some feature'`)
+- Commit your changes (`git commit -am '[feature_context] Add some feature'`)
 - Push to the branch (`git push origin feature/my-new-feature`)
 - Create new Pull Request
 

data/lib/smart_core.rb

@@ -4,9 +4,9 @@
 # @since 0.1.0
 module SmartCore
   require_relative 'smart_core/version'
-  require_relative 'smart_core/exceptions'
-  require_relative 'smart_core/initializer'
+  require_relative 'smart_core/errors'
   require_relative 'smart_core/container'
+  require_relative 'smart_core/initializer'
   require_relative 'smart_core/injector'
   require_relative 'smart_core/validator'
   require_relative 'smart_core/operation'

data/lib/smart_core/container.rb

@@ -1,123 +1,116 @@
 # frozen_string_literal: true
 
 # @api public
-# @since 0.5.0
+# @since 0.1.0
 class SmartCore::Container
-  require_relative 'container/exceptions'
-  require_relative 'container/commands'
-  require_relative 'container/command_set'
+  require_relative 'container/errors'
+  require_relative 'container/arbitary_lock'
   require_relative 'container/key_guard'
-  require_relative 'container/entity'
-  require_relative 'container/dependency'
-  require_relative 'container/memoized_dependency'
-  require_relative 'container/namespace'
-  require_relative 'container/dependency_builder'
+  require_relative 'container/entities'
+  require_relative 'container/definition_dsl'
+  require_relative 'container/dependency_compatability'
   require_relative 'container/registry'
   require_relative 'container/registry_builder'
-  require_relative 'container/dependency_compatability'
   require_relative 'container/dependency_resolver'
-  require_relative 'container/definition_dsl'
   require_relative 'container/mixin'
 
-  # TODO: container composition
-  # TODO: #merge / #merge!
-
-  # @since 0.5.0
+  # @since 0.1.0
   include DefinitionDSL
 
   # @return [void]
   #
   # @api public
-  # @since 0.5.0
+  # @since 0.1.0
   def initialize
-    build_registry
-    @access_lock = Mutex.new
+    build_registry!
+    @access_lock = ArbitaryLock.new
   end
 
   # @param dependency_name [String, Symbol]
-  # @param options [Hash<Symbol,Any>]
   # @param dependency_definition [Block]
   # @return [void]
   #
-  # @todo option list
-  #
   # @api public
-  # @since 0.5.0
-  def register(dependency_name, **options, &dependency_definition)
-    thread_safe do
-      registry.register(dependency_name, **options, &dependency_definition)
-    end
+  # @sicne 0.1.0
+  def register(dependency_name, &dependency_definition)
+    thread_safe { registry.register_dependency(dependency_name, &dependency_definition) }
   end
 
+  # @param namespace_name [String, Symbol]
+  # @param dependencies_definition [Block]
   # @return [void]
   #
   # @api public
-  # @since 0.5.0
-  def freeze
-    thread_safe { registry.freeze }
+  # @since 0.1.0
+  def namespace(namespace_name, &dependencies_definition)
+    thread_safe { registry.register_namespace(namespace_name, &dependencies_definition) }
   end
 
-  # @return [Boolean]
+  # @param dependency_path [String, Symbol]
+  # @return [Any]
   #
   # @api public
-  # @since 0.5.0
-  def frozen?
-    thread_safe { registry.frozen? }
+  # @since 0.1.0
+  def resolve(dependency_path)
+    thread_safe { DependencyResolver.resolve(registry, dependency_path) }
   end
 
-  # @param namespace_name [String, Symbol]
-  # @param dependency_definitions [Block]
   # @return [void]
   #
   # @api public
-  # @since 0.5.0
-  def namespace(namespace_name, &dependency_definitions)
-    thread_safe do
-      registry.namespace(namespace_name, &dependency_definitions)
-    end
+  # @since 0.1.0
+  def freeze!
+    thread_safe { registry.freeze! }
   end
 
-  # @param dependency_path [String, Symbol]
-  # @return [Any]
+  # @return [Boolean]
   #
   # @api public
-  # @since 0.5.0
-  def resolve(dependency_path)
-    thread_safe do
-      DependencyResolver.resolve(registry, dependency_path)
-    end
+  # @since 0.1.0
+  def frozen?
+    thread_safe { registry.frozen? }
   end
 
   # @return [void]
   #
   # @api public
-  # @since 0.5.0
+  # @since 0.1.0
   def reload!
-    thread_safe { build_registry }
+    thread_safe { build_registry! }
+  end
+
+  # @return [Hash<String|Symbol,SmartCore::Container::Entities::Base|Any>]
+  #
+  # @api public
+  # @since 0.1.0
+  def hash_tree(resolve_dependencies: false)
+    thread_safe { registry.hash_tree(resolve_dependencies: resolve_dependencies) }
   end
+  alias_method :to_h, :hash_tree
+  alias_method :to_hash, :hash_tree
 
   private
 
   # @return [SmartCore::Container::Registry]
   #
   # @api private
-  # @since 0.5.0
+  # @since 0.1.0
   attr_reader :registry
 
   # @return [void]
   #
   # @api private
-  # @since 0.5.0
-  def build_registry
-    @registry = RegistryBuilder.build(self.class.__commands__)
+  # @since 0.1.0
+  def build_registry!
+    @registry = RegistryBuilder.build(self)
   end
 
-  # @param block [Proc]
+  # @param block [Block]
   # @return [Any]
   #
   # @api private
-  # @since 0.5.0
+  # @since 0.1.0
   def thread_safe(&block)
-    @access_lock.synchronize(&block)
+    @access_lock.thread_safe(&block)
   end
 end

data/lib/smart_core/container/arbitary_lock.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.7.0
+class SmartCore::Container::ArbitaryLock
+  # @return [void]
+  #
+  # @api private
+  # @since 0.7.0
+  def initialize
+    @lock = Mutex.new
+  end
+
+  # @param block [Proc]
+  # @return [Any]
+  #
+  # @api private
+  # @since 0.7.0
+  def thread_safe(&block)
+    @lock.owned? ? yield : @lock.synchronize(&block)
+  end
+end

data/lib/smart_core/container/definition_dsl.rb

@@ -1,66 +1,116 @@
 # frozen_string_literal: true
 
-# @api private
-# @since 0.5.0
-module SmartCore::Container::DefinitionDSL
-  class << self
-    # @param base_klass [Class<SmartCore::Container>]
-    # @return [void]
-    #
-    # @api private
-    # @since 0.5.0
-    def included(base_klass)
-      base_klass.instance_variable_set(:@__commands__, SmartCore::Container::CommandSet.new)
-      base_klass.singleton_class.send(:attr_reader, :__commands__)
-      base_klass.extend(ClassMethods)
-      base_klass.singleton_class.prepend(ClassInheritance)
+class SmartCore::Container
+  # @api private
+  # @since 0.7.0
+  module DefinitionDSL
+    require_relative 'definition_dsl/commands'
+    require_relative 'definition_dsl/command_set'
+
+    class << self
+      # @param base_klass [Class<SmartCore::Container>]
+      # @return [void]
+      #
+      # @api private
+      # @since 0.7.0
+      def included(base_klass)
+        base_klass.instance_variable_set(:@__container_definition_commands__, CommandSet.new)
+        base_klass.instance_variable_set(:@__container_instantiation_commands__, CommandSet.new)
+        base_klass.instance_variable_set(:@__container_definition_lock__, ArbitaryLock.new)
+        base_klass.singleton_class.send(:attr_reader, :__container_definition_commands__)
+        base_klass.singleton_class.send(:attr_reader, :__container_instantiation_commands__)
+        base_klass.extend(ClassMethods)
+        base_klass.singleton_class.prepend(ClassInheritance)
+      end
     end
-  end
 
-  # @api private
-  # @since 0.5.0
-  module ClassInheritance
-    # @param child_klass [Class<SmartCore::Container>]
-    # @return [void]
-    #
     # @api private
-    # @since 0.5.0
-    def inherited(child_klass)
-      child_klass.instance_variable_set(:@__commands__, SmartCore::Container::CommandSet.new)
-      child_klass.__commands__.concat(__commands__)
-      child_klass.singleton_class.prepend(ClassInheritance)
-      super
-    end
-  end
+    # @since 0.7.0
+    module ClassInheritance
+      # @param child_klass [Class<SmartCore::Container>]
+      # @return [void]
+      #
+      # @api private
+      # @since 0.7.0
+      def inherited(child_klass)
+        child_klass.instance_variable_set(:@__container_definition_commands__, CommandSet.new)
+        child_klass.instance_variable_set(:@__container_instantiation_commands__, CommandSet.new)
+        child_klass.instance_variable_set(:@__container_definition_lock__, ArbitaryLock.new)
 
-  # @api private
-  # @since 0.5.0
-  module ClassMethods
-    # @param namespace_name [String, Symbol]
-    # @param dependency_definitions [Block]
-    # @return [void]
-    #
-    # @api public
-    # @since 0.5.0
-    def namespace(namespace_name, &dependency_definitions)
-      __commands__ << SmartCore::Container::Commands::Namespace.new(
-        namespace_name, dependency_definitions
-      )
+        child_klass.__container_definition_commands__.concat(
+          __container_definition_commands__
+        )
+
+        child_klass.__container_instantiation_commands__.concat(
+          __container_instantiation_commands__
+        )
+
+        child_klass.singleton_class.prepend(ClassInheritance)
+        super
+      end
     end
 
-    # @param dependency_name [String, Symbol]
-    # @param options [Hash<Symbol,Any>]
-    # @param dependency_definition [Proc]
-    # @return [void]
-    #
-    # @todo option list
-    #
-    # @api public
-    # @since 0.5.0
-    def register(dependency_name, **options, &dependency_definition)
-      __commands__ << SmartCore::Container::Commands::Register.new(
-        dependency_name, dependency_definition, **options
-      )
+    # @api private
+    # @since 0.7.0
+    module ClassMethods
+      # @param namespace_name [String, Symbol]
+      # @param dependencies_definition [Block]
+      # @return [void]
+      #
+      # @api public
+      # @since 0.7.0
+      def namespace(namespace_name, &dependencies_definition)
+        @__container_definition_lock__.thread_safe do
+          DependencyCompatability::Definition.prevent_dependency_overlap!(self, namespace_name)
+
+          __container_definition_commands__ << Commands::Definition::Namespace.new(
+            namespace_name, dependencies_definition
+          )
+        end
+      end
+
+      # @param dependency_name [String, Symbol]
+      # @param dependency_definition [Block]
+      # @return [void]
+      #
+      # @api public
+      # @since 0.7.0
+      def register(dependency_name, &dependency_definition)
+        @__container_definition_lock__.thread_safe do
+          DependencyCompatability::Definition.prevent_namespace_overlap!(self, dependency_name)
+
+          __container_definition_commands__ << Commands::Definition::Register.new(
+            dependency_name, dependency_definition
+          )
+        end
+      end
+
+      # @param container_klass [Class<SmartCore::Container>]
+      # @return [void]
+      #
+      # @api public
+      # @since 0.7.0
+      def compose(container_klass)
+        @__container_definition_lock__.thread_safe do
+          __container_definition_commands__ << Commands::Definition::Compose.new(
+            container_klass
+          )
+
+          __container_instantiation_commands__ << Commands::Instantiation::Compose.new(
+            container_klass
+          )
+        end
+      end
+
+      # @return [void]
+      #
+      # @api public
+      # @since 0.7.0
+      def freeze_state!
+        @__container_definition_lock__.thread_safe do
+          __container_instantiation_commands__ << Commands::Instantiation::FreezeState.new
+        end
+      end
     end
   end
 end