hexx-dependencies 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 06edafd9f55a776138c9c14cef0000d8bcfc4470
+  data.tar.gz: f8b989bf59c2fb9eb08b21353ab0267b6aef4511
+SHA512:
+  metadata.gz: a51db0341740592db0db53de842a070eff891a36ffdb01d7d664a951b799d9422f63d4c82024ad2cc43ee15e012225f41d55e79d9ce15aef0f23ce6eabfc58f0
+  data.tar.gz: f401c4e82c644fb82675976214dd031f120c006102c89fb776c8fcc87ba87cc6751bb5ea3fbcbc62c2e628fbda14fd2a1b457f4e303f3854f04bd177db330782

data/.gitignore

@@ -0,0 +1,9 @@
+*.gem
+*.lock
+.bundle/
+.yardoc/
+coverage/
+doc/
+log/
+pkg/
+tmp/

data/.metrics

@@ -0,0 +1,8 @@
+# Settings for metric_fu and its packages are collected in the `config/metrics`
+# and loaded by the Hexx::Suit::Metrics::MetricFu.
+
+begin
+  require "hexx-suit"
+  Hexx::Suit::Metrics::MetricFu.load
+rescue LoadError
+end

data/.rspec

@@ -0,0 +1,2 @@
+--require spec_helper
+--color

data/.rubocop.yml

@@ -0,0 +1,2 @@
+---
+inherit_from: "./config/metrics/rubocop.yml"

data/.travis.yml

@@ -0,0 +1,10 @@
+---
+language: ruby
+bundler_args: --without metrics
+script: rake test:coverage:run
+rvm:
+  - '2.0'
+  - ruby-head
+  - rbx-2 --2.0
+  - jruby-head-20mode
+  - jruby-head-21mode

data/.yardopts

@@ -0,0 +1,3 @@
+--asset LICENSE
+--exclude lib/hexx/dependencies/version.rb
+--output doc/api

data/Gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+gemspec
+
+gem "hexx-suit", "~> 2.0", group: :metrics if RUBY_ENGINE == "ruby"

data/Guardfile

