turbodep 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 151d0651ac1d5be8161d650c80784a56992a56fb
+  data.tar.gz: 740f03a4a1cd363a51f978db11b050428e697f0a
+SHA512:
+  metadata.gz: 74b0a41b7fdb269b5a03e3eab39a91eee274c4372ad6d06d853b6aabba81ed51f36a56a2c59c0966549b20031e575ccf22b24a6fe808219a85607a0431db2dc9
+  data.tar.gz: 4e35aacd315e929b01e6e6708e44b42d6e36681f77e9594703fa1ef753e9e6cb4902f58dbd575eb9b79b13919cd63c0bc505ef099bfb107ee9cb7bef2bf528a4

data/bin/dep

@@ -0,0 +1,386 @@
+#!/usr/bin/env ruby
+
+require "fileutils"
+
+module Dep
+  class List
+    attr :path
+
+    def initialize(path)
+      @path = path
+    end
+
+    def add(lib)
+      remove(lib)
+      libraries.push(lib)
+    end
+
+    def remove(lib)
+      libraries.delete_if { |e| e.name == lib.name }
+    end
+
+    def libraries
+      @libraries ||= File.readlines(path).map { |line| Lib[line] }
+    end
+
+    def missing_libraries
+      libraries.reject(&:available?)
+    end
+
+    def save
+      File.open(path, "w") do |file|
+        libraries.each do |lib|
+          file.puts lib.to_s
+        end
+      end
+    end
+  end
+
+  class Lib < Struct.new(:name, :version)
+    def self.[](line)
+      if line.strip =~ /^(\S+) -v (\S+)$/
+        return new($1, $2)
+      elsif line.strip =~ /^(\S+) --git '?([^']+)'?$/
+        return GitLib.new($1, $2)
+      elsif line.strip =~ /^(\S+) --github '?([^']+)'?$/
+        return GitHubLib.new($1, $2)
+      elsif line.strip =~ /^(\S+) -v (\S+) --source '?([^']+)'?$/
+        return SourceLib.new($1, $2, $3)
+      else
+        abort("Invalid requirement found: #{line}")
+      end
+    end
+
+    def available?
+      Gem::Specification.find_by_name(name, version)
+    rescue Gem::LoadError
+      return false
+    end
+
+    def to_s
+      "#{name} -v #{version}"
+    end
+
+    def ==(other)
+      to_s == other.to_s
+    end
+
+    def install
+      "gem install #{to_s}"
+    end
+  end
+
+  class SourceLib < Lib
+    attr_accessor :source
+
+    def initialize(name, version, source)
+      self.name    = name
+      self.version = version
+      self.source  = source
+    end
+
+    def to_s
+      super + "--source #{source}"
+    end
+
+    def install
+      super + "--source #{source}"
+    end
+  end
+
+  class GitLib < Lib
+    attr_accessor :uri, :gemspec_path
+
+    def initialize(name, data)
+      self.name = name
+      if data.strip =~ /^(\S+) (\S+)$/
+        @uri = $1
+        @gemspec_path = $2
+      else
+        @uri = data
+        @gemspec_path = nil
+      end
+      self
+    end
+
+    def to_s
+      "#{name} --git #{@gemspec_path ? "'#{@uri} #{@gemspec_path}'" : @uri}"
+    end
+
+    def install
+      tmp_path = "/tmp/dep-#{name}"
+      %{rm -rf #{tmp_path} &&
+        git clone #{uri} #{tmp_path} &&
+        (cd #{tmp_path}/#{@gemspec_path} && gem build #{name}.gemspec) &&
+        gem install `ls #{tmp_path}/#{@gemspec_path}/#{name}-*.gem | head -n 1`}
+    end
+  end
+
+  class GitHubLib < GitLib
+    attr_accessor :repository
+
+    def initialize(*)
+      super
+      @repository = @uri
+      @uri = "git://github.com/#{repository}.git"
+      self
+    end
+
+    def to_s
+      "#{name} --github #{@gemspec_path ? "'#{@repository} #{@gemspec_path}'" : @repository}"
+    end
+  end
+
+  module CLI
+    class << self
+      attr_accessor :prerelease, :list, :file, :git
+    end
+
+    def self.add(name)
+      if @git
+        lib  = Dep::GitLib.new(name, @git)
+      else
+        dependency = Gem::Dependency.new(name)
+        fetcher = Gem::SpecFetcher.fetcher
+
+        if fetcher.respond_to?(:spec_for_dependency)
+          dependency.prerelease = @prerelease
+          res, _ = fetcher.spec_for_dependency(dependency)
+        else
+          res = fetcher.fetch(dependency, false, true, @prerelease)
+        end
+
+        abort("Unable to find #{name}") if res.empty?
+
+        spec = res[-1][0]
+        lib  = Dep::Lib.new(spec.name, spec.version)
+      end
+
+      @list.add(lib)
+      @list.save
+
+      puts "dep: added #{lib}"
+    end
+
+    def self.rm(name)
+      @list.remove(Dep::Lib.new(name))
+      @list.save
+
+      puts "dep: removed #{name}"
+    end
+
+    def self.check
+      if @list.missing_libraries.empty?
+        puts "dep: all cool"
+      else
+        puts "dep: the following libraries are missing"
+
+        @list.missing_libraries.each do |lib|
+          puts "  %s" % lib
+        end
+
+        exit(1)
+      end
+    end
+
+    def self.install
+      if @list.missing_libraries.empty?
+        puts "dep: nothing to install"
+        exit
+      end
+
+      @list.missing_libraries.each do |lib|
+        run lib.install
+      end
+    end
+
+    def self.run(cmd)
+      puts "  #{cmd}"
+      `#{cmd}`
+    end
+
+    def self.abort
+      abort("error: dep --help for more info")
+    end
+  end
+end
+
+module Kernel
+private
+  def on(flag, &block)
+    if index = ARGV.index(flag)
+      _ = ARGV.delete_at(index)
+
+      case block.arity
+      when 1 then block.call(ARGV.delete_at(index))
+      when 0 then block.call
+      else
+        Dep::CLI.abort
+      end
+    end
+  end
+end
+
+# So originally, this was just $0 == __FILE__, but
+# since rubygems wraps the actual bin file in a loader
+# script, we have to instead rely on a different condition.
+if File.basename($0) == "dep"
+
+  Dep::CLI.file = File.join(Dir.pwd, ".gems")
+  Dep::CLI.prerelease = false
+  Dep::CLI.git = false
+  Dep::CLI.github = false
+  Dep::CLI.source = false
+
+  on("-f") do |file|
+    Dep::CLI.file = file
+  end
+
+  on("--pre") do
+    Dep::CLI.prerelease = true
+  end
+
+  on("--git") do |git|
+    Dep::CLI.git = git
+  end
+
+  on("--github") do |github|
+    Dep::CLI.github = github
+  end
+
+  on("--source") do |source|
+    Dep::CLI.source = source
+  end
+
+  on("--help") do
+
+    # We can't use DATA.read because rubygems does a wrapper script.
+    help = File.read(__FILE__).split(/^__END__/)[1]
+
+    IO.popen("less", "w") { |f| f.write(help) }
+    exit
+  end
+
+  Dep::CLI.list = Dep::List.new(Dep::CLI.file)
+
+  FileUtils.touch(Dep::CLI.list.path) unless File.exist?(Dep::CLI.list.path)
+
+  case ARGV[0]
+  when "add"
+    Dep::CLI.add(ARGV[1])
+  when "rm"
+    Dep::CLI.rm(ARGV[1])
+  when "install", "i"
+    Dep::CLI.install
+  when nil
+    Dep::CLI.check
+  else
+    Dep::CLI.abort
+  end
+
+end
+
+__END__
+DEP(1)
+
+NAME
+      dep -- Basic dependency tracking
+
+SYNOPSIS
+      dep
+      dep add libname [--pre]|[--git]|[--github][--source]
+      dep rm libname
+      dep install
+
+DESCRIPTION
+      dep
+          Checks that all dependencies are met.
+
+      dep add [gemname]
+          Fetches the latest version of `gemname`
+          and automatically adds it to your .gems file.
+
+          If you specify `--git` it will take a git repository followed
+          by a gemspec path if it's different than the repository's root.
+
+          If you specify `--github` it will take a github repository
+          (e.g. user/repository_name) followed by a gemspec path if it's
+          different than the repository's root.
+
+          If you specify `--source` it will use the given URL as the remote
+          source for gems.
+
+      rm
+          Removes the corresponding entry in your .gems file.
+
+      install
+          Installs all the missing dependencies for you. An important
+          point here is that it simply does a `gem install` for each
+          dependency you have. Dep assumes that you use some form of
+          sandboxing like gs, rbenv-gemset or RVM gemsets.
+
+
+INSTALLATION
+      $ wget -qO- http://amakawa.org/sh/install.sh | sh
+
+      # or
+
+      $ gem install dep
+
+HISTORY
+      dep is actually more of a workflow than a tool. If you think about
+      package managers and the problem of dependencies, you can summarize
+      what you absolutely need from them in just two points:
+
+      1. When you build an application which relies on 3rd party libraries,
+         it's best to explicitly declare the version numbers of these
+         libraries.
+
+      2. You can either bundle the specific library version together with
+         your application, or you can have a list of versions.
+
+      The first approach is handled by vendoring the library. The second
+      approach typically is done using Bundler. But why do you need such
+      a complicated tool when all you need is simply listing version numbers?
+
+      We dissected what we were doing and eventually reached the following
+      workflow:
+
+      1. We maintain a .gems file for every application which lists the
+         libraries and the version numbers.
+      2. We omit dependencies of dependencies in that file, the reason being
+         is that that should already be handled by the package manager
+         (typically rubygems).
+      3. Whenever we add a new library, we add the latest version.
+      4. When we pull the latest changes, we want to be able to rapidly
+         check if the dependencies we have is up to date and matches what
+         we just pulled.
+
+      So after doing this workflow manually for a while, we decided to
+      build the simplest tool to aid us with our workflow.
+
+      The first point is handled implicitly by dep. You can also specify
+      a different file by doing dep -f.
+
+      The second point is more of an implementation detail. We thought about
+      doing dependencies, but then, why re-implement something that's already
+      done for you by rubygems?
+
+      The third point (and also the one which is most inconvenient), is
+      handled by dep add.
+
+      The manual workflow for that would be:
+
+      gem search -r "^ohm$" [--pre] # check and remember the version number
+      echo "ohm -v X.x.x" >> .gems
+
+      If you try doing that repeatedly, it will quickly become cumbersome.
+
+      The fourth and final point is handled by typing dep check or simply dep.
+      Practically speaking it's just:
+
+      git pull
+      dep
+
+      And that's it. The dep command typically happens in 0.2 seconds which
+      is something we LOVE.

data/test/dep.rb

@@ -0,0 +1,126 @@
+require "cutest"
+
+load File.expand_path("../../bin/dep", __FILE__)
+
+# Dep::Lib
+scope do
+  test "parsing" do
+    lib = Dep::Lib["ohm-contrib -v 1.0.rc1"]
+
+    assert_equal "ohm-contrib", lib.name
+    assert_equal "1.0.rc1", lib.version
+
+    lib = Dep::Lib["dep --git git://github.com/cyx/dep.git"]
+
+    assert_equal "dep", lib.name
+    assert_equal "git://github.com/cyx/dep.git", lib.uri
+
+    lib = Dep::Lib["dep --github cyx/dep"]
+    assert_equal "dep", lib.name
+    assert_equal "cyx/dep", lib.repository
+    assert_equal "git://github.com/cyx/dep.git", lib.uri
+
+    lib = Dep::Lib["ohm-contrib -v 1.0.rc1 --source https://rubygems.org/"]
+    assert_equal "ohm-contrib", lib.name
+    assert_equal "1.0.rc1", lib.version
+    assert_equal "https://rubygems.org/", lib.source
+  end
+
+  test "availability of existing gem" do
+    lib = Dep::Lib.new("cutest", "1.2.0")
+    assert lib.available?
+  end
+
+  test "non-availability of missing gem" do
+    lib = Dep::Lib.new("rails", "3.0")
+    assert ! lib.available?
+  end
+
+  test "to_s" do
+    lib = Dep::Lib.new("cutest", "1.1.3")
+    assert_equal "cutest -v 1.1.3", lib.to_s
+  end
+end
+
+# Dep::GitLib
+scope do
+  test "parsing" do
+    lib = Dep::Lib["dep --git git://github.com/cyx/dep.git"]
+
+    assert_equal "dep", lib.name
+    assert_equal "git://github.com/cyx/dep.git", lib.uri
+    assert_equal nil, lib.gemspec_path
+
+    lib = Dep::Lib["dep --git 'git://github.com/cyx/dep.git path/to/gemspec'"]
+
+    assert_equal "dep", lib.name
+    assert_equal "git://github.com/cyx/dep.git", lib.uri
+    assert_equal "path/to/gemspec", lib.gemspec_path
+  end
+
+  test "to_s" do
+    lib = Dep::GitLib.new("dep", "git://github.com/cyx/dep.git")
+    assert_equal "dep --git git://github.com/cyx/dep.git", lib.to_s
+
+    lib = Dep::GitLib.new("dep", "git://github.com/cyx/dep.git path/to/gemspec")
+    assert_equal "dep --git 'git://github.com/cyx/dep.git path/to/gemspec'", lib.to_s
+  end
+end
+
+# Dep::GitHubLib
+scope do
+  test "parsing" do
+    lib = Dep::Lib["dep --github cyx/dep"]
+
+    assert_equal "dep", lib.name
+    assert_equal "git://github.com/cyx/dep.git", lib.uri
+    assert_equal nil, lib.gemspec_path
+    assert_equal "cyx/dep", lib.repository
+
+    lib = Dep::Lib["dep --github 'cyx/dep path/to/gemspec'"]
+
+    assert_equal "dep", lib.name
+    assert_equal "git://github.com/cyx/dep.git", lib.uri
+    assert_equal "path/to/gemspec", lib.gemspec_path
+    assert_equal "cyx/dep", lib.repository
+  end
+
+  test "to_s" do
+    lib = Dep::GitHubLib.new("dep", "cyx/dep")
+    assert_equal "dep --github cyx/dep", lib.to_s
+
+    lib = Dep::GitHubLib.new("dep", "cyx/dep path/to/gemspec")
+    assert_equal "dep --github 'cyx/dep path/to/gemspec'", lib.to_s
+  end
+end
+
+# Dep::List
+scope do
+  setup do
+    Dep::List.new(File.expand_path(".gems", File.dirname(__FILE__)))
+  end
+
+  test do |list|
+    lib1 = Dep::Lib.new("ohm-contrib", "1.0.rc1")
+    lib2 = Dep::Lib.new("cutest", "1.2.0")
+    lib3 = Dep::GitLib.new("padrino-performance", "git://github.com/padrino/padrino-framework.git padrino-performance")
+    lib4 = Dep::GitHubLib.new("shield", "cyx/shield shield")
+
+    assert list.libraries.include?(lib1)
+    assert list.libraries.include?(lib2)
+    assert list.libraries.include?(lib3)
+    assert list.libraries.include?(lib4)
+
+    assert_equal 3, list.missing_libraries.size
+    assert list.missing_libraries.include?(lib1)
+    assert list.missing_libraries.include?(lib3)
+    assert list.missing_libraries.include?(lib4)
+  end
+
+  test do |list|
+    list.add(Dep::Lib.new("cutest", "2.0"))
+
+    assert ! list.libraries.include?(Dep::Lib.new("cutest", "1.1.3"))
+    assert list.libraries.include?(Dep::Lib.new("cutest", "2.0"))
+  end
+end

metadata

@@ -0,0 +1,50 @@
+--- !ruby/object:Gem::Specification
+name: turbodep
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Francesco Rodriguez
+- Cyril David
+- Michel Martens
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-05-22 00:00:00.000000000 Z
+dependencies: []
+description: Adds support for gems on git/github repositories or different sources
+  to dep
+email:
+- lrodriguezsanc@gmail.com
+executables:
+- dep
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/dep
+- test/dep.rb
+homepage: https://github.com/frodsan/turbodep
+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.0.2
+signing_key: 
+specification_version: 4
+summary: Turbo-dependencies manager
+test_files: []