polyphony 0.38 → 0.43

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b952f96f313866e5b61e200093fcb1eb8111b2d48bb2a736e36b62f06772786c
-  data.tar.gz: 03ffbc7481d3e20cfd5d50cc0c7e1e28749da15a6c9d65c89e83a0370b61b2d2
+  metadata.gz: 4eb88a97bf07f85f50aa46923883fce2fe1bbd253407021a6f5bb246e0fdcfdc
+  data.tar.gz: c707861eb93f709661aa90abb33519004df5ff5db16f2d3da00387b292234027
 SHA512:
-  metadata.gz: 8fb34d135a0ab50a3e3ae722dd3f9ae70ba8ee83534c199f98611f5fa273b424fcedab548929a2dedcdaddec73a9aa6b652fa97a924dd5400155cf57a1cdcaf0
-  data.tar.gz: caacb6a006f52abf888a9f4a3f1ef2c917a73422abaf1cba7d1ae1b0c7db07a3bc62a5a6b6abbe22e46fd6e679e82d7a048ec2d9ac7ec7dee54453600c688597
+  metadata.gz: b554716ed26188fec86606198cdca669253d921017748ef0d9231db9f01e08e046b62fc38c0c6c3595a42f1976771db8b42c352c0431cc73f4b1ed64f7edf3c9
+  data.tar.gz: 3ba74e7427fab47a65cd466e9bbe14e48176f737f6fd7fca21b3143d75d1dd9fa2ddef24b723d83f26f321949171359d946cfd4281b3b96c33bf43593199adce

data/.github/workflows/test.yml

@@ -4,12 +4,21 @@ on: [push]
 
 jobs:
   build:
-    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest]
+        ruby: [2.6, 2.7]
+
+    name: >-
+      ${{matrix.os}}, ${{matrix.ruby}}
+
+    runs-on: ${{matrix.os}}
     steps:
     - uses: actions/checkout@v1
     - uses: actions/setup-ruby@v1
       with:
-        ruby-version: 2.6.5
+        ruby-version: ${{matrix.ruby}}
     - name: Install dependencies
       run: |
         gem install bundler

data/.gitignore

@@ -52,8 +52,8 @@ build-iPhoneSimulator/
 test.rb
 .vscode
 
