barney 0.9.1 → 0.10.0

data/ChangeLog

@@ -3,6 +3,9 @@
 	* lib/barney/share.rb: 
 		Fix a bug where Barney::Share#share could return nil.
 		If there were no duplicates in @variables, `nil` would be returned.
+	
+	* lib/barney.rb:
+		The Barney module proxies requests onto a Barney::Share object.
 
 
 2011-04-21  Robert Gleeson <rob@flowof.info>

data/README.md

@@ -3,7 +3,8 @@
 Barney tries to make the sharing of data between processes as easy and **natural** as possible.  
 Barney is developed to run on Ruby 1.9.1 or later, but it may work on earlier versions of Ruby as well.
 
-## Limitations
+Limitations  
+-----------
 
 * Sharable objects  
   Behind the scenes, Barney is using Marshal to send data between processes.  
@@ -16,12 +17,13 @@ Barney is developed to run on Ruby 1.9.1 or later, but it may work on earlier ve
   There is a mutex lock in place, but it only concerns Barney::Share#synchronize, where data is shared
   among all instances of Barney::Share.
 
-## Examples
+Examples
+--------
 
 Okay, now that we've got that out of the way, let's see what using Barney is like:  
 (The [Samples](https://github.com/robgleeson/barney/tree/develop/samples) directory has more examples …)
 
-**Basic**
+**Barney::Share**
 
       #!/usr/bin/env ruby
       require 'barney'
@@ -40,7 +42,28 @@ Okay, now that we've got that out of the way, let's see what using Barney is lik
       puts message # 'Hello, World!' 
 
 
-## Install
+      
+**Barney (Module)** 
+
+The Barney module will forward requests onto an instance of Barney::Share:
+
+      #!/usr/bin/env ruby
+      require 'barney'
+
+      Barney.share :name
+      name = 'Robert'
+
+      pid = Barney.fork do 
+        name.slice! 0..2
+      end
+
+      Process.wait pid
+      Barney.sync
+
+      puts name # "Rob"
+
+Install
+--------
 
 RubyGems.org  
 
@@ -55,21 +78,23 @@ Github
 
 I'm following the [Semantic Versioning](http://www.semver.org) policy.  
 
-## Documentation
+Documentation
+--------------
 
 **API**  
 
 * [master (git)](http://rubydoc.info/github/robgleeson/barney/master/)
+* [0.10.0](http://rubydoc.info/gems/barney/0.10.0/)
 * [0.9.1](http://rubydoc.info/gems/barney/0.9.1/)
 * [0.9.0](http://rubydoc.info/gems/barney/0.9.0/)
 * [0.8.1](http://rubydoc.info/gems/barney/0.8.1/)
 * [0.8.0](http://rubydoc.info/gems/barney/0.8.0/)
 * [0.7.0](http://rubydoc.info/gems/barney/0.7.0)
-* [0.6.0](http://rubydoc.info/gems/barney/0.6.0)
 * …
 
 
-## License
+License
+--------
 
 Barney is released under the Lesser GPL(LGPL).  
 

data/Rakefile

@@ -1,3 +1,4 @@
+desc 'Run test suite.'
 task :test do
   $LOAD_PATH.unshift './lib'
   require 'barney'

data/lib/barney/share.rb

@@ -26,7 +26,7 @@ module Barney
       attr_reader :mutex
     end
 
-    # Returns a list of all variables or constants being shared for this instance of {Barney::Share Barney::Share}.
+    # Returns a list of all variables or constants being shared for an instance of {Barney::Share}.
     # @return [Array<Symbol>] 
     attr_reader :variables
 
@@ -50,8 +50,8 @@ module Barney
     end
 
     # Marks a variable or constant to be shared between two processes. 
-    # @param  [Symbol] Variable   Accepts the name(s) of the variables or constants you want to share.
-    # @return [Array<Symbol>]     Returns a list of all variables that are being shared.
+    # @param  [Symbol, #to_sym]  Variable  Accepts the name(s) of the variables or constants you want to share.
+    # @return [Array<Symbol>]              Returns a list of all variables that are being shared.
     def share *variables
       @variables.push *variables.map(&:to_sym)
       @variables.uniq!
@@ -59,8 +59,8 @@ module Barney
     end
 
     # Removes a variable or constant from being shared between two processes.
-    # @param  [Symbol] Variable Accepts the name(s) of the variables or constants you want to stop sharing.
-    # @return [Array<Symbol>]   Returns a list of the variables that are still being shared.
+    # @param  [Symbol, #to_sym] Variable  Accepts the name(s) of the variables or constants you want to stop sharing.
+    # @return [Array<Symbol>]             Returns a list of the variables that are still being shared.
     def unshare *variables
       variables.map(&:to_sym).each do |variable| 
         @streams.delete_if { |stream| stream.variable == variable }
@@ -104,9 +104,9 @@ module Barney
           value = eval "#{stream.variable} = Barney::Share.value", @context 
           @history.push HistoryItem.new(stream.variable, value)
         end
-      end
-    
-      @streams.clear
+
+        @streams.clear
+      end 
     end
     alias_method :sync, :synchronize
 

data/lib/barney.rb

@@ -1,6 +1,20 @@
 require 'barney/share' 
 
 module Barney 
-  VERSION = '0.9.1'
-end
 
+  VERSION = '0.10.0'
+  @proxy  = Barney::Share.new
+
+  class << self
+
+    def method_missing meth, *args, &blk
+      if @proxy.respond_to? meth
+        @proxy.send meth, *args, &blk
+      else
+        super
+      end
+    end
+
+  end
+
+end

metadata

@@ -2,7 +2,7 @@
 name: barney
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.9.1
+  version: 0.10.0
 platform: ruby
 authors: 
 - Robert Gleeson
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-04-23 00:00:00 +01:00
+date: 2011-04-25 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency