eventbox 0.1.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06556e4ddd4d9ccd8cfede0c2163dd164165bdf6585d6a3352a1f44b7d17ff67
-  data.tar.gz: 6532937e73f20e42808a5516699781ed95284fc1cc52e0d160b443239e690fd6
+  metadata.gz: 2cded1e660a5b8321b82e80dfec3bb02f66186d5e9befa33a9083773e67708a4
+  data.tar.gz: a49d8755319a94fc72d67ffbbf8aee6c2f3da6c1c35f8530f0ea3e2bd4cfe003
 SHA512:
-  metadata.gz: 69dd49a9e166760c2cb7487ef5560ed92a59b68eaf4702dbf08dcab93751ae8bfc2f271f387eae0822b4798f60f8eff7cd644ecf63fd765bf10b42758c37e8ac
-  data.tar.gz: 66d26b6bf6dcac3954273b216261e576cbd62aec7b8c208eec55b84fd87fe3e1a1b452884cf8a97e2ef772c34020d48d0596ed1483e755a630aace852c7a20e1
+  metadata.gz: 1566416c8c226a188e21e5d79e6dcc8ca663854fc87062bc7a4600656bf35c75d81c46226b8ba165962f7730e34161c215cf15d3a1b5529ec74947d4a2b14831
+  data.tar.gz: 38f010998ef24d2b650264fcead255f905983948ecdbfd7c56afed59f1d36326ccc10015d6e6783fd8d54a757986be233fbe9fa31d25cd7795ed6a916e149bdc

data/.appveyor.yml

@@ -1,8 +1,10 @@
+image: Visual Studio 2019
+
 build: off
 
 init:
   - set PATH=C:/Ruby%ruby_version%/bin;%PATH%
-  - set RUBYOPT=--verbose -Eutf-8 --enable-frozen-string-literal
+  - set RUBYOPT=--verbose --enable-frozen-string-literal
 
 install:
   - ps: |
@@ -24,5 +26,5 @@ environment:
       RUBYDOWNLOAD: x64
     - ruby_version: "head"
       RUBYDOWNLOAD: x86
-    - ruby_version: "24-x64"
-    - ruby_version: "24"
+    - ruby_version: "30-x64"
+    - ruby_version: "30"

data/.travis.yml

@@ -3,14 +3,14 @@ sudo: false
 language: ruby
 cache: bundler
 matrix:
-  fast_finish: true
+  fast_finish: false
   include:
-    - rvm: 2.3.8
-    - rvm: 2.5.3
+    - rvm: 3.0.1
       env: RUBYOPT=--verbose --enable-frozen-string-literal
-    - rvm: jruby-9.2.4.1
     - rvm: ruby-head
       env: RUBYOPT=--verbose --enable-frozen-string-literal
 
+    # JRuby and Truffleruby don't support keyword argument semantics of ruby-3.0
+
 script:
   - bundle exec rake test TESTOPTS=-v

data/.yardopts

@@ -3,7 +3,7 @@
 --protected
 --private
 --no-private
---embed-mixin Eventbox::Boxable
+--asset docs/images:images
 lib/**/*.rb
 -
