psychic-runner 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 67df9a60685ee7062b1b4a26ef84a74157338023
+  data.tar.gz: 5fd8577946b451d79ac3b7b928538089d66f512e
+SHA512:
+  metadata.gz: 8ef2abd35ba79d48c86b27389731b6b6962dcd793a4810b144b439d1b846351f7052cc213a4d77463c468f7dc22ba825180e723244e45eab4001026c5b0f8a62
+  data.tar.gz: f254488c0fa32cd13e8f8c7477988d3d61b7a5b165e08d31626f07834d0341fd33097ac85eeb101ae73d3fbeb1e7b9d5a8aea864065b620eb8bc02ab6afd9a5e

data/.gitignore

@@ -0,0 +1,2 @@
+Gemfile.lock
+tmp/

data/.rspec

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

data/.rubocop.yml

@@ -0,0 +1,2 @@
+inherit_from: .rubocop_todo.yml
+

data/.rubocop_todo.yml

@@ -0,0 +1,29 @@
+# This configuration was generated by `rubocop --auto-gen-config`
+# on 2014-11-20 15:08:06 -0500 using RuboCop version 0.27.1.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 7
+# Configuration parameters: AllowURI, URISchemes.
+Metrics/LineLength:
+  Max: 104
+
+# Offense count: 1
+# Configuration parameters: CountComments.
+Metrics/MethodLength:
+  Max: 11
+
+# Offense count: 14
+Style/Documentation:
+  Enabled: false
+
+# Offense count: 1
+# Configuration parameters: MinBodyLength.
+Style/GuardClause:
+  Enabled: false
+
+# Offense count: 2
+Style/RegexpLiteral:
+  MaxSlashes: 0

data/.travis.yml

@@ -0,0 +1,30 @@
+language: php
+php:
+  - "5.6"
+  - "5.5"
+  - "5.4"
+  - "5.3"
+  - hhvm
+
+matrix:
+  allow_failures:
+    - php: hhvm
+
+branches:
+  only:
+    - master
+    - working
+
+before_script:
+  - composer install --prefer-source
+  - vendor/bin/parallel-lint --exclude vendor .
+  - vendor/bin/php-cs-fixer fix --dry-run --level psr2 .
+
+after_script:
+  - php vendor/bin/coveralls -v
+
+notifications:
+  email:
+    - jamie.hannaford@rackspace.com
+    - glen.campbell@rackspace.com
+    - shaunak.kashyap@rackspace.com