@@ -0,0 +1,17 @@
+# encoding: utf-8
+
+guard :rspec, cmd: "bundle exec rspec" do
+
+  watch(%r{^lib/hexx/dependencies/(\w+)\.rb$}) do |m|
+    "spec/tests/#{ m[1] }_spec.rb"
+  end
+
+  watch(%r{^lib/hexx/dependencies/cli/.+}) { "spec/tests/cli_spec.rb" }
+
+  watch(%r{^spec/tests/.+_spec\.rb$})
+
+  watch("lib/hexx.rb")              { "spec" }
+  watch("lib/hexx/dependencies.rb") { "spec" }
+  watch("spec/spec_helper.rb")      { "spec" }
+
+end # guard :rspec

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2015 Andrew Kozin, andrew.kozin@gmail.com
+
+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,162 @@
+Hexx::Dependencies
+==================
+
+[![Gem Version](https://img.shields.io/gem/v/hexx-dependencies.svg?style=flat)][gem]
+[![Build Status](https://img.shields.io/travis/nepalez/hexx-dependencies/master.svg?style=flat)][travis]
+[![Dependency Status](https://img.shields.io/gemnasium/nepalez/hexx-dependencies.svg?style=flat)][gemnasium]
+[![Code Climate](https://img.shields.io/codeclimate/github/nepalez/hexx-dependencies.svg?style=flat)][codeclimate]
+[![Coverage](https://img.shields.io/coveralls/nepalez/hexx-dependencies.svg?style=flat)][coveralls]
+
+[codeclimate]: https://codeclimate.com/github/nepalez/hexx-dependencies
+[coveralls]: https://coveralls.io/r/nepalez/hexx-dependencies
+[gem]: https://rubygems.org/gems/hexx-dependencies
+[gemnasium]: https://gemnasium.com/nepalez/hexx-dependencies
+[travis]: https://travis-ci.org/nepalez/hexx-dependencies
+
+Scaffolds the current project's dependency from a variable, defined outside.
+
+The module is used inside the [hexx] collection of scaffolders.
+
+[hexx]: https://github.com/nepalez/hexx
+
+Usage
+-----
+
+Suppose we need the `user_class` dependency that should be initialized by dummy application as `User` taken from the external `users` module.
+
+The dependency should be called as a core module getter:
+
+```ruby
+MyModule.user_class # => User from 'users' gem (in the test environment)
+```
+
+To do it start the scaffolder:
+
+```ruby
+Hexx::Dependencies::CLI.start %w(user_class -i User -g users) 
+```
+
+Results
+-------
+
+At first the scaffolder provides base loader mechanism (if it is absent):
+
+* dummy app `spec/dummy`.
+* dummy loader `spec/spec_helper.rb`.
+* the module configurator `lib/my_module/configurator.rb`.
+* the module initializer `spec/dummy/config/initializers/my_module.rb`.
+* the configurator loaders from `lib/my_module.rb`.
+
+See the *Loading Order* part below for details how it works.
+
+Then the scaffolder adds required settings:
+
+* `user_class` attribute in `lib/my_module/configurator.rb`.
+* `users` development dependency in the Gemfile.
+* `users` loader in the `spec/dummy/initializers.rb`.
+* `user_class = User` injection in the `spec/dummy/initializers.rb`.
+
+### Loading Order
+
+The module is loaded in the following order:
+
+* The dummy application takes the control:
+
+```ruby
+# spec/spec_helper.rb
+require_relative "dummy/lib/dummy"
+```
+
+The dummy app:
+* sets the pointer to initializers folder `ENV['PATH_TO_INITIALIZERS']`.
+* gives control to the module.
+
+```ruby
+# spec/dummy/lib/dummy.rb
+ENV['PATH_TO_INITIALIZERS'] = File.expand_path(
+  "../../config/initializers", __FILE__
+)
+require "my_module"
+```
+
+`lib/my_module.rb`:
+* declares its `Configurator`.
+* takes its own initializers from dummy `config/initializers` folder.
+* loads the rest of the code.
+
+```ruby
+# lib/my_module.rb
+require_relative "my_module/configurator"
+load File.join(ENV['PATH_TO_INITIALIZERS'], "my_module.rb")
+# ...loads the rest of application
+
+# lib/my_module/configurator.rb
+module MyModule
+  class << self
+    def configure
+      instance_eval(yield) if block_given?
+    end
+
+    attr_accessor :user_class
+  end
+end
+
+# spec/dummy/config/initializers/my_module.rb
+require "users"
+
+MyModule.configure do |config|
+  user_class = User  
+end
+```
+
+Installation
+------------
+
+Add this line to your application's Gemfile:
+
+```ruby
+# Gemfile
+gem "hexx-dependencies"
+```
+
+Then execute:
+
+```
+bundle
+```
+
+Or add it manually:
+
+```
+gem install hexx-dependencies
+```
+
+Compatibility
+-------------
+
+Tested under rubies compatible to MRI 2.0 API:
+* MRI 2.0+
+* Rubinius 2+ (2.0+ modes)
+* JRuby-head (9000) (2.0+ modes)
+
+Uses [RSpec] 3.0+ for testing and [hexx-suit] for dev/test tools collection.
+
+[hexx-suit]: https://github.com/nepalez/hexx-suit
+
+Contributing
+------------
+
+* Fork the project.
+* Read the [STYLEGUIDE](config/metrics/STYLEGUIDE).
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with Rakefile or version
+  (if you want to have your own version, that is fine but bump version
+  in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+License
+-------
+
+See the [MIT LICENSE](LICENSE).

data/Rakefile

@@ -0,0 +1,22 @@
+# encoding: utf-8
+begin
+  require "bundler/setup"
+rescue LoadError
+  puts "You must `gem install bundler` and `bundle install` to run rake tasks"
+  exit
+end
+
+# Loads bundler tasks
+Bundler::GemHelper.install_tasks
+
+# Loads the Hexx::RSpec and its tasks
+begin
+  require "hexx-suit"
+  Hexx::Suit.install_tasks
+rescue LoadError
+  require "hexx-rspec"
+  Hexx::RSpec.install_tasks
+end
+
+# Sets the Hexx::RSpec :test task to default
+task default: "test:coverage:run"

data/config/metrics/STYLEGUIDE

@@ -0,0 +1,230 @@
+= Ruby Style Guide
+
+Adapted from Dan Kubb's Ruby Style Guide
+https://github.com/dkubb/styleguide/blob/master/RUBY-STYLE
+
+== Commiting:
+
+* Write descriptive commit messages, following the pattern:
+
+    [TYPE] name
+
+    The message, describing the changes being made
+
+* Use the types below to mark commits:
+
+  - FEATURE - for adding new features, or backward-compatible changes;
+  - CHANGE - for backward-incompatible changes;
+  - BUG FIX - for fixing bugs;
+  - REFACTORING - for other changes of the code not affecting the API;
+  - OTHER - for changes in documentaton, metrics etc, not touching the code;
+  - VERSION - for version changes.
+
+* Always separate commits of different types (such as FEATURE and CHANGE).
+
+* Try to separate various features from each other.
+
+* Include specification to the same commit as the code.
+
+* Run all tests before making a commit.
+  Never commit the code that break unit tests.
+
+* Use metric (run `rake check`) before making a commit.
+
+* Do refactoring before making a commit. Best writing is rewriting.
+
+* Follow semantic versioning.
+
+    http://semver.org/
+
+* For versions name the commit after a version number, following the pattern:
+
+    VERSION 1.0.0-rc2
+
+
+== Formatting:
+
+* Use UTF-8. Declare encoding in the first line of every file.
+
+    # encoding: utf-8
+
+* Use 2 space indent, no tabs.
+
+* Use Unix-style line endings.
+
+* Use spaces around operators, after commas, colons and semicolons,
+  around { and before }.
+
+* No spaces after (, [ and before ], ).
+
+* Align `when` and `else` with `case`.
+
+* Use an empty line before the return value of a method (unless it
+  only has one line), and an empty line between defs.
+
+* Use empty lines to break up a long method into logical paragraphs.
+
+* Keep lines fewer than 80 characters.
+
+* Strip trailing whitespace.
+
+
+== Syntax:
+
+* Write for 2.0.
+
+* Use double quotes
+  
+    http://viget.com/extend/just-use-double-quoted-ruby-strings
+
+* Use def with parentheses when there are arguments.
+
+* Never use for, unless you exactly know why.
+
+* Never use then, except in case statements.
+
+* Use when x then ... for one-line cases.
+
+* Use &&/|| for boolean expressions, and/or for control flow. (Rule
+  of thumb: If you have to use outer parentheses, you are using the
+  wrong operators.)
+
+* Avoid double negation (!!), unless Null Objects are expected.
+  
+    http://devblog.avdi.org/2011/05/30/null-objects-and-falsiness
+
+* Avoid multiline ?:, use if.
+
+* Use {...} when defining blocks on one line. Use do...end for multiline
+  blocks.
+
+* Avoid return where not required.
+
+* Use ||= freely.
+
+* Use OO regexps, and avoid =~ $0-9, $~, $` and $' when possible.
+
+* Do not use Enumerable#inject when the "memo" object does not change between
+  iterations, use Enumerable#each_with_object instead (in ruby 1.9,
+  active_support and backports).
+
+* Prefer ENV.fetch to ENV[] syntax.
+  Prefer block syntax for ENV.fetch to usage of the second argument.
+
+
+== Naming:
+
+* Use snake_case for methods.
+
+* Use CamelCase for classes and modules. (Keep acronyms like HTTP,
+  RFC, XML uppercase.)
+
+* Use SCREAMING_SNAKE_CASE for other constants.
+
+* Do not use single letter variable names. Avoid uncommunicative names.
+
+* Use consistent variable names. Try to keep the variable names close
+  to the object class name.
+
+* Use names prefixed with _ for unused variables.
+
+* When defining a predicate method that compares against another object of
+  a similar type, name the argument "other".
+
+* Prefer map over collect, detect over find, select over find_all.
+
+* Use def self.method to define singleton methods.
+
+* Avoid alias when alias_method will do.
+
+
+== Comments:
+
+* Use YARD and its conventions for API documentation. Don't put an
+  empty line between the comment block and the def.
+
+* Comments longer than a word are capitalized and use punctuation.
+  Use one space after periods.
+
+* Avoid superfluous comments.
+
+
+== Code structuring:
+
+* Break code into packages, decoupled from the environment.
+
+* Wrap packages into gems.
+
+* Inject dependencies explicitly.
+  Leave all outer references on the border of any package. Inside
+  the package use internal references only.
+
+* Follow SOLID principles.
+
+    http://en.wikipedia.org/wiki/SOLID_(object-oriented_design)
+
+* Only give a method one purpose for existing. If you pass in a boolean
+  to a method, what you're saying is that this method has two different
+  behaviours. Just split it into two single purpose methods. If you have
+  to use the words "AND" or "OR" to describe what the method does it
+  probably does too much.
+
+* Avoid long methods.
+  Try to keep them at no more than 6 lines long, and preferably 4 or less.
+
+  If sections of a method are logically separate by blank lines, then
+  that's probably a sign that those sections should be split into separate
+  methods.
+
+* Avoid hashes-as-optional-parameters. Does the method do too much?
+
+* Avoid long parameter lists.
+
+* Add "global" methods to Kernel (if you have to) and make them private.
+
+* Use OptionParser for parsing complex command line options and
+  ruby -s for trivial command line options.
+
+* Avoid needless metaprogramming.
+
+* Always freeze objects assigned to constants.
+
+
+== General:
+
+* Code in a functional way, avoid mutation when it makes sense.
+
+* Try to have methods either return the state of the object and have
+  no side effects, or return self and have side effects. This is
+  otherwise known as Command-query separation (CQS):
+
+    http://en.wikipedia.org/wiki/Command-query_separation
+
+* Do not mutate arguments unless that is the purpose of the method.
+
+* Try following TRUE heuristics by Sandi Metz
+
+    http://designisrefactoring.com/2015/02/08/introducing-sandi-metz-true/
+
+* Do not mess around in core classes when writing libraries.
+  Namespace your code inside the modules, or wrap core classes to
+  decorators of your own.
+
+* Do not program defensively.
+  
+    http://www.erlang.se/doc/programming_rules.shtml#HDR11
+
+* Keep the code simple.
+
+* Don't overdesign.
+
+* Don't underdesign.
+
+* Avoid bugs.
+
+* Read other style guides and apply the parts that don't dissent with
+  this list.
+
+* Be consistent.
+
+* Use common sense.

data/config/metrics/cane.yml

@@ -0,0 +1,5 @@
+---
+abc_max: "10"
+line_length: "80"
+no_doc: "y"
+no_readme: "y"

data/config/metrics/churn.yml

@@ -0,0 +1,6 @@
+---
+ignore_files:
+- spec
+- config
+minimum_churn_count: 0
+start_date: "1 year ago"

data/config/metrics/flay.yml

@@ -0,0 +1,2 @@
+---
+minimum_score: 5

data/config/metrics/metric_fu.yml

@@ -0,0 +1,15 @@
+---
+folders: # The list of folders to be used by any metric.
+- lib
+- app
+metrics: # The list of allowed metrics. The other metrics are disabled.
+- cane
+- churn
+- flay
+- flog
+- reek
+- roodi
+- saikuro
+format: html
+output: tmp/metric_fu
+verbose: false

data/config/metrics/reek.yml

@@ -0,0 +1 @@
+---

data/config/metrics/roodi.yml

@@ -0,0 +1,24 @@
+---
+AssignmentInConditionalCheck:
+CaseMissingElseCheck:
+ClassLineCountCheck:
+  line_count: 300
+ClassNameCheck:
+  pattern: !ruby/regexp /^[A-Z][a-zA-Z0-9]*$/
+ClassVariableCheck:
+CyclomaticComplexityBlockCheck:
+  complexity: 4
+CyclomaticComplexityMethodCheck:
+  complexity: 8
+EmptyRescueBodyCheck:
+ForLoopCheck:
+MethodLineCountCheck:
+  line_count: 20
+MethodNameCheck:
+  pattern: !ruby/regexp /^[\||\^|\&|\!]$|^[_a-z<>=\[|+-\/\*`]+[_a-z0-9_<>=~@\[\]]*[=!\?]?$/
+ModuleLineCountCheck:
+  line_count: 300
+ModuleNameCheck:
+  pattern: !ruby/regexp /^[A-Z][a-zA-Z0-9]*$/
+ParameterNumberCheck:
+  parameter_count: 5

data/config/metrics/rubocop.yml

@@ -0,0 +1,73 @@
+---
+# settings added by the 'hexx-suit' module
+# output: "tmp/rubocop"
+# format: "html"
+
+AllCops:
+  Exclude:
+    - '**/db/schema.rb'
+
+Lint/HandleExceptions:
+  Exclude:
+    - '**/*_spec.rb'
+
+Lint/RescueException:
+  Exclude:
+    - '**/*_spec.rb'
+
+Style/AccessorMethodName:
+  Exclude:
+    - '**/*_spec.rb'
+
+Style/AsciiComments:
+  Enabled: false
+
+Style/ClassAndModuleChildren:
+  Exclude:
+    - '**/*_spec.rb'
+
+Style/Documentation:
+  Enabled: false
+
+Style/EmptyLinesAroundBlockBody:
+  Enabled: false
+
+Style/EmptyLinesAroundClassBody:
+  Enabled: false
+
+Style/EmptyLinesAroundMethodBody:
+  Enabled: false
+
+Style/EmptyLinesAroundModuleBody:
+  Enabled: false
+
+Style/EmptyLineBetweenDefs:
+  Enabled: false
+
+Style/FileName:
+  Enabled: false
+
+Style/RaiseArgs:
+  EnforcedStyle: compact
+
+Style/SingleLineMethods:
+  Exclude:
+    - '**/*_spec.rb'
+
+Style/SingleSpaceBeforeFirstArg:
+  Enabled: false
+
+Style/SpecialGlobalVars:
+  Exclude:
+    - '**/Gemfile'
+    - '**/*.gemspec'
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+
+Style/TrivialAccessors:
+  Exclude:
+    - '**/*_spec.rb'

data/config/metrics/saikuro.yml

@@ -0,0 +1,3 @@
+---
+warn_cyclo:  4
+error_cyclo: 6

data/config/metrics/simplecov.yml

@@ -0,0 +1,8 @@
+---
+output: tmp/coverage
+filters: # The list of paths to be excluded from coverage checkup
+- "spec/"
+- "config/"
+groups: # The list of groups to be shown in the coverage report
+  Libraries: "lib/"
+  Application: "app/"

data/config/metrics/yardstick.yml

@@ -0,0 +1,37 @@
+---
+# Settings added by the 'hexx-suit' gem
+output: "tmp/yardstick/output.log"
+path: "lib/**/*.rb"
+rules:
+  ApiTag::Presence:
+    enabled: true
+    exclude: []
+  ApiTag::Inclusion:
+    enabled: true
+    exclude: []
+  ApiTag::ProtectedMethod:
+    enabled: true
+    exclude: []
+  ApiTag::PrivateMethod:
+    enabled: false
+    exclude: []
+  ExampleTag:
+    enabled: true
+    exclude: []
+  ReturnTag:
+    enabled: true
+    exclude: []
+  Summary::Presence:
+    enabled: true
+    exclude: []
+  Summary::Length:
+    enabled: true
+    exclude: []
+  Summary::Delimiter:
+    enabled: true
+    exclude: []
+  Summary::SingleLine:
+    enabled: true
+    exclude: []
+threshold: 100
+verbose: false

data/hexx-dependencies.gemspec

@@ -0,0 +1,25 @@
+$:.push File.expand_path("../lib", __FILE__)
+require "hexx/dependencies/version"
+
+Gem::Specification.new do |gem|
+
+  gem.name        = "hexx-dependencies"
+  gem.version     = Hexx::Dependencies::VERSION.dup
+  gem.author      = "Andrew Kozin"
+  gem.email       = "andrew.kozin@gmail.com"
+  gem.homepage    = "https://github.com/nepalez/hexx-dependencies"
+  gem.description = "Gem dependency scaffolder."
+  gem.summary     = "Creates the loader mechanism and defines an external" \
+                    " dependency for the host module."
+  gem.license     = "MIT"
+
+  gem.require_paths    = ["lib"]
+  gem.files            = `git ls-files`.split($INPUT_RECORD_SEPARATOR)
+  gem.test_files       = Dir["spec/**/*.rb"]
+  gem.extra_rdoc_files = Dir["README.md", "LICENSE"]
+
+  gem.required_ruby_version = "~> 2.0"
+  gem.add_runtime_dependency "hexx-cli", "~> 0.0", ">= 0.0.3"
+  gem.add_development_dependency "hexx-rspec", "~> 0.3"
+
+end

data/lib/hexx/dependencies/cli/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/lib/hexx/dependencies/cli/configurator.erb

@@ -0,0 +1,35 @@
+# encoding: utf-8
+<% tabs = 0 -%>
+<% project.namespaces.each do |item| -%>
+
+<%= "  " * tabs %>module <%= item %>
+<% tabs += 1 -%>
+<% end -%>
+
+<%= "  " * tabs %>module <%= project.const %>
+
+<%= "  " * tabs %>  # The module's eigenclass containing its settings
+<%= "  " * tabs %>  class << self
+
+<%= "  " * tabs %>    # Configures the module settings
+<%= "  " * tabs %>    #
+<%= "  " * tabs %>    # @example
+<%= "  " * tabs %>    #   <%= project.type %>.configure do
+<%= "  " * tabs %>    #     setting = Injection
+<%= "  " * tabs %>    #   end
+<%= "  " * tabs %>    #
+<%= "  " * tabs %>    # @yield the block in the module eigenclass' scope
+<%= "  " * tabs %>    #
+<%= "  " * tabs %>    # @return [undefined]
+<%= "  " * tabs %>    def configure
+<%= "  " * tabs %>      instance_eval { yield } if block_given?
+<%= "  " * tabs %>    end
+
+<%= "  " * tabs %>  end # eigenclass
+
+<%= "  " * tabs %>end # module <%= project.const %>
+<% project.namespaces.reverse.each do |item| -%>
+
+<% tabs -= 1 -%>
+<%= "  " * tabs %>end # module <%= item %>
+<% end -%>

data/lib/hexx/dependencies/cli/dependency.erb

@@ -0,0 +1,6 @@
+<% tabs = project.namespaces.count + 2 %>
+<%= "  " * tabs %># @!attribute <%= dependency %>
+<%= "  " * tabs %># @todo Describe the dependency
+<%= "  " * tabs %>#
+<%= "  " * tabs %># @return [Module]
+<%= "  " * tabs %>attr_accessor :<%= dependency %>

data/lib/hexx/dependencies/cli/dummy.erb

@@ -0,0 +1,10 @@
+# encoding: utf-8
+
+# Dummy application
+module Dummy
+
+  ENV["PATH_TO_INITIALIZERS"] =
+    ::File.expand_path("../../config/initializers", __FILE__)
+  require "<%= project.item %>"
+
+end

data/lib/hexx/dependencies/cli/initializer.erb

@@ -0,0 +1,4 @@
+# encoding: utf-8
+
+<%= project.type %>.configure do
+end

data/lib/hexx/dependencies/cli/lib.erb

@@ -0,0 +1,17 @@
+# encoding: utf-8
+<% tabs = 0 -%>
+<% project.namespaces.each do |item| -%>
+
+<%= "  " * tabs %>module <%= item %>
+<% tabs += 1 -%>
+<% end -%>
+
+<%= "  " * tabs %># @todo Describe the module
+<%= "  " * tabs %>module <%= project.const %>
+
+<%= "  " * tabs %>end # module <%= project.const %>
+<% project.namespaces.reverse.each do |item| -%>
+
+<% tabs -= 1 -%>
+<%= "  " * tabs %>end # module <%= item %>
+<% end -%>

data/lib/hexx/dependencies/cli/lib_loader.erb

@@ -0,0 +1,3 @@
+<% tabs = project.namespaces.count + 1 %>
+<% "  " * tabs %>  require_relative "<%= project.item %>/configurator"
+<% "  " * tabs %>  load ::File.join(ENV["PATH_TO_INITIALIZERS"], "<%= project.file %>.rb")

data/lib/hexx/dependencies/cli/spec_helper.erb

@@ -0,0 +1,8 @@
+# encoding: utf-8
+require "hexx-rspec"
+
+# Loads the runtime metrics
+Hexx::RSpec.loads_metrics_for(self)
+
+# Loads the dummy app
+require_relative "dummy/lib/dummy"

data/lib/hexx/dependencies/cli.rb

@@ -0,0 +1,154 @@
+# encoding: utf-8
+
+module Hexx
+
+  module Dependencies
+
+    class CLI < Hexx::CLI::Base
+
+      def self.source_root
+        ::File.expand_path "../cli", __FILE__
+      end
+
+      desc "Scaffolds the dependency from a variable defined outside of the gem"
+      namespace :dependency
+
+      argument(
+        :name,
+        banner: "NAME",
+        desc: "The name of the dependency",
+        required: false,
+        type: :string
+      )
+
+      class_option(
+        :injection,
+        aliases: "-i",
+        banner:  "Injection",
+        desc: "The name of the dependency implementation injected by the dummy",
+        required: false,
+        type: :string
+      )
+
+      class_option(
+        :gemname,
+        aliases: "-g",
+        banner:  "gemname",
+        desc: "The name of the gem for dummy to inject the dependency from",
+        required: false,
+        type: :string
+      )
+
+      # @private
+      def add_dummy_loader
+        template "spec_helper.erb", "spec/spec_helper.rb", skip: true
+        gsub_file(
+          "spec/spec_helper.rb",
+          /require\s+"#{ project.item }"/,
+          "require_relative \"dummy/lib/dummy\""
+        )
+      end
+
+      # @private
+      def add_dummy_lib
+        template "dummy.erb", "spec/dummy/lib/dummy.rb", skip: true
+      end
+
+      # @private
+      def add_initializer
+        template(
+          "initializer.erb",
+          "spec/dummy/config/initializers/#{ project.file }.rb",
+          skip: true
+        )
+      end
+
+      # @private
+      def add_configurator
+        template(
+          "configurator.erb",
+          "lib/#{ project.path }/configurator.rb",
+          skip: true
+        )
+      end
+
+      # @private
+      def add_lib
+        template "lib.erb", "lib/#{ project.path }.rb", skip: true
+        insert_into_file(
+          "lib/#{ project.path }.rb",
+          from_template("lib_loader.erb"),
+          after: /\n\s*module #{ project.const }\n/
+        )
+      end
+
+      # @private
+      def add_dependency
+        return unless dependency?
+        insert_into_file(
+          "lib/#{ project.path }/configurator.rb",
+          from_template("dependency.erb"),
+          after: "class << self\n"
+        )
+      end
+
+      # @private
+      def add_gemfile
+        return unless injection?
+        copy_file "Gemfile", skip: true
+        append_to_file "Gemfile", "gem \"#{ gemname }\", group: :test"
+      end
+
+      # @private
+      def add_injection
+        return unless injection?
+        insert_into_file(
+          "spec/dummy/config/initializers/#{ project.file }.rb",
+          "\nrequire \"#{ gemname }\"",
+          before: /\n*#{ project.type }/,
+          skip: true
+        )
+      end
+
+      # @private
+      def set_injection
+        return unless injection?
+        insert_into_file(
+          "spec/dummy/config/initializers/#{ project.file }.rb",
+          "\n  #{ dependency } = #{ injection }",
+          before: /\nend/,
+          skip: true
+        )
+      end
+
+      private
+
+      def project
+        @project ||= Hexx::CLI::Name.new ::File.basename(destination_root)
+      end
+
+      def dependency
+        @dependency ||= name ? name.to_s.snake_case : nil
+      end
+
+      def injection
+        @injection ||= options.fetch("injection", "").camel_case
+      end
+
+      def gemname
+        @gemname ||= options.fetch("gemname", "").snake_case
+      end
+
+      def dependency?
+        dependency ? true : false
+      end
+
+      def injection?
+        dependency? && !injection.blank? && !gemname.blank?
+      end
+
+    end # module Hexx
+
+  end # module Dependencies
+
+end # class CLI

data/lib/hexx/dependencies/version.rb

@@ -0,0 +1,13 @@
+# encoding: utf-8
+
+module Hexx
+
+  module Dependencies
+
+    # The semantic version of the module.
+    # @see http://semver.org/ Semantic versioning 2.0
+    VERSION = "0.0.1".freeze
+
+  end # module Dependencies
+
+end # module Hexx

data/lib/hexx/dependencies.rb

@@ -0,0 +1,12 @@
+# encoding: utf-8
+
+module Hexx
+
+  # The namespace for 'hexx-dependencies' module
+  module Dependencies
+
+    require_relative "dependencies/cli"
+
+  end # module Dependencies
+
+end # module Hexx

data/lib/hexx-dependencies.rb

@@ -0,0 +1,10 @@
+# encoding: utf-8
+require "hexx-cli"
+
+# The shared namespace for hexx-based modules
+module Hexx
+
+  require_relative "hexx/dependencies"
+  require_relative "hexx/dependencies/version"
+
+end # module Hexx

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+# encoding: utf-8
+require "hexx-rspec"
+
+# Loads runtime metrics
+Hexx::RSpec.load_metrics_for(self)
+
+# Loads the code under test
+require "hexx-dependencies"

data/spec/tests/cli_spec.rb

@@ -0,0 +1,145 @@
+# encoding: utf-8
+
+describe Hexx::Dependencies::CLI, :sandbox, :capture do
+
+  describe ".start" do
+
+    subject { try_in_sandbox { described_class.start params } }
+
+    shared_examples "creating a loader mechanism" do
+
+      before { subject }
+
+      it "[adds dummy loader]" do
+        content = read_in_sandbox "spec/spec_helper.rb"
+        expect(content).to include "require_relative \"dummy/lib/dummy\""
+      end
+
+      it "[adds dummy lib]" do
+        content = read_in_sandbox "spec/dummy/lib/dummy.rb"
+        expect(content).to include "ENV[\"PATH_TO_INITIALIZERS\"] ="
+        expect(content).to include "\"../../config/initializers\""
+        expect(content).to include "require \"sandbox\""
+      end
+
+      it "[adds the initializer]" do
+        content = read_in_sandbox "spec/dummy/config/initializers/sandbox.rb"
+        expect(content).to include "Sandbox.configure do"
+      end
+
+      it "[adds gem configurator]" do
+        content = read_in_sandbox "lib/sandbox/configurator.rb"
+        expect(content).to include "class << self"
+        expect(content).to include "def configure"
+      end
+
+      it "[adds gem lib]" do
+        content = read_in_sandbox "lib/sandbox.rb"
+        expect(content).to include "require_relative \"sandbox/configurator\""
+        expect(content).to include "ENV[\"PATH_TO_INITIALIZERS\"]"
+        expect(content).to include "sandbox.rb"
+      end
+
+    end # shared_examples
+
+    shared_examples "providing a dependency" do
+
+      before { subject }
+
+      it "[adds the attribute]" do
+        content = read_in_sandbox "lib/sandbox/configurator.rb"
+        expect(content).to include "attr_accessor :#{ name }"
+      end
+
+    end # shared_examples
+
+    shared_examples "injecting a dependency" do
+
+      before { subject }
+
+      it "[adds gem]" do
+        content = read_in_sandbox "Gemfile"
+        expect(content).to include "gem \"#{ gemname }\", group: :test"
+      end
+
+      it "[adds injection]" do
+        content = read_in_sandbox "spec/dummy/config/initializers/sandbox.rb"
+        expect(content).to include "require \"#{ gemname }\""
+        expect(content).to include "#{ name } = #{ injection }"
+      end
+
+    end # shared_examples
+
+    context "without params" do
+
+      let(:params) { %w() }
+
+      it_behaves_like "creating a loader mechanism"
+
+    end # context
+
+    context "foo" do
+
+      let(:params) { %w(foo) }
+
+      it_behaves_like "creating a loader mechanism"
+
+      it_behaves_like "providing a dependency" do
+        let(:name) { "foo" }
+      end
+
+    end # context
+
+    context "foo -i bar -g baz" do
+
+      let(:params) { %w(foo -i bar -g baz) }
+
+      it_behaves_like "creating a loader mechanism"
+
+      it_behaves_like "providing a dependency" do
+        let(:name) { "foo" }
+      end
+
+      it_behaves_like "injecting a dependency" do
+        let(:name)      { "foo" }
+        let(:injection) { "Bar" }
+        let(:gemname)   { "baz" }
+      end
+
+    end # context
+
+    context "foo -i Bar" do
+
+      let(:params) { %w(foo -i Bar) }
+
+      it_behaves_like "creating a loader mechanism"
+
+      it_behaves_like "providing a dependency" do
+        let(:name) { "foo" }
+      end
+
+    end # context
+
+    context "foo -g baz" do
+
+      let(:params) { %w(foo -g baz) }
+
+      it_behaves_like "creating a loader mechanism"
+
+      it_behaves_like "providing a dependency" do
+        let(:name) { "foo" }
+      end
+
+    end # context
+
+    context "-i bar -g baz" do
+
+      let(:params) { %w(-i bar -g baz) }
+
+      it_behaves_like "creating a loader mechanism"
+
+    end # context
+
+  end # describe .start
+
+end # describe Hexx::Dependencies::CLI

metadata

@@ -0,0 +1,120 @@
+--- !ruby/object:Gem::Specification
+name: hexx-dependencies
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Andrew Kozin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-03-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: hexx-cli
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.3
+- !ruby/object:Gem::Dependency
+  name: hexx-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+description: Gem dependency scaffolder.
+email: andrew.kozin@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+- LICENSE
+files:
+- ".gitignore"
+- ".metrics"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- ".yardopts"
+- Gemfile
+- Guardfile
+- LICENSE
+- README.md
+- Rakefile
+- config/metrics/STYLEGUIDE
+- config/metrics/cane.yml
+- config/metrics/churn.yml
+- config/metrics/flay.yml
+- config/metrics/metric_fu.yml
+- config/metrics/reek.yml
+- config/metrics/roodi.yml
+- config/metrics/rubocop.yml
+- config/metrics/saikuro.yml
+- config/metrics/simplecov.yml
+- config/metrics/yardstick.yml
+- hexx-dependencies.gemspec
+- lib/hexx-dependencies.rb
+- lib/hexx/dependencies.rb
+- lib/hexx/dependencies/cli.rb
+- lib/hexx/dependencies/cli/Gemfile
+- lib/hexx/dependencies/cli/configurator.erb
+- lib/hexx/dependencies/cli/dependency.erb
+- lib/hexx/dependencies/cli/dummy.erb
+- lib/hexx/dependencies/cli/initializer.erb
+- lib/hexx/dependencies/cli/lib.erb
+- lib/hexx/dependencies/cli/lib_loader.erb
+- lib/hexx/dependencies/cli/spec_helper.erb
+- lib/hexx/dependencies/version.rb
+- spec/spec_helper.rb
+- spec/tests/cli_spec.rb
+homepage: https://github.com/nepalez/hexx-dependencies
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '2.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.6
+signing_key: 
+specification_version: 4
+summary: Creates the loader mechanism and defines an external dependency for the host
+  module.
+test_files:
+- spec/spec_helper.rb
+- spec/tests/cli_spec.rb
+has_rdoc: