timers 4.3.5 → 4.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e7c61c9db77955d85c69ca83499add3629c71628af3a825d78978b2383182b4a
-  data.tar.gz: 27f570753d83d4b4a98ee6ede089908d571347df8ba411edb56fe4ae965e703c
+  metadata.gz: '07298120c1d45f17c3494b356f3a7415da25406804f33d58fa8f2cfe430ca1c1'
+  data.tar.gz: '09d40256b9e64b66fcee87a2e8222f062a0fd600b3845ba9e0675e21c09e323c'
 SHA512:
-  metadata.gz: a7bac196cc0e3e1a784f7ba961c4a09539c875f80ac366da0b0d091d9f6ad1a505fb0a86a0c9d61d44a3495342029d003749b3ac072904b37f667d8e6e90b356
-  data.tar.gz: 4fa05113f72aef3abe63804a097e7fd9322c5b84a2a9ad14d590906e3ca59754857378a085388c52f9eb7ef1beb934b6b75789c3c087eee0b900f3446ace7207
+  metadata.gz: bd660f745409c852fa6756983cb460e58143bda880332230669e9f49bdb197b7ea5593563f5526ee0d36c56f1aa89673afe14df27f0eda58f1c7a8fadd9b8947
+  data.tar.gz: ff2f6672fa7a6d8c561cd0933bd796b406d98fbc0250600abc4a04779be917f3ddf1205795b0b6455bde09d89ae224c25f3b37349cef5fbdf810ea6a9ec650d9

data/lib/timers/group.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2014-2022, by Samuel Williams.
+# Copyright, 2014-2025, by Samuel Williams.
 # Copyright, 2014-2016, by Tony Arcieri.
 # Copyright, 2015, by Donovan Keme.
 # Copyright, 2015, by Tommy Ong Gia Phu.
@@ -92,8 +92,9 @@ module Timers
 		# -   0: timers ready to fire
 		# - +ve: timers waiting to fire
 		def wait_interval(offset = current_offset)
-			handle = @events.first
-			handle.time - Float(offset) if handle
+			if handle = @events.first
+				handle.time - Float(offset)
+			end
 		end
 		
 		# Fire all timers that are ready.

data/lib/timers/priority_heap.rb

@@ -2,7 +2,7 @@
 
 # Released under the MIT License.
 # Copyright, 2021, by Wander Hillen.
-# Copyright, 2021-2022, by Samuel Williams.
+# Copyright, 2021-2025, by Samuel Williams.
 
 module Timers
 	# A priority queue implementation using a standard binary minheap. It uses straight comparison
@@ -84,9 +84,10 @@ module Timers
 
 		private
 		
-		def swap(i, j)
-			@contents[i], @contents[j] = @contents[j], @contents[i]
-		end
+		# Left here for reference, but unused.
+		# def swap(i, j)
+		# 	@contents[i], @contents[j] = @contents[j], @contents[i]
+		# end
 		
 		def bubble_up(index)
 			parent_index = (index - 1) / 2 # watch out, integer division!

data/lib/timers/timer.rb

@@ -1,11 +1,12 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2014-2022, by Samuel Williams.
+# Copyright, 2014-2025, by Samuel Williams.
 # Copyright, 2014-2017, by Tony Arcieri.
 # Copyright, 2014, by Utenmiki.
 # Copyright, 2014, by Lin Jen-Shin.
 # Copyright, 2017, by Vít Ondruch.
+# Copyright, 2025, by Patrik Wenger.
 
 module Timers
 	# An individual timer set to fire a given proc at a given time. A timer is
@@ -23,12 +24,11 @@ module Timers
 			@interval = interval
 			@recurring = recurring
 			@block = block
-			@offset = offset
-			
+			@offset = nil
 			@handle = nil
 			
 			# If a start offset was supplied, use that, otherwise use the current timers offset.
-			reset(@offset || @group.current_offset)
+			reset(offset || @group.current_offset)
 		end
 		
 		def paused?
@@ -73,7 +73,7 @@ module Timers
 			@handle = nil
 			
 			# This timer is no longer valid:
-			@group.timers.delete self if @group
+			@group.timers.delete(self) if @group
 		end
 		
 		# Reset this timer. Do not call while paused.
@@ -103,9 +103,9 @@ module Timers
 				@offset = offset
 			end
 			
-			@block.call(offset, self)
-			
+			result = @block.call(offset, self)
 			cancel unless recurring
+			result
 		end
 		
 		alias call fire
@@ -117,18 +117,18 @@ module Timers
 		
 		# Inspect a timer
 		def inspect
-			buffer = "#{to_s[0..-2]} ".dup
+			buffer = to_s[0..-2]
 			
 			if @offset
-				if fires_in >= 0
-					buffer << "fires in #{fires_in} seconds"
+				delta_offset = @offset - @group.current_offset
+				
+				if delta_offset > 0
+					buffer << " fires in #{delta_offset} seconds"
 				else
-					buffer << "fired #{fires_in.abs} seconds ago"
+					buffer << " fired #{delta_offset.abs} seconds ago"
 				end
 				
 				buffer << ", recurs every #{interval}" if recurring
-			else
-				buffer << "dead"
 			end
 			
 			buffer << ">"

data/lib/timers/version.rb

@@ -6,5 +6,5 @@
 # Copyright, 2015, by Donovan Keme.
 
 module Timers
