celluloid-essentials 0.20.0.pre12

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 465c17603445ec94193ded92aa14e4c03a9f458e
+  data.tar.gz: b47f9cc8d04bb273aef64b60cc5ee756e559e0ee
+SHA512:
+  metadata.gz: 9dff6fac7b6ba39e3a72bcf10f83e2d12fd62830456d584f119e404f5bf864b5010eaf776ce9fdc48ed4c0ac7ba06b9e63d2c60589975cda9d2b544de70fda12
+  data.tar.gz: bdbf67635bc5d8df9b61120fd657018daeb159c6d7a808b4fd1362d1e23e11bbd2f2c7904ad4e2d0fb0a14f921f037fb42133ddb1e87ed8947cddf0de5fdf567

data/.env-ci

@@ -0,0 +1,4 @@
+CELLULOID_SPECS_LOG_STRATEGY=stderr
+CELLULOID_SPECS_LOG_LEVEL=3
+CELLULOID_SPECS_LOG_FILE=log/ci.log
+CELLULOID_SPECS_LOG_SYNC=false

data/.env-dev

@@ -0,0 +1,4 @@
+CELLULOID_SPECS_LOG_STRATEGY=single
+CELLULOID_SPECS_LOG_FILE=log/test.log
+CELLULOID_SPECS_LOG_LEVEL=0
+CELLULOID_SPECS_LOG_SYNC=true

data/.gitignore

@@ -0,0 +1,10 @@
+coverage/
+rdoc/
+doc/
+pkg/
+tmp/
+.yardoc
+.bundle
+Gemfile.lock
+log
+.DS_Store

data/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "culture"]
+	path = culture
+	url = http://github.com/celluloid/culture.git

data/.rspec

@@ -0,0 +1,5 @@
+--color
+--format documentation
+--order random
+--warnings
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,2 @@
+inherit_from:
+  - culture/rubocop/rubocop.yml

data/.travis.yml

@@ -0,0 +1,29 @@
+script: rake ci
+language: ruby
+rvm:
+  - 2.2.0
+  - jruby
+  - ruby-head
+  - jruby-head
+  - rbx-2
+
+matrix:
+  allow_failures:
+    - rvm: rbx-2
+    - rvm: ruby-head
+    - rvm: jruby-head
+    - env: CELLULOID_TASK_CLASS=Threaded
+
+env:
+  matrix:
+    - CELLULOID_TASK_CLASS=Fibered
+    - CELLULOID_TASK_CLASS=Threaded
+    - CELLULOID_BACKPORTED=false
+  global:
+    - NUMBER_OF_PROCESSORS=2 CELLULOID_CONFIG_FILE=.env-ci
+
+notifications:
+  irc: "irc.freenode.org#celluloid"
+
+sudo: false
+install: bundle install --retry=3 --without=development

data/Gemfile

@@ -0,0 +1,29 @@
+source 'https://rubygems.org'
+
+gem 'bundler'
+gem 'coveralls', require: false
+
+gemspec development_group: :gem_build_tools
+
+group :development do
+  gem 'pry'
+  #de gem 'guard'
+  #de gem 'rb-fsevent', '~> 0.9.1' if RUBY_PLATFORM =~ /darwin/
+  #de gem 'guard-rspec'
+  gem 'rubocop'
+end
+
+group :test do
+  gem 'dotenv', '~> 2.0'
+  gem 'nenv'
+  gem 'benchmark_suite'
+  gem 'rspec', '~> 3.2'
+  gem 'rspec-retry'
+  gem 'rspec-log_split', github: 'abstractive/rspec-log_split', branch: 'master'
+end
+
+group :gem_build_tools do
+  gem 'rake'
+end
+
+gem 'celluloid-gems', github: 'celluloid/celluloid-gems', branch: 'master'

data/LICENSE.txt

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Celluloid
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

data/README.md

@@ -0,0 +1,3 @@
+# Celluloid Essentials
+
+* Prerelease gem.

data/Rakefile

