rb-kqueue 0.2.1 → 0.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 78c0252826cd5dbb42baf397441e76a75ccc43c0
-  data.tar.gz: 2e1dc0fe3c9df91b5ebede02074380391aacddf1
+SHA256:
+  metadata.gz: 0f24844743c7766edc2ddfa6c7c125a5ff7419eac128d6695fcb8da70c07d66b
+  data.tar.gz: '008dd0f2124471e3a190cb80458774076d6ed5f1cbba1dc020f8e6a0f3250eb8'
 SHA512:
-  metadata.gz: 4b18a3176de712e04ae937c12c91fac319cb05b47286cc2aa4b7dd0244e937d8c86de8ad6db6768c6eadba56e7161544289eb7c666687acbbda7c2cee36e9d28
-  data.tar.gz: 43e9c02219fd75c0060a14a2c9340788a8a48ef2adab351532a492803bbaed8dc8070c91907657a94c7daab75f23f756f077b3dd32f1347b5cd7274ba2889529
+  metadata.gz: d86c4ef6d17773c5ca1b6567ea9be15b7c2b179bac98253d7c2d230dea89d6ba8c0c20badd335e3944843eb1902b077fb0690eb392ba0b6cf357c8362521676d
+  data.tar.gz: bbdde67f0d98268d46c7b4c8a13fe0497a017671efdfbab0c7754f577c2a58aa4e8397603f033ad316fb4f28633a6fe78e1ee21c1e3bb71c2c62fc4b6ba0fa7b

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

data/.ruby-gemset

@@ -0,0 +1 @@
+rb-kqueue

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.6.5

data/lib/rb-kqueue.rb

@@ -4,8 +4,11 @@ require 'rb-kqueue/watcher'
 require 'rb-kqueue/watcher/file'
 require 'rb-kqueue/watcher/read_write'
 require 'rb-kqueue/watcher/process'
+require 'rb-kqueue/watcher/signal'
+require 'rb-kqueue/watcher/timer'
 require 'rb-kqueue/event'
 require 'rb-kqueue/queue'
+require 'rb-kqueue/version'
 
 # The root module of the library, which is laid out as so:
 #
@@ -13,8 +16,6 @@ require 'rb-kqueue/queue'
 # * {Watcher} -- A watcher for a single sort of event
 # * {Event} -- A notification that an event has occurred
 module KQueue
-  VERSION = [0, 2, 1]
-
   # Raise an exception for a native kqueue error.
   #
   # @param errno [Fixnum] The errno identifying the sort of error.

data/lib/rb-kqueue/event.rb

@@ -3,6 +3,11 @@ module KQueue
   # Each {Watcher} can fire many events,
   # which are passed to that Watcher's callback.
   class Event
+
+    # Exception raised on an attempt to construct an {Event}
+    # from a native event with unexpected field values.
+    class UnexpectedEvent < Exception; end
+
     # Some integer data, the interpretation of which
     # is specific to each individual {Watcher}.
     # For specifics, see the individual Watcher subclasses.
@@ -64,7 +69,11 @@ module KQueue
       @native = native
       @queue = queue
       @data = @native[:data]
-      @filter = KQueue::Native::Flags.from_flag("EVFILT", @native[:filter])
+      begin
+        @filter = KQueue::Native::Flags.from_flag("EVFILT", @native[:filter])
+      rescue Native::Flags::FlagNotFound
+        raise UnexpectedEvent
+      end
       @flags = Native::Flags.from_mask("EV", @native[:flags])
 
       KQueue.handle_error @native[:data] if @flags.include?(:error)

data/lib/rb-kqueue/native.rb

@@ -13,13 +13,39 @@ module KQueue
     #
     # @private
     class KEvent < FFI::Struct
