celluloid-essentials 0.20.0.pre12

data/lib/celluloid/notifications.rb

@@ -0,0 +1,95 @@
+module Celluloid
+  module Notifications
+    def self.notifier
+      Actor[:notifications_fanout] or raise DeadActorError, "notifications fanout actor not running"
+    end
+
+    def publish(pattern, *args)
+      Celluloid::Notifications.notifier.publish(pattern, *args)
+    rescue DeadActorError
+      # Bad shutdown logic. Oh well....
+      # TODO: needs a tests
+    end
+
+    module_function :publish
+
+    def subscribe(pattern, method)
+      Celluloid::Notifications.notifier.subscribe(Actor.current, pattern, method)
+    end
+
+    def unsubscribe(*args)
+      Celluloid::Notifications.notifier.unsubscribe(*args)
+    end
+
+    class Fanout
+      include Celluloid
+      trap_exit :prune
+
+      def initialize
+        @subscribers = []
+        @listeners_for = {}
+      end
+
+      def subscribe(actor, pattern, method)
+        subscriber = Subscriber.new(actor, pattern, method).tap do |s|
+          @subscribers << s
+        end
+        link actor
+        @listeners_for.clear
+        subscriber
+      end
+
+      def unsubscribe(subscriber)
+        @subscribers.reject! { |s| s.matches?(subscriber) }
+        @listeners_for.clear
+      end
+
+      def publish(pattern, *args)
+        listeners_for(pattern).each { |s| s.publish(pattern, *args) }
+      end
+
+      def listeners_for(pattern)
+        @listeners_for[pattern] ||= @subscribers.select { |s| s.subscribed_to?(pattern) }
+      end
+
+      def listening?(pattern)
+        listeners_for(pattern).any?
+      end
+
+      def prune(actor, reason=nil)
+        @subscribers.reject! { |s| s.actor == actor }
+        @listeners_for.clear
+      end
+    end
+
+    class Subscriber
+      attr_accessor :actor, :pattern, :method
+
+      def initialize(actor, pattern, method)
+        @actor = actor
+        @pattern = pattern
+        @method = method
+      end
+
+      def publish(pattern, *args)
+        actor.async method, pattern, *args
+      rescue DeadActorError
+        # TODO: needs a tests
+        # Bad shutdown logic. Oh well....
+      end
+
+      def subscribed_to?(pattern)
+        !pattern || @pattern === pattern.to_s || @pattern === pattern
+      end
+
+      def matches?(subscriber_or_pattern)
+        self === subscriber_or_pattern ||
+          @pattern && @pattern === subscriber_or_pattern
+      end
+    end
+  end
+
+  def self.publish(*args)
+    Notifications.publish(*args)
+  end
+end

data/lib/celluloid/probe.rb

@@ -0,0 +1,75 @@
+require 'celluloid'
+
+$CELLULOID_MONITORING = true
+
+module Celluloid
+  class Probe
+    include Celluloid
+    include Celluloid::Notifications
+
+    NOTIFICATIONS_TOPIC_BASE = 'celluloid.events.%s'
+    EVENTS_BUFFER = Queue.new
+
+    class << self
+      def run
+        # spawn the actor if not found
+        supervise_as(:probe_actor) unless Actor[:probe_actor] && Actor[:probe_actor].alive?
+      end
+
+      def run_without_supervision
+        Actor[:probe_actor] = Celluloid::Probe.new
+      end
+
+      def actor_created(actor)
+        trigger_event(:actor_created, actor)
+      end
+
+      def actor_named(actor)
+        trigger_event(:actor_named, actor)
+      end
+
+      def actor_died(actor)
+        trigger_event(:actor_died, actor)
+      end
+
+      def actors_linked(a, b)
+        a = find_actor(a)
+        b = find_actor(b)
+        trigger_event(:actors_linked, a, b)
+      end
+
+      private
+
+      def trigger_event(name, *args)
+        return unless $CELLULOID_MONITORING
+
+        EVENTS_BUFFER << [name, args]
+        probe_actor = Actor[:probe_actor]
+        probe_actor.async.process_queue if probe_actor
+      end
+
+      def find_actor(obj)
+        if obj.__send__(:class) == Actor
+          obj
+        elsif owner = obj.instance_variable_get(OWNER_IVAR)
+          owner
+        end
+      end
+    end
+
+    def initialize
+      async.process_queue
+    end
+
+    def process_queue
+      until EVENTS_BUFFER.empty?
+        event = EVENTS_BUFFER.pop
+        dispatch_event(*event)
+      end
+    end
+
+    def dispatch_event(cmd, args)
+      publish(NOTIFICATIONS_TOPIC_BASE % cmd, args)
+    end
+  end
+end

