philiprehberger-ring_buffer 0.1.5 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f38ecf9b42695830add96e0218d665eb4f258d8b4765827d244b147dfa10827f
-  data.tar.gz: a6b0ee06470c7283b5503cb5fac563cf6b5a6a27cfaca8371c856218608f4d66
+  metadata.gz: c769e36a185afb7b7b200d7fc7d29822c067460b135f64f32ca5157164f070fc
+  data.tar.gz: 40ce5c2dc5f27dc4aab0ebf8fe376e5e971c31acac25cb47248c7b212eadeeed
 SHA512:
-  metadata.gz: 90759da53fd6a5aa40d1b1b9393944f81e9d47779d84c021223a810becafc4e72b3410c3a8d1ada1419a3bfdb08e2192524af6b02d4c9a09e77cd97c2246ff1f
-  data.tar.gz: 7f7f091815c8d02ac0cf863dd99887241c2898ca2bd7df5e0f0a3a45f1d94d0d8561827ca4c2fbaa5bdde2ad7c5be4ba13f1abcc7f31b2c9deb2c643bfc2f2cb
+  metadata.gz: a9a1dc2bdbbe335dccf1607aea535bbf7baf21e5b1bcbcd3e4d05f49a84f0a13f927abdc1086b70d3019c13e6ed495105a25e1145f73550135851ef2b05a0c7a
+  data.tar.gz: 873932dfa685d64a5ceaa0d677241ffa821a917ced571dbbf5b97a737d53fcc85024ce28f6d01004b2045737bae0f1325a62f72607a6261bf8b6335a76b24716

data/CHANGELOG.md

@@ -7,6 +7,19 @@ and this gem adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-04-03
+
+### Added
+- Index-based access via `[]` with positive and negative indices
+- `first` method for accessing oldest elements
+- `clear` method to reset buffer state
+- Statistical methods: `variance`, `stddev`, `median`
+
+## [0.1.6] - 2026-03-31
+
+### Added
+- Add GitHub issue templates, dependabot config, and PR template
+
 ## [0.1.5] - 2026-03-31
 
 ### Changed

data/README.md

@@ -38,24 +38,51 @@ buf.to_a          # => [2, 3, 4]
 buf.full?         # => true
 ```
 
-### Statistics
+### Index Access
 
 ```ruby
-buf = Philiprehberger::RingBuffer.new(100)
+buf = Philiprehberger::RingBuffer.new(5)
 [10, 20, 30].each { |v| buf.push(v) }
 
-buf.average  # => 20.0
-buf.sum      # => 60
-buf.min      # => 10
-buf.max      # => 30
+buf[0]   # => 10 (oldest)
+buf[-1]  # => 30 (newest)
+buf[99]  # => nil (out of bounds)
 ```
 
-### Last N Elements
+### First / Last Elements
 
 ```ruby
 buf = Philiprehberger::RingBuffer.new(10)
 (1..10).each { |v| buf.push(v) }
-buf.last(3)  # => [8, 9, 10]
+
+buf.first      # => 1
+buf.first(3)   # => [1, 2, 3]
+buf.last(3)    # => [8, 9, 10]
+```
+
+### Clear
+
+```ruby
+buf = Philiprehberger::RingBuffer.new(5)
+[1, 2, 3].each { |v| buf.push(v) }
+buf.clear
+buf.size   # => 0
+buf.empty? # => true
+```
+
+### Statistics
+
+```ruby
+buf = Philiprehberger::RingBuffer.new(100)
+[10, 20, 30].each { |v| buf.push(v) }
+
+buf.average   # => 20.0
+buf.sum       # => 60
+buf.min       # => 10
+buf.max       # => 30
+buf.variance  # => 66.66666666666667
+buf.stddev    # => 8.16496580927726
+buf.median    # => 20.0
 ```
 
 ### Enumerable
@@ -73,15 +100,21 @@ buf.select(&:odd?)        # => [1, 3]
 |--------|-------------|
 | `RingBuffer.new(capacity)` | Create a buffer with fixed capacity |
 | `#push(value)` | Add a value, overwriting oldest if full |