@@ -0,0 +1,9 @@
+require 'bundler/gem_tasks'
+
+Dir['tasks/**/*.rake'].each { |task| load task }
+
+default_tasks = ['spec']
+default_tasks << 'rubocop' unless ENV['CI']
+task default: default_tasks
+
+task ci: %w(spec benchmark)

data/celluloid-essentials.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |gem|
+  gem.name         = 'celluloid-essentials'
+  gem.version      = '0.20.0.pre12'
+  gem.platform     = Gem::Platform::RUBY
+  gem.summary      = 'Internally used tools, and superstructural dependencies of Celluloid'
+  gem.description  = 'Notifications, Internals, Logging, Probe, and essential Celluloid pieces demanding Supervision'
+  gem.licenses     = ['MIT']
+
+  gem.authors      = ["Tony Arcieri", "digitalextremist //"]
+  gem.email        = ['tony.arcieri@gmail.com', 'code@extremist.digital']
+  gem.homepage     = 'https://github.com/celluloid/celluloid-essentials'
+
+  gem.required_ruby_version     = '>= 1.9.2'
+  gem.required_rubygems_version = '>= 1.3.6'
+
+  gem.files        = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|examples|spec|features)/}) }
+  gem.require_path = 'lib'
+
+  gem.add_development_dependency 'bundler'
+
+  gem.add_dependency 'celluloid-gems'
+end

data/lib/celluloid/essentials.rb

@@ -0,0 +1,33 @@
+module Celluloid::Internals; end
+
+require 'celluloid/internals/call_chain'
+require 'celluloid/internals/cpu_counter'
+require 'celluloid/internals/links'
+require 'celluloid/internals/logger'
+require 'celluloid/internals/method'
+require 'celluloid/internals/properties'
+require 'celluloid/internals/handlers'
+require 'celluloid/internals/receivers'
+require 'celluloid/internals/registry'
+require 'celluloid/internals/responses'
+require 'celluloid/internals/signals'
+require 'celluloid/internals/task_set'
+require 'celluloid/internals/thread_handle'
+require 'celluloid/internals/uuid'
+
+require 'celluloid/internals/stack'
+
+require 'celluloid/notifications'
+require 'celluloid/logging'
+
+if $CELLULOID_DEPRECATE
+  puts "@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@}"
+  Celluloid::Registry = Celluloid::Internals::Registry
+  Celluloid::Logger = Celluloid::Internals::Logger
+end
+
+require 'celluloid/supervision'
+
+# TODO: Remove unneeded gem requirements once the gems are well known.
+require 'celluloid/pool'
+require 'celluloid/fsm'

data/lib/celluloid/internals/call_chain.rb

@@ -0,0 +1,15 @@
+module Celluloid
+  module Internals
+    class CallChain
+      def self.current_id=(value)
+        Thread.current[:celluloid_chain_id] = value
+        task = Thread.current[:celluloid_task]
+        task.chain_id = value if task
+      end
+
+      def self.current_id
+        Thread.current[:celluloid_chain_id]
+      end
+    end
+  end
+end

data/lib/celluloid/internals/cpu_counter.rb

@@ -0,0 +1,36 @@
+module Celluloid
+  module Internals
+    module CPUCounter
+      class << self
+        def cores
+          @cores ||= count_cores
+        end
+
+        private
+
+        def count_cores
+          result = from_env || from_sysdev || from_sysctl
+          Integer(result.to_s[/\d+/], 10) if result
+        end
+
+        def from_env
+          result = ENV['NUMBER_OF_PROCESSORS']
+          result if result
+        end
+
+        def from_sysdev
+          ::IO.read('/sys/devices/system/cpu/present').split('-').last.to_i + 1
+        rescue Errno::ENOENT
+          result = Dir['/sys/devices/system/cpu/cpu*'].count { |n| n =~ /cpu\d+/ }
+          result unless result.zero?
+        end
+
+        def from_sysctl
+          result = `sysctl -n hw.ncpu`
+          result if $?.success?
+        rescue Errno::ENOENT
+        end
+      end
+    end
+  end
+end

data/lib/celluloid/internals/handlers.rb

