rubycube 0.2.0

data/lib/cube/traits.rb

@@ -0,0 +1,75 @@
+require_relative 'interfaces'
+
+module Cube
+  module Trait
+    class MethodConflict < RuntimeError; end
+    class IncludeError < RuntimeError; end
+
+    def requires_interface(intf)
+      unless intf.is_a? Cube::Interface
+        raise ArgumentError, "#{intf} is not a Cube::Interface"
+      end
+      @__interface_trait_required_interface = intf
+    end
+
+    def append_features(mod)
+      unless mod.instance_variable_defined?(:@__trait_allow_include) &&
+        mod.instance_variable_get(:@__trait_allow_include)
+        raise IncludeError, "Traits can only be mixed in using method `with_trait`"
+      end
+      conflicts = public_instance_methods & mod.public_instance_methods
+      errors = conflicts.map { |c|
+        meth = mod.instance_method(c)
+        { meth: meth, owner: meth.owner } unless meth.owner.is_a?(Class)
+      }.compact
+      unless errors.empty?
+        message = "\n" + errors.map { |e| e[:meth].to_s }.join("\n")
+        raise MethodConflict, message
+      end
+      if @__interface__trait_required_interface
+        intf = @__interface_trait_required_interface
+        mod.include?(intf) || mod.assert_implements(intf)
+      end
+      super(mod)
+    end
+  end
+end
+
+class Module
+  def with_trait(trait, aliases: {}, suppresses: [])
+    unless trait.is_a? Cube::Trait
+      raise ArgumentError, "#{trait} is not an Cube::Trait"
+    end
+    cls = clone
+    cls.instance_variable_set(:@__trait_allow_include, true)
+    cls.instance_variable_set(:@__trait_cloned_from, self)
+    raise ArgumentError, "aliases must be a Hash" unless aliases.is_a?(Hash)
+    raise ArgumentError, "supresses must be a Array" unless suppresses.is_a?(Array)
+
+    al_trait = trait_with_resolutions(trait, aliases, suppresses)
+    al_trait.instance_variable_set(:@__interface_runtime_check, false)
+    cls.include(al_trait)
+    cls
+  end
+
+  private
+
+  def trait_with_resolutions(trait, aliases, suppress)
+    cl = trait.clone
+    cl.module_exec do
+      suppress.each do |sup|
+        undef_method(sup)
+      end
+      aliases.each do |before, after|
+        begin
+          alias_method(after, before)
+        rescue => e
+          $stderr.puts "with_trait(#{trait}): #{e.message}"
+          raise ArgumentError, "with_trait(#{trait}): #{e.message}"
+        end
+        undef_method(before)
+      end
+    end
+    cl
+  end
+end

data/test/test_interface.rb

