focus_actor 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d829a31144bf0acd271fe344c811c7c2a9ebbf87032c8ff161207c590a36bdf3
+  data.tar.gz: cefdfe56ecb66e63680c84c1c0020e655ca0f3c12b1dda9dff6370b054143198
+SHA512:
+  metadata.gz: b21356bcd44f228fa626cb2257a6cbcf6e4fcd0c494f5d60b3f1d224cc8379b3eb2c2c9e45798e2d3badfc4de97bbae253bb847dd263f9c3af85b680dc9bddbc
+  data.tar.gz: a78c8beae8dbf4a1a4470305d0e758269a4e4467048352bdd768e62dde617d15a821131ab37ae83f0ecbb73fcba39a2d791f4db4866bc30c7f8a6ff1a1127e3d

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+.byebug_history

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,254 @@
+require:
+  - rubocop-performance
+  - rubocop-rails
+
+AllCops:
+  TargetRubyVersion: 2.5
+  # RuboCop has a bunch of cops enabled by default. This setting tells RuboCop
+  # to ignore them, so only the ones explicitly set in this file are enabled.
+  DisabledByDefault: true
+  Exclude:
+    - './focus_actor.gemspec'
+
+Performance:
+  Exclude:
+    - '**/test/**/*'
+
+# Prefer assert_not over assert !
+Rails/AssertNot:
+  Include:
+    - '**/test/**/*'
+
+# Prefer assert_not_x over refute_x
+Rails/RefuteMethods:
+  Include:
+    - '**/test/**/*'
+
+Rails/IndexBy:
+  Enabled: true
+
+Rails/IndexWith:
+  Enabled: true
+
+# Prefer &&/|| over and/or.
+Style/AndOr:
+  Enabled: true
+
+# Align `when` with `case`.
+Layout/CaseIndentation:
+  Enabled: true
+
+Layout/ClosingHeredocIndentation:
+  Enabled: true
+
+# Align comments with method definitions.
+Layout/CommentIndentation:
+  Enabled: true
+
+Layout/ElseAlignment:
+  Enabled: true
+
+# Align `end` with the matching keyword or starting expression except for
+# assignments, where it should be aligned with the LHS.
+Layout/EndAlignment:
+  Enabled: true
+  EnforcedStyleAlignWith: variable
+  AutoCorrect: true
+
+Layout/EmptyLineAfterMagicComment:
+  Enabled: true
+
+Layout/EmptyLinesAroundAccessModifier:
+  Enabled: true
+  EnforcedStyle: only_before
+
+Layout/EmptyLinesAroundBlockBody:
+  Enabled: true
+
+# In a regular class definition, no empty lines around the body.
+Layout/EmptyLinesAroundClassBody:
+  Enabled: true
+
+# In a regular method definition, no empty lines around the body.
+Layout/EmptyLinesAroundMethodBody:
+  Enabled: true
+
+# In a regular module definition, no empty lines around the body.
+Layout/EmptyLinesAroundModuleBody:
+  Enabled: true
+
+# Use Ruby >= 1.9 syntax for hashes. Prefer { a: :b } over { :a => :b }.
+Style/HashSyntax:
+  Enabled: true
+
+Layout/FirstArgumentIndentation:
+  Enabled: true
+
+# Method definitions after `private` or `protected` isolated calls need one
+# extra level of indentation.
+Layout/IndentationConsistency:
+  Enabled: true
+  EnforcedStyle: indented_internal_methods
+
+# Two spaces, no tabs (for indentation).
+Layout/IndentationWidth:
+  Enabled: true
+
+Layout/LeadingCommentSpace:
+  Enabled: true
+
+Layout/SpaceAfterColon:
+  Enabled: true
+
+Layout/SpaceAfterComma:
+  Enabled: true
+
+Layout/SpaceAfterSemicolon:
+  Enabled: true
+
+Layout/SpaceAroundEqualsInParameterDefault:
+  Enabled: true
+
+Layout/SpaceAroundKeyword:
+  Enabled: true
+
+Layout/SpaceBeforeComma:
+  Enabled: true
+
+Layout/SpaceBeforeComment:
+  Enabled: true
+
+Layout/SpaceBeforeFirstArg:
+  Enabled: true
+
+Style/DefWithParentheses:
+  Enabled: true
+
+# Defining a method with parameters needs parentheses.
+Style/MethodDefParentheses:
+  Enabled: true
+
+Style/RedundantFreeze:
+  Enabled: true
+
+# Use `foo {}` not `foo{}`.
+Layout/SpaceBeforeBlockBraces:
+  Enabled: true
+
+# Use `foo { bar }` not `foo {bar}`.
+Layout/SpaceInsideBlockBraces:
+  Enabled: true
+  EnforcedStyleForEmptyBraces: space
+
+# Use `{ a: 1 }` not `{a:1}`.
+Layout/SpaceInsideHashLiteralBraces:
+  Enabled: true
+
+Layout/SpaceInsideParens:
+  Enabled: true
+
+## Check quotes usage according to lint rule below.
+#Style/StringLiterals:
+#  Enabled: true
+#  EnforcedStyle: double_quotes
+
+# Detect hard tabs, no hard tabs.
+Layout/IndentationStyle:
+  Enabled: true
+
+# Empty lines should not have any spaces.
+Layout/TrailingEmptyLines:
+  Enabled: true
+
+# No trailing whitespace.
+Layout/TrailingWhitespace:
+  Enabled: true
+
+# Use quotes for string literals when they are enough.
+Style/RedundantPercentQ:
+  Enabled: true
+
+Lint/AmbiguousOperator:
+  Enabled: true
+
+Lint/AmbiguousRegexpLiteral:
+  Enabled: true
+
+Lint/ErbNewArguments:
+  Enabled: true
+
+# Use my_method(my_arg) not my_method( my_arg ) or my_method my_arg.
+Lint/RequireParentheses:
+  Enabled: true
+
+Lint/ShadowingOuterLocalVariable:
+  Enabled: true
+
+Lint/RedundantStringCoercion:
+  Enabled: true
+
+Lint/UriEscapeUnescape:
+  Enabled: true
+
+Lint/UselessAssignment:
+  Enabled: true
+
+Lint/DeprecatedClassMethods:
+  Enabled: true
+
+Style/ParenthesesAroundCondition:
+  Enabled: true
+
+Style/HashTransformKeys:
+  Enabled: true
+
+Style/HashTransformValues:
+  Enabled: true
+
+Style/RedundantBegin:
+  Enabled: true
+
+Style/RedundantReturn:
+  Enabled: true
+  AllowMultipleReturnValues: true
+
+Style/Semicolon:
+  Enabled: true
+  AllowAsExpressionSeparator: true
+
+# Prefer Foo.method over Foo::method
+Style/ColonMethodCall:
+  Enabled: true
+
+Style/TrivialAccessors:
+  Enabled: true
+
+Performance/FlatMap:
+  Enabled: true
+
+Performance/RedundantMerge:
+  Enabled: true
+
+Performance/StartWith:
+  Enabled: true
+
+Performance/EndWith:
+  Enabled: true
+
+Performance/RegexpMatch:
+  Enabled: true
+
+Performance/ReverseEach:
+  Enabled: true
+
+Performance/UnfreezeString:
+  Enabled: true
+
+#Performance/DeletePrefix:
+#  Enabled: true
+#
+#Performance/DeleteSuffix:
+#  Enabled: true
+
+Style/FrozenStringLiteralComment:
+  Enabled: false

