pairing_heap 3.1.0 → 3.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0ab471c325e03585ad3544c864f4ea058e5a05cd2d196c6e77015c13780f74c1
-  data.tar.gz: e27b561d32e04e3e22360bbcca57eaeacedf960a49d331ae437d13ab8cbcf2f8
+  metadata.gz: 8389560b615ae5871d0adbae5a6b4e55554fa2df72e611e208a91352cdb3af28
+  data.tar.gz: 130e2d0daa895cf7921e18dd736552de22bf6ac23aab8bbdb0c6a33536c2d5e9
 SHA512:
-  metadata.gz: d90c55d1640a827df56dc753dc03e9c524f0f68da44071c75bef3f6065dfcddcd5fc4275d22061e7fbf468c2ebc9fc932b35eca7d0f40a7810a0e96778ca5238
-  data.tar.gz: 750813b4cd86ccafb76499a65b145620c78539a4cd4f0cb73b4a8217e2112b049ce87bc8a1ce4a7e83cd94a092e9ccd9bcba108bbb4f0f6a9f1f972bd3bd75de
+  metadata.gz: 6f2d1588a2de63ce23c96ee06af18983304798dd4d678e88e58a7ee09efafafe511adc8d33259ed17aee88fcba63726fa467fb6a79a7ce863dac25466137e4ec
+  data.tar.gz: e972e7c8cd380c9374870c5b9232c1c307f3c723ba7672007f66e843d837482dd5e983d683eba29ef4e24aeaed839b8ab5f78cc382a0d6731de0f2fd393e716e

data/.github/workflows/main.yml

@@ -7,11 +7,10 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, macos-latest]
-        # Due to https://github.com/actions/runner/issues/849, we have to use quotes for '3.0'
-        ruby: ['2.7', '3.0', '3.1', '3.2', '3.3', head, jruby, jruby-head, truffleruby, truffleruby-head]
+        ruby: ['3.3', '3.4', '3.5', '4.0', jruby, truffleruby]
     runs-on: ${{ matrix.os }}
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - name: Set up ruby
       uses: ruby/setup-ruby@v1
       with:

data/Gemfile.lock

@@ -1,82 +1,131 @@
 PATH
   remote: .
   specs:
-    pairing_heap (3.1.0)
+    pairing_heap (3.1.2)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    ast (2.4.2)
-    base64 (0.1.1)
-    docile (1.4.0)
-    json (2.6.3)
-    json (2.6.3-java)
-    language_server-protocol (3.17.0.3)
+    ast (2.4.3)
+    docile (1.4.1)
+    drb (2.2.3)
+    jar-dependencies (0.6.1-java)
+    json (2.21.2)
+    json (2.21.2-java)
+    language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
-    minitest (5.21.2)
-    parallel (1.23.0)
-    parser (3.2.2.3)
+    logger (1.7.0)
+    minitest (6.0.6)
+      drb (~> 2.0)
+      prism (~> 1.5)
+    parallel (1.27.0)
+    parser (3.3.10.0)
       ast (~> 2.4.1)
       racc
-    racc (1.7.1)
-    racc (1.7.1-java)
+    prism (1.9.0)
+    racc (1.8.1)
+    racc (1.8.1-java)
     rainbow (3.1.1)
-    rake (13.0.6)
-    regexp_parser (2.8.1)
-    rexml (3.2.6)
-    rubocop (1.56.3)
-      base64 (~> 0.1.1)
+    rake (13.3.1)
+    rbs (4.2.0)
+      logger
+      prism (>= 1.6.0)
+      tsort
+    rbs (4.2.0-java)
+      jar-dependencies (>= 0.1.7)
+      logger
+      prism (>= 1.6.0)
+      tsort
+    regexp_parser (2.11.3)
+    rubocop (1.87.0)
       json (~> 2.3)
