philiprehberger-counter 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9235199a1afba364ec57b7c6107386e10c538941a6469a2555e80f452f1bc14a
-  data.tar.gz: 3de6990335685ca1d28a98e4ea796c5488ba9d52fafc04b5a4258255be8f504d
+  metadata.gz: abc51d850f2a69c9c0394ac11b5a31a033d4f0753c476508a242ba98e19991f6
+  data.tar.gz: b8a5ebe0f5b363ddecd385d82a0b316d99afb07c1722363c84b1dc937366ca42
 SHA512:
-  metadata.gz: de7b409893d4e6f89a94f8f2afde8629f19a631c6606be3a8075ba0151ae45f3ba65c0803de527d73eb686bf3de153b1479da5419e51aac6eaeda3fd8ad7b163
-  data.tar.gz: 99f089682769fff8d738f3a89df4de0133fbf09dbd84e86c0ca1af072f0418880f7468ca5dec2a706ab0ccff87ebd920103fe83f6e3821982688cc659e41d8c1
+  metadata.gz: fa6a9773aeb27ee63287220200f8236062fe917b72e47edd9f7d8f5de90586cd27d371bb7223bbfd437b39223e6e0c7ef45774c08aef6c981eeb51957765473e
+  data.tar.gz: aedb5cb2e5d7192669c1b2837ea43bbe391f1ab76923bde5c91bb501b3c04615297164a1a86c8e423c3355d8ad9f1bd1eecb0860a94b07b89db1ed4c6fc32a44

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this gem adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-04-30
+
+### Added
+- `#unique_ratio` — ratio of unique keys to total observations (`size / total`); `0.0` for empty counters; pairs with `#entropy` as a simple diversity metric
+
 ## [0.5.0] - 2026-04-24
 
 ### Added

data/README.md

@@ -141,6 +141,18 @@ skewed = Philiprehberger::Counter.new(%w[a a a a b])
 skewed.entropy   # => ~0.7219 (less than uniform upper bound)
 ```
 
+### Unique Ratio
+
+Ratio of unique keys to total observations — a simple diversity metric.
+`1.0` means every observation was unique; small values mean a few keys
+dominate.
+
+```ruby
+Philiprehberger::Counter.new(%w[a b c d]).unique_ratio    # => 1.0
+Philiprehberger::Counter.new(%w[a a a a]).unique_ratio    # => 0.25
+Philiprehberger::Counter.new(%w[a a b b b c]).unique_ratio # => 0.5
+```
+
 ## API
 
 | Method | Description |
@@ -168,6 +180,7 @@ skewed.entropy   # => ~0.7219 (less than uniform upper bound)
 | `#values` | Return all count values |
 | `#filter_by_count(min:, max:)` | Filter entries by count range |
 | `#entropy` | Shannon entropy of the count distribution in bits |
+| `#unique_ratio` | Ratio of unique keys to total observations (`size / total`); `0.0` for empty counters |
 | `#to_h` | Convert to a plain hash |
 | `#size` | Number of unique keys |
 

data/lib/philiprehberger/counter/version.rb

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

data/lib/philiprehberger/counter.rb

@@ -152,6 +152,20 @@ module Philiprehberger
       (@counts[key].to_f / total * 100)
     end
 
+    # Ratio of unique keys to total observations
+    #
+    # A simple diversity / repetition metric. `1.0` means every observation
+    # was unique; small values mean a few keys dominate the counter. Returns
+    # `0.0` for empty counters.
+    #
+    # @return [Float] `size.to_f / total`, or `0.0` when total is zero
+    def unique_ratio
+      t = total
+      return 0.0 if t.zero?
+
+      size.to_f / t
+    end
+
     # Shannon entropy of the count distribution in bits
     #
     # @return [Float] entropy in bits, 0.0 for empty or single-key counters

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-counter
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-24 00:00:00.000000000 Z
+date: 2026-04-30 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