+| `#[](index)` | Access by index (0 = oldest, -1 = newest) |
 | `#to_a` | Convert to array (oldest first) |
 | `#size` | Number of elements in the buffer |
 | `#full?` | Whether the buffer is at capacity |
 | `#empty?` | Whether the buffer has no elements |
+| `#first(n)` | First n elements (oldest) |
+| `#last(n)` | Last n elements (most recent) |
+| `#clear` | Remove all elements, reset state |
 | `#average` | Average of numeric elements |
 | `#sum` | Sum of numeric elements |
 | `#min` | Minimum element |
 | `#max` | Maximum element |
-| `#last(n)` | Last n elements (most recent) |
+| `#variance` | Population variance |
+| `#stddev` | Population standard deviation |
+| `#median` | Median value |
 
 ## Development
 

data/lib/philiprehberger/ring_buffer/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   class RingBuffer
-    VERSION = '0.1.5'
+    VERSION = '0.2.0'
   end
 end

data/lib/philiprehberger/ring_buffer.rb

@@ -113,6 +113,73 @@ module Philiprehberger
       arr.last(n)
     end
 
+    # Access element by index (0 = oldest, -1 = newest)
+    #
+    # @param index [Integer]
+    # @return [Object, nil]
+    def [](index)
+      arr = to_a
+      return nil if arr.empty?
+      return nil if index >= arr.length || index < -arr.length
+
+      arr[index]
+    end
+
+    # Return the oldest n elements
+    #
+    # @param n [Integer] number of elements (default 1)
+    # @return [Object, Array]
+    def first(n = 1)
+      arr = to_a
+      return arr.first if n == 1
+
+      arr.first(n)
+    end
+
+    # Remove all elements and reset internal state
+    #
+    # @return [self]
+    def clear
+      @buffer = Array.new(@capacity)
+      @head = 0
+      @count = 0
+      self
+    end
+
+    # Population variance of numeric elements
+    #
+    # @return [Float]
+    def variance
+      return 0.0 if @count <= 1
+
+      avg = average
+      arr = to_a
+      arr.sum { |v| (v - avg)**2 } / arr.length.to_f
+    end
+
+    # Population standard deviation of numeric elements
+    #
+    # @return [Float]
+    def stddev
+      Math.sqrt(variance)
+    end
+
+    # Median value of numeric elements
+    #
+    # @return [Float, nil]
+    def median
+      return nil if empty?
+
+      sorted = to_a.sort
+      mid = sorted.length / 2
+
+      if sorted.length.odd?
+        sorted[mid].to_f
+      else
+        (sorted[mid - 1] + sorted[mid]) / 2.0
+      end
+    end
+
     # Iterate over elements (oldest first)
     #
     # @yield [element]

metadata

@@ -1,18 +1,18 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-ring_buffer
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.2.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-31 00:00:00.000000000 Z
+date: 2026-04-03 00:00:00.000000000 Z
 dependencies: []
 description: Fixed-capacity ring buffer that overwrites oldest entries on overflow,
-  with built-in statistics (average, sum, min, max), last-n retrieval, and Enumerable
-  support.
+  with index access, built-in statistics (average, sum, min, max, variance, stddev,
+  median), first/last-n retrieval, and Enumerable support.
 email:
 - me@philiprehberger.com
 executables: []
@@ -24,11 +24,11 @@ files:
 - README.md
 - lib/philiprehberger/ring_buffer.rb
 - lib/philiprehberger/ring_buffer/version.rb
-homepage: https://github.com/philiprehberger/rb-ring-buffer
+homepage: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-ring_buffer
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/philiprehberger/rb-ring-buffer
+  homepage_uri: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-ring_buffer
   source_code_uri: https://github.com/philiprehberger/rb-ring-buffer
   changelog_uri: https://github.com/philiprehberger/rb-ring-buffer/blob/main/CHANGELOG.md
   bug_tracker_uri: https://github.com/philiprehberger/rb-ring-buffer/issues