-	VERSION = "4.3.5"
+	VERSION = "4.4.0"
 end

data/lib/timers/wait.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2014-2022, by Samuel Williams.
+# Copyright, 2014-2025, by Samuel Williams.
 # Copyright, 2014-2016, by Tony Arcieri.
 # Copyright, 2015, by Utenmiki.
 # Copyright, 2015, by Donovan Keme.
@@ -17,6 +17,7 @@ module Timers
 				
 				timeout.while_time_remaining(&block)
 			else
+				# If there is no "duration" to wait for, we wait forever.
 				loop do
 					yield(nil)
 				end

data/license.md

@@ -12,7 +12,7 @@ Copyright, 2013-2015, by Utenmiki.
 Copyright, 2013, by Jeremy Hinegardner.  
 Copyright, 2014, by Larry Lv.  
 Copyright, 2014, by Bruno Enten.  
-Copyright, 2014-2022, by Samuel Williams.  
+Copyright, 2014-2025, by Samuel Williams.  
 Copyright, 2014, by Mike Bourgeous.  
 Copyright, 2014, by Klaus Trainer.  
 Copyright, 2014, by Lin Jen-Shin.  
@@ -20,14 +20,15 @@ Copyright, 2014, by Lavir the Whiolet.
 Copyright, 2015-2016, by Donovan Keme.  
 Copyright, 2015, by Tommy Ong Gia Phu.  
 Copyright, 2015, by Will Jessop.  
-Copyright, 2016, by Ryunosuke SATO.  
+Copyright, 2016, by Ryunosuke Sato.  
 Copyright, 2016, by Atul Bhosale.  
-Copyright, 2016, by Feram.  
 Copyright, 2017, by Vít Ondruch.  
 Copyright, 2017-2020, by Olle Jonsson.  
 Copyright, 2020, by Tim Smith.  
 Copyright, 2021, by Wander Hillen.  
 Copyright, 2022, by Yoshiki Takagi.  
+Copyright, 2023, by Peter Goldstein.  
+Copyright, 2025, by Patrik Wenger.  
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/readme.md

@@ -103,8 +103,18 @@ timers.resume
 
 ## Contributing
 
-1.  Fork it
-2.  Create your feature branch (`git checkout -b my-new-feature`)
-3.  Commit your changes (`git commit -am 'Add some feature'`)
-4.  Push to the branch (`git push origin my-new-feature`)
-5.  Create new Pull Request
+We welcome contributions to this project.
+
+1.  Fork it.
+2.  Create your feature branch (`git checkout -b my-new-feature`).
+3.  Commit your changes (`git commit -am 'Add some feature'`).
+4.  Push to the branch (`git push origin my-new-feature`).
+5.  Create new Pull Request.
+
+### Developer Certificate of Origin
+
+In order to protect users of this project, we require all contributors to comply with the [Developer Certificate of Origin](https://developercertificate.org/). This ensures that all contributions are properly licensed and attributed.
+
+### Community Guidelines
+
+This project is best served by a collaborative and respectful environment. Treat each other professionally, respect differing viewpoints, and engage constructively. Harassment, discrimination, or harmful behavior is not tolerated. Communicate clearly, listen actively, and support one another. If any issues arise, please inform the project maintainers.

metadata

@@ -1,41 +1,38 @@
 --- !ruby/object:Gem::Specification
 name: timers
 version: !ruby/object:Gem::Version
-  version: 4.3.5
+  version: 4.4.0
 platform: ruby
 authors:
 - Tony Arcieri
 - Samuel Williams
-- "//de"
+- Donovan Keme
 - Wander Hillen
+- Utenmiki
 - Jeremy Hinegardner
-- skinnyjames
+- Sean Gregory
 - Chuck Remes
-- utenmiki
 - Olle Jonsson
-- deadprogrammer
-- takiy33
+- Ron Evans
+- Tommy Ong Gia Phu
 - Larry Lv
 - Lin Jen-Shin
-- Ryunosuke SATO
-- Tommy Ong Gia Phu
+- Ryunosuke Sato
 - Atul Bhosale
 - Bruno Enten
 - Dimitrij Denissenko
-- Donovan Keme
-- Feram
 - Jesse Cooke
 - Klaus Trainer
 - Lavir the Whiolet
 - Mike Bourgeous
+- Nicholas Evans
+- Patrik Wenger
+- Peter Goldstein
 - Ryan LeCompte
 - Tim Smith
 - Vít Ondruch
 - Will Jessop
 - Yoshiki Takagi
-- nicholas a. evans
-- tommyogp
-autorequire:
 bindir: bin
 cert_chain:
 - |
@@ -67,80 +64,8 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2022-10-12 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: covered
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: bake-test
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.1'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.1'
-- !ruby/object:Gem::Dependency
-  name: bake-test-external
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.2'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.2'
-- !ruby/object:Gem::Dependency
-  name: sus
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.13'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.13'
-description:
-email:
+date: 2025-02-07 00:00:00.000000000 Z
+dependencies: []
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -158,8 +83,8 @@ files:
 homepage: https://github.com/socketry/timers
 licenses:
 - MIT
-metadata: {}
-post_install_message:
+metadata:
+  source_code_uri: https://github.com/socketry/timers.git
 rdoc_options: []
 require_paths:
 - lib
@@ -167,15 +92,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Pure Ruby one-shot and periodic timers.
 test_files: []