data/Gemfile

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in psychic-runner.gemspec
+gemspec
+gem 'pry'

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Max Lincoln
+
+MIT License
+
+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,70 @@
+**php-opencloud**
+=============
+PHP SDK for OpenStack/Rackspace APIs
+
+[![Latest Stable Version](https://poser.pugx.org/rackspace/php-opencloud/v/stable.png)](https://packagist.org/packages/rackspace/php-opencloud) [![Travis CI](https://secure.travis-ci.org/rackspace/php-opencloud.png)](https://travis-ci.org/rackspace/php-opencloud) [![Total Downloads](https://poser.pugx.org/rackspace/php-opencloud/downloads.png)](https://packagist.org/packages/rackspace/php-opencloud)
+
+For SDKs in different languages, see http://developer.rackspace.com.
+
+The PHP SDK should work with most OpenStack-based cloud deployments,
+though it specifically targets the Rackspace public cloud. In
+general, whenever a Rackspace deployment is substantially different
+than a pure OpenStack one, a separate Rackspace subclass is provided
+so that you can still use the SDK with a pure OpenStack instance
+(for example, see the `OpenStack` class (for OpenStack) and the
+`Rackspace` subclass).
+
+Requirements
+------------
+* PHP >=5.3.3
+* cURL extension for PHP
+
+Installation
+------------
+You must install this library through Composer:
+
+```bash
+# Install Composer
+curl -sS https://getcomposer.org/installer | php
+
+# Require php-opencloud as a dependency
+php composer.phar require rackspace/php-opencloud
+```
+
+Once you have installed the library, you will need to load Composer's autoloader (which registers all the required
+namespaces):
+
+```php
+require 'vendor/autoload.php';
+```
+
+And you're ready to go!
+
+You can also check out the [Getting Started guide](docs/getting-started.md) for a quick tutorial.
+
+- - -
+
+Alternatively, if you would like to fork or clone the repository into a directory (to work and submit pull requests),
+you will need to execute:
+
+```bash
+php composer.phar install
+```
+
+Instead of the `require` command. You can also specify the `--no-dev` option if you do not want to install phpDocumentor
+(which has lots of vendor folders).
+
+Support and Feedback
+--------------------
+Your feedback is appreciated! If you have specific problems or bugs with this SDK, please file an issue on Github. We
+also have a [mailing list](https://groups.google.com/forum/#!forum/php-opencloud), so feel free to join to keep up to
+date with all the latest changes and announcements to the library.
+
+For general feedback and support requests, send an email to sdk-support@rackspace.com.
+
+You can also find assistance via IRC on #rackspace at freenode.net.
+
+Contributing
+------------
+If you'd like to contribute to the project, or require help running the unit/acceptance tests, please view the
+[contributing guidelines](https://github.com/rackspace/php-opencloud/blob/master/CONTRIBUTING.md).

data/Rakefile

@@ -0,0 +1,12 @@
+require 'bundler/gem_tasks'
+require 'rubocop/rake_task'
+require 'rake/notes/rake_task'
+require 'rspec/core/rake_task'
+
+task default: [:spec, :rubocop, :notes]
+
+RSpec::Core::RakeTask.new('spec')
+RuboCop::RakeTask.new(:rubocop) do |task|
+  # abort rake on failure
+  task.fail_on_error = true
+end

data/bin/psychic

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+require 'psychic/cli'
+
+Psychic::CLI.start

data/lib/psychic/cli.rb

@@ -0,0 +1,37 @@
+require 'thor'
+require 'psychic/runner'
+
+module Psychic
+  class CLI < Thor
+    desc 'run_task <name>', 'Executes a custom task by name'
+    def run_task(task_name, *args)
+      result = runner.execute_task(task_name, *args)
+      result.error!
+      say_status :success, task_name
+    rescue Psychic::Shell::ExecutionError => e
+      say_status :failed, task_name, :red
+      say e.execution_result if e.execution_result
+    end
+
+    desc 'run_sample <name>', 'Executes a code sample'
+    def run_sample(sample_name, *args)
+      result = runner.run_sample(sample_name, *args)
+      result.error!
+      say_status :success, sample_name
+    rescue Errno::ENOENT => e
+      say_status :failed, "No code sample found for #{sample_name}", :red
+    rescue Psychic::Shell::ExecutionError => e
+      say_status :failed, "Executing sample #{sample_name}", :red
+      say e.execution_result if e.execution_result
+    end
+
+    private
+
+    def runner
+      # Psychic::Shell.shell = shell
+      @runner ||= Psychic::Runner.new
+    end
+  end
+end
+
+# require 'psychic/commands/exec'

data/lib/psychic/commands/exec.rb

@@ -0,0 +1,19 @@
+module Psychic
+  module Commands
+    class Exec < Thor
+      desc 'task <name>', 'Executes a custom task by name'
+      def task(task_name)
+        # Psychic::Shell.shell = shell
+        runner = Psychic::Runner.new
+        result = runner.public_send(task_name.to_sym)
+        result.error!
+        say_status :success, task_name
+      rescue Psychic::Shell::ExecutionError => e
+        say_status :failed, task_name, :red
+        say e.execution_result if e.execution_result
+      end
+    end
+  end
+end
+
+Psychic::CLI.register(Psychic::Commands::Exec, 'exec', 'exec <task>', 'Execute things via psychic')

data/lib/psychic/logger.rb

@@ -0,0 +1,17 @@
+require 'logger'
+
+module Psychic
+  module Logger
+    def logger
+      @logger ||= new_logger
+    end
+
+    def new_logger(_io = $stdout, _level = :debug)
+      ::Logger.new(STDOUT)
+    end
+
+    def log_level=(level)
+      logger.level = level
+    end
+  end
+end

data/lib/psychic/runner/base_runner.rb

@@ -0,0 +1,68 @@
+module Psychic
+  class Runner
+    module BaseRunner
+      include Psychic::Shell
+      include Psychic::Logger
+
+      attr_reader :known_tasks
+      attr_reader :cwd
+
+      module ClassMethods
+        attr_accessor :magic_file_pattern
+
+        def register_runner
+          Psychic::Runner::ColdRunnerRegistry.register(self)
+        end
+
+        def magic_file(pattern) # rubocop:disable Style/TrivialAccessors
+          @magic_file_pattern = pattern
+        end
+      end
+
+      def self.included(base)
+        base.extend(ClassMethods)
+      end
+
+      def initialize(opts = {})
+        opts[:cwd] ||= Dir.pwd
+        @logger = opts[:logger] || new_logger
+        @cwd = opts[:cwd]
+        @opts = opts
+      end
+
+      def respond_to_missing?(task, include_all = false)
+        return true if known_tasks.include?(task.to_s)
+        super
+      end
+
+      def method_missing(task, *args, &block)
+        execute_task(task, *args)
+      rescue Psychic::Runner::TaskNotImplementedError
+        super
+      end
+
+      # Reserved words
+
+      def execute(command, *args)
+        full_cmd = [command, *args].join(' ')
+        logger.info("Executing #{full_cmd}")
+        shell.execute(full_cmd, @opts)
+      end
+
+      def command_for_task(task, *_args)
+        task_name = task.to_s
+        self[task_name]
+      end
+
+      def execute_task(task, *args)
+        command = command_for_task(task, *args)
+        fail Psychic::Runner::TaskNotImplementedError if command.nil?
+        execute(command, *args)
+      end
+
+      def active?
+        self.class.magic_file_pattern ? false : Dir["#{@cwd}/#{self.class.magic_file_pattern}"]
+      end
+    end
+  end
+end

data/lib/psychic/runner/cold/shell_script_runner.rb

@@ -0,0 +1,38 @@
+module Psychic
+  class Runner
+    module Cold
+      class ShellScriptRunner
+        include BaseRunner
+        EXTENSIONS = ['.sh', '']
+        magic_file 'scripts/*'
+        register_runner
+
+        def initialize(opts)
+          super
+          @known_tasks = Dir["#{@cwd}/scripts/*"].map do | script |
+            File.basename(script, File.extname(script)) if EXTENSIONS.include?(File.extname(script))
+          end
+        end
+
+        def [](task_name)
+          task = task_name.to_s
+          script = Dir["#{@cwd}/scripts/#{task}{.sh,}"].first
+          if script
+            cmd = Psychic::Util.relativize(script, @cwd)
+            cmd = [cmd, args_for_task(task_name)].compact.join(' ')
+            "./#{cmd}" unless cmd.to_s.start_with? '/'
+          end
+        end
+
+        def args_for_task(task)
+          # HACK: Need a better way to deal with args
+          '{{sample_file}}' if task == 'run_sample'
+        end
+
+        def active?
+          true
+        end
+      end
+    end
+  end
+end

data/lib/psychic/runner/cold_runner_registry.rb

@@ -0,0 +1,31 @@
+module Psychic
+  class Runner
+    class ColdRunnerRegistry
+      include Psychic::Logger
+
+      BUILT_IN_DIR = File.expand_path('../cold', __FILE__)
+
+      class << self
+        def autoload_runners!
+          # Load built-in runners
+          Dir["#{BUILT_IN_DIR}/*.rb"].each do |cold_runner_file|
+            require cold_runner_file
+          end
+        end
+
+        def runner_classes
+          @runner_classes ||= Set.new
+        end
+
+        def register(klass)
+          runner_classes.add klass
+        end
+
+        def active_runners(opts)
+          runners = runner_classes.map { |k| k.new(opts) }
+          runners.select(&:active?)
+        end
+      end
+    end
+  end
+end

data/lib/psychic/runner/hot_runner.rb

@@ -0,0 +1,25 @@
+module Psychic
+  class Runner
+    class HotRunner
+      include BaseRunner
+      def initialize(opts = {})
+        hints = opts.delete :hints
+        super
+        @hints = Psychic::Util.stringified_hash(hints || load_hints || {})
+        @tasks = @hints['tasks'] || {}
+        @known_tasks = @tasks.keys
+      end
+
+      def [](task_name)
+        @tasks[task_name]
+      end
+
+      private
+
+      def load_hints
+        hints_file = Dir["#{@cwd}/psychic-hints.{yaml,yml}"].first
+        YAML.load(File.read(hints_file)) unless hints_file.nil?
+      end
+    end
+  end
+end

data/lib/psychic/runner/sample_runner.rb

@@ -0,0 +1,50 @@
+module Psychic
+  class Runner
+    module SampleRunner
+      def run_sample(code_sample, *args)
+        sample_file = Psychic::Util.find_file_by_alias(code_sample, cwd)
+        process_template(sample_file) if templated?
+        command = command_for_task('run_sample')
+        if command
+          variables = { sample: code_sample, sample_file: sample_file }
+          command = Psychic::Util.replace_tokens(command, variables)
+          execute(command, *args)
+        else
+          run_sample_file(sample_file)
+        end
+      end
+
+      def run_sample_file(sample_file, *args)
+        execute("./#{sample_file}", *args) # Assuming Bash, but should detect Windows and use PowerShell
+      end
+
+      def process_template(sample_file)
+        absolute_sample_file = File.expand_path(sample_file, cwd)
+        template = File.read(absolute_sample_file)
+        # Default token pattern/replacement (used by php-opencloud) should be configurable
+        content = Psychic::Util.replace_tokens(template, variables, /'\{(\w+)\}'/, "'\\1'")
+
+        # Backup and overwrite
+        backup_file = "#{absolute_sample_file}.bak"
+        fail 'Please clear out old backups before rerunning' if File.exist? backup_file
+        FileUtils.cp(absolute_sample_file, backup_file)
+        File.write(absolute_sample_file, content)
+      end
+
+      def templated?
+        # Probably not the best way to turn this on/off
+        true unless variables.nil?
+      end
+
+      def variables
+        # ... or
+        variables_file = Dir["#{cwd}/psychic-variables.{yaml,yml}"].first
+        return nil unless variables_file
+        environment_variables = ENV.to_hash
+        environment_variables.merge!(@opts[:env]) if @opts[:env]
+        variables = Psychic::Util.replace_tokens(File.read(variables_file), environment_variables)
+        YAML.load(variables)
+      end
+    end
+  end
+end

data/lib/psychic/runner/version.rb

@@ -0,0 +1,5 @@
+module Psychic
+  class Runner
+    VERSION = '0.0.2'
+  end
+end

data/lib/psychic/runner.rb

@@ -0,0 +1,37 @@
+require 'psychic/runner/version'
+
+autoload :YAML, 'yaml'
+
+module Psychic
+  autoload :Util,   'psychic/util'
+  autoload :Logger, 'psychic/logger'
+  autoload :Shell,  'psychic/shell'
+  class Runner
+    autoload :BaseRunner, 'psychic/runner/base_runner'
+    autoload :SampleRunner, 'psychic/runner/sample_runner'
+    autoload :HotRunner, 'psychic/runner/hot_runner'
+    autoload :CompoundRunner, 'psychic/runner/compound_runner'
+    autoload :ColdRunnerRegistry, 'psychic/runner/cold_runner_registry'
+    class TaskNotImplementedError < NotImplementedError; end
+    ColdRunnerRegistry.autoload_runners!
+
+    include BaseRunner
+    include SampleRunner
+    attr_reader :runners, :hot_runner, :cold_runners
+
+    def initialize(opts = { cwd: Dir.pwd })
+      fail 'cwd is required' unless opts[:cwd]
+      super
+      @hot_runner = HotRunner.new(opts)
+      @cold_runners = ColdRunnerRegistry.active_runners(opts)
+      @runners = [@hot_runner, @cold_runners].flatten
+      @known_tasks = @runners.map(&:known_tasks).uniq
+    end
+
+    def [](task_name)
+      runner = runners.find { |r| r.command_for_task(task_name) }
+      return nil unless runner
+      runner[task_name]
+    end
+  end
+end

data/lib/psychic/shell/execution_result.rb

@@ -0,0 +1,42 @@
+require 'English'
+
+module Psychic
+  module Shell
+    class ExecutionError < StandardError
+      attr_accessor :execution_result
+    end
+
+    class ExecutionResult
+      attr_reader :exitstatus
+      attr_reader :stdout
+      attr_reader :stderr
+      # coerce_value String, ->(v) { v.force_encoding('utf-8') }
+
+      def initialize(results)
+        @exitstatus = results.fetch(:exitstatus)
+        # Needs to be UTF-8 to serialize as YAML
+        @stdout = results.fetch(:stdout).force_encoding('utf-8')
+        @stderr = results.fetch(:stderr).force_encoding('utf-8')
+      end
+
+      def error!
+        if @exitstatus != 0
+          error = ExecutionError.new
+          error.execution_result = self
+          fail error
+        end
+      end
+
+      def to_s
+        ''"
+        Execution Result:
+          exitstatus: #{exitstatus}
+          stdout:
+        #{stdout}
+          stderr:
+        #{stderr}
+        "''
+      end
+    end
+  end
+end

data/lib/psychic/shell/mixlib_shellout_executor.rb

@@ -0,0 +1,62 @@
+require 'mixlib/shellout'
+
+module Psychic
+  module Shell
+    class IOToLog < IO
+      def initialize(logger)
+        @logger = logger
+        @buffer = ''
+      end
+
+      def write(string)
+        (@buffer + string).lines.each do |line|
+          if line.end_with? "\n"
+            @buffer = ''
+            @logger.info(line.rstrip)
+          else
+            @buffer = line
+          end
+        end
+      end
+    end
+
+    class MixlibShellOutExecutor
+      include Psychic::Logger
+      attr_reader :shell
+
+      MIXLIB_SHELLOUT_EXCEPTION_CLASSES = Mixlib::ShellOut.constants.map do|name|
+        klass = Mixlib::ShellOut.const_get(name)
+        if klass.is_a?(Class) && klass <= RuntimeError
+          klass
+        else
+          nil
+        end
+      end.compact
+
+      def execute(command, opts)
+        @logger = opts.delete(:logger) || logger
+        @shell = Mixlib::ShellOut.new(command, opts)
+        @shell.live_stream = IOToLog.new(@logger)
+        @shell.run_command
+        execution_result
+      rescue SystemCallError, *MIXLIB_SHELLOUT_EXCEPTION_CLASSES, TypeError => e
+        # See https://github.com/opscode/mixlib-shellout/issues/62
+        execution_error = ExecutionError.new(e)
+        execution_error.execution_result = execution_result
+        raise execution_error
+      end
+
+      private
+
+      def execution_result
+        return nil if shell.nil?
+
+        ExecutionResult.new(
+          exitstatus: shell.exitstatus,
+          stdout: shell.stdout,
+          stderr: shell.stderr
+        )
+      end
+    end
+  end
+end

data/lib/psychic/shell.rb

@@ -0,0 +1,19 @@
+module Psychic
+  module Shell
+    autoload :ExecutionResult, 'psychic/shell/execution_result'
+    autoload :ExecutionError, 'psychic/shell/execution_result'
+    autoload :MixlibShellOutExecutor, 'psychic/shell/mixlib_shellout_executor'
+
+    class << self
+      attr_writer :shell
+    end
+
+    def self.shell
+      @shell ||=  MixlibShellOutExecutor.new
+    end
+
+    def shell
+      Psychic::Shell.shell
+    end
+  end
+end

data/lib/psychic/tokens.rb

@@ -0,0 +1,39 @@
+autoload :Mustache, 'mustache'
+
+module Psychic
+  class RegexpTokenHandler
+    def initialize(template, token_pattern, token_replacement)
+      @template = template
+      @token_pattern = token_pattern
+      @token_replacement = token_replacement
+    end
+
+    def tokens
+      @template.scan(@token_pattern).flatten.uniq
+    end
+
+    def replace(variables = {})
+      @template.gsub(@token_pattern) do
+        full_match = Regexp.last_match[0]
+        key = Regexp.last_match[1]
+        value = variables[key]
+        value = @token_replacement.gsub('\\1', value.to_s) unless @token_replacement.nil?
+        full_match.gsub(@token_pattern, value)
+      end
+    end
+  end
+
+  class MustacheTokenHandler
+    def initialize(template)
+      @template = Mustache::Template.new(template)
+    end
+
+    def tokens
+      @template.tags
+    end
+
+    def replace(variables = {})
+      Mustache.render(@template, variables)
+    end
+  end
+end

data/lib/psychic/util.rb

@@ -0,0 +1,108 @@
+module Psychic
+  autoload :RegexpTokenHandler, 'psychic/tokens'
+  autoload :MustacheTokenHandler, 'psychic/tokens'
+  class Util
+    # Returns a new Hash with all key values coerced to strings. All keys
+    # within a Hash are coerced by calling #to_s and hashes with arrays
+    # and other hashes are traversed.
+    #
+    # @param obj [Object] the hash to be processed. While intended for
+    #   hashes, this method safely processes arbitrary objects
+    # @return [Object] a converted hash with all keys as strings
+    def self.stringified_hash(obj)
+      if obj.is_a?(Hash)
+        obj.each_with_object({}) do |(k, v), h|
+          h[k.to_s] = stringified_hash(v)
+        end
+      elsif obj.is_a?(Array)
+        obj.each_with_object([]) do |e, a|
+          a << stringified_hash(e)
+        end
+      else
+        obj
+      end
+    end
+
+    def self.relativize(file, base_path)
+      absolute_file = File.absolute_path(file)
+      absolute_base_path = File.absolute_path(base_path)
+      Pathname.new(absolute_file).relative_path_from Pathname.new(absolute_base_path)
+    end
+
+    def self.slugify(*labels)
+      labels.map do |label|
+        label.downcase.gsub(/[\.\s-]/, '_')
+      end.join('-')
+    end
+
+    def self.find_file_by_alias(file_alias, search_path, ignored_patterns = nil)
+      FileFinder.new(search_path, ignored_patterns).find_file(file_alias)
+    end
+
+    def self.replace_tokens(template, variables, token_regexp = nil, token_replacement = nil)
+      if token_regexp.nil?
+        MustacheTokenHandler.new(template).replace(variables)
+      else
+        RegexpTokenHandler.new(template, token_regexp, token_replacement).replace(variables)
+      end
+    end
+  end
+
+  class FileFinder
+    attr_reader :search_path, :ignored_patterns
+
+    def initialize(search_path, ignored_patterns)
+      @search_path = search_path
+      @ignored_patterns = ignored_patterns || read_gitignore(search_path)
+    end
+
+    # Finds a file by loosely matching the file name to a scenario name
+    def find_file(name)
+      return name if File.exist? File.expand_path(name, search_path)
+
+      # Filter out ignored filesFind the first file, not including generated files
+      files = potential_files(name).select do |f|
+        !ignored? f
+      end
+
+      # Select the shortest path, likely the best match
+      file = files.min_by(&:length)
+
+      fail Errno::ENOENT, "No file was found for #{name} within #{search_path}" if file.nil?
+      Psychic::Util.relativize(file, search_path)
+    end
+
+    def potential_files(name)
+      slugified_name = Psychic::Util.slugify(name)
+      glob_string = "#{search_path}/**/*#{slugified_name}*.*"
+      potential_files = Dir.glob(glob_string, File::FNM_CASEFOLD)
+      potential_files.concat Dir.glob(glob_string.gsub('_', '-'), File::FNM_CASEFOLD)
+      potential_files.concat Dir.glob(glob_string.gsub('_', ''), File::FNM_CASEFOLD)
+    end
+
+    private
+
+    # @api private
+    def read_gitignore(dir)
+      gitignore_file = "#{dir}/.gitignore"
+      File.read(gitignore_file)
+    rescue
+      ''
+    end
+
+    # @api private
+    def ignored?(target_file)
+      # Trying to match the git ignore rules but there's some discrepencies.
+      ignored_patterns.split.find do |pattern|
+        # if git ignores a folder, we should ignore all files it contains
+        pattern = "#{pattern}**" if pattern[-1] == '/'
+        started_with_slash = pattern.start_with? '/'
+
+        pattern.gsub!(%r{\A/}, '') # remove leading slashes since we're searching from root
+        file = Psychic::Util.relativize(target_file, search_path)
+        ignored = file.fnmatch? pattern
+        ignored || (file.fnmatch? "**/#{pattern}" unless started_with_slash)
+      end
+    end
+  end
+end

data/psychic-runner.gemspec

@@ -0,0 +1,33 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'psychic/runner/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'psychic-runner'
+  spec.version       = Psychic::Runner::VERSION
+  spec.authors       = ['Max Lincoln']
+  spec.email         = ['max@devopsy.com']
+  spec.summary       = 'Psychic runs anything.'
+  spec.description   = 'Provides cross-project aliases for running tasks or similar code samples.'
+  # spec.homepage      = ''
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'thor', '~> 0.19'
+  spec.add_dependency 'mixlib-shellout', '~> 1.3' # Used for MRI
+  # spec.add_dependency "buff-shell_out", "~> 0.1"  # Used for JRuby
+  spec.add_dependency 'mustache', '~> 0.99'
+  spec.add_development_dependency 'bundler', '~> 1.7'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rake-notes'
+  spec.add_development_dependency 'simplecov'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'rubocop', '~> 0.18', '<= 0.27'
+  spec.add_development_dependency 'rubocop-rspec', '~> 1.2'
+  spec.add_development_dependency 'aruba'
+end

data/spec/psychic/runner/cold/shell_script_runner_spec.rb

@@ -0,0 +1,80 @@
+module Psychic
+  class Runner
+    module Cold
+      RSpec.describe ShellScriptRunner do
+        let(:shell) { Psychic::Shell.shell = double('shell') }
+        subject { described_class.new(cwd: current_dir) }
+
+        shared_context 'with scripts/*.sh files' do
+          before(:each) do
+            write_file 'scripts/bootstrap.sh', ''
+            write_file 'scripts/compile.sh', ''
+            write_file 'scripts/foo.ps1', ''
+          end
+        end
+
+        shared_context 'with scripts/* (no extension) files' do
+          before(:each) do
+            write_file 'scripts/bootstrap', ''
+            write_file 'scripts/compile', ''
+            write_file 'scripts/.foo', ''
+          end
+        end
+
+        describe 'respond_to?' do
+          shared_examples 'detects matching scripts' do
+            it 'returns true if a matching script exists' do
+              expect(subject.respond_to? :bootstrap).to be true
+              expect(subject.respond_to? :compile).to be true
+            end
+            it 'returns false if a matching script does not exists' do
+              expect(subject.respond_to? :foo).to be false
+              expect(subject.respond_to? :bar).to be false
+            end
+          end
+
+          context 'with scripts/*.sh files' do
+            include_context 'with scripts/*.sh files' do
+              include_examples 'detects matching scripts'
+            end
+          end
+
+          context 'with scripts/* (no extension) files' do
+            include_context 'with scripts/* (no extension) files' do
+              include_examples 'detects matching scripts'
+            end
+          end
+        end
+
+        describe '#method_missing' do
+          context 'matching a task' do
+            context 'with scripts/*.sh files' do
+              include_context 'with scripts/*.sh files' do
+                it 'executes the script command' do
+                  expect(shell).to receive(:execute).with('./scripts/bootstrap.sh', cwd: current_dir)
+                  subject.bootstrap
+                end
+              end
+            end
+
+            context 'with scripts/* (no extension) files' do
+              include_context 'with scripts/* (no extension) files' do
+                it 'executes the script command' do
+                  expect(shell).to receive(:execute).with('./scripts/bootstrap', cwd: current_dir)
+                  subject.bootstrap
+                end
+              end
+            end
+          end
+
+          context 'not matching a task' do
+            it 'raises an error' do
+              # Use foo to ensure it doesn't match ps1 or hidden (. prefixed) files
+              expect { subject.foo }.to raise_error(NoMethodError)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/spec/psychic/runner/hot_runner_spec.rb

@@ -0,0 +1,63 @@
+module Psychic
+  class Runner
+    RSpec.describe HotRunner do
+      let(:task_map) do
+        {
+          'bootstrap' => 'foo',
+          'compile'   => 'bar',
+          'execute'   => 'baz'
+        }
+      end
+      let(:shell) { Psychic::Shell.shell = double('shell') }
+      subject { described_class.new(cwd: current_dir, hints: task_map) }
+
+      shared_examples 'runs tasks' do
+        describe 'respond_to?' do
+          it 'returns true for task ids' do
+            task_map.each_key do |key|
+              expect(subject.respond_to? key).to be true
+            end
+          end
+
+          it 'returns false for anything else' do
+            expect(subject.respond_to? 'max').to be false
+          end
+        end
+
+        describe '#method_missing' do
+          context 'matching a task' do
+            it 'executes the task command' do
+              expect(shell).to receive(:execute).with('foo', cwd: current_dir)
+              subject.bootstrap
+            end
+          end
+
+          context 'not matching a task' do
+            it 'raises an error' do
+              expect { subject.spin_around }.to raise_error(NoMethodError)
+            end
+          end
+        end
+      end
+
+      context 'task map stored in psychic-hints.yml' do
+        let(:hints) do
+          { 'tasks' => task_map }
+        end
+        before(:each) do
+          write_file 'psychic-hints.yml', YAML.dump(hints)
+        end
+        subject { described_class.new(cwd: current_dir) }
+        include_examples 'runs tasks'
+      end
+
+      context 'hints passed as a parameter' do
+        let(:hints) do
+          { 'tasks' => task_map }
+        end
+        subject { described_class.new(cwd: current_dir, hints: hints) }
+        include_examples 'runs tasks'
+      end
+    end
+  end
+end

data/spec/psychic/runner_spec.rb

@@ -0,0 +1,45 @@
+require 'spec_helper'
+
+module Psychic
+  RSpec.describe Runner do
+    subject { described_class.new(cwd: current_dir) }
+    context 'when psychic-hints.yml exists' do
+      let(:hints) do
+        {
+          'tasks' =>
+          {
+            'bootstrap' => 'foo',
+            'compile'   => 'bar',
+            'execute'   => 'baz'
+          }
+        }
+      end
+
+      before(:each) do
+        write_file 'psychic-hints.yml', YAML.dump(hints)
+      end
+
+      describe 'initialize' do
+        it 'should create a HotRunner for the specified directory' do
+          expect(subject.hot_runner).to be_an_instance_of(Psychic::Runner::HotRunner)
+          expect(subject.cwd).to eq(current_dir)
+        end
+      end
+    end
+
+    context 'when scripts/* exist' do
+      before(:each) do
+        write_file 'scripts/bootstrap.sh', ''
+        write_file 'scripts/foo.sh', ''
+      end
+
+      describe 'initialize' do
+        it 'should create a cold runner for ShellScriptRunner' do
+          expect(subject.cold_runners).to include(
+            an_instance_of(Psychic::Runner::Cold::ShellScriptRunner)
+          )
+        end
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,47 @@
+require 'simplecov'
+SimpleCov.start
+
+require 'rspec'
+require 'psychic/runner'
+require 'aruba'
+require 'aruba/api'
+
+# Config required for project
+RSpec.configure do | config |
+  config.include Aruba::Api
+  config.before(:example) do
+    @aruba_timeout_seconds = 30
+    clean_current_dir
+  end
+end
+
+# Configs recommended by RSpec
+RSpec.configure do |config|
+  config.warnings = true
+  config.disable_monkey_patching!
+  config.filter_run :focus
+  config.run_all_when_everything_filtered = true
+
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4.
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+  if config.files_to_run.one?
+    # Use the documentation formatter for detailed output,
+    # unless a formatter has already been configured
+    # (e.g. via a command-line flag).
+    config.default_formatter = 'doc'
+  end
+
+  config.profile_examples = 10
+  config.order = :random
+  Kernel.srand config.seed
+end

metadata

@@ -0,0 +1,239 @@
+--- !ruby/object:Gem::Specification
+name: psychic-runner
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Max Lincoln
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-12-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
+- !ruby/object:Gem::Dependency
+  name: mixlib-shellout
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: mustache
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.99'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.99'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !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: rake-notes
+  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'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  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'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.18'
+    - - "<="
+      - !ruby/object:Gem::Version
+        version: '0.27'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.18'
+    - - "<="
+      - !ruby/object:Gem::Version
+        version: '0.27'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: aruba
+  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: Provides cross-project aliases for running tasks or similar code samples.
+email:
+- max@devopsy.com
+executables:
+- psychic
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".rubocop_todo.yml"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/psychic
+- lib/psychic/cli.rb
+- lib/psychic/commands/exec.rb
+- lib/psychic/logger.rb
+- lib/psychic/runner.rb
+- lib/psychic/runner/base_runner.rb
+- lib/psychic/runner/cold/shell_script_runner.rb
+- lib/psychic/runner/cold_runner_registry.rb
+- lib/psychic/runner/hot_runner.rb
+- lib/psychic/runner/sample_runner.rb
+- lib/psychic/runner/version.rb
+- lib/psychic/shell.rb
+- lib/psychic/shell/execution_result.rb
+- lib/psychic/shell/mixlib_shellout_executor.rb
+- lib/psychic/tokens.rb
+- lib/psychic/util.rb
+- psychic-runner.gemspec
+- spec/psychic/runner/cold/shell_script_runner_spec.rb
+- spec/psychic/runner/hot_runner_spec.rb
+- spec/psychic/runner_spec.rb
+- spec/spec_helper.rb
+homepage: 
+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.4.2
+signing_key: 
+specification_version: 4
+summary: Psychic runs anything.
+test_files:
+- spec/psychic/runner/cold/shell_script_runner_spec.rb
+- spec/psychic/runner/hot_runner_spec.rb
+- spec/psychic/runner_spec.rb
+- spec/spec_helper.rb