adocconf 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 114bb62e62dfd948dff12053c7d99d761a946dd79cab5237d09139d3355609d5
+  data.tar.gz: 9f20a3d92931504bf01918cb74204607fe558b660e29cdb99b861d9f476ac2dd
+SHA512:
+  metadata.gz: 79a3a5fd799bfba457d73f3b9b182a5e426e3a90156421154cb12ccf6da4fd85783773696c4930a82b376395cb0ed907cf2c3e80624e7720cfad450e738f97da
+  data.tar.gz: bddd93ffefbbca8091c3ea06ae376421adee8b252dbc2f13bdfc2796a0b2ea408c849bfd8bb00a0a30d4e7db755f1c353e74ee7d2d9f6661a24c60ef05ef5e23

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nathan Hammer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/exe/adocconf

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
+require "adocconf"
+exit Adocconf::CLI.start(ARGV)

data/lib/adocconf/cli.rb

@@ -0,0 +1,28 @@
+module Adocconf
+  class CLI
+    def self.start(argv)
+      command = argv.shift
+
+      case command
+      when "parse"
+        parse_command(argv)
+      else
+        warn "Unknown command: #{command}"
+        1
+      end
+    rescue Adocconf::Error => e
+      warn "error: #{e.message}"
+      1
+    end
+
+    def self.parse_command(argv)
+      path = argv.shift
+      raise ParseError, "No input file provided" if path.nil? || path.strip.empty?
+
+      result = Parser.new.parse_file(path)
+
+      puts JSON.pretty_generate(result)
+      0
+    end
+  end
+end

data/lib/adocconf/errors.rb

@@ -0,0 +1,7 @@
+module Adocconf
+    class Error < StandardError; end
+    class DuplicateKeyError < Error; end
+    class InvalidStructureError < Error; end
+    class UnsupportedNodeError < Error; end
+    class ParseError < Error; end
+end

data/lib/adocconf/extract.rb

@@ -0,0 +1,199 @@
+module Adocconf
+  class Extractor
+    def initialize(document)
+      @document = document
+    end
+
+    def extract
+      extract_node(@document)
+    end
+
+    def extract_node(node)
+      sections = child_sections(node)
+
+      if sections.any?
+        extract_container(node, sections)
+      else
+        extract_value_section(node)
+      end
+    end
+
+    def child_sections(node)
+      return [] unless node.respond_to?(:blocks)
+      node.blocks.select { |block| block.context == :section }
+    end
+
+    def non_section_blocks(node)
+      return [] unless node.respond_to?(:blocks)
+      node.blocks.reject { |block| block.context == :section }
+    end
+
+    def extract_container(_node, sections)
+      result = {}
+
+      sections.each do |section|
+        key = slugify(section.title)
+
+        if result.key?(key)
+          raise DuplicateKeyError, "Duplicate section key: #{key}"
+        end
+
+        result[key] = extract_node(section)
+      end
+
+      result
+    end
+
+    def extract_term_text(term)
+      if term.respond_to?(:text)
+        term.text.to_s
+      else
+        term.to_s
+      end
+    end
+
+    def extract_description_text(description)
+      if description.respond_to?(:text)
+        description.text.to_s.strip
+      elsif description.respond_to?(:blocks) && description.blocks&.any?
+        raise UnsupportedNodeError, "Complex description list values are not supported"
+      else
+        ""
+      end
+    end
+
+    def extract_value_section(node)
+      blocks = non_section_blocks(node)
+      values = []
+
+      blocks.each do |block|
+        case block.context
+        when :dlist
+          values << extract_dlist(block)
+        when :ulist
+          values << extract_ulist(block)
+        when :table
+          values << extract_table(block)
+        when :paragraph
+          # ignored by spec
+        when :open, :example, :listing, :literal, :quote, :verse, :stem, :sidebar, :image, :audio, :video
+          handle_unsupported(block)
+        else
+          handle_unsupported(block)
+        end
+      end
+
+      merge_values(values)
+    end
+
+    def extract_dlist(block)
+      result = {}
+
+      block.items.each do |terms, description|
+        if terms.nil? || terms.empty?
+          raise InvalidStructureError, "Description list item is missing a term"
+        end
+
+        key = extract_term_text(terms.first).strip
+
+        if result.key?(key)
+          raise DuplicateKeyError, "Duplicate key in description list: #{key}"
+        end
+
+        result[key] = extract_description_text(description)
+      end
+
+      result
+    end
+
+    def extract_dlist_term(item)
+      terms = item.respond_to?(:terms) ? item.terms : []
+      raise InvalidStructureError, "Description list item is missing a term" if terms.nil? || terms.empty?
+
+      term = terms.first
+      term.respond_to?(:text) ? term.text : term.to_s
+    end
+
+    def extract_dlist_value(item)
+      return item.text.strip if item.respond_to?(:text) && item.text
+
+      raise UnsupportedNodeError, "Complex description list values are not supported" if item.respond_to?(:blocks) && item.blocks&.any?
+
+      ""
+    end
+
+    def extract_ulist(block)
+      block.items.map do |item|
+        nested_blocks = item.respond_to?(:blocks) ? item.blocks : []
+        nested_lists = nested_blocks.select { |b| b.context == :ulist || b.context == :olist }
+
+        if nested_lists.any?
+          raise UnsupportedNodeError, "Nested lists are not supported"
+        end
+
+        item.text.to_s.strip
+      end
+    end
+
+    def extract_table(block)
+      head_rows = block.rows[:head] || []
+      body_rows = block.rows[:body] || []
+
+      raise InvalidStructureError, "Table must have a header row" if head_rows.empty?
+
+      headers = head_rows.first.map { |cell| cell.text.to_s.strip }
+      raise InvalidStructureError, "Table header cannot be empty" if headers.empty?
+
+      body_rows.map do |row|
+        if row.length != headers.length
+          raise InvalidStructureError,
+                "Table row width mismatch: expected #{headers.length}, got #{row.length}"
+        end
+
+        result = {}
+        headers.zip(row).each do |header, cell|
+          result[header] = cell.text.to_s.strip
+        end
+        result
+      end
+    end
+
+    def merge_values(values)
+      return {} if values.empty?
+      return values.first if values.length == 1
+
+      if values.all? { |value| value.is_a?(Hash) }
+        merged = {}
+
+        values.each do |hash|
+          hash.each do |key, value|
+          if merged.key?(key)
+            raise DuplicateKeyError, "Duplicate merged key: #{key}"
+          end
+
+          merged[key] = value
+        end
+      end
+
+        return merged
+      end
+
+      if values.all? { |value| value.is_a?(Array) }
+        return values.flatten(1)
+      end
+
+      raise InvalidStructureError, "Mixed value types in section are not supported"
+    end
+
+    def slugify(title)
+      value = Slugifier.call(title)
+      raise InvalidStructureError, "Section title produced an empty slug" if value.empty?
+
+      value
+    end
+
+    def handle_unsupported(block)
+      raise UnsupportedNodeError, "Unsupported block context: #{block.context}"
+    end
+  end
+end