@@ -0,0 +1,111 @@
+#####################################################
+# test_interface.rb
+#
+# Test suite for the Interface module.
+#####################################################
+ENV['RUBY_CUBE_TYPECHECK'] = "1"
+require 'test-unit'
+require 'cube'
+
+
+class TC_Interface < Test::Unit::TestCase
+  def self.startup
+    alpha_interface = interface{
+      public_visible(:alpha, :beta)
+      proto(:beta) { [Integer, NilClass].to_set }
+      proto(:delta, Integer, String, Integer) { Integer }
+    }
+
+    gamma_interface = interface{
+      extends alpha_interface
+      public_visible :gamma
+    }
+
+    # Workaround for 1.9.x
+    @@alpha_interface = alpha_interface
+    @@gamma_interface = gamma_interface
+
+    eval("class A; end")
+
+    eval("
+      class B
+        def alpha; end
+        def beta; end
+        def delta(a, b, c=nil); 0; end
+      end
+    ")
+
+    eval("
+      class C
+        def alpha; end
+        def beta; end
+        def gamma; end
+        def delta(a); end
+      end
+    ")
+  end
+
+
+  def checker_method(arg)
+    check_type(@@gamma_interface, arg)
+  end
+
+  def test_version
+    assert_equal('0.2.0', Cube::Interface::VERSION)
+  end
+
+  def test_interface_requirements_not_met
+    assert_raise(Cube::Interface::PublicVisibleMethodMissing){ A.extend(@@alpha_interface) }
+    assert_raise(Cube::Interface::PublicVisibleMethodMissing){ A.new.extend(@@alpha_interface) }
+  end
+
+  def test_sub_interface_requirements_not_met
+    assert_raise(Cube::Interface::PublicVisibleMethodMissing){ B.extend(@@gamma_interface) }
+    assert_raise(Cube::Interface::PublicVisibleMethodMissing){ B.new.extend(@@gamma_interface) }
+  end
+
+  def test_alpha_interface_requirements_met
+    assert_nothing_raised{ B.new.extend(@@alpha_interface) }
+  end
+
+  def test_gamma_interface_requirements_met
+    assert_raise(Cube::Interface::MethodArityError) { C.new.extend(@@gamma_interface) }
+    assert_raise(Cube::Interface::MethodArityError) { C.as_interface(@@gamma_interface) }
+  end
+
+  def test_method_check
+    assert_raise(Cube::Interface::TypeMismatchError) { checker_method(B.as_interface(@@alpha_interface).new) }
+  end
+
+  def test_runtime_error_check
+    assert_nothing_raised {
+      B.as_interface(@@alpha_interface, runtime_checks: true).new.beta
+    }
+    assert_raise(ArgumentError) {
+      B.as_interface(@@alpha_interface).new.delta
+    }
+    assert_raise(ArgumentError) {
+      B.as_interface(@@alpha_interface).new.delta(1)
+    }
+    assert_raise(Cube::Interface::TypeMismatchError) {
+      B.as_interface(@@alpha_interface).new.delta(1, 2)
+    }
+    assert_raise(Cube::Interface::TypeMismatchError) {
+      B.as_interface(@@alpha_interface).new.delta(1, "2", "3")
+    }
+    assert_nothing_raised {
+      B.as_interface(@@alpha_interface).new.delta(1, "2")
+    }
+    assert_nothing_raised {
+      B.as_interface(@@alpha_interface).new.delta(1, "2", 3)
+    }
+  end
+
+  def test_shell
+    sh = @@alpha_interface.shell
+    sho = sh.new
+    [:alpha, :beta].each do |m|
+      assert_equal(sho.send(m), nil)
+    end
+  end
+end

metadata

@@ -0,0 +1,151 @@
+--- !ruby/object:Gem::Specification
+name: rubycube
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Aditya Godbole
+autorequire: 
+bindir: bin
+cert_chain:
+- certs/djberg96_pub.pem
+date: 2016-07-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: test-unit
+  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: rake
+  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: |2
+      CUBE (Composable Units of Behaviour) implements Interfaces, Traits and typechecks for Ruby.
+email: code.aa@gdbl.me
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+- CHANGES
+- MANIFEST
+files:
+- CHANGES
+- MANIFEST
+- README.md
+- Rakefile
+- certs/djberg96_pub.pem
+- cube.gemspec
+- doc/Bar.html
+- doc/CHANGES.html
+- doc/Foo.html
+- doc/Interface.html
+- doc/Interface/MethodMissing.html
+- doc/Interface/PrivateVisibleMethodMissing.html
+- doc/Interface/PublicVisibleMethodMissing.html
+- doc/MANIFEST.html
+- doc/Module.html
+- doc/MyClass.html
+- doc/MyInterface.html
+- doc/MySubInterface.html
+- doc/Object.html
+- doc/README.html
+- doc/Rakefile.html
+- doc/TC_Interface.html
+- doc/certs/djberg96_pub_pem.html
+- doc/created.rid
+- doc/css/fonts.css
+- doc/css/rdoc.css
+- doc/fonts/Lato-Light.ttf
+- doc/fonts/Lato-LightItalic.ttf
+- doc/fonts/Lato-Regular.ttf
+- doc/fonts/Lato-RegularItalic.ttf
+- doc/fonts/SourceCodePro-Bold.ttf
+- doc/fonts/SourceCodePro-Regular.ttf
+- doc/images/add.png
+- doc/images/arrow_up.png
+- doc/images/brick.png
+- doc/images/brick_link.png
+- doc/images/bug.png
+- doc/images/bullet_black.png
+- doc/images/bullet_toggle_minus.png
+- doc/images/bullet_toggle_plus.png
+- doc/images/date.png
+- doc/images/delete.png
+- doc/images/find.png
+- doc/images/loadingAnimation.gif
+- doc/images/macFFBgHack.png
+- doc/images/package.png
+- doc/images/page_green.png
+- doc/images/page_white_text.png
+- doc/images/page_white_width.png
+- doc/images/plugin.png
+- doc/images/ruby.png
+- doc/images/tag_blue.png
+- doc/images/tag_green.png
+- doc/images/transparent.png
+- doc/images/wrench.png
+- doc/images/wrench_orange.png
+- doc/images/zoom.png
+- doc/index.html
+- doc/interface_gemspec.html
+- doc/js/darkfish.js
+- doc/js/jquery.js
+- doc/js/navigation.js
+- doc/js/navigation.js.gz
+- doc/js/search.js
+- doc/js/search_index.js
+- doc/js/search_index.js.gz
+- doc/js/searcher.js
+- doc/js/searcher.js.gz
+- doc/table_of_contents.html
+- examples/demo.rb
+- lib/cube.rb
+- lib/cube/interfaces.rb
+- lib/cube/traits.rb
+- test/test_interface.rb
+homepage: http://github.com/adityagodbole/rubycube
+licenses:
+- Artistic 2.0
+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.5
+signing_key: 
+specification_version: 4
+summary: Interfaces for Ruby
+test_files:
+- test/test_interface.rb