rubycube 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 15f74edc75a9b3c9587e572360070308146541b5
+  data.tar.gz: 0736d80440604b0648df131b813fa815c9e7b66c
+SHA512:
+  metadata.gz: 0b27eedc46814fca3c9030e8488bb3faf1afc236c57a7ae2f5c99ed1d3dddf6584676a368ddc1892c3677cd08ea6a159a739ba66a016556f782a68e2f091e95e
+  data.tar.gz: f186007c1b070d8c170f4df5b351889235dffef1d99eea10f412987538d144f07c77ee6c882d254430740c4feb09045987bf945dbf76d02f1ce5c5fdcceae34c

data/CHANGES

@@ -0,0 +1,30 @@
+== 1.0.4 - 8-Jan-2016
+* This gem is now signed.
+* The gem related tasks in the Rakefile now assume Rubygems 2.x.
+
+== 1.0.3 - 12-Oct-2014
+* Rakefile, gemspec and README updates.
+
+== 1.0.2 - 7-Oct-2009
+* Fixed packaging bug in the gemspec, and made some other minor changes.
+* Added the 'gem' rake task.
+* Updated copyright and license in the README.
+
+== 1.0.1 - 29-Jul-2009
+* Now compatible with Ruby 1.9.x.
+* Replaced the install.rb with a Rakefile and various tasks.
+* Updated the license to Artistic 2.0.
+* Added test-unit 2.x as a development dependency and refactored the test
+  suite to take advantage of some of its features.
+* Renamed the test file to test_interface.rb.
+* Renamed the example programs to all start with 'example_' to avoid any
+  possible confusion with actual test suites.
+* Added rake tasks for running the example programs.
+* Updated and refactored the gemspec.
+
+== 1.0.0 - 5-Jun-2005
+* Re-released on RubyForge.
+* Some test suite and doc changes.
+
+== 0.1.0 - 9-May-2004
+* Initial release

data/MANIFEST

@@ -0,0 +1,12 @@
+* CHANGES
+* MANIFEST
+* README
+* Rakefile
+* interface.gemspec
+* certs/djberg96_pub.pem
+* examples/example_instance.rb
+* examples/example_interface.rb
+* examples/example_sub.rb
+* examples/example_unrequire.rb
+* lib/interface.rb
+* test/test_interface.rb

data/README.md

@@ -0,0 +1,69 @@
+### Description
+This is a backward incompatible fork of https://github.com/djberg96/interface
+It provides interfaces, traits and runtime interface checks in Ruby 
+
+### Installation
+This gem is not yet available on rubygems. Please use from github directly.
+
+### Synopsis
+See [this annotated example](examples/demo.rb)
+
+### General Notes
+
+Subinterfaces work as well. 
+
+Since runtime checks are meant to be invoked for every invocation of a method,
+there is a runtime overhead associated which may not be desirable in
+production. Hence these checks are guarded by an environment variable
+`RUBY_CUBE_TYPECHECK`. Unless this variable is set to 1, the runtime
+checks are not executed
+
+### Runtime performance of check methods
+
+On a Macbook Pro 2.4 GHz Intel Core i5 machine, enabling runtime checks costs
+about 1 second for every million calls. YMMV.  It is advisable to benchmark for
+your code to determine if the overhead is acceptable in your enviroment.
+
+### Developer's Notes (from the original repository)
+  A discussion on IRC with Mauricio Fernandez got us talking about traits.
+  During that discussion I remembered a blog entry by David Naseby. I 
+  revisited his blog entry and took a closer look:
+
+  http://ruby-naseby.blogspot.com/2008/11/traits-in-ruby.html
+
+  Keep in mind that I also happened to be thinking about Java at the moment
+  because of a recent job switch that involved coding in Java. I was also
+  trying to figure out what the purpose of interfaces were.
+
+  As I read the first page of David Naseby's article I realized that,
+  whether intended or not, he had implemented a rudimentary form of interfaces
+  for Ruby. When I discovered this, I talked about it some more with Mauricio
+  and he and I (mostly him) fleshed out the rest of the module, including some
+  syntax improvements. The result is syntax and functionality that is nearly
+  identical to Java.
+
+  I should note that, although I am listed as the author, this was mostly the
+  combined work of David Naseby and Mauricio Fernandez. I just happened to be
+  the guy that put it all together.
+
+### Acknowledgements (from the original repository)
+  This module was largely inspired and somewhat copied from a post by
+  David Naseby (see URL above). It was subsequently modified almost entirely
+  by Mauricio Fernandez through a series of discussions on IRC.
+	
+### Copyright
+  (C) 2004-2016 Daniel J. Berger
+  (C) 2016 Aditya Godbole
+  All rights reserved.
+	
+### Warranty
+  This package is provided "as is" and without any express or
+  implied warranties, including, without limitation, the implied
+  warranties of merchantability and fitness for a particular purpose.
+	
+### License
+  Artistic 2.0
+	
+### Author
+  Daniel J. Berger
+  Aditya Godbole

