asynchronous 1.0.4 → 2.0.0

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    OTU5ZGY2NjQ1ZjAwMDBkNDhmN2JhMjkwZjdjNjk4M2RiMWQxYTRmOQ==
+    OTNkMmY0MjUwZmI4OTNhYThjYzcwZmFmYTJjN2U4MjNjNzZmZDJmYg==
   data.tar.gz: !binary |-
-    MDY5MjRjMjhjMzc2YmUxZWUzODFiMWY4NWNkYWFiM2RmZDdmNjg5MQ==
+    ODQ3ZDc0YTU1Yzc0N2VjYWFjYTgyMzBmODBmNDkwYjEzOWZlZmY0Zg==
 SHA512:
   metadata.gz: !binary |-
-    Mjg5MzZiN2I3NDM4Yzc2MmYwYzMyNzk3OGUxOWU3NjIwZTdiNjg2NDM0NGQx
-    NGQ2MGE4NmFiYTgxNDM1OWVmMmQ5YjMwZjI5ODcxZTM2MTk0NWE5OTdiOWI1
-    NTY2N2FhODI4N2JkOTljNDU1OTE5NGY0YTM4NWY3MTliNzIyNWQ=
+    OWQwOTg0MDVlZDVlMjQ2NTk4YjJjM2VhZDU2ZTZiMmI4OTAyZjhjYjk0N2Yy
+    NWNhM2RmNDcxMjVlMTJiMjNlNTU4Y2M0ZDBhZWU1OTE5OTVkNGZkNGVkOWRi
+    YWRkYzI5ZWE2OWE5MDVlNzNjYzBhMWRiYzQ5YzA3OTJlNTFkMTE=
   data.tar.gz: !binary |-
-    ZjViMzZjODEwNTI2MzIxZjNlYjE0MDZkMTg0MzNiNzY1MTQ3MDYyNmI1MzJh
-    ZTE3ODQxMWFjNjhlYmE3MWNjMDgwMmQ2NmQyOWNhNGJjOWVlOTY0ZTZhYjI4
-    N2YzOTZiYzEzOWJhNTMyZDFlNmRiMDE3Y2JmYTkxZjU4ZmExZDM=
+    ZGZkZmI1MGEwNWExMTRmNTMyM2M1NTIxMDdiOTQ5NjRmMmFlNmYwZWMwOWMw
+    N2NmODk4ZTY5NTU5ZWYyZjFmMDIxZmMzODM1NWQ5M2Y0MDczMmJiNjE0ZThj
+    YjIyMjQ4NmE4OTY5OTc2MTAyMzI5YzIzYjc3ZjU2MDVlMTg2YjI=

data/Gemfile

@@ -1,13 +1,2 @@
 source "http://rubygems.org"
-# Add dependencies required to use your gem here.
-# Example:
-#   gem "activesupport", ">= 2.3.5"
-
-# Add dependencies to develop your gem here.
-# Include everything needed to run rake, tests, features, etc.
-group :development do
-  gem "shoulda", ">= 0"
-  gem "rdoc", "~> 3.12"
-  gem "bundler", "~> 1.0"
-  gem "jeweler", "~> 1.8.7"
-end
+gemspec

data/Gemfile.lock

@@ -1,72 +1,18 @@
+PATH
+  remote: .
+  specs:
+    asynchronous (1.1.0.pre.pre)
+      process_shared
+
 GEM
   remote: http://rubygems.org/
   specs:
