win32-taskscheduler 1.0.12 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5b6d6ad467e4dd3518af4776d1937f9227afbc42bf743c3f3b09480141e08e15
-  data.tar.gz: 2a3a9d694c22b5734e30c50fe50142af6b23e6d467c8e38e33ee48bba3a15952
+  metadata.gz: 90e586400ec6f09917fb684fb99037a5bd2c332995ecb72c43b37222ce9e2a61
+  data.tar.gz: 7a081a2f498d932400424d87885a89d2f58126366f6d51d6a361d97a215c18c6
 SHA512:
-  metadata.gz: e5ca12f5424d5f790107a1af5ff8838e7931d846cdece3959627c0500a34ff2bcdae1fa749f253a89f4b523065ca27b15f1e629dc11ad586a990854cfbcb2a83
-  data.tar.gz: c423125d42002ae09d4bc1fab148004a325e399cbdeb5bb48fb6210f1f3f5af510a4ecd9f0345fd8ec1e4291905c214d2e8d58eb261cd5b7e791d2b3c59c9c49
+  metadata.gz: 4fffce988d9274141c58c5cfce948ac86ff9b03396313f2721ce7bea08c6daf3a118be23418a2b56c7cfa58628db4e7e3943c0fe011b2b7da343007f80c9a7d0
+  data.tar.gz: 7a282afc6a6be4a3cefd6258ee33257221e2d397c327f07329b1972178165c64df0ef89b3c408c951db7375a85a5afea4a0ad63895f3a449036f18b94db13ae4

data/CHANGELOG.md

