win32-taskscheduler 0.3.1 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 73d17d442fa2fa10b337a907dd0c2831b722cf56
-  data.tar.gz: 60051a6eb63417dce9a9dd9e2428b32e6afc21c1
+  metadata.gz: b74ccd6aa98c21f9e0a7bdd20c24e09f7e461450
+  data.tar.gz: a0742bc2c56d80f282a1e5cd37fb1b809e0c3e70
 SHA512:
-  metadata.gz: 0b84db2f85f3703e0f60f435d77736100169b20bbc5dd43dcd3ee3a43c6869aa7f8db0bc8fcfc9fd934040e716fbad262e62b1c00b78290df512289a33459e18
-  data.tar.gz: 9dcbf5dfd9bca8b15f52741c913d602dacf31ae706c89dda1cb6e25362ca65d98434a8f0e172c33edfe1d8cc9bcce2a087ef5183bb7cf00b3edad1f36374df86
+  metadata.gz: eaa9bc605ad45fd60797cf46fb9d4083054ead60552c92e10546e4f2e83247cbf0b6c063c9716e7f729271b4b0f7410fc52cdb349e72b281efea287d5252d8fb
+  data.tar.gz: f338910febc7774ce538465684f39e4b6480eb5f5b78d769b56a2c89eb9a02e41d31ead7bba871c1138b09e138c929416dff779d29a2a005b9e3c3f7d589596e

data/CHANGES