data/.travis.yml

@@ -0,0 +1,6 @@
+---
+language: ruby
+cache: bundler
+rvm:
+  - 2.6.3
+before_install: gem install bundler -v 2.1.4

data/Gemfile

@@ -0,0 +1,8 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in focus_actor.gemspec
+gemspec
+
+gem 'byebug'
+gem "rake", "~> 12.0"
+gem "rspec", "~> 3.0"

data/Gemfile.lock

@@ -0,0 +1,36 @@
+PATH
+  remote: .
+  specs:
+    focus_actor (0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    byebug (11.1.3)
+    diff-lcs (1.3)
+    rake (12.3.2)
+    rspec (3.8.0)
+      rspec-core (~> 3.8.0)
+      rspec-expectations (~> 3.8.0)
+      rspec-mocks (~> 3.8.0)
+    rspec-core (3.8.0)
+      rspec-support (~> 3.8.0)
+    rspec-expectations (3.8.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-mocks (3.8.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-support (3.8.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  byebug
+  focus_actor!
+  rake (~> 12.0)
+  rspec (~> 3.0)
+
+BUNDLED WITH
+   2.1.4

data/README.md

@@ -0,0 +1,45 @@
+# FocusActor
+
+This is a toy tool to extend concurrency for objects.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'focus_actor'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install focus_actor
+
+## Usage
+
+```ruby
+class User
+  include FocusActor::Async
+  include FocusActor::Future
+
+  attr_reader :name, :age
+
+  def initialize(name)
+    @name = name
+    @age = 0
+  end
+
+  def grow(cost = 0.1)
+    sleep cost
+    @age += 1
+  end
+end
+
+user = User.new('Bob')
+user.async.grow(1) # return nil, without block
+future = user.future.grow(1) # return FutureCell
+future.value
+```

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "focus_actor"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/focus_actor.gemspec

@@ -0,0 +1,28 @@
+require_relative 'lib/focus_actor/version'
+
+Gem::Specification.new do |spec|
+  spec.name = "focus_actor"
+  spec.version = FocusActor::VERSION
+  spec.authors = ["Baodong"]
+  spec.email = ["wwwicbd@gmail.com"]
+
+  spec.summary = %q{Actor Tools}
+  spec.description = %q{Actor Tools}
+  spec.homepage = 'https://github.com/icbd/focus_actor'
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
+
+  #spec.metadata["allowed_push_host"] = "TODO: Set to 'http://mygemserver.com'"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "#{spec.homepage}.git"
+  spec.metadata["changelog_uri"] = "#{spec.homepage}/tags"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+end

data/lib/focus_actor.rb

@@ -0,0 +1,8 @@
+require "focus_actor/version"
+require "focus_actor/async"
+require "focus_actor/future"
+
+module FocusActor
+  class Error < StandardError
+  end
+end

data/lib/focus_actor/async.rb

@@ -0,0 +1,17 @@
+require_relative 'async_processor'
+
+module FocusActor
+  module Async
+    module InitializeExtension
+      def initialize(*args, &block)
+        super
+        @async = AsyncProcessor.new(self)
+      end
+    end
+
+    def self.included(base)
+      base.send :prepend, InitializeExtension
+      base.attr_reader :async
+    end
+  end
+end

data/lib/focus_actor/async_processor.rb

@@ -0,0 +1,40 @@
+require_relative 'cell_context'
+
+module FocusActor
+  # This is a Proxy for instance.
+  # It can response instance methods on instance.
+  #
+  # Start a new thread, and then loop to call methods in mailbox.
+  class AsyncProcessor
+    attr_reader :instance, :mailbox
+
+    # mailbox should be thread safe
+    def initialize(instance, mailbox: Queue.new)
+      @instance = instance
+      @mailbox = mailbox
+
+      run!
+    end
+
+    # To call a method, push it to mailbox.
+    def method_missing(method, *args, &block)
+      return super unless instance.respond_to?(method)
+
+      mailbox.push CellContext.new(method, args, block)
+      nil
+    end
+
+    def respond_to_missing?(method, include_all = false)
+      instance.respond_to?(method) || super
+    end
+
+    private def run!
+      Thread.new do
+        loop do
+          cell_context = mailbox.pop
+          instance.public_send(cell_context.method, *cell_context.args, &cell_context.block)
+        end
+      end
+    end
+  end
+end

data/lib/focus_actor/cell_context.rb

@@ -0,0 +1,4 @@
+module FocusActor
+  CellContext = Struct.new(:method, :args, :block) do
+  end
+end

data/lib/focus_actor/future.rb

@@ -0,0 +1,17 @@
+require_relative 'future_processor'
+
+module FocusActor
+  module Future
+    module InitializeExtension
+      def initialize(*args, &block)
+        super
+        @future = FutureProcessor.new(self)
+      end
+    end
+
+    def self.included(base)
+      base.send :prepend, InitializeExtension
+      base.attr_reader :future
+    end
+  end
+end

data/lib/focus_actor/future_cell.rb

@@ -0,0 +1,14 @@
+module FocusActor
+  class FutureCell
+    def initialize(queue)
+      @queue = queue
+      @value_lock = Mutex.new
+    end
+
+    def value
+      @value ||= @value_lock.synchronize do
+        @value ||= @queue.pop
+      end
+    end
+  end
+end

data/lib/focus_actor/future_processor.rb

@@ -0,0 +1,27 @@
+require_relative 'cell_context'
+require_relative 'future_cell'
+
+module FocusActor
+  class FutureProcessor
+    attr_reader :instance
+
+    def initialize(instance)
+      @instance = instance
+    end
+
+    def method_missing(method, *args, &block)
+      return super unless instance.respond_to?(method)
+
+      queue = Queue.new
+      Thread.new do
+        queue.push instance.public_send(method, *args, &block)
+      end
+
+      FutureCell.new(queue)
+    end
+
+    def respond_to_missing?(method, include_all = false)
+      instance.respond_to?(method) || super
+    end
+  end
+end

data/lib/focus_actor/version.rb

@@ -0,0 +1,3 @@
+module FocusActor
+  VERSION = '0.1.0'
+end

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification
+name: focus_actor
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Baodong
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2020-07-30 00:00:00.000000000 Z
+dependencies: []
+description: Actor Tools
+email:
+- wwwicbd@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- focus_actor.gemspec
+- lib/focus_actor.rb
+- lib/focus_actor/async.rb
+- lib/focus_actor/async_processor.rb
+- lib/focus_actor/cell_context.rb
+- lib/focus_actor/future.rb
+- lib/focus_actor/future_cell.rb
+- lib/focus_actor/future_processor.rb
+- lib/focus_actor/version.rb
+homepage: https://github.com/icbd/focus_actor
+licenses: []
+metadata:
+  homepage_uri: https://github.com/icbd/focus_actor
+  source_code_uri: https://github.com/icbd/focus_actor.git
+  changelog_uri: https://github.com/icbd/focus_actor/tags
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.6
+signing_key:
+specification_version: 4
+summary: Actor Tools
+test_files: []