-      language_server-protocol (>= 3.17.0)
-      parallel (~> 1.10)
-      parser (>= 3.2.2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (>= 1.10)
+      parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.8, < 3.0)
-      rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.28.1, < 2.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.29.0)
-      parser (>= 3.2.1.0)
-    rubocop-performance (1.19.0)
-      rubocop (>= 1.7.0, < 2.0)
-      rubocop-ast (>= 0.4.0)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.49.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    rubocop-performance (1.26.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
     ruby-progressbar (1.13.0)
     simplecov (0.22.0)
       docile (~> 1.1)
       simplecov-html (~> 0.11)
       simplecov_json_formatter (~> 0.1)
-    simplecov-html (0.12.3)
+    simplecov-html (0.13.2)
     simplecov_json_formatter (0.1.4)
-    standard (1.31.1)
+    standard (1.55.0)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.0)
-      rubocop (~> 1.56.2)
+      rubocop (~> 1.87.0)
       standard-custom (~> 1.0.0)
-      standard-performance (~> 1.2)
+      standard-performance (~> 1.8)
     standard-custom (1.0.2)
       lint_roller (~> 1.0)
       rubocop (~> 1.50)
-    standard-performance (1.2.0)
+    standard-performance (1.9.0)
       lint_roller (~> 1.1)
