rachinations 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 5bd962b3b335b5820974f83f65110cdb5c322e36
+  data.tar.gz: 16bd1cd9a661aaac83f2d0532898da95d60cd587
+SHA512:
+  metadata.gz: cb22e2caebc4211a0d323d5ffa4e967fb777c260fa63e4e4a8b51024d57519066e989616f928cc67830539c17cabf29d79918380f9e60050caa71f52e8a24f0e
+  data.tar.gz: 0f7bb8b7800dd390de9a51523a5cbc627bb6fdc7c3404be4e66b90e8a321aad756b3b9afadfe778c73f322af57560b3d6fb5c38a357be663b7361ae26f9e10f7

data/.coveralls.yml

@@ -0,0 +1 @@
+service_name: travis-ci

data/.gitignore

@@ -0,0 +1,6 @@
+.bundle
+.idea
+coverage
+testing/coverage
+.yardoc/
+doc/

data/.travis.yml

@@ -0,0 +1,8 @@
+language: ruby
+rvm:
+  - "ruby 2.1.1"
+install: bundle install
+branches:
+  only:
+    - master
+    - new_main_loop

data/.yardopts

@@ -0,0 +1 @@
+domain/* domain/*/* domain/*/*/* domain/*/*/*/*  dsl/* - README.md

data/Gemfile

@@ -0,0 +1,19 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in rachinations.gemspec
+gemspec
+
+
+# ruby '2.1.1'
+#
+# gem 'rake'
+# gem 'activesupport','3.0.0'
+# gem 'i18n'
+# gem 'minitest'
+# gem 'minitest-reporters'
+# gem 'rspec'
+# gem 'cucumber'
+# gem 'coveralls', require: false
+
+
+

data/Gemfile.lock

@@ -0,0 +1,93 @@
+PATH
+  remote: .
+  specs:
+    rachinations (0.0.1)
+      activesupport (= 3.0.0)
+      i18n
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (3.0.0)
+    ansi (1.4.3)
+    builder (3.2.2)
+    coveralls (0.7.0)
+      multi_json (~> 1.3)
+      rest-client
+      simplecov (>= 0.7)
+      term-ansicolor
+      thor
+    cucumber (1.3.16)
+      builder (>= 2.1.2)
+      diff-lcs (>= 1.1.3)
+      gherkin (~> 2.12)
+      multi_json (>= 1.7.5, < 2.0)
+      multi_test (>= 0.1.1)
+    diff-lcs (1.2.5)
+    docile (1.1.5)
+    ffi (1.9.3-x64-mingw32)
+    ffi (1.9.3-x86-mingw32)
+    gherkin (2.12.2)
+      multi_json (~> 1.3)
+    gherkin (2.12.2-x86-mingw32)
+      multi_json (~> 1.3)
+    i18n (0.6.11)
+    mime-types (2.3)
+    minitest (5.4.0)
+    minitest-reporters (1.0.5)
+      ansi
+      builder
+      minitest (>= 5.0)
+      ruby-progressbar
+    multi_json (1.10.1)
+    multi_test (0.1.1)
+    netrc (0.7.7)
+    rake (10.3.2)
+    rest-client (1.7.2)
+      mime-types (>= 1.16, < 3.0)
+      netrc (~> 0.7)
+    rest-client (1.7.2-x64-mingw32)
+      ffi (~> 1.9)
+      mime-types (>= 1.16, < 3.0)
+      netrc (~> 0.7)
+    rest-client (1.7.2-x86-mingw32)
+      ffi (~> 1.9)
+      mime-types (>= 1.16, < 3.0)
+      netrc (~> 0.7)
+    rspec (3.0.0)
+      rspec-core (~> 3.0.0)
+      rspec-expectations (~> 3.0.0)
+      rspec-mocks (~> 3.0.0)
+    rspec-core (3.0.3)
+      rspec-support (~> 3.0.0)
+    rspec-expectations (3.0.3)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.0.0)
+    rspec-mocks (3.0.3)
+      rspec-support (~> 3.0.0)
+    rspec-support (3.0.3)
+    ruby-progressbar (1.5.1)
+    simplecov (0.9.0)
+      docile (~> 1.1.0)
+      multi_json
+      simplecov-html (~> 0.8.0)
+    simplecov-html (0.8.0)
+    term-ansicolor (1.3.0)
+      tins (~> 1.0)
+    thor (0.19.1)
+    tins (1.3.0)
+
+PLATFORMS
+  ruby
+  x64-mingw32
+  x86-mingw32
+
+DEPENDENCIES
+  bundler (~> 1.5)
+  coveralls
+  cucumber
+  minitest
+  minitest-reporters
+  rachinations!
+  rake
+  rspec (~> 3.0)

data/LICENSE.txt

@@ -0,0 +1,21 @@
+Copyright (c) 2014 Felipe Almeida
+
+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

data/README.md

@@ -0,0 +1,18 @@
+rachinations
+====================
+[![Build Status](https://travis-ci.org/queirozfcom/rachinations.svg?branch=master)](https://travis-ci.org/queirozfcom/rachinations?branch=master)
+[![Code Climate](https://codeclimate.com/github/queirozfcom/rachinations.png)](https://codeclimate.com/github/queirozfcom/rachinations)
+[![Coverage Status](https://coveralls.io/repos/queirozfcom/rachinations/badge.png?branch=master)](https://coveralls.io/r/queirozfcom/rachinations?branch=master)
+
+### Introduction
+
+This is a port of Dr. J. Dormans' Machinations framework into Ruby.
+
+### Contents
+
+- Classes to model the domain
+- Tests
+- A simple DSL (Domain-specific language) whose objective is to enable anyone to write Machinations diagrams, run them, obtain metrics, compose subdiagrams and so on.
+
+### Usage
+- TODO

data/Rakefile

@@ -0,0 +1,16 @@
+require 'rake'
+require 'rake/testtask'
+require 'rspec/core/rake_task'
+require 'bundler/gem_tasks'
+
+task :default => [:spec]
+
+Rake::TestTask.new do |t|
+  t.pattern = 'testing/**/*_test.rb'
+end
+
+RSpec::Core::RakeTask.new do |t|
+  t.rspec_opts= ['--default-path testing/spec','--color']
+end
+
+

