gloo-md 1.1 → 1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d4263fc76f70591ae470fa3bf72800df6bc2055fe6ea73610940d4bc398548b6
-  data.tar.gz: f645e639d0759dab026b38d8b266a4e67004c977039402b6c4efac5a0ee12008
+  metadata.gz: 26d3d6ba34f0daaa4881b63fa84848e8ad01043d34357e67d93aad97d85bfe64
+  data.tar.gz: cd27b868d2846861b17031cbf2076c24b1f1d996238f208d5e2a1760533086d3
 SHA512:
-  metadata.gz: c885359772e7b95bcf53baa9d2e62db12f9a03a86dce068a03c8c1eb9ea8aa9f10ea07252a929ebef0ad373b364f9b43fd6a6427aff134e6586468d9f2f7972c
-  data.tar.gz: 5bce0c04c4cc2f76e54fa69b6aa2b86b1f5506953eb04de23274c1102e5afc7c40d74e81340443da7a706d59f603826ed1e5964567c61ef50e4f120d29abb672
+  metadata.gz: 670f1cc4ca37f23fcd67ae241c26bb8c334d9cef5a49de5b5d4b3ac587e629d5f02a3999fdf390c1642c94aeec829b63ccbc4bb6da49a338fb317d81ff0ca2ba
+  data.tar.gz: cc147be4c2af1f0a82e64e504e397d6f76f32cc11e34c38d85645e6ef69324339d67b34f416e5d1a3c948cf9abfa5c37fe48236745031712a487c4c29d77aefd

data/lib/gloo-md.rb

@@ -4,18 +4,20 @@
 # This file is loaded when someone does `require 'gloo-md'`
 # 
 require 'md'
+require 'md_doc'
 require 'markdown_ext'
 
-# 
+#
 # Registers the extension.
-# 
+#
 class MdInit < Gloo::Plugin::Base
 
-    # 
+    #
     # Register verbs and objects.
-    # 
+    #
     def register( callback )
       callback.register_obj( Md )
+      callback.register_obj( MdDoc )
     end
 
 end

data/lib/md_doc.rb

@@ -0,0 +1,178 @@
+# Author::    Eric Crane  (mailto:eric.crane@mac.com)
+# Copyright:: Copyright (c) 2026 Eric Crane.  All rights reserved.
+#
+# A Markdown document with YAML frontmatter.
+# Holds a file path and exposes the frontmatter fields as container
+# children and the Markdown body as a text child.
+#
+require 'yaml'
+
+class MdDoc < Gloo::Core::Obj
+
+  KEYWORD       = 'md_doc'.freeze
+  KEYWORD_SHORT = 'md_doc'.freeze
+
+  PATH        = 'path'.freeze
+  FRONTMATTER = 'frontmatter'.freeze
+  BODY        = 'body'.freeze
+
+
+  # ---------------------------------------------------------------------
+  #    Type identity
+  # ---------------------------------------------------------------------
+
+  #
+  # The name of the object type.
+  #
+  def self.typename
+    return KEYWORD
+  end
+
+  #
+  # The short name of the object type.
+  #
+  def self.short_typename
+    return KEYWORD_SHORT
+  end
+
+  #
+  # Set the value with any necessary type conversions.
+  #
+  def set_value( new_value )
+    self.value = new_value.to_s
+  end
+
+
+  # ---------------------------------------------------------------------
+  #    Children
+  # ---------------------------------------------------------------------
+
+  #
+  # Does this object have children to add when an object
+  # is created in interactive mode?
+  #
+  def add_children_on_create?
+    return true
+  end
+
+  #
+  # Add the default children: path, frontmatter, body.
+  #
+  def add_default_children
+    fac = @engine.factory
+    fac.create_file PATH, nil, self
+    fac.create_can FRONTMATTER, self
+    fac.create_text BODY, nil, self
+  end
+
+
+  # ---------------------------------------------------------------------
+  #    Messages
+  # ---------------------------------------------------------------------
+
+  #
+  # Get a list of message names that this object receives.
+  #
+  def self.messages
+    return super + %w[read write]
+  end
+
+  #
+  # Read the file at path, parse frontmatter and body, populate children.
+  # Frontmatter children are created dynamically from whatever keys are present.
+  #
+  def msg_read
+    path = resolve_path
+    return unless path
+
+    unless File.exist?( path )
+      @engine.log.error "md_doc file not found: #{path}"
+      return
+    end
+
+    content = File.read( path )
+    fm_hash, body_text = parse_frontmatter( content )
+
+    fm_can = find_child FRONTMATTER
+    if fm_can && fm_hash
+      fm_hash.each do |key, val|
+        child = fm_can.find_add_child( key.to_s, 'string' )
+        child.set_value val.to_s
+      end
+    end
+
+    body = find_child BODY
+    body.set_value( body_text ) if body
+  end
+
+  #
+  # Serialize frontmatter and body children back to the file at path.
+  # Creates the file if it does not exist.
+  #
+  def msg_write
+    path = resolve_path
+    return unless path
+
+    fm_can = find_child FRONTMATTER
+    fm_hash = {}
+    if fm_can
+      fm_can.children.each do |child|
+        fm_hash[ child.name ] = child.value
+      end
+    end
+
+    body = find_child BODY
+    body_text = body ? body.value.to_s : ''
+
+    content = build_content( fm_hash, body_text )
+    File.write( File.expand_path( path ), content )
+  end
+
+
+  # ---------------------------------------------------------------------
+  #    Private helpers
+  # ---------------------------------------------------------------------
+
+  private
+
+  #
+  # Get the expanded path string from the path child.
+  #
+  def resolve_path
+    o = find_child PATH
+    return nil unless o
+    return nil if o.value.to_s.strip.empty?
+
+    File.expand_path( o.value.to_s )
+  end
+
+  #
+  # Parse YAML frontmatter from file content.
+  # Returns [fm_hash, body_text]. If there is no frontmatter block,
+  # fm_hash is empty and body_text is the full content.
+  #
+  def parse_frontmatter( content )
+    if content =~ /\A---\s*\n(.*?\n)---\s*\n?(.*)\z/m
+      fm_hash   = YAML.safe_load( $1 ) || {}
+      body_text = $2
+      return fm_hash, body_text
+    end
+
+    return {}, content
+  end
+
+  #
+  # Build the file content string from a frontmatter hash and body text.
+  # Emits frontmatter as YAML between --- delimiters.
+  #
+  def build_content( fm_hash, body_text )
+    if fm_hash.empty?
+      return body_text
+    end
+
+    # to_yaml emits "---\nkey: val\n"; strip the leading "---\n" and rewrap.
+    fm_yaml = fm_hash.to_yaml.sub( /\A---\n/, '' )
+    "---\n#{fm_yaml}---\n#{body_text}"
+  end
+
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gloo-md
 version: !ruby/object:Gem::Version
-  version: '1.1'
+  version: '1.2'
 platform: ruby
 authors:
 - Eric Crane
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-11 00:00:00.000000000 Z
+date: 2026-06-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: redcarpet
@@ -34,6 +34,7 @@ files:
 - lib/gloo-md.rb
 - lib/markdown_ext.rb
 - lib/md.rb
+- lib/md_doc.rb
 homepage: https://gloo.ecrane.us/
 licenses:
 - MIT