@@ -1,93 +1,108 @@
-== 0.3.1 - 6-Jul-2014
-* Added FFI as a dependency. Thanks go to Maxime Lapointe for the spot.
-* Some updates to the win_error helper method. Thanks go to Ethan J. Brown
-  for the suggestions.
-
-== 0.3.0 - 15-Jan-2014
-* Rewritten to use Win32OLE instead of using wrapping the C API. Benefits
-  include working on Windows Vista or later, and working with JRuby.
-* Modified the constructor to accept 3rd and 4th arguments. These indicate
-  which folder to use, and whether or not to create it if it doesn't exist.
-* The TaskScheduler#save method is now no longer necessary. It is retained
-  for backwards compatibility, but will raise a deprecation warning. In this
-  version simply calling TaskScheduler#activate will implement the task.
-* Added support for the AT_SYSTEMSTART, AT_LOGON and ON_IDLE trigger types.
-* Now requires the structured_warnings gem.
-* Removed the doc directory and separate documentation file. Everything is
-  inlined now. There's still an example under the "examples" directory, too.
-* Added test-unit, rake, and win32-security as development dependencies.
-  These are needed for testing only.
-
-== 0.2.2 - 29-Feb-2012
-* Moved some include statements inside the TaskScheduler class to avoid
-  polluting Object. Thanks go to Josh Cooper for the spot and patch.
-* Minor formatting tweaks to silence 1.9 warnings.
-
-== 0.2.1 - 8-Oct-2011
-* Fixed a bug that would not allow task to run as SYSTEM. Thanks go to
-  Josh cooper for the spot and patch.
-* Fixed a bug in new_work_item that would cause it to crash if you tried
-  to create a work item that already existed. An error is now raised instead.
-  Thanks go to Pete Higgins for the spot.
-* The set_trigger and trigger= methods now internally transform and validate
-  the trigger hash in the same manner as new_work_item. Thanks again go to
-  Pete Higgins.
-* Cleaned up the repo. The C source files have been removed from the main
-  repository (and this gem). They are in a separate branch on github for
-  anyone who misses them.
-* Refactored the Rakefile, removing tasks related to the old C source files,
-  and added tasks for cleaning, building and installing a gem.
-* Updated the README file, eliminating references to anything that was only
-  related to the older C version.
-
-== 0.2.0 - 19-Jun-2009
-* Rewritten in pure Ruby!
-* The TaskScheduler::ONCE constant is now a valid trigger type. Thanks go to
-  Uri Iurgel for the spot and patch.
-* Added the TaskScheduler#exists? method.
-* Added the TaskScheduler#tasks alias for the TaskScheduler#enum method.
-* The TaskScheduler#new_work_item method now accepts symbols as well as
-  strings for hash keys, and ignores case. Also, the keys are now validated.
-* Renamed the example file and test file.
-* Added the 'example' Rake task.
-* Fixed some code in the README synopsis that was incorrect.
-
-== 0.1.0 - 11-May-2008
-* The TaskScheduler#save instance method now accepts an optional file name.
-* Most of the TaskScheduler setter methods now return the value specified
-  instead of true.
-* Removed the RUN_ONLY_IF_DOCKED and RUN_IF_CONNECTED_TO_INTERNET constants.
-  The MSDN docs say that they are unused.
-* Added more documentation. Much more rdoc friendly now.
-* Added many more tests.
-* Better type handling for bad arguments.
-* Added a Rakefile with tasks for building, installation and testing.
-* Added a gemspec.
-* Inlined the rdoc documentation.
-* Internal project reorganization and code cleanup.
-
-== 0.0.3 - 1-Mar-2005
-* Bug fix for the bitFieldToHumanDays() internal function.
-* Moved the 'examples' directory to the toplevel directory.
-* Made the CHANGES and README files rdoc friendly.
-* Minor updates to taskscheduler.h.
-
-== 0.0.2 - 04-Aug-2004
-* Now uses the newer allocation framework and replaced all instances of the
-  deprecated STR2CSTR() function with StringValuePtr().  This means that, as
-  of this release, Ruby 1.8.0 or later is required.
-* Modified the constructor to accept arguments.  This is just some sugar for
-  creating a new task item in one call instead of two.
-* The argument to trigger= now must be a hash.  The same goes for the 'type'
-  sub-hash.
-* Added the add_trigger() method.  Actually, the C code for this method was
-  already in place, I simply forgot to create a corresponding Ruby method
-  for it.
-* Removed the create_trigger() method.  This was really nothing more than an
-  alias for trigger=().  I got confused somehow.
-* Test suite modified and many more tests added.
-* Documentation updates, including docs for a couple of methods that I had
-  accidentally omitted previously.
-
-== 0.0.1 - 24-Apr-2004
-* Initial release
+== 0.3.2 - 18-Mar-2018
+* Use the block form for FFI::MemoryPointer in the error message helper
+  function. Thanks go to Ethan Brown for the suggestion.
+* Fixed a potential bug in the helper module, which was also renamed to
+  help prevent any name collisions.
+* Added the win32-taskscheduler.rb file for convenience.
+* Added the configure_settings method.
+* Added the configure_registration_info method.
+* Added the description and description= aliases for comments.
+* Added the author and author= aliases for creator.
+* Some internal cleanup, moving common code to private methods.
+* Rakefile now assumes Rubygems 2.0 or later for tasks.
+* Gemspec cleanup, updated home page, removed old rubyforge_project reference.
+* This gem is now signed.
+
+== 0.3.1 - 6-Jul-2014
+* Added FFI as a dependency. Thanks go to Maxime Lapointe for the spot.
+* Some updates to the win_error helper method. Thanks go to Ethan J. Brown
+  for the suggestions.
+
+== 0.3.0 - 15-Jan-2014
+* Rewritten to use Win32OLE instead of using wrapping the C API. Benefits
+  include working on Windows Vista or later, and working with JRuby.
+* Modified the constructor to accept 3rd and 4th arguments. These indicate
+  which folder to use, and whether or not to create it if it doesn't exist.
+* The TaskScheduler#save method is now no longer necessary. It is retained
+  for backwards compatibility, but will raise a deprecation warning. In this
+  version simply calling TaskScheduler#activate will implement the task.
+* Added support for the AT_SYSTEMSTART, AT_LOGON and ON_IDLE trigger types.
+* Now requires the structured_warnings gem.
+* Removed the doc directory and separate documentation file. Everything is
+  inlined now. There's still an example under the "examples" directory, too.
+* Added test-unit, rake, and win32-security as development dependencies.
+  These are needed for testing only.
+
+== 0.2.2 - 29-Feb-2012
+* Moved some include statements inside the TaskScheduler class to avoid
+  polluting Object. Thanks go to Josh Cooper for the spot and patch.
+* Minor formatting tweaks to silence 1.9 warnings.
+
+== 0.2.1 - 8-Oct-2011
+* Fixed a bug that would not allow task to run as SYSTEM. Thanks go to
+  Josh cooper for the spot and patch.
+* Fixed a bug in new_work_item that would cause it to crash if you tried
+  to create a work item that already existed. An error is now raised instead.
+  Thanks go to Pete Higgins for the spot.
+* The set_trigger and trigger= methods now internally transform and validate
+  the trigger hash in the same manner as new_work_item. Thanks again go to
+  Pete Higgins.
+* Cleaned up the repo. The C source files have been removed from the main
+  repository (and this gem). They are in a separate branch on github for
+  anyone who misses them.
+* Refactored the Rakefile, removing tasks related to the old C source files,
+  and added tasks for cleaning, building and installing a gem.
+* Updated the README file, eliminating references to anything that was only
+  related to the older C version.
+
+== 0.2.0 - 19-Jun-2009
+* Rewritten in pure Ruby!
+* The TaskScheduler::ONCE constant is now a valid trigger type. Thanks go to
+  Uri Iurgel for the spot and patch.
+* Added the TaskScheduler#exists? method.
+* Added the TaskScheduler#tasks alias for the TaskScheduler#enum method.
+* The TaskScheduler#new_work_item method now accepts symbols as well as
+  strings for hash keys, and ignores case. Also, the keys are now validated.
+* Renamed the example file and test file.
+* Added the 'example' Rake task.
+* Fixed some code in the README synopsis that was incorrect.
+
+== 0.1.0 - 11-May-2008
+* The TaskScheduler#save instance method now accepts an optional file name.
+* Most of the TaskScheduler setter methods now return the value specified
+  instead of true.
+* Removed the RUN_ONLY_IF_DOCKED and RUN_IF_CONNECTED_TO_INTERNET constants.
+  The MSDN docs say that they are unused.
+* Added more documentation. Much more rdoc friendly now.
+* Added many more tests.
+* Better type handling for bad arguments.
+* Added a Rakefile with tasks for building, installation and testing.
+* Added a gemspec.
+* Inlined the rdoc documentation.
+* Internal project reorganization and code cleanup.
+
+== 0.0.3 - 1-Mar-2005
+* Bug fix for the bitFieldToHumanDays() internal function.
+* Moved the 'examples' directory to the toplevel directory.
+* Made the CHANGES and README files rdoc friendly.
+* Minor updates to taskscheduler.h.
+
+== 0.0.2 - 04-Aug-2004
+* Now uses the newer allocation framework and replaced all instances of the
+  deprecated STR2CSTR() function with StringValuePtr().  This means that, as
+  of this release, Ruby 1.8.0 or later is required.
+* Modified the constructor to accept arguments.  This is just some sugar for
+  creating a new task item in one call instead of two.
+* The argument to trigger= now must be a hash.  The same goes for the 'type'
+  sub-hash.
+* Added the add_trigger() method.  Actually, the C code for this method was
+  already in place, I simply forgot to create a corresponding Ruby method
+  for it.
+* Removed the create_trigger() method.  This was really nothing more than an
+  alias for trigger=().  I got confused somehow.
+* Test suite modified and many more tests added.
+* Documentation updates, including docs for a couple of methods that I had
+  accidentally omitted previously.
+
+== 0.0.1 - 24-Apr-2004
+* Initial release

