hay 0.0.1.pre.alpha.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3e9f58b9c8931713ab80709d18de6eacf67cf121
+  data.tar.gz: 1f80d87fc28483308026bd62a36c228ea2238989
+SHA512:
+  metadata.gz: 0f20a6d70a05ce284af2a3c8b22bd040a426a393b358a937d1f6e8fa8d1e418b1e4a009f5497b6953bc67041f13d69d96cab4474fd700247ec6e70ebf3f7be97
+  data.tar.gz: a062287b084f6fc0f6b2f1e9636ae5f6f732edf3504dcdbe01868edcb8debdca8088f5e42ebccf07fc7109a3017614f7e2cec68ab535f28549d7f9cbe439434f

data/.gitignore

@@ -0,0 +1,34 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+Gemfile.lock
+.ruby-version
+.ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/.travis.yml

@@ -0,0 +1,17 @@
+language: ruby
+
+env:
+  global:
+    - COVERAGE=true
+  matrix:
+    - TEST_SUITE=unit
+    - TEST_SUITE=integration
+
+script: "bundle exec rake test:$TEST_SUITE"
+
+rvm:
+  - "1.9.3"
+  - "2.1.3"
+  - "ruby-head"
+  - "jruby-19mode"
+  - "rbx-2"

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+gem 'coveralls', group: :test, require: false
+gem 'codeclimate-test-reporter', group: :test, require: nil
+
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Ed Carrel
+
+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,3 @@
+Hay
+=======
+A workflow definition framework.

data/Rakefile

@@ -0,0 +1,60 @@
+require 'rake/testtask'
+
+$LOAD_PATH.push("rakelib")
+require 'hay/rake'
+
+require 'coveralls/rake/task'
+
+Edger::Rake::Tasks.new do |t|
+end
+
+namespace :cov do
+  
+  desc "Rake tests and then open report"
+  task :run do
+    puts 'Running Tests...'
+    `rake`
+    puts 'Opening Report.'
+    path = File.expand_path('../../../', __FILE__)
+    `open #{path}/coverage/index.html`
+  end
+  
+  desc "View coverage report"
+  task :report do
+    path = File.expand_path('../../../', __FILE__)
+    `open #{path}/coverage/index.html`
+  end
+end
+
+namespace :coinstar do
+  task :test do
+    Rake::Task['test'].invoke
+  end
+end
+
+task :test do
+  Rake::Task['test:unit'].invoke
+  Rake::Task['test:integration'].invoke
+end
+
+namespace :test do
+  Rake::TestTask.new("integration") do |t|
+    t.libs << "test"
+    t.libs << "config"
+    t.test_files = FileList['test/integration/**/*_test.rb']
+    t.verbose = true
+  end
+
+  Rake::TestTask.new("unit") do |t|
+    t.libs << "test"
+    t.libs << "config"
+    t.test_files = FileList['test/unit/**/*_test.rb']
+    t.verbose = true
+  end
+end
+
+Coveralls::RakeTask.new
+
+task :test_with_coveralls => ['test:unit', 'test:integration', 'coveralls:push']
+
+task :default => :test_with_coveralls

data/hay.gemspec

@@ -0,0 +1,30 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'hay/version'
+
+Gem::Specification.new do |spec|
+  spec.name        = "hay"
+  spec.version     = Hay::VERSION
+  spec.summary     = "A workflow definition framework."
+  spec.description = "A generic workflow definition framework."
+  spec.platform    = "ruby"
+
+  spec.homepage    = "https://github.com/azanar/hay"
+  spec.license     = "MIT"
+
+  spec.authors     = ["Ed Carrel"]
+  spec.email       = ["edward@carrel.org"]
+
+  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_runtime_dependency 'punchout', '~> 0'
+
+  spec.add_development_dependency 'test-unit', '~> 3'
+  spec.add_development_dependency 'mocha', '~> 1'
+  spec.add_development_dependency 'simplecov', '~> 0'
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake", "~> 10.0"
+end

