empathy 0.0.1.RC0 → 0.0.1.RC2

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: empathy
 version: !ruby/object:Gem::Version
-  version: 0.0.1.RC0
+  version: 0.0.1.RC2
   prerelease: 6
 platform: ruby
 authors:
@@ -10,8 +10,24 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-05-30 00:00:00.000000000 Z
+date: 2013-07-26 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: eventmachine
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: mspec
   requirement: !ruby/object:Gem::Requirement
@@ -61,21 +77,37 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: eventmachine
+  name: yard
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ~>
+    - - ! '>='
       - !ruby/object:Gem::Version
-        version: 1.0.0
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ~>
+    - - ! '>='
       - !ruby/object:Gem::Version
-        version: 1.0.0
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Empathic Eventmachine
 email:
 - grant@lastweekend.com.au
@@ -84,21 +116,25 @@ extensions: []
 extra_rdoc_files: []
 files:
 - .gitignore
+- .yardopts
+- CHANGES.md
 - Gemfile
 - LICENSE.txt
-- README.rdoc
+- README.md
 - Rakefile
-- TESTING.rdoc
+- TESTING.md
 - empathy.gemspec
 - empathy.mspec
 - lib/empathy.rb
 - lib/empathy/em/condition_variable.rb
+- lib/empathy/em/monitor.rb
 - lib/empathy/em/mutex.rb
 - lib/empathy/em/queue.rb
 - lib/empathy/em/thread.rb
 - lib/empathy/object.rb
-- lib/empathy/thread.rb
 - lib/empathy/version.rb
+- lib/empathy/with_all_of_ruby.rb
+- lib/monitor.rb
 - mspec/lib/mspec/empathy.rb
 - mspec/lib/mspec/guards/empathy.rb
 - rubyspec/core/kernel/fixtures/__method__.rb
@@ -184,6 +220,7 @@ files:
 - rubyspec/library/queue/shared/length.rb
 - rubyspec/library/queue/shift_spec.rb
 - rubyspec/library/queue/size_spec.rb
+- rubyspec/monitor_spec.rb
 - rubyspec/shared/kernel/raise.rb
 - rubyspec/shared/mutex/lock.rb
 - rubyspec/shared/mutex/locked.rb
@@ -194,6 +231,7 @@ files:
 - spec/empathy_spec.rb
 - spec/library_spec.rb
 - spec/spec_helper.rb
+- yard/extensions.rb
 homepage: http://rubygems.org/gems/empathy
 licenses:
 - MIT
@@ -215,8 +253,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: 1.3.1
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 1.8.25
 signing_key: 
 specification_version: 3
 summary: Make EventMachine behave like ruby
 test_files: []
+has_rdoc: 

data/README.rdoc

