const_conf 0.8.2 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 783442195899da65976c312008a1dbc0277e523159702d8582e5933a1f40750c
-  data.tar.gz: a019c8c9d8b0eaa6eebe12ce15a5a3772d47bbec121a0eb7c323de25e13edc59
+  metadata.gz: bce56d92973da4818e0e6fcd37343ea5e27a3902d0dbec7f6ad352dec69705ba
+  data.tar.gz: 317afdeca380f7847900eb421f06ced5342b60776a1c370c194408a3536b8285
 SHA512:
-  metadata.gz: 1a9b3cc846abe1a7196bae1d51090349be3de081e80ce733a4ea947f66026f53f4cd99893d2144c17917b78c56c149e28382e63a8046b65b0f51f08325450f9b
-  data.tar.gz: d7331a496fd34232f3986f1d5940a8af108c2ff965c4e2af7d800acc3b1eda109424234f727cdc5260d82c89a84e0f52be4d3babf4c57b20b39cff85e6b25f64
+  metadata.gz: 8591d5703c6fbe796e220c8c3ecf31330e12981b3cf3806e191cde8efe0bd5410d762d37e4d7fcf7f55b746080155d4a795361470efbc4562553de48b0de9158
+  data.tar.gz: 628a002745c8cd17970496b51dc977bab3d6cabd662afe02c7d14286594bb2f75f58424fc8aa7eaac7f114ab1ebe6c1c0c077cf9790e92e6ab4e9000b52d69b6

data/CHANGES.md

@@ -1,5 +1,14 @@
 # Changes
 
+## 2026-10-01 v0.9.0
+
+*   Add `pager:` keyword argument to `ConstConf.view` and `Setting#view`,
+    allowing callers to override the pager command used for long output;
+    defaults to `ENV['PAGER']` or `less -r`
+*   Add YARD `@param pager` documentation to both `view` methods
+*   Add spec verifying that a custom `pager:` string is passed through to
+    `IO.popen`
+
 ## 2026-08-20 v0.8.2
 
 *   Documented block calling contexts for `decode`, `required`, and `check` in

data/const_conf.gemspec

@@ -1,9 +1,9 @@
 # -*- encoding: utf-8 -*-
-# stub: const_conf 0.8.2 ruby lib
+# stub: const_conf 0.9.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "const_conf".freeze
-  s.version = "0.8.2".freeze
+  s.version = "0.9.0".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
@@ -17,7 +17,7 @@ Gem::Specification.new do |s|
   s.licenses = ["MIT".freeze]
   s.rdoc_options = ["--title".freeze, "ConstConf - Clean DSL for config settings with validation and Rails integration".freeze, "--main".freeze, "README.md".freeze]
   s.required_ruby_version = Gem::Requirement.new(">= 3.2".freeze)
-  s.rubygems_version = "4.0.17".freeze
+  s.rubygems_version = "4.0.20".freeze
   s.summary = "Clean DSL for config settings with validation and Rails integration".freeze
   s.test_files = ["spec/const_conf/dir_plugin_spec.rb".freeze, "spec/const_conf/env_dir_extension_spec.rb".freeze, "spec/const_conf/file_plugin_spec.rb".freeze, "spec/const_conf/json_plugin_spec.rb".freeze, "spec/const_conf/setting_accessor_spec.rb".freeze, "spec/const_conf/setting_spec.rb".freeze, "spec/const_conf/tree_spec.rb".freeze, "spec/const_conf/yaml_plugin_spec.rb".freeze, "spec/const_conf_spec.rb".freeze, "spec/spec_helper.rb".freeze]
 

data/lib/const_conf/setting.rb

@@ -353,8 +353,11 @@ class ConstConf::Setting
   # standard output.
   #
   # @param io [IO, nil] the IO object to write the output to; if nil, uses STDOUT
-  def view(io: nil)
-    parent_namespace.view(object: self, io:)
+  # @param pager [String, nil] the pager command to use when output exceeds
+  # terminal height; if nil, falls back to the PAGER environment variable or
+  # `less -r`
+  def view(io: nil, pager: nil)
+    parent_namespace.view(object: self, io:, pager:)
   end
 
   # Returns the string representation of the tree structure.

data/lib/const_conf/version.rb

@@ -1,6 +1,6 @@
 module ConstConf
   # ConstConf version
-  VERSION         = '0.8.2'
+  VERSION         = '0.9.0'
   VERSION_ARRAY   = VERSION.split('.').map(&:to_i) # :nodoc:
   VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
   VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:

data/lib/const_conf.rb

@@ -410,14 +410,17 @@ module ConstConf
     # @param object [Object] the ConstConf module or setting to display
     # @param io [IO, nil] the IO object to write the output to; if nil, uses
     # STDOUT
-    def view(object: self, io: nil)
+    # @param pager [String, nil] the pager command for long output; if nil,
+    #   falls back to the `PAGER` environment variable or `less -r`
+    def view(object: self, io: nil, pager: nil)
+      pager ||= ENV.fetch('PAGER', 'less -r')
       output = ConstConf::Tree.from_const_conf(object).to_a
       if io
         io.puts output
       elsif output.size < Tins::Terminal.lines
         STDOUT.puts output
       else
-        IO.popen(ENV.fetch('PAGER', 'less -r'), ?w) do |f|
+        IO.popen(pager, ?w) do |f|
           f.puts output
           f.close_write
         end

data/spec/const_conf_spec.rb

@@ -265,6 +265,12 @@ describe ConstConf do
             )
             TestConstConf.view
           end
+
+          it 'passes custom pager to IO.popen' do
+            allow(Tins::Terminal).to receive(:lines).and_return(0)
+            expect(IO).to receive(:popen).with('my-custom-pager', ?w)
+            TestConstConf.view(pager: 'my-custom-pager')
+          end
         end
 
         describe '.documentation' do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: const_conf
 version: !ruby/object:Gem::Version
-  version: 0.8.2
+  version: 0.9.0
 platform: ruby
 authors:
 - Florian Frank
@@ -229,7 +229,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.17
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Clean DSL for config settings with validation and Rails integration
 test_files: