smart_config 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 025b4afefa2ea50c75c77001460628df27241849a6ccb090dd948a4926db80ce
-  data.tar.gz: 1ca3075c54be54c5a4c11eb0da918c2e7fe1947691bdc9ffc79f55dc70798fa2
+  metadata.gz: 5baec6d3e93cb78128a09ddf0448b50b291c72d41002f161f0adbfcda8f0471d
+  data.tar.gz: 98b529930e526149c73a85080acb0b2b008db88d02e8a75f9720db195721e835
 SHA512:
-  metadata.gz: 152cd53fb92b3e3912acff22748bc17eea6d64523c9759aa6f31dc84e3c16f715a55fd506f9f07e85e412ff9e6091c0b01d06b2411806ef6524cb98dfaffb4da
-  data.tar.gz: da08fd3f31fe6c0b1829ef08642f788c72f0726cc1a9b82c0fae06b96579f03c2dc119292d2780ae74338c9f8fb75b5862ecd69769f96964ea7f6c28899eef56
+  metadata.gz: 83b4657ecdfe488d740ab0494f391cbc8c9436339f0c794790da0e7f376c0a1383d80f9a20768977ca3a70eaa7edf2b3089a3605b148f2a28e5af0c6e14d7554
+  data.tar.gz: 321702e528aa873f3bb7953c72b8b805b75b497dfac2b7aa7060fb914c48f35f528367e5b4b538946db91bd61dd8cda5d5dd467bab5f28e8fb2f5f28afdf6607

data/README.md

@@ -80,7 +80,37 @@ value :hostname, default: 'localhost'
 
 All available options are:
 
-| name      | description                                                                                                                                        |
-|-----------|----------------------------------------------------------------------------------------------------------------------------------------------------|
-| default   | Sets a default value for the field, if no configuration could be found. If this option is not set, getting an unset field will raise an exception. |
-| format    | Sets the format of the field. If this option is not set, the field will be formatted as string.                                                    |
+| name        | description                                                                                                                                        |
+|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------|
+| default     | Sets a default value for the field, if no configuration could be found. If this option is not set, getting an unset field will raise an exception. |
+| format      | Sets the format of the field. If this option is not set, the field will be formatted as string.                                                    |
+| description | A free-form text description of the field. Optional. Used for documentation generation.                                                           |
+
+The `description` option is also accepted on `group`:
+
+```ruby
+group :smtp, description: 'SMTP server settings' do
+  value :hostname, description: 'The SMTP server hostname'
+  value :port, format: :integer, description: 'The SMTP server port'
+end
+```
+
+#### Generating Documentation
+
+`SmartConfig::Markdown` renders a Markdown table documenting all values in a config module, including their descriptions, defaults, and formats:
+
+```ruby
+puts SmartConfig::Markdown.new(Config).render
+```
+
+Output:
+
+```
+| Key            | Description              | Default | Format  |
+|----------------|--------------------------|---------|---------|
+| app_name       |                          | My App  | string  |
+| smtp.hostname  | The SMTP server hostname |         | string  |
+| smtp.port      | The SMTP server port     |         | integer |
+```
+
+Values from nested groups are listed with their full dotted key path. Groups themselves are not rendered as rows.

data/lib/smart_config/markdown.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module SmartConfig
+  #
+  # Generates a markdown table documenting all config values in a SmartConfig module.
+  #
+  class Markdown
+    def initialize(config)
+      @config = config
+    end
+
+    def render
+      rows = collect_entries(@config, [])
+      return '' if rows.empty?
+
+      lines = []
+      lines << '| Key | Description | Default | Format |'
+      lines << '|-----|-------------|---------|--------|'
+      rows.each do |row|
+        cells = [row[:path], row[:description], row[:default], row[:format]]
+        lines << "| #{cells.map { |c| escape(c) }.join(' | ')} |"
+      end
+      lines.join("\n")
+    end
+
+    private
+
+    def escape(value)
+      value.to_s.gsub('|', '\|')
+    end
+
+    def collect_entries(config, prefix)
+      raw = config.instance_variable_get(:@config) || {}
+      raw.flat_map do |key, entry|
+        next_prefix = prefix + [key.to_s]
+        if entry.key?(:group)
+          collect_entries(entry[:group], next_prefix)
+        else
+          [entry_for(entry, next_prefix)]
+        end
+      end
+    end
+
+    def entry_for(entry, prefix)
+      {
+        path: prefix.join('.'),
+        description: entry.fetch(:description, ''),
+        default: entry.key?(:default) ? entry[:default].to_s : '',
+        format: entry[:format].to_s
+      }
+    end
+  end
+end

data/lib/smart_config/values.rb

@@ -13,15 +13,18 @@ module SmartConfig
       @config ||= {}
       key = name.to_sym
       config = opts.reduce({}, :merge)
-      config[:formatter] = SmartConfig::Formatters.find(config.fetch(:format, :string))
+      config[:format] = config.fetch(:format, :string)
+      config[:formatter] = SmartConfig::Formatters.find(config[:format])
       @config[key] = config
       define_singleton_method(name) { format_value(key, get_value(key)) }
     end
 
-    def group(name, &)
+    def group(name, *opts, &)
       @config ||= {}
       key = name.to_sym
+      config = opts.reduce({}, :merge)
       @config[key] ||= {}
+      @config[key].merge!(config)
       @config[key][:group] = SmartConfig::Group.new([namespace, name].compact.flatten, method(:walker), &)
       define_singleton_method(name) { get_value(key) }
     end
@@ -30,6 +33,10 @@ module SmartConfig
       (@config || {}).keys
     end
 
+    def description_for(name)
+      (@config || {})[name.to_sym]&.fetch(:description, '') || ''
+    end
+
     def get_value(name)
       return @config[name][:group] if @config[name].key?(:group)
 

data/lib/smart_config/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SmartConfig
-  VERSION = '0.1.0'
+  VERSION = '0.2.0'
 end

data/lib/smart_config.rb

@@ -12,4 +12,5 @@ require 'smart_config/walker'
 require 'smart_config/values'
 require 'smart_config/group'
 require 'smart_config/config'
+require 'smart_config/markdown'
 require 'smart_config/version'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: smart_config
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Damien MATHIEU
@@ -27,6 +27,7 @@ files:
 - lib/smart_config/formatters/integer.rb
 - lib/smart_config/formatters/string.rb
 - lib/smart_config/group.rb
+- lib/smart_config/markdown.rb
 - lib/smart_config/values.rb
 - lib/smart_config/version.rb
 - lib/smart_config/walker.rb
@@ -49,7 +50,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.16
 specification_version: 4
 summary: A DLS for reading and accessing static configuration
 test_files: []