data/lib/adocconf/parser.rb

@@ -0,0 +1,14 @@
+module Adocconf
+  class Parser
+    def parse_file(path)
+      raise ParseError, "File not found: #{path}" unless File.file?(path)
+
+      doc = Asciidoctor.load_file(path, safe: :safe, parse: true)
+      Extractor.new(doc).extract
+    rescue Adocconf::Error
+      raise
+    rescue StandardError => e
+      raise ParseError, e.message
+    end
+  end
+end

data/lib/adocconf/slugify.rb

@@ -0,0 +1,13 @@
+module Adocconf
+    module Slugifier
+        module_function
+        def call(value)
+            value.to_s
+                 .downcase
+                 .strip
+                 .gsub(/[^a-z0-9]+/, "_")
+                 .gsub(/-+/, "_")
+                 .gsub(/\A-+|-+\z/, "")
+        end
+    end
+end

data/lib/adocconf/version.rb

@@ -0,0 +1,3 @@
+module Adocconf
+    VERSION = "1.0.0"
+end

data/lib/adocconf.rb

@@ -0,0 +1,9 @@
+require "asciidoctor"
+require "json"
+
+require_relative "adocconf/version"
+require_relative "adocconf/errors"
+require_relative "adocconf/slugify"
+require_relative "adocconf/extract"
+require_relative "adocconf/parser"
+require_relative "adocconf/cli"

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification
+name: adocconf
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Nathan Hammer
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: asciidoctor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: adocconf allows you to create both configuration using AsciiDoc.
+executables:
+- adocconf
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- exe/adocconf
+- lib/adocconf.rb
+- lib/adocconf/cli.rb
+- lib/adocconf/errors.rb
+- lib/adocconf/extract.rb
+- lib/adocconf/parser.rb
+- lib/adocconf/slugify.rb
+- lib/adocconf/version.rb
+homepage: https://github.com/vphammer/adocconf
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.8
+specification_version: 4
+summary: Create configuration using AsciiDoc
+test_files: []