dry-component 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ee78e672954f38457a8469c522b169caff7433ae
+  data.tar.gz: 8b649eed1db04abef81ac6d0512f38bbafd26cb3
+SHA512:
+  metadata.gz: a0bf880fd5c645e2fa85c40061f66a9a8da31be70f0fadff877b15cccede26560215b52895fa9e1a443609f8db9dc587b00c821e1d75d0768675f98d28d978cd
+  data.tar.gz: 4ac3f8c0f089975e808736577bfb0e8fc3fcafebfeb6ca8ed440d4a060d9c2ef8eaadfc8801c3609e6991926bbd08fafc8fd4a9ce5aa4a55232f626f33a00843

data/.gitignore

@@ -0,0 +1,36 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+Gemfile.lock

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--require ./spec/spec_helper
+--order random

data/.rubocop.yml

@@ -0,0 +1,34 @@
+# Generated by `rubocop --auto-gen-config`
+inherit_from: .rubocop_todo.yml
+
+# No need to handle LoadError in spec helper
+Lint/HandleExceptions:
+  Exclude:
+    - spec/spec_helper.rb
+
+Style/FileName:
+  Exclude:
+    - 'lib/dry-component.rb'
+
+# Documentation checked by Inch CI
+Style/Documentation:
+  Enabled: false
+
+# Ain't nobody got time for that!
+Style/MethodCallParentheses:
+  Enabled: false
+
+Style/Lambda:
+  Enabled: false
+
+Style/BlockDelimiters:
+  Enabled: false
+
+Style/LambdaCall:
+  EnforcedStyle: braces
+
+Style/MultilineBlockChain:
+  Enabled: false
+
+Style/StabbyLambdaParentheses:
+  EnforcedStyle: require_no_parentheses

data/.rubocop_todo.yml

@@ -0,0 +1,26 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2015-12-23 21:42:26 +0000 using RuboCop version 0.35.1.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 1
+Metrics/AbcSize:
+  Max: 25
+
+# Offense count: 1
+# Configuration parameters: CountComments.
+Metrics/ClassLength:
+  Max: 130
+
+# Offense count: 1
+# Configuration parameters: AllowURI, URISchemes.
+Metrics/LineLength:
+  Max: 84
+
+# Offense count: 2
+# Configuration parameters: CountComments.
+Metrics/MethodLength:
+  Max: 14

data/.travis.yml

@@ -0,0 +1,26 @@
+language: ruby
+sudo: false
+cache: bundler
+bundler_args: --without tools
+script:
+  - bundle exec rake spec
+rvm:
+  - 2.0
+  - 2.1
+  - 2.2
+  - rbx-2
+  - jruby-9000
+  - ruby-head
+  - jruby-head
+matrix:
+  allow_failures:
+    - rvm: ruby-head
+    - rvm: jruby-head
+notifications:
+  email: false
+  webhooks:
+    urls:
+      - https://webhooks.gitter.im/e/19098b4253a72c9796db
+    on_success: change  # options: [always|never|change] default: always
+    on_failure: always  # options: [always|never|change] default: always
+    on_start: false     # default: false

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+# v0.0.1 2015-12-24
+
+First public release, extracted from rodakase project

data/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+
+gemspec
+
+gem 'codeclimate-test-reporter', platforms: :rbx
+
+group :tools do
+  gem 'byebug', platforms: :mri
+end