-      layout(
-        :ident,  :uintptr_t,
-        :filter, :int16,
-        :flags,  :uint16,
-        :fflags, :uint32,
-        :data,   :intptr_t,
-        :udata,  :pointer)
+      if FFI::Platform::IS_FREEBSD
+        layout(
+          :ident,  :uintptr_t,
+          :filter, :short,
+          :flags,  :u_short,
+          :fflags, :u_int,
+          :data,   :intptr_t,
+          :udata,  :pointer)
+      elsif FFI::Platform::IS_NETBSD
+        layout(
+          :ident,  :uintptr_t,
+          :filter, :uint32_t,
+          :flags,  :uint32_t,
+          :fflags, :uint32_t,
+          :data,   :int64_t,
+          :udata,  :pointer)
+      elsif FFI::Platform::IS_OPENBSD
+        layout(
+          :ident,  :__uintptr_t,
+          :filter, :short,
+          :flags,  :u_short,
+          :fflags, :u_int,
+          :data,   :quad_t,
+          :udata,  :pointer)
+      else
+        layout(
+          :ident,  :uintptr_t,
+          :filter, :int16,
+          :flags,  :uint16,
+          :fflags, :uint32,
+          :data,   :intptr_t,
+          :udata,  :pointer)
+      end
     end
 
     # The C struct describing a timeout.

data/lib/rb-kqueue/native/flags.rb

@@ -6,17 +6,50 @@ module KQueue
     # @private
     module Flags
       # Filters
-      EVFILT_READ = -1
-      EVFILT_WRITE = -2
-      EVFILT_AIO = -3 # Attached to aio requests
-      EVFILT_VNODE = -4 # Attached to vnodes
-      EVFILT_PROC = -5 # Attached to struct proc
-      EVFILT_SIGNAL = -6 # Attached to struct proc
-      EVFILT_TIMER = -7 # Timers
-      EVFILT_MACHPORT = -8 # Mach portsets
-      EVFILT_FS = -9 # Filesystem events
-      EVFILT_USER = -10 # User events
-      EVFILT_SESSION = -11 # Audit session events
+      if FFI::Platform::IS_FREEBSD
+        EVFILT_READ = -1
+        EVFILT_WRITE = -2
+        EVFILT_AIO = -3 # Attached to aio requests
+        EVFILT_VNODE = -4 # Attached to vnodes
+        EVFILT_PROC = -5 # Attached to struct proc
+        EVFILT_SIGNAL = -6 # Attached to struct proc
+        EVFILT_TIMER = -7 # Timers
+        EVFILT_PROCDESC = -8 # Attached to process descriptors
+        EVFILT_FS = -9 # Filesystem events
+        EVFILT_LIO = -10 # Attached to lio requests
+        EVFILT_USER = -11 # User events
+        EVFILT_SENDFILE = -12 # Attached to sendfile requests
+        EVFILT_SYSCOUNT = 12
+      elsif FFI::Platform::IS_NETBSD
+        EVFILT_READ = 0
+        EVFILT_WRITE = 1
+        EVFILT_AIO = 2 # Attached to aio requests
+        EVFILT_VNODE = 3 # Attached to vnodes
+        EVFILT_PROC = 4 # Attached to struct proc
+        EVFILT_SIGNAL = 5 # Attached to struct proc
+        EVFILT_TIMER = 6 # Arbitrary timer (in ms)
+        EVFILT_SYSCOUNT = 7 # Number of filters
+      elsif FFI::Platform::IS_OPENBSD
+        EVFILT_READ = -1
+        EVFILT_WRITE = -2
+        EVFILT_AIO = -3 # Attached to aio requests
+        EVFILT_VNODE = -4 # Attached to vnodes
+        EVFILT_PROC = -5 # Attached to struct proc
+        EVFILT_SIGNAL = -6 # Attached to struct proc
+        EVFILT_TIMER = -7 # Timers
+      else
+        EVFILT_READ = -1
+        EVFILT_WRITE = -2
+        EVFILT_AIO = -3 # Attached to aio requests
+        EVFILT_VNODE = -4 # Attached to vnodes
+        EVFILT_PROC = -5 # Attached to struct proc
+        EVFILT_SIGNAL = -6 # Attached to struct proc
+        EVFILT_TIMER = -7 # Timers
+        EVFILT_MACHPORT = -8 # Mach portsets
+        EVFILT_FS = -9 # Filesystem events
+        EVFILT_USER = -10 # User events
+        EVFILT_SESSION = -11 # Audit session events
+      end
 
 
       # Actions
@@ -64,6 +97,9 @@ module KQueue
       NOTE_TIMER_NSECONDS = 0x00000004 # data is nanoseconds
       NOTE_TIMER_ABSOLUTE = 0x00000008 # absolute timeout
 
+      # Exception raised when a function fails to find a flag satisfying
+      # its given query.
+      class FlagNotFound < Exception; end
 
       # Converts a list of flags to the bitmask that the C API expects.
       #
