philiprehberger-counter 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ec5f8cbe5ef7c7233a73a37cbb103098418654492af1cbfbad0743e8a64045c2
-  data.tar.gz: 10fd4fabf5dc064c088e0c1f40a576cad7e5c0901aad13ed6cbfd9b21427be68
+  metadata.gz: 9235199a1afba364ec57b7c6107386e10c538941a6469a2555e80f452f1bc14a
+  data.tar.gz: 3de6990335685ca1d28a98e4ea796c5488ba9d52fafc04b5a4258255be8f504d
 SHA512:
-  metadata.gz: 6076470a39f47c2ae0a024ee5479ec66029df9cd2d3b90da0533ee239afbfc02addc90b8ddaf2d7dce6aa5efaa995ba13b874c639c96c628417a2eb35a83b1ea
-  data.tar.gz: 49f7f17e8541bafadc97442d14410d8c163aea4e64e4c5251b1a65edf8460c57bf2a8b747e1bff01eb5d5d170d8705713167665fdb27a6ebb2952388d2a08487
+  metadata.gz: de7b409893d4e6f89a94f8f2afde8629f19a631c6606be3a8075ba0151ae45f3ba65c0803de527d73eb686bf3de153b1479da5419e51aac6eaeda3fd8ad7b163
+  data.tar.gz: 99f089682769fff8d738f3a89df4de0133fbf09dbd84e86c0ca1af072f0418880f7468ca5dec2a706ab0ccff87ebd920103fe83f6e3821982688cc659e41d8c1

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this gem adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-04-24
+
+### Added
+- `#mode` method returning the single most-common key (shorthand for `max_count.first`); returns `nil` for empty counters
+
 ## [0.4.0] - 2026-04-15
 
 ### Added

data/README.md

@@ -95,6 +95,7 @@ counter.delete('z')  # => nil (key not present)
 counter = Philiprehberger::Counter.new(%w[a b a c a b])
 counter.max_count  # => ["a", 3]
 counter.min_count  # => ["c", 1]
+counter.mode       # => "a"
 ```
 
 ### JSON Serialization
@@ -159,6 +160,7 @@ skewed.entropy   # => ~0.7219 (less than uniform upper bound)
 | `#delete(key)` | Remove a key entirely, returns count or nil |
 | `#max_count` | Key-count pair with highest count |
 | `#min_count` | Key-count pair with lowest count |
+| `#mode` | Most-common key (just the key, not the pair) |
 | `#to_json` | Serialize counter to JSON string |
 | `.from_json(str)` | Deserialize counter from JSON string |
 | `#sample(n)` | Weighted random sample based on counts |

data/lib/philiprehberger/counter/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   class Counter
-    VERSION = '0.4.0'
+    VERSION = '0.5.0'
   end
 end

data/lib/philiprehberger/counter.rb

@@ -184,6 +184,17 @@ module Philiprehberger
       @counts.max_by { |_, count| count }
     end
 
+    # Return the single most-common key (the mode of the count distribution)
+    #
+    # When multiple keys tie for the highest count, returns the first one
+    # encountered via `Hash#max_by` (i.e., insertion order among ties).
+    #
+    # @return [Object, nil] the most-common key, or nil if empty
+    def mode
+      pair = max_count
+      pair && pair[0]
+    end
+
     # Return the [key, count] pair with the lowest count
     #
     # @return [Array, nil] [key, count] or nil if empty

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-counter
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-15 00:00:00.000000000 Z
+date: 2026-04-24 00:00:00.000000000 Z
 dependencies: []
 description: Count element frequencies from any enumerable with most-common and least-common
   queries, merge and subtract operations, percentage calculations, and Enumerable