mikka 2.0.0.pre0-java → 2.0.0.pre1-java

data/.rvmrc

@@ -1 +1 @@
-rvm --create use jruby-1.6.7@mikka
+rvm --create use jruby-1.7.0.preview2@mikka

data/README.mdown

@@ -2,21 +2,45 @@
 
 Mikka is a thin Ruby wrapper around Akka. It makes Akka's Java API more pleasing to the Rubyist's eye.
 
-It uses Akka 1.2, but there are plans to create an Akka 2.0 version as soon as possible. Follow the 2.0 development in the [`mikka-2.0` branch](https://github.com/iconara/mikka/tree/mikka-2.0).
+## Examples
 
-## Work in progress
+Here's a quick example:
 
-Mikka is a work in progress, but currently used in production. It currently mostly scratches my own itchs, but improvement suggestions and patches are welcome. 
+    # first you need an ActorSystem, it contains configuration and coordinates actors
+    actor_system = Mikka.create_actor_system('systam')
 
-Check out the `examples` directory for the basics. Start with the `hello_world.rb` example, it is extensively documented and goes through the basics.
+    # actors are created by the ActorSystem from an instance of Props, which is
+    # a container for actor configuration properties -- here we assume there
+    # exists a class called SomeActor
+    actor = actor_system.actor_of(Mikka::Props[SomeActor], 'Sigourney Weaver')
+
+    # send a message to an actor using the shovel operator, which is an alias for #tell
+    actor << :hello
+
+    # when you're done you can shut down your actor system, and wait for it to 
+    # complete the shutdown process -- don't do this too early, this won't wait
+    # for your actors to complete processing of their mailboxes, it will just 
+    # tell them to stop
+    actor_system.shutdown
+    actor_system.await_termination
+
+that's how you create and communicate with an actor, here's how you create an actor class:
+
+    class SomeActor < Mikka::Actor
+      def receive(message)
+        # do the thing
+      end
+    end
+
+that's the basics. v2.0 of Mikka is a work in progress, and there will hopefully be more examples in the future. Mikka is a thin wrapper and you should be able to do everything with it that you can with Akka's Java API. It's not always pretty in Ruby, but it kind of works. Mikka's job is to make it pretty.
 
 If you make something that can serve as a useful illustration of some concept, please contribute by sending a patch.
 
 ## Requirements
 
-Tested in JRuby 1.6.5+ and Ruby 1.9 mode (run with `jruby --1.9` or set `JRUBY_OPTS='--1.9`).
+Tested in JRuby 1.6.7+ and Ruby 1.9 mode (run with `jruby --1.9` or set `JRUBY_OPTS='--1.9`).
 
-The required Akka and Scala JARs are loaded from the [akka-actor-jars](https://rubygems.org/gems/akka-actor-jars), [akka-remote-jars](https://rubygems.org/gems/akka-remote-jars) and [scala-library-jars](https://rubygems.org/gems/scala-library-jars) wrapper gems.
+The required Akka and Scala JARs are loaded from the [akka-actor-jars](https://rubygems.org/gems/akka-actor-jars) and [scala-library-jars](https://rubygems.org/gems/scala-library-jars) wrapper gems.
 
 ## Installation
 
@@ -29,7 +53,7 @@ Daniel Gaiottino, [@bantai](http://twitter.com/bantai)
 
 ## License
 
-Mikka is licensed under the Apache 2 license, the same as Akka. See http://akka.io/docs/akka/1.2/project/licenses.html
+Mikka is licensed under the Apache 2 license, the same as Akka. See http://doc.akka.io/docs/akka/2.0/project/licenses.html
 
 ## Mikka?
 

data/lib/mikka.rb

@@ -64,13 +64,16 @@ module Mikka
     def receive(message); end
     def pre_start; end
     def post_stop; end
-    def pre_restart(reason); end
+    def pre_restart(reason, message); end
     def post_restart(reason); end
 
     def onReceive(message); receive(message); end
     def preStart; super; pre_start; end
     def postStop; super; post_stop; end
-    def preRestart(reason); super; pre_restart(reason); end
+    def preRestart(reason, message_option) 
+      super 
+      pre_restart(reason, message_option.is_defined ? message_option.get : nil)
+    end
     def postRestart(reason); super; post_restart(reason); end
   end
 

data/lib/mikka/version.rb

@@ -1,5 +1,5 @@
 # encoding: utf-8
 
 module Mikka
-  VERSION = '2.0.0.pre0'
+  VERSION = '2.0.0.pre1'
 end

data/mikka.gemspec

@@ -20,7 +20,5 @@ Gem::Specification.new do |s|
   s.add_dependency 'akka-actor-jars', '~> 2.0.2'
 
   s.files         = `git ls-files`.split("\n")
-  # s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
-  # s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   s.require_paths = %w(lib)
 end

data/spec/mikka_spec.rb

@@ -40,10 +40,31 @@ module Mikka
       actor = @system.actor_of(actor_props, 'some_actor')
       actor.should be_a(ActorRef)
     end
+  end
 
-    # future = actor.ask(:hi, 1000)
-    # reply = Mikka.await_result(future, :timeout => '1000ms')
-    # reply.should == :hi
-    
+  describe 'message sending' do
+    before do
+      @system = Mikka.create_actor_system('testsystem')
+      @actor = @system.actor_of(Props[TestActor])
+    end
+
+    after do
+      @system.shutdown
+    end
+
+    describe '#tell/#<<' do
+      it 'sends a message to an actor' do
+        @actor << 'hello'
+      end
+    end
+
+    describe '#ask' do
+      it 'sends a message'
+            # future = actor.ask(:hi, 1000)
+      # reply = Mikka.await_result(future, :timeout => '1000ms')
+      # reply.should == :hi
+
+      end
+    end
   end
 end

metadata

@@ -2,7 +2,7 @@
 name: mikka
 version: !ruby/object:Gem::Version
   prerelease: 6
-  version: 2.0.0.pre0
+  version: 2.0.0.pre1
 platform: java
 authors:
 - Theo Hultberg
@@ -10,17 +10,22 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2012-08-07 00:00:00.000000000Z
+date: 2012-08-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: akka-actor-jars
-  version_requirements: &2058 !ruby/object:Gem::Requirement
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.0.2
+    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 2.0.2
     none: false
-  requirement: *2058
   prerelease: false
   type: :runtime
 description: Mikka adapts Akka's Java API to fit better with Ruby
@@ -52,19 +57,20 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
-      version: '0'
+      version: !binary |-
+        MA==
   none: false
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>'
+  - - !binary |-
+      Pg==
     - !ruby/object:Gem::Version
       version: 1.3.1
   none: false
 requirements: []
 rubyforge_project: mikka
-rubygems_version: 1.8.15
+rubygems_version: 1.8.24
 signing_key:
 specification_version: 3
 summary: Mikka is a JRuby wrapper for Akka
 test_files: []
-...