data/tasks/benchmarks.rake

@@ -0,0 +1,16 @@
+require 'timeout'
+
+desc "Run Celluloid benchmarks"
+task :benchmark do
+  begin
+    Timeout.timeout(120) do
+      glob = File.expand_path("../../benchmarks/*.rb", __FILE__)
+      Dir[glob].each { |benchmark| load benchmark }
+    end
+  rescue Exception, Timeout::Error => ex
+    puts "ERROR: Couldn't complete benchmark: #{ex.class}: #{ex}"
+    puts "  #{ex.backtrace.join("\n  ")}"
+
+    exit 1 unless ENV['CI'] # Hax for running benchmarks on Travis
+  end
+end

data/tasks/rspec.rake

@@ -0,0 +1,7 @@
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new
+
+RSpec::Core::RakeTask.new(:rcov) do |task|
+  task.rcov = true
+end

data/tasks/rubocop.rake

@@ -0,0 +1,4 @@
+unless ENV['CI']
+  require 'rubocop/rake_task'
+  RuboCop::RakeTask.new
+end

metadata

@@ -0,0 +1,117 @@
+--- !ruby/object:Gem::Specification
+name: celluloid-essentials
+version: !ruby/object:Gem::Version
+  version: 0.20.0.pre12
+platform: ruby
+authors:
+- Tony Arcieri
+- digitalextremist //
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-04-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  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: celluloid-gems
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Notifications, Internals, Logging, Probe, and essential Celluloid pieces
+  demanding Supervision
+email:
+- tony.arcieri@gmail.com
+- code@extremist.digital
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".env-ci"
+- ".env-dev"
+- ".gitignore"
+- ".gitmodules"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- CHANGES.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- celluloid-essentials.gemspec
+- lib/celluloid/essentials.rb
+- lib/celluloid/internals/call_chain.rb
+- lib/celluloid/internals/cpu_counter.rb
+- lib/celluloid/internals/handlers.rb
+- lib/celluloid/internals/links.rb
+- lib/celluloid/internals/logger.rb
+- lib/celluloid/internals/method.rb
+- lib/celluloid/internals/properties.rb
+- lib/celluloid/internals/receivers.rb
+- lib/celluloid/internals/registry.rb
+- lib/celluloid/internals/responses.rb
+- lib/celluloid/internals/signals.rb
+- lib/celluloid/internals/stack.rb
+- lib/celluloid/internals/stack/dump.rb
+- lib/celluloid/internals/stack/states.rb
+- lib/celluloid/internals/stack/summary.rb
+- lib/celluloid/internals/task_set.rb
+- lib/celluloid/internals/thread_handle.rb
+- lib/celluloid/internals/uuid.rb
+- lib/celluloid/logging/incident.rb
+- lib/celluloid/logging/incident_logger.rb
+- lib/celluloid/logging/incident_reporter.rb
+- lib/celluloid/logging/log_event.rb
+- lib/celluloid/logging/ring_buffer.rb
+- lib/celluloid/notifications.rb
+- lib/celluloid/probe.rb
+- tasks/benchmarks.rake
+- tasks/rspec.rake
+- tasks/rubocop.rake
+homepage: https://github.com/celluloid/celluloid-essentials
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.9.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.3.6
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Internally used tools, and superstructural dependencies of Celluloid
+test_files: []