yank 1.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4707b4b285e8f4572037682fcb3229695b8e18b3
+  data.tar.gz: 6caf86b471ae378c6d5afe1d325a892f2f4f404c
+SHA512:
+  metadata.gz: 26bd47ec04a27dd5a6c8e68dc2fa1849365000108bcb8fa1385c7d7c54b916dadfd263e5db02724238b4446413e0e2bd155ce80fc9a809e92d10b77b007efbd2
+  data.tar.gz: 89126f9d8d831e76bbeac0512da259f27f0e59ca122b7141cbf30f7d0d066df0743d1d33caf348b0130acb526d7f99d85c6ac95afd5ab3d2a180015b636164d3

data/bin/yank

@@ -0,0 +1,53 @@
+#! /usr/bin/env ruby
+
+require 'logger'
+require 'optparse'
+require 'fileutils'
+require_relative '../lib/yank'
+require_relative '../lib/logging'
+
+include Yank::Logging
+
+yank_file = '.yank'
+yank_target = './target'
+$yank_debug = nil
+
+OptionParser.new do |opts|
+	opts.banner = "Usage: #{__FILE__} [options]\n\nOptions:\n"
+
+	opts.on('-h', '--help', 'Prints usage.'){
+		puts opts
+		exit 0
+	}
+
+	opts.on('-f', '--file FILE', "Yank file to use, defaults to '.yank'"){|v| yank_file = v}
+	opts.on('-t', '--target TARGET', 'Directory to install yanks to'){|v| yank_target = v}
+	opts.on('-d', '--debug', 'Turn on debug logging'){|v| $yank_debug = Logger::DEBUG}
+end.parse!
+
+begin
+	# Load the yank file
+	unless File.exists?(yank_file)
+		raise Yank::YankException.new("missing '#{yank_file}' file.")
+	end
+
+	files_to_remove = Dir[File.join(yank_target, '*')]
+	logger.debug("removing previous yanks: #{files_to_remove}")
+	FileUtils.rm_rf(files_to_remove)
+
+	# For now just default to using the .yank file for parameters
+	yanks = Yank.parse_yanks(yank_file)
+
+	# Check the yank target directory exists
+	unless File.exists?(yank_target)
+		raise Yank::YankException.new("target directory is missing #{yank_target}.")
+	end
+
+	Yank::Yank.new.install(yanks, yank_target)
+rescue Yank::YankException => e
+	puts "ERROR: #{e.message}"
+	exit e.exit_code
+end
+
+puts "Yank successful."
+exit 0

data/lib/logging.rb

@@ -0,0 +1,25 @@
+require 'logger'
+
+module Yank
+  module Logging
+    def logger
+      @logger ||= Logging.logger_for(self.class.name)
+    end
+
+    # Use a hash class-ivar to cache a unique Logger per class:
+    @loggers = {}
+
+    class << self
+      def logger_for(classname)
+        @loggers[classname] ||= configure_logger_for(classname)
+      end
+
+      def configure_logger_for(classname)
+        logger = Logger.new(STDOUT)
+        logger.progname = classname
+        logger.level = $yank_debug || Logger::INFO
+        logger
+      end
+    end
+  end
+end

data/lib/vcs/git.rb

@@ -0,0 +1,36 @@
+require 'open3'
+require_relative '../logging'
+
+module Yank
+	class Git
+		attr_reader :repo_name
+
+		include ::Yank::Logging
+
+		def initialize(repo_name, repo, version)
+			git = `which git`
+			if git.nil? or git.empty?
+				raise ::Yank::YankException.new("git must be installed and on the PATH.")
+			end
+
+			@repo = repo
+			@repo_name = repo_name || @repo.split(".git")[0].split("/").last
+			@version = version
+
+			logger.debug("git repo: #{@repo}")
+			logger.debug("git repo name: #{@repo_name}")
+			logger.debug("git repo version: #{@version}")
+		end
+
+		def install(dir)
+			logger.debug("Cloning into #{@repo}...")
+			logger.debug(Open3.capture3("git clone --recursive #{@repo} #{dir}/#{@repo_name}"))
+
+			case @version["type"]
+			when "branch", "tag", "commit"
+				logger.debug("Checking out #{@version["value"]}...")
+				logger.debug(Open3.capture3("cd #{dir}/#{@repo_name} && git checkout #{@version["value"]}"))
+			end
+		end
+	end
+end

