cc-os/plugins/os-backlog/lib/backlog/config.rb

module Backlog
  # The parsed contents of a repo's `.cc-os/config`. The file format is
  # '#'-commented key=value lines — the contract is owned by os-status
  # (plugins/os-status/hooks/state.py); legacy `key: value` YAML lines
  # from earlier os-backlog versions are still read for compatibility.
  # Never touches the filesystem itself — callers read the file and pass
  # its contents (or nil, if absent) in.
  class Config
    def initialize(contents)
      @data = {}
      contents.to_s.each_line do |line|
        line = line.strip
        next if line.empty? || line.start_with?("#") || line == "---"

        if line.include?("=")
          key, value = line.split("=", 2)
        elsif line.include?(": ")
          key, value = line.split(": ", 2)
        else
          next
        end
        @data[key.strip] = value.strip
      end
    end

    # @return [String, nil] the explicit board name override, if configured
    def board
      @data["board"]
    end

    # @return [String, nil] the tracker key (e.g. "forgejo:owner/repo"), if configured
    def tracker
      @data["tracker"]
    end

    def configured? = !board.nil?
    def tracker_configured? = !tracker.nil?

    # @return [Hash] a copy of the parsed config data
    def to_h = @data.dup

    # Return new key=value contents with `key` set to `value`, preserving
    # every other key already present in `contents` (legacy YAML-style
    # lines are rewritten to key=value). Pure — does not touch the
    # filesystem; callers read/write the file themselves.
    #
    # @param contents [String, nil] existing raw `.cc-os/config` contents
    # @param key [String, Symbol] key to set
    # @param value [Object] value to set it to
    # @return [String] the updated key=value contents
    def self.merge(contents, key, value)
      data = new(contents).to_h
      data[key.to_s] = value.to_s
      data.map { |k, v| "#{k}=#{v}\n" }.join
    end
  end
end