@@ -110,6 +146,7 @@ module KQueue
           next unless c =~ re
           return c.to_s.sub("#{prefix}_", "").downcase.to_sym if const_get(c) == flag
         end
+        raise FlagNotFound
       end
     end
   end

data/lib/rb-kqueue/queue.rb

@@ -359,7 +359,13 @@ module KQueue
       res = Native.kevent(@fd, nil, 0, eventlist, size, timeout)
 
       KQueue.handle_error if res < 0
-      (0...res).map {|i| KQueue::Event.new(Native::KEvent.new(eventlist[i]), self)}
+      (0...res).map do |i|
+        begin
+          KQueue::Event.new(Native::KEvent.new(eventlist[i]), self)
+        rescue KQueue::Event::UnexpectedEvent
+          nil
+        end
+      end.compact
     end
   end
 end

data/lib/rb-kqueue/version.rb

@@ -0,0 +1,3 @@
+module KQueue
+  VERSION = [0, 2, 6]
+end

data/lib/rb-kqueue/watcher/signal.rb

@@ -19,9 +19,9 @@ module KQueue
       def initialize(queue, signal, callback)
         if signal.is_a?(String)
           @name = signal
-          @number = Signal.list[signal]
+          @number = ::Signal.list[signal]
         else
-          @name = Signal.list.find {|_, n| n == signal}.first
+          @name = ::Signal.list.find {|_, n| n == signal}.first
           @number = signal
         end
 

data/rb-kqueue.gemspec

@@ -1,29 +1,25 @@
-# Generated by jeweler
-# DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
-# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/rb-kqueue/version', __FILE__)
 
 Gem::Specification.new do |gem|
   gem.name = %q{rb-kqueue}
-  gem.version = "0.2.1"
+  gem.version = KQueue::VERSION.join(".")
 
   gem.authors = ["Mathieu Arnold", "Nathan Weizenbaum"]
   gem.email = %q{mat@mat.cc nex342@gmail.com}