data/lib/yank.kwalify

@@ -0,0 +1,40 @@
+type: map
+mapping:
+  "path":
+    type: str
+    required: false
+  "yanks":
+    required: true
+    type: seq
+    sequence:
+        - type: map
+          mapping:
+            "recurse":
+                type: bool
+                required: false
+                default: true
+            "alias":
+                type: str
+                required: false
+            "vcs":
+                type: str
+                enum:
+                    - git
+                required: true
+            "repo":
+                type: str
+                required: true
+            "version":
+                required: true
+                type: map
+                mapping:
+                    "type": 
+                        required: true
+                        type: str
+                        enum:
+                            - tag
+                            - branch
+                            - commit
+                    "value":
+                        type: str
+                        required: true

data/lib/yank.rb

@@ -0,0 +1,77 @@
+require 'kwalify'
+require_relative 'vcs/git'
+require_relative 'yank_exception'
+require_relative 'logging'
+
+module Yank
+	class Yank
+		include ::Yank::Logging
+
+		def install(options, target)
+			for yank in options["yanks"]
+				logger.debug("verifying yank: #{yank}")
+				vcs = get_vcs(yank)
+
+				if ::Yank.yank_exists?(yank["alias"].nil?? vcs.repo_name: yank["alias"], target)
+					logger.debug("yank already installed, skipping")
+					next
+				end
+
+				logger.debug("installing yank with vcs: #{vcs}")
+				vcs.install(target)
+
+				if yank["recurse"]
+					yank_file = ::Yank.get_yanks_file(target, yank["alias"].nil?? vcs.repo_name: yank["alias"])
+
+					return if yank_file.nil?
+
+					logger.debug("recursing into #{yank_file}")
+					return install(::Yank::parse_yanks(yank_file), target)
+				end
+			end
+		end
+
+	private
+		def get_vcs(yank)
+			vcs = nil
+
+			case yank["vcs"]
+			when 'git'
+				vcs = ::Yank::Git.new(yank["alias"], yank["repo"], yank["version"])
+			end
+
+			if vcs.nil?
+				raise ::Yank::YankException.new("illegal vcs.")
+			end
+
+			return vcs
+		end
+	end
+
+	def self.yank_exists?(name, target)
+		return File.exists?(File.join(target, name))
+	end
+
+	def self.get_yanks_file(target, name)
+		yanks_file = File.join(target, name, ".yanks")
+
+		if yanks_file.nil? || !File.exists?(yanks_file)
+			return nil
+		else
+			return yanks_file
+		end
+	end
+
+	def self.parse_yanks(yank_file)
+		schema    = Kwalify::Yaml.load_file("#{File.join(File.dirname(__FILE__), 'yank.kwalify')}")
+		validator = Kwalify::Validator.new(schema)
+		document  = Kwalify::Yaml.load_file(yank_file)
+		errors    = validator.validate(document)
+
+		if !errors.nil? && !errors.empty?
+			raise ::Yank::YankException.new("unable to validate '#{yank_file}' file: #{errors.join('\n')}.")
+		end
+
+		return document
+	end
+end

data/lib/yank_exception.rb

@@ -0,0 +1,12 @@
+
+module Yank
+	class YankException < Exception
+		attr_reader :exit_code
+
+		def initialize(message)
+			super(message)
+
+			@exit_code = 1
+		end
+	end
+end

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification
+name: yank
+version: !ruby/object:Gem::Version
+  version: 1.0.1
+platform: ruby
+authors:
+- Justin Lathrop
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-04-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: kwalify
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.2
+description: Dependency manager
+email: jelathrop@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/yank
+- lib/logging.rb
+- lib/vcs/git.rb
+- lib/yank.kwalify
+- lib/yank.rb
+- lib/yank_exception.rb
+homepage: https://github.com/jelathro/yank
+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.0.14.1
+signing_key: 
+specification_version: 4
+summary: Generic dependency management for popular version control systems
+test_files: []