active_record_in_time_scope 0.1.7 → 0.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b8fa7d1397cbad1a682309ad55bee699deabf406ea542ee48182e7880c87aa48
-  data.tar.gz: 8459cdc187fb8c7eb3d8a158e0d16ae2209a3664ba64d6a70c08c3e3908856b3
+  metadata.gz: 1c7368eb997ae0a2489562309c633db819e903274260d88295476fd964071b12
+  data.tar.gz: 8aeebd6b5cac7f98646d0b035560cc027d046b9f9164c9b0390aeb73ecafb594
 SHA512:
-  metadata.gz: ba9ca47a5b010da08753bb84ea270f82b8d1b0fb056d71962530370240c88b803b2739db51f844a75efa9d70b6b4bc938f3a0898116c006ea240b76d3fd34401
-  data.tar.gz: b9917fc20bc4d32e41d1e7466f56d4c766c86e10edde9d0a08f6563954120ebc63cf4d797448b27434b1812975e253aa03f44ba9bc9ce7fedab442770e64fd38
+  metadata.gz: 8a6bcd19c674377ae8216a8b4bd67e2a3233d3dec766bd1549a45f864c3688574d372397179047e0b1d664371258c5c21585e0dfd5104b37f40ade7d437b73bc
+  data.tar.gz: 05057f9961c6767269d048fc4fefcb3e7f7fd628785d104efbfa84762d24381fbaa81b7f273a6a2be3410690f265d93f6da85ba0a6e3d2f521bb50ab3f34a778

data/README.md

@@ -95,6 +95,20 @@ end
 
 For records where each row is valid until the next one:
 
+| id | user_id | amount | start_at   |
+|----|---------|--------|------------|
+| 1  | 1       | 100    | 2024-10-01 |
+| 2  | 1       | 120    | 2024-10-10 |
+| 3  | 1       | 150    | 2024-10-15 |
+
+```ruby
+# Time.current = 2024-10-20 → row id=3 (latest) is selected
+Price.in_time
+
+# 2024-10-12 → row id=2 (latest before 10/12) is selected
+Price.in_time(Time.parse("2024-10-12"))
+```
+
 ```ruby
 class Price < ActiveRecord::Base
   in_time_scope start_at: { null: false }, end_at: { column: nil }
@@ -108,10 +122,56 @@ end
 User.includes(:current_price)  # No N+1, fetches only latest per user
 ```
 
+**`latest_in_time` — latest record per FK before the given time:**
+
+```mermaid
+flowchart LR
+    A["id=1\n10/01"] --> B["id=2\n10/10"] --> C["id=3\n10/15"]
+    T(["⏱ time=10/20"]) -.->|latest_in_time| C
+```
+
+```
+──────●──────────●──────────●──────────▶ time
+    10/01      10/10      10/15    10/20(now)
+    id=1       id=2       id=3
+                             ↑
+                       latest_in_time
+```
+
+**`earliest_in_time` — earliest record per FK before the given time:**
+
+```mermaid
+flowchart LR
+    A["id=1\n10/01"] --> B["id=2\n10/10"] --> C["id=3\n10/15"]
+    T(["⏱ time=10/20"]) -.->|earliest_in_time| A
+```
+
+```
+──────●──────────●──────────●──────────▶ time
+    10/01      10/10      10/15    10/20(now)
+    id=1       id=2       id=3
+      ↑
+earliest_in_time
+```
+
 ### End-Only Pattern (Expiration)
 
 For records that are active until they expire:
 
+| id | code | expired_at |
+|----|------|------------|
+| 1  | ABC  | 2024-11-30 |
+| 2  | XYZ  | 2024-10-05 |
+| 3  | DEF  | 2024-12-31 |
+
+```ruby
+# Time.current = 2024-10-20 → id=1 (ABC) and id=3 (DEF) selected (not yet expired)
+Coupon.in_time
+
+# 2024-10-06 → id=1 (ABC) and id=3 (DEF) selected (XYZ expired on 10/05)
+Coupon.in_time(Time.parse("2024-10-06"))
+```
+
 ```ruby
 class Coupon < ActiveRecord::Base
   in_time_scope start_at: { column: nil }, end_at: { null: false }
@@ -120,6 +180,22 @@ end
 
 ### Inverse Scopes
 
+```mermaid
+flowchart LR
+    A["before_in_time"] -->|"● start_at"| B["in_time"] -->|"○ end_at"| C["after_in_time"]
+    D["out_of_time"] -->|"● start_at"| B
+    B -->|"○ end_at"| E["out_of_time"]
+```
+
+```
+before_in_time │       in_time       │ after_in_time
+───────────────●─────────────────────○──────────────▶ time
+             start_at             end_at
+
+   out_of_time │       in_time       │  out_of_time
+───────────────●─────────────────────○──────────────▶ time
+```
+
 Query records outside the time window:
 
 ```ruby

data/lib/active_record_in_time_scope/version.rb

@@ -2,5 +2,5 @@
 
 module ActiveRecordInTimeScope
   # The current version of the ActiveRecordInTimeScope gem
-  VERSION = "0.1.7"
+  VERSION = "0.1.8"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: active_record_in_time_scope
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 0.1.8
 platform: ruby
 authors:
 - kyohah
@@ -217,7 +217,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.7
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Add time-window scopes to ActiveRecord models
 test_files: []