ratproto 0.3.3 → 0.3.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a098c33a93bc8b33f32631f733fb3b5d3d1f3b233035d1cdbf8d397071a8d566
-  data.tar.gz: ae846bf49bca35fa4ee7fe748e8d0a05eeaf60a44f6cd687d7a0d66f61c4254f
+  metadata.gz: c5fee431ed4b84e739b1ff36768bfb1db007dd1457d63dfd1ba5279c92b66c00
+  data.tar.gz: 260c01a4b45629e2c55026404ad5bbbc6fe9e93a22647cba85d4897b11a7ed81
 SHA512:
-  metadata.gz: 9abf0ae89949e3e20b9f89c6b0ed9d09275a4fe55b68104c0579f6c85b6f10b7901c0dc9c884c022b8f269cf28bcfe6e07e00db9519266ab4e00bc5fab5e8b35
-  data.tar.gz: 0dfd41610d6faf493475041b065b8e688bae795bdb14c85238945ec0498a80d9ea530e7ce9e1e8fe81d7938f106c9467d100859404925000a4e58927c60a480a
+  metadata.gz: ff763fe7c82d4a645de4228bf909e362b33efd98094390451bcf99b6b64c9ce165f83f17c4325746f7f4c73a076d3824944b5422c871f6bf25fdc89331f1a7a3
+  data.tar.gz: 855c076aa6553f04635f5275e2b94bef28bd78d91f816b9446cad9f8c5d305719dcb4dbdc85c986d9b736d3355d3cc4d2faec59425c2eca9f93b821c7cbf906e

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## [0.3.4] - 2026-09-03
+
+- `stream`: for Jetstream sources, you can pass e.g. '-4h' as the cursor to start from 4 hours ago
+
 ## [0.3.3] - 2026-08-17
 
 - `stream`: added `--print-time` mode, bug fixes, unified timestamp formats

data/lib/ratproto/commands/stream.rb

@@ -17,13 +17,8 @@ module RatProto
 
       option ['-j', '--jetstream'], :flag, 'use a Jetstream source'
 
-      option(
-        ['-r', '--cursor'], 'CURSOR',
+      option ['-r', '--cursor'], 'CURSOR',
         'start from a given cursor (pass 0 to read from the beginning of the playback window)'
-      ) do |value|
-        raise ArgumentError, 'must be a decimal integer' unless value =~ /\A\d+\z/
-        value.to_i
-      end
 
       option ['-d', '--did'], 'DID[,DID...]', 'filter events by DID (comma-separated or repeated)',
              multivalued: true, attribute_name: :did_values
@@ -48,6 +43,7 @@ module RatProto
         require 'skyfall'
 
         prepare_filters
+        validate_cursor
 
         @sky = build_stream
         configure_interrupt_handler
@@ -97,6 +93,29 @@ module RatProto
         @operations = (@operations.length > 0) ? @operations.map { |operation| validate_operation(operation) } : nil
       end
 
+      def validate_cursor
+        return if cursor.nil?
+
+        if cursor.start_with?('-')
+          if !jetstream?
+            signal_usage_error("time offset cursors are only supported with Jetstream right now")
+          end
+
+          if cursor =~ /\A\-([0-9]+(\.[0-9]+)?)([hms])\z/i
+            amount, unit = $1, $3.downcase
+
+            multiplier = { 'h' => 3600, 'm' => 60, 's' => 1 }[unit]
+            @cursor = (Time.now.to_f - amount.to_f * multiplier) * 1_000_000
+          else
+            signal_usage_error("invalid time offset specifier: #{cursor}")
+          end
+        elsif cursor =~ /\A[0-9]+\z/
+          @cursor = cursor.to_i
+        else
+          signal_usage_error("cursor must be an integer number or an offset specifier")
+        end
+      end
+
       def validate_operation(operation)
         if OPERATION_TYPES.include?(operation)
           operation.to_sym
@@ -108,7 +127,7 @@ module RatProto
       def build_stream
         if jetstream?
           options = {}
-          options[:cursor] = cursor if cursor
+          options[:cursor] = @cursor if @cursor
 
           # pass DID/collection filters to Jetstream to filter events server-side
           options[:wanted_dids] = @dids if @dids

data/lib/ratproto/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RatProto
-  VERSION = "0.3.3"
+  VERSION = "0.3.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ratproto
 version: !ruby/object:Gem::Version
-  version: 0.3.3
+  version: 0.3.4
 platform: ruby
 authors:
 - Kuba Suder
@@ -133,7 +133,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.18
 specification_version: 4
 summary: Ruby CLI tool for accessing Bluesky API / ATProto
 test_files: []