usleep 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ed1ae7252234ade0db2e259f484817e67e043573
+  data.tar.gz: 5f25e467c6e8928e8944e8428eb90363696c77f8
+SHA512:
+  metadata.gz: 6e225d3f3a9eff13e43cdd41eb221bf74d98246ebb0df1c2c0c00f6db80a4530c2cad0c12ed48250090e2570117cc771c118aca5eb0aa5c213f4db4a5ec33840
+  data.tar.gz: c557a2beda25a43bba7365cd15564ddeafeae6af43d7a6e9983e25e8c3b541b8e8920334fcfce747945118203361c97551c0d14d1fa34ed94637a7dd695cf0e9

data/.gitignore

@@ -0,0 +1,4 @@
+.bundle/
+tmp/
+Gemfile.lock
+*.gem

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/Gemfile

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+
+gemspec
+
+eval_gemfile "#{__FILE__}.local" if File.exists? "#{__FILE__}.local"

data/README.md

@@ -0,0 +1,10 @@
+Usleep
+======
+
+This Ruby gem provides a module with a single function: `Usleep.sleep( )`
+
+This function sleeps for an integer amount of seconds in C code while holding
+the Ruby Global VM Lock (GVL). This is a worthless behavior that noone should
+allow in production code, but is useful in testing for simulating an operation
+that blocks other Ruby threads and is "uninterpretable" from other Ruby code
+once it begins.

data/Rakefile

@@ -0,0 +1,16 @@
+require 'rake/extensiontask'
+require 'rspec/core/rake_task'
+
+Rake::ExtensionTask.new 'ext' do |ext|
+  ext.lib_dir = 'lib/usleep'
+end
+
+namespace(:spec) do
+  desc 'Run RSpec unit tests'
+  RSpec::Core::RakeTask.new(:unit) do |task|
+    task.pattern = 'spec/unit/**{,/*/**}/*_spec.rb'
+  end
+end
+
+desc 'Run all test suites'
+task(:test => ['spec:unit'])

data/ext/ext/extconf.rb

@@ -0,0 +1,3 @@
+require 'mkmf'
+
+create_makefile('usleep/ext')

data/ext/ext/usleep.c

@@ -0,0 +1,23 @@
+#include <ruby.h>
+
+#include <unistd.h>
+
+static VALUE
+do_sleep(VALUE mod, VALUE time_to_sleep)
+{
+  unsigned int naptime = NUM2UINT(time_to_sleep);
+
+  sleep(naptime);
+
+  return Qnil;
+}
+
+void
+Init_ext()
+{
+  rb_require("usleep/version");
+
+  VALUE mUsleep = rb_const_get(rb_cObject, rb_intern("Usleep"));
+
+  rb_define_singleton_method(mUsleep, "sleep", do_sleep, 1);
+}

data/lib/usleep.rb

@@ -0,0 +1,4 @@
+module Usleep
+  require 'usleep/version'
+  require 'usleep/ext'
+end

data/lib/usleep/version.rb

@@ -0,0 +1,3 @@
+module Usleep
+  VERSION = '0.0.1'.freeze
+end

data/spec/unit/usleep_spec.rb

@@ -0,0 +1,21 @@
+require 'usleep'
+
+describe Usleep do
+  it 'blocks other threads when sleeping' do
+    start_time = Process.clock_gettime(Process::CLOCK_MONOTONIC, :float_second)
+
+    sleeper = Thread.new { Usleep.sleep(1) }
+
+    5.times do
+      sleep(0.1)
+      Thread.pass
+    end
+
+    sleeper.kill
+    sleeper.join
+
+    end_time = Process.clock_gettime(Process::CLOCK_MONOTONIC, :float_second)
+
+    expect(end_time - start_time).to be > 1.0
+  end
+end

data/usleep.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'usleep/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'usleep'
+  spec.version       = Usleep::VERSION
+  spec.authors       = ['Charlie Sharpsteen']
+  spec.email         = ['source@sharpsteen.net']
+  spec.license       = 'MIT'
+
+  spec.summary       = 'A Ruby library that provides functionality for sleeping while holding the Global VM Lock (GVL).'
+  spec.homepage      = 'https://github.com/Sharpie/ruby-usleep'
+  spec.description   = <<-EOS
+A Ruby library that can execute a sleep while holding the Global VM Lock,
+which is pathological behavior that would normally be avoided in practice.
+However, having an easy method of blocking the Ruby VM from a thread is
+useful in certain debugging and simulation scenarios.
+  EOS
+
+  spec.files         = %x[git ls-files].split($/)
+  spec.require_paths = ['lib']
+  spec.extensions    = Dir['ext/**/extconf.rb']
+
+  spec.add_development_dependency 'rake', '~> 12.3'
+  spec.add_development_dependency 'rake-compiler', '~> 1.0'
+  spec.add_development_dependency 'rspec', '~> 3.7'
+end

metadata

@@ -0,0 +1,103 @@
+--- !ruby/object:Gem::Specification
+name: usleep
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Charlie Sharpsteen
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-03-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.3'
+- !ruby/object:Gem::Dependency
+  name: rake-compiler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+description: |
+  A Ruby library that can execute a sleep while holding the Global VM Lock,
+  which is pathological behavior that would normally be avoided in practice.
+  However, having an easy method of blocking the Ruby VM from a thread is
+  useful in certain debugging and simulation scenarios.
+email:
+- source@sharpsteen.net
+executables: []
+extensions:
+- ext/ext/extconf.rb
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- README.md
+- Rakefile
+- ext/ext/extconf.rb
+- ext/ext/usleep.c
+- lib/usleep.rb
+- lib/usleep/version.rb
+- spec/unit/usleep_spec.rb
+- usleep.gemspec
+homepage: https://github.com/Sharpie/ruby-usleep
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.14
+signing_key: 
+specification_version: 4
+summary: A Ruby library that provides functionality for sleeping while holding the
+  Global VM Lock (GVL).
+test_files: []