-    activesupport (4.0.0)
-      i18n (~> 0.6, >= 0.6.4)
-      minitest (~> 4.2)
-      multi_json (~> 1.3)
-      thread_safe (~> 0.1)
-      tzinfo (~> 0.3.37)
-    addressable (2.3.5)
-    atomic (1.1.14)
-    builder (3.2.2)
-    faraday (0.8.8)
-      multipart-post (~> 1.2.0)
-    git (1.2.6)
-    github_api (0.10.1)
-      addressable
-      faraday (~> 0.8.1)
-      hashie (>= 1.2)
-      multi_json (~> 1.4)
-      nokogiri (~> 1.5.2)
-      oauth2
-    hashie (2.0.5)
-    highline (1.6.20)
-    httpauth (0.2.0)
-    i18n (0.6.5)
-    jeweler (1.8.8)
-      builder
-      bundler (~> 1.0)
-      git (>= 1.2.5)
-      github_api (= 0.10.1)
-      highline (>= 1.6.15)
-      nokogiri (= 1.5.10)
-      rake
-      rdoc
-    json (1.8.1)
-    jwt (0.1.8)
-      multi_json (>= 1.5)
-    minitest (4.7.5)
-    multi_json (1.8.2)
-    multi_xml (0.5.5)
-    multipart-post (1.2.0)
-    nokogiri (1.5.10)
-    oauth2 (0.9.2)
-      faraday (~> 0.8)
-      httpauth (~> 0.2)
-      jwt (~> 0.1.4)
-      multi_json (~> 1.0)
-      multi_xml (~> 0.5)
-      rack (~> 1.2)
-    rack (1.5.2)
-    rake (10.1.0)
-    rdoc (3.12.2)
-      json (~> 1.4)
-    shoulda (3.5.0)
-      shoulda-context (~> 1.0, >= 1.0.1)
-      shoulda-matchers (>= 1.4.1, < 3.0)
-    shoulda-context (1.1.5)
-    shoulda-matchers (2.4.0)
-      activesupport (>= 3.0.0)
-    thread_safe (0.1.3)
-      atomic
-    tzinfo (0.3.38)
+    ffi (1.9.3)
+    process_shared (0.2.0)
+      ffi (~> 1.0)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  bundler (~> 1.0)
-  jeweler (~> 1.8.7)
-  rdoc (~> 3.12)
-  shoulda
+  asynchronous!

data/README.md

@@ -8,7 +8,7 @@ real async patterns in ruby
 Well it is achived in Ruby really simple, and elegant way.
 
 
-## Quoting Sun's Multithreaded Programming Guide:
+### Quoting Sun's Multithreaded Programming Guide:
 
 Parallelism: 
 - A condition that arises when at least two threads are executing simultaneously.
@@ -17,7 +17,7 @@ Concurrency:
 - A condition that exists when at least two threads are making progress. 
 - A more generalized form of parallelism that can include time-slicing as a form of virtual parallelism
 
-### for short:
+#### for short:
 
 Concurrency is when two tasks can start, run, and complete in overlapping time periods.
 It doesn't necessarily mean they'll ever both be running at the same instant.
@@ -27,7 +27,7 @@ Parallelism is when tasks literally run at the same time.
 Eg. on a multicore processor.
 
 
-## OS managed thread (Native Threads)
+### OS managed thread (Native Threads)
 
 copy on write memory share,
 so you cant change anything in the mother process