@@ -4,27 +4,33 @@ Note: this log contains only changes from win32-taskscheduler release 0.4.0 and
 -- it does not contain the changes from prior releases. To view change history
 prior to release 0.4.0, please visit the [source repository](https://github.com/chef/win32-taskscheduler/commits).
 
-<!-- latest_release 1.0.12 -->
-## [win32-taskscheduler-1.0.12](https://github.com/chef/win32-taskscheduler/tree/win32-taskscheduler-1.0.12) (2018-10-11)
+<!-- latest_release unreleased -->
+## Unreleased
 
 #### Merged Pull Requests
-- Fixing user registration at Non English version of windows [#69](https://github.com/chef/win32-taskscheduler/pull/69) ([Nimesh-Msys](https://github.com/Nimesh-Msys))
+- Bump version to 2.0 [#71](https://github.com/chef/win32-taskscheduler/pull/71) ([btm](https://github.com/btm))
 <!-- latest_release -->
 
-<!-- release_rollup since=1.0.10 -->
-### Changes since 1.0.10 release
+<!-- release_rollup since=1.0.12 -->
+### Changes since 1.0.12 release
 
 #### Merged Pull Requests
-- Fixing user registration at Non English version of windows [#69](https://github.com/chef/win32-taskscheduler/pull/69) ([Nimesh-Msys](https://github.com/Nimesh-Msys)) <!-- 1.0.12 -->
-- Refactored configure_settings [#67](https://github.com/chef/win32-taskscheduler/pull/67) ([btm](https://github.com/btm)) <!-- 1.0.11 -->
+- Bump version to 2.0 [#71](https://github.com/chef/win32-taskscheduler/pull/71) ([btm](https://github.com/btm)) <!-- 2.0.0 -->
+- Move helpers under the Win32::TaskScheduler namespace [#70](https://github.com/chef/win32-taskscheduler/pull/70) ([btm](https://github.com/btm)) <!-- 1.0.13 -->
 <!-- release_rollup -->
 
 <!-- latest_stable_release -->
+## [win32-taskscheduler-1.0.12](https://github.com/chef/win32-taskscheduler/tree/win32-taskscheduler-1.0.12) (2018-10-11)
+
+#### Merged Pull Requests
+- Refactored configure_settings [#67](https://github.com/chef/win32-taskscheduler/pull/67) ([btm](https://github.com/btm))
+- Fixing user registration at Non English version of windows [#69](https://github.com/chef/win32-taskscheduler/pull/69) ([Nimesh-Msys](https://github.com/Nimesh-Msys))
+<!-- latest_stable_release -->
+
 ## [win32-taskscheduler-1.0.10](https://github.com/chef/win32-taskscheduler/tree/win32-taskscheduler-1.0.10) (2018-07-24)
 
 #### Merged Pull Requests
 - Fix exists? method breaking task full path search [#62](https://github.com/chef/win32-taskscheduler/pull/62) ([Vasu1105](https://github.com/Vasu1105))
-<!-- latest_stable_release -->
 
 ## [win32-taskscheduler-1.0.9](https://github.com/chef/win32-taskscheduler/tree/win32-taskscheduler-1.0.9) (2018-07-23)
 

data/VERSION

@@ -1 +1,2 @@
-1.0.12
+2.0.0
+

data/lib/win32/taskscheduler.rb

@@ -1,6 +1,7 @@
-require_relative 'windows/helper'
-require_relative 'windows/time_calc_helper'
-require_relative 'windows/constants'
+require_relative 'taskscheduler/sid'
+require_relative 'taskscheduler/helper'
+require_relative 'taskscheduler/time_calc_helper'
+require_relative 'taskscheduler/constants'
 require_relative 'taskscheduler/version'
 require 'win32ole'
 require 'socket'
@@ -12,9 +13,10 @@ module Win32
 
   # The TaskScheduler class encapsulates a Windows scheduled task
   class TaskScheduler
-    include Windows::TaskSchedulerHelper
-    include Windows::TimeCalcHelper
-    include Windows::TaskSchedulerConstants
+    include Win32::TaskScheduler::Helper
+    include Win32::TaskScheduler::TaskSchedulerConstants
+    include Win32::TaskScheduler::TimeCalcHelper
+    include Win32::TaskScheduler::SID
 
     # The Error class is typically raised if any TaskScheduler methods fail.
     class Error < StandardError; end

data/lib/win32/taskscheduler/constants.rb

@@ -0,0 +1,266 @@
+require_relative 'sid'
+
+module Win32
+  class TaskScheduler
+    module TaskSchedulerConstants
+      SERVICE_ACCOUNT_USERS = SID::SERVICE_ACCOUNT_USERS
+
+      BUILT_IN_GROUPS = SID::BUILT_IN_GROUPS
+
+      SYSTEM_USERS = SERVICE_ACCOUNT_USERS + BUILT_IN_GROUPS
+
+      # Triggers
+
+      # Trigger is set to run the task a single time
+      TASK_TIME_TRIGGER_ONCE = 1
+
+      # Trigger is set to run the task on a daily interval
+      TASK_TIME_TRIGGER_DAILY = 2
+
+      # Trigger is set to run the task on specific days of a specific week & month
+      TASK_TIME_TRIGGER_WEEKLY = 3
+
+      # Trigger is set to run the task on specific day(s) of the month
+      TASK_TIME_TRIGGER_MONTHLYDATE = 4
+
+      # Trigger is set to run the task on specific day(s) of the month
+      TASK_TIME_TRIGGER_MONTHLYDOW = 5
+
+      # Trigger is set to run the task if the system remains idle for the amount
+      # of time specified by the idle wait time of the task
+      TASK_EVENT_TRIGGER_ON_IDLE = 6
+
+      TASK_TRIGGER_REGISTRATION = 7
+
+      # Trigger is set to run the task at system startup
+      TASK_EVENT_TRIGGER_AT_SYSTEMSTART = 8
+
+      # Trigger is set to run the task when a user logs on
+      TASK_EVENT_TRIGGER_AT_LOGON = 9
+
+      TASK_TRIGGER_SESSION_STATE_CHANGE = 11
+
+      # Daily Tasks
+
+      # The task will run on Sunday
+      TASK_SUNDAY = 0x1
+
+      # The task will run on Monday
+      TASK_MONDAY = 0x2
+
+      # The task will run on Tuesday
+      TASK_TUESDAY = 0x4
+
+      # The task will run on Wednesday
+      TASK_WEDNESDAY = 0x8
+
+      # The task will run on Thursday
+      TASK_THURSDAY = 0x10
+
+      # The task will run on Friday
+      TASK_FRIDAY = 0x20
+
+      # The task will run on Saturday
+      TASK_SATURDAY = 0x40
+
+      # Weekly tasks
+
+      # The task will run between the 1st and 7th day of the month
+      TASK_FIRST_WEEK = 0x01
+
+      # The task will run between the 8th and 14th day of the month
+      TASK_SECOND_WEEK = 0x02
+
+      # The task will run between the 15th and 21st day of the month
+      TASK_THIRD_WEEK = 0x04
+
+      # The task will run between the 22nd and 28th day of the month
+      TASK_FOURTH_WEEK = 0x08
+
+      # The task will run the last seven days of the month
+      TASK_LAST_WEEK = 0x10
+
+      # Monthly tasks
+
+      # The task will run in January
+      TASK_JANUARY = 0x1
+
+      # The task will run in February
+      TASK_FEBRUARY = 0x2
+
+      # The task will run in March
+      TASK_MARCH = 0x4
+
+      # The task will run in April
+      TASK_APRIL = 0x8
+
+      # The task will run in May
+      TASK_MAY = 0x10
+
+      # The task will run in June
+      TASK_JUNE = 0x20
+
+      # The task will run in July
+      TASK_JULY = 0x40
+
+      # The task will run in August
+      TASK_AUGUST = 0x80
+
+      # The task will run in September
+      TASK_SEPTEMBER = 0x100
+
+      # The task will run in October
+      TASK_OCTOBER = 0x200
+
+      # The task will run in November
+      TASK_NOVEMBER = 0x400
+
+      # The task will run in December
+      TASK_DECEMBER = 0x800
+
+      # Flags
+
+      # Used when converting AT service jobs into work items
+      TASK_FLAG_INTERACTIVE = 0x1
+
+      # The work item will be deleted when there are no more scheduled run times
+      TASK_FLAG_DELETE_WHEN_DONE = 0x2
+
+      # The work item is disabled. Useful for temporarily disabling a task
+      TASK_FLAG_DISABLED = 0x4
+
+      # The work item begins only if the computer is not in use at the scheduled
+      # start time
+      TASK_FLAG_START_ONLY_IF_IDLE = 0x10
+
+      # The work item terminates if the computer makes an idle to non-idle
+      # transition while the work item is running
+      TASK_FLAG_KILL_ON_IDLE_END = 0x20
+
+      # The work item does not start if the computer is running on battery power
+      TASK_FLAG_DONT_START_IF_ON_BATTERIES = 0x40
+
+      # The work item ends, and the associated application quits, if the computer
+      # switches to battery power
+      TASK_FLAG_KILL_IF_GOING_ON_BATTERIES = 0x80
+
+      # The work item starts only if the computer is in a docking station
+      TASK_FLAG_RUN_ONLY_IF_DOCKED = 0x100
+
+      # The work item created will be hidden
+      TASK_FLAG_HIDDEN = 0x200
+
+      # The work item runs only if there is a valid internet connection
+      TASK_FLAG_RUN_IF_CONNECTED_TO_INTERNET = 0x400
+
+      # The work item starts again if the computer makes a non-idle to idle
+      # transition
+      TASK_FLAG_RESTART_ON_IDLE_RESUME = 0x800
+
+      # The work item causes the system to be resumed, or awakened, if the
+      # system is running on batter power
+      TASK_FLAG_SYSTEM_REQUIRED = 0x1000
+
+      # The work item runs only if a specified account is logged on interactively
+      TASK_FLAG_RUN_ONLY_IF_LOGGED_ON = 0x2000
+
+      # Triggers
+
+      # The task will stop at some point in time
+      TASK_TRIGGER_FLAG_HAS_END_DATE = 0x1
+
+      # The task can be stopped at the end of the repetition period
+      TASK_TRIGGER_FLAG_KILL_AT_DURATION_END = 0x2
+
+      # The task trigger is disabled
+      TASK_TRIGGER_FLAG_DISABLED = 0x4
+
+      # Run Level Types
+      # Tasks will be run with the least privileges
+      TASK_RUNLEVEL_LUA      = 0
+      # Tasks will be run with the highest privileges
+      TASK_RUNLEVEL_HIGHEST  = 1
+
+      # Logon Types
+      # Used for non-NT credentials
+      TASK_LOGON_NONE                           = 0
+      # Use a password for logging on the user
+      TASK_LOGON_PASSWORD                       = 1
+      # The service will log the user on using Service For User
+      TASK_LOGON_S4U                            = 2
+      # Task will be run only in an existing interactive session
+      TASK_LOGON_INTERACTIVE_TOKEN              = 3
+      # Group activation. The groupId field specifies the group
+      TASK_LOGON_GROUP                          = 4
+      # When Local System, Local Service, or Network Service account is
+      # being used as a security context to run the task
+      TASK_LOGON_SERVICE_ACCOUNT                = 5
+      # Not in use; currently identical to TASK_LOGON_PASSWORD
+      TASK_LOGON_INTERACTIVE_TOKEN_OR_PASSWORD  = 6
+
+      TASK_MAX_RUN_TIMES = 1440
+      TASKS_TO_RETRIEVE  = 5
+
+      # Task creation
+
+      TASK_VALIDATE_ONLY = 0x1
+      TASK_CREATE = 0x2
+      TASK_UPDATE = 0x4
+      TASK_CREATE_OR_UPDATE = 0x6
+      TASK_DISABLE = 0x8
+      TASK_DONT_ADD_PRINCIPAL_ACE = 0x10
+      TASK_IGNORE_REGISTRATION_TRIGGERS = 0x20
+
+      # Priority classes
+
+      REALTIME_PRIORITY_CLASS     = 0
+      HIGH_PRIORITY_CLASS         = 1
+      ABOVE_NORMAL_PRIORITY_CLASS = 2 # Or 3
+      NORMAL_PRIORITY_CLASS       = 4 # Or 5, 6
+      BELOW_NORMAL_PRIORITY_CLASS = 7 # Or 8
+      IDLE_PRIORITY_CLASS         = 9 # Or 10
+
+      CLSCTX_INPROC_SERVER = 0x1
+      CLSID_CTask = [0x148BD520, 0xA2AB, 0x11CE, 0xB1, 0x1F, 0x00, 0xAA, 0x00, 0x53, 0x05, 0x03].pack('LSSC8')
+      CLSID_CTaskScheduler = [0x148BD52A, 0xA2AB, 0x11CE, 0xB1, 0x1F, 0x00, 0xAA, 0x00, 0x53, 0x05, 0x03].pack('LSSC8')
+      IID_ITaskScheduler = [0x148BD527, 0xA2AB, 0x11CE, 0xB1, 0x1F, 0x00, 0xAA, 0x00, 0x53, 0x05, 0x03].pack('LSSC8')
+      IID_ITask = [0x148BD524, 0xA2AB, 0x11CE, 0xB1, 0x1F, 0x00, 0xAA, 0x00, 0x53, 0x05, 0x03].pack('LSSC8')
+      IID_IPersistFile = [0x0000010b, 0x0000, 0x0000, 0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46].pack('LSSC8')
+
+      # Days of month
+
+      TASK_FIRST = 0x01
+      TASK_SECOND = 0x02
+      TASK_THIRD = 0x04
+      TASK_FOURTH = 0x08
+      TASK_FIFTH = 0x10
+      TASK_SIXTH = 0x20
+      TASK_SEVENTH = 0x40
+      TASK_EIGHTH = 0x80
+      TASK_NINETH = 0x100
+      TASK_TENTH = 0x200
+      TASK_ELEVENTH = 0x400
+      TASK_TWELFTH = 0x800
+      TASK_THIRTEENTH = 0x1000
+      TASK_FOURTEENTH = 0x2000
+      TASK_FIFTEENTH = 0x4000
+      TASK_SIXTEENTH = 0x8000
+      TASK_SEVENTEENTH = 0x10000
+      TASK_EIGHTEENTH = 0x20000
+      TASK_NINETEENTH = 0x40000
+      TASK_TWENTIETH = 0x80000
+      TASK_TWENTY_FIRST = 0x100000
+      TASK_TWENTY_SECOND = 0x200000
+      TASK_TWENTY_THIRD = 0x400000
+      TASK_TWENTY_FOURTH = 0x800000
+      TASK_TWENTY_FIFTH = 0x1000000
+      TASK_TWENTY_SIXTH = 0x2000000
+      TASK_TWENTY_SEVENTH = 0x4000000
+      TASK_TWENTY_EIGHTH = 0x8000000
+      TASK_TWENTY_NINTH = 0x10000000
+      TASK_THIRTYETH = 0x20000000
+      TASK_THIRTY_FIRST = 0x40000000
+      TASK_LAST = 0x80000000
+    end
+  end
+end

data/lib/win32/taskscheduler/helper.rb

@@ -0,0 +1,51 @@
+require 'ffi'
+
+module Win32
+  class TaskScheduler
+    module Helper
+      extend FFI::Library
+
+      FORMAT_MESSAGE_IGNORE_INSERTS = 0x00000200
+      FORMAT_MESSAGE_FROM_SYSTEM    = 0x00001000
+      FORMAT_MESSAGE_MAX_WIDTH_MASK = 0x000000FF
+
+      ffi_lib :kernel32, :advapi32
+
+      attach_function :FormatMessage, :FormatMessageA,
+      [:ulong, :pointer, :ulong, :ulong, :pointer, :ulong, :pointer], :ulong
+
+      attach_function :ConvertStringSidToSidW, [ :pointer, :pointer ], :bool
+      attach_function :LookupAccountSidW, [ :pointer, :pointer, :pointer, :pointer, :pointer, :pointer, :pointer ], :bool
+      attach_function :LocalFree, [ :pointer ], :pointer
+
+      def win_error(function, err=FFI.errno)
+        err_msg = ''
+        flags = FORMAT_MESSAGE_IGNORE_INSERTS |
+          FORMAT_MESSAGE_FROM_SYSTEM |
+          FORMAT_MESSAGE_MAX_WIDTH_MASK
+
+        # 0x0409 == MAKELANGID(LANG_ENGLISH, SUBLANG_ENGLISH_US)
+        # We use English for errors because Ruby uses English for errors.
+
+        FFI::MemoryPointer.new(:char, 1024) do |buf|
+          len = FormatMessage(flags, nil, err , 0x0409, buf, buf.size, nil)
+          err_msg = function + ': ' + buf.read_string(len).strip
+        end
+
+        err_msg
+      end
+
+      def ole_error(function, err)
+        regex = /OLE error code:(.*?)\sin/
+        match = regex.match(err.to_s)
+
+        if match
+          error = match.captures.first.hex
+          win_error(function, error)
+        else
+          "#{function}: #{err.to_s}"
+        end
+      end
+    end
+  end
+end

data/lib/win32/taskscheduler/sid.rb

@@ -0,0 +1,132 @@
+require_relative 'helper'
+
+module FFI
+  class Pointer
+    def read_wstring(num_wchars = nil)
+      if num_wchars.nil?
+        # Find the length of the string
+        length = 0
+        last_char = nil
+        while last_char != "\000\000"
+          length += 1
+          last_char = get_bytes(0, length * 2)[-2..-1]
+        end
+
+        num_wchars = length
+      end
+
+      wide_to_utf8(get_bytes(0, num_wchars * 2))
+    end
+
+    def wide_to_utf8(wstring)
+      # ensure it is actually UTF-16LE
+      # Ruby likes to mark binary data as ASCII-8BIT
+      wstring = wstring.force_encoding('UTF-16LE')
+
+      # encode it all as UTF-8 and remove trailing CRLF and NULL characters
+      wstring.encode('UTF-8').strip
+    end
+  end
+end
+
+module Win32
+  class TaskScheduler
+    module SID
+      extend Win32::TaskScheduler::Helper
+      ERROR_INSUFFICIENT_BUFFER = 122
+
+      def self.LocalSystem
+        from_string_sid('S-1-5-18')
+      end
+
+      def self.NtLocal
+        from_string_sid('S-1-5-19')
+      end
+
+      def self.NtNetwork
+        from_string_sid('S-1-5-20')
+      end
+
+      def self.BuiltinAdministrators
+        from_string_sid('S-1-5-32-544')
+      end
+
+      def self.BuiltinUsers
+        from_string_sid('S-1-5-32-545')
+      end
+
+      def self.Guests
+        from_string_sid('S-1-5-32-546')
+      end
+
+      # Converts a string-format security identifier (SID) into a valid, functional SID
+      # and returns a hash with account_name and account_simple_name
+      # @see https://docs.microsoft.com/en-us/windows/desktop/api/sddl/nf-sddl-convertstringsidtosidw
+      #
+      def self.from_string_sid(string_sid)
+        result = FFI::MemoryPointer.new :pointer
+        unless ConvertStringSidToSidW(utf8_to_wide(string_sid), result)
+          raise FFI::LastError.error
+        end
+        result_pointer = result.read_pointer
+        domain, name, use = account(result_pointer)
+        LocalFree(result_pointer)
+        account_names(domain, name, use)
+      end
+
+      def self.utf8_to_wide(ustring)
+        # ensure it is actually UTF-8
+        # Ruby likes to mark binary data as ASCII-8BIT
+        ustring = (ustring + '').force_encoding('UTF-8')
+
+        # ensure we have the double-null termination Windows Wide likes
+        ustring += "\000\000" if ustring.empty? || ustring[-1].chr != "\000"
+
+        # encode it all as UTF-16LE AKA Windows Wide Character AKA Windows Unicode
+        ustring.encode('UTF-16LE')
+      end
+
+      # Accepts a security identifier (SID) as input.
+      # It retrieves the name of the account for this SID and the name of the
+      # first domain on which this SID is found
+      # @see https://docs.microsoft.com/en-us/windows/desktop/api/winbase/nf-winbase-lookupaccountsidw
+      #
+      def self.account(sid)
+        sid = sid.pointer if sid.respond_to?(:pointer)
+        name_size = FFI::Buffer.new(:long).write_long(0)
+        referenced_domain_name_size = FFI::Buffer.new(:long).write_long(0)
+
+        if LookupAccountSidW(nil, sid, nil, name_size, nil, referenced_domain_name_size, nil)
+          raise 'Expected ERROR_INSUFFICIENT_BUFFER from LookupAccountSid, and got no error!'
+        elsif FFI::LastError.error != ERROR_INSUFFICIENT_BUFFER
+          raise FFI::LastError.error
+        end
+
+        name = FFI::MemoryPointer.new :char, (name_size.read_long * 2)
+        referenced_domain_name = FFI::MemoryPointer.new :char, (referenced_domain_name_size.read_long * 2)
+        use = FFI::Buffer.new(:long).write_long(0)
+        unless LookupAccountSidW(nil, sid, name, name_size, referenced_domain_name, referenced_domain_name_size, use)
+          raise FFI::LastError.error
+        end
+        [referenced_domain_name.read_wstring(referenced_domain_name_size.read_long), name.read_wstring(name_size.read_long), use.read_long]
+      end
+
+      # Formats domain, name and returns a hash with
+      # account_name and account_simple_name
+      #
+      def self.account_names(domain, name, _use)
+        account_name = !domain.to_s.empty? ? "#{domain}\\#{name}" : name
+        account_simple_name = name
+        { account_name: account_name, account_simple_name: account_simple_name }
+      end
+
+      SERVICE_ACCOUNT_USERS = [self.LocalSystem, self.NtLocal, self.NtNetwork].map do |user|
+        [user[:account_simple_name].upcase, user[:account_name].upcase]
+      end.flatten.freeze
+
+      BUILT_IN_GROUPS = [self.BuiltinAdministrators, self.BuiltinUsers, self.Guests].map do |user|
+        [user[:account_simple_name].upcase, user[:account_name].upcase]
+      end.flatten.freeze
+    end
+  end
+end

data/lib/win32/taskscheduler/time_calc_helper.rb

@@ -0,0 +1,132 @@
+module Win32
+  class TaskScheduler
+    module TimeCalcHelper
+
+      # Returns actual no of days for given month;
+      # Array with a 0 is defined to give actual result without
+      # any manipulation. eg, DAYS_IN_A_MONTH[1] = 31
+      # 0(NUMBER) is kept to avoid exceptions during calculations
+      DAYS_IN_A_MONTH = [0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]
+
+      # Returns no of days in a given month of a year
+      def days_in_month(month, year)
+        (month == 2 && is_leap_year?(year)) ? 29 : DAYS_IN_A_MONTH[month]
+      end
+
+      # Year is leap when it is a multiple of 4 and not a multiple of 100.
+      # But it can be a multiple of 400
+      def is_leap_year?(year)
+        (((year % 4).zero? && !(year % 100).zero?) || (year % 400).zero?)
+      end
+
+      # Returns total time duration in minutes
+      def time_in_minutes(time_str)
+        time_in_seconds(time_str) / 60
+      end
+
+      # Calculates total time duration in seconds
+      def time_in_seconds(time_str)
+        dt_tm_hash = time_details(time_str)
+        curr_time = Time.now
+
+        # Basic time variables
+        future_year = curr_time.year + dt_tm_hash[:year].to_i
+        future_month = curr_time.month + dt_tm_hash[:month].to_i
+        future_day = curr_time.day + dt_tm_hash[:day].to_i
+        future_hr = curr_time.hour + dt_tm_hash[:hour].to_i
+        future_min = curr_time.min + dt_tm_hash[:min].to_i
+        future_sec = curr_time.sec + dt_tm_hash[:sec].to_i
+
+        # 'extra value' calculations for these time variables
+        future_sec, future_min = extra_time(future_sec, future_min, 60)
+        future_min, future_hr = extra_time(future_min, future_hr, 60)
+        future_hr, future_day = extra_time(future_hr, future_day, 24)
+
+        # explicit method to calculate overloaded days;
+        # They may stretch upto years; heance leap year & months are into consideration
+        future_day, future_month, future_year = extra_days(future_day, future_month, future_year, curr_time.month, curr_time.year)
+
+        future_month, future_year = extra_months(future_month, future_year, curr_time.month, curr_time.year)
+
+        future_time = Time.new(future_year, future_month, future_day, future_hr, future_min, future_sec)
+
+        # Difference in time will return seconds
+        future_time.to_i - curr_time.to_i
+      end
+
+      # a will contain extra value of low_rank (in high_rank(eg min));
+      # b will hold actual low_rank value(ie sec) Example:
+      # low_rank = 65, high_rank = 2, div_val = 60
+      # Hence a = 1; b = 5
+      def extra_time(low_rank, high_rank, div_val)
+        a, b = low_rank.divmod(div_val)
+        high_rank += a; low_rank = b
+        [low_rank, high_rank]
+      end
+
+      def extra_months(month_count, year_count, init_month, init_year)
+        year, month_count = month_count.divmod(12)
+        if year.positive? && month_count.zero?
+          month_count = 12
+          year -= 1
+        end
+        year_count += year
+        [month_count, year_count]
+      end
+
+      # Returns no of actual days with all overloaded months & Years
+      def extra_days(days_count, month_count, year_count, init_month, init_year)
+        # Will keep increamenting them with surplus days
+        days = days_count
+        mth = init_month
+        yr = init_year
+
+        loop do
+         days -= days_in_month(mth, yr)
+         break if days <= 0
+         mth += 1
+         if mth > 12
+           mth = 1; yr += 1
+         end
+         days_count = days
+        end
+
+        # Setting actual incremented values
+        month_count += (mth - init_month)
+        year_count += (yr - init_year)
+
+        [days_count, month_count, year_count]
+      end
+
+      # Extracts "P_Y_M_DT_H_M_S" format and
+      # Returns a hash with applicable values of
+      # (keys =>) [:year, :month, :day, :hour, :min, :sec]
+      # Example: "PT3S" => {sec: 3}
+      def time_details(time_str)
+        tm_detail = {}
+        if time_str.to_s != ''
+          # time_str will be like "PxxYxxMxxDTxxHxxMxxS"
+          # Ignoring 'P' and extracting date and time
+          dt, tm = time_str[1..-1].split('T')
+
+          # Replacing strings
+          if dt.to_s != ''
+            dt['Y'] = 'year' if dt['Y']; dt['M'] = 'month' if dt['M']; dt['D'] = 'day' if dt['D']
+            dt_tm_array_to_hash(dt, tm_detail)
+          end
+
+          if tm.to_s != ''
+            tm['H'] = 'hour' if tm['H']; tm['M'] = 'min' if tm['M']; tm['S'] = 'sec' if tm['S']
+            dt_tm_array_to_hash(tm, tm_detail)
+          end
+        end
+        tm_detail
+      end
+
+      # Method to convert date/time array to hash
+      def dt_tm_array_to_hash(arr, tm_detail)
+        arr.split(/(\d+)/)[1..-1].each_slice(2).inject(tm_detail) { |h, i| h[i.last.to_sym] = i.first; h }
+      end
+    end
+  end
+end

data/lib/win32/taskscheduler/version.rb

@@ -1,6 +1,6 @@
 module Win32
   class TaskScheduler
     # The version of the win32-taskscheduler library
-    VERSION = '1.0.12'.freeze
+    VERSION = '2.0.0'.freeze
   end
 end

data/spec/functional/win32/{windows → taskscheduler}/time_calc_helper_spec.rb

@@ -1,11 +1,11 @@
-require 'win32/windows/time_calc_helper'
+require 'win32/taskscheduler/time_calc_helper'
 require 'spec_helper'
 
-RSpec.describe Windows::TimeCalcHelper do
+RSpec.describe Win32::TaskScheduler::TimeCalcHelper do
   let(:object) { klass.new }
   let(:klass) do
     Class.new do
-      include Windows::TimeCalcHelper
+      include Win32::TaskScheduler::TimeCalcHelper
     end
   end
 

data/spec/unit/win32/{windows → taskscheduler}/constants_spec.rb

@@ -1,6 +1,6 @@
 require 'spec_helper'
 require 'win32/taskscheduler'
-require 'win32/windows/constants'
+require 'win32/taskscheduler/constants'
 
 RSpec.describe Win32::TaskScheduler, :windows_only do
   describe 'Ensuring trigger constants' do

data/spec/unit/win32/{windows → taskscheduler}/time_calc_helper_spec.rb

@@ -1,11 +1,11 @@
 require 'spec_helper'
-require 'win32/windows/time_calc_helper'
+require 'win32/taskscheduler/time_calc_helper'
 
-RSpec.describe Windows::TimeCalcHelper do
+RSpec.describe Win32::TaskScheduler::TimeCalcHelper do
   let(:object) { klass.new }
   let(:klass) do
     Class.new do
-      include Windows::TimeCalcHelper
+      include Win32::TaskScheduler::TimeCalcHelper
     end
   end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: win32-taskscheduler
 version: !ruby/object:Gem::Version
-  version: 1.0.12
+  version: 2.0.0
 platform: ruby
 authors:
 - Park Heesob
@@ -117,17 +117,17 @@ files:
 - examples/taskscheduler_example.rb
 - lib/win32-taskscheduler.rb
 - lib/win32/taskscheduler.rb
+- lib/win32/taskscheduler/constants.rb
+- lib/win32/taskscheduler/helper.rb
+- lib/win32/taskscheduler/sid.rb
+- lib/win32/taskscheduler/time_calc_helper.rb
 - lib/win32/taskscheduler/version.rb
-- lib/win32/windows/constants.rb
-- lib/win32/windows/helper.rb
-- lib/win32/windows/sid.rb
-- lib/win32/windows/time_calc_helper.rb
-- spec/functional/win32/taskschedular_spec.rb
-- spec/functional/win32/windows/time_calc_helper_spec.rb
+- spec/functional/win32/taskscheduler/time_calc_helper_spec.rb
+- spec/functional/win32/taskscheduler_spec.rb
 - spec/spec_helper.rb
-- spec/unit/win32/taskschedular_spec.rb
-- spec/unit/win32/windows/constants_spec.rb
-- spec/unit/win32/windows/time_calc_helper_spec.rb
+- spec/unit/win32/taskscheduler/constants_spec.rb
+- spec/unit/win32/taskscheduler/time_calc_helper_spec.rb
+- spec/unit/win32/taskscheduler_spec.rb
 - test/test_taskscheduler.rb
 - win32-taskscheduler.gemspec
 homepage: http://github.com/chef/win32-taskscheduler

data/lib/win32/windows/constants.rb

@@ -1,263 +0,0 @@
-require_relative 'sid'
-module Windows
-  module TaskSchedulerConstants
-    SERVICE_ACCOUNT_USERS = SID::SERVICE_ACCOUNT_USERS
-
-    BUILT_IN_GROUPS = SID::BUILT_IN_GROUPS
-
-    SYSTEM_USERS = SERVICE_ACCOUNT_USERS + BUILT_IN_GROUPS
-
-    # Triggers
-
-    # Trigger is set to run the task a single time
-    TASK_TIME_TRIGGER_ONCE = 1
-
-    # Trigger is set to run the task on a daily interval
-    TASK_TIME_TRIGGER_DAILY = 2
-
-    # Trigger is set to run the task on specific days of a specific week & month
-    TASK_TIME_TRIGGER_WEEKLY = 3
-
-    # Trigger is set to run the task on specific day(s) of the month
-    TASK_TIME_TRIGGER_MONTHLYDATE = 4
-
-    # Trigger is set to run the task on specific day(s) of the month
-    TASK_TIME_TRIGGER_MONTHLYDOW = 5
-
-    # Trigger is set to run the task if the system remains idle for the amount
-    # of time specified by the idle wait time of the task
-    TASK_EVENT_TRIGGER_ON_IDLE = 6
-
-    TASK_TRIGGER_REGISTRATION = 7
-
-    # Trigger is set to run the task at system startup
-    TASK_EVENT_TRIGGER_AT_SYSTEMSTART = 8
-
-    # Trigger is set to run the task when a user logs on
-    TASK_EVENT_TRIGGER_AT_LOGON = 9
-
-    TASK_TRIGGER_SESSION_STATE_CHANGE = 11
-
-    # Daily Tasks
-
-    # The task will run on Sunday
-    TASK_SUNDAY = 0x1
-
-    # The task will run on Monday
-    TASK_MONDAY = 0x2
-
-    # The task will run on Tuesday
-    TASK_TUESDAY = 0x4
-
-    # The task will run on Wednesday
-    TASK_WEDNESDAY = 0x8
-
-    # The task will run on Thursday
-    TASK_THURSDAY = 0x10
-
-    # The task will run on Friday
-    TASK_FRIDAY = 0x20
-
-    # The task will run on Saturday
-    TASK_SATURDAY = 0x40
-
-    # Weekly tasks
-
-    # The task will run between the 1st and 7th day of the month
-    TASK_FIRST_WEEK = 0x01
-
-    # The task will run between the 8th and 14th day of the month
-    TASK_SECOND_WEEK = 0x02
-
-    # The task will run between the 15th and 21st day of the month
-    TASK_THIRD_WEEK = 0x04
-
-    # The task will run between the 22nd and 28th day of the month
-    TASK_FOURTH_WEEK = 0x08
-
-    # The task will run the last seven days of the month
-    TASK_LAST_WEEK = 0x10
-
-    # Monthly tasks
-
-    # The task will run in January
-    TASK_JANUARY = 0x1
-
-    # The task will run in February
-    TASK_FEBRUARY = 0x2
-
-    # The task will run in March
-    TASK_MARCH = 0x4
-
-    # The task will run in April
-    TASK_APRIL = 0x8
-
-    # The task will run in May
-    TASK_MAY = 0x10
-
-    # The task will run in June
-    TASK_JUNE = 0x20
-
-    # The task will run in July
-    TASK_JULY = 0x40
-
-    # The task will run in August
-    TASK_AUGUST = 0x80
-
-    # The task will run in September
-    TASK_SEPTEMBER = 0x100
-
-    # The task will run in October
-    TASK_OCTOBER = 0x200
-
-    # The task will run in November
-    TASK_NOVEMBER = 0x400
-
-    # The task will run in December
-    TASK_DECEMBER = 0x800
-
-    # Flags
-
-    # Used when converting AT service jobs into work items
-    TASK_FLAG_INTERACTIVE = 0x1
-
-    # The work item will be deleted when there are no more scheduled run times
-    TASK_FLAG_DELETE_WHEN_DONE = 0x2
-
-    # The work item is disabled. Useful for temporarily disabling a task
-    TASK_FLAG_DISABLED = 0x4
-
-    # The work item begins only if the computer is not in use at the scheduled
-    # start time
-    TASK_FLAG_START_ONLY_IF_IDLE = 0x10
-
-    # The work item terminates if the computer makes an idle to non-idle
-    # transition while the work item is running
-    TASK_FLAG_KILL_ON_IDLE_END = 0x20
-
-    # The work item does not start if the computer is running on battery power
-    TASK_FLAG_DONT_START_IF_ON_BATTERIES = 0x40
-
-    # The work item ends, and the associated application quits, if the computer
-    # switches to battery power
-    TASK_FLAG_KILL_IF_GOING_ON_BATTERIES = 0x80
-
-    # The work item starts only if the computer is in a docking station
-    TASK_FLAG_RUN_ONLY_IF_DOCKED = 0x100
-
-    # The work item created will be hidden
-    TASK_FLAG_HIDDEN = 0x200
-
-    # The work item runs only if there is a valid internet connection
-    TASK_FLAG_RUN_IF_CONNECTED_TO_INTERNET = 0x400
-
-    # The work item starts again if the computer makes a non-idle to idle
-    # transition
-    TASK_FLAG_RESTART_ON_IDLE_RESUME = 0x800
-
-    # The work item causes the system to be resumed, or awakened, if the
-    # system is running on batter power
-    TASK_FLAG_SYSTEM_REQUIRED = 0x1000
-
-    # The work item runs only if a specified account is logged on interactively
-    TASK_FLAG_RUN_ONLY_IF_LOGGED_ON = 0x2000
-
-    # Triggers
-
-    # The task will stop at some point in time
-    TASK_TRIGGER_FLAG_HAS_END_DATE = 0x1
-
-    # The task can be stopped at the end of the repetition period
-    TASK_TRIGGER_FLAG_KILL_AT_DURATION_END = 0x2
-
-    # The task trigger is disabled
-    TASK_TRIGGER_FLAG_DISABLED = 0x4
-
-    # Run Level Types
-    # Tasks will be run with the least privileges
-    TASK_RUNLEVEL_LUA      = 0
-    # Tasks will be run with the highest privileges
-    TASK_RUNLEVEL_HIGHEST  = 1
-
-    # Logon Types
-    # Used for non-NT credentials
-    TASK_LOGON_NONE                           = 0
-    # Use a password for logging on the user
-    TASK_LOGON_PASSWORD                       = 1
-    # The service will log the user on using Service For User
-    TASK_LOGON_S4U                            = 2
-    # Task will be run only in an existing interactive session
-    TASK_LOGON_INTERACTIVE_TOKEN              = 3
-    # Group activation. The groupId field specifies the group
-    TASK_LOGON_GROUP                          = 4
-    # When Local System, Local Service, or Network Service account is
-    # being used as a security context to run the task
-    TASK_LOGON_SERVICE_ACCOUNT                = 5
-    # Not in use; currently identical to TASK_LOGON_PASSWORD
-    TASK_LOGON_INTERACTIVE_TOKEN_OR_PASSWORD  = 6
-
-    TASK_MAX_RUN_TIMES = 1440
-    TASKS_TO_RETRIEVE  = 5
-
-    # Task creation
-
-    TASK_VALIDATE_ONLY = 0x1
-    TASK_CREATE = 0x2
-    TASK_UPDATE = 0x4
-    TASK_CREATE_OR_UPDATE = 0x6
-    TASK_DISABLE = 0x8
-    TASK_DONT_ADD_PRINCIPAL_ACE = 0x10
-    TASK_IGNORE_REGISTRATION_TRIGGERS = 0x20
-
-    # Priority classes
-
-    REALTIME_PRIORITY_CLASS     = 0
-    HIGH_PRIORITY_CLASS         = 1
-    ABOVE_NORMAL_PRIORITY_CLASS = 2 # Or 3
-    NORMAL_PRIORITY_CLASS       = 4 # Or 5, 6
-    BELOW_NORMAL_PRIORITY_CLASS = 7 # Or 8
-    IDLE_PRIORITY_CLASS         = 9 # Or 10
-
-    CLSCTX_INPROC_SERVER = 0x1
-    CLSID_CTask = [0x148BD520, 0xA2AB, 0x11CE, 0xB1, 0x1F, 0x00, 0xAA, 0x00, 0x53, 0x05, 0x03].pack('LSSC8')
-    CLSID_CTaskScheduler = [0x148BD52A, 0xA2AB, 0x11CE, 0xB1, 0x1F, 0x00, 0xAA, 0x00, 0x53, 0x05, 0x03].pack('LSSC8')
-    IID_ITaskScheduler = [0x148BD527, 0xA2AB, 0x11CE, 0xB1, 0x1F, 0x00, 0xAA, 0x00, 0x53, 0x05, 0x03].pack('LSSC8')
-    IID_ITask = [0x148BD524, 0xA2AB, 0x11CE, 0xB1, 0x1F, 0x00, 0xAA, 0x00, 0x53, 0x05, 0x03].pack('LSSC8')
-    IID_IPersistFile = [0x0000010b, 0x0000, 0x0000, 0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46].pack('LSSC8')
-
-    # Days of month
-
-    TASK_FIRST = 0x01
-    TASK_SECOND = 0x02
-    TASK_THIRD = 0x04
-    TASK_FOURTH = 0x08
-    TASK_FIFTH = 0x10
-    TASK_SIXTH = 0x20
-    TASK_SEVENTH = 0x40
-    TASK_EIGHTH = 0x80
-    TASK_NINETH = 0x100
-    TASK_TENTH = 0x200
-    TASK_ELEVENTH = 0x400
-    TASK_TWELFTH = 0x800
-    TASK_THIRTEENTH = 0x1000
-    TASK_FOURTEENTH = 0x2000
-    TASK_FIFTEENTH = 0x4000
-    TASK_SIXTEENTH = 0x8000
-    TASK_SEVENTEENTH = 0x10000
-    TASK_EIGHTEENTH = 0x20000
-    TASK_NINETEENTH = 0x40000
-    TASK_TWENTIETH = 0x80000
-    TASK_TWENTY_FIRST = 0x100000
-    TASK_TWENTY_SECOND = 0x200000
-    TASK_TWENTY_THIRD = 0x400000
-    TASK_TWENTY_FOURTH = 0x800000
-    TASK_TWENTY_FIFTH = 0x1000000
-    TASK_TWENTY_SIXTH = 0x2000000
-    TASK_TWENTY_SEVENTH = 0x4000000
-    TASK_TWENTY_EIGHTH = 0x8000000
-    TASK_TWENTY_NINTH = 0x10000000
-    TASK_THIRTYETH = 0x20000000
-    TASK_THIRTY_FIRST = 0x40000000
-    TASK_LAST = 0x80000000
-  end
-end

data/lib/win32/windows/helper.rb

@@ -1,49 +0,0 @@
-require 'ffi'
-
-module Windows
-  module TaskSchedulerHelper
-    extend FFI::Library
-
-    FORMAT_MESSAGE_IGNORE_INSERTS = 0x00000200
-    FORMAT_MESSAGE_FROM_SYSTEM    = 0x00001000
-    FORMAT_MESSAGE_MAX_WIDTH_MASK = 0x000000FF
-
-    ffi_lib :kernel32, :advapi32
-
-    attach_function :FormatMessage, :FormatMessageA,
-    [:ulong, :pointer, :ulong, :ulong, :pointer, :ulong, :pointer], :ulong
-
-    attach_function :ConvertStringSidToSidW, [ :pointer, :pointer ], :bool
-    attach_function :LookupAccountSidW, [ :pointer, :pointer, :pointer, :pointer, :pointer, :pointer, :pointer ], :bool
-    attach_function :LocalFree, [ :pointer ], :pointer
-
-    def win_error(function, err=FFI.errno)
-      err_msg = ''
-      flags = FORMAT_MESSAGE_IGNORE_INSERTS |
-        FORMAT_MESSAGE_FROM_SYSTEM |
-        FORMAT_MESSAGE_MAX_WIDTH_MASK
-
-      # 0x0409 == MAKELANGID(LANG_ENGLISH, SUBLANG_ENGLISH_US)
-      # We use English for errors because Ruby uses English for errors.
-
-      FFI::MemoryPointer.new(:char, 1024) do |buf|
-        len = FormatMessage(flags, nil, err , 0x0409, buf, buf.size, nil)
-        err_msg = function + ': ' + buf.read_string(len).strip
-      end
-
-      err_msg
-    end
-
-    def ole_error(function, err)
-      regex = /OLE error code:(.*?)\sin/
-      match = regex.match(err.to_s)
-
-      if match
-        error = match.captures.first.hex
-        win_error(function, error)
-      else
-        "#{function}: #{err.to_s}"
-      end
-    end
-  end
-end

data/lib/win32/windows/sid.rb

@@ -1,128 +0,0 @@
-require_relative 'helper'
-
-module FFI
-  class Pointer
-    def read_wstring(num_wchars = nil)
-      if num_wchars.nil?
-        # Find the length of the string
-        length = 0
-        last_char = nil
-        while last_char != "\000\000"
-          length += 1
-          last_char = get_bytes(0, length * 2)[-2..-1]
-        end
-
-        num_wchars = length
-      end
-
-      wide_to_utf8(get_bytes(0, num_wchars * 2))
-    end
-
-    def wide_to_utf8(wstring)
-      # ensure it is actually UTF-16LE
-      # Ruby likes to mark binary data as ASCII-8BIT
-      wstring = wstring.force_encoding('UTF-16LE')
-
-      # encode it all as UTF-8 and remove trailing CRLF and NULL characters
-      wstring.encode('UTF-8').strip
-    end
-  end
-end
-
-class SID
-  extend Windows::TaskSchedulerHelper
-  ERROR_INSUFFICIENT_BUFFER = 122
-
-  def self.LocalSystem
-    from_string_sid('S-1-5-18')
-  end
-
-  def self.NtLocal
-    from_string_sid('S-1-5-19')
-  end
-
-  def self.NtNetwork
-    from_string_sid('S-1-5-20')
-  end
-
-  def self.BuiltinAdministrators
-    from_string_sid('S-1-5-32-544')
-  end
-
-  def self.BuiltinUsers
-    from_string_sid('S-1-5-32-545')
-  end
-
-  def self.Guests
-    from_string_sid('S-1-5-32-546')
-  end
-
-  # Converts a string-format security identifier (SID) into a valid, functional SID
-  # and returns a hash with account_name and account_simple_name
-  # @see https://docs.microsoft.com/en-us/windows/desktop/api/sddl/nf-sddl-convertstringsidtosidw
-  #
-  def self.from_string_sid(string_sid)
-    result = FFI::MemoryPointer.new :pointer
-    unless ConvertStringSidToSidW(utf8_to_wide(string_sid), result)
-      raise FFI::LastError.error
-    end
-    result_pointer = result.read_pointer
-    domain, name, use = account(result_pointer)
-    LocalFree(result_pointer)
-    account_names(domain, name, use)
-  end
-
-  def self.utf8_to_wide(ustring)
-    # ensure it is actually UTF-8
-    # Ruby likes to mark binary data as ASCII-8BIT
-    ustring = (ustring + '').force_encoding('UTF-8')
-
-    # ensure we have the double-null termination Windows Wide likes
-    ustring += "\000\000" if ustring.empty? || ustring[-1].chr != "\000"
-
-    # encode it all as UTF-16LE AKA Windows Wide Character AKA Windows Unicode
-    ustring.encode('UTF-16LE')
-  end
-
-  # Accepts a security identifier (SID) as input.
-  # It retrieves the name of the account for this SID and the name of the
-  # first domain on which this SID is found
-  # @see https://docs.microsoft.com/en-us/windows/desktop/api/winbase/nf-winbase-lookupaccountsidw
-  #
-  def self.account(sid)
-    sid = sid.pointer if sid.respond_to?(:pointer)
-    name_size = FFI::Buffer.new(:long).write_long(0)
-    referenced_domain_name_size = FFI::Buffer.new(:long).write_long(0)
-
-    if LookupAccountSidW(nil, sid, nil, name_size, nil, referenced_domain_name_size, nil)
-      raise 'Expected ERROR_INSUFFICIENT_BUFFER from LookupAccountSid, and got no error!'
-    elsif FFI::LastError.error != ERROR_INSUFFICIENT_BUFFER
-      raise FFI::LastError.error
-    end
-
-    name = FFI::MemoryPointer.new :char, (name_size.read_long * 2)
-    referenced_domain_name = FFI::MemoryPointer.new :char, (referenced_domain_name_size.read_long * 2)
-    use = FFI::Buffer.new(:long).write_long(0)
-    unless LookupAccountSidW(nil, sid, name, name_size, referenced_domain_name, referenced_domain_name_size, use)
-      raise FFI::LastError.error
-    end
-    [referenced_domain_name.read_wstring(referenced_domain_name_size.read_long), name.read_wstring(name_size.read_long), use.read_long]
-  end
-
-  # Formats domain, name and returns a hash with
-  # account_name and account_simple_name
-  #
-  def self.account_names(domain, name, _use)
-    account_name = !domain.to_s.empty? ? "#{domain}\\#{name}" : name
-    account_simple_name = name
-    { account_name: account_name, account_simple_name: account_simple_name }
-  end
-
-  SERVICE_ACCOUNT_USERS = [self.LocalSystem, self.NtLocal, self.NtNetwork].map do |user|
-    [user[:account_simple_name].upcase, user[:account_name].upcase]
-  end.flatten.freeze
-
-  BUILT_IN_GROUPS = [self.BuiltinAdministrators, self.BuiltinUsers, self.Guests].map do |user|
-    [user[:account_simple_name].upcase, user[:account_name].upcase]
-  end.flatten.freeze
-end

data/lib/win32/windows/time_calc_helper.rb

@@ -1,130 +0,0 @@
-module Windows
-  module TimeCalcHelper
-
-    # Returns actual no of days for given month;
-    # Array with a 0 is defined to give actual result without
-    # any manipulation. eg, DAYS_IN_A_MONTH[1] = 31
-    # 0(NUMBER) is kept to avoid exceptions during calculations
-    DAYS_IN_A_MONTH = [0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]
-
-    # Returns no of days in a given month of a year
-    def days_in_month(month, year)
-      (month == 2 && is_leap_year?(year)) ? 29 : DAYS_IN_A_MONTH[month]
-    end
-
-    # Year is leap when it is a multiple of 4 and not a multiple of 100.
-    # But it can be a multiple of 400
-    def is_leap_year?(year)
-      (((year % 4).zero? && !(year % 100).zero?) || (year % 400).zero?)
-    end
-
-    # Returns total time duration in minutes
-    def time_in_minutes(time_str)
-      time_in_seconds(time_str) / 60
-    end
-
-    # Calculates total time duration in seconds
-    def time_in_seconds(time_str)
-      dt_tm_hash = time_details(time_str)
-      curr_time = Time.now
-
-      # Basic time variables
-      future_year = curr_time.year + dt_tm_hash[:year].to_i
-      future_month = curr_time.month + dt_tm_hash[:month].to_i
-      future_day = curr_time.day + dt_tm_hash[:day].to_i
-      future_hr = curr_time.hour + dt_tm_hash[:hour].to_i
-      future_min = curr_time.min + dt_tm_hash[:min].to_i
-      future_sec = curr_time.sec + dt_tm_hash[:sec].to_i
-
-      # 'extra value' calculations for these time variables
-      future_sec, future_min = extra_time(future_sec, future_min, 60)
-      future_min, future_hr = extra_time(future_min, future_hr, 60)
-      future_hr, future_day = extra_time(future_hr, future_day, 24)
-
-      # explicit method to calculate overloaded days;
-      # They may stretch upto years; heance leap year & months are into consideration
-      future_day, future_month, future_year = extra_days(future_day, future_month, future_year, curr_time.month, curr_time.year)
-
-      future_month, future_year = extra_months(future_month, future_year, curr_time.month, curr_time.year)
-
-      future_time = Time.new(future_year, future_month, future_day, future_hr, future_min, future_sec)
-
-      # Difference in time will return seconds
-      future_time.to_i - curr_time.to_i
-    end
-
-    # a will contain extra value of low_rank (in high_rank(eg min));
-    # b will hold actual low_rank value(ie sec) Example:
-    # low_rank = 65, high_rank = 2, div_val = 60
-    # Hence a = 1; b = 5
-    def extra_time(low_rank, high_rank, div_val)
-      a, b = low_rank.divmod(div_val)
-      high_rank += a; low_rank = b
-      [low_rank, high_rank]
-    end
-
-    def extra_months(month_count, year_count, init_month, init_year)
-      year, month_count = month_count.divmod(12)
-      if year.positive? && month_count.zero?
-        month_count = 12
-        year -= 1
-      end
-      year_count += year
-      [month_count, year_count]
-    end
-
-    # Returns no of actual days with all overloaded months & Years
-    def extra_days(days_count, month_count, year_count, init_month, init_year)
-      # Will keep increamenting them with surplus days
-      days = days_count
-      mth = init_month
-      yr = init_year
-
-      loop do
-       days -= days_in_month(mth, yr)
-       break if days <= 0
-       mth += 1
-       if mth > 12
-         mth = 1; yr += 1
-       end
-       days_count = days
-      end
-
-      # Setting actual incremented values
-      month_count += (mth - init_month)
-      year_count += (yr - init_year)
-
-      [days_count, month_count, year_count]
-    end
-
-    # Extracts "P_Y_M_DT_H_M_S" format and
-    # Returns a hash with applicable values of
-    # (keys =>) [:year, :month, :day, :hour, :min, :sec]
-    # Example: "PT3S" => {sec: 3}
-    def time_details(time_str)
-      tm_detail = {}
-      if time_str.to_s != ''
-        # time_str will be like "PxxYxxMxxDTxxHxxMxxS"
-        # Ignoring 'P' and extracting date and time
-        dt, tm = time_str[1..-1].split('T')
-
-        # Replacing strings
-        if dt.to_s != ''
-          dt['Y'] = 'year' if dt['Y']; dt['M'] = 'month' if dt['M']; dt['D'] = 'day' if dt['D']
-          dt_tm_array_to_hash(dt, tm_detail)
-        end
-
-        if tm.to_s != ''
-          tm['H'] = 'hour' if tm['H']; tm['M'] = 'min' if tm['M']; tm['S'] = 'sec' if tm['S']
-          dt_tm_array_to_hash(tm, tm_detail)
-        end
-      end
-      tm_detail
-    end
-
-    # Method to convert date/time array to hash
-    def dt_tm_array_to_hash(arr, tm_detail)
-      arr.split(/(\d+)/)[1..-1].each_slice(2).inject(tm_detail) { |h, i| h[i.last.to_sym] = i.first; h }
-    end
-  end
-end