-docs/**/*.md
+docs/*.md

data/CHANGELOG.md

@@ -0,0 +1,19 @@
+1.0.0 / 2021-07-07
+-------------------
+
+Changed:
+* Requires ruby-3.0 or newer.
+* More readable #inspect output of several classes.
+
+Added:
+* Allow calls to external objects and procs/lambdas from the event scope.
+* Introduce Eventbox#call_context .
+* Correct and consistent handling of keyword arguments to method/prod calls.
+* Allow serialization by marshal_dump and marshal_load.
+* Improved documentation.
+
+
+0.1.0 / 2018-12-04
+-------------------
+
+* First release

data/README.md

@@ -5,21 +5,23 @@
 
 _Manage multithreading with the safety of event based programming_
 
+Eventbox is a model of concurrent computation that is used to build thread-safe objects with arbitrary interfaces.
+It is [kind of advancement](#comparison-threading-abstractions) of the well known [actor model](https://en.wikipedia.org/wiki/Actor_model) leveraging the possibilities of the ruby language.
+It is a small, consistent but powerful threading abstraction which **integrates well into existing environments**.
+
 {Eventbox} objects are event based and single threaded from the inside but thread-safe and blocking from the outside.
-Eventbox enforces a separation of code for event processing and code running blocking operations.
+Eventbox enforces a **separation of code for event processing** and code running blocking operations.
 Code inside an {Eventbox} object is executed non-concurrently and hence shouldn't do any blocking operations.
 This is similar to the typical JavaScript programming style.
 
-On the other hand all blocking operations can be executed in action threads spawned by the {Eventbox.action action} method type.
-Communication between actions and event processing is done through ordinary method or lambda calls.
+On the other hand all **blocking operations can be executed in action threads** spawned by the {Eventbox.action action} method type.
+Communication between actions, event processing and external environment is done through ordinary method and lambda calls.
+They arbitrate between blocking versus event based scheme and ensure thread-safety.
 
 An important task of Eventbox is to avoid race conditions through shared data.
-Such data races between event scope and external/action scope are avoided through {Eventbox::Sanitizer filters} applied to all inputs and outputs.
+Such data races between event scope and external/action scope are avoided through **{Eventbox::Sanitizer filters} applied to all inputs and outputs**.
 That way {Eventbox} guarantees stable states while event processing without a need for any locks.
 
-Eventbox is a model of concurrent computation that is used to build thread-safe objects with arbitrary interfaces.
-It is kind of [advancement](#comparison-threading-abstractions) of the well known [actor model](https://en.wikipedia.org/wiki/Actor_model) leveraging the possibilities of the ruby language.
-
 * [API documentation](https://www.rubydoc.info/github/larskanis/eventbox/master)
 
 
@@ -53,22 +55,23 @@ It can therefore be used to build well known multithread abstractions like a Que
 
 ```ruby
 require "eventbox"
-class Queue < Eventbox
-  # Called at Queue.new just like Object#initialize in ordinary ruby classes
+class MyQueue < Eventbox
+  # Called at MyQueue.new just like Object#initialize in ordinary ruby classes
   async_call def init
     @que = []       # List of values waiting for being fetched by deq
     @waiting = []   # List of blocking deq calls waiting for new values to be pushed by enq
   end
 
-  # Push a value to the queue and return the next value by the next waiting deq call
-  async_call def enq(€value)  # €-variables are passed through as reference
-    @que << €value            # Push a value to the queue
-    if w=@waiting.shift
-      w.yield @que.shift      # Let one waiting deq call return with the next value from the queue
+  # Push a value to the queue - async methods always return immediately
+  async_call def enq(€value)  # €-variables are passed through as reference instead of copies
+    @que << €value            # Push the value to the queue
+    if w=@waiting.shift       # Is there a thread already waiting for a value?
+      w.yield @que.shift      # Let the waiting `deq' call return the oldest value in the queue
     end
   end
 
   # Fetch a value from the queue or suspend the caller until a value has been enqueued
+  # yield methods are completely processed, but return not before a result has been yielded
   yield_call def deq(result)
     if @que.empty?
       @waiting << result      # Don't return a value now, but enqueue the request as waiting
@@ -78,13 +81,30 @@ class Queue < Eventbox
   end
 end
 ```
-It has semantics like ruby's builtin Queue implementation:
+
+<a name="my_queue_image"></a>
+A picture describes it best:
+
+[![MyQueue calls](https://raw.github.com/larskanis/eventbox/master/docs/images/my_queue_calls.svg?sanitize=true)](https://www.rubydoc.info/github/larskanis/eventbox/master/file/README.md#my_queue_image)
+{include:file:docs/my_queue_calls_github.md}
+
+Although there are no mutex or condition variables in use, the implementation is thread-safe.
+This is due to the wrapping that is activated by {Eventbox::Boxable.async_call async_call} and {Eventbox::Boxable.yield_call yield_call} prefixes.
+The {Eventbox::Boxable.yield_call yield_call} method definition divides the single external call into two internal events: The event of the start of call and the event of releasing the call with a return value.
+In contrast {Eventbox::Boxable.async_call async_call} defines a method which handles one event only - the start of the call: The external call completes immediately and always returns `self`.
+
+The branch in `Queue#deq` shows a typical decision taking in Eventbox:
+If the call can be processed immediately it yields the result, else wise the result is added to an internal list to be processes later.
+This list must be checked at each event which could signal the ability to complete the enqueued processing.
+This is done in `Queue#enq` in the above example.
+
+Our new queue class unsurprisingly has semantics like ruby's builtin Queue implementation:
 
 ```ruby
-q = Queue.new
+q = MyQueue.new
 Thread.new do
   5.times do |i|
-    q.enq i      # Enqueue integers 0 to 5
+    q.enq i      # Enqueue integers 0 to 4
   end
 end
 
@@ -100,22 +120,9 @@ end
 4
 ```
 
-Although there are no mutex or condition variables in use, the implementation is guaranteed to be thread-safe.
-The key feature is the {Eventbox.yield_call} method definition.
-It divides the single external call into two internal events: The event of the start of call and the event of releasing the call with a return value.
-In contrast {Eventbox.async_call} defines a method which handles one event only - the start of the call.
-The external call returns immediately, but can't return a value.
-
-Seeing curly braces instead of links? Switch to the [API documentation](https://www.rubydoc.info/github/larskanis/eventbox/master).
-
-The branch in `Queue#deq` shows a typical decision taking in Eventbox:
-If the call can be processed immediately it yields the result, else wise the result is added to a list to be processes later.
-It's important to check this list at each event which could signal the ability to complete the enqueued processing.
-This is done in `Queue#enq` in the above example.
-
 If you just need a queue it's better to stay at the Queue implementations of the standard library or [concurrent-ruby](https://github.com/ruby-concurrency/concurrent-ruby).
 However if you want to cancel items in the queue for example, you need more control about waiting items or waiting callers than common thread abstractions offer.
-The same if you want to query and visualize the internal state of processing - that means the pending items in the queue.
+The same if you want to query and visualize the internal state of processing (the pending items in the queue).
 
 
 ### Hands on
@@ -127,9 +134,12 @@ It is recommended to work them through, in order to fully understand how Eventbo
 * {file:docs/server.md TCP server} - Understand how to startup and shutdown blocking actions and to combine several Eventbox classes to handle parallel connections.
 * {file:docs/threadpool.md Thread-pool} - Understand how parallel external requests can be serialized and scheduled.
 
+Seeing curly braces instead of links? Switch to the [API documentation](https://www.rubydoc.info/github/larskanis/eventbox/master).
+
 
 ## Method types
 
+<a name="event-scope"></a>
 ### Event Scope
 
 Eventbox offers 3 different types of external callable methods:
@@ -148,11 +158,12 @@ There is no hard criteria for what is considered a blocking operation, but since
 If the processing time of an event scope method or block exceeds the limit of 0.5 seconds, a warning is print to `STDERR`.
 This limit can be changed by {Eventbox.with_options}.
 
-Arguments of async, sync and yield calls can be prefixed by a € sign.
+Arguments of async, sync and yield calls can be prefixed by a `€` sign.
 This marks them as to be passed through as reference, instead of being copied.
-A €-variable is wrapped and protected within the event scope, but unwrapped when passed to action or external scope.
+A `€`-variable is wrapped and protected within the event scope, but unwrapped when passed to action or external scope.
+It can be called within the event scope by {Eventbox::ExternalObject#send}.
 
-In additoin there are accessor methods usable as known from ordinary ruby objects: {Eventbox.attr_reader attr_reader},  {Eventbox.attr_writer attr_writer} and  {Eventbox.attr_accessor attr_accessor}.
+In addition there are accessor methods usable as known from ordinary ruby objects: {Eventbox.attr_reader attr_reader},  {Eventbox.attr_writer attr_writer} and  {Eventbox.attr_accessor attr_accessor}.
 They allow thread-safe access to instance variables.
 
 Beside {Eventbox.async_call async_call}, {Eventbox.sync_call sync_call} and {Eventbox.yield_call yield_call} methods it's possible to define plain `private` methods, since they are not accessible externally.
@@ -178,12 +189,21 @@ And all data generated by the action should be passed as arguments back to event
 Some data shall just be managed as reference in some scope without being accessed there.
 Or it is passed through a given scope only.
 In such cases it can be marked as {Eventbox#shared_object shared_object}.
-This wrapping is similar to € argument variables, however {Eventbox#shared_object shared_object} it more versatile.
+This wrapping is similar to `€` argument variables, however {Eventbox#shared_object shared_object} it more versatile.
 It marks objects permanently and wraps them even when they are stored inside of a copied object.
 
+<a name="external-scope"></a>
 ### External scope
 
 Code outside of the Eventbox class is referred to as "external scope".
+The external scope is recognized as one common space.
+
+External objects can be directly called from action scope, since they are unwrapped when passed from event to action scope.
+In this case the object to be called should be thread-safe.
+See also [What is safe and what isn't?](#eventbox-safety) below.
+
+External objects can also be called from event scope per {Eventbox::ExternalObject#send}, but with some restrictions.
+The same restrictions apply to external closures too, which are callable from event scope per {Eventbox::ExternalProc#call}.
 
 
 ## Block and Proc types
@@ -197,8 +217,8 @@ Similary to the 3 method calls above there are 3 types of proc objects which act
 
 These proc objects can be created within event scope, can be passed to external scope and called from there.
 
-Arguments of async, sync and yield procs can be prefixed by a € sign.
-In that case, they are passed as reference, equally to €-variables of {Eventbox.async_call async_call}, {Eventbox.sync_call sync_call} and {Eventbox.yield_call yield_call} methods.
+Arguments of async, sync and yield procs can be prefixed by a `€` sign.
+In that case, they are passed as reference, equally to `€`-variables of {Eventbox.async_call async_call}, {Eventbox.sync_call sync_call} and {Eventbox.yield_call yield_call} methods.
 
 The other way around - Proc objects or blocks which are defined in external or action scope - can be passed to event scope.
 Such a Proc object is wrapped as a {Eventbox::ExternalProc} object within the event scope.
@@ -207,6 +227,7 @@ Instead the event scope method is executed until its end, while the block is exe
 Optionally the block can be called with a completion block as the last argument, which is called with the result of the external proc when it has finished.
 
 
+<a name="exceptions"></a>
 ## Exceptions
 
 Eventbox makes use of exceptions in several ways.
@@ -236,10 +257,14 @@ async_call def conn_failed(error)
 end
 ```
 
+Alternatively closures can be passed to the action which are called in case of success or failure.
+See the {file:docs/downloads.md#exceptions-closure-style download example} for more description about this variation.
+
 Another use of exceptions is for sending signals to running actions.
 This is done by {Eventbox::Action#raise}.
 
 
+<a name="eventbox-safety"></a>
 ## What is safe and what isn't?
 
 At each transition of the scope all passing objects are sanitized by the {Eventbox::Sanitizer}.
@@ -247,7 +272,7 @@ It protects the event scope from data races and arbitrates between blocking and
 This is done by copying or wrapping the objects conveniently as described in the {Eventbox::Sanitizer}.
 That way event scope methods never get an inconsistent state regardless of the activities of external threads.
 
-Obviously it's not safe to do things like using `send` to call private methods from external, access instance variables per `instance_variable_set` or use global variables in a multithreading context.
+Obviously it's not safe to do things like using `send` to call private methods from external, access instance variables per `instance_variable_set` or use class or global variables in a multithreading context.
 Such rough ways of communication with an Eventbox object are surely neither recommended nor supported.
 Other than these the event scope of an Eventbox instance is pretty well protected against accident mistakes.
 
@@ -263,11 +288,20 @@ External libraries and objects must be thread-safe on its own if used from diffe
 Protecting them is beyond the scope of Eventbox.
 
 
+## Object distribution and persistence
+
+Eventbox objects can be serialized to be stored persistent or distributed across the network.
+This allows the utilization by job schedulers, messaging libraries and distributed object systems.
+However there are the following restrictions:
+
+1. Only objects without running actions can be serialized, since running code can not be serialized.
+2. Objects with a custom {Eventbox.with_options thread-pool} can be serialized only, when the thread-pool can be serialized.
+3. Objects with {Eventbox.with_options guard_time} set to a Proc object can not be serialized.
+
+
 ## Time based events
 
-It's possible to generate a timer event by stating an action with a `sleep` and subsequent call to an {Eventbox.async_call async_call} method.
-However that's not very convenient.
-Therefore Eventbox provides a dedicated {Eventbox::Timer timer module} for simple timer functions.
+Although timer events can be easily generated by an action with a `sleep` function, they are so common, that Eventbox bundles a dedicated {Eventbox::Timer timer module} for scheduling timer events.
 It can be included into Eventbox classes by:
 
 ```ruby
@@ -275,6 +309,7 @@ It can be included into Eventbox classes by:
 ```
 
 It offers {Eventbox::Timer#timer_after} and {Eventbox::Timer#timer_every} functions to schedule blocks to be called.
+See the {Eventbox::Timer} module for further description.
 
 
 ## Derived classes and mixins
@@ -313,13 +348,13 @@ This was the primary motivation to develop this library.
 Eventbox is kind of advancement of the well known [actor model](https://en.wikipedia.org/wiki/Actor_model) leveraging the possibilities of the ruby language.
 While the actor model uses explicit message passing, Eventbox relies on method calls, closure calls and exceptions, which makes it much more natural to use.
 Unlike an actor, Eventbox doesn't start a thread per object, but uses the thread of the caller to execute non-blocking code.
-This makes instantiation of Eventbox objects cheeper than Actor objects.
+This makes instantiation of Eventbox objects cheaper than Actor objects.
 Instead it can create and manage in-object private threads in form of {Eventbox.action actions} to be used for blocking operations.
 
 Many actor implementations manage an inheritance tree of actor objects.
 Parent actors are then notified about failures of child actors.
 In contrast Eventbox objects maintain a list of all running internal actions instead, but are completely independent from each other.
-Failures are handled object internal - see chapter "Exceptions" above.
+Failures are handled either object internal or by the caller - see chapter [Exceptions](#exceptions) above.
 
 ### Internal state
 
@@ -341,15 +376,23 @@ Beside this, Eventbox has an explicit specification where blocking and where non
 This ensures that events are processed in time regardless of the current state.
 Such a specification is not enforced by most other threading abstractions and can quickly lead to delayed reactions in particular situations.
 
+### No global states
+
+Eventbox doesn't manage or use any global states other than class definitions.
+Even {Eventbox.with_options configuration options} are handled on a class basis.
+This is why Eventbox can be combined with other threading abstractions and integrated in any applications without side effects.
+Vice versa Eventbox objects can easily replaced by other threading abstractions, if these fit better.
 
-## Comparison with other async libraries
+### Comparison with other async libraries
 
-Eventbox doesn't try to implement IO or other blocking operations on top of a global event loop.
+Eventbox doesn't implement any own IO or other kinds of blocking operations.
 Instead it encourages the use of blocking operations and threads for things which should run in parallel, while keeping the management code in safe internal methods written in an event based style.
-Because IO is done in action threads, the only type of events handled by the event scope are method calls received from actions or external calls.
-They are processed by a kind of event loop which runs one per Eventbox object.
+Because IO is done in action threads, the only type of events handled by the event scope are method or closure calls received from actions or external.
+They are processed by a kind of local event loop which runs one per Eventbox object.
 
 This is in contrast to libraries like [async](https://github.com/socketry/async), [EventMachine](https://github.com/eventmachine/eventmachine) or [Celluloid](https://github.com/celluloid/celluloid) which provide dozens of IO wrappers.
+Due to these differences the focus of Eventbox is on a consistent, solid and accurate core that developers can rely on.
+Intentionally there is no ecosystem around Eventbox.
 
 
 ## Eventbox performance
@@ -362,7 +405,7 @@ And it is written to act as a solid and consistent foundation for a wide range o
 So if your use case requires raw performance more than implementation safety, Eventbox is probably not the right tool.
 
 Still there is lots of room for performance improvements in Eventbox, like faster method invocations or copy-on-write objects.
-If there's a stronger interest in Eventbox performance, it's possible to source relevant parts out to a C extension.
+If there's a stronger interest in Eventbox performance, it's even possible to source relevant parts out to a C extension.
 The introduction of guilds in ruby will probably be helpful for Eventbox as well.
 
 

data/docs/downloads.md

@@ -1,8 +1,8 @@
-### Use Eventbox to download URLs concurrently
+## Use Eventbox to download URLs concurrently
 
 The following example illustrates how to use actions in order to download a list of URLs in parallel.
 
-At first the `init` method starts an action for each URL to be downloaded, initializes some variables and stores the `result` object for later use.
+At first the {Eventbox#init init} method starts an action for each URL to be downloaded, initializes some variables and stores the `result` object for later use.
 Since the `result` is not yielded in the method body, the external call to `ParallelDownloads.new` doesn't return to that point in time.
 Instead it's suspended until `result` is yielded later on, when all URLs have been retrieved.
 
@@ -53,14 +53,14 @@ class ParallelDownloads < Eventbox.with_options(threadpool: Eventbox::ThreadPool
   private action def start_download(url)
     data = OpenURI.open_uri(url)    # HTTP GET url
       .read(100).each_line.first    # Retrieve the first line but max 100 bytes
-  rescue SocketError => err         # Catch any network errors
+  rescue => err                     # Catch any network errors
     download_finished(url, err)     # and store it in the result hash
   else
     download_finished(url, data)    # ... or store the retrieved data when successful
   end
 
   # Called for each finished download
-  private sync_call def download_finished(url, res)
+  private async_call def download_finished(url, res)
     @downloads[url] = res             # Store the download result in the result hash
     @progress&.yield(@downloads.size) # Notify the caller about our progress
     if @downloads.size == @urls.size  # All downloads finished?
@@ -97,6 +97,7 @@ The order depends on the particular response time of the URL.
 Since Eventbox protects from data races, it's insignificant in which order events are emitted by an event scope method and whether objects are changed after being sent.
 It's therefore OK to set `@downloads` both before or after starting the action threads per `start_download` in `init`.
 
+<a name="exceptions-closure-style"></a>
 ### Change to closure style
 
 There is another alternative way to transmit the result of an action to the event scope.
@@ -113,7 +114,7 @@ class ParallelDownloads < Eventbox.with_options(threadpool: Eventbox::ThreadPool
   yield_call def init(urls, result, &progress)
     urls.each do |url|                   # Start a download thread for each URL
 
-      on_finished = sync_proc do |res|   # Create a closure object comparable to sync_call
+      on_finished = async_proc do |res|  # Create a closure object comparable to sync_call
         @downloads[url] = res            # Store the download result in the result hash
         progress&.yield(@downloads.size) # Notify the caller about our progress
         if @downloads.size == urls.size  # All downloads finished?

data/docs/images/my_queue_calls.svg

@@ -0,0 +1,761 @@
+<!--
+# @markup html
+-->
+
+<svg
+   xmlns:osb="http://www.openswatchbook.org/uri/2009/osb"
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="185mm"
+   height="142mm"
+   viewBox="0 0 129.5 99.400001"
+   version="1.1"
+   id="svg8"
+   inkscape:version="0.92.3 (2405546, 2018-03-11)"
+   sodipodi:docname="my_queue_calls.svg">
+  <defs
+     id="defs2">
+    <marker
+       inkscape:isstock="true"
+       style="overflow:visible;"
+       id="marker1378"
+       refX="0.0"
+       refY="0.0"
+       orient="auto"
+       inkscape:stockid="Arrow1Lend">
+      <path
+         transform="scale(0.8) rotate(180) translate(12.5,0)"
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1pt;stroke-opacity:1;fill:#000000;fill-opacity:1"
+         d="M 0.0,0.0 L 5.0,-5.0 L -12.5,0.0 L 5.0,5.0 L 0.0,0.0 z "
+         id="path1376" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow1Lend"
+       orient="auto"
+       refY="0.0"
+       refX="0.0"
+       id="marker1208"
+       style="overflow:visible;"
+       inkscape:isstock="true"
+       inkscape:collect="always">
+      <path
+         id="path948"
+         d="M 0.0,0.0 L 5.0,-5.0 L -12.5,0.0 L 5.0,5.0 L 0.0,0.0 z "
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1pt;stroke-opacity:1;fill:#000000;fill-opacity:1"
+         transform="scale(0.8) rotate(180) translate(12.5,0)" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow1Lend"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="marker1168"
+       style="overflow:visible"
+       inkscape:isstock="true">
+      <path
+         id="path908"
+         d="M 0,0 5,-5 -12.5,0 5,5 Z"
+         style="fill:#ffffeb;fill-opacity:1;fill-rule:evenodd;stroke:#ee0000;stroke-width:1.00000003pt;stroke-opacity:1"
+         transform="matrix(-0.8,0,0,-0.8,-10,0)"
+         inkscape:connector-curvature="0" />
+    </marker>
+    <marker
+       inkscape:isstock="true"
+       style="overflow:visible"
+       id="marker928"
+       refX="0"
+       refY="0"
+       orient="auto"
+       inkscape:stockid="Arrow1Lend">
+      <path
+         transform="matrix(-0.8,0,0,-0.8,-10,0)"
+         style="fill:#0000ff;fill-opacity:1;fill-rule:evenodd;stroke:#0000ff;stroke-width:1.00000003pt;stroke-opacity:1"
+         d="M 0,0 5,-5 -12.5,0 5,5 Z"
+         id="path926"
+         inkscape:connector-curvature="0" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow1Lend"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="marker10624"
+       style="overflow:visible"
+       inkscape:isstock="true"
+       inkscape:collect="always">
+      <path
+         id="path10622"
+         d="M 0,0 5,-5 -12.5,0 5,5 Z"
+         style="fill:#0000ff;fill-opacity:1;fill-rule:evenodd;stroke:#0000ff;stroke-width:1.00000003pt;stroke-opacity:1"
+         transform="matrix(-0.8,0,0,-0.8,-10,0)"
+         inkscape:connector-curvature="0" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow1Lend"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="marker10556"
+       style="overflow:visible"
+       inkscape:isstock="true">
+      <path
+         id="path10554"
+         d="M 0,0 5,-5 -12.5,0 5,5 Z"
+         style="fill:#ff0000;fill-opacity:1;fill-rule:evenodd;stroke:#ff0000;stroke-width:1.00000003pt;stroke-opacity:1"
+         transform="matrix(-0.8,0,0,-0.8,-10,0)"
+         inkscape:connector-curvature="0" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow1Lend"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="marker10502"
+       style="overflow:visible"
+       inkscape:isstock="true">
+      <path
+         id="path10500"
+         d="M 0,0 5,-5 -12.5,0 5,5 Z"
+         style="fill:#ff0000;fill-opacity:1;fill-rule:evenodd;stroke:#ff0000;stroke-width:1.00000003pt;stroke-opacity:1"
+         transform="matrix(-0.8,0,0,-0.8,-10,0)"
+         inkscape:connector-curvature="0" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow1Lend"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="marker9930"
+       style="overflow:visible"
+       inkscape:isstock="true">
+      <path
+         id="path9928"
+         d="M 0,0 5,-5 -12.5,0 5,5 Z"
+         style="fill:#f90000;fill-opacity:1;fill-rule:evenodd;stroke:#f90000;stroke-width:1.00000003pt;stroke-opacity:1"
+         transform="matrix(-0.8,0,0,-0.8,-10,0)"
+         inkscape:connector-curvature="0" />
+    </marker>
+    <marker
+       inkscape:isstock="true"
+       style="overflow:visible"
+       id="marker4910"
+       refX="0"
+       refY="0"
+       orient="auto"
+       inkscape:stockid="Arrow1Lend">
+      <path
+         transform="matrix(-0.8,0,0,-0.8,-10,0)"
+         style="fill:#f50000;fill-opacity:1;fill-rule:evenodd;stroke:#f50000;stroke-width:1.00000003pt;stroke-opacity:1"
+         d="M 0,0 5,-5 -12.5,0 5,5 Z"
+         id="path4908"
+         inkscape:connector-curvature="0" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow1Lend"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="Arrow1Lend"
+       style="overflow:visible"
+       inkscape:isstock="true"
+       inkscape:collect="always">
+      <path
+         id="path4537"
+         d="M 0,0 5,-5 -12.5,0 5,5 Z"
+         style="fill:#fa0000;fill-opacity:1;fill-rule:evenodd;stroke:#fa0000;stroke-width:1.00000003pt;stroke-opacity:1"
+         transform="matrix(-0.8,0,0,-0.8,-10,0)"
+         inkscape:connector-curvature="0" />
+    </marker>
+    <linearGradient
+       id="linearGradient4522"
+       osb:paint="solid">
+      <stop
+         style="stop-color:#000000;stop-opacity:1;"
+         offset="0"
+         id="stop4520" />
+    </linearGradient>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="1"
+     inkscape:cx="373.74533"
+     inkscape:cy="265.12062"
+     inkscape:document-units="mm"
+     inkscape:current-layer="layer1"
+     showgrid="false"
+     inkscape:snap-nodes="false"
+     inkscape:window-width="1252"
+     inkscape:window-height="720"
+     inkscape:window-x="28"
+     inkscape:window-y="0"
+     inkscape:window-maximized="1"
+     scale-x="0.7" />
+  <metadata
+     id="metadata5">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title />
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Ebene 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(0,-167.6)">
+    <rect
+       id="rect10"
+       width="91.673447"
+       height="86.87912"
+       x="19.489588"
+       y="179.25435"
+       rx="0"
+       ry="0"
+       style="fill:#ffff25;fill-opacity:1;stroke:#000000;stroke-width:0.26458332;stroke-opacity:1" />
+    <rect
+       y="186.75443"
+       x="42.474762"
+       height="78.274651"
+       width="42.228584"
+       id="rect4528"
+       style="fill:#ffcfff;fill-opacity:1;stroke:#000000;stroke-width:0.26458335;stroke-opacity:1" />
+    <path
+       style="fill:none;fill-opacity:1;stroke:#fa0000;stroke-width:0.26499999;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;marker-end:url(#Arrow1Lend)"
+       d="M 6.9279211,181.36207 51.561932,205.15991"
+       id="path4532"
+       inkscape:connector-curvature="0" />
+    <rect
+       style="fill:none;fill-opacity:1;stroke:#fa0000;stroke-width:0.26500002;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       id="rect4816"
+       width="12.828883"
+       height="12.562"
+       x="47.018349"
+       y="206.254" />
+    <path
+       style="fill:none;stroke:#f50000;stroke-width:0.26499999;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;marker-end:url(#marker4910)"
+       d="M 51.830151,219.0522 8.5333361,235.09765"
+       id="path4824"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="cc" />
+    <path
+       sodipodi:type="spiral"
+       style="fill:#ffffeb;fill-opacity:1;fill-rule:evenodd;stroke:#ee0000;stroke-width:0.42626965;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;marker-end:url(#marker1168);image-rendering:auto"
+       id="path4942"
+       sodipodi:cx="18.441597"
+       sodipodi:cy="66.346397"
+       sodipodi:expansion="1"
+       sodipodi:revolution="3.0059199"
+       sodipodi:radius="17.37999"
+       sodipodi:argument="-17.866762"
+       sodipodi:t0="0.6560148"
+       d="M 26.332514,74.57612 C 21.896357,79.574502 14.036872,79.637691 9.1685147,75.23772 3.6278489,70.230124 3.5838485,61.445599 8.5498677,56.029955 14.128266,49.946488 23.838892,49.921766 29.801399,55.454262 c 6.626649,6.14874 6.632031,16.786244 0.53274,23.295297 -0.842512,0.899114 -1.781959,1.706899 -2.796296,2.406374"
+       transform="matrix(0.62478665,0,0,0.61857331,84.213942,200.00264)" />
+    <path
+       style="fill:none;stroke:#f90000;stroke-width:0.26499999;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;marker-end:url(#marker9930)"
+       d="m 96.207354,249.79477 22.454726,16.57189"
+       id="path9918"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="cc" />
+    <rect
+       style="fill:none;fill-opacity:1;stroke:#ee0000;stroke-width:0.26499999;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       id="rect10496"
+       width="13.096148"
+       height="12.561667"
+       x="66.796196"
+       y="206.25435" />
+    <path
+       style="fill:none;stroke:#ff0000;stroke-width:0.26499999;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;marker-end:url(#marker10502)"
+       d="M 117.84573,185.10297 74.281541,204.8956"
+       id="path10498"
+       inkscape:connector-curvature="0" />
+    <path
+       style="fill:none;stroke:#ff0000;stroke-width:0.26499999;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;marker-end:url(#marker10556)"
+       d="m 76.158622,219.01967 18.712932,12.59301"
+       id="path10552"
+       inkscape:connector-curvature="0" />
+    <a
+       id="a1025"
+       target=""
+       transform="translate(-0.555625,-23.151042)"
+       xlink:href="https://www.rubydoc.info/github/larskanis/eventbox/master/Eventbox/Sanitizer">
+      <ellipse
+         onclick=""
+         transform="matrix(0.89625618,-0.44353677,0.47919017,0.8777111,0,0)"
+         cx="-17.232189"
+         cy="238.3199"
+         rx="5.3748827"
+         ry="10.333156"
+         id="path10612"
+         style="fill:#ffffff;fill-opacity:1;stroke:#007800;stroke-width:0.34833023;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+    </a>
+    <path
+       style="fill:none;stroke:#0000ff;stroke-width:0.26499999;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;marker-end:url(#marker10624)"
+       d="m 53.165548,215.24192 c 0,0 -9.262697,45.65359 32.874156,23.98422"
+       id="path10620"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="cc" />
+    <a
+       xlink:href="../Eventbox/Sanitizer"
+       transform="translate(0,6.2970833)"
+       id="a4631">
+      <path
+         onclick="https://www.rubydoc.info/github/larskanis/eventbox/master/Eventbox/Sanitizer"
+         sodipodi:open="true"
+         transform="matrix(0.92881568,0.37054207,-0.47054194,0.88237763,0,0)"
+         d="m 114.76537,172.63952 a 5.2028461,8.8422928 0 0 1 -3.99824,-10.43402 5.2028461,8.8422928 0 0 1 6.10517,-6.88361 5.2028461,8.8422928 0 0 1 4.10216,10.31685 5.2028461,8.8422928 0 0 1 -6.03535,7.05921"
+         sodipodi:end="1.7491596"
+         sodipodi:start="1.7832031"
+         sodipodi:ry="8.8422928"
+         sodipodi:rx="5.2028461"
+         sodipodi:cy="163.99594"
+         sodipodi:cx="115.8622"
+         sodipodi:type="arc"
+         id="path10686"
+         style="fill:#ffffff;fill-opacity:1;stroke:#007800;stroke-width:0.32815173;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+    </a>
+    <a
+       xlink:href="../Eventbox/Sanitizer"
+       transform="translate(0,6.2970833)"
+       id="a925"
+       target="">
+      <path
+         onclick="https://www.rubydoc.info/github/larskanis/eventbox/master/Eventbox/Sanitizer"
+         sodipodi:open="true"
+         transform="matrix(0.8488041,0.52870748,-0.64396364,0.7650561,0,0)"
+         d="m 247.74739,159.80509 a 4.7844305,9.6128368 0 0 1 -4.70978,9.68959 4.7844305,9.6128368 0 0 1 -4.85765,-9.39028 4.7844305,9.6128368 0 0 1 4.63728,-9.82976 4.7844305,9.6128368 0 0 1 4.92686,9.24357"
+         sodipodi:end="6.2452272"
+         sodipodi:start="6.2750789"
+         sodipodi:ry="9.6128368"
+         sodipodi:rx="4.7844305"
+         sodipodi:cy="159.88301"
+         sodipodi:cx="242.96312"
+         sodipodi:type="arc"
+         id="path10694"
+         style="fill:#ffffff;fill-opacity:1;stroke:#007800;stroke-width:0.32306719;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+    </a>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-weight:normal;font-size:2.96333332px;line-height:1.25;font-family:sans-serif;text-align:center;letter-spacing:0px;word-spacing:0px;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332;"
+       x="-152.70258"
+       y="122.78255"
+       id="text10838"
+       transform="rotate(-59.850075)"><tspan
+         sodipodi:role="line"
+         x="-152.70258"
+         y="122.78255"
+         style="font-size:2.96333332px;text-align:center;text-anchor:middle;stroke-width:0.26458332;"
+         id="tspan10848">sanitize</tspan><tspan
+         sodipodi:role="line"
+         x="-152.70258"
+         y="127.19227"
+         style="font-size:2.96333332px;text-align:center;text-anchor:middle;stroke-width:0.26458332;"
+         id="tspan10852">args</tspan></text>
+    <text
+       transform="rotate(59.31363)"
+       id="text10858"
+       y="13.567711"
+       x="216.40395"
+       style="font-style:normal;font-weight:normal;font-size:2.96333332px;line-height:1.25;font-family:sans-serif;text-align:center;letter-spacing:0px;word-spacing:0px;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332;"
+       xml:space="preserve"><tspan
+         id="tspan10854"
+         style="font-size:2.96333332px;text-align:center;text-anchor:middle;stroke-width:0.26458332;"
+         y="13.567711"
+         x="216.40395"
+         sodipodi:role="line">sanitize</tspan><tspan
+         id="tspan10856"
+         style="font-size:2.96333332px;text-align:center;text-anchor:middle;stroke-width:0.26458332;"
+         y="17.977434"
+         x="216.40395"
+         sodipodi:role="line">args</tspan></text>
+    <text
+       transform="rotate(-46.618563)"
+       id="text10881"
+       y="250.48445"
+       x="-115.84221"
+       style="font-style:normal;font-weight:normal;font-size:2.96333332px;line-height:1.25;font-family:sans-serif;text-align:center;letter-spacing:0px;word-spacing:0px;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332;"
+       xml:space="preserve"><tspan
+         style="font-size:2.96333332px;text-align:center;text-anchor:middle;stroke-width:0.26458332;"
+         y="250.48445"
+         x="-115.84221"
+         sodipodi:role="line"
+         id="tspan867">sanitize</tspan><tspan
+         style="font-size:2.96333332px;text-align:center;text-anchor:middle;stroke-width:0.26458332;"
+         y="254.89418"
+         x="-115.84221"
+         sodipodi:role="line"
+         id="tspan923">result</tspan></text>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-weight:normal;font-size:2.96333332px;line-height:1.25;font-family:sans-serif;text-align:center;letter-spacing:0px;word-spacing:0px;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332;"
+       x="96.894981"
+       y="237.41592"
+       id="text873"><tspan
+         sodipodi:role="line"
+         x="96.894981"
+         y="237.41592"
+         style="font-size:2.96333332px;text-align:center;text-anchor:middle;stroke-width:0.26458332;"
+         id="tspan903">wait for</tspan><tspan
+         sodipodi:role="line"
+         x="96.894981"
+         y="241.82565"
+         style="font-size:2.96333332px;text-align:center;text-anchor:middle;stroke-width:0.26458332;"
+         id="tspan884">result or</tspan><tspan
+         sodipodi:role="line"
+         x="96.894981"
+         y="246.23537"
+         style="font-size:2.96333332px;text-align:center;text-anchor:middle;stroke-width:0.26458332;"
+         id="tspan902">callback</tspan></text>
+    <path
+       inkscape:connector-curvature="0"
+       id="path924"
+       d="m 70.160202,215.24192 c 0,0 1.163455,23.98422 15.900542,23.98422"
+       style="fill:none;stroke:#0000ff;stroke-width:0.26499999;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;marker-end:url(#marker928)" />
+    <path
+       style="fill:#ffffff;fill-opacity:1;stroke:#007800;stroke-width:0.2027204;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       id="path877"
+       sodipodi:type="arc"
+       sodipodi:cx="-81.083595"
+       sodipodi:cy="244.79619"
+       sodipodi:rx="10.626561"
+       sodipodi:ry="4.9516382"
+       sodipodi:start="3.8273013"
+       sodipodi:end="3.8141906"
+       d="m -89.30824,241.6607 a 10.626561,4.9516382 0 0 1 14.926619,-0.70719 10.626561,4.9516382 0 0 1 1.566604,6.95297 10.626561,4.9516382 0 0 1 -14.91635,0.75278 10.626561,4.9516382 0 0 1 -1.664385,-6.94804"
+       transform="matrix(0.8900354,-0.45589142,0.59689097,0.80232236,0,0)"
+       sodipodi:open="true" />
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-weight:normal;font-size:2.96333332px;line-height:1.25;font-family:sans-serif;text-align:center;letter-spacing:0px;word-spacing:0px;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332;"
+       x="-40.597473"
+       y="240.45992"
+       id="text881"
+       transform="rotate(-27.245601)"><tspan
+         sodipodi:role="line"
+         x="-40.597473"
+         y="240.45992"
+         style="font-size:2.96333332px;text-align:center;text-anchor:middle;stroke-width:0.26458332;"
+         id="tspan899">if someth.</tspan><tspan
+         sodipodi:role="line"
+         x="-40.597473"
+         y="244.86964"
+         style="font-size:2.96333332px;text-align:center;text-anchor:middle;stroke-width:0.26458332;"
+         id="tspan911">in queue</tspan></text>
+    <path
+       transform="matrix(0.88469021,-0.46617941,0.63817391,0.76989224,0,0)"
+       d="m -100.19975,237.55663 a 11.223675,5.1413383 0 0 1 -11.16623,5.14127 11.223675,5.1413383 0 0 1 -11.28053,-5.08865 11.223675,5.1413383 0 0 1 11.05077,-5.19336 11.223675,5.1413383 0 0 1 11.39364,5.03549"
+       sodipodi:end="6.2627144"
+       sodipodi:start="0"
+       sodipodi:ry="5.1413383"
+       sodipodi:rx="11.223675"
+       sodipodi:cy="237.55663"
+       sodipodi:cx="-111.42342"
+       sodipodi:type="arc"
+       id="path885"
+       style="fill:#ffffff;fill-opacity:1;stroke:#007800;stroke-width:0.21229133;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       sodipodi:open="true" />
+    <text
+       transform="rotate(-22.489804)"
+       id="text891"
+       y="236.29482"
+       x="-40.395329"
+       style="font-style:normal;font-weight:normal;font-size:2.96333332px;line-height:1.25;font-family:sans-serif;text-align:center;letter-spacing:0px;word-spacing:0px;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332;"
+       xml:space="preserve"><tspan
+         style="font-size:2.96333332px;text-align:center;text-anchor:middle;stroke-width:0.26458332;"
+         y="236.29482"
+         x="-40.395329"
+         sodipodi:role="line"
+         id="tspan915">if a deq</tspan><tspan
+         style="font-size:2.96333332px;text-align:center;text-anchor:middle;stroke-width:0.26458332;"
+         y="240.70454"
+         x="-40.395329"
+         sodipodi:role="line"
+         id="tspan919">call waits</tspan></text>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-weight:normal;font-size:10.58333302px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
+       x="48.087425"
+       y="210.23882"
+       id="text909"><tspan
+         sodipodi:role="line"
+         id="tspan907"
+         x="48.087425"
+         y="219.60258"
+         style="stroke-width:0.26458332" /></text>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-weight:normal;font-size:4.58611107px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
+       x="48.354698"
+       y="211.57516"
+       id="text875"><tspan
+         sodipodi:role="line"
+         id="tspan873"
+         x="48.354698"
+         y="211.57516"
+         style="font-size:4.58611107px;stroke-width:0.26458332">enq</tspan></text>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-weight:normal;font-size:4.58611107px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
+       x="68.132637"
+       y="211.62103"
+       id="text879"><tspan
+         sodipodi:role="line"
+         id="tspan877"
+         x="68.132637"
+         y="211.62103"
+         style="font-size:4.58611107px;stroke-width:0.26458332">deq</tspan></text>
+    <a
+       xlink:href="../file/README.md#event-scope"
+       transform="translate(0,6.2970833)"
+       id="a4641">
+      <text
+         xml:space="preserve"
+         style="font-style:normal;font-weight:normal;font-size:3.52777767px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
+         x="53.247608"
+         y="184.36324"
+         id="text888"
+         onclick="../file/README.md#Event_Scope"><tspan
+           sodipodi:role="line"
+           id="tspan886"
+           x="53.247608"
+           y="184.36324"
+           style="font-size:3.52777767px;stroke-width:0.26458332">Event Scope</tspan></text>
+    </a>
+    <a
+       xlink:href="../Eventbox/Boxable#async_call-instance_method"
+       transform="translate(0,6.2970833)"
+       id="a4644">
+      <text
+         id="text892"
+         y="184.96559"
+         x="0.51345128"
+         style="font-style:normal;font-weight:normal;font-size:2.96333332px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332;"
+         xml:space="preserve"><tspan
+           id="tspan894"
+           style="font-size:2.96333332px;stroke-width:0.26458332;"
+           y="184.96559"
+           x="0.51345128"
+           sodipodi:role="line">external</tspan><tspan
+           id="tspan898"
+           style="font-size:2.96333332px;stroke-width:0.26458332;"
+           y="189.37532"
+           x="0.51345128"
+           sodipodi:role="line">call to</tspan><tspan
+           id="tspan905"
+           style="font-size:2.96333332px;stroke-width:0.26458332;"
+           y="193.78503"
+           x="0.51345128"
+           sodipodi:role="line">async</tspan><tspan
+           id="tspan909"
+           style="font-size:2.96333332px;stroke-width:0.26458332;"
+           y="198.19476"
+           x="0.51345128"
+           sodipodi:role="line">method</tspan></text>
+    </a>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.96333332px;line-height:1.25;font-family:sans-serif;-inkscape-font-specification:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332;"
+       x="0.71974826"
+       y="225.93076"
+       id="text902"
+       onclick="Eventbox/Boxable#yield_call-instance_method"><tspan
+         sodipodi:role="line"
+         x="0.71974826"
+         y="225.93076"
+         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.96333332px;font-family:sans-serif;-inkscape-font-specification:sans-serif;stroke-width:0.26458332;"
+         id="tspan904">... returns</tspan><tspan
+         sodipodi:role="line"
+         x="0.71974826"
+         y="230.34048"
+         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.96333332px;font-family:sans-serif;-inkscape-font-specification:sans-serif;stroke-width:0.26458332;"
+         id="tspan906">immediat.</tspan></text>
+    <a
+       xlink:href="../Eventbox/Boxable#yield_call-instance_method"
+       transform="translate(0,6.2970833)"
+       id="a4634">
+      <text
+         xml:space="preserve"
+         style="font-style:normal;font-weight:normal;font-size:2.96333332px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332;"
+         x="112.76665"
+         y="185.76741"
+         id="text912"><tspan
+           sodipodi:role="line"
+           x="112.76665"
+           y="185.76741"
+           style="font-size:2.96333332px;stroke-width:0.26458332;"
+           id="tspan908">external</tspan><tspan
+           sodipodi:role="line"
+           x="112.76665"
+           y="190.17714"
+           style="font-size:2.96333332px;stroke-width:0.26458332;"
+           id="tspan910">call to</tspan><tspan
+           id="tspan927"
+           sodipodi:role="line"
+           x="112.76665"
+           y="194.58685"
+           style="font-size:2.96333332px;stroke-width:0.26458332;">yield</tspan><tspan
+           id="tspan929"
+           sodipodi:role="line"
+           x="112.76665"
+           y="198.99658"
+           style="font-size:2.96333332px;stroke-width:0.26458332;">method</tspan></text>
+    </a>
+    <text
+       id="text920"
+       y="243.64752"
+       x="113.03392"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.96333332px;line-height:1.25;font-family:sans-serif;-inkscape-font-specification:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332;"
+       xml:space="preserve"
+       onclick=""><tspan
+         id="tspan916"
+         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.96333332px;font-family:sans-serif;-inkscape-font-specification:sans-serif;stroke-width:0.26458332;"
+         y="243.64752"
+         x="113.03392"
+         sodipodi:role="line">... returns</tspan><tspan
+         id="tspan918"
+         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.96333332px;font-family:sans-serif;-inkscape-font-specification:sans-serif;stroke-width:0.26458332;"
+         y="248.05725"
+         x="113.03392"
+         sodipodi:role="line">when</tspan><tspan
+         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.96333332px;font-family:sans-serif;-inkscape-font-specification:sans-serif;stroke-width:0.26458332;"
+         y="252.46696"
+         x="113.03392"
+         sodipodi:role="line"
+         id="tspan925">value</tspan><tspan
+         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.96333332px;font-family:sans-serif;-inkscape-font-specification:sans-serif;stroke-width:0.26458332;"
+         y="256.87668"
+         x="113.03392"
+         sodipodi:role="line"
+         id="tspan922">yielded</tspan></text>
+    <path
+       style="fill:#ffffff;fill-opacity:1;stroke:#007800;stroke-width:0.26499999;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       id="path936"
+       sodipodi:type="arc"
+       sodipodi:cx="202.16064"
+       sodipodi:cy="108.06693"
+       sodipodi:rx="9.7553377"
+       sodipodi:ry="5.6126599"
+       sodipodi:start="0"
+       sodipodi:end="6.2820258"
+       d="m 211.91598,108.06693 a 9.7553377,5.6126599 0 0 1 -9.75251,5.61266 9.7553377,5.6126599 0 0 1 -9.75816,-5.6094 9.7553377,5.6126599 0 0 1 9.74685,-5.61592 9.7553377,5.6126599 0 0 1 9.76382,5.60615"
+       transform="rotate(54.360684)"
+       sodipodi:open="true" />
+    <a
+       xlink:href="../file/README.md#external-scope"
+       transform="translate(-17.78)"
+       id="a4651">
+      <text
+         onclick="window.location.href='../file/README.md#External_Scope'"
+         id="text903"
+         y="170.53304"
+         x="51.607788"
+         style="font-style:normal;font-weight:normal;font-size:3.52777767px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
+         xml:space="preserve"><tspan
+           style="font-size:3.52777767px;stroke-width:0.26458332"
+           y="170.53304"
+           x="51.607788"
+           id="tspan901"
+           sodipodi:role="line">External Scope (outside of the class)</tspan></text>
+    </a>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-weight:normal;font-size:2.96333332px;line-height:1.25;font-family:sans-serif;text-align:center;letter-spacing:0px;word-spacing:0px;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332;"
+       x="202.64171"
+       y="107.0413"
+       id="text932"
+       transform="rotate(54.360684)"><tspan
+         sodipodi:role="line"
+         id="tspan930"
+         x="202.64171"
+         y="107.0413"
+         style="font-size:2.96333332px;text-align:center;text-anchor:middle;stroke-width:0.26458332;">return</tspan><tspan
+         sodipodi:role="line"
+         x="202.64171"
+         y="111.45102"
+         style="font-size:2.96333332px;text-align:center;text-anchor:middle;stroke-width:0.26458332;"
+         id="tspan934">self</tspan></text>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-weight:normal;font-size:3.52636671px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.18520834"
+       x="23.706667"
+       y="182.73022"
+       id="text933"><tspan
+         sodipodi:role="line"
+         id="tspan931"
+         x="23.706667"
+         y="182.73022"
+         style="font-size:3.52636671px;stroke-width:0.18520834">Wrapping Layer around methods and closures</tspan></text>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-weight:normal;font-size:2.96333332px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.18520834;"
+       x="56.858959"
+       y="196.80605"
+       id="text937"><tspan
+         sodipodi:role="line"
+         id="tspan935"
+         x="56.858959"
+         y="196.80605"
+         style="font-size:2.96333332px;stroke-width:0.18520834;">@que</tspan><tspan
+         sodipodi:role="line"
+         x="56.858959"
+         y="200.81889"
+         style="font-size:2.96333332px;stroke-width:0.18520834;"
+         id="tspan939">@waiting</tspan></text>
+    <path
+       style="fill:#000000;fill-opacity:1;stroke:#000000;stroke-width:0.1855;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;marker-end:url(#marker1378)"
+       d="m 55.377291,207.35367 3.889375,-5.74554"
+       id="path941"
+       inkscape:connector-curvature="0" />
+    <path
+       style="fill:#000000;fill-opacity:1;stroke:#000000;stroke-width:0.1855;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;marker-end:url(#marker1208)"
+       d="m 69.638332,207.36291 -2.2225,-5.92666"
+       id="path943"
+       inkscape:connector-curvature="0" />
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-weight:normal;font-size:2.96333332px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.18520834;"
+       x="43.709164"
+       y="255.8875"
+       id="text919"><tspan
+         sodipodi:role="line"
+         id="tspan917"
+         x="43.709164"
+         y="255.8875"
+         style="font-size:2.96333332px;stroke-width:0.18520834;">* non-blocking area</tspan><tspan
+         sodipodi:role="line"
+         x="43.709164"
+         y="259.90033"
+         style="font-size:2.96333332px;stroke-width:0.18520834;"
+         id="tspan921">* synchronized</tspan><tspan
+         sodipodi:role="line"
+         x="43.709164"
+         y="263.91318"
+         style="font-size:2.96333332px;stroke-width:0.18520834;"
+         id="tspan4773">* event driven</tspan></text>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-weight:normal;font-size:2.96333332px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.18520834;"
+       x="34.263542"
+       y="175.32187"
+       id="text1060"><tspan
+         sodipodi:role="line"
+         x="34.263542"
+         y="175.32187"
+         style="font-size:2.96333332px;stroke-width:0.18520834;"
+         id="tspan4765">* blocking, thread-safe area</tspan></text>
+  </g>
+</svg>