data/Rakefile

@@ -0,0 +1,50 @@
+require 'rake'
+require 'rake/clean'
+require 'rake/testtask'
+
+CLEAN.include("**/*.gem", "**/*.rbc")
+
+namespace :gem do
+  desc "Create the interface gem"
+  task :create => [:clean] do 
+    require 'rubygems/package'
+    spec = eval(IO.read('interface.gemspec'))
+    spec.signing_key = File.join(Dir.home, '.ssh', 'gem-private_key.pem')
+    Gem::Package.build(spec, true)
+  end
+
+  desc "Install the interface gem"
+  task :install => [:create] do
+    file = Dir["*.gem"].first
+    sh "gem install -l #{file}"
+  end
+end
+
+namespace :example do
+  desc 'Run the example_instance.rb sample program'
+  task :instance do
+    ruby '-Ilib examples/example_instance.rb'
+  end
+
+  desc 'Run the example_interface.rb sample program'
+  task :interface do
+    ruby '-Ilib examples/example_interface.rb'
+  end
+
+  desc 'Run the example_sub.rb sample program'
+  task :sub do
+    ruby '-Ilib examples/example_sub.rb'
+  end
+
+  desc 'Run the example_unrequire.rb sample program'
+  task :unrequire do
+    ruby '-Ilib examples/example_unrequire.rb'
+  end
+end
+
+Rake::TestTask.new do |t|
+  t.verbose = true
+  t.warning = true
+end
+
+task :default => :test

data/certs/djberg96_pub.pem

@@ -0,0 +1,21 @@
+-----BEGIN CERTIFICATE-----
+MIIDcDCCAligAwIBAgIBATANBgkqhkiG9w0BAQUFADA/MREwDwYDVQQDDAhkamJl
+cmc5NjEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPyLGQBGRYDY29t
+MB4XDTE1MDkwMjIwNDkxOFoXDTE2MDkwMTIwNDkxOFowPzERMA8GA1UEAwwIZGpi
+ZXJnOTYxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixkARkWA2Nv
+bTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMyTkvXqRp6hLs9eoJOS
+Hmi8kRYbq9Vkf15/hMxJpotYMgJVHHWrmDcC5Dye2PbnXjTkKf266Zw0PtT9h+lI
+S3ts9HO+vaCFSMwFFZmnWJSpQ3CNw2RcHxjWkk9yF7imEM8Kz9ojhiDXzBetdV6M
+gr0lV/alUr7TNVBDngbXEfTWscyXh1qd7xZ4EcOdsDktCe5G45N/o3662tPQvJsi
+FOF0CM/KuBsa/HL1/eoEmF4B3EKIRfTHrQ3hu20Kv3RJ88QM4ec2+0dd97uX693O
+zv6981fyEg+aXLkxrkViM/tz2qR2ZE0jPhHTREPYeMEgptRkTmWSKAuLVWrJEfgl
+DtkCAwEAAaN3MHUwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0OBBYEFEwe
+nn6bfJADmuIDiMSOzedOrL+xMB0GA1UdEQQWMBSBEmRqYmVyZzk2QGdtYWlsLmNv
+bTAdBgNVHRIEFjAUgRJkamJlcmc5NkBnbWFpbC5jb20wDQYJKoZIhvcNAQEFBQAD
+ggEBAHmNOCWoDVD75zHFueY0viwGDVP1BNGFC+yXcb7u2GlK+nEMCORqzURbYPf7
+tL+/hzmePIRz7i30UM//64GI1NLv9jl7nIwjhPpXpf7/lu2I9hOTsvwSumb5UiKC
+/sqBxI3sfj9pr79Wpv4MuikX1XPik7Ncb7NPsJPw06Lvyc3Hkg5X2XpPtLtS+Gr2
+wKJnmzb5rIPS1cmsqv0M9LPWflzfwoZ/SpnmhagP+g05p8bRNKjZSA2iImM/GyYZ
+EJYzxdPOrx2n6NYR3Hk+vHP0U7UBSveI6+qx+ndQYaeyCn+GRX2PKS9h66YF/Q1V
+tGSHgAmcLlkdGgan182qsE/4kKM=
+-----END CERTIFICATE-----

