yogo-operation 0.1.0

data/.gitignore

@@ -0,0 +1,24 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+.bundle
+.yardoc
+
+## PROJECT::SPECIFIC
+spec/tmp

data/Gemfile

@@ -0,0 +1,13 @@
+source :rubygems
+
+gem 'dataflow'
+gem 'yogo-support', "~> 0.1.0"
+
+group :development do
+  gem "rake"
+  gem "jeweler"
+  gem "rspec"
+  gem "cucumber"
+  gem "yard"
+  gem "ruby-debug"
+end

data/Gemfile.lock

@@ -0,0 +1,49 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    builder (2.1.2)
+    columnize (0.3.1)
+    cucumber (0.8.5)
+      builder (~> 2.1.2)
+      diff-lcs (~> 1.1.2)
+      gherkin (~> 2.1.4)
+      json_pure (~> 1.4.3)
+      term-ansicolor (~> 1.0.4)
+    dataflow (0.3.1)
+    diff-lcs (1.1.2)
+    gemcutter (0.6.1)
+    gherkin (2.1.5)
+      trollop (~> 1.16.2)
+    git (1.2.5)
+    jeweler (1.4.0)
+      gemcutter (>= 0.1.0)
+      git (>= 1.2.5)
+      rubyforge (>= 2.0.0)
+    json_pure (1.4.6)
+    linecache (0.43)
+    rake (0.8.7)
+    rspec (1.3.0)
+    ruby-debug (0.10.3)
+      columnize (>= 0.1)
+      ruby-debug-base (~> 0.10.3.0)
+    ruby-debug-base (0.10.3)
+      linecache (>= 0.3)
+    rubyforge (2.0.4)
+      json_pure (>= 1.1.7)
+    term-ansicolor (1.0.5)
+    trollop (1.16.2)
+    yard (0.6.1)
+    yogo-support (0.1.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  cucumber
+  dataflow
+  jeweler
+  rake
+  rspec
+  ruby-debug
+  yard
+  yogo-support (~> 0.1.0)

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Ryan Heimbuch, Montana State University
+
+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.rdoc

@@ -0,0 +1,23 @@
+= yogo-operation
+
+yogo-operation contains various extensions to Proc, including:
+
+* Yogo::Operation::Restriction - Allows an operation to be restricted to a certain argument type.
+* Yogo::Operation::Closed - Ensures that an operation is 'closed' over it's input/output.
+* Yogo::Operation::Concurrent - Allows an operation to execute in its own thread.
+
+The Yogo::Op class implements these modules and can be used without further modification.
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2010 Ryan Heimbuch, Montana State University. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,63 @@
+require 'rubygems'
+
+begin
+  require 'bundler'
+  Bundler.setup
+rescue LoadError
+  puts "Bundler is not intalled. Install with: gem install bundler"
+end
+
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "yogo-operation"
+    gem.summary = "specialization of Proc"
+    gem.description = "yogo-operation contains extensions to Proc to support various higher-order operations"
+    gem.email = "rheimbuch@gmail.com"
+    gem.homepage = "http://github.com/yogo/yogo-operation"
+    gem.authors = ["Ryan Heimbuch"]
+    gem.add_bundler_dependencies
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+begin
+  require 'cucumber/rake/task'
+  Cucumber::Rake::Task.new(:features)
+
+  task :features => :check_dependencies
+rescue LoadError
+  task :features do
+    abort "Cucumber is not available. In order to run features, you must: sudo gem install cucumber"
+  end
+end
+
+task :default => :spec
+
+begin
+  require 'yard'
+  YARD::Rake::YardocTask.new
+rescue LoadError
+  task :yardoc do
+    abort "YARD is not available. In order to run yardoc, you must: sudo gem install yard"
+  end
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/features/support/env.rb

@@ -0,0 +1,4 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__) + '/../../lib')
+require 'yogo-operation'
+
+require 'spec/expectations'

data/features/yogo-operation.feature

@@ -0,0 +1,9 @@
+Feature: something something
+  In order to something something
+  A user something something
+  something something something
+
+  Scenario: something something
+    Given inspiration
+    When I create a sweet new gem
+    Then everyone should see how awesome I am

data/lib/yogo/operation.rb

@@ -0,0 +1,17 @@
+require 'yogo/support/proc'
+require 'yogo/operation/base'
+require 'yogo/operation/restricted'
+require 'yogo/operation/closed'
+require 'yogo/operation/concurrent'
+
+module Yogo
+  class Op < Proc
+    extend Yogo::Operation::Base
+    extend Yogo::Operation::Restricted
+    extend Yogo::Operation::Closed
+  end # Op
+  
+  class FlowOp < Op
+    extend Yogo::Operation::Concurrent
+  end
+end # Yogo

data/lib/yogo/operation/base.rb