data/lib/rachinations.rb

@@ -0,0 +1,49 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'rachinations/version'
+
+
+# A few extra methods
+# to make code read more intuitively.
+class Proc
+
+  alias_method :accepts?, :call
+  alias_method :accept?, :call
+
+  alias_method :match?, :call
+  alias_method :matches?, :call
+
+  alias_method :match_resource?, :call
+  alias_method :matches_resource?, :call
+
+end
+
+require 'rachinations/extras/fifo'
+
+require 'rachinations/domain/diagrams/diagram'
+require 'rachinations/domain/diagrams/verbose_diagram'
+require 'rachinations/dsl/dsl'
+require 'rachinations/domain/strategies/strategy'
+require 'rachinations/domain/strategies/valid_types'
+require 'rachinations/domain/edges/random_edge'
+require 'rachinations/domain/edges/edge'
+require 'rachinations/domain/exceptions/no_elements_of_given_type'
+require 'rachinations/domain/exceptions/unsupported_type_error'
+require 'rachinations/domain/exceptions/bad_options'
+require 'rachinations/domain/exceptions/no_elements_matching_condition_error'
+require 'rachinations/domain/exceptions/no_elements_found'
+require 'rachinations/domain/nodes/node'
+require 'rachinations/domain/nodes/resourceful_node'
+require 'rachinations/domain/nodes/pool'
+require 'rachinations/domain/nodes/source'
+require 'rachinations/domain/nodes/sink'
+require 'rachinations/domain/nodes/gate'
+require 'rachinations/domain/nodes/trader'
+require 'rachinations/domain/nodes/converter'
+require 'rachinations/domain/resources/token'
+require 'rachinations/domain/edge_collection'
+require 'rachinations/domain/node_collection'
+require 'rachinations/domain/resource_bag'
+
+
+include DSL

data/lib/rachinations/domain/diagrams/diagram.rb