data/lib/hay/consumer.rb

@@ -0,0 +1,27 @@
+require 'hay'
+
+require 'hay/queue'
+require 'hay/task/resolver'
+require 'hay/task/resolvers'
+
+module Hay
+  module Consumer
+    def initialize(agent)
+      @queue = Hay::Queue.new(self, agent)
+    end
+
+    def ours?(task)
+      task_names.include?(task.task_name)
+    end
+
+    def push(task)
+      resolved_task = Hay::Task::Resolver.new(task)
+      @queue.push(resolved_task)
+      @queue.run
+    end
+
+    def task_names
+      @task_names ||= tasks.map(&:task_name)
+    end
+  end
+end

data/lib/hay/dispatcher.rb

@@ -0,0 +1,23 @@
+require 'hay'
+
+require 'hay/router'
+require 'hay/message'
+
+module Hay
+  class Dispatcher
+    def initialize(consumer, agent)
+      @consumer = consumer
+      @agent = agent
+      @router = Hay::Router.new(@agent)
+    end
+
+    def push(task)
+      if @consumer.ours?(task)
+        @consumer.push(task)
+      else
+        message = Hay::Message.new(task)
+        @router.push(message)
+      end
+    end
+  end
+end

data/lib/hay/message.rb

@@ -0,0 +1,28 @@
+require 'hay/routes'
+
+module Hay
+  class Message
+    def initialize(task)
+      @task = task
+      if @task.class == Hash
+        raise "god damn it all #{@task}"
+      end
+    end
+
+    attr_reader :task
+
+    def payload
+      @payload ||= @task.dehydrate
+    end
+
+    def destination
+      @destination ||= build_destination
+    end
+
+    private
+
+    def build_destination
+      Hay::Routes.for_name(@task.task_name) or raise "Could not find route for task #{@task.task_name}"
+    end
+  end
+end

data/lib/hay/queue.rb

@@ -0,0 +1,22 @@
+require 'hay/dispatcher'
+
+module Hay
+  class Queue
+    def initialize(consumer, agent)
+      @queue = []
+      @dispatcher = Hay::Dispatcher.new(consumer, agent)
+    end
+
+    def push(task)
+      @queue << task
+    end
+
+    def run
+      until @queue.empty?
+        task = @queue.shift
+        task.process(@dispatcher)
+      end
+    end
+  end
+end
+

data/lib/hay/route.rb

@@ -0,0 +1,29 @@
+module Hay
+  module Route
+    class << self
+      def queue_name
+        raise NotImplementedException
+      end
+
+      def included(route)
+        Hay::Routes.register(route)
+      end
+    end
+
+    def initialize(agent)
+      @agent = agent
+    end
+
+    def tasks
+      raise NotImplementedException
+    end
+
+    def push(message)
+      @agent.publish(message)
+    end
+
+    def ours?(message)
+      tasks.include?(message.task.class)
+    end
+  end
+end

data/lib/hay/router.rb

@@ -0,0 +1,25 @@
+require 'hay/dispatcher'
+require 'hay/routes'
+
+module Hay
+  class Router
+    def initialize(agent)
+      @agent = agent
+    end
+
+    def push(message)
+      route_klass = message.destination
+
+      if route_klass.nil?
+        Hay.logger.error "Unknown route for task #{message.destination}"
+        raise "Unknown route for task #{message.destination}"
+      end
+
+      route = route_klass.new(@agent)
+
+      route.push(message)
+    end
+  end
+end
+
+

data/lib/hay/routes.rb

@@ -0,0 +1,24 @@
+require 'punchout'
+require 'punchout/matcher/equal'
+
+module Hay
+  module Routes
+    extend Punchout::Punchable
+
+    def self.register(route)
+      route.tasks.each do |task|
+        matchable = Punchout::Matcher::Equal.new(task.task_name).punches(route)
+        puncher.add(matchable)
+      end
+    end
+
+    def self.for_task(task)
+      punch(task.task_name)
+    end
+
+    def self.for_name(name)
+      punch(name)
+    end
+  end
+end
+

