polyphony 0.40 → 0.43.2

data/test/test_trace.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative 'helper'
+require 'polyphony/adapters/trace'
 
 class TraceTest < MiniTest::Test
   def test_tracing_disabled
@@ -11,13 +12,13 @@ class TraceTest < MiniTest::Test
     assert_equal 0, records.size
   ensure
     t&.disable
-    Gyro.trace(nil)
+    Polyphony.trace(nil)
   end
 
   def test_tracing_enabled
     records = []
     t = Polyphony::Trace.new(:fiber_all) { |r| records << r if r[:event] =~ /^fiber_/ }
-    Gyro.trace(true)
+    Polyphony.trace(true)
     t.enable
     snooze
     t.disable
@@ -28,14 +29,14 @@ class TraceTest < MiniTest::Test
     assert_equal [Fiber.current], records.map { |r| r[:fiber] }.uniq
   ensure
     t&.disable
-    Gyro.trace(nil)
+    Polyphony.trace(nil)
   end
 
   def test_2_fiber_trace
     records = []
     t = Polyphony::Trace.new(:fiber_all) { |r| records << r if r[:event] =~ /^fiber_/ }
     t.enable
-    Gyro.trace(true)
+    Polyphony.trace(true)
 
     f = spin { sleep 0 }
     suspend
@@ -61,6 +62,6 @@ class TraceTest < MiniTest::Test
     ], events
   ensure
     t&.disable
-    Gyro.trace(nil)
+    Polyphony.trace(nil)
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: polyphony
 version: !ruby/object:Gem::Version
-  version: '0.40'
+  version: 0.43.2
 platform: ruby
 authors:
 - Sharon Rosner
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-05-04 00:00:00.000000000 Z
+date: 2020-07-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -86,14 +86,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.80.0
+        version: 0.85.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.80.0
+        version: 0.85.1
 - !ruby/object:Gem::Dependency
   name: pg
   requirement: !ruby/object:Gem::Requirement
@@ -212,19 +212,19 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.7
+        version: 0.3.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.7
+        version: 0.3.0
 description: 
 email: ciconia@gmail.com
 executables: []
 extensions:
-- ext/gyro/extconf.rb
+- ext/polyphony/extconf.rb
 extra_rdoc_files:
 - README.md
 files:
@@ -242,19 +242,14 @@ files:
 - TODO.md
 - bin/polyphony-debug
 - docs/_config.yml
-- docs/_includes/nav.html
-- docs/_includes/prevnext.html
-- docs/_layouts/default.html
 - docs/_sass/custom/custom.scss
 - docs/_sass/overrides.scss
-- docs/api-reference.md
+- docs/_user-guide/all-about-timers.md
+- docs/_user-guide/index.md
+- docs/_user-guide/web-server.md
 - docs/api-reference/exception.md
 - docs/api-reference/fiber.md
-- docs/api-reference/gyro-async.md
-- docs/api-reference/gyro-child.md
-- docs/api-reference/gyro-queue.md
-- docs/api-reference/gyro-timer.md
-- docs/api-reference/gyro.md
+- docs/api-reference/index.md
 - docs/api-reference/io.md
 - docs/api-reference/object.md
 - docs/api-reference/polyphony-baseexception.md
@@ -272,23 +267,24 @@ files:
 - docs/assets/img/echo-fibers.svg
 - docs/assets/img/sleeping-fiber.svg
 - docs/faq.md
-- docs/getting-started.md
+- docs/favicon.ico
+- docs/getting-started/index.md
 - docs/getting-started/installing.md
+- docs/getting-started/overview.md
 - docs/getting-started/tutorial.md
 - docs/index.md
-- docs/main-concepts.md
 - docs/main-concepts/concurrency.md
 - docs/main-concepts/design-principles.md
 - docs/main-concepts/exception-handling.md
 - docs/main-concepts/extending.md
 - docs/main-concepts/fiber-scheduling.md
-- docs/user-guide.md
-- docs/user-guide/all-about-timers.md
-- docs/user-guide/web-server.md
+- docs/main-concepts/index.md
+- docs/polyphony-logo.png
 - examples/adapters/pg_client.rb
 - examples/adapters/pg_notify.rb
 - examples/adapters/pg_pool.rb
 - examples/adapters/pg_transaction.rb
+- examples/adapters/redis_blpop.rb
 - examples/adapters/redis_channels.rb
 - examples/adapters/redis_client.rb
 - examples/adapters/redis_pubsub.rb
@@ -296,7 +292,8 @@ files:
 - examples/core/01-spinning-up-fibers.rb
 - examples/core/02-awaiting-fibers.rb
 - examples/core/03-interrupting.rb