-      rubocop-performance (~> 1.19.0)
-    unicode-display_width (2.4.2)
+      rubocop-performance (~> 1.26.0)
+    tsort (0.2.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
 
 PLATFORMS
-  universal-java-17
-  x86_64-darwin-19
-  x86_64-darwin-20
-  x86_64-darwin-21
-  x86_64-darwin-22
-  x86_64-darwin-23
-  x86_64-linux
+  java
+  ruby
 
 DEPENDENCIES
-  minitest (~> 5.21)
+  minitest (~> 6.0)
   pairing_heap!
-  rake (~> 13.0)
+  rake (~> 13.3)
+  rbs (~> 4.2)
   simplecov (~> 0.22.0)
-  standard (~> 1.31)
+  standard (~> 1.55)
+
+CHECKSUMS
+  ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
+  docile (1.4.1) sha256=96159be799bfa73cdb721b840e9802126e4e03dfc26863db73647204c727f21e
+  drb (2.2.3) sha256=0b00d6fdb50995fe4a45dea13663493c841112e4068656854646f418fda13373
+  jar-dependencies (0.6.1-java) sha256=2746643482d139fd9cecb524b57df63b71d9b5d734c7275171701201e3164f23
+  json (2.21.2) sha256=1f1d3b7cf2b3ba1a69beca0bb6db13d5438b80bff3cd54cdaaa620b9b07c1c6a
+  json (2.21.2-java) sha256=f01521cd90639cc26b63040fb00d2b949f18f41ecaab5c82b02fb31d0b8b736c
+  language_server-protocol (3.17.0.5) sha256=fd1e39a51a28bf3eec959379985a72e296e9f9acfce46f6a79d31ca8760803cc
+  lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87
+  logger (1.7.0) sha256=196edec7cc44b66cfb40f9755ce11b392f21f7967696af15d274dde7edff0203
+  minitest (6.0.6) sha256=153ea36d1d987a62942382b61075745042a2b3123b1cd48f4c3675af9cc7d6f1
+  pairing_heap (3.1.2)
+  parallel (1.27.0) sha256=4ac151e1806b755fb4e2dc2332cbf0e54f2e24ba821ff2d3dcf86bf6dc4ae130
+  parser (3.3.10.0) sha256=ce3587fa5cc55a88c4ba5b2b37621b3329aadf5728f9eafa36bbd121462aabd6
+  prism (1.9.0) sha256=7b530c6a9f92c24300014919c9dcbc055bf4cdf51ec30aed099b06cd6674ef85
+  racc (1.8.1) sha256=4a7f6929691dbec8b5209a0b373bc2614882b55fc5d2e447a21aaa691303d62f
+  racc (1.8.1-java) sha256=54f2e6d1e1b91c154013277d986f52a90e5ececbe91465d29172e49342732b98
+  rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a
+  rake (13.3.1) sha256=8c9e89d09f66a26a01264e7e3480ec0607f0c497a861ef16063604b1b08eb19c
+  rbs (4.2.0) sha256=51f7b886dcc05bc09e10b901daa6a81829f6adc03101d6ca9ea4aac6103e0674
+  rbs (4.2.0-java) sha256=a19282d89c307dd6d33c6a72cc60f75b10d6d35a5996796e864789c903cddb3c
+  regexp_parser (2.11.3) sha256=ca13f381a173b7a93450e53459075c9b76a10433caadcb2f1180f2c741fc55a4
+  rubocop (1.87.0) sha256=b9d9ddf55116a513f8ef2c7ae660662d8b49301f118d3f0df61865b33a5c188d
+  rubocop-ast (1.49.0) sha256=49c3676d3123a0923d333e20c6c2dbaaae2d2287b475273fddee0c61da9f71fd
+  rubocop-performance (1.26.1) sha256=cd19b936ff196df85829d264b522fd4f98b6c89ad271fa52744a8c11b8f71834
+  ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
+  simplecov (0.22.0) sha256=fe2622c7834ff23b98066bb0a854284b2729a569ac659f82621fc22ef36213a5
+  simplecov-html (0.13.2) sha256=bd0b8e54e7c2d7685927e8d6286466359b6f16b18cb0df47b508e8d73c777246
+  simplecov_json_formatter (0.1.4) sha256=529418fbe8de1713ac2b2d612aa3daa56d316975d307244399fa4838c601b428
+  standard (1.55.0) sha256=8a8f2c3e681a4db3aafde1b301561b0f3d7c5f06c160167cb744a4d7baf0426e
+  standard-custom (1.0.2) sha256=424adc84179a074f1a2a309bb9cf7cd6bfdb2b6541f20c6bf9436c0ba22a652b
+  standard-performance (1.9.0) sha256=49483d31be448292951d80e5e67cdcb576c2502103c7b40aec6f1b6e9c88e3f2
+  tsort (0.2.0) sha256=9650a793f6859a43b6641671278f79cfead60ac714148aabe4e3f0060480089f
+  unicode-display_width (3.2.0) sha256=0cdd96b5681a5949cdbc2c55e7b420facae74c4aaf9a9815eee1087cb1853c42
+  unicode-emoji (4.2.0) sha256=519e69150f75652e40bf736106cfbc8f0f73aa3fb6a65afe62fefa7f80b0f80f
 
 BUNDLED WITH
-   2.3.6
+  4.0.3

data/Rakefile

@@ -12,4 +12,8 @@ Rake::TestTask.new(:test) do |t|
   t.test_files = FileList["test/**/*_test.rb"]
 end
 
-task default: %i[test standard]
+task :rbs do
+  sh "rbs validate sig/pairing_heap.rbs"
+end
+
+task default: %i[test standard rbs]

data/lib/pairing_heap/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PairingHeap
-  VERSION = "3.1.0"
+  VERSION = "3.1.2"
 end

data/lib/pairing_heap.rb

@@ -508,7 +508,7 @@ module PairingHeap
         delete(elem)
         push(elem, priority)
       else
-        super(elem, priority)
+        super
       end
     end
   end
@@ -518,14 +518,20 @@ module PairingHeap
 
     def visit_node(node, &block)
       return unless node
+      stack = [node]
 
-      block.call(node)
+      until stack.empty?
+        node = stack.pop
 
-      if node.subheaps
-        visit_node(node.subheaps, &block)
-      end
-      if node.next_sibling
-        visit_node(node.next_sibling, &block)
+        block.call(node)
+
+        if node.subheaps
+          stack << node.subheaps
+        end
+
+        if node.next_sibling
+          stack << node.next_sibling
+        end
       end
     end
   end

data/pairing_heap.gemspec

@@ -26,8 +26,9 @@ Gem::Specification.new do |spec|
   spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "minitest", "~> 5.21"
-  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rbs", "~> 4.2"
+  spec.add_development_dependency "minitest", "~> 6.0"
+  spec.add_development_dependency "rake", "~> 13.3"
   spec.add_development_dependency "simplecov", "~> 0.22.0"
-  spec.add_development_dependency "standard", "~> 1.31"
+  spec.add_development_dependency "standard", "~> 1.55"
 end

data/sig/pairing_heap.rbs

@@ -0,0 +1,175 @@
+module PairingHeap
+  VERSION: String
+
+  # Pairing heap data structure implementation
+  # @see https://en.wikipedia.org/wiki/Pairing_heap
+  class PairingHeap[Elem, Priority]
+    # @yield [l_priority, r_priority] Optional heap property priority comparator. `<=.to_proc` by default
+    # @yieldreturn [bool] if `l_priority` is more prioritary than `r_priority`, or the priorities are equal
+    def initialize: () ?{ (Priority, Priority) -> boolish } -> void
+
+    # Pushes element to the heap.
+    #   Time Complexity: O(1)
+    # @raise [ArgumentError] if the element is already in the heap
+    def push: (Elem elem, ?Priority priority) -> self
+    alias enqueue push
+    alias offer push
+
+    # Returns the element at the top of the heap.
+    #   Time Complexity: O(1)
+    def peek: () -> Elem?
+
+    # Returns the priority of the element at the top of the heap.
+    #   Time Complexity: O(1)
+    def peek_priority: () -> Priority?
+
+    # Returns the element and its priority at the top of the heap.
+    #   Time Complexity: O(1)
+    def peek_with_priority: () -> [Elem, Priority] | [nil, nil]
+
+    # Time Complexity: O(1)
+    def empty?: () -> bool
+
+    # Time Complexity: O(1)
+    def any?: () -> bool
+
+    # Time Complexity: O(1)
+    def size: () -> Integer
+    alias length size
+
+    # Removes element from the top of the heap and returns it.
+    #   Time Complexity: O(N), Amortized: O(log N)
+    def pop: () -> Elem?
+    alias dequeue pop
+
+    # Removes element from the top of the heap and returns its priority.
+    #   Time Complexity: O(N), Amortized: O(log N)
+    def pop_priority: () -> Priority?
+
+    # Removes element from the top of the heap and returns it along with its priority.
+    #   Time Complexity: O(N), Amortized: O(log N)
+    def pop_with_priority: () -> [Elem, Priority] | [nil, nil]
+
+    # Changes a priority of element to a more prioritary one.
+    #   Time Complexity: O(1), Amortized: O(log N)
+    # @param elem Element
+    # @param priority New priority
+    # @raise [ArgumentError] if the element is not in the heap or the new priority is less prioritary
+    def change_priority: (Elem elem, Priority priority) -> self
+
+    # Removes element from the heap.
+    #   Time Complexity: O(N), Amortized: O(log N)
+    # @raise [ArgumentError] if the element is not in the heap
+    def delete: (Elem elem) -> self
+
+    # Check if element is in the heap.
+    #   Time Complexity: O(1)
+    def include?: (Elem key) -> bool
+    alias exists? include?
+
+    # Returns priority of the provided element.
+    #   Time Complexity: O(1)
+    def get_priority: (Elem elem) -> Priority?
+
+    # Returns [false, nil] if the element is not in heap, [true, priority] if it is.
+    #   Time Complexity: O(1)
+    def get_priority_if_exists: (Elem elem) -> [false, nil] | [true, Priority]
+
+    # Yields each element in the heap. No order guarantees.
+    def each: () { (Elem) -> void } -> void
+            | () -> Enumerator[Elem, void]
+
+    # Yields each [element, priority] pair in the heap. No order guarantees.
+    def each_with_priority: () { ([Elem, Priority]) -> void } -> void
+                          | () -> Enumerator[[Elem, Priority], void]
+  end
+
+  class SimplePairingHeap[Elem, Priority]
+    # @yield [l_priority, r_priority] Optional heap property priority comparator. `<=.to_proc` by default
+    # @yieldreturn [bool] if `l_priority` is more prioritary than `r_priority`, or the priorities are equal
+    def initialize: () ?{ (Priority, Priority) -> boolish } -> void
+
+    # Pushes element to the heap.
+    #   Time Complexity: O(1)
+    def push: (Elem elem, ?Priority priority) -> self
+    alias enqueue push
+    alias offer push
+
+    # Returns the element at the top of the heap.
+    #   Time Complexity: O(1)
+    def peek: () -> Elem?
+
+    # Returns the priority of the element at the top of the heap.
+    #   Time Complexity: O(1)
+    def peek_priority: () -> Priority?
+
+    # Returns the element and its priority at the top of the heap.
+    #   Time Complexity: O(1)
+    def peek_with_priority: () -> [Elem, Priority] | [nil, nil]
+
+    # Time Complexity: O(1)
+    def empty?: () -> bool
+
+    # Time Complexity: O(1)
+    def any?: () -> bool
+
+    # Time Complexity: O(1)
+    attr_reader size: Integer
+    alias length size
+
+    # Removes element from the top of the heap and returns it.
+    #   Time Complexity: O(N), Amortized: O(log N)
+    def pop: () -> Elem?
+    alias dequeue pop
+
+    # Removes element from the top of the heap and returns its priority.
+    #   Time Complexity: O(N), Amortized: O(log N)
+    def pop_priority: () -> Priority?
+
+    # Removes element from the top of the heap and returns it along with its priority.
+    #   Time Complexity: O(N), Amortized: O(log N)
+    def pop_with_priority: () -> [Elem, Priority] | [nil, nil]
+
+    # Yields each element in the heap. No order guarantees.
+    def each: () { (Elem) -> void } -> void
+            | () -> Enumerator[Elem, void]
+
+    # Yields each [element, priority] pair in the heap. No order guarantees.
+    def each_with_priority: () { ([Elem, Priority]) -> void } -> void
+                          | () -> Enumerator[[Elem, Priority], void]
+
+    # Merges provided heap into self.
+    #   Time Complexity: O(1)
+    # @raise [ArgumentError] if the provided argument is self
+    # @note Modifies the argument (clears it)
+    def merge: (SimplePairingHeap[Elem, Priority] other) -> self
+  end
+
+  # Priority queue where the smallest priority is the most prioritary
+  class MinPriorityQueue[Elem, Priority < Comparable[Priority]] < PairingHeap[Elem, Priority]
+    def initialize: () -> void
+
+    alias decrease_key change_priority
+    alias min peek
+    alias extract_min dequeue
+  end
+
+  # Priority queue where the highest priority is the most prioritary
+  class MaxPriorityQueue[Elem, Priority < Comparable[Priority]] < PairingHeap[Elem, Priority]
+    def initialize: () -> void
+
+    alias increase_key change_priority
+    alias max peek
+    alias extract_max dequeue
+  end
+
+  # Priority queue with change_priority that accepts changing to a less prioritary priority
+  class SafeChangePriorityQueue[Elem, Priority] < PairingHeap[Elem, Priority]
+    # Changes a priority of the element (accepts any direction).
+    #   Time Complexity: O(N), Amortized: O(log N)
+    # @param elem Element
+    # @param priority New priority
+    # @raise [ArgumentError] if the element is not in the heap
+    def change_priority: (Elem elem, Priority priority) -> self
+  end
+end

metadata

@@ -1,43 +1,56 @@
 --- !ruby/object:Gem::Specification
 name: pairing_heap
 version: !ruby/object:Gem::Version
-  version: 3.1.0
+  version: 3.1.2
 platform: ruby
 authors:
 - Marcin Henryk Bartkowiak
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-02-11 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: rbs
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.21'
+        version: '6.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.21'
+        version: '6.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '13.0'
+        version: '13.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '13.0'
+        version: '13.3'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -58,14 +71,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.31'
+        version: '1.55'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.31'
+        version: '1.55'
 description: Performant priority queue in pure ruby with support for changing priority
   using pairing heap data structure
 email:
@@ -87,6 +100,7 @@ files:
 - lib/pairing_heap.rb
 - lib/pairing_heap/version.rb
 - pairing_heap.gemspec
+- sig/pairing_heap.rbs
 homepage: https://github.com/mhib/pairing_heap
 licenses:
 - MIT
@@ -95,7 +109,6 @@ metadata:
   source_code_uri: https://github.com/mhib/pairing_heap
   documentation_uri: https://rubydoc.info/gems/pairing_heap
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -110,8 +123,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
-signing_key:
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Performant priority queue in pure ruby with support for changing priority
 test_files: []