data/lib/hay/task/decorator.rb

@@ -0,0 +1,35 @@
+require 'delegate'
+
+module Hay
+  module Task
+    class Decorator < SimpleDelegator 
+
+
+      def initialize(obj)
+        super
+      end
+
+      attr_writer :flow
+
+      def flow
+        @flow ||= Hay::Task::Flow.new
+      end
+
+      def dehydrate
+        {
+          "name" => task_name,
+          "task" => super,
+          "flow" => flow.dehydrate
+        }
+      end
+
+      def process(dispatcher)
+        resulter = Hay::Task::Resulter.new(flow, dispatcher)
+        super(resulter)
+      end
+    end
+  end
+end
+
+require 'hay/task/flow'
+require 'hay/task/resulter'

data/lib/hay/task/exception/transient_exception.rb

@@ -0,0 +1,10 @@
+require 'hay/task/exception'
+
+module Hay
+  module Task
+    class Exception < StandardError
+      class TransientException < Hay::Task::Exception
+      end
+    end
+  end
+end

data/lib/hay/task/exception/unknown_template_error.rb

@@ -0,0 +1,16 @@
+module Hay
+  module Task
+    class Exception < StandardError
+      class UnknownTemplateError < StandardError
+        def initialize(template_name)
+          @template_name = template_name
+        end
+
+        def message
+          "Failed to find template #{@template_name}"
+        end
+      end
+    end
+  end
+end
+

data/lib/hay/task/exception.rb

@@ -0,0 +1,11 @@
+module Hay
+  module Task
+    class Exception < StandardError
+      def initialize(cause)
+        @cause = cause
+      end
+
+      attr_accessor :cause
+    end
+  end
+end

data/lib/hay/task/flow.rb

@@ -0,0 +1,41 @@
+require 'hay'
+
+require 'hay/task/template'
+
+module Hay
+  module Task
+    class Flow
+      def initialize(list = [])
+        @tasks = list || []
+        unless @tasks.kind_of?(Array)
+          raise "This has to be an array, dude!"
+        end
+      end
+
+      def push(tasks)
+        tasks = Array(tasks)
+
+        @tasks += tasks
+      end
+
+      def dehydrate
+        @tasks.map do |n| 
+          if n.kind_of?(Hash)
+            Hay.logger.debug("Not dehydrating an already dehydrated #{n.inspect}")
+            n
+          else
+            Hay.logger.debug("Dehydrating #{n.inspect}")
+            n.dehydrate 
+          end
+        end
+      end
+
+      def inflate
+        @tasks.map do |params| 
+          Hay.logger.debug("Inflating #{params.inspect}")
+          Hay::Task::Template.new(params)
+        end
+      end
+    end
+  end
+end

data/lib/hay/task/hydrator/registry.rb

@@ -0,0 +1,21 @@
+module Hay
+  module Task
+    class Factory
+      module Registry
+        @@factories = {}
+
+        def self.register(task_class)
+          @@factories[task_class.task_name] = Hay::Task::Factory.new(task_class)
+        end
+
+        def self.factory_by_task_class(task_class)
+          @@factories[task_class.task_name]
+        end
+
+        def self.factory_by_task_name(task_name)
+          @@factories[task_name]
+        end
+      end
+    end
+  end
+end

data/lib/hay/task/hydrator.rb

@@ -0,0 +1,21 @@
+require 'hay/task/flow'
+
+module Hay
+  module Task
+    class Hydrator
+      def initialize(hash)
+        @hash = hash
+      end
+
+      def hydrate
+        task_class = Hay::Tasks.for_name(@hash['name'])
+        if task_class.nil?
+          raise "No task for name #{@hash['name']}"
+        end
+        task = task_class.new(@hash['task']).to_hay
+        task.flow = Hay::Task::Flow.new(@hash['flow'])
+        task
+      end
+    end
+  end
+end