-- examples/core/forever_sleep.rb
+- examples/core/04-handling-signals.rb
+- examples/core/xx-agent.rb
 - examples/core/xx-at_exit.rb
 - examples/core/xx-caller.rb
 - examples/core/xx-channels.rb
@@ -359,27 +356,14 @@ files:
 - examples/performance/snooze_raw.rb
 - examples/performance/thread-vs-fiber/polyphony_mt_server.rb
 - examples/performance/thread-vs-fiber/polyphony_server.rb
+- examples/performance/thread-vs-fiber/polyphony_server_read_loop.rb
 - examples/performance/thread-vs-fiber/threaded_server.rb
 - examples/performance/thread-vs-fiber/xx-httparty_multi.rb
 - examples/performance/thread-vs-fiber/xx-httparty_threaded.rb
 - examples/performance/thread_pool_perf.rb
-- ext/gyro/async.c
-- ext/gyro/child.c
-- ext/gyro/extconf.rb
-- ext/gyro/fiber.c
-- ext/gyro/gyro.c
-- ext/gyro/gyro.h
-- ext/gyro/gyro_ext.c
-- ext/gyro/io.c
-- ext/gyro/libev.c
-- ext/gyro/libev.h
-- ext/gyro/queue.c
-- ext/gyro/selector.c
-- ext/gyro/signal.c
-- ext/gyro/socket.c
-- ext/gyro/thread.c
-- ext/gyro/timer.c
-- ext/gyro/tracing.c
+- examples/performance/xx-array.rb
+- examples/performance/xx-fiber-switch.rb
+- examples/performance/xx-snooze.rb
 - ext/libev/Changes
 - ext/libev/LICENSE
 - ext/libev/README
@@ -396,6 +380,17 @@ files:
 - ext/libev/ev_win32.c
 - ext/libev/ev_wrap.h
 - ext/libev/test_libev_win32.c
+- ext/polyphony/extconf.rb
+- ext/polyphony/fiber.c
+- ext/polyphony/libev.c
+- ext/polyphony/libev.h
+- ext/polyphony/libev_agent.c
+- ext/polyphony/libev_queue.c
+- ext/polyphony/polyphony.c
+- ext/polyphony/polyphony.h
+- ext/polyphony/polyphony_ext.c
+- ext/polyphony/thread.c
+- ext/polyphony/tracing.c
 - lib/polyphony.rb
 - lib/polyphony/adapters/fs.rb
 - lib/polyphony/adapters/irb.rb
@@ -410,6 +405,7 @@ files:
 - lib/polyphony/core/sync.rb
 - lib/polyphony/core/thread_pool.rb
 - lib/polyphony/core/throttler.rb
+- lib/polyphony/event.rb
 - lib/polyphony/extensions/core.rb
 - lib/polyphony/extensions/fiber.rb
 - lib/polyphony/extensions/io.rb
@@ -424,20 +420,22 @@ files:
 - test/helper.rb
 - test/run.rb
 - test/stress.rb
-- test/test_async.rb
+- test/test_agent.rb
+- test/test_event.rb
 - test/test_ext.rb
 - test/test_fiber.rb
 - test/test_global_api.rb
 - test/test_io.rb
 - test/test_kernel.rb
 - test/test_process_supervision.rb
+- test/test_queue.rb
 - test/test_resource_pool.rb
 - test/test_signal.rb
+- test/test_socket.rb
 - test/test_supervise.rb
 - test/test_thread.rb
 - test/test_thread_pool.rb
 - test/test_throttler.rb
-- test/test_timer.rb
 - test/test_trace.rb
 homepage: https://digital-fabric.github.io/polyphony
 licenses:

data/docs/_includes/nav.html

