bootinq 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a2e3311d9fe2f906d1d620e0bff5fa4271d6aaf0
+  data.tar.gz: fa4bc277f3707743b340b53988252f425a6648c0
+SHA512:
+  metadata.gz: d047b517e113b611dbfc62ad58f8f4ac86aa96cd30a4ae7ac9d11a5ac1564911e35307e5d651f01f5401224b8a31e4ae48ef1e38a152f9b8144edc0a99e5414f
+  data.tar.gz: 4b09c5cff33cfc68c72dffeeea388673e4ab873283a34db963c9e73cbe6b818d3d1c3572253e6a040d00c44c964a38d7595b2a24e12b3a3bce7ba015b9369ebf

data/.gitignore

@@ -0,0 +1,16 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/log/*.log
+/spec/dummy/db/*.sqlite3
+/spec/dummy/db/*.sqlite3-journal
+/spec/dummy/log/*.log
+/spec/dummy/tmp/
+/spec/dummy/.sass-cache
+.rake_t_cache

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.2.2
+before_install: gem install bundler -v 1.10.6

data/Gemfile

@@ -0,0 +1,36 @@
+source 'https://rubygems.org'
+
+# Declare your gem's dependencies in bootinq.gemspec.
+# Bundler will treat runtime dependencies like base dependencies, and
+# development dependencies will be added by default to the :development group.
+gemspec
+
+# Declare any dependencies that are still in development here instead of in
+# your gemspec. These might include edge Rails or gems from your path or
+# Git. Remember to move these dependencies to your gemspec before releasing
+# your gem to rubygems.org.
+
+gem 'rails', '~> 4.2'
+gem 'sqlite3'
+
+# To use a debugger
+gem 'byebug', group: [:development, :test]
+
+group :development, :test do
+  # You need these
+  gem "rspec-rails"
+  gem "pry"
+end
+
+group :development do
+  # You don't need these, but I use them
+  gem "awesome_print"
+end
+
+group :shared_boot do
+  gem 'shared', path: 'spec/dummy/engines/shared'
+end
+
+group :api_boot do
+  gem 'api', path: 'spec/dummy/engines/api'
+end

data/README.md

@@ -0,0 +1,48 @@
+# Rails Boot Inquirer (Bootinq)
+
+The gem allows to select which bundle groups to boot in the current rails process.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'bootinq'
+```
+
+And then execute:
+
+    $ bundle
+
+Insert `require "bootinq"` to the top of `config/application.rb` file.
+
+Find a `Bundler.require(*Rails.groups)` line below and replace it with the `Bootinq.require`.
+
+## Example `config/bootinq.yml`:
+
+```yaml
+env_key: BOOTINQ
+default: "-f"
+
+parts:
+  s: :shared
+
+mount:
+  a: :api
+  f: :engine
+```
+
+## Usage
+
+Using example `bootinq.yml` above, you can create `api_boot` group in your `Gemfile` and load gems from that only when flag `BOOTINQ=a` is set. The group can contain local `api` gem, which provides a mountable engine. Please, see `specs/dummy` for the example.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/estum/bootinq.
+

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "bootinq"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/bootinq.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'bootinq/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "bootinq"
+  spec.version       = Bootinq::VERSION
+  spec.authors       = ["Anton"]
+  spec.email         = ["anton.estum@gmail.com"]
+
+  spec.summary       = %q{Rails Boot Inquirer}
+  spec.description   = %q{Allows to select which bundle groups to boot in the current rails process}
+  spec.homepage      = "https://github.com/estum/bootinq"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.10"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec"
+end

data/lib/bootinq.rb

@@ -0,0 +1,102 @@
+require "yaml"
+require "erb"
+require "singleton"
+require "forwardable"
+require "bootinq/component"
+
+# = Bootinq
+#
+# == Installation
+#
+# 1. Insert <tt>require "bootinq"</tt> in the top of <tt>config/application.rb</tt>
+#
+# 2. Find <tt>Bundler.require(*Rails.groups)</tt> line below and replace it
+#    with the <tt>Bootinq.require</tt>.
+#
+# == Example <tt>config/bootinq.yml</tt>:
+#
+#     env_key: BOOTINQ
+#     default: "-f"
+#
+#     parts:
+#       s: :shared
+#
+#     mount:
+#       a: :api
+#       f: :engine
+class Bootinq
+  NEG     = '-'.freeze
+  DEFAULT = {
+    "env_key" => 'BOOTINQ',
+    "default" => '',
+    "parts"   => {},
+    "mount"   => {}
+  }
+
+  attr_reader :flags, :components
+
+  include Singleton
+  extend SingleForwardable
+
+  def initialize
+    config = YAML.load(File.read(ENV['BOOTINQ_PATH']))
+    config.reject! { |_, v| v.nil? }
+    config.reverse_merge!(DEFAULT)
+
+    config['parts'].merge!(config['mount'])
+
+    value = ENV[config['env_key']] || config['default'].to_s
+    neg   = value.start_with?(NEG)
+
+    flags = []
+    parts = []
+
+    config['parts'].each do |flag, name|
+      if neg ^ value[flag]
+        flags << flag
+        parts << Component.new(name, mountable: config['mount'].key?(flag))
+      end
+    end
+
+    @_value     = value.freeze
+    @_neg       = neg.freeze
+    @flags      = flags.freeze
+    @components = parts.freeze
+  end
+
+  # Checks if a given gem (i.e. a gem group) is enabled
+  def enabled?(gem_name)
+    components.include?(gem_name)
+  end
+
+  # Returns a <tt>Bootinq::Component</tt> object by its name
+  def component(key)
+    components[components.index(key)]
+  end
+
+  # Enums each mountable component
+  def each_mountable
+    return to_enum(__method__) unless block_given?
+    components.each { |c| yield(c) if c.mountable? }
+  end
+
+  # Invokes <tt>Rails.groups</tt> method within enabled Bootinq's groups
+  def groups(*groups)
+    Rails.groups(*components.map(&:group), *groups)
+  end
+
+  def_delegators "instance", *instance_methods(false)
+
+  class << self
+    # The helper method to bootstrap the Bootinq. Sets the BOOTINQ_PATH enviroment variable
+    # and requires selected bundler groups.
+    def require(*groups)
+      ENV['BOOTINQ_PATH'] ||= File.expand_path('../bootinq.yml', caller_locations(1..1)[0].path)
+      Bundler.require(*instance.groups(*groups))
+    end
+
+    private def new
+      super.freeze
+    end
+  end
+end

data/lib/bootinq.yml

@@ -0,0 +1,8 @@
+env_key: BOOTINQ
+default: "-f"
+parts:
+  # s: :shared
+
+mount:
+  # a: :api
+  # f: :engine

data/lib/bootinq/component.rb

@@ -0,0 +1,20 @@
+class Bootinq
+  class Component < DelegateClass(Symbol)
+    attr_reader :gem_name, :mountable, :namespace, :group
+    alias :to_s :gem_name
+    alias :mountable? :mountable
+
+    def initialize(name, mountable: false)
+      super(name)
+      @gem_name  = name.to_s.freeze
+      @mountable = !!mountable
+      @group     = :"#{gem_name}_boot"
+      @namespace = :"#{gem_name.camelcase}" if mountable?
+      freeze
+    end
+
+    def engine
+      Object.const_get(@namespace)::Engine
+    end
+  end
+end

data/lib/bootinq/version.rb

@@ -0,0 +1,3 @@
+class Bootinq
+  VERSION = "0.2.0"
+end

data/lib/tasks/bootinq_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :bootinq do
+#   # Task goes here
+# end

metadata

@@ -0,0 +1,100 @@
+--- !ruby/object:Gem::Specification
+name: bootinq
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Anton
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2015-08-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.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: Allows to select which bundle groups to boot in the current rails process
+email:
+- anton.estum@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- bootinq.gemspec
+- lib/bootinq.rb
+- lib/bootinq.yml
+- lib/bootinq/component.rb
+- lib/bootinq/version.rb
+- lib/tasks/bootinq_tasks.rake
+homepage: https://github.com/estum/bootinq
+licenses: []
+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.8
+signing_key: 
+specification_version: 4
+summary: Rails Boot Inquirer
+test_files: []
+has_rdoc: