polyphony 0.27 → 0.28

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f3c496d74c1fb5545a3111d9a116c55268cde00298feaea546dab8ba199fb359
-  data.tar.gz: 57810b0cac851c5364ed831549a5d06beef73b13f9f6615d2d9ee0558397ccfd
+  metadata.gz: 96b63d0e57950ea2983cfadab521cceaba97180fce4269575715a856d1beebdd
+  data.tar.gz: 42580ebe9a11620cc546474837983ae959aa239fba3a0c926eb62a40d9b66773
 SHA512:
-  metadata.gz: b0df4d81349f7226544a158e4f46b2e24f71db9496c5ccee0911634f848d0bdaaebc7ac9ae231e8a29892858212f6782a4f4d8a639121249b13cf4793c133482
-  data.tar.gz: 9ac4943327e356c2bf8f6a5a72d75787d1e71983c2aec6784eb6daa242bee3f79c49c379e716b2fb8fc235bf48fc7d2a50825f24a541c129dab12d0b34b1da9b
+  metadata.gz: b4f4f02373ff3f9f1780a90b5df09bdd8efc95dbe28bed7787915a474961fe1f687baeb6cf46431eda65a6719c9e98a46b44807d71496723d84fbe7b0841a582
+  data.tar.gz: 1582cdfa47593230dc64f1676a514cea09e36db37048e138f41f75a626a91acac0e6dd34d6962597b4016a57afb125a9913c1111474f3470543e75f1b4915b88

data/.gitignore

@@ -52,4 +52,7 @@ build-iPhoneSimulator/
 test.rb
 .vscode
 
-lib/gyro_ext.bundle
+lib/gyro_ext.bundle
+
+_site
+.sass-cache

data/CHANGELOG.md

@@ -1,3 +1,16 @@
+0.28 2020-01-27
+---------------
+
+* Accept block in Supervisor#initialize
+* Refactor `ThreadPool`
+* Implement fiber switch events for `TracePoint`
+* Add optional tag parameter to #spin
+* Correctly increment ref count for indefinite sleep
+* Add `irb` adapter
+* Add support for listen/notify to postgres adapter
+* Use `:waiting`, `:runnable`, `:running`, `:dead` for fiber states
+* Move docs to https://digital-fabric.github.io/polyphony/
+
 0.27 2020-01-19
 ---------------
 

data/Gemfile

@@ -1,3 +1,14 @@
 source 'https://rubygems.org'
 
-gemspec
+gemspec
+
+# gem "jekyll", "~> 3.8.6"
+# gem "jekyll-remote-theme"
+# gem "jekyll-seo-tag"
+# gem "just-the-docs"
+
+# # gem "github-pages", group: :jekyll_plugins
+
+# group :jekyll_plugins do
+#   gem "jekyll-feed", "~> 0.6"
+# end

data/Gemfile.lock

@@ -1,26 +1,73 @@
 PATH
   remote: .
   specs:
-    polyphony (0.27)
+    polyphony (0.28)
       modulation (~> 1.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
+    addressable (2.7.0)
+      public_suffix (>= 2.0.2, < 5.0)
     ansi (1.5.0)
+    ast (2.4.0)
     builder (3.2.4)
+    colorator (1.1.0)
+    concurrent-ruby (1.1.5)
     docile (1.3.2)
+    em-websocket (0.5.1)
+      eventmachine (>= 0.12.9)
+      http_parser.rb (~> 0.6.0)
+    eventmachine (1.2.7)
+    ffi (1.12.1)
+    forwardable-extended (2.6.0)
     hiredis (0.6.3)
     http_parser.rb (0.6.0)
     httparty (0.17.0)
       mime-types (~> 3.0)
       multi_xml (>= 0.5.2)
-    json (2.1.0)
+    i18n (0.9.5)
+      concurrent-ruby (~> 1.0)
+    jaro_winkler (1.5.4)
+    jekyll (3.8.6)
+      addressable (~> 2.4)
+      colorator (~> 1.0)
+      em-websocket (~> 0.5)
+      i18n (~> 0.7)
+      jekyll-sass-converter (~> 1.0)
+      jekyll-watch (~> 2.0)
+      kramdown (~> 1.14)
+      liquid (~> 4.0)
+      mercenary (~> 0.3.3)
+      pathutil (~> 0.9)
+      rouge (>= 1.7, < 4)
+      safe_yaml (~> 1.0)
+    jekyll-remote-theme (0.4.1)
+      addressable (~> 2.0)
+      jekyll (>= 3.5, < 5.0)
+      rubyzip (>= 1.3.0)
+    jekyll-sass-converter (1.5.2)
+      sass (~> 3.4)
+    jekyll-seo-tag (2.6.1)
+      jekyll (>= 3.3, < 5.0)
+    jekyll-watch (2.2.1)
+      listen (~> 3.0)
+    json (2.3.0)
+    just-the-docs (0.2.7)
+      jekyll (~> 3.8.5)
+      jekyll-seo-tag (~> 2.0)
+      rake (~> 12.3.1)
+    kramdown (1.17.0)
+    liquid (4.0.3)
+    listen (3.2.1)
+      rb-fsevent (~> 0.10, >= 0.10.3)
+      rb-inotify (~> 0.9, >= 0.9.10)
     localhost (1.1.4)
+    mercenary (0.3.6)
     mime-types (3.3.1)
       mime-types-data (~> 3.2015)
     mime-types-data (3.2019.1009)
-    minitest (5.11.3)
+    minitest (5.13.0)
     minitest-reporters (1.4.2)
       ansi
       builder
@@ -28,17 +75,43 @@ GEM
       ruby-progressbar
     modulation (1.0)
     multi_xml (0.6.0)
+    parallel (1.19.1)
+    parser (2.7.0.2)
+      ast (~> 2.4.0)
+    pathutil (0.16.2)
+      forwardable-extended (~> 2.6)
     pg (1.1.3)
-    rake (13.0.1)
+    public_suffix (4.0.3)
+    rainbow (3.0.0)
+    rake (12.3.3)
     rake-compiler (1.0.5)
       rake
+    rb-fsevent (0.10.3)
+    rb-inotify (0.10.1)
+      ffi (~> 1.0)
     redis (4.1.0)
+    rouge (3.15.0)
+    rubocop (0.79.0)
+      jaro_winkler (~> 1.5.1)
+      parallel (~> 1.10)
+      parser (>= 2.7.0.1)
+      rainbow (>= 2.2.2, < 4.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 1.7)
     ruby-progressbar (1.10.1)
+    rubyzip (2.0.0)
+    safe_yaml (1.0.5)
+    sass (3.7.4)
+      sass-listen (~> 4.0.0)
+    sass-listen (4.0.0)
+      rb-fsevent (~> 0.9, >= 0.9.4)
+      rb-inotify (~> 0.9, >= 0.9.7)
     simplecov (0.17.1)
       docile (~> 1.1)
       json (>= 1.8, < 3)
       simplecov-html (~> 0.10.0)
     simplecov-html (0.10.2)
+    unicode-display_width (1.6.1)
 
 PLATFORMS
   ruby
@@ -47,13 +120,18 @@ DEPENDENCIES
   hiredis (= 0.6.3)
   http_parser.rb (~> 0.6.0)
   httparty (= 0.17.0)
+  jekyll (~> 3.8.6)
+  jekyll-remote-theme (~> 0.4.1)
+  jekyll-seo-tag (~> 2.6.1)
+  just-the-docs (~> 0.2.7)
   localhost (= 1.1.4)
-  minitest (= 5.11.3)
+  minitest (= 5.13.0)
   minitest-reporters (= 1.4.2)
   pg (= 1.1.3)
   polyphony!
   rake-compiler (= 1.0.5)
   redis (= 4.1.0)
+  rubocop (= 0.79.0)
   simplecov (= 0.17.1)
 
 BUNDLED WITH

data/Rakefile

@@ -15,6 +15,10 @@ task :test do
   exec 'ruby test/run.rb'
 end
 
+task :docs do
+  exec 'RUBYOPT=-W0 jekyll serve -s docs'
+end
+
 task default: %w[compile]
 
 CLEAN.include "**/*.o", "**/*.so", "**/*.bundle", "**/*.jar", "pkg", "tmp"

data/TODO.md

@@ -1,16 +1,18 @@
-## 0.27 Multithreaded fiber scheduling
+## 0.29 Multithreaded fiber scheduling - some rough corners
 
+- Docs: explain difference between `sleep` and `suspend`
+- Write about threads: scheduling, etc
 - `Gyro_schedule_fiber` - schedule using fiber's associated thread (store thread
   ref in fiber), instead of current thread
 - Check why first call to `#sleep` returns too early in tests. Check the
   sleep behaviour in a spawned thread.
 