@@ -1,51 +0,0 @@
-<nav role="navigation" aria-label="Main navigation">
-  <ul class="navigation-list">
-    {%- assign pages_list = site.html_pages | sort:"nav_order" -%}
-    {%- for node in pages_list -%}
-      {%- unless node.nav_exclude -%}
-        {%- if node.parent == nil -%}
-          <li class="navigation-list-item
-                     {% if page.url == node.url %} active{% endif %}
-                     {% if node.section %}section-title{% endif %}
-                    ">
-            {%- if page.parent == node.title or page.grand_parent == node.title -%}
-              {%- assign first_level_url = node.section_link | node.url | absolute_url -%}
-            {%- endif -%}
-            {%- if node.section -%}
-              <span class="section-title">{{ node.title }}</span>
-            {%- else -%}
-              <a href="{{ node.url | absolute_url }}" class="navigation-list-link{% if page.url == node.url %} active{% endif %}">{{ node.title }}</a>
-            {%- endif -%}
-            {%- if node.has_children -%}
-              {%- if node.alphabetical_order -%}
-                {%- assign children_list = site.html_pages | where: "parent", node.title | sort:"title" -%}
-              {%- else -%}
-                {%- assign children_list = site.html_pages | where: "parent", node.title | sort:"nav_order" -%}
-              {%- endif -%}
-              <ul class="navigation-list-child-list ">
-                {%- for child in children_list -%}
-                  <li class="navigation-list-item {% if page.url == child.url or page.parent == child.title %} active{% endif %}">
-                    {%- if page.url == child.url or page.parent == child.title -%}
-                      {%- assign second_level_url = child.url | absolute_url -%}
-                    {%- endif -%}
-                    <a href="{{ child.url | absolute_url }}" class="navigation-list-link{% if page.url == child.url %} active{% endif %}">{{ child.title }}</a>
-                    {%- if child.has_children -%}
-                        {%- assign grand_children_list = site.html_pages | where: "parent", child.title | sort:"nav_order" -%}
-                        <ul class="navigation-list-child-list">
-                        {%- for grand_child in grand_children_list -%}
-                          <li class="navigation-list-item {% if page.url == grand_child.url %} active{% endif %}">
-                            <a href="{{ grand_child.url | absolute_url }}" class="navigation-list-link{% if page.url == grand_child.url %} active{% endif %}">{{ grand_child.title }}</a>
-                          </li>
-                        {%- endfor -%}
-                      </ul>
-                    {%- endif -%}
-                  </li>
-                {%- endfor -%}
-              </ul>
-            {%- endif -%}
-          </li>
-        {%- endif -%}
-      {%- endunless -%}
-    {%- endfor -%}
-  </ul>
-</nav>

data/docs/_includes/prevnext.html

@@ -1,17 +0,0 @@
-{%- for node in site.html_pages -%}
-  {%- if page.prev_title == node.title -%}
-    {%- assign prev_url = node.url -%}
-  {%- endif -%}
-  {%- if page.next_title == node.title -%}
-    {%- assign next_url = node.url -%}
-  {%- endif -%}
-{%- endfor -%}
-<div id="prevnext">
-  {%- if prev_url -%}
-    <span class="prev"><a href="{{prev_url | relative_url}}">☜ {{page.prev_title}}</a></span>
-  {%- endif -%}
-  {%- if next_url -%}
-    <span class="next"><a href="{{next_url | relative_url}}">{{page.next_title}} ☞</a></span>
-  {%- endif -%}
-  <span class="clear">&nbsp;</span>
-</div>

data/docs/_layouts/default.html