@@ -0,0 +1,24 @@
+require 'yogo/support/extension_module'
+require 'yogo/support/proc/call'
+require 'yogo/support/proc/partial'
+require 'yogo/support/proc/compose'
+
+module Yogo
+  module Operation
+    module Base
+      extend Yogo::ExtensionModule
+      
+      instance_extensions do
+        extend Support::Proc::Call
+        extend Support::Proc::Partial
+        extend Support::Proc::Compose
+      end
+      
+      class_extensions do
+        include Support::Proc::Call
+        include Support::Proc::Partial
+        include Support::Proc::Compose
+      end
+    end # Base
+  end # Operation
+end # Yogo

data/lib/yogo/operation/closed.rb

@@ -0,0 +1,18 @@
+require 'yogo/support/extension_module'
+require 'yogo/operation/closed/call'
+
+module Yogo
+  module Operation
+    module Closed
+      extend Yogo::ExtensionModule
+      
+      instance_extensions do
+        extend Closed::Call
+      end
+      
+      class_extensions do
+        include Closed::Call
+      end
+    end # Closed
+  end # Operation
+end # Yogo

data/lib/yogo/operation/closed/call.rb

@@ -0,0 +1,18 @@
+require 'yogo/operation/closed/error'
+
+module Yogo
+  module Operation
+    module Closed
+      module Call
+        def call(*args)
+          argument = args.first
+          result = super(*args)
+          unless result.kind_of?(argument.class)
+            raise(OperationNotClosedError, :argument => argument, :result => result)
+          end
+          result
+        end
+      end # Call
+    end # Closed
+  end # Operation
+end # Yogo

data/lib/yogo/operation/closed/error.rb

@@ -0,0 +1,16 @@
+require 'yogo/operation/error'
+
+module Yogo
+  module Operation
+    module Closed
+      class OperationNotClosedError < OperationError
+        def_delegators :information, :expected_type, :argument, :result
+        def initialize(options)
+          options[:message] ||= "The Operation is not closed! The argument and result of the operation were not of the same type."
+          options[:expected_type] ||= options[:argument].class
+          super(options)
+        end
+      end # OperationNotClosedError
+    end # Closed
+  end # Operation
+end # Yogo

data/lib/yogo/operation/concurrent.rb

@@ -0,0 +1,18 @@
+require 'yogo/support/extension_module'
+require 'yogo/operation/concurrent/call'
+
+module Yogo
+  module Operation
+    module Concurrent
+      extend Yogo::ExtensionModule
+      
+      instance_extensions do
+        extend Concurrent::Call
+      end
+      
+      class_extensions do
+        include Concurrent::Call
+      end
+    end # Concurrent
+  end # Operation
+end # Yogo

data/lib/yogo/operation/concurrent/call.rb

@@ -0,0 +1,19 @@
+require 'dataflow'
+
+module Yogo
+  module Operation
+    module Concurrent
+      module Call
+        include Dataflow
+        def call(*args)
+          local do |result|
+            flow do
+              unify result, super(*args)
+            end
+            result
+          end
+        end
+      end # Call
+    end # Concurrent
+  end # Operation
+end # Yogo

data/lib/yogo/operation/error.rb

@@ -0,0 +1,23 @@
+require 'ostruct'
+require 'forwardable'
+
+module Yogo
+  module Operation
+    class OperationError < StandardError
+      attr_reader :information
+      
+      extend Forwardable
+      def_delegators :information, :operation, :action
+      
+      def initialize(options={})
+        message = options.delete(:message)
+        @information = OpenStruct.new(options)
+        @information.freeze
+        
+        message ? super(message) : super()
+      end
+      
+      
+    end # OperationError
+  end # Operation
+end # Yogo

data/lib/yogo/operation/restricted.rb

@@ -0,0 +1,23 @@
+require 'yogo/support/extension_module'
+require 'yogo/operation/restricted/construction'
+require 'yogo/operation/restricted/call'
+require 'yogo/operation/restricted/partial'
+
+module Yogo
+  module Operation
+    module Restricted
+      extend Yogo::ExtensionModule
+      
+      instance_extensions do
+        extend Restricted::Call
+        extend Restricted::Partial
+      end
+      
+      class_extensions do
+        extend Restricted::Construction
+        include Restricted::Call
+        include Restricted::Partial
+      end
+    end # Restricted
+  end # Operation
+end # Yogo

data/lib/yogo/operation/restricted/call.rb

@@ -0,0 +1,20 @@
+require 'yogo/operation/restricted/error'
+require 'yogo/operation/restricted/expected_type'
+
+module Yogo
+  module Operation
+    module Restricted
+      module Call
+        include ExpectedType
+        
+        def call(*args)
+          argument = args.first
+          unless argument.kind_of?(expected_type)
+            raise(OperationRestrictionError, :argument => argument, :expected_type => expected_type)
+          end
+          super
+        end
+      end # Call
+    end # Closed
+  end # Operation
+end # Yogo

data/lib/yogo/operation/restricted/construction.rb