@@ -73,33 +73,56 @@ calculation= async { sleep 3; 4 * 3 }
 calculation.value
 
 ```
-# Examples
 
-the "async patterns" will let you see how easy to use threads 
-for multiprocessing so you can give multiple task to do and
-until you need they value, let the process run in the background
+### Shared Memory
 
-## LICENSE
+By default the last value will be returned (OS) in IO.pipe,
+but when you need something else, there is the shared_memory!
 
-(The MIT License)
+Shared memory is good when you want make a ruby worked on native OS thread ,
+but need to update data back at the mother process.
 
-Copyright (c) 2009-2013 Adam Luzsi <adamluzsi@gmail.com>
+the usecase is simple like that:
+```ruby
+
+SharedMemory.anything_you_want_use_as_variable_name= {:some=>:object}
+SharedMemory.anything_you_want_use_as_variable_name #> {:some=>:object}
+
+```
+
+by default i set the memory allocation to 16Mb because it common usecase to me (MongoDB),
+but feel free to change!:
+```ruby
+
+Asynchronous::Allocation.memory_allocation_size= 1024 #INT!
+
+```
+
+## Example
 
-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:
+```ruby
+
+# you can use simple :p or :parallelism as nametag
+# remember :parallelism is all about real OS thread case, so
+# you CANT modify the objects in memory only in sharedmemories,
+# the normal variables will only be copy on write modify
+# This is ideal for big operations where you need do a big process
+# w/o the fear of the Garbage collector slowness or the GIL lock
+# when you need to update objects in the memory use SharedMemory
+#
+# Remember! if the hardware only got 1 cpu, it will be like a harder
+# to use concurrency with an expensive memory allocation
+calculation = async :OS do
+
+  sleep 4
+  4 * 5
 
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
+end
+
+calculation.value += 1
+
+puts calculation.value
+
+```
 
-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.
+there are other examples that you can check in the exampels folder

data/VERSION

@@ -1 +1 @@
-1.0.4
+2.0.0

data/asynchronous.gemspec

@@ -12,17 +12,13 @@ Gem::Specification.new do |spec|
   spec.description   = %q{DSL for for dead simple to use asynchronous patterns in both VM managed and OS managed way (Concurrency and Parallelism) }
   spec.summary       = %q{Simple Async Based on standard CRuby}
   spec.homepage      = "https://github.com/adamluzsi/asynchronous"
-  spec.license       = "MIT"
+  #spec.license       = "MIT"
 
   spec.files         = SpecFiles
   spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
-  ##=======Runtime-ENV================##
-  #spec.add_runtime_dependency "asdf", ['~>4.1.3']
-
-  ##=======Development-ENV============##
-  #spec.add_development_dependency "asdf",['~>4.1.3']
+  spec.add_dependency "process_shared"
 
 end

data/examples/array_of_value_with_native_threads.rb

@@ -1,4 +1,4 @@
-require 'async'
+require_relative "../lib/asynchronous"
 
 async1= async :OS do
 

data/examples/async_patterns.rb

@@ -34,13 +34,13 @@ puts calculation.value
 
 #>--------------------------------------------------
 # now let's see the Parallelism
-# you can use simple :p also instead of :parallelism
+# you can use simple :p or :parallelism as nametag
 # remember :parallelism is all about real OS thread case, so
-# you CANT modify the objects in memory only copy on write modify
+# you CANT modify the objects in memory only in sharedmemories,
+# the normal variables will only be copy on write modify
 # This is ideal for big operations where you need do a big process
-# and only get the return value so you can do big works without the fear of the
-# Garbage collector slowness or the GIL lock
-# when you need to update objects in the memory use :concurrency
+# w/o the fear of the Garbage collector slowness or the GIL lock
+# when you need to update objects in the memory use SharedMemory
 calculation = async :parallelism do
 
   sleep 4

data/examples/shared_memory.rb

@@ -0,0 +1,19 @@
+require_relative "../lib/asynchronous"
+
+SharedMemory.test_value= 0
+async :OS do
+
+  loop do
+    SharedMemory.test_value += 1
+    sleep 3
+  end
+
+end
+
+loop do
+  if SharedMemory.test_value >= 10
+    Process.exit
+  end
+  puts SharedMemory.test_value
+  sleep 1
+end

data/lib/asynchronous.rb

@@ -1,9 +1,11 @@
 #encoding: UTF-8
 module Asynchronous
 
+  require 'process_shared'
   require File.join(File.dirname(__FILE__),"asynchronous","clean_class")
   require File.join(File.dirname(__FILE__),"asynchronous","concurrency")
   require File.join(File.dirname(__FILE__),"asynchronous","parallelism")
+  require File.join(File.dirname(__FILE__),"asynchronous","shared_memory")
   require File.join(File.dirname(__FILE__),"asynchronous","kernel")
 
 end

data/lib/asynchronous/shared_memory.rb

@@ -0,0 +1,138 @@
+require 'process_shared'
+require_relative "clean_class"
+module Asynchronous
+
+
+  module Allocation
+
+    class << self
+      attr_accessor :memory_allocation_size
+    end
+
+    self.memory_allocation_size= 16384
+
+    def self.mutex
+      @@mutex
+    end
+
+    @@mutex  = ProcessShared::Mutex.new
+
+  end
+
+
+  class SharedMemory < CleanClass
+    class << self
+      def method_missing(method, *args)
+
+        ::Asynchronous::Allocation.mutex.synchronize do
+          if method.to_s.include?('=')
+            begin
+              self.class_variable_get("@@#{method.to_s.sub('=','')}").write_object(args[0])
+            rescue ::NameError
+              self.class_variable_set(
+                  "@@#{method.to_s.sub('=','')}",
+                  ::ProcessShared::SharedMemory.new( ::Asynchronous::Allocation.memory_allocation_size )
+              )
+              self.class_variable_get("@@#{method.to_s.sub('=','')}").write_object(args[0])
+            end
+          else
+            begin
+              self.class_variable_get("@@#{method.to_s}").read_object
+            rescue ::NameError
+              return nil
+            end
+          end
+        end
+
+      end
+    end
+  end
+
+
+end
+
+SharedMemory ||= Asynchronous::SharedMemory
+
+
+
+=begin
+
+
+      # The C void type; only useful for function return types
+      :void => Type::VOID,
+
+      # C boolean type
+      :bool => Type::BOOL,
+
+      # C nul-terminated string
+      :string => Type::STRING,
+
+      # C signed char
+      :char => Type::CHAR,
+      # C unsigned char
+      :uchar => Type::UCHAR,
+
+      # C signed short
+      :short => Type::SHORT,
+      # C unsigned short
+      :ushort => Type::USHORT,
+
+      # C signed int
+      :int => Type::INT,
+      # C unsigned int
+      :uint => Type::UINT,
+
+      # C signed long
+      :long => Type::LONG,
+
+      # C unsigned long
+      :ulong => Type::ULONG,
+
+      # C signed long long integer
+      :long_long => Type::LONG_LONG,
+
+      # C unsigned long long integer
+      :ulong_long => Type::ULONG_LONG,
+
+      # C single precision float
+      :float => Type::FLOAT,
+
+      # C double precision float
+      :double => Type::DOUBLE,
+
+      # C long double
+      :long_double => Type::LONGDOUBLE,
+
+      # Native memory address
+      :pointer => Type::POINTER,
+
+      # 8 bit signed integer
+      :int8 => Type::INT8,
+      # 8 bit unsigned integer
+      :uint8 => Type::UINT8,
+
+      # 16 bit signed integer
+      :int16 => Type::INT16,
+      # 16 bit unsigned integer
+      :uint16 => Type::UINT16,
+
+      # 32 bit signed integer
+      :int32 => Type::INT32,
+      # 32 bit unsigned integer
+      :uint32 => Type::UINT32,
+
+      # 64 bit signed integer
+      :int64 => Type::INT64,
+      # 64 bit unsigned integer
+      :uint64 => Type::UINT64,
+
+      :buffer_in => Type::BUFFER_IN,
+      :buffer_out => Type::BUFFER_OUT,
+      :buffer_inout => Type::BUFFER_INOUT,
+
+      # Used in function prototypes to indicate the arguments are variadic
+      :varargs => Type::VARARGS,
+
+
+=end
+

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: asynchronous
 version: !ruby/object:Gem::Version
-  version: 1.0.4
+  version: 2.0.0
 platform: ruby
 authors:
 - Adam Luzsi
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-02-05 00:00:00.000000000 Z
-dependencies: []
+date: 2014-02-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: process_shared
+  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: ! 'DSL for for dead simple to use asynchronous patterns in both VM managed
   and OS managed way (Concurrency and Parallelism) '
 email:
@@ -20,26 +34,25 @@ extra_rdoc_files: []
 files:
 - Gemfile
 - Gemfile.lock
-- LICENSE
-- LICENSE.txt
 - README.md
 - Rakefile
 - VERSION
 - asynchronous.gemspec
+- dump/async.rb
 - examples/array_of_value_with_native_threads.rb
 - examples/async_patterns.rb
 - examples/no_zombie_test.rb
+- examples/shared_memory.rb
 - files.rb
-- lib/async.rb
 - lib/asynchronous.rb
 - lib/asynchronous/clean_class.rb
 - lib/asynchronous/concurrency.rb
 - lib/asynchronous/kernel.rb
 - lib/asynchronous/parallelism.rb
+- lib/asynchronous/shared_memory.rb
 - test/test.rb
 homepage: https://github.com/adamluzsi/asynchronous
-licenses:
-- MIT
+licenses: []
 metadata: {}
 post_install_message: 
 rdoc_options: []

data/LICENSE

@@ -1,20 +0,0 @@
-The MIT License (MIT)
-
-Copyright (c) 2014 Adam Luzsi
-
-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/LICENSE.txt

@@ -1,20 +0,0 @@
-Copyright (c) 2013 Adam Luzsi
-
-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.