yarrow 0.9.0 → 0.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 96b575b4a93031397d38c09ab442ce577a98378114941c6be3dcaf4c2a71a3ac
-  data.tar.gz: 15d01eb7b8f710aee890c8879dc202a12ecab3f3cca0030cdc7df8e61619ed75
+  metadata.gz: f8f774a7c3013a183129ba27e6929cb1d9cb65f784121f61d3df2c1ffba8a4fb
+  data.tar.gz: 7f94b3a971a5fb00d089b6bbad8c12cb724d35f3e00497091130c4731534b275
 SHA512:
-  metadata.gz: be90c39d718849c20db481c2f90d105400af237c7232d4cdd091e7260fffe3d09e4828c4d50f473424daa1d223d2cf5259ed55f4120534ad884ea7ca4d2124dc
-  data.tar.gz: b4e5150cd8a3da147489fe0f8077520df328ae2fc5018e4ea102ca171625ada864da3a08aeb59860a98d04b7515e8f0868a023f85fb10c1718592a066d818b1b
+  metadata.gz: de66835c7de07c4c84802a8adf75e57d637c4865f7a7e2f1f42f06ac0a22adbadfd067c812a6ba8a5be7e8fa03f116173f1a47777c550d38004e0683c6395685
+  data.tar.gz: a7aff55ba63ed7cc2b493b28dd27f415c985bd55730de71732411c2d3500ee0beb0dd21a599b7110599dfb80253bef6b4204a70276b4ed794cf0f2884d3149a1

data/.gitignore

@@ -10,3 +10,4 @@ bin/scripts
 /www
 /web
 /docs
+_*.md

data/lib/yarrow/content/expansion/aggregator.rb

@@ -12,13 +12,13 @@ module Yarrow
         def before_traversal(policy)
         end
 
-        def expand_container(container, policy)
+        def expand_source(container, policy)
         end
 
-        def expand_collection(collection, policy)
+        def expand_directory(collection, policy)
         end
 
-        def expand_entity(entity, policy)
+        def expand_file(entity, policy)
         end
 
         def after_traversal(policy)
@@ -53,13 +53,16 @@ module Yarrow
         end
 
         def create_entity(source_node, parent_path, type, entity_const)
+          contents = Yarrow::Format.read(source_node.props[:path])
+
           # Create an entity node with attached resource model
           entity = graph.create_node do |entity_node|
             attributes = {
               name: source_node.props[:basename],
-              title: source_node.props[:basename].capitalize,
-              body: ""
-            }
+              title: Yarrow::Symbols.to_text(source_node.props[:basename]),
+              body: contents.document.to_s
+            }.merge(contents.metadata)
+            
             entity_node.label = :entity
             entity_node.props[:type] = type
             entity_node.props[:resource] = entity_const.new(attributes)

data/lib/yarrow/content/expansion/basename_merge.rb

@@ -9,18 +9,18 @@ module Yarrow
           @entity_collections = {}
         end
       
-        def expand_container(container, policy)
+        def expand_source(container, policy)
           puts "create_node label=:collection type=:#{policy.collection} name='#{container.props[:basename]}'"
           @container_collection = container.props[:basename]
         end
       
-        def expand_collection(collection, policy)
+        def expand_directory(collection, policy)
           if @container_collection == collection.props[:entry].parent.to_s
             puts "create_node label=:collection type=:#{policy.entity} name='#{collection.props[:basename]}' collection='#{@container_collection}'"
           end
         end
       
-        def expand_entity(entity, policy)
+        def expand_file(entity, policy)
           unless @entity_bundles.key?(entity.props[:basename])
             @entity_bundles[entity.props[:basename]] = []
           end

data/lib/yarrow/content/expansion/directory_map.rb

@@ -2,17 +2,17 @@ module Yarrow
   module Content
     module Expansion
       class DirectoryMap < Aggregator
-        def expand_container(container, policy)
+        def expand_source(container, policy)
           puts "create_node label=:collection type=:#{policy.container} name='#{container.props[:basename]}'"
           @current_collection = container.props[:basename]
         end
 
-        def expand_collection(collection, policy)
+        def expand_directory(collection, policy)
           puts "create_node label=:collection type=:#{policy.collection} name='#{collection.props[:basename]}' collection=#{@current_collection}"
           @current_collection = collection.props[:basename]
         end
 
-        def expand_entity(entity, policy)
+        def expand_file(entity, policy)
           puts "create_node label=:entity type=:#{policy.entity} name='#{entity.props[:basename]}' collection='#{@current_collection}"
         end
       end

data/lib/yarrow/content/expansion/directory_merge.rb