@@ -1,106 +0,0 @@
----
-layout: table_wrappers
----
-
-<!DOCTYPE html>
-
-<html lang="{{ site.lang | default: "en-US" }}">
-{% include head.html %}
-<body>
-  <svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
-    <symbol id="link" viewBox="0 0 16 16">
-      <title>Link</title>
-      <path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path>
-    </symbol>
-  </svg>
-
-  <div class="page-wrap">
-    <div class="side-bar">
-      <div class="site-header">
-        <a href="{{ site.url }}{{ site.baseurl }}" class="site-title lh-tight">{% include title.html %}</a>
-        <button class="menu-button fs-3 js-main-nav-trigger" data-text-toggle="Hide" type="button">Menu</button>
-      </div>
-
-      <div class="navigation main-nav js-main-nav">
-        {% include nav.html %}
-      </div>
-      <footer class="site-footer">
-        <p class="text-small text-grey-dk-000 mb-4">This site uses <a href="https://github.com/pmarsceill/just-the-docs">Just the Docs</a>, a documentation theme for Jekyll.</p>
-      </footer>
-    </div>
-    <div class="main-content-wrap js-main-content" tabindex="0">
-      <div class="main-content">
-        <div class="page-header js-page-header">
-          {% if site.search_enabled != false %}
-          <div class="search">
-            <div class="search-input-wrap">
-              <input type="text" class="js-search-input search-input" tabindex="0" placeholder="Search {{ site.title }}" aria-label="Search {{ site.title }}" autocomplete="off">
-              <svg width="14" height="14" viewBox="0 0 28 28" xmlns="http://www.w3.org/2000/svg" class="search-icon"><title>Search</title><g fill-rule="nonzero"><path d="M17.332 20.735c-5.537 0-10-4.6-10-10.247 0-5.646 4.463-10.247 10-10.247 5.536 0 10 4.601 10 10.247s-4.464 10.247-10 10.247zm0-4c3.3 0 6-2.783 6-6.247 0-3.463-2.7-6.247-6-6.247s-6 2.784-6 6.247c0 3.464 2.7 6.247 6 6.247z"/><path d="M11.672 13.791L.192 25.271 3.02 28.1 14.5 16.62z"/></g></svg>
-            </div>
-            <div class="js-search-results search-results-wrap"></div>
-          </div>
-          {% endif %}
-          {% if site.aux_links != nil %}
-            <ul class="list-style-none text-small aux-nav">
-              {% for link in site.aux_links %}
-                <li class="d-inline-block my-0{% unless forloop.last %} mr-2{% endunless %}"><a href="{{ link.last }}">{{ link.first }}</a></li>
-              {% endfor %}
-            </ul>
-          {% endif %}
-        </div>
-        <div class="page">
-          {% unless page.url == "/" %}
-            {% if page.parent %}
-              <nav class="breadcrumb-nav">
-                <ol class="breadcrumb-nav-list">
-                  {% if page.grand_parent %}
-                    <li class="breadcrumb-nav-list-item"><a href="{{ first_level_url }}">{{ page.grand_parent }}</a></li>
-                    <li class="breadcrumb-nav-list-item"><a href="{{ second_level_url }}">{{ page.parent }}</a></li>
-                  {% else %}
-                    <li class="breadcrumb-nav-list-item"><a href="{{ first_level_url }}">{{ page.parent }}</a></li>
-                  {% endif %}
-                  <li class="breadcrumb-nav-list-item"><span>{{ page.title }}</span></li>
-                </ol>
-              </nav>
-            {% endif %}
-          {% endunless %}
-          <div id="main-content" class="page-content" role="main">
-            {% if site.heading_anchors != false %}
-              {% include vendor/anchor_headings.html html=content beforeHeading="true" anchorBody="<svg viewBox=\"0 0 16 16\" aria-hidden=\"true\"><use xlink:href=\"#link\"></use></svg>" anchorClass="anchor-heading" %}
-            {% else %}
-              {{ content }}
-            {% endif %}
-
-            {% if page.prev_title or page.next_title %}
-              {% include prevnext.html %}
-            {% endif %}
-
-          {% if page.has_children == true and page.has_toc != false %}
-            <hr>
-            <h2 class="text-delta">Table of contents</h2>
-            {% assign children_list = site.pages | sort:"nav_order" %}
-            <ul>
-              {% for child in children_list %}
-                {% if child.parent == page.title and child.title != page.title %}
-                <li>
-                  <a href="{{ child.url | absolute_url }}">{{ child.title }}</a>{% if child.summary %} - {{ child.summary }}{% endif %}
-                </li>
-                {% endif %}
-              {% endfor %}
-            </ul>
-          {% endif %}
-
-          {% if site.footer_content != nil %}
-            <hr>
-            <footer role="contentinfo">
-              <p class="text-small text-grey-dk-000 mb-0">{{ site.footer_content }}</p>
-            </footer>
-          {% endif %}
-
-        </div>
-      </div>
-    </div>
-  </div>
-
-</body>
-</html>

data/docs/api-reference.md

@@ -1,11 +0,0 @@
----
-layout: page
-title: API Reference
-description: Lorem ipsum
-has_children: true
-alphabetical_order: true
-section: true
-has_toc: false
-nav_order: 5
-section_link: /api-reference/exception
----

data/docs/api-reference/gyro-async.md

@@ -1,57 +0,0 @@
----
-layout: page
-title: Gyro::Async
-parent: API Reference
-permalink: /api-reference/gyro-async/
----
-# Gyro::Async
-
-`Gyro::Async` encapsulates a libev [async
-watcher](http://pod.tst.eu/http://cvs.schmorp.de/libev/ev.pod#code_ev_async_code_how_to_wake_up_an),
-allowing thread-safe synchronisation and signalling. `Gyro::Async` watchers are
-used both directly and indirectly in Polyphony to implement
-[queues](../gyro-queue/), await fibers and threads, and auxiliary features such
-as [thread pools](../polyphony-threadpool/).
-
-A `Gyro::Async` watcher instance is shared across two or more fibers (across one
-or more threads), where one fiber waits to be signalled by calling
-`Gyro::Async#await`, and one or more other fibers do the signalling by calling
-`Gyro::Async#signal`:
-
-```ruby
-async = Gyro::Async.new
-spin do
-  sleep 1
-  async.signal
-end
-
-async.await
-```
-
-The signalling of async watchers is compressed, which means that multiple
-invocations of `Gyro::Async#signal` before the event loop can continue will
-result the watcher being signalled just a single time.
-
-In addition to signalling, the async watcher can also be used to transfer an
-arbitrary value to the awaitng fiber. See `#signal` for an example.
-
-## Instance methods
-
-### #await → object
-
-Blocks the current thread until the watcher is signalled.
-
-### #initialize
-
-Initializes the watcher instance.
-
-### #signal(value = nil) → async
-
-Signals the watcher, causing the fiber awaiting the watcher to become runnable
-and be eventually resumed with the given value.
-
-```ruby
-async = Gyro::Async.new
-spin { async.signal('foo') }
-async.await #=> 'foo'
-```