@@ -0,0 +1,167 @@
+require_relative '../../domain/modules/common/invariant'
+require_relative '../edge_collection'
+require_relative '../node_collection'
+
+class Diagram
+
+  include Invariant
+
+  attr_accessor :name, :max_iterations, :nodes, :edges
+
+  def initialize(name)
+    @nodes = NodeCollection.new
+    @edges = EdgeCollection.new
+    @name = name
+    @max_iterations = 999
+  end
+
+  def get_node(name)
+
+    nodes.each do |node|
+      if node.name == name
+        return node
+      end
+    end
+
+    raise RuntimeError, "Node with name='#{name}' not found."
+  end
+
+  def add_node!(node_klass, params)
+
+    params.store(:diagram, self)
+
+    node = node_klass.new(params)
+
+    nodes.push(node)
+
+    self
+
+  end
+
+  def add_edge!(edge_klass, params)
+
+    params.store(:diagram, self)
+
+    #we need to send the actual nodes, not their names
+    from = get_node(params.fetch(:from))
+    to = get_node(params.fetch(:to))
+
+    params.store(:from, from)
+    params.store(:to, to)
+
+    edge = edge_klass.new(params)
+
+    from.attach_edge!(edge)
+    to.attach_edge!(edge)
+
+    edges.push(edge)
+
+    self
+  end
+
+  def run!(rounds=5)
+
+    run_while! do |i|
+      i<=rounds
+    end
+
+  end
+
+  # Runs the diagram until given block returns false
+  #
+  # @yieldparam i [Fixnum] The current round.
+  # @yieldreturn [Boolean] True if diagram should keep on running, false if it should stop.
+  # @return [Diagram] The diagram itself.
+  def run_while!
+
+    before_run
+
+    i=1
+
+    #if given condition block turned false, it's time to stop
+    while yield i do
+
+      break unless sanity_check? i
+
+      before_round i
+
+      if i == 1
+        # some things are different for the first round, namely nodes with activation = start
+        run_first_round!
+      else
+        run_round!
+      end
+
+      after_round i
+      i+=1
+    end
+
+    after_run
+
+    self
+
+  end
+
+  def to_s
+    nodes.reduce('') { |carry, n| carry+n.to_s }
+  end
+
+  def sanity_check?(round_no)
+    if round_no > @max_iterations
+      sanity_check_message
+      false
+    else
+      true
+    end
+  end
+
+  def run_first_round!
+
+    enabled_nodes.select { |n| n.automatic? || n.start? }.shuffle.each { |n| n.trigger! }
+
+    commit_nodes!
+
+  end
+
+  def run_round!
+
+    enabled_nodes.select { |n| n.automatic? }.shuffle.each { |node| node.trigger! }
+
+    commit_nodes!
+
+  end
+
+  def commit_nodes!
+    #only after all nodes have run do we update the actual resources and changes, to be used in the next round.
+    nodes.shuffle.each { |n| n.commit! }
+  end
+
+
+  def resource_count(klass=nil)
+    total=0
+    @nodes.each do |n|
+      total+=n.resource_count(klass)
+    end
+    total
+  end
+
+  def enabled_nodes
+    nodes.select{|n| n.enabled? }
+  end
+
+  #template method
+  def before_round(node_no) end
+
+  #template method
+  def after_round(node_no) end
+
+  #template method
+  def before_run; end
+
+  #template method
+  def after_run; end
+
+  #template method
+  def sanity_check_message; end
+
+end

data/lib/rachinations/domain/diagrams/non_deterministic_diagram.rb

@@ -0,0 +1,16 @@
+
+class NonDeterministicDiagram < Diagram
+
+
+  # This version of run_round! triggers only one node
+  #  per turn.
+  def run_round!
+
+    node = nodes.sample
+    node.trigger!
+
+    nodes.each{ |n| n.commit! }
+
+  end
+
+end

data/lib/rachinations/domain/diagrams/verbose_diagram.rb

@@ -0,0 +1,9 @@
+require 'rachinations/domain/modules/diagrams/verbose'
+
+class VerboseDiagram < Diagram
+
+  #useful to see round-to-round changes, to help debugging for instance.
+
+  include Verbose
+
+end