mri_gil_lock 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 472933b4d5f0d0a9f81d884ce9d5e7a4d6def17bed832b166a1ea6ca49740293
-  data.tar.gz: 047d8c57a91ebb39b7e21bfade2069eeb43a05871e09a4d62a3fbac53dcd32d7
+  metadata.gz: 8556c962fa31f8eec0526a60c75585b2083a2adae5f9e723029eb2c18c811901
+  data.tar.gz: c9b7ab1b0b020e54667bbe7eca1498e76ad0250c23f0cd694ece126c1d413558
 SHA512:
-  metadata.gz: 572dba8a4b7e22ed70f4122136796f9f2dcd729f9b304304292430ce0d86d2862fef83ed2621ae49aaa431508b91e9b66f31380d543784d73a8d743f97cbadbf
-  data.tar.gz: 276957b59af9bb9309fc0bbf11525aa916e19de11bfc4f808c62f9e8df9a8b66eb131a78992365ecb978f4bcefa9b948432b969af5bc8db55d882e0d652b6749
+  metadata.gz: a05c54d85602a71ecc9f9b7195bc9c3c1e0df651dfc26ff72f05ba5ea6f0d28ad73ce9e78bdba8a4334d15bf24e1ee674cb098d85a64c60c7925d41a75ced336
+  data.tar.gz: 56f10e78c89caa8fdd52f93f69b079c4496dc5c9a69deff5e71836e49660a69390e6429663e12a245063d06be58a8871193eaf261705798100b78f9ae1986382

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    mri_gil_lock (0.1.2)
+    mri_gil_lock (0.1.3)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -1,35 +1,7 @@
-# MriGilLock
+# Demonstration of MRI Ruby's GIL locking
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/mri_gil_lock`. To experiment with that code, run `bin/console` for an interactive prompt.
-
-TODO: Delete this and the text above, and describe your gem
-
-## Installation
-
-Add this line to your application's Gemfile:
-
-```ruby
-gem 'mri_gil_lock'
 ```
-
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
-
-    $ gem install mri_gil_lock
-
-## Usage
-
-TODO: Write usage instructions here
-
-## Development
-
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
-
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
-
-## Contributing
-
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/mri_gil_lock.
+bundle
+bundle exec rake compile
+bin/demo.rb
+```

data/bin/demo.rb

@@ -0,0 +1,71 @@
+#!/usr/bin/env ruby
+require 'bundler/setup'
+require 'mri_gil_lock'
+require 'timeout'
+
+Thread.abort_on_exception=true
+
+def test_gil_lock
+ start_time = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+ sleep(1)
+ end_time = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+ elapsed_time = end_time - start_time
+
+ if elapsed_time > 1.1
+  puts "GIL locking, time elapsed #{elapsed_time}"
+ else
+   puts "NO GIL locking, time elapsed #{elapsed_time}"
+ end
+end
+
+puts "First, let's demo a non blocking thread that uses Ruby's sleep:"
+ruby_sleep_thread = Thread.new do
+  while(true) do
+    sleep(2)
+  end
+end
+
+monitoring_thread = Thread.new do
+  while(true) do
+    test_gil_lock
+  end
+end
+
+begin
+  Timeout.timeout(10) do
+    [ruby_sleep_thread, monitoring_thread].each(&:join)
+  end
+rescue Timeout::Error
+  ruby_sleep_thread.kill
+end
+
+puts "Now let's demo a blocking thread that uses a C extension:"
+c_extension_sleep_thread = Thread.new do
+  while(true) do
+    MriGilLock::Hold.for_microseconds(2_000_000)
+  end
+end
+begin
+  Timeout::timeout(10) do
+    [c_extension_sleep_thread, monitoring_thread].each(&:join)
+  end
+rescue Timeout::Error
+  c_extension_sleep_thread.kill
+end
+
+puts "Now let's demo a non blocking thread that uses a C extension which releases the GIL:"
+c_extension_sleep_thread_that_releases_the_gil = Thread.new do
+  while(true) do
+    MriGilLock::Hold.for_two_seconds_without_gil
+  end
+end
+begin
+  Timeout::timeout(10) do
+    [c_extension_sleep_thread_that_releases_the_gil, monitoring_thread].each(&:join)
+  end
+rescue Timeout::Error
+  c_extension_sleep_thread_that_releases_the_gil.kill
+end
+
+monitoring_thread.kill # And we're done
+puts "Done!"

data/ext/hold/hold.c

@@ -1,5 +1,6 @@
 #include "ruby.h"
 #include <unistd.h> // provides usleep
+#include <ruby/thread.h> // provides rb_thread_call_without_gvl
 
 VALUE holdFor(VALUE self, VALUE rubyTimeToHold)
 {
@@ -7,9 +8,23 @@ VALUE holdFor(VALUE self, VALUE rubyTimeToHold)
     return rubyTimeToHold;
 }
 
+void* holdForTwoSeconds()
+{
+    usleep(2000000); // avoid possible collision with ruby sleep functions
+    return NULL;
+}
+
+VALUE holdForTwoSecondsWithoutGil(VALUE self)
+{
+    // https://silverhammermba.github.io/emberb/c/#c-in-ruby-threads
+    rb_thread_call_without_gvl(holdForTwoSeconds, NULL, RUBY_UBF_IO, NULL);
+    return self;
+}
+
 void Init_hold()
 {
     VALUE moduleMriGilLock = rb_define_module("MriGilLock");
     VALUE classHold = rb_define_class_under(moduleMriGilLock, "Hold", rb_cObject);
     rb_define_singleton_method(classHold, "for_microseconds", holdFor, 1);
+    rb_define_singleton_method(classHold, "for_two_seconds_without_gil", holdForTwoSecondsWithoutGil, 0);
 }

data/lib/mri_gil_lock/version.rb

@@ -1,3 +1,3 @@
 module MriGilLock
-  VERSION = "0.1.2"
+  VERSION = "0.1.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mri_gil_lock
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Brian Buchalter
@@ -83,6 +83,7 @@ files:
 - README.md
 - Rakefile
 - bin/console
+- bin/demo.rb
 - bin/setup
 - ext/hold/extconf.rb
 - ext/hold/hold.c