@@ -0,0 +1,42 @@
+require 'set'
+
+module Celluloid
+  module Internals
+    class Handlers
+      def initialize
+        @handlers = Set.new
+      end
+
+      def handle(*patterns, &block)
+        patterns.each do |pattern|
+          handler = Handler.new pattern, block
+          @handlers << handler
+        end
+      end
+
+      # Handle incoming messages
+      def handle_message(message)
+        handler = @handlers.find { |h| h.match(message) }
+        handler.call message if handler
+        handler
+      end
+    end
+
+    # Methods blocking on a call to receive
+    class Handler
+      def initialize(pattern, block)
+        @pattern = pattern
+        @block = block
+      end
+
+      # Match a message with this receiver's block
+      def match(message)
+        @pattern === message
+      end
+
+      def call(message)
+        @block.call message
+      end
+    end
+  end
+end

data/lib/celluloid/internals/links.rb

@@ -0,0 +1,38 @@
+module Celluloid
+  module Internals
+    # Linked actors send each other system events
+    class Links
+      include Enumerable
+
+      def initialize
+        @links = {}
+      end
+
+      # Add an actor to the current links
+      def <<(actor)
+        @links[actor.mailbox.address] = actor
+      end
+
+      # Do links include the given actor?
+      def include?(actor)
+        @links.has_key? actor.mailbox.address
+      end
+
+      # Remove an actor from the links
+      def delete(actor)
+        @links.delete actor.mailbox.address
+      end
+
+      # Iterate through all links
+      def each
+        @links.each { |_, actor| yield(actor) }
+      end
+
+      # Generate a string representation
+      def inspect
+        links = self.map(&:inspect).join(',')
+        "#<#{self.class}[#{links}]>"
+      end
+    end
+  end
+end

data/lib/celluloid/internals/logger.rb

@@ -0,0 +1,98 @@
+module Celluloid
+  module Internals
+    module Logger
+      class WithBacktrace
+        def initialize(backtrace)
+          @backtrace = backtrace
+        end
+
+        def debug(string)
+          Celluloid.logger.debug(decorate(string))
+        end
+
+        def info(string)
+          Celluloid.logger.info(decorate(string))
+        end
+
+        def warn(string)
+          Celluloid.logger.warn(decorate(string))
+        end
+
+        def error(string)
+          Celluloid.logger.error(decorate(string))
+        end
+
+        def decorate(string)
+          [string, @backtrace].join("\n\t")
+        end
+      end
+
+      @exception_handlers = []
+
+      module_function
+
+      def with_backtrace(backtrace)
+        yield WithBacktrace.new(backtrace) if Celluloid.logger
+      end
+
+      # Send a debug message
+      def debug(string)
+        Celluloid.logger.debug(string) if Celluloid.logger
+      end
+
+      # Send a info message
+      def info(string)
+        Celluloid.logger.info(string) if Celluloid.logger
+      end
+
+      # Send a warning message
+      def warn(string)
+        Celluloid.logger.warn(string) if Celluloid.logger
+      end
+
+      # Send an error message
+      def error(string)
+        Celluloid.logger.error(string) if Celluloid.logger
+      end
+
+      # Handle a crash
+      def crash(string, exception)
+        if Celluloid.log_actor_crashes
+          string << "\n" << format_exception(exception)
+          error string
+        end
+
+        @exception_handlers.each do |handler|
+          begin
+            handler.call(exception)
+          rescue => ex
+            error "EXCEPTION HANDLER CRASHED:\n" << format_exception(ex)
+          end
+        end
+      end
+
+      # Note a deprecation
+      def deprecate(message)
+        trace = caller.join("\n\t")
+        warn "DEPRECATION WARNING: #{message}\n\t#{trace}"
+      end
+
+      # Define an exception handler
+      # NOTE: These should be defined at application start time
+      def exception_handler(&block)
+        @exception_handlers << block
+        nil
+      end
+
+      # Format an exception message
+      def format_exception(exception)
+        str = "#{exception.class}: #{exception.to_s}\n\t"
+        if exception.backtrace
+          str << exception.backtrace.join("\n\t")
+        else
+          str << "EMPTY BACKTRACE\n\t"
+        end
+      end
+    end
+  end
+end