@@ -1,135 +0,0 @@
-= empathy
-
-Empathy
-
-http://rubygems.org/gems/empathy
-
-Make EventMachine behave like standard Ruby
-
-== Empathic Threads
-
-Empathy::EM module uses Fibers to provide Thread, Queue, Mutex, ConditionVariable and MonitorMixin classes that behave like the native ruby ones.
-
-  require 'eventmachine'
-  require 'empathy'
-
-  # start eventmachine and a main EM::Thread
-  Empathy.run do
-    thread = Empathy::EM::Thread.new do
-      my_thread = Empathy::EM::Thread.current
-
-      #local storage
-      Empathy::EM::Thread.current[:my_key] = "some value"
-
-      #pass control elsewhere
-      Empathy::EM::Thread.pass
-
-      Empathy::EM::Kernel.sleep(1)
-
-      1 + 2
-    end
-
-    thread.join
-    thread.value # => 3
-  end
-
-Almost all Thread behaviour is provided except that one thread will never see another as "running". Where ruby's thread API raises ThreadError, Empathy::EM will raise FiberError.
-
-== Empathic code outside of the EventMachine reactor
-
-If your code may run inside or outside the reactor the Empathy module itself provides a set of submodules that delegate to either the native ruby class when called outside of the reactor, or to the Empathy:EM class when called inside the reactor.
-
-  require 'eventmachine'
-  require 'empathy'
-  Empathy::Thread.current.inspect # => "Thread<...>"
-
-  # normal Kernel.sleep
-  Empathy::Thread.sleep(1)
-
-  Empathy.event_machine? # => false
-
-  Empathy.run do
-
-    Empathy.event_machine? # => true
-
-    Empathy::Thread.new do
-
-      Empathy::Thread.current.inspect #=> "Empathy::EM::Thread<...>"
-
-      Empathy::Kernel.sleep(1)
-
-      begin
-           #...do something with threads...
-      rescue Empathy::ThreadError
-           # ...
-      end
-    end
-  end
-
-Note that since Empathy::Thread and friends are modules, you cannot subclass them
-
-== Empathise with all ruby code
-
-Seamlessly Replace Ruby's native classes with the Empathy:EM ones (redefines constants), plus monkey patching of
- Object#sleep and Object#at_exit
-
-  require 'empathy/thread'
-  # do not run any code that uses threads outside of the reactor after the above require
-
-  Empathy.run do
-    t = Thread.new { 1 + 2 }
-
-    t.inspect # => "Empathy::EM::Thread<.....>"
-
-    # this will be a Fiber+EM sleep, not Kernel.sleep
-    sleep(4)
-
-    t.join
-  end
-
-Caveat: Take care with code that subclasses Thread. This can work as long as the classes are defined after
- 'empathy/thread' is required.
-
-Q: But doesn't eventmachine need to use normal threads?
-A: Indeed, 'empathy/thread' also defines constants in the EventMachine namespace that refer to the original Ruby classes
-
-== Empathise a library module
-
-  module MyLibary
-     def create_thread
-        Thread.new { Thread.current.inspect }
-     end
-  end
-
-  # If library will only be used inside the reactor
-  Empathy::EM::empathise(MyLibrary)
-
-  # If library is used both inside and outside the reactor
-  Empathy.empathise((MyLibrary)
-
-In both cases constants are defined in the MyLibrary namespace so that Thread, Queue etc, refer to either Empathy modules
-or Empathy:EM classes. Note that any call to empathise will have the side-effect of monkey patching Object to provide EM
-safe #sleep and #at_exit.
-
-Caveat: MyLibrary must not subclass Thread etc...
-
-== Empathy::EM::IO - Implement Ruby's Socket API over EventMachine
-
-Work in progress - see experimental socket-io branch 
-
-== Contributing to empathy
-* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
-* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
-* Fork the project
-* Start a feature/bugfix branch
-* Commit and push until you are happy with your contribution
-* Make sure to add specs, preferably based on ruby-spec
-* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
-
-== Copyright
-
-Copyright (c) 2011 Christopher J. Bottaro. (Original fiber+EM concept in "strand" library)
-Copyright (c) 2012,2013 Grant Gardner.
-
-See LICENSE.txt for further details.
-

data/TESTING.rdoc

@@ -1,11 +0,0 @@
-= Empathy Testing
-
-== Empathy::EM
-
-Classes in Empathy::EM module are tested  using the fully empathic method - replacing Ruby's ::Thread constant with one that points to Empathy::EM::Thread etc, and then running against the subset of rubyspec to do with threads. The rubyspecs are not changed at all. Some tests are skipped (see *.mspec)
-
-This also tests Empathy.run and the class replacement approach (including subclassing)
-
-== Empathy module - reactor aware
-
-We just test that the delegation works as expected, with explicit specs run under rspec

data/lib/empathy/thread.rb

@@ -1,8 +0,0 @@
-require 'eventmachine'
-require 'empathy'
-require 'empathy/object'
-
-module Empathy
- map_classes(::EventMachine,::Object,"Thread","Queue","Mutex","ConditionVariable", "ThreadError" )
- map_classes(::Object,Empathy::EM,"Thread","Queue","Mutex","ConditionVariable", "ThreadError" => FiberError)
-end