data/cube.gemspec

@@ -0,0 +1,23 @@
+require 'rubygems'
+
+Gem::Specification.new do |spec|
+  spec.name       = 'rubycube'
+  spec.version    = '0.2.0'
+  spec.author     = 'Aditya Godbole'
+  spec.license    = 'Artistic 2.0'
+  spec.email      = 'code.aa@gdbl.me'
+  spec.homepage   = 'http://github.com/adityagodbole/rubycube'
+  spec.summary    = 'Interfaces for Ruby'
+  spec.test_file  = 'test/test_interface.rb'
+  spec.files      = Dir['**/*'].reject { |f| f.include?('git') }
+  spec.cert_chain = Dir['certs/*']
+
+  spec.extra_rdoc_files = ['README.md', 'CHANGES', 'MANIFEST']
+
+  spec.add_development_dependency('test-unit')
+  spec.add_development_dependency('rake')
+
+  spec.description = <<-EOF
+    CUBE (Composable Units of Behaviour) implements Interfaces, Traits and typechecks for Ruby.
+  EOF
+end

data/doc/Bar.html

@@ -0,0 +1,102 @@
+<!DOCTYPE html>
+
+<html>
+<head>
+<meta charset="UTF-8">
+
+<title>class Bar - RDoc Documentation</title>
+
+<script type="text/javascript">
+  var rdoc_rel_prefix = "./";
+</script>
+
+<script src="./js/jquery.js"></script>
+<script src="./js/darkfish.js"></script>
+
+<link href="./css/fonts.css" rel="stylesheet">
+<link href="./css/rdoc.css" rel="stylesheet">
+
+
+
+<body id="top" role="document" class="class">
+<nav role="navigation">
+  <div id="project-navigation">
+    <div id="home-section" role="region" title="Quick navigation" class="nav-section">
+  <h2>
+    <a href="./index.html" rel="home">Home</a>
+  </h2>
+
+  <div id="table-of-contents-navigation">
+    <a href="./table_of_contents.html#pages">Pages</a>
+    <a href="./table_of_contents.html#classes">Classes</a>
+    <a href="./table_of_contents.html#methods">Methods</a>
+  </div>
+</div>
+
+    <div id="search-section" role="search" class="project-section initially-hidden">
+  <form action="#" method="get" accept-charset="utf-8">
+    <div id="search-field-wrapper">
+      <input id="search-field" role="combobox" aria-label="Search"
+             aria-autocomplete="list" aria-controls="search-results"
+             type="text" name="search" placeholder="Search" spellcheck="false"
+             title="Type to search, Up and Down to navigate, Enter to load">
+    </div>
+
+    <ul id="search-results" aria-label="Search Results"
+        aria-busy="false" aria-expanded="false"
+        aria-atomic="false" class="initially-hidden"></ul>
+  </form>
+</div>
+
+  </div>
+
+  
+
+  <div id="class-metadata">
+    
+    <div id="parent-class-section" class="nav-section">
+  <h3>Parent</h3>
+
+  
+  <p class="link"><a href="Object.html">Object</a>
+  
+</div>
+
+    
+    
+    
+  </div>
+</nav>
+
+<main role="main" aria-labelledby="class-Bar">
+  <h1 id="class-Bar" class="class">
+    class Bar
+  </h1>
+
+  <section class="description">
+    
+  </section>
+
+  
+  
+  
+  <section id="5Buntitled-5D" class="documentation-section">
+    
+
+    
+
+    
+
+    
+
+    
+  </section>
+</main>
+
+
+<footer id="validator-badges" role="contentinfo">
+  <p><a href="http://validator.w3.org/check/referer">Validate</a>
+  <p>Generated by <a href="http://docs.seattlerb.org/rdoc/">RDoc</a> 4.2.0.
+  <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
+</footer>
+

data/doc/CHANGES.html

@@ -0,0 +1,159 @@
+<!DOCTYPE html>
+
+<html>
+<head>
+<meta charset="UTF-8">
+
+<title>CHANGES - RDoc Documentation</title>
+
+<script type="text/javascript">
+  var rdoc_rel_prefix = "./";
+</script>
+
+<script src="./js/jquery.js"></script>
+<script src="./js/darkfish.js"></script>
+
+<link href="./css/fonts.css" rel="stylesheet">
+<link href="./css/rdoc.css" rel="stylesheet">
+
+
+
+<body id="top" role="document" class="file">
+<nav role="navigation">
+  <div id="project-navigation">
+    <div id="home-section" role="region" title="Quick navigation" class="nav-section">
+  <h2>
+    <a href="./index.html" rel="home">Home</a>
+  </h2>
+
+  <div id="table-of-contents-navigation">
+    <a href="./table_of_contents.html#pages">Pages</a>
+    <a href="./table_of_contents.html#classes">Classes</a>
+    <a href="./table_of_contents.html#methods">Methods</a>
+  </div>
+</div>
+
+    <div id="search-section" role="search" class="project-section initially-hidden">
+  <form action="#" method="get" accept-charset="utf-8">
+    <div id="search-field-wrapper">
+      <input id="search-field" role="combobox" aria-label="Search"
+             aria-autocomplete="list" aria-controls="search-results"
+             type="text" name="search" placeholder="Search" spellcheck="false"
+             title="Type to search, Up and Down to navigate, Enter to load">
+    </div>
+
+    <ul id="search-results" aria-label="Search Results"
+        aria-busy="false" aria-expanded="false"
+        aria-atomic="false" class="initially-hidden"></ul>
+  </form>
+</div>
+
+  </div>
+
+  
+<div class="nav-section">
+  <h3>Table of Contents</h3>
+
+  <ul class="link-list" role="directory">
+    <li><a href="#label-1.0.4+-+8-Jan-2016">1.0.4 - 8-Jan-2016</a>
+    <li><a href="#label-1.0.3+-+12-Oct-2014">1.0.3 - 12-Oct-2014</a>
+    <li><a href="#label-1.0.2+-+7-Oct-2009">1.0.2 - 7-Oct-2009</a>
+    <li><a href="#label-1.0.1+-+29-Jul-2009">1.0.1 - 29-Jul-2009</a>
+    <li><a href="#label-1.0.0+-+5-Jun-2005">1.0.0 - 5-Jun-2005</a>
+    <li><a href="#label-0.1.0+-+9-May-2004">0.1.0 - 9-May-2004</a>
+  </ul>
+</div>
+
+
+  <div id="project-metadata">
+    <div id="fileindex-section" class="nav-section">
+  <h3>Pages</h3>
+
+  <ul class="link-list">
+  
+    <li><a href="./CHANGES.html">CHANGES</a>
+  
+    <li><a href="./MANIFEST.html">MANIFEST</a>
+  
+    <li><a href="./README.html">README</a>
+  
+    <li><a href="./Rakefile.html">Rakefile</a>
+  
+    <li><a href="./certs/djberg96_pub_pem.html">djberg96_pub.pem</a>
+  
+    <li><a href="./interface_gemspec.html">interface.gemspec</a>
+  
+  </ul>
+</div>
+
+  </div>
+</nav>
+
+<main role="main" aria-label="Page CHANGES">
+
+<h2 id="label-1.0.4+-+8-Jan-2016">1.0.4 - 8-Jan-2016<span><a href="#label-1.0.4+-+8-Jan-2016">&para;</a> <a href="#top">&uarr;</a></span></h2>
+<ul><li>
+<p>This gem is now signed.</p>
+</li><li>
+<p>The gem related tasks in the <a href="Rakefile.html">Rakefile</a> now
+assume Rubygems 2.x.</p>
+</li></ul>
+
+<h2 id="label-1.0.3+-+12-Oct-2014">1.0.3 - 12-Oct-2014<span><a href="#label-1.0.3+-+12-Oct-2014">&para;</a> <a href="#top">&uarr;</a></span></h2>
+<ul><li>
+<p><a href="Rakefile.html">Rakefile</a>, gemspec and <a
+href="README.html">README</a> updates.</p>
+</li></ul>
+
+<h2 id="label-1.0.2+-+7-Oct-2009">1.0.2 - 7-Oct-2009<span><a href="#label-1.0.2+-+7-Oct-2009">&para;</a> <a href="#top">&uarr;</a></span></h2>
+<ul><li>
+<p>Fixed packaging bug in the gemspec, and made some other minor changes.</p>
+</li><li>
+<p>Added the &#39;gem&#39; rake task.</p>
+</li><li>
+<p>Updated copyright and license in the <a href="README.html">README</a>.</p>
+</li></ul>
+
+<h2 id="label-1.0.1+-+29-Jul-2009">1.0.1 - 29-Jul-2009<span><a href="#label-1.0.1+-+29-Jul-2009">&para;</a> <a href="#top">&uarr;</a></span></h2>
+<ul><li>
+<p>Now compatible with Ruby 1.9.x.</p>
+</li><li>
+<p>Replaced the install.rb with a <a href="Rakefile.html">Rakefile</a> and
+various tasks.</p>
+</li><li>
+<p>Updated the license to Artistic 2.0.</p>
+</li><li>
+<p>Added test-unit 2.x as a development dependency and refactored the test
+suite to take advantage of some of its features.</p>
+</li><li>
+<p>Renamed the test file to test_interface.rb.</p>
+</li><li>
+<p>Renamed the example programs to all start with &#39;example_&#39; to avoid
+any possible confusion with actual test suites.</p>
+</li><li>
+<p>Added rake tasks for running the example programs.</p>
+</li><li>
+<p>Updated and refactored the gemspec.</p>
+</li></ul>
+
+<h2 id="label-1.0.0+-+5-Jun-2005">1.0.0 - 5-Jun-2005<span><a href="#label-1.0.0+-+5-Jun-2005">&para;</a> <a href="#top">&uarr;</a></span></h2>
+<ul><li>
+<p>Re-released on RubyForge.</p>
+</li><li>
+<p>Some test suite and doc changes.</p>
+</li></ul>
+
+<h2 id="label-0.1.0+-+9-May-2004">0.1.0 - 9-May-2004<span><a href="#label-0.1.0+-+9-May-2004">&para;</a> <a href="#top">&uarr;</a></span></h2>
+<ul><li>
+<p>Initial release</p>
+</li></ul>
+</main>
+
+
+
+<footer id="validator-badges" role="contentinfo">
+  <p><a href="http://validator.w3.org/check/referer">Validate</a>
+  <p>Generated by <a href="http://docs.seattlerb.org/rdoc/">RDoc</a> 4.2.0.
+  <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
+</footer>
+