data/MANIFEST

@@ -1,9 +1,10 @@
-* CHANGES
-* MANIFEST
-* README
-* Rakefile
-* win32-taskscheduler.gemspec
-* lib/win32/taskscheduler.rb
-* lib/win32/windows/helper.rb
-* examples/taskscheduler_test.rb
-* test/test_taskscheduler.rb
+* CHANGES
+* MANIFEST
+* README
+* Rakefile
+* win32-taskscheduler.gemspec
+* lib/win32-taskscheduler.rb
+* lib/win32/taskscheduler.rb
+* lib/win32/windows/helper.rb
+* examples/taskscheduler_test.rb
+* test/test_taskscheduler.rb

data/README

@@ -1,68 +1,72 @@
-= Description
-  The win32-taskscheduler library is a Ruby interface to the MS Windows Task
-  Scheduler. It is analogous to the Unix cron daemon.
-
-= Installation
-  gem install win32-taskscheduler
-
-= Synopsis
-  require 'win32/taskscheduler'
-  include Win32
-
-  ts = TaskScheduler.new
-
-  # Create a trigger that starts on April 25, 2014 at 11:05 pm. The trigger
-  # will run on the first and last week of the month, on Monday and Friday,
-  # in the months of April and May.
-  #
-  trigger = {
-    :start_year   => 2014,
-    :start_month  => 4,
-    :start_day    => 25,
-    :start_hour   => 23,
-    :start_minute => 5,
-    :trigger_type => TaskScheduler::MONTHLYDOW,
-    :type => {
-      :weeks        => TaskScheduler::FIRST_WEEK | TaskScheduler::LAST_WEEK,
-      :days_of_week => TaskScheduler::MONDAY | TaskScheduler::FRIDAY,
-      :months       => TaskScheduler::APRIL | TaskScheduler::MAY
-    }
-  }
-
-  ts.new_work_item('my_notepad', trigger)
-  ts.application_name = 'notepad.exe'
-  ts.activate('my_notepad')
-
-= Documentation
-  If you installed this library as a gem then the documentation was built for
-  you and can be viewed if your gem server is running. There is also some
-  documentation on the github wiki page.
-
-= Acknowledgements
-  This library was modeled to some degree on the Win32::TaskScheduler Perl
-  module by Umberto Nicoletti. However, there are some differences. Please see
-  the documentation for details.
-
-= Warranty
-  This package is provided "as is" and without any express or
-  implied warranties, including, without limitation, the implied
-  warranties of merchantability and fitness for a particular purpose.
-   
-= Known Issues
-  In some cases JRuby appears to raise a native exception rather than a
-  Ruby exception on failure. This should be mostly harmless.
-
-  Please submit any bug reports to the project page at
-  http://github.com/djberg96/win32-taskscheduler or
-  http://www.rubyforge.org/projects/win32utils.
-
-= Copyright
-  (C) 2003-2014 Daniel J. Berger
-  All Rights Reserved
-
-= License
-  Artistic 2.0
-
-= Authors
-  Park Heesob
-  Daniel Berger
+= Description
+  The win32-taskscheduler library is a Ruby interface to the MS Windows Task
+  Scheduler. It is analogous to the Unix cron daemon.
+
+= Installation
+  gem install win32-taskscheduler
+
+= Synopsis
+  require 'win32/taskscheduler'
+  include Win32
+
+  ts = TaskScheduler.new
+
+  # Create a trigger that starts on April 25, 2014 at 11:05 pm. The trigger
+  # will run on the first and last week of the month, on Monday and Friday,
+  # in the months of April and May.
+  #
+  trigger = {
+    :start_year   => 2014,
+    :start_month  => 4,
+    :start_day    => 25,
+    :start_hour   => 23,
+    :start_minute => 5,
+    :trigger_type => TaskScheduler::MONTHLYDOW,
+    :type => {
+      :weeks        => TaskScheduler::FIRST_WEEK | TaskScheduler::LAST_WEEK,
+      :days_of_week => TaskScheduler::MONDAY | TaskScheduler::FRIDAY,
+      :months       => TaskScheduler::APRIL | TaskScheduler::MAY
+    }
+  }
+
+  ts.new_work_item('my_notepad', trigger)
+  ts.application_name = 'notepad.exe'
+  ts.activate('my_notepad')
+
+= Documentation
+  If you installed this library as a gem then the documentation was built for
+  you and can be viewed if your gem server is running. There is also some
+  documentation on the github wiki page.
+
+= Acknowledgements
+  This library was modeled to some degree on the Win32::TaskScheduler Perl
+  module by Umberto Nicoletti. However, there are some differences. Please see
+  the documentation for details.
+
+= Warranty
+  This package is provided "as is" and without any express or
+  implied warranties, including, without limitation, the implied
+  warranties of merchantability and fitness for a particular purpose.
+   
+= Known Issues
+  Some versions of Ruby have been known to segfault when attempting to create
+  a task. If this happens you will need to upgrade your version of Ruby. Or,
+  at least, your version of win32ole.
+  
+  In some cases JRuby appears to raise a native exception rather than a
+  Ruby exception on failure. This should be mostly harmless.
+
+  Please submit any bug reports to the project page at:
+
+  http://github.com/djberg96/win32-taskscheduler
+
+= Copyright
+  (C) 2003-2017 Daniel J. Berger
+  All Rights Reserved
+
+= License
+  Artistic 2.0
+
+= Authors
+  Park Heesob
+  Daniel Berger