@@ -8,16 +8,16 @@ module Yarrow
           @current_entity = nil
         end
 
-        def expand_container(container, policy)
+        def expand_source(container, policy)
           create_collection(container, policy.container, policy.container_const)
           @current_collection = container.props[:path]
         end
 
-        def expand_collection(collection, policy)
+        def expand_directory(collection, policy)
           @current_entity = collection.props[:basename]
         end
 
-        def expand_entity(entity, policy)
+        def expand_file(entity, policy)
           if entity.props[:basename] == @current_entity && entity.props[:ext] == ".md"
             create_entity(entity, @current_collection, policy.entity, policy.entity_const)
           else

data/lib/yarrow/content/expansion/filename_map.rb

@@ -2,17 +2,17 @@ module Yarrow
   module Content
     module Expansion
       class FilenameMap < Aggregator
-        def expand_container(container, policy)
+        def expand_source(container, policy)
           create_collection(container, policy.container, policy.container_const)
           @current_collection = container.props[:path]
         end
 
-        def expand_collection(collection, policy)
+        def expand_directory(collection, policy)
           create_collection(collection, policy.collection, policy.collection_const)
           @current_collection = collection.props[:path]
         end
 
-        def expand_entity(entity, policy)
+        def expand_file(entity, policy)
           if policy.match_by_extension(entity.props[:ext])
             parent_path = entity.incoming(:directory).first.props[:path]
             create_entity(entity, parent_path, policy.entity, policy.entity_const)

data/lib/yarrow/content/expansion/traversal.rb

@@ -21,45 +21,45 @@ module Yarrow
           end
         end
 
-        def on_root_visited(root_node)
-          aggregator.expand_container(root_node, policy)
+        def visit_source(root_node)
+          aggregator.expand_source(root_node, policy)
         end
 
-        def on_directory_visited(dir_node)
+        def visit_directory(dir_node)
           # TODO: match on potential directory extension/filter
-          aggregator.expand_collection(dir_node, policy)
+          aggregator.expand_directory(dir_node, policy)
         end
 
-        def on_file_visited(file_node)
+        def visit_file(file_node)
           # TODO: dispatch underscore prefix or index files separately
           # TODO: match on file extension
-          aggregator.expand_entity(file_node, policy)
+          aggregator.expand_file(file_node, policy)
         end
 
-        def on_traversal_initiated
+        def start_traversal
           aggregator.before_traversal(policy)
         end
 
-        def on_traversal_completed
+        def complete_traversal
           aggregator.after_traversal(policy)
         end
 
         def expand
-          on_traversal_initiated
+          start_traversal
 
           traversal = source_node.depth_first.each
           
-          on_root_visited(traversal.next)
+          visit_source(traversal.next)
 
           loop do
             node = traversal.next
             case node.label
-            when :directory then on_directory_visited(node)
-            when :file then on_file_visited(node)
+            when :directory then visit_directory(node)
+            when :file then visit_file(node)
             end
           end
 
-          on_traversal_completed
+          complete_traversal
         end
       end
     end

data/lib/yarrow/content/policy.rb

@@ -109,7 +109,7 @@ module Yarrow
         @container = container
         @collection = collection
         @entity = entity
-        @expansion = expansion
+        @expansion = expansion.to_sym
         @extensions = extensions
         @source_path = source_path
         @module_prefix = module_prefix.split(MODULE_SEPARATOR)

data/lib/yarrow/format/markdown.rb

@@ -1,6 +1,6 @@
 module Yarrow
   module Format
-    class Markdown < ContentType[".md", ".markdown"]
+    class Markdown < ContentType[".md", ".markdown", ".htm"]
       include Methods::FrontMatter
 
       def initialize(source)

data/lib/yarrow/format/methods/front_matter.rb

@@ -3,18 +3,75 @@ module Yarrow
     module Methods
       # Utility methods for working with text formats containing frontmatter separators.
       module FrontMatter
+        module Syntax
+          YAML = "-"
+          YAML_DOC_END = "."
+          TOML = "+"
+          MM_JSON = ";"
+          JSON_START = "{"
+          JSON_END = "}"
+
+          PATTERN = /\A
+            (?<start>[\-]{3}|[\+]{3}|[;]{3}|[\{]{1})\s*\r?\n
+            (?<meta>.*?)\r?\n?
+            ^(?<stop>[\-]{3}|[\+]{3}|[;]{3}|[\.]{3}|[\}]{1})\s*\r?\n?
+            \r?\n?
+            (?<body>.*)
+          /mx
+        end
+
         module ClassMethods
           def read(path)
             text = File.read(path, :encoding => "utf-8")