-## 0.28 Working Sinatra application
+## 0.30 Working Sinatra application
 
 - app with database access (postgresql)
 - benchmarks!
 
-## 0.29 Sidekick
+## 0.31 Sidekick
 
 Plan of action:
 
@@ -18,13 +20,13 @@ Plan of action:
 - test performance
 - proceed from there
 
-## 0.30 Testing && Docs
+## 0.32 Testing && Docs
 
 - Pull out redis/postgres code, put into new `polyphony-xxx` gems
 
-## 0.31 Integration
+## 0.33 Integration
 
-## 0.32 Real IO#gets and IO#read
+## 0.34 Real IO#gets and IO#read
 
 - More tests
 - Implement some basic stuff missing:
@@ -34,24 +36,13 @@ Plan of action:
   - `IO.foreach`
   - `Process.waitpid`
 
-## 0.32 Support for multithreaded apps
-
-- Move fiber scheduling to the `Thread` class
-- Gyro selector conforming to the selector interface:
-  
-  ```ruby
-  class Selector
-    def wait
-  end
-  ```
-
-- Better separation between 
+## 0.35 Rails
 
 - Rails?
 
-# DNS
+## 0.36 DNS
 
-## DNS client
+### DNS client
 
 ```ruby
 ip_address = DNS.lookup('google.com', 'A')

data/docs/_config.yml

@@ -0,0 +1,15 @@
+title: "Polyphony"
+
+remote_theme: pmarsceill/just-the-docs
+color_scheme: nil
+
+search_enabled: true
+# Enable support for hyphenated search words:
+search_tokenizer_separator: /[\s/]+/
+
+plugins:
+  - jekyll-remote-theme
+
+aux_links:
+  "Polyphony on GitHub":
+    - "//github.com/digital-fabric/polyphony"

data/docs/_includes/nav.html

@@ -0,0 +1,47 @@
+<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 -%}
+              {%- assign children_list = site.html_pages | where: "parent", node.title | sort:"nav_order" -%}
+              <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/_sass/custom/custom.scss

@@ -0,0 +1,5 @@
+$link-color: $blue-000;
+
+.img-figure {
+  text-align: center;
+}

data/docs/_sass/overrides.scss

@@ -0,0 +1,45 @@
+.navigation-list-item.section-title {
+  padding-top: 0.75em;
+  padding-bottom: 0.75em;
+}
+
+span.section-title {
+  text-transform: uppercase;
+  font-weight: bold;
+  color: #888;
+}
+
+.navigation-list-item .navigation-list-child-list {
+  display: block;
+}
+
+.navigation-list-child-list {
+  padding-left: 0;
+
+  .navigation-list-item {
+    position: relative;
+
+    &::before {
+      position: absolute;
+      margin-top: 0.3em;
+      margin-left: -0.8em;
+      color: rgba($body-text-color, 0.3);
+      content: "";
+    }
+
+    &.active {
+      &::before {
+        color: $body-text-color;
+      }
+    }
+  }
+}
+
+a.navigation-list-link {
+  color: $nav-child-link-color;
+  font-weight: 600;
+}
+
+a.navigation-list-link:hover {
+  color: $link-color;
+}