@@ -0,0 +1,28 @@
+require 'yogo/operation/restricted/expected_type'
+
+module Yogo
+  module Operation
+    module Restricted
+      module Construction
+        def self.included(base)
+          raise "Inclusions not allowed. Use: extend(#{self.name})"
+        end
+      
+        def extended(base)
+          base.class_eval {
+            include ExpectedType
+          }
+          base.instance_eval {
+            protected :new
+          }
+        end
+      
+        def on(type, &block)
+          op = self.new(&block)
+          op.instance_eval{ self.expected_type = type }
+          op
+        end
+      end # Construction
+    end # Restricted
+  end # Operation
+end # Yogo

data/lib/yogo/operation/restricted/error.rb

@@ -0,0 +1,16 @@
+require 'yogo/operation/error'
+
+module Yogo
+  module Operation
+    module Restricted
+      class OperationRestrictionError < OperationError
+        def_delegators :information, :expected_type, :argument, :actual_type
+        
+        def initialize(options)
+          options[:message] ||= "The Operation cannot be applied to an argument of this type!"
+          super(options)
+        end
+      end # OperationNotClosedError
+    end # Closed
+  end # Operation
+end # Yogo

data/lib/yogo/operation/restricted/expected_type.rb

@@ -0,0 +1,16 @@
+require 'yogo/support/proc/partial'
+
+module Yogo
+  module Operation
+    module Restricted
+      module ExpectedType
+        protected
+        attr_accessor :expected_type
+        
+        def expected_type
+          @expected_type ||= Object
+        end
+      end # Partial
+    end # Restricted
+  end # Operation
+end # Yogo

data/lib/yogo/operation/restricted/partial.rb

@@ -0,0 +1,17 @@
+require 'yogo/support/proc/partial'
+require 'yogo/operation/restricted/expected_type'
+
+module Yogo
+  module Operation
+    module Restricted
+      module Partial
+        include ExpectedType
+        
+        def partial(*args)
+          applied = super(*args)
+          self.class.on(self.expected_type, &applied)
+        end
+      end # Partial
+    end # Restricted
+  end # Operation
+end # Yogo

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'yogo-operation'
+require 'spec'
+require 'spec/autorun'
+
+Spec::Runner.configure do |config|
+  
+end

data/spec/yogo-operation_spec.rb

@@ -0,0 +1,7 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "YogoOperation" do
+  it "fails" do
+    fail "hey buddy, you should probably rename this file and start specing for real"
+  end
+end

metadata

@@ -0,0 +1,208 @@
+--- !ruby/object:Gem::Specification 
+name: yogo-operation
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Ryan Heimbuch
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-09-08 00:00:00 -06:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  type: :runtime
+  prerelease: false
+  name: dataflow
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id001
+- !ruby/object:Gem::Dependency 
+  type: :runtime
+  prerelease: false
+  name: yogo-support
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 27
+        segments: 
+        - 0
+        - 1
+        - 0
+        version: 0.1.0
+  requirement: *id002
+- !ruby/object:Gem::Dependency 
+  type: :development
+  prerelease: false
+  name: rake
+  version_requirements: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id003
+- !ruby/object:Gem::Dependency 
+  type: :development
+  prerelease: false
+  name: jeweler
+  version_requirements: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id004
+- !ruby/object:Gem::Dependency 
+  type: :development
+  prerelease: false
+  name: rspec
+  version_requirements: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id005
+- !ruby/object:Gem::Dependency 
+  type: :development
+  prerelease: false
+  name: cucumber
+  version_requirements: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id006
+- !ruby/object:Gem::Dependency 
+  type: :development
+  prerelease: false
+  name: yard
+  version_requirements: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id007
+- !ruby/object:Gem::Dependency 
+  type: :development
+  prerelease: false
+  name: ruby-debug
+  version_requirements: &id008 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id008
+description: yogo-operation contains extensions to Proc to support various higher-order operations
+email: rheimbuch@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- features/step_definitions/yogo-operation_steps.rb
+- features/support/env.rb
+- features/yogo-operation.feature
+- lib/yogo/operation.rb
+- lib/yogo/operation/base.rb
+- lib/yogo/operation/closed.rb
+- lib/yogo/operation/closed/call.rb
+- lib/yogo/operation/closed/error.rb
+- lib/yogo/operation/concurrent.rb
+- lib/yogo/operation/concurrent/call.rb
+- lib/yogo/operation/error.rb
+- lib/yogo/operation/restricted.rb
+- lib/yogo/operation/restricted/call.rb
+- lib/yogo/operation/restricted/construction.rb
+- lib/yogo/operation/restricted/error.rb
+- lib/yogo/operation/restricted/expected_type.rb
+- lib/yogo/operation/restricted/partial.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- spec/yogo-operation_spec.rb
+has_rdoc: true
+homepage: http://github.com/yogo/yogo-operation
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: specialization of Proc
+test_files: 
+- spec/spec_helper.rb
+- spec/yogo-operation_spec.rb