data/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Dryrb Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,218 @@
+# dry-component <a href="https://gitter.im/dryrb/chat" target="_blank">![Join the chat at https://gitter.im/dryrb/chat](https://badges.gitter.im/Join%20Chat.svg)</a>
+
+<a href="https://rubygems.org/gems/dry-component" target="_blank">![Gem Version](https://badge.fury.io/rb/dry-component.svg)</a>
+<a href="https://travis-ci.org/dryrb/dry-component" target="_blank">![Build Status](https://travis-ci.org/dryrb/dry-component.svg?branch=master)</a>
+<a href="https://gemnasium.com/dryrb/dry-component" target="_blank">![Dependency Status](https://gemnasium.com/dryrb/dry-component.svg)</a>
+<a href="https://codeclimate.com/github/dryrb/dry-component" target="_blank">![Code Climate](https://codeclimate.com/github/dryrb/dry-component/badges/gpa.svg)</a>
+<a href="http://inch-ci.org/github/dryrb/dry-component" target="_blank">![Documentation Status](http://inch-ci.org/github/dryrb/dry-component.svg?branch=master&style=flat)</a>
+
+Sane dependency management system allowing you to configure reusable components
+in any environment, set up their load-paths, require needed files and instantiate
+objects automatically with the ability to have them injected as dependencies.
+
+Originally built for [rodakase](https://github.com/solnic/rodakase) stack, now as
+a standalone, small library.
+
+This is a simple system that relies on very basic mechanisms provided by Ruby,
+specifically `require` and managing `$LOAD_PATH`. It does not rely on any magic
+like automatic const resolution, it's pretty much the opposite and forces you to
+be explicit about dependencies in your applications.
+
+It does a couple of things for you that are really not something you want to do
+yourself:
+
+* Provides an abstract dependency container implementation
+* Handles `$LOAD_PATH` configuration
+* Loads needed files using `require`
+* Resolves dependencies automatically
+* Supports auto-registration of dependencies via file/dir naming conventions
+* Provides support for custom configuration loaded from external sources (ie YAML)
+
+To put it all together, this allows you to configure your system in a way where
+you have full control over dependencies and it's very easy to draw the boundaries
+between individual components.
+
+This comes with a bunch of nice benefits:
+
+* Your system relies on abstractions rather than concrete classes and modules
+* It helps in decoupling your code from 3rd party code
+* It makes it possible to load components in complete isolation. In example you
+  can run a single test for a single component and only required files will be
+  loaded, or you can run a rake task and it will only load the things it needs.
+* It opens up doors for better instrumentation and debugging tools
+
+## Container
+
+Main API is the abstract container that you inherit from. It allows you to configure
+basic settings and exposes APIs for requiring files easily.
+
+Let's say you want to define an application container that will provide a logger:
+
+``` ruby
+require 'dry/component/container'
+
+class Application < Dry::Component::Container
+  configure do |config|
+    config.root = '/my/app'
+  end
+end
+
+# now you can register a logger
+require 'logger'
+Application.register('utils.logger', Logger.new($stdout))
+
+# and access it
+Application['utils.logger']
+```
+
+## Auto-Registration
+
+By using simple naming conventions we can automatically register objects within
+our container.
+
+Let's provide a custom logger object and put it under a custom load-path that we
+will configure:
+
+``` ruby
+require 'dry/component/container'
+
+class Application < Dry::Component::Container
+  configure do |config|
+    config.root = '/my/app'
+
+    # we set 'lib' relative to `root` as a path which contains class definitions
+    # that can be auto-registered
+    config.auto_register = 'lib'
+  end
+
+  # this alters $LOAD_PATH hence the `!`
+  load_paths!('lib')
+end
+
+# under /my/app/lib/logger.rb we put
+class Logger
+  # some neat logger implementation
+end
+
+# we can finalize the container which triggers auto-registration
+Application.finalize!
+
+# the logger becomes available
+Application['logger']
+```
+
+## Auto-Import Mechanism
+
+After defining a container, we can use its import module that will inject object
+dependencies automatically.
+
+Let's say we have an object that will need a logger:
+
+``` ruby
+# let's define an import module
+Import = Application.import_module
+
+# in a class definition you simply specify what it needs
+class PostPublisher
+  include Import['utils.logger']
+
+  def call(post)
+    # some stuff
+    logger.debug("post published: #{post}")
+  end
+end
+```
+
+## Directory Structure
+
+You need to provide a specific directory/file structure but names of directories
+are configurable. The default is as follows:
+
+```
+#{root}
+  |- core
+    |- boot
+      # arbitrary files that are automatically loaded on finalization
+```
+
+## Booting a Dependency
+
+In some cases a dependency can be huge, so huge it needs to load some additional
+files (often 3rd party code) and it may rely on custom configuration.
+
+Because of this reason `dry-component` has the concept of booting a dependency.
+
+The convention is pretty simple. You put files under `boot` directory and use
+your container to register dependencies with the ability to postpone finalization.
+This gives us a way to define what's needed but load it and boot it on demand.
+
+Here's a simple example:
+
+``` ruby
+# under /my/app/boot/heavy_dep.rb
+
+Application.finalize(:persistence) do
+  # some 3rd-party dependency
+  require '3rd-party/database'
+
+  container.register('database') do
+    # some code which initializes this thing
+  end
+end
+```
+
+After defining the finalization block our container will not call it until its
+own finalization. This means we can require file that defines our container
+and ask it to boot *just that one :persistence dependency*:
+
+``` ruby
+# under /my/app/boot/container.rb
+class Application < Dry::Component::Container
+  configure do |config|
+    config.root = '/my/app'
+  end
+end
+
+Application.boot!(:persistence)
+
+# and now `database` becomes available
+Application['database']
+```
+
+## Environment & Providing Arbitrary Options
+
+In most of the systems you need some kind of options for your runtime. Typically
+it's provided via ENV vars or a yaml file in development mode. `dry-component`
+has a built-in support for this.
+
+You can simply put a file under `#{root}/config/application.yml` and it will be
+loaded:
+
+``` yaml
+# /my/app/config/application.yml
+development:
+  foo: 'bar'
+```
+
+Now let's configure our container for a specific env:
+
+``` ruby
+class Application < Dry::Component::Container
+  configure('development') do |config|
+    config.root = '/my/app'
+  end
+end
+
+# now our application options are available
+Application.options.foo # => "bar"
+```
+
+## Underlying Tools
+
+`dry-component` uses [dry-container](https://github.com/dryrb/dry-container) and
+[dry-auto_inject](https://github.com/dryrb/dry-auto_inject) under the hood. These
+gems are very small and simple with a total 254LOC. Just saying.
+
+## LICENSE
+
+See `LICENSE` file.

data/Rakefile

@@ -0,0 +1,12 @@
+#!/usr/bin/env rake
+require 'bundler/gem_tasks'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), 'lib'))
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+
+task default: :spec
+
+desc 'Run all specs in spec directory'
+RSpec::Core::RakeTask.new(:spec)

data/dry-component.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+require File.expand_path('../lib/dry/component/version', __FILE__)
+
+Gem::Specification.new do |spec|
+  spec.name          = 'dry-component'
+  spec.version       = Dry::Component::VERSION
+  spec.authors       = ['Piotr Solnica']
+  spec.email         = ['piotr.solnica@gmail.com']
+  spec.summary       = 'Organize your code into reusable components'
+  spec.homepage      = 'https://github.com/dryrb/dry-component'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.add_runtime_dependency 'memoizable', '~> 0.4'
+  spec.add_runtime_dependency 'inflecto', '>= 0.0.2'
+  spec.add_runtime_dependency 'dry-container', '~> 0.2', '>= 0.2.7'
+  spec.add_runtime_dependency 'dry-auto_inject', '~> 0.1'
+  spec.add_runtime_dependency 'dry-configurable', '~> 0.1'
+
+  spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec'
+end

data/lib/dry-component.rb

@@ -0,0 +1 @@
+require 'dry/component'

data/lib/dry/component.rb

@@ -0,0 +1,4 @@
+module Dry
+  module Component
+  end
+end

data/lib/dry/component/config.rb

@@ -0,0 +1,23 @@
+require 'yaml'
+
+module Dry
+  module Component
+    class Config
+      extend Dry::Configurable
+
+      def self.load(root, env)
+        path = root.join('config').join('application.yml')
+
+        return {} unless File.exist?(path)
+
+        yaml = YAML.load_file(path)
+
+        yaml.fetch(env.to_s).each do |key, value|
+          setting key.downcase.to_sym, ENV.fetch(key, value)
+        end
+
+        config
+      end
+    end
+  end
+end

data/lib/dry/component/container.rb

@@ -0,0 +1,181 @@
+require 'inflecto'
+require 'dry-container'
+require 'dry-auto_inject'
+
+require 'dry/component/loader'
+require 'dry/component/config'
+
+module Dry
+  module Component
+    class Container
+      extend Dry::Container::Mixin
+
+      setting :env
+      setting :root, Pathname.pwd.freeze
+      setting :core_dir, 'core'.freeze
+      setting :auto_register
+      setting :options
+
+      def self.configure(env = config.env, &block)
+        return self if configured?
+
+        super() do |config|
+          yield(config) if block
+          config.options = Config.load(root, env)
+        end
+
+        load_paths!(config.core_dir)
+
+        @configured = true
+
+        self
+      end
+
+      def self.options
+        config.options
+      end
+
+      def self.finalize(name, &block)
+        finalizers[name] = block
+      end
+
+      def self.configured?
+        @configured
+      end
+
+      def self.finalize!(&_block)
+        yield(self) if block_given?
+
+        Dir[root.join("#{config.core_dir}/boot/**/*.rb")].each do |path|
+          boot!(File.basename(path, '.rb').to_sym)
+        end
+
+        auto_register.each(&method(:auto_register!)) if auto_register?
+
+        freeze
+      end
+
+      def self.import_module
+        auto_inject = Dry::AutoInject(self)
+
+        -> *keys {
+          keys.each { |key| load_component(key) unless key?(key) }
+          auto_inject[*keys]
+        }
+      end
+
+      def self.auto_register!(dir, &_block)
+        dir_root = root.join(dir.to_s.split('/')[0])
+
+        Dir["#{root}/#{dir}/**/*.rb"].each do |path|
+          component_path = path.to_s.gsub("#{dir_root}/", '').gsub('.rb', '')
+          Component.Loader(component_path).tap do |component|
+            next if key?(component.identifier)
+
+            Kernel.require component.path
+
+            if block_given?
+              register(component.identifier, yield(component.constant))
+            else
+              register(component.identifier) { component.instance }
+            end
+          end
+        end
+
+        self
+      end
+
+      def self.boot!(name)
+        check_component_identifier!(name)
+        return self unless booted?(name)
+        boot(name)
+        self
+      end
+
+      def self.boot(name)
+        require "#{config.core_dir}/boot/#{name}.rb"
+
+        finalizers[name].tap do |finalizer|
+          finalizer.() if finalizer
+        end
+
+        booted[name] = true
+      end
+
+      def self.booted?(name)
+        !booted.key?(name)
+      end
+
+      def self.require(*paths)
+        paths.flat_map { |path|
+          path.include?('*') ? Dir[root.join(path)] : root.join(path)
+        }.each { |path|
+          Kernel.require path.to_s
+        }
+      end
+
+      def self.load_component(key)
+        require_component(key) { |klass| register(key) { klass.new } }
+      end
+
+      def self.require_component(key, &block)
+        component = Component.Loader(key)
+        path = load_paths.detect { |p| p.join(component.file).exist? }
+
+        if path
+          Kernel.require component.path
+          yield(component.constant) if block
+        else
+          fail ArgumentError, "could not resolve require file for #{key}"
+        end
+      end
+
+      def self.root
+        config.root
+      end
+
+      def self.load_paths!(*dirs)
+        dirs.map(&:to_s).each do |dir|
+          path = root.join(dir)
+          load_paths << path
+          $LOAD_PATH.unshift(path.to_s)
+        end
+        self
+      end
+
+      def self.load_paths
+        @load_paths ||= []
+      end
+
+      def self.booted
+        @booted ||= {}
+      end
+
+      def self.finalizers
+        @finalizers ||= {}
+      end
+
+      private
+
+      def self.auto_register
+        Array(config.auto_register)
+      end
+
+      def self.auto_register?
+        !auto_register.empty?
+      end
+
+      def self.check_component_identifier!(name)
+        fail(
+          ArgumentError,
+          'component identifier must be a symbol'
+        ) unless name.is_a?(Symbol)
+
+        fail(
+          ArgumentError,
+          "component identifier +#{name}+ is invalid or boot file is missing"
+        ) unless root.join("#{config.core_dir}/boot/#{name}.rb").exist?
+      end
+    end
+  end
+end

data/lib/dry/component/loader.rb

@@ -0,0 +1,47 @@
+require 'memoizable'
+require 'inflecto'
+
+module Dry
+  module Component
+    def self.Loader(input)
+      Loader.new(Loader.identifier(input), Loader.path(input))
+    end
+
+    class Loader
+      include Memoizable
+
+      IDENTIFIER_SEPARATOR = '.'.freeze
+      PATH_SEPARATOR = '/'.freeze
+
+      attr_reader :identifier, :path, :file
+
+      def self.identifier(input)
+        input.to_s.gsub(PATH_SEPARATOR, IDENTIFIER_SEPARATOR)
+      end
+
+      def self.path(input)
+        input.to_s.gsub(IDENTIFIER_SEPARATOR, PATH_SEPARATOR)
+      end
+
+      def initialize(identifier, path)
+        @identifier = identifier
+        @path = path
+        @file = "#{path}.rb"
+      end
+
+      def name
+        Inflecto.camelize(path)
+      end
+      memoize :name
+
+      def constant
+        Inflecto.constantize(name)
+      end
+      memoize :constant
+
+      def instance(*args)
+        constant.new(*args)
+      end
+    end
+  end
+end

data/lib/dry/component/version.rb

@@ -0,0 +1,5 @@
+module Dry
+  module Component
+    VERSION = '0.0.1'.freeze
+  end
+end

data/spec/fixtures/other/config/boot/bar.rb

@@ -0,0 +1,11 @@
+Test::Container.namespace(:test) do |container|
+  module Test
+    module Bar
+      # I shall be booted
+    end
+  end
+
+  container.finalize(:bar) do
+    container.register(:bar, 'I was finalized')
+  end
+end

data/spec/fixtures/other/lib/test/dep.rb

@@ -0,0 +1,4 @@
+module Test
+  class Dep
+  end
+end

data/spec/fixtures/other/lib/test/foo.rb

@@ -0,0 +1,5 @@
+module Test
+  class Foo
+    include Import['test.dep']
+  end
+end

data/spec/fixtures/other/lib/test/models.rb

@@ -0,0 +1,4 @@
+module Test
+  module Models
+  end
+end

data/spec/fixtures/other/lib/test/models/book.rb

@@ -0,0 +1,6 @@
+module Test
+  module Models
+    class Book
+    end
+  end
+end

data/spec/fixtures/other/lib/test/models/user.rb

@@ -0,0 +1,6 @@
+module Test
+  module Models
+    class User
+    end
+  end
+end

data/spec/fixtures/test/config/application.yml

@@ -0,0 +1,2 @@
+test:
+  foo: 'bar'

data/spec/fixtures/test/core/boot/bar.rb

@@ -0,0 +1,11 @@
+Test::Container.namespace(:test) do |container|
+  module Test
+    module Bar
+      # I shall be booted
+    end
+  end
+
+  container.finalize(:bar) do
+    container.register(:bar, 'I was finalized')
+  end
+end

data/spec/fixtures/test/lib/test/dep.rb

@@ -0,0 +1,4 @@
+module Test
+  class Dep
+  end
+end

data/spec/fixtures/test/lib/test/foo.rb

@@ -0,0 +1,5 @@
+module Test
+  class Foo
+    include Import['test.dep']
+  end
+end

data/spec/fixtures/test/lib/test/models.rb

@@ -0,0 +1,4 @@
+module Test
+  module Models
+  end
+end

data/spec/fixtures/test/lib/test/models/book.rb

@@ -0,0 +1,6 @@
+module Test
+  module Models
+    class Book
+    end
+  end
+end

data/spec/fixtures/test/lib/test/models/user.rb

@@ -0,0 +1,6 @@
+module Test
+  module Models
+    class User
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,46 @@
+# encoding: utf-8
+
+if RUBY_ENGINE == 'rbx'
+  require 'codeclimate-test-reporter'
+  CodeClimate::TestReporter.start
+end
+
+begin
+  require 'byebug'
+rescue LoadError; end
+
+SPEC_ROOT = Pathname(__FILE__).dirname
+
+Dir[SPEC_ROOT.join('support/*.rb').to_s].each { |f| require f }
+Dir[SPEC_ROOT.join('shared/*.rb').to_s].each { |f| require f }
+
+require 'dry/component/container'
+
+class Dry::Component::Container
+  setting :env, 'test'
+end
+
+module TestNamespace
+  def remove_constants
+    constants.each do |name|
+      remove_const(name)
+    end
+  end
+end
+
+RSpec.configure do |config|
+  config.disable_monkey_patching!
+
+  config.before do
+    @load_paths = $LOAD_PATH.dup
+    Object.const_set(:Test, Module.new { |m| m.extend(TestNamespace) })
+  end
+
+  config.after do
+    ($LOAD_PATH - @load_paths).each do |path|
+      $LOAD_PATH.delete(path)
+    end
+    Test.remove_constants
+    Object.send(:remove_const, :Test)
+  end
+end

data/spec/unit/config_spec.rb

@@ -0,0 +1,15 @@
+require 'dry/component/container'
+
+RSpec.describe Dry::Component::Config do
+  before do
+    class Test::App < Dry::Component::Container
+      configure do |config|
+        config.root = SPEC_ROOT.join('fixtures/test').realpath
+      end
+    end
+  end
+
+  it 'loads config under component name' do
+    expect(Test::App.options.foo).to eql('bar')
+  end
+end

data/spec/unit/container_spec.rb

@@ -0,0 +1,102 @@
+require 'dry/component/container'
+
+RSpec.describe Dry::Component::Container do
+  subject(:container) { Test::Container }
+
+  context 'with default core dir' do
+    before do
+      class Test::Container < Dry::Component::Container
+        configure do |config|
+          config.root = SPEC_ROOT.join('fixtures/test').realpath
+        end
+
+        load_paths!('lib')
+      end
+
+      module Test
+        Import = Container.import_module
+      end
+    end
+
+    describe '.require' do
+      it 'requires a single file' do
+        container.require('lib/test/models')
+
+        expect(Test.const_defined?(:Models)).to be(true)
+      end
+
+      it 'requires many files when glob pattern is passed' do
+        container.require('lib/test/models/*.rb')
+
+        expect(Test::Models.const_defined?(:User)).to be(true)
+        expect(Test::Models.const_defined?(:Book)).to be(true)
+      end
+    end
+
+    describe '.require_component' do
+      it 'requires components from configured load paths' do
+        container.require_component('test.foo')
+
+        expect(Test.const_defined?(:Foo)).to be(true)
+        expect(Test.const_defined?(:Dep)).to be(true)
+
+        expect(Test::Foo.new.dep).to be_instance_of(Test::Dep)
+      end
+    end
+  end
+
+  describe '.boot!' do
+    shared_examples_for 'a booted component' do
+      it 'boots a given component and finalizes it' do
+        container.boot!(:bar)
+
+        expect(Test.const_defined?(:Bar)).to be(true)
+        expect(container['test.bar']).to eql('I was finalized')
+      end
+
+      it 'expects a symbol identifier matching file name' do
+        expect {
+          container.boot!('bar')
+        }.to raise_error(ArgumentError, 'component identifier must be a symbol')
+      end
+
+      it 'expects identifier to point to an existing boot file' do
+        expect {
+          container.boot!(:foo)
+        }.to raise_error(
+          ArgumentError,
+          'component identifier +foo+ is invalid or boot file is missing'
+        )
+      end
+    end
+
+    context 'with the default core dir' do
+      it_behaves_like 'a booted component' do
+        before do
+          class Test::Container < Dry::Component::Container
+            configure do |config|
+              config.root = SPEC_ROOT.join('fixtures/test').realpath
+            end
+
+            load_paths!('lib')
+          end
+        end
+      end
+    end
+
+    context 'with a custom core dir' do
+      it_behaves_like 'a booted component' do
+        before do
+          class Test::Container < Dry::Component::Container
+            configure do |config|
+              config.root = SPEC_ROOT.join('fixtures/other').realpath
+              config.core_dir = 'config'
+            end
+
+            load_paths!('lib')
+          end
+        end
+      end
+    end
+  end
+end

data/spec/unit/loader_spec.rb

@@ -0,0 +1,66 @@
+require 'dry/component/loader'
+
+RSpec.describe Dry::Component::Loader do
+  before do
+    module Test
+      class Bar
+      end
+    end
+  end
+
+  shared_examples_for 'a valid component' do
+    describe '#name' do
+      it 'returns name of the constant' do
+        expect(component.name).to eql('Test::Bar')
+      end
+    end
+
+    describe '#constant' do
+      it 'returns the constant' do
+        expect(component.constant).to be(Test::Bar)
+      end
+    end
+
+    describe '#identifier' do
+      it 'returns container identifier' do
+        expect(component.identifier).to eql('test.bar')
+      end
+    end
+
+    describe '#path' do
+      it 'returns relative path to file defining the component constant' do
+        expect(component.path).to eql('test/bar')
+      end
+    end
+
+    describe '#file' do
+      it 'returns relative path to file with ext defining the component constant' do
+        expect(component.file).to eql('test/bar.rb')
+      end
+    end
+
+    describe '#instance' do
+      it 'builds a component class instance' do
+        expect(component.instance).to be_instance_of(Test::Bar)
+      end
+    end
+  end
+
+  context 'from identifier as a symbol' do
+    subject(:component) { Dry::Component::Loader(:'test.bar') }
+
+    it_behaves_like 'a valid component'
+  end
+
+  context 'from identifier as a string' do
+    subject(:component) { Dry::Component::Loader('test.bar') }
+
+    it_behaves_like 'a valid component'
+  end
+
+  context 'from path' do
+    subject(:component) { Dry::Component::Loader('test/bar') }
+
+    it_behaves_like 'a valid component'
+  end
+end

metadata

@@ -0,0 +1,213 @@
+--- !ruby/object:Gem::Specification
+name: dry-component
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Piotr Solnica
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-12-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: memoizable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+- !ruby/object:Gem::Dependency
+  name: inflecto
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+- !ruby/object:Gem::Dependency
+  name: dry-container
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.7
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.7
+- !ruby/object:Gem::Dependency
+  name: dry-auto_inject
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: dry-configurable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- piotr.solnica@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".rubocop_todo.yml"
+- ".travis.yml"
+- CHANGELOG.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- dry-component.gemspec
+- lib/dry-component.rb
+- lib/dry/component.rb
+- lib/dry/component/config.rb
+- lib/dry/component/container.rb
+- lib/dry/component/loader.rb
+- lib/dry/component/version.rb
+- spec/fixtures/other/config/boot/bar.rb
+- spec/fixtures/other/lib/test/dep.rb
+- spec/fixtures/other/lib/test/foo.rb
+- spec/fixtures/other/lib/test/models.rb
+- spec/fixtures/other/lib/test/models/book.rb
+- spec/fixtures/other/lib/test/models/user.rb
+- spec/fixtures/test/config/application.yml
+- spec/fixtures/test/core/boot/bar.rb
+- spec/fixtures/test/lib/test/dep.rb
+- spec/fixtures/test/lib/test/foo.rb
+- spec/fixtures/test/lib/test/models.rb
+- spec/fixtures/test/lib/test/models/book.rb
+- spec/fixtures/test/lib/test/models/user.rb
+- spec/spec_helper.rb
+- spec/unit/config_spec.rb
+- spec/unit/container_spec.rb
+- spec/unit/loader_spec.rb
+homepage: https://github.com/dryrb/dry-component
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5.1
+signing_key: 
+specification_version: 4
+summary: Organize your code into reusable components
+test_files:
+- spec/fixtures/other/config/boot/bar.rb
+- spec/fixtures/other/lib/test/dep.rb
+- spec/fixtures/other/lib/test/foo.rb
+- spec/fixtures/other/lib/test/models.rb
+- spec/fixtures/other/lib/test/models/book.rb
+- spec/fixtures/other/lib/test/models/user.rb
+- spec/fixtures/test/config/application.yml
+- spec/fixtures/test/core/boot/bar.rb
+- spec/fixtures/test/lib/test/dep.rb
+- spec/fixtures/test/lib/test/foo.rb
+- spec/fixtures/test/lib/test/models.rb
+- spec/fixtures/test/lib/test/models/book.rb
+- spec/fixtures/test/lib/test/models/user.rb
+- spec/spec_helper.rb
+- spec/unit/config_spec.rb
+- spec/unit/container_spec.rb
+- spec/unit/loader_spec.rb