-  gem.date = %q{2012-12-03}
   gem.description = %q{A Ruby wrapper for BSD's kqueue, using FFI}
   gem.extra_rdoc_files = %w(README.md)
+  gem.licenses = ['MIT']
 
   gem.files = `git ls-files`.split(/\n/)
-  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
-  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.executables = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files = gem.files.grep(%r{^(test|spec|features)/})
 
   gem.homepage = %q{http://github.com/mat813/rb-kqueue}
   gem.rdoc_options = ["--charset=UTF-8"]
   gem.require_paths = ["lib"]
-  gem.rubygems_version = %q{1.3.5}
   gem.summary = %q{A Ruby wrapper for BSD's kqueue, using FFI}
 
   gem.add_runtime_dependency(%q<ffi>, [">= 0.5.0"])
   gem.add_development_dependency(%q<yard>, [">= 0.4.0"])
+  gem.add_development_dependency(%q<rspec>, [">= 3.3.0"])
 end
-

data/spec/kqueue_queue_spec.rb

@@ -0,0 +1,32 @@
+require_relative '../lib/rb-kqueue'
+require 'tempfile'
+require 'pathname'
+
+RSpec.describe KQueue::Queue do
+  describe '#watch_file' do
+    let(:file_touched) { false }
+    let(:queue) { KQueue::Queue.new }
+    let(:file) { Tempfile.new 'rb-kqueue_test', Pathname(__dir__).parent.join('tmp') }
+
+    context 'file is watched for writes' do
+      before do
+        queue.watch_file file.path, :write do
+          file_touched = !file_touched
+        end
+        queue.process
+      end
+
+      context 'file is written to' do
+        it 'executes the defined block' do
+          expect { file.write 'test' }.to change { file_touched }.from(false).to true
+        end
+      end
+    end
+
+    context 'file is watched for reads' do
+    end
+
+    context 'file is not watched' do
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,96 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# The generated `.rspec` file contains `--require spec_helper` which will cause
+# this file to always be loaded, without a need to explicitly require it in any
+# files.
+#
+# Given that it is always loaded, you are encouraged to keep this file as
+# light-weight as possible. Requiring heavyweight dependencies from this file
+# will add to the boot time of your test suite on EVERY test run, even for an
+# individual file that may not need all of that loaded. Instead, consider making
+# a separate helper file that requires the additional dependencies and performs
+# the additional setup, and require it from the spec files that actually need
+# it.
+#
+# The `.rspec` file also contains a few flags that are not defaults but that
+# users commonly want.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text for helper methods
+    # defined using `chain`, e.g.:
+    #     be_bigger_than(2).and_smaller_than(4).description
+    #     # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #     # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+# The settings below are suggested to provide a good initial experience
+# with RSpec, but feel free to customize to your heart's content.
+=begin
+  # These two settings work together to allow you to limit a spec run
+  # to individual examples or groups you care about by tagging them with
+  # `:focus` metadata. When nothing is tagged with `:focus`, all examples
+  # get run.
+  config.filter_run :focus
+  config.run_all_when_everything_filtered = true
+
+  # Allows RSpec to persist some state between runs in order to support
+  # the `--only-failures` and `--next-failure` CLI options. We recommend
+  # you configure your source control system to ignore this file.
+  config.example_status_persistence_file_path = "spec/examples.txt"
+
+  # Limits the available syntax to the non-monkey patched syntax that is
+  # recommended. For more details, see:
+  #   - http://myronmars.to/n/dev-blog/2012/06/rspecs-new-expectation-syntax
+  #   - http://www.teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+  #   - http://myronmars.to/n/dev-blog/2014/05/notable-changes-in-rspec-3#new__config_option_to_disable_rspeccore_monkey_patching
+  config.disable_monkey_patching!
+
+  # This setting enables warnings. It's recommended, but in some cases may
+  # be too noisy due to issues in dependencies.
+  config.warnings = true
+
+  # Many RSpec users commonly either run the entire suite or an individual
+  # file, and it's useful to allow more verbose output when running an
+  # individual spec file.
+  if config.files_to_run.one?
+    # Use the documentation formatter for detailed output,
+    # unless a formatter has already been configured
+    # (e.g. via a command-line flag).
+    config.default_formatter = 'doc'
+  end
+
+  # Print the 10 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  config.profile_examples = 10
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce
+  # test failures related to randomization by passing the same `--seed` value
+  # as the one that triggered the failure.
+  Kernel.srand config.seed
+=end
+end

metadata

@@ -1,44 +1,58 @@
 --- !ruby/object:Gem::Specification
 name: rb-kqueue
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.6
 platform: ruby
 authors:
 - Mathieu Arnold
 - Nathan Weizenbaum
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2012-12-03 00:00:00.000000000 Z
+date: 2021-04-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.5.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.5.0
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.4.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.4.0
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.3.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.3.0
 description: A Ruby wrapper for BSD's kqueue, using FFI
 email: mat@mat.cc nex342@gmail.com
 executables: []
@@ -46,18 +60,21 @@ extensions: []
 extra_rdoc_files:
 - README.md
 files:
-- .gitignore
-- .yardopts
+- ".gitignore"
+- ".rspec"
+- ".ruby-gemset"
+- ".ruby-version"
+- ".yardopts"
 - Gemfile
 - MIT-LICENSE
 - README.md
 - Rakefile
-- VERSION
 - lib/rb-kqueue.rb
 - lib/rb-kqueue/event.rb
 - lib/rb-kqueue/native.rb
 - lib/rb-kqueue/native/flags.rb
 - lib/rb-kqueue/queue.rb
+- lib/rb-kqueue/version.rb
 - lib/rb-kqueue/watcher.rb
 - lib/rb-kqueue/watcher/file.rb
 - lib/rb-kqueue/watcher/process.rb
@@ -66,28 +83,32 @@ files:
 - lib/rb-kqueue/watcher/socket_read_write.rb
 - lib/rb-kqueue/watcher/timer.rb
 - rb-kqueue.gemspec
+- spec/kqueue_queue_spec.rb
+- spec/spec_helper.rb
 homepage: http://github.com/mat813/rb-kqueue
-licenses: []
+licenses:
+- MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options:
-- --charset=UTF-8
+- "--charset=UTF-8"
 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.2.1
-signing_key: 
+rubygems_version: 3.0.9
+signing_key:
 specification_version: 4
 summary: A Ruby wrapper for BSD's kqueue, using FFI
-test_files: []
+test_files:
+- spec/kqueue_queue_spec.rb
+- spec/spec_helper.rb

data/VERSION

@@ -1 +0,0 @@
-0.1.0