-lib/gyro_ext.bundle
-lib/gyro_ext.so
+lib/*.bundle
+lib/*.so
 
 _site
 .sass-cache

data/.rubocop.yml

@@ -143,3 +143,33 @@ Style/HashTransformKeys:
 
 Style/HashTransformValues:
   Enabled: true
+
+Layout/EmptyLinesAroundAttributeAccessor:
+  Enabled: true
+
+Layout/SpaceAroundMethodCallOperator:
+  Enabled: true
+
+Lint/DeprecatedOpenSSLConstant:
+  Enabled: true
+
+Lint/MixedRegexpCaptureTypes:
+  Enabled: true
+
+Lint/RaiseException:
+  Enabled: true
+
+Lint/StructNewOverride:
+  Enabled: true
+
+Style/ExponentialNotation:
+  Enabled: true
+
+Style/RedundantRegexpCharacterClass:
+  Enabled: true
+
+Style/RedundantRegexpEscape:
+  Enabled: true
+
+Style/SlicingWithRange:
+  Enabled: true

data/CHANGELOG.md

@@ -1,3 +1,26 @@
+## 0.43 2020-07-05
+
+* Add IO#read_loop
+* Fix OpenSSL extension
+* More work on docs
+
+## 0.42 2020-07-03
+
+* Improve documentation
+* Fix backtrace on SIGINT
+* Implement LibevAgent#accept_loop, #read_loop
+* Move ref counting from thread to agent
+* Short circuit switchpoint if continuing with the same fiber
+* Always do a switchpoint in #read, #write, #accept
+
+## 0.41 2020-06-27
+
+* Introduce System Agent design, remove all `Gyro` classes
+
+## 0.40 2020-05-04
+
+* More improvements to stability after fork
+
 ## 0.38 2020-04-13
 
 * Fix post-fork segfault if parent process has multiple threads with active watchers
@@ -17,13 +40,13 @@
 
 * Rename `Fiber#cancel!` to `Fiber#cancel`
 * Rename `Gyro::Async#signal!` to `Gyro::Async#signal`
-* Use `Fiber#auto_async` in thread pool, thread extension
+* Use `Fiber#auto_watcher` in thread pool, thread extension
 * Implement `Fiber#auto_io` for reusing IO watcher instances
 * Refactor C code
 
 ## 0.34 2020-03-25
 
-* Add `Fiber#auto_async` mainly for use in places like `Gyro::Queue#shift`
+* Add `Fiber#auto_watcher` mainly for use in places like `Gyro::Queue#shift`
 * Refactor C extension
 * Improved GC'ing for watchers
 * Implement process supervisor (`Polyphony::ProcessSupervisor`)

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    polyphony (0.38)
+    polyphony (0.43)
 
 GEM
   remote: https://rubygems.org/
@@ -27,7 +27,6 @@ GEM
       multi_xml (>= 0.5.2)
     i18n (0.9.5)
       concurrent-ruby (~> 1.0)
-    jaro_winkler (1.5.4)
     jekyll (3.8.6)
       addressable (~> 2.4)
       colorator (~> 1.0)
@@ -52,10 +51,10 @@ GEM
     jekyll-watch (2.2.1)
       listen (~> 3.0)
     json (2.3.0)
-    just-the-docs (0.2.7)
-      jekyll (~> 3.8.5)
+    just-the-docs (0.3.0)
+      jekyll (>= 3.8.5)
       jekyll-seo-tag (~> 2.0)
-      rake (~> 12.3.1)
+      rake (>= 12.3.1, < 13.1.0)
     kramdown (1.17.0)
     liquid (4.0.3)
     listen (3.2.1)
@@ -78,7 +77,7 @@ GEM
       ast (~> 2.4.0)
     pathutil (0.16.2)
       forwardable-extended (~> 2.6)
-    pg (1.1.3)
+    pg (1.1.4)
     public_suffix (4.0.3)
     rainbow (3.0.0)
     rake (12.3.3)
@@ -88,16 +87,20 @@ GEM
     rb-inotify (0.10.1)
       ffi (~> 1.0)
     redis (4.1.0)
+    regexp_parser (1.7.1)
     rexml (3.2.4)
     rouge (3.15.0)
-    rubocop (0.80.0)
-      jaro_winkler (~> 1.5.1)
+    rubocop (0.85.1)
       parallel (~> 1.10)
       parser (>= 2.7.0.1)
       rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.7)
       rexml
+      rubocop-ast (>= 0.0.3)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 1.7)
+      unicode-display_width (>= 1.4.0, < 2.0)
+    rubocop-ast (0.0.3)
+      parser (>= 2.7.0.1)
     ruby-progressbar (1.10.1)
     rubyzip (2.0.0)
     safe_yaml (1.0.5)
@@ -123,15 +126,15 @@ DEPENDENCIES
   jekyll (~> 3.8.6)
   jekyll-remote-theme (~> 0.4.1)
   jekyll-seo-tag (~> 2.6.1)
-  just-the-docs (~> 0.2.7)
+  just-the-docs (~> 0.3.0)
   localhost (= 1.1.4)
   minitest (= 5.13.0)
   minitest-reporters (= 1.4.2)
-  pg (= 1.1.3)
+  pg (= 1.1.4)
   polyphony!
   rake-compiler (= 1.0.5)
   redis (= 4.1.0)
-  rubocop (= 0.80.0)
+  rubocop (= 0.85.1)
   simplecov (= 0.17.1)
 
 BUNDLED WITH

data/README.md

@@ -1,5 +1,6 @@
 # Polyphony - Fine-Grained Concurrency for Ruby
 
+
 [![Gem Version](https://badge.fury.io/rb/polyphony.svg)](http://rubygems.org/gems/polyphony)
 [![Modulation Test](https://github.com/digital-fabric/polyphony/workflows/Tests/badge.svg)](https://github.com/digital-fabric/polyphony/actions?query=workflow%3ATests)
 [![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/digital-fabric/polyphony/blob/master/LICENSE)
@@ -46,4 +47,4 @@ The complete documentation for Polyphony could be found on the
 
 Issues and pull requests will be gladly accepted. Please use the [Polyphony git
 repository](https://github.com/digital-fabric/polyphony) as your primary point
-of departure for contributing.
+of departure for contributing.

data/Rakefile

@@ -4,8 +4,8 @@ require "bundler/gem_tasks"
 require "rake/clean"
 
 require "rake/extensiontask"
-Rake::ExtensionTask.new("gyro_ext") do |ext|
-  ext.ext_dir = "ext/gyro"
+Rake::ExtensionTask.new("polyphony_ext") do |ext|
+  ext.ext_dir = "ext/polyphony"
 end
 
 task :recompile => [:clean, :compile]
@@ -20,7 +20,7 @@ task :stress_test do
 end
 
 task :docs do
-  exec 'RUBYOPT=-W0 jekyll serve -s docs'
+  exec 'RUBYOPT=-W0 jekyll serve -s docs -H ec2-35-158-110-38.eu-central-1.compute.amazonaws.com'
 end
 
 CLEAN.include "**/*.o", "**/*.so", "**/*.bundle", "**/*.jar", "pkg", "tmp"

data/TODO.md

@@ -1,42 +1,9 @@
-- Would it be possible to spin up a fiber on another thread?
-  
-  The use case is being able to supervise fibers that run on separate threads.
-  This might be useful for distributing jobs (such as handling HTTP connections)
-  over multiple threads.
+## 0.43 
 
-  For this we need:
-
-  - A way to communicate to a thread that it needs to spin up a fiber, the
-    simplest solution is to start a fiber accepting spin requests for each
-    thread (in `Thread#initialize`).
-  - An API:
-
-    ```ruby
-    spin(on_thread: thread) { do_something_important }
-    ```
-
-  An alternative is to turn the main fiber of spawned threads into a child of
-  the spawning fiber. But since a lot of people might start threads without any
-  regard to fibers, it might be better to implement this in a new API. An
-  example of the top of my head for threads that shouldn't be children of the
-  spawning fiber is our own test helper, which kills all child fibers after each
-  test. MiniTest has some threads it spawns for running tests in parallel, and
-  we don't want to stop them after each test!
-
-  So, a good solution would be:
-
-  ```ruby
-  t = Thread.new { do_stuff }
-  t.parent_fiber = Fiber.current
-  # or otherwise:
-  Fiber.current.add_child_fiber(t.main_fiber)
-  ```
-
-
-
-
-
-## 0.40 Some more API work, more docs
+- Reimplement ResourcePool, Channel, Mutex using LibevQueue
+-- Add `Fiber#schedule_with_priority` method, aliased by `Fiber#wakeup`
+- Implement agent interface is virtual function table
+- Implement proxy agent for plugging in a user-provided agent class
 
 - Debugging
   - Eat your own dogfood: need a good tool to check what's going on when some
@@ -148,13 +115,12 @@
     - links to the interesting stuff
       - benchmarks
   - explain difference between `sleep` and `suspend`
-  - add explanation about async vs sync, blocking vs non-blocking
   - discuss using `snooze` for ensuring responsiveness when executing CPU-bound work
 
-- Check why first call to `#sleep` returns too early in tests. Check the
-  sleep behaviour in a spawned thread.
 
-## 0.41 Sinatra / Sidekiq
+## 0.44
+
+### Some more API work, more docs
 
 - sintra app with database access (postgresql)
 
@@ -164,13 +130,16 @@
   - test performance
   - proceed from there
 
-## 0.42 Testing && Docs
+
+## 0.45
+
+### Sinatra / Sidekiq
 
 - Pull out redis/postgres code, put into new `polyphony-xxx` gems
 
-## 0.43 Integration
+## 0.46
 
-## 0.44 Real IO#gets and IO#read
+### Testing && Docs
 
 - More tests
 - Implement some basic stuff missing:
@@ -180,11 +149,11 @@
   - `IO.foreach`
   - `Process.waitpid`
 
-## 0.45 Rails
+## 0.47
 
-- Rails?
+### Real IO#gets and IO#read
 
-## 0.46 DNS
+## 0.48 DNS
 
 ### DNS client
 
@@ -217,56 +186,17 @@ Prior art:
 
 - https://github.com/socketry/async-dns
 
-### Work on API
-
-  - Introduce mailbox limiting:
-    - add API for limiting mailbox size:
-
-      ```ruby
-      Fiber.current.mailbox_limit = 1000
-      ```
-
-    - Add the limit for `Gyro::Queue`
-
-      ```ruby
-      Gyro::Queue.new(1000)
-      ```
-
-    - Pushing to a limited queue will block if limit is reached
-
-  - Introduce selective receive:
-
-    ```ruby
-    # returns (or waits for) the first message for which the block returns true
-    (_, item) = receive { |msg| msg.first == ref }
-    ```
-
-    Possible implementation:
-
-    ```ruby
-    def receive
-      return @mailbox.shift unless block_given?
-      
-      loop
-        msg = @mailbox.shift
-        return msg if yield(msg)
-
-        # message didn't match condition, put it back in queue
-        @mailbox.push msg
-      end
-    end
-    ```
+## Work on API
 
 - Add option for setting the exception raised on cancelling using `#cancel_after`:
 
-  ```ruby
-  cancel_after(3, with_error: MyErrorClass) do
-    do_my_thing
-  end
-
-  # or a RuntimeError with message
-  cancel_after(3, with_error: 'Cancelling due to timeout') do
-    do_my_thing
-  end
-  ```
+```ruby
+cancel_after(3, with_error: MyErrorClass) do
+  do_my_thing
+end
+# or a RuntimeError with message
+cancel_after(3, with_error: 'Cancelled due to timeout') do
+  do_my_thing
+end
+```
 

data/docs/_config.yml

@@ -1,15 +1,64 @@
 title: "Polyphony"
+description: Fine-grained concurrency for Ruby
 
+plugins:
+  - jekyll-remote-theme
+
+permalink: pretty
 remote_theme: pmarsceill/just-the-docs
-color_scheme: nil
+color_scheme: light
 
 search_enabled: true
-# Enable support for hyphenated search words:
-search_tokenizer_separator: /[\s/]+/
-
-plugins:
-  - jekyll-remote-theme
+search:
+  # Split pages into sections that can be searched individually
+  # Supports 1 - 6, default: 2
+  heading_level: 2
+  # Maximum amount of previews per search result
+  # Default: 3
+  previews: 3
+  # Maximum amount of words to display before a matched word in the preview
+  # Default: 5
+  preview_words_before: 5
+  # Maximum amount of words to display after a matched word in the preview
+  # Default: 10
+  preview_words_after: 10
+  # Set the search token separator
+  # Default: /[\s\-/]+/
+  # Example: enable support for hyphenated search words
+  tokenizer_separator: /[\s/]+/
+  # Display the relative url in search results
+  # Supports true (default) or false
+  rel_url: true
+  # Enable or disable the search button that appears in the bottom right corner of every page
+  # Supports true or false (default)
+  button: false
 
 aux_links:
   "Polyphony on GitHub":
-    - "//github.com/digital-fabric/polyphony"
+    - "//github.com/digital-fabric/polyphony"
+
+# Makes Aux links open in a new tab. Default is false
+aux_links_new_tab: false
+
+# Enable or disable heading anchors
+heading_anchors: true
+
+back_to_top: true
+back_to_top_text: "Back to top"
+
+footer_content: "Copyright &copy; 2020 Sharon Rosner. Distributed by an <a href=\"https://github.com/digital-fabric/polyphony/tree/master/LICENSE\">MIT license.</a>"
+
+# Footer "Edit this page on GitHub" link text
+gh_edit_link: true # show or hide edit this page link
+gh_edit_link_text: "Edit this page on GitHub"
+gh_edit_repository: "https://github.com/digital-fabric/polyphony" # the github URL for your repo
+gh_edit_branch: "master/docs" # the branch that your docs is served from
+gh_edit_view_mode: "tree" # "tree" or "edit" if you want the user to jump into the editor immediately
+
+compress_html:
+  clippings: all
+  comments: all
+  endings: all
+  startings: []
+  blanklines: false
+  profile: false