config_file_manager 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e292b152343b7533c6dc061be052d078fb351e9506e54e093dd2070ae82db895
-  data.tar.gz: f37d1f71cf8c1c71e844366832740ba472b0e7b65b0dd1dd11303419f03a84ee
+  metadata.gz: d77a5b859939e565703bc2dc5dce3dd9fe8d4cec4f33c7939585834d991a4e66
+  data.tar.gz: bd75f33acab4a3e6790bbf907d0409a0a24023f87f2a7f1f0236af26590525ca
 SHA512:
-  metadata.gz: 31c41b7c8361f5ed1b29a4acc765f4052985585c2348cc91211cdfc0e83687955965b5bdb2158bfeff7f4d486207237981ab7fe0cdc8301b0f99eaf193af90aa
-  data.tar.gz: da52f61bdee2f0c9d6ce90f2777a47ca92170591771359d1d1cc6262564a869d26016fee418da1455b123519e26f57bbfa7c0b1c644e2a742fab649c4e5de47e
+  metadata.gz: 3ad597c042ac18dcc1502113ad9ba87fb925c76a9ccb2e1e835bab8192a657d4a0ee2d1ce5ee46957db8c2115c0fc608a4a81ac5051ad1d06c7fed9296bb8ee7
+  data.tar.gz: 4bdcdb68a55c6f6166ef65b9ba6cfcb858288723894e219843616dbffd4c43f0da70b0bcc3735c5eff8f040430787f60e045e1223f6dda38af083e87e73d4060

data/.rubocop.yml

@@ -1,5 +1,5 @@
 inherit_gem:
-  rubocop-espago: rubocop.yml
+  rubocop-espago: sorbet.yml
 
 AllCops:
-  TargetRubyVersion: 3.0
+  TargetRubyVersion: 3.3

data/.ruby-version

@@ -0,0 +1 @@
+4.0.6

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+## [0.1.4] - 2026-09-01
+
+- Add recursive example directories
+- Switch from YARD to RBS comments
+
 ## [0.1.3] - 2023-11-30
 
 - Add json parsing

data/lib/config_file_manager/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class ConfigFileManager # rubocop:disable Style/StaticClass
-  VERSION = '0.1.3'
+  VERSION = '0.1.4'
 end

data/lib/config_file_manager.rb

@@ -1,3 +1,4 @@
+# typed: true
 # frozen_string_literal: true
 
 require 'fileutils'
@@ -14,29 +15,30 @@ class ConfigFileManager
 
   # Absolute path to the main directory that contains all config files (and subdirectories).
   #
-  # @return [String]
+  #: String
   attr_reader :config_dir
 
   # Maximum depth of nested directories containing config files.
   #
-  # @return [Integer]
+  #: Integer
   attr_reader :max_dir_depth
 
   # Current environment name. Used to load the correct section of YAML files.
   #
-  # @return [String]
+  #: String
   attr_reader :env
 
   # Extension of the example/dummy version of a config file.
   # eg. `.example`, `.dummy`
   #
-  # @return [String]
+  #: String
   attr_reader :example_extension
 
-  # @param config_dir [String] Absolute path to the root config directory
-  # @param example_extension [String]
-  # @param max_dir_depth [Integer] Maximum depth of nested directories containing config files.
-  # @param env [String] Current environment name
+  # @param config_dir Absolute path to the root config directory
+  # @param max_dir_depth Maximum depth of nested directories containing config files.
+  # @param env Current environment name
+  #
+  #: (String config_dir, ?example_extension: String, ?max_dir_depth: Integer, ?env: String) -> void
   def initialize(config_dir, example_extension: '.example', max_dir_depth: 5, env: 'development')
     @config_dir = config_dir
     @example_extension = example_extension
@@ -49,8 +51,9 @@ class ConfigFileManager
   # Returns an array of absolute paths to the found files
   # with the specified extension stripped away.
   #
-  # @param example_extension [String] File extension of example files
-  # @return [Array<String>]
+  # @param example_extension File extension of example files
+  #
+  #: (?example_extension: String, ?result: Array[String], ?depth: Integer, ?dir_path: String) -> Array[String]
   def files(example_extension: @example_extension, result: [], depth: 0, dir_path: @config_dir)
     return result if depth > @max_dir_depth
 
@@ -62,9 +65,9 @@ class ConfigFileManager
         # this essentially performs a depth limited search (DFS with a depth limit)
         next files(
           example_extension: example_extension,
-          result: result,
-          depth: depth + 1,
-          dir_path: abs_path
+          result:            result,
+          depth:             depth + 1,
+          dir_path:          abs_path,
         )
       end
 
@@ -76,8 +79,9 @@ class ConfigFileManager
     result
   end
 
-  # @param example_extension [String]
-  # @return [Array<String>] Absolute paths to missing config files.
+  # Absolute paths to missing config files.
+  #
+  #: (?example_extension: String) -> Array[String]
   def missing_files(example_extension: @example_extension)
     files(example_extension: example_extension).reject do |file|
       ::File.exist?(file)
@@ -86,9 +90,7 @@ class ConfigFileManager
 
   # Create the missing config files based on their dummy/example versions.
   #
-  # @param example_extension [String]
-  # @param print [Boolean]
-  # @return [void]
+  #: (?example_extension: String, ?print: bool) -> void
   def create_missing_files(example_extension: @example_extension, print: false)
     puts COLORS.blue('== Copying missing config files ==') if print
     files(example_extension: example_extension).each do |file|
@@ -96,22 +98,44 @@ class ConfigFileManager
     end
   end
 
-  # Search for directories under the `config_dir` directory
-  # with the specified ending (eg. `.example`).
-  # Returns an array of absolute paths to the found files
-  # with the specified ending stripped away.
+  # Recursively search for directories under the `config_dir` directory
+  # with the specified extension (eg. `.example`).
+  # Returns an array of absolute paths to the found directories
+  # with the specified extension stripped away.
+  #
+  # @param example_extension ending of example directories
   #
-  # @param example_extension [String] ending of example directories
-  # @return [Array<String>]
-  def dirs(example_extension: @example_extension)
-    ::Dir.each_child(@config_dir)
-         .map { ::File.join(@config_dir, _1) }
-         .select { ::File.directory?(_1) && _1.end_with?(example_extension) }
-         .map { _1.delete_suffix(example_extension) }
+  #: (?example_extension: String, ?result: Array[String], ?depth: Integer, ?dir_path: String) -> Array[String]
+  def dirs(example_extension: @example_extension, result: [], depth: 0, root_dir_path: @config_dir)
+    return result if depth > @max_dir_depth
+
+    ::Dir.each_child(root_dir_path) do |path|
+      abs_path = ::File.join(root_dir_path, path)
+
+      next unless ::File.directory?(abs_path)
+
+      # if the entry is a directory with the example extension, add it to the result array
+      if path.end_with?(example_extension)
+        result << abs_path.delete_suffix(example_extension)
+        next
+      end
+
+      # if the entry is a directory without the example extension, scan it recursively
+      # this essentially performs a depth limited search (DFS with a depth limit)
+      next dirs(
+        example_extension: example_extension,
+        result:            result,
+        depth:             depth + 1,
+        root_dir_path:     abs_path,
+      )
+    end
+
+    result
   end
 
-  # @param example_extension [String]
-  # @return [Array<String>] Absolute paths to missing config directories.
+  # Absolute paths to missing config directories.
+  #
+  #: (?example_extension: String) -> Array[String]
   def missing_dirs(example_extension: @example_extension)
     dirs(example_extension: example_extension).reject do |file|
       ::Dir.exist?(file)
@@ -120,9 +144,7 @@ class ConfigFileManager
 
   # Create the missing config directories based on their dummy/example versions.
   #
-  # @param example_extension [String]
-  # @param print [Boolean]
-  # @return [void]
+  #: (?example_extension: String, ?print: bool) -> void
   def create_missing_dirs(example_extension: @example_extension, print: false)
     puts COLORS.blue('== Copying missing config directories ==') if print
     dirs(example_extension: example_extension).each do |dir|
@@ -133,8 +155,7 @@ class ConfigFileManager
   # Converts a collection of absolute paths to an array of
   # relative paths.
   #
-  # @param absolute_paths [Array<String>]
-  # @return [Array<String>]
+  #: (Array[String] absolute_paths) -> Array[String]
   def to_relative_paths(absolute_paths)
     absolute_paths.map do |path|
       to_relative_path(path)
@@ -143,8 +164,7 @@ class ConfigFileManager
 
   # Converts an absolute path to a relative path
   #
-  # @param absolute_path [String]
-  # @return [String]
+  #: (String absolute_path) -> String
   def to_relative_path(absolute_path)
     absolute_path.delete_prefix("#{@config_dir}/")
   end
@@ -152,8 +172,7 @@ class ConfigFileManager
   # Converts a collection of relative paths to an array of
   # absolute paths.
   #
-  # @param relative_paths [Array<String>]
-  # @return [Array<String>]
+  #: (Array[String] relative_paths) -> Array[String]
   def to_absolute_paths(relative_paths)
     relative_paths.map do |path|
       to_absolute_path(path)
@@ -162,16 +181,14 @@ class ConfigFileManager
 
   # Converts a relative path to an absolute path.
   #
-  # @param relative_path [String]
-  # @return [String]
+  #: (String relative_path) -> String
   def to_absolute_path(relative_path)
     "#{@config_dir}/#{relative_path}"
   end
 
-  # @param file_name [Array<String>]
-  # @param env [String, nil]
-  # @param symbolize [Boolean] Whether the keys should be converted to Ruby symbols
-  # @return [Hash, Array]
+  # @param symbolize Whether the keys should be converted to Ruby symbols
+  #
+  #: (*String file_name, ?env: String?, ?symbolize: bool) -> untyped
   def load_yaml(*file_name, env: @env, symbolize: true)
     env = env.to_sym if env && symbolize
     parsed = ruby_load_yaml(load_erb(*file_name), symbolize_names: symbolize)
@@ -180,10 +197,9 @@ class ConfigFileManager
     parsed[env]
   end
 
-  # @param file_name [Array<String>]
-  # @param env [String, nil]
-  # @param symbolize [Boolean] Whether the keys should be converted to Ruby symbols
-  # @return [Hash, Array]
+  # @param symbolize Whether the keys should be converted to Ruby symbols
+  #
+  #: (*String file_name, ?env: String?, ?symbolize: bool) -> untyped
   def load_json(*file_name, env: @env, symbolize: true)
     env = env.to_sym if env && symbolize
     parsed = ::JSON.parse(load_erb(*file_name), symbolize_names: symbolize)
@@ -192,43 +208,39 @@ class ConfigFileManager
     parsed[env]
   end
 
-  # @param file_name [Array<String>]
+  #: (*String file_name) -> void
   def delete_file(*file_name)
     ::File.delete(file_path(*file_name))
   end
 
-  # @param dir_name [Array<String>]
+  #: (*String dir_name) -> void
   def delete_dir(*dir_name)
     ::FileUtils.rm_r(file_path(*dir_name))
   end
 
-  # @param file_name [Array<String>]
-  # @return [String]
+  #: (*String file_name) -> String
   def load_erb(*file_name)
     ::ERB.new(load_file(*file_name)).result
   end
 
-  # @param file_name [Array<String>]
-  # @return [String]
   # @raise [SystemCallError]
+  #
+  #: (*String file_name) -> String
   def load_file(*file_name)
     ::File.read file_path(*file_name)
   end
 
-  # @param file_name [Array<String>]
-  # @return [Boolean]
+  #: (*String file_name) -> bool
   def file_exist?(*file_name)
     ::File.exist? file_path(*file_name)
   end
 
-  # @param dir_name [Array<String>]
-  # @return [Boolean]
+  #: (*String dir_name) -> bool
   def dir_exist?(*dir_name)
     ::Dir.exist? file_path(*dir_name)
   end
 
-  # @param file_name [Array<String>]
-  # @return [String]
+  #: (*String file_name) -> String
   def file_path(*file_name)
     *path, name = file_name
     ::File.join(@config_dir, *path, name)
@@ -237,19 +249,22 @@ class ConfigFileManager
   private
 
   if ::Psych::VERSION >= '4'
-    def ruby_load_yaml(content, **options) # rubocop:disable Style/DocumentationMethod
-      ::YAML.load(content, aliases: true, **options) # rubocop:disable Security/YAMLLoad
+    # Load YAML content using the Psych 4+ API.
+    #
+    #: (String content, **untyped options) -> untyped
+    def ruby_load_yaml(content, **options)
+      ::YAML.load(content, aliases: true, **options)
     end
   else
-    def ruby_load_yaml(content, **options) # rubocop:disable Style/DocumentationMethod
-      ::YAML.load(content, **options) # rubocop:disable Security/YAMLLoad
+    # Load YAML content using the pre Psych 4 API.
+    #
+    #: (String content, **untyped options) -> untyped
+    def ruby_load_yaml(content, **options)
+      ::YAML.load(content, **options)
     end
   end
 
-  # @param original_name [String]
-  # @param new_name [String]
-  # @param print [Boolean]
-  # @return [Boolean]
+  #: (String original_name, String new_name, ?print: bool) -> bool
   def create_missing_file(original_name, new_name, print: false)
     return false if ::File.exist?(new_name)
 
@@ -262,10 +277,7 @@ class ConfigFileManager
     true
   end
 
-  # @param original_name [String]
-  # @param new_name [String]
-  # @param print [Boolean]
-  # @return [Boolean]
+  #: (String original_name, String new_name, ?print: bool) -> bool
   def create_missing_dir(original_name, new_name, print: false)
     return false if ::Dir.exist?(new_name)
 

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: config_file_manager
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Mateusz Drewniak
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-11-30 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pastel
@@ -32,13 +31,13 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".rubocop.yml"
+- ".ruby-version"
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
 - Rakefile
 - lib/config_file_manager.rb
 - lib/config_file_manager/version.rb
-- sig/config_loader.rbs
 homepage: https://github.com/Verseth/ruby-config-loader
 licenses:
 - MIT
@@ -46,7 +45,6 @@ metadata:
   homepage_uri: https://github.com/Verseth/ruby-config-loader
   source_code_uri: https://github.com/Verseth/ruby-config-loader
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -54,15 +52,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.0.0
+      version: 3.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.21
-signing_key:
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Gem that makes it easy to load config files.
 test_files: []

data/sig/config_loader.rbs

@@ -1,4 +0,0 @@
-module ConfigFileManager
-  VERSION: String
-  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-end