envandle 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6ca4f6faadb9b5212f25212d23ab42ab36d9e1c5
+  data.tar.gz: 00da2b9a9de635373d09654e47f52c391b28b6ba
+SHA512:
+  metadata.gz: 98977a5f9a1f7b29e0b1222693cf6f04cb8ea409ab1c31aa3ac67bf7fed328cda2b6818f31c6690ce62395f937c76754ecce5388d0514b1804c851639b4c50ab
+  data.tar.gz: 2f70f6b8b345f854c8fffe4791ba47e56b432d7602136c1f91c4cb523dc9d702db1ffd03be287b8fa67d1f451b5f03f50801389ff7915a7aa9870df2f547bdcf

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rspec

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

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.3.1
+before_install: gem install bundler -v 1.13.6

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in envandle.gemspec
+gemspec

data/README.md

@@ -0,0 +1,151 @@
+# Envandle
+
+A rubygem for enabling Gemfiles to specify gem locations from environment variables.
+
+## Installation
+
+```sh
+$ gem install envandle
+```
+
+## Usage
+
+Write a Gemfile.
+
+```ruby
+require "envandle"
+
+source "https://rubygems.org"
+
+binding.envandle do |bundle|
+  bundle.gem "mygem", "~> 1.0"
+end
+```
+
+Set the environment variables.
+
+```sh
+export ENVANDLE_GEM_PATH=mygem:/path/to/mygem
+```
+
+And execute Bundler.
+
+```sh
+$ bundle
+```
+
+## Examples
+
+### Setting Paths
+
+You can specify the gem method's `path` option by setting the ENVANDLE_GEM_PATH variable.
+
+For example,
+
+```ruby
+ENV["ENVANDLE_GEM_PATH"] = "mygem:/path/to/mygem"
+
+binding.envandle do |bundle|
+  bundle.gem "mygem", "~> 1.0"
+end
+```
+
+is evaluated as:
+
+```ruby
+gem "mygem", path: "/path/to/mygem"
+```
+
+If the variable is not set,
+
+```ruby
+ENV["ENVANDLE_GEM_PATH"] = ""
+
+binding.envandle do |bundle|
+  bundle.gem "mygem", "~> 1.0"
+end
+```
+
+is evaluated as:
+
+```ruby
+gem "mygem", "~> 1.0"
+```
+
+### Setting Git Branches
+
+You can specify the gem method's `git` and `branch` options by setting the ENVANDLE_GEM_GIT_BRANCH variable.
+
+For example,
+
+```ruby
+ENV["ENVANDLE_GEM_GIT_BRANCH"] = "mygem:https://github.com/mosop/mygem.git#edge"
+
+binding.envandle do |bundle|
+  bundle.gem "mygem", "~> 1.0"
+end
+```
+
+is evaluated as:
+
+```ruby
+gem "mygem", git: "https://github.com/mosop/mygem.git", branch: "edge"
+```
+
+If the variable is not set,
+
+```ruby
+ENV["ENVANDLE_GEM_GIT_BRANCH"] = ""
+
+binding.envandle do |bundle|
+  bundle.gem "mygem", "~> 1.0"
+end
+```
+
+is evaluated as:
+
+```ruby
+gem "mygem", "~> 1.0"
+```
+
+### Specifying Gemspecs
+
+As well as the regular Gemfile, you can also specify a gemspec not a single gem.
+
+For example, if your gem's name is "mygem", the gemspec refers the a, b and c gems and the c's version requirement is "~> 1.0",
+
+```ruby
+ENV["ENVANDLE_GEM_PATH"] = "a:/path/to/a;b:/path/to/b"
+
+binding.envandle do |bundle|
+  bundle.gemspec
+end
+```
+
+is evaluated as:
+
+```ruby
+gem "mygem", path: "."
+gem "a", path: "/path/to/a"
+gem "b", path: "/path/to/b"
+gem "c", "~> 1.0"
+```
+
+### Resolving Multilevel Dependencies
+
+For example, if a Gemfile refers the gem a that depends on the gem b, Envandle also tries to resolve the b's reference by the environment variables.
+
+```ruby
+ENV["ENVANDLE_GEM_PATH"] = "a:/path/to/a;b:/path/to/b"
+
+binding.envandle do |bundle|
+  bundle.gem "a", "~> 1.0"
+end
+```
+
+is evaluated as:
+
+```ruby
+gem "a", path: "/path/to/a"
+gem "b", path: "/path/to/b"
+```

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 "envandle"
+
+# 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,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/envandle.gemspec

@@ -0,0 +1,33 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'envandle/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "envandle"
+  spec.version       = Envandle::VERSION
+  spec.authors       = ["mosop"]
+
+  spec.summary       = %q{A library for enabling Gemfiles to specify gem locations from environment variables.}
+  spec.homepage      = "https://github.com/mosop/envandle"
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    spec.metadata['allowed_push_host'] = "https://rubygems.org"
+  else
+    raise "RubyGems 2.0 or newer is required to protect against " \
+      "public gem pushes."
+  end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.13"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.5"
+end

data/lib/envandle/as_git_reference.rb

@@ -0,0 +1,10 @@
+module Envandle
+  module AsGitReference
+    def self.extended(mod)
+      mod.extend AsReference
+      mod.class_eval do
+        attr_reader :url, :ref
+      end
+    end
+  end
+end

data/lib/envandle/as_reference.rb

@@ -0,0 +1,13 @@
+module Envandle
+  module AsReference
+    def self.extended(mod)
+      mod.class_eval do
+        attr_reader :group, :name
+
+        def key
+          @key ||= ReferenceCache.key(group, name)
+        end
+      end
+    end
+  end
+end

data/lib/envandle/binding.rb

@@ -0,0 +1,12 @@
+require "envandle/lib"
+
+class Binding
+  def envandle
+    /^(.+?):(\d+)(?::in `(.*)')?/ =~ caller(1, 1).first
+    yield ::Envandle::BundleDsl.new(::Envandle::Gemfile.new($1, self))
+  end
+
+  def gem(*args)
+    receiver.__send__ :gem, *args
+  end
+end

data/lib/envandle/bundle_dsl.rb

@@ -0,0 +1,31 @@
+module Envandle
+  class BundleDsl
+    def initialize(gemfile)
+      @gemfile = gemfile
+    end
+
+    def gem(*args)
+      @gemfile.gem nil, *args
+    end
+
+    def group(name)
+      yield GroupDsl.new(@gemfile, name)
+    end
+
+    def gemspec(development_group: "development", path: nil, name: nil)
+      development_group = development_group.to_s.strip
+      raise "No gemspec's development group." if development_group.empty?
+      name = name.to_s.strip if name
+      raise "No gemspec's name." if name && name.empty
+      path ||= Gemspec.find_file(@gemfile.dir, name: name)
+      path = path.to_s.strip
+      raise "No gemspec's path." if path.empty?
+      spec = Gemspec.new(path)
+      @gemfile.gem nil, spec.name, path: "."
+      spec.dependencies.each do |i|
+        group = i.type == :development ? development_group : nil
+        @gemfile.gem group, i.name, *i.requirements_list
+      end
+    end
+  end
+end

data/lib/envandle/gem.rb

@@ -0,0 +1,20 @@
+module Envandle
+  class Gem
+    def initialize(group, name, args, options)
+      @group = group
+      @name = name
+      @args = args
+      @options = options
+    end
+
+    def args
+      h = @group ? {group: @group} : {}
+      h.merge! @options
+      if h.empty?
+        [@name, *@args]
+      else
+        [@name, *@args, h]
+      end
+    end
+  end
+end

data/lib/envandle/gemfile.rb

@@ -0,0 +1,48 @@
+module Envandle
+  class Gemfile
+    def initialize(path, binding)
+      @path = path
+      @binding = binding
+    end
+
+    def dir
+      @dir ||= File.dirname(@path)
+    end
+
+    def gems
+      @gems ||= {}
+    end
+
+    def references
+      @references ||= ReferenceCache.new
+    end
+
+    def append(group, name, args, options)
+      key = ReferenceCache.key(group, name)
+      gems[key] || begin
+        if ref = references.find(key, name)
+          gem = ref.to_gem(args, options)
+          gems[key] = gem
+          ref.spec.runtime_dependencies.each do |i|
+            append nil, i.name, [], {}
+          end
+          @binding.gem *gem.args
+        else
+          gems[key] = gem = Gem.new(group, name, args, options)
+          @binding.gem *gem.args
+        end
+      end
+    end
+
+    def gem(group, *args)
+      h = args.last.is_a?(Hash) ? args.pop : {}
+      options = {}
+      h.each do |k, v|
+        options[k.to_s.to_sym] = v
+      end
+      name = args.shift.to_s.strip
+      raise "No gem name." if name.empty?
+      append group, name, args, options
+    end
+  end
+end

data/lib/envandle/gemspec.rb

@@ -0,0 +1,28 @@
+module Envandle
+  class Gemspec
+    def initialize(path)
+      @path = path
+      @native = ::Gem::Specification.load(path)
+    end
+
+    def self.find_file(dir, name:)
+      name ||= "*"
+      Dir.glob(File.join(dir, "#{name}.gemspec")) do |f|
+        return f
+      end
+      nil
+    end
+
+    def name
+      @native.name
+    end
+
+    def dependencies
+      @native.dependencies
+    end
+
+    def runtime_dependencies
+      @native.runtime_dependencies
+    end
+  end
+end

data/lib/envandle/git.rb

@@ -0,0 +1,16 @@
+module Envandle
+  GIT = `which git`.chomp
+
+  def self.git_pull(url, ref, branch)
+    raise "No git installed." if GIT.empty?
+    Dir.mktmpdir do |tmp|
+      Dir.chdir(tmp) do
+        sh "#{GIT} init"
+        sh "#{GIT} remote add origin #{url}"
+        sh "#{GIT} checkout -b #{branch}"
+        sh "#{GIT} pull origin #{ref}:#{branch}"
+        yield tmp
+      end
+    end
+  end
+end

data/lib/envandle/git_branch_reference.rb

@@ -0,0 +1,22 @@
+module Envandle
+  class GitBranchReference
+    extend AsGitReference
+
+    def initialize(group, name, url, ref)
+      @group = group
+      @name = name
+      @url = url
+      @ref = ref
+    end
+
+    def to_gem(args, options)
+      Gem.new(@group, @name, [], {git: @url, branch: @ref})
+    end
+
+    def spec
+      Envandle.git_pull(@url, @ref, @ref) do |dir|
+        Gemspec.new(File.join(dir, "#{@name}.gemspec"))
+      end
+    end
+  end
+end

data/lib/envandle/group_dsl.rb

@@ -0,0 +1,14 @@
+module Envandle
+  class GroupDsl
+    def initialize(world, name)
+      @world = world
+      name = name.to_s.strip
+      raise "No group name." if name.empty?
+      @name = name
+    end
+
+    def gem(*args)
+      world.gem @name, *args
+    end
+  end
+end

data/lib/envandle/lib.rb

@@ -0,0 +1,14 @@
+require "tmpdir"
+require "envandle/version"
+require "envandle/as_reference"
+require "envandle/as_git_reference"
+require "envandle/bundle_dsl"
+require "envandle/gem"
+require "envandle/gemfile"
+require "envandle/gemspec"
+require "envandle/git"
+require "envandle/git_branch_reference"
+require "envandle/group_dsl"
+require "envandle/path_reference"
+require "envandle/shell"
+require "envandle/reference_cache"

data/lib/envandle/path_reference.rb

@@ -0,0 +1,19 @@
+module Envandle
+  class PathReference
+    extend AsReference
+
+    def initialize(group, name, path)
+      @group = group
+      @name = name
+      @path = path
+    end
+
+    def to_gem(args, options)
+      Gem.new(@group, @name, [], {path: @path})
+    end
+
+    def spec
+      @spec ||= Gemspec.new(Gemspec.find_file(@path, name: @name))
+    end
+  end
+end

data/lib/envandle/reference_cache.rb

@@ -0,0 +1,69 @@
+module Envandle
+  class ReferenceCache
+    def self.key(group, name)
+      if group
+        "#{name}@#{group}"
+      else
+        name
+      end
+    end
+
+    def find(key, name)
+      paths[key] ||
+      git_branches[key] ||
+      paths[name] ||
+      git_branches[name]
+    end
+
+    def paths
+      @paths ||= parse(:path, PathReference, "ENVANDLE_GEM_PATH")
+    end
+
+    def git_branches
+      @git_branches ||= parse(:git, GitBranchReference, "ENVANDLE_GEM_GIT_BRANCH")
+    end
+
+    def parse(key, klass, env)
+      {}.tap do |h|
+        (ENV[env].to_s).split(";").each do |i|
+          if v = __send__("parse_#{key}", klass, env, i)
+            h[v.key] = v if v
+          end
+        end
+      end
+    end
+
+    def parse_group_and_name(env, v)
+      name, group = v.to_s.strip.split("@")
+      name = name.to_s.strip
+      group = group.to_s.strip if group
+      raise "No gem name (#{env}): #{ENV[env]}" if name.empty?
+      raise "No group name (#{env}): #{ENV[env]}" if group && group.empty?
+      [group, name]
+    end
+
+    def parse_path(klass, env, v)
+      v = v.to_s.strip
+      return if v.empty?
+      a = v.split(":")
+      name = a[0].to_s.strip
+      path = a[1..-1].join(":").to_s.strip
+      raise "No gem path (#{env}): #{ENV[env]}" if path.empty?
+      klass.new(*parse_group_and_name(env, name), path)
+    end
+
+    def parse_git(klass, env, v)
+      v = v.to_s.strip
+      return if v.empty?
+      a = v.split(":")
+      name = a[0].to_s.strip
+      path = a[1..-1].join(":").to_s.strip
+      url_and_ref = path.split('#')
+      url = url_and_ref[0].to_s.strip
+      ref = url_and_ref[1].to_s.strip
+      raise "No gem git url (#{env}): #{ENV[env]}" if url.empty?
+      raise "No gem git ref/branch/tag (#{env}): #{ENV[env]}" if ref.empty?
+      klass.new(*parse_group_and_name(env, name), url, ref)
+    end
+  end
+end

data/lib/envandle/shell.rb

@@ -0,0 +1,6 @@
+module Envandle
+  def self.sh(cmd)
+    system cmd, out: "/dev/null", err: "/dev/null"
+    raise "Command error: #{cmd}" unless $?.success?
+  end
+end

data/lib/envandle/version.rb

@@ -0,0 +1,3 @@
+module Envandle
+  VERSION = "0.1.0"
+end

data/lib/envandle.rb

@@ -0,0 +1 @@
+require "envandle/binding"

metadata

@@ -0,0 +1,111 @@
+--- !ruby/object:Gem::Specification
+name: envandle
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- mosop
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-01-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !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: '3.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+description: 
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- envandle.gemspec
+- lib/envandle.rb
+- lib/envandle/as_git_reference.rb
+- lib/envandle/as_reference.rb
+- lib/envandle/binding.rb
+- lib/envandle/bundle_dsl.rb
+- lib/envandle/gem.rb
+- lib/envandle/gemfile.rb
+- lib/envandle/gemspec.rb
+- lib/envandle/git.rb
+- lib/envandle/git_branch_reference.rb
+- lib/envandle/group_dsl.rb
+- lib/envandle/lib.rb
+- lib/envandle/path_reference.rb
+- lib/envandle/reference_cache.rb
+- lib/envandle/shell.rb
+- lib/envandle/version.rb
+homepage: https://github.com/mosop/envandle
+licenses: []
+metadata:
+  allowed_push_host: https://rubygems.org
+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.5.1
+signing_key: 
+specification_version: 4
+summary: A library for enabling Gemfiles to specify gem locations from environment
+  variables.
+test_files: []