-            source, metadata = read_yfm(path)
+            source, metadata = parse(text)
             Yarrow::Format::Contents.new(new(source), metadata)
           end
 
+          def parse(text)
+            result = Syntax::PATTERN.match(text)
+
+            return [text, nil] if result.nil?
+
+            start_chr = result[:start].chr
+            stop_chr = result[:stop].chr
+            input = result[:meta]
+
+            meta = if start_chr == stop_chr
+              case start_chr
+              when Syntax::YAML then parse_yaml(input)
+              when Syntax::TOML then parse_toml(input)
+              when Syntax::MM_JSON then parse_json(input)
+              end
+            else
+              if start_chr == Syntax::YAML && stop_chr == Syntax::YAML_DOC_END
+                parse_yaml(input)
+              elsif start_chr == Syntax::JSON_START && stop_chr == Syntax::JSON_END
+                parse_json(input)
+              else
+                raise "Unsupported frontmatter delimiters"
+              end
+            end
+
+            [result[:body], meta]
+          end
+
+          def parse_yaml(raw)
+            YAML.load(raw, symbolize_names: true)
+          end
+
+          def parse_toml(raw)
+            TOML::Parser.new(raw).parsed
+          end
+
+          def parse_json(raw)
+            JSON.parse("{#{raw}}", symbolize_names: true)
+          end
+
           def read_yfm(path)
             text = File.read(path, :encoding => 'utf-8')
             extract_yfm(text, symbolize_keys: true)
           end
-  
+
           def extract_yfm(text, options={})
             pattern = /^(---\s*\n.*?\n?)^(---\s*$\n?)/m
             if text =~ pattern

data/lib/yarrow/format.rb

@@ -5,7 +5,7 @@ module Yarrow
 
       def initialize(document, metadata)
         @document = document
-        @metadata = metadata
+        @metadata = metadata || {}
       end
     end
 

data/lib/yarrow/symbols.rb

@@ -30,5 +30,11 @@ module Yarrow
     def self.to_plural(atom)
       Strings::Inflection.pluralize(atom.to_s).to_sym
     end
+
+    # @param [Symbol, String] atom
+    # @return [String]
+    def self.to_text(identifier)
+      identifier.to_s.gsub(/\A[^[:alnum:]]+/, "").gsub(/[\-_]+/, " ").capitalize
+    end
   end
 end

data/lib/yarrow/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 module Yarrow
   APP_NAME = "Yarrow"
-  VERSION = "0.9.0"
+  VERSION = "0.9.1"
 end

data/lib/yarrow/web/generator.rb

@@ -40,7 +40,8 @@ module Yarrow
           file.puts(content)
         end
 
-        puts "[write] #{path} → #{url}"
+        # If stdout logging
+        #puts "[write] #{path} → #{url}"
       end
 
       def generate_sitemap(manifest)

data/lib/yarrow/web/manifest.rb

@@ -56,10 +56,18 @@ module Yarrow
       end
 
       def self.collection_context(collection)
+        # TODO: debug log
+        # puts "collection_context"
+        # p collection.props[:resource].title
+        # p collection
         IndexDocument.new(collection, nil, true)
       end
 
       def self.collection_index_context(collection, entity)
+        # TODO: debug log
+        # puts "collection_index_context"
+        # p collection.props[:resource].title
+        # p entity.props[:resource].title
         IndexDocument.new(collection, entity, false)
       end
 

data/lib/yarrow.rb

@@ -1,6 +1,7 @@
 require "pathname"
 require "yaml"
 require "kramdown"
+require "toml"
 require "mustache"
 require "parallel"
 

data/yarrow.gemspec

@@ -24,6 +24,7 @@ Gem::Specification.new do |spec|
   spec.add_runtime_dependency 'parallel', '~> 1.22.1'
   spec.add_runtime_dependency 'strings-inflection', '~> 0.1'
   spec.add_runtime_dependency 'strings-case', '~> 0.3'
+  spec.add_runtime_dependency 'toml', '~> 0.3.0'
   # https://github.com/joeldrapper/phlex
   spec.add_runtime_dependency 'kramdown', '~> 2.4.0'
   spec.add_development_dependency 'rake', '~> 13.0'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: yarrow
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.9.1
 platform: ruby
 authors:
 - Mark Rickerby
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-04-10 00:00:00.000000000 Z
+date: 2023-09-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -164,6 +164,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: toml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.3.0
 - !ruby/object:Gem::Dependency
   name: kramdown
   requirement: !ruby/object:Gem::Requirement