data/lib/hay/task/hydrators.rb

@@ -0,0 +1,28 @@
+require 'hay'
+
+require 'punchout/matcher/equal'
+
+module Hay
+  module Task
+    module Hydrators
+      extend Punchout::Punchable
+
+      def self.register(task, hydrator)
+        Hay.logger.info "Registering hydrator #{task.task_name} for #{hydrator}"
+        matchable = Punchout::Matcher::Equal.new(task.task_name).punches(hydrator)
+        puncher.add(matchable)
+      end
+
+      def self.for(params)
+        if params['name'].nil?
+          raise "No name in parameter list: #{params.inspect}"
+        end
+        hydrator = punch(params['name'])
+        if hydrator.nil?
+          raise "No hydrator for task name #{params["name"]}: #{self.puncher.inspect}"
+        end
+        hydrator.new(params)
+      end
+    end
+  end
+end

data/lib/hay/task/registry.rb

@@ -0,0 +1,16 @@
+#require 'hay/task/factory'
+
+module Hay
+  module Task
+    ##
+    # A registry for any tasks which the system knows how to create.
+    #
+    module Registry
+      def self.register(task)
+        Hay.logger.info "Registering #{task} for #{task.task_name}"
+
+        #Hay::Task::Factory::Registry.register(task)
+      end
+    end
+  end
+end

data/lib/hay/task/resolver/hash.rb

@@ -0,0 +1,19 @@
+require 'hay/task/hydrators'
+require 'hay/task/resolvers'
+
+module Hay
+  module Task
+    module Resolver
+      class Hash
+        def initialize(hash)
+          @hash = hash
+        end
+
+        def build
+          Hay::Task::Hydrators.for(@hash).hydrate
+        end
+        Hay::Task::Resolvers.register(::Hash, self)
+      end
+    end
+  end
+end

data/lib/hay/task/resolver/registry.rb

@@ -0,0 +1,11 @@
+module Hay
+  module Task
+    module Resolver
+      module Registry
+        def self.resolver_for(task_class)
+          Hay::Task::Resolvers.punch(task_class)
+        end
+      end
+    end
+  end
+end

data/lib/hay/task/resolver/task.rb

@@ -0,0 +1,18 @@
+require 'hay/task/decorator'
+
+module Hay
+  module Task
+    module Resolver
+      class Task
+        def initialize(task)
+          @task = task
+        end
+
+        def build
+          @task
+        end
+        Hay::Task::Resolvers.register(Hay::Task::Decorator, self)
+      end
+    end
+  end
+end

data/lib/hay/task/resolver.rb

@@ -0,0 +1,17 @@
+require 'hay'
+
+require 'hay/task/exception/unknown_template_error'
+
+module Hay
+  module Task
+    module Resolver
+      def self.new(params)
+        resolver_class = Hay::Task::Resolvers.punch(params)
+        if resolver_class.nil?
+          raise Hay::Task::Exception::UnknownTemplateError.new("No resolver for #{params.class}")
+        end
+        resolver_class.new(params).build
+      end
+    end
+  end
+end

data/lib/hay/task/resolvers.rb

@@ -0,0 +1,20 @@
+require 'punchout'
+require 'punchout/matcher/ancestry'
+
+module Hay
+  module Task
+    module Resolvers
+      extend Punchout::Punchable
+
+      def self.register(type, resolver)
+        Hay.logger.info "Registering resolver #{type} for #{resolver}"
+        matchable = Punchout::Matcher::Ancestry.new(type).punches(resolver)
+        puncher.add(matchable)
+      end
+    end
+  end
+end
+
+require 'hay/task/resolver/hash'
+require 'hay/task/resolver/task'
+