in_time_scope 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eee76cde212cee461aa7b915b048c5479bc1adc82faa1a57fc4d10e136806eb6
-  data.tar.gz: b6de2422411c951e2e1cf3029498755b77c9de73731ed9e24d3d20c0df612d79
+  metadata.gz: 7ae5a251a71cec0f0ad9ac7890d9e1e88de46dade545cbfcff2cf0201d603939
+  data.tar.gz: 9a4c17e7f1ad5a1b62ebf37038332d43a7610fcce5f770e66df70e51670dc415
 SHA512:
-  metadata.gz: 9d9daa7dc0815efde3c0d6a0d6231da6799526fa17be1c96bc22cb76f460ce7e4c84f40ae449760a5e24e86177632b174c94ecf13ec0d3240cae9c4a39ad5721
-  data.tar.gz: 337490e629eca19edec0fe0615ee895f67e475258281a173c61e10cf8014a4f185ae72c48fbc07065d7ae29c0b6e9016b547827b83556a4d8c6be3c79c95ec04
+  metadata.gz: 4480bbfaee296c29a87e96b26c2f32f29a78792712765cb48b51699c01bc552526ab1764972bd6cb19bfa4ce5de115abd099a7d0abf8701a26fa69eedc780d6e
+  data.tar.gz: b905e3bf65da95f7b4868e49c386051616b071cd67de613617d0443caa4679cbb4cc0c729ca9b6ec2776a32af4cfda32deedd48d61ceca4d326c833748b382a4

data/README.md

@@ -87,11 +87,12 @@ Use these options in `in_time_scope` to customize column behavior.
 
 | Option | Applies to | Type | Default | Description | Example |
 | --- | --- | --- | --- | --- | --- |
-| `:scope_name` (1st arg) | in_time | `Symbol` | `:in_time` | Creates a named scope like `published_in_time` | `in_time_scope :published` |
+| `:scope_name` (1st arg) | in_time | `Symbol` | `:in_time` | Creates a named scope like `in_time_published` | `in_time_scope :published` |
 | `start_at: { column: ... }` | start_at | `Symbol` / `nil` | `:start_at` (or `:"<scope>_start_at"` when `:scope_name` is set) | Use a custom column name; set `nil` to disable `start_at` | `start_at: { column: :available_at }` |
 | `end_at: { column: ... }` | end_at | `Symbol` / `nil` | `:end_at` (or `:"<scope>_end_at"` when `:scope_name` is set) | Use a custom column name; set `nil` to disable `end_at` | `end_at: { column: nil }` |
 | `start_at: { null: ... }` | start_at | `true/false` | auto (schema) | Force NULL-aware vs NOT NULL behavior | `start_at: { null: false }` |
 | `end_at: { null: ... }` | end_at | `true/false` | auto (schema) | Force NULL-aware vs NOT NULL behavior | `end_at: { null: true }` |
+| `prefix: true` | scope_name | `true/false` | `false` | Use prefix style method name like `published_in_time` instead of `in_time_published` | `in_time_scope :published, prefix: true` |
 
 ### Alternative: Start-Only History (No `end_at`)
 Use this when periods never overlap and you want exactly one "current" row.
@@ -175,8 +176,8 @@ Customize which columns are used and define more than one time window per model.
 create_table :events do |t|
   t.datetime :available_at, null: true
   t.datetime :expired_at, null: true
-  t.datetime :publish_start_at, null: false
-  t.datetime :publish_end_at, null: false
+  t.datetime :published_start_at, null: false
+  t.datetime :published_end_at, null: false
 
   t.timestamps
 end
@@ -187,15 +188,30 @@ class Event < ActiveRecord::Base
   # Use different column names
   in_time_scope start_at: { column: :available_at }, end_at: { column: :expired_at }
 
-  # Define an additional scope
-  in_time_scope :published, start_at: { column: :publish_start_at, null: false }, end_at: { column: :publish_end_at, null: false }
+  # Define an additional scope - uses published_start_at / published_end_at by default
+  in_time_scope :published
 end
 
 Event.in_time
 # => uses available_at / expired_at
 
+Event.in_time_published
+# => uses published_start_at / published_end_at
+```
+
+### Using `prefix: true` Option
+Use the `prefix: true` option if you prefer the scope name as a prefix instead of suffix.
+
+```ruby
+class Event < ActiveRecord::Base
+  include InTimeScope
+
+  # With prefix: true, the method name becomes published_in_time instead of in_time_published
+  in_time_scope :published, prefix: true
+end
+
 Event.published_in_time
-# => uses publish_start_at / publish_end_at
+# => uses published_start_at / published_end_at
 ```
 
 ### Using with `has_one` Associations

data/lib/in_time_scope/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module InTimeScope
-  VERSION = "0.1.0"
+  VERSION = "0.1.2"
 end

data/lib/in_time_scope.rb

@@ -11,23 +11,22 @@ module InTimeScope
   end
 
   module ClassMethods
-    def in_time_scope(scope_name = nil, start_at: {}, end_at: {})
+    def in_time_scope(scope_name = nil, start_at: {}, end_at: {}, prefix: false)
       scope_name ||= :in_time
-      scope_suffix = scope_name == :in_time ? "" : "_#{scope_name}"
+      scope_prefix = scope_name == :in_time ? "" : "#{scope_name}_"
 
-      start_config = normalize_config(start_at, :"start_at#{scope_suffix}", :start_at)
-      end_config = normalize_config(end_at, :"end_at#{scope_suffix}", :end_at)
+      start_config = normalize_config(start_at, :"#{scope_prefix}start_at")
+      end_config = normalize_config(end_at, :"#{scope_prefix}end_at")
 
-      define_scope_methods(scope_name, start_config, end_config)
+      define_scope_methods(scope_name, start_config, end_config, prefix)
     end
 
     private
 
-    def normalize_config(config, default_column, fallback_column)
+    def normalize_config(config, default_column)
       return { column: nil, null: true } if config[:column].nil? && config.key?(:column)
 
       column = config[:column] || default_column
-      column = fallback_column unless column_names.include?(column.to_s)
       column = nil unless column_names.include?(column.to_s)
 
       null = config.key?(:null) ? config[:null] : column_nullable?(column)
@@ -42,8 +41,14 @@ module InTimeScope
       col ? col.null : true
     end
 
-    def define_scope_methods(scope_name, start_config, end_config)
-      method_name = scope_name == :in_time ? :in_time : :"#{scope_name}_in_time"
+    def define_scope_methods(scope_name, start_config, end_config, prefix)
+      method_name = if scope_name == :in_time
+                      :in_time
+                    elsif prefix
+                      :"#{scope_name}_in_time"
+                    else
+                      :"in_time_#{scope_name}"
+                    end
       instance_method_name = :"#{method_name}?"
 
       start_column = start_config[:column]
@@ -89,7 +94,7 @@ module InTimeScope
     end
 
     def define_latest_scope(method_name, start_column, start_null)
-      latest_method_name = method_name == :in_time ? :latest_in_time : :"latest_#{method_name}_in_time"
+      latest_method_name = method_name == :in_time ? :latest_in_time : :"latest_#{method_name}"
       tbl = table_name
       col = start_column
 

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: in_time_scope
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - kyohah
 bindir: exe
 cert_chain: []
-date: 2026-01-24 00:00:00.000000000 Z
+date: 2026-01-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord