sinotify 0.0.2

data/tasks/test.rake

@@ -0,0 +1,40 @@
+
+if test(?e, PROJ.test.file) or not PROJ.test.files.to_a.empty?
+require 'rake/testtask'
+
+namespace :test do
+
+  Rake::TestTask.new(:run) do |t|
+    t.libs = PROJ.libs
+    t.test_files = if test(?f, PROJ.test.file) then [PROJ.test.file]
+                   else PROJ.test.files end
+    t.ruby_opts += PROJ.ruby_opts
+    t.ruby_opts += PROJ.test.opts
+  end
+
+  if HAVE_RCOV
+    desc 'Run rcov on the unit tests'
+    task :rcov => :clobber_rcov do
+      opts = PROJ.rcov.opts.dup << '-o' << PROJ.rcov.dir
+      opts = opts.join(' ')
+      files = if test(?f, PROJ.test.file) then [PROJ.test.file]
+              else PROJ.test.files end
+      files = files.join(' ')
+      sh "#{RCOV} #{files} #{opts}"
+    end
+
+    task :clobber_rcov do
+      rm_r 'coverage' rescue nil
+    end
+  end
+
+end  # namespace :test
+
+desc 'Alias to test:run'
+task :test => 'test:run'
+
+task :clobber => 'test:clobber_rcov' if HAVE_RCOV
+
+end
+
+# EOF

data/tasks/zentest.rake

@@ -0,0 +1,36 @@
+if HAVE_ZENTEST
+
+# --------------------------------------------------------------------------
+if test(?e, PROJ.test.file) or not PROJ.test.files.to_a.empty?
+require 'autotest'
+
+namespace :test do
+  task :autotest do
+    Autotest.run
+  end
+end
+
+desc "Run the autotest loop"
+task :autotest => 'test:autotest'
+
+end  # if test
+
+# --------------------------------------------------------------------------
+if HAVE_SPEC_RAKE_SPECTASK and not PROJ.spec.files.to_a.empty?
+require 'autotest/rspec'
+
+namespace :spec do
+  task :autotest do
+    load '.autotest' if test(?f, '.autotest')
+    Autotest::Rspec.run
+  end
+end
+
+desc "Run the autotest loop"
+task :autotest => 'spec:autotest'
+
+end  # if rspec
+
+end  # if HAVE_ZENTEST
+
+# EOF

metadata

@@ -0,0 +1,154 @@
+--- !ruby/object:Gem::Specification 
+name: sinotify
+version: !ruby/object:Gem::Version 
+  version: 0.0.2
+platform: ruby
+authors: 
+- Steven Swerling
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-10-11 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: cosell
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: bones
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.5.1
+    version: 
+description: |-
+  ALPHA Alert -- just uploaded initial release. 
+  
+  Linux inotify is a means to receive events describing file system activity (create, modify, delete, close, etc). 
+  
+  Sinotify was derived from aredridel's package (http://raa.ruby-lang.org/project/ruby-inotify/), with the addition of
+  Paul Boon's tweak for making the event_check thread more polite (see
+  http://www.mindbucket.com/2009/02/24/ruby-daemons-verifying-good-behavior/)
+  
+  In sinotify, the classes Sinotify::PrimNotifier and Sinotify::PrimEvent provide a low level wrapper to inotify, with
+  the ability to establish 'watches' and then listen for inotify events using one of inotify's synchronous event loops,
+  and providing access to the events' masks (see 'man inotify' for details). Sinotify::PrimEvent class adds a little semantic sugar
+  to the event in to the form of 'etypes', which are just ruby symbols that describe the event mask. If the event has a
+  raw mask of (DELETE_SELF & IS_DIR), then the etypes array would be [:delete_self, :is_dir]. 
+  
+  In addition to the 'straight' wrapper in inotify, sinotify provides an asynchronous implementation of the 'observer
+  pattern' for notification. In other words, Sinotify::Notifier listens in the background for inotify events, adapting
+  them into instances of Sinotify::Event as they come in and immediately placing them in a concurrent queue, from which
+  they are 'announced' to 'subscribers' of the event.  [Sinotify uses the 'cosell' implementation of the Announcements
+  event notification framework, hence the terminology 'subscribe' and 'announce' rather then 'listen' and 'trigger' used
+  in the standard event observer pattern. See the 'cosell' package on github for details.]
+  
+  A variety of 'knobs' are provided for controlling the behavior of the notifier: whether a watch should apply to a
+  single directory or should recurse into subdirectores, how fast it should broadcast queued events, etc (see
+  Sinotify::Notifier, and the example in the synopsis section below). An event 'spy' can also be setup to log all
+  Sinotify::PrimEvents and Sinotify::Events.
+  
+  Sinotify::Event simplifies inotify's muddled event model, sending events only for those files/directories that have
+  changed. That's not to say you can't setup a notifier that recurses into subdirectories, just that any individual
+  event will apply to a single file, and not to its children. Also, event types are identified using words (in the form
+  of ruby :symbols) instead of inotify's event masks. See Sinotify::Event for more explanation. 
+  
+  The README for inotify:
+  
+    http://www.kernel.org/pub/linux/kernel/people/rml/inotify/README
+  
+  Selected quotes from the README for inotify:
+  
+    * "Rumor is that the 'd' in 'dnotify' does not stand for 'directory' but for 'suck.'"
+  
+    * "The 'i' in inotify does not stand for 'suck' but for 'inode' -- the logical
+      choice since inotify is inode-based."
+    
+  (The 's' in 'sinotify' does in fact stand for 'suck.')
+email: sswerling@yahoo.com
+executables: []
+
+extensions: 
+- ext/extconf.rb
+extra_rdoc_files: 
+- History.txt
+- README.txt
+files: 
+- .gitignore
+- History.txt
+- README.rdoc
+- README.txt
+- Rakefile
+- TODO
+- examples/watcher.rb
+- ext/extconf.rb
+- ext/src/inotify-syscalls.h
+- ext/src/inotify.h
+- ext/src/sinotify.c
+- lib/sinotify.rb
+- lib/sinotify/event.rb
+- lib/sinotify/notifier.rb
+- lib/sinotify/prim_event.rb
+- lib/sinotify/watch.rb
+- lib/sinotify_info.rb
+- sinotify.gemspec
+- spec/prim_notify_spec.rb
+- spec/sinotify_spec.rb
+- spec/spec_helper.rb
+- tasks/ann.rake
+- tasks/bones.rake
+- tasks/gem.rake
+- tasks/git.rake
+- tasks/notes.rake
+- tasks/post_load.rake
+- tasks/rdoc.rake
+- tasks/rubyforge.rake
+- tasks/setup.rb
+- tasks/spec.rake
+- tasks/svn.rake
+- tasks/test.rake
+- tasks/zentest.rake
+has_rdoc: true
+homepage: http://tab-a.slot-z.net
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --inline-source
+- --main
+- README.txt
+require_paths: 
+- lib
+- ext
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: sinotify
+rubygems_version: 1.3.2
+signing_key: 
+specification_version: 3
+summary: ALPHA Alert -- just uploaded initial release
+test_files: []
+