data/Rakefile

@@ -1,37 +1,34 @@
-require 'rake'
-require 'rake/clean'
-require 'rake/testtask'
-
-CLEAN.include("**/*.gem", "**/*.rbc")
-
-namespace 'gem' do
-  desc 'Build the win32-taskscheduler gem'
-  task :create => [:clean] do
-    spec = eval(IO.read('win32-taskscheduler.gemspec'))
-    if Gem::VERSION < "2.0"
-      Gem::Builder.new(spec).build
-    else
-      require 'rubygems/package'
-      Gem::Package.build(spec)
-    end
-  end
-
-  desc 'Install the win32-taskscheduler library as a gem'
-  task :install => [:create] do
-    file = Dir['win32-taskscheduler*.gem'].first
-    sh "gem install -l #{file}"
-  end
-end
-
-desc 'Run the example code'
-task :example do
-  ruby '-Iib examples/taskscheduler_example.rb'
-end
-
-desc 'Run the test suite for the win32-taskscheduler library'
-Rake::TestTask.new do |t|
-  t.verbose = true
-  t.warning = true
-end
-
-task :default => :test
+require 'rake'
+require 'rake/clean'
+require 'rake/testtask'
+
+CLEAN.include("**/*.gem", "**/*.rbc")
+
+namespace 'gem' do
+  desc 'Build the win32-taskscheduler gem'
+  task :create => [:clean] do
+    require 'rubygems/package'
+    spec = eval(IO.read('win32-taskscheduler.gemspec'))
+    spec.signing_key = File.join(Dir.home, '.ssh', 'gem-private_key.pem')
+    Gem::Package.build(spec, true)
+  end
+
+  desc 'Install the win32-taskscheduler library as a gem'
+  task :install => [:create] do
+    file = Dir['win32-taskscheduler*.gem'].first
+    sh "gem install -l #{file}"
+  end
+end
+
+desc 'Run the example code'
+task :example do
+  ruby '-Iib examples/taskscheduler_example.rb'
+end
+
+desc 'Run the test suite for the win32-taskscheduler library'
+Rake::TestTask.new do |t|
+  t.verbose = true
+  t.warning = true
+end
+
+task :default => :test