flora 0.11.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6fa0d4f3614285445c78586bf4d63163cb6419b8944dcb1e614a3e90f5b50925
-  data.tar.gz: 17aaa52cf397c066edb770f98959fa3b9f211e398c1bca87c365d2c157691f5e
+  metadata.gz: 0333fa46d5b40eb06534baaba23d9fd099a2f1384814feb560ff4cdc38702863
+  data.tar.gz: ae45ab23580875aa64eddaae0c806cbb1c7f4be9f5cba7283aa3923ffb978802
 SHA512:
-  metadata.gz: c21a1b6b5ab70780a0e182f99d300239661c36f72cf3d8ea022a6be7edb8374e2b587233648d6939705bd073aeb1234a1e04e041f609f1ea7fcb82b36e99813b
-  data.tar.gz: a92dacb2c646acd722b018eb948d2380567b38438cbf3ee09cc387c689fc0fd2375205e0c0044823f8bd306625ab40a87c34a2764f5969349331b6a9c7e27268
+  metadata.gz: c4dcbb9a3237d1d3c7156894555e859532fe63d978d4845ec608367a8044cc43ee4c9f6e15eef0c3c07a77a1d1848a0f1486b8360a01956e9b48e1638c1eca78
+  data.tar.gz: a5863189034686838ca35636aea54b07247da127c3cd540b945d8fed9c47873ba42b9bc2346e8675232230bcf846e3f630cb79fcf0328a474fb43cfb83582cdd

data/.woodpecker.yml

@@ -0,0 +1,16 @@
+when:
+  - event: push
+  - event: pull_request
+
+matrix:
+  RUBY_VERSION:
+    - 4.0
+    - 3.4
+
+steps:
+    - name: build
+      image: ruby:${RUBY_VERSION}-alpine
+      commands:
+        - apk add alpine-sdk yaml-dev
+        - bundle install
+        - rake

data/lib/flora/config.rb

@@ -1,27 +1,31 @@
 # This is the user-visible configuration class. It lives in ROOT/_config.rb.
 class Flora::Config
 
-  def initialize(file, flora)
+  def initialize(file, plugin_manager)
     @file = file
-    @flora = flora
-    load if @file.exist?
+    @plugin_manager = plugin_manager
   end
 
 
   def use(mod)
-    @flora.load_plugin(mod)
+    @plugin_manager.load(mod)
+
+    # TODO: ideally, this would live in PluginManager, but it needs to pass
+    # Config.
+    mod.loaded(self) if mod.respond_to?(:loaded)
   end
 
 
   def extend_view(mod)
-    Kernel.prepend(mod)
+    @plugin_manager.global_load(mod)
   end
 
 
-  private
+  # :nodoc:
+  def load
+    return unless @file.exist?
 
-    def load
-      instance_eval(@file.read)
-    end
+    instance_eval(@file.read)
+  end
 
 end

data/lib/flora/factory.rb

@@ -14,10 +14,10 @@ class Flora::Factory
 
     @project.blueprints.each do |blueprint|
       out_filename = out_dir.join(blueprint.page_name)
+      @logger.debug("[Flora] #{blueprint.file} => #{out_filename}")
+
       FileUtils.mkdir_p(out_filename.dirname) unless out_filename.dirname.exist?
       out_filename.write(blueprint.render)
-
-      @logger.debug("[Flora] #{blueprint.file} => #{out_filename}")
     end
   end
 

data/lib/flora/plugin_manager.rb

@@ -0,0 +1,28 @@
+class Flora::PluginManager
+
+  def initialize(logger)
+    @logger = logger
+    @pluggables = {}
+  end
+
+
+  def create_pluggable_class(klass)
+    @pluggables[klass] = Class.new(klass)
+  end
+
+
+  def load(mod)
+    @pluggables.each do |base_class, anon_class|
+      name = "#{base_class.name.split('::').last}Methods"
+      anon_class.include(mod.const_get(name)) if mod.const_defined?(name)
+    end
+
+    @logger.debug("[Flora] Plugin #{mod} loaded")
+  end
+
+
+  def global_load(mod)
+    Kernel.include(mod)
+  end
+
+end

data/lib/flora/plugins/blog/post.rb

@@ -18,7 +18,7 @@ class Flora::Plugins::Blog::Post
 
 
   def date
-    @frontmatter['date']
+    @frontmatter['date'].to_time
   end
 
 

data/lib/flora/plugins/blog.rb

@@ -13,10 +13,66 @@ module Flora::Plugins::Blog
       @post = Post.new(file, project.dir)
     end
 
+  end
+
+
+  class Feed
+
+    def initialize(posts, config)
+      @posts = posts
+      @config = config
+    end
+
+
+    def render
+      builder = Nokogiri::XML::Builder.new do |xml|
+        xml.feed(xmlns: 'http://www.w3.org/2005/Atom') do
+          xml.generator('Flora')
+          nokogiri_tag(xml, :title, @config.blog[:title])
+          xml.updated(last_updated.iso8601)
+          nokogiri_tag(xml, :link, href: @config.blog[:url])
+          xml.id(@config.blog[:url])
+          xml.author do
+            xml.name(@config.blog[:author])
+          end
+
+          @posts.each { to_entry(xml, it) }
+        end
+      end
+
+      builder.to_xml
+    end
+
 
     private
 
-      def render_tree
+      def full_url(post)
+        @config.blog[:url] + post.url
+      end
+
+
+      def last_updated
+        @posts[0].date
+      end
+
+
+      def to_entry(xml, post)
+        xml.entry do
+          xml.id(full_url(post))
+          nokogiri_tag(xml, :title, post.title)
+          # TODO: actually support published vs updated.
+          xml.updated(post.date.iso8601)
+          xml.published(post.date.iso8601)
+          nokogiri_tag(xml, :link, rel: 'alternate', href: full_url(post))
+        end
+      end
+
+
+      # Nokogiri's builder uses method_missing, and some of Lilac's tags are
+      # named the same as some of the Atom tags we want to use which causes
+      # conflicts. Use this method to get around that!
+      def nokogiri_tag(xml, tag, *args, **opts, &block)
+        xml.method_missing(tag, *args, **opts, &block)
       end
 
   end
@@ -24,6 +80,13 @@ module Flora::Plugins::Blog
 
   module ProjectMethods
 
+    def self.included(base)
+      base.class_eval do
+        blueprint_classes.prepend(Flora::Plugins::Blog::BlogPost)
+      end
+    end
+
+
     def posts
       @dir.glob('posts/**.md').map { Post.new(it, @dir) }.sort_by(&:date).reverse
     end
@@ -31,7 +94,30 @@ module Flora::Plugins::Blog
   end
 
 
-  module BlueprintMethods
+  module FactoryMethods
+
+    def assemble(out_dir)
+      super
+
+      feed = Feed.new(@project.posts, @config)
+      out_dir.join('feed.xml').write(feed.render)
+    end
+
+  end
+
+
+  module ConfigMethods
+
+    def self.included(base)
+      base.class_eval do
+        attr_accessor(:blog)
+      end
+    end
+
+  end
+
+
+  module ViewExtensions
 
     def posts
       @project.posts
@@ -39,4 +125,9 @@ module Flora::Plugins::Blog
 
   end
 
+
+  def self.loaded(config)
+    config.extend_view(ViewExtensions)
+  end
+
 end

data/lib/flora/plugins/redirector.rb

@@ -26,7 +26,7 @@ module Flora::Plugins::Redirector
   end
 
 
-  module Config
+  module ConfigMethods
 
     def self.included(base)
       base.class_eval do

data/lib/flora/plugins/static_files.rb

@@ -19,7 +19,18 @@ module Flora::Plugins::StaticFiles
   end
 
 
-  module Config
+  module ProjectMethods
+
+    def self.included(base)
+      base.class_eval do
+        blueprint_classes.prepend(Flora::Plugins::StaticFiles::StaticFile)
+      end
+    end
+
+  end
+
+
+  module ConfigMethods
 
     def self.included(base)
       base.class_eval do

data/lib/flora/project/blueprint/{nestable.rb → has_layout.rb}

@@ -1,6 +1,6 @@
-# A Blueprint that includes Nestable is something that can be nested into a
+# A Blueprint that includes HasLayout is something that can be nested into a
 # Lilac-based layout.
-module Flora::Project::Blueprint::Nestable
+module Flora::Project::Blueprint::HasLayout
 
   def render
     # The Html DSL uses a global variable internally that needs to be reset every time.
@@ -19,16 +19,15 @@ module Flora::Project::Blueprint::Nestable
 
     def find_layouts
       layouts = []
+      current = @file.parent
 
-      @file.ascend do |dir|
-        maybe_layout = dir.join('_layout.rb')
+      loop do
+        maybe_layout = current.join('./_layout.rb')
         layouts << maybe_layout if maybe_layout.exist?
-      end
 
-      # Ascend doesn't go to the top level directory.
-      # TODO: Make this code less brittle.
-      maybe_layout = Pathname.new('./_layout.rb')
-      layouts << maybe_layout if maybe_layout.exist?
+        break if current == @project.dir
+        current = current.parent
+      end
 
       layouts
     end
@@ -40,12 +39,13 @@ module Flora::Project::Blueprint::Nestable
       end
 
       cont = -> { render_internal(layouts, i-1, &block) }
-      eval_with_block(layouts[i-1].read, &cont)
+      filename = layouts[i-1].to_s
+      eval_with_block(layouts[i-1].read, filename, &cont)
     end
 
 
-    def eval_with_block(str, &block)
-      eval(str)
+    def eval_with_block(str, filename, &block)
+      eval(str, binding, filename)
     end
 
 end

data/lib/flora/project/blueprint/markdown.rb

@@ -1,6 +1,6 @@
 class Flora::Project::Blueprint::Markdown < Flora::Project::Blueprint
 
-  include Flora::Project::Blueprint::Nestable
+  include Flora::Project::Blueprint::HasLayout
 
 
   def self.recognize(file, config)

data/lib/flora/project/blueprint/ruby_html.rb

@@ -1,6 +1,6 @@
 class Flora::Project::Blueprint::RubyHtml < Flora::Project::Blueprint
 
-  include Flora::Project::Blueprint::Nestable
+  include Flora::Project::Blueprint::HasLayout
 
 
   def self.recognize(file, config)
@@ -11,7 +11,7 @@ class Flora::Project::Blueprint::RubyHtml < Flora::Project::Blueprint
   private
 
     def render_lilac
-      instance_eval(@file.read)
+      instance_eval(@file.read, @file.to_s)
     end
 
 end

data/lib/flora/project/blueprint.rb

@@ -1,17 +1,11 @@
-# A Blueprint is something can be rendered into a File. Sometimes a Blueprint
-# looks very different than the File it renders into, but other times (like for
+# A Blueprint is something can be rendered into a page. Sometimes a Blueprint
+# looks very different than the page it renders into, but other times (like for
 # static files), nothing changes.
 class Flora::Project::Blueprint
 
   attr_reader(:file)
 
 
-  # :nodoc:
-  def self.types
-    ObjectSpace.each_object(Class).select { it < self }
-  end
-
-
   # Returns true if this Blueprint is appropriate for the file.
   #
   # TODO: should this be an instance method somewhere instead?
@@ -28,15 +22,15 @@ class Flora::Project::Blueprint
   end
 
 
-  # The name of the Page this Blueprint makes. By default this is just the
+  # The name of the page this Blueprint makes. By default this is just the
   # filename, but .html, but subclasses can override this.
   def page_name
     @file.relative_path_from(@project.dir).sub_ext('.html').to_s
   end
 
 
-  # Render a Blueprint into a Page for a Website. This is the String contents
-  # of whatever the Page in the final Website looks like.
+  # Render a Blueprint into a page for a Website. This is the String contents
+  # of whatever the page in the final Website looks like.
   def render
     # Override in subclasses!
   end

data/lib/flora/project.rb

@@ -9,6 +9,10 @@ class Flora::Project
 
   IGNORES = ['.git/*', 'lib/**', '**_*.rb']
 
+  def self.blueprint_classes
+    @blueprint_classes ||= [Blueprint::Markdown, Blueprint::RubyHtml]
+  end
+
 
   def initialize(dir, loader, config)
     @dir = dir
@@ -38,7 +42,7 @@ class Flora::Project
         next if IGNORES.any? { file.fnmatch((@dir / it).to_s) }
         next if file.directory?
 
-        klass = Blueprint.types.find {
+        klass = self.class.blueprint_classes.find {
           it.recognize(file.relative_path_from(@dir), @config)
         }
 

data/lib/flora/version.rb

@@ -1,3 +1,3 @@
 class Flora
-  VERSION = '0.11.0'
+  VERSION = '1.0.0'
 end

data/lib/flora.rb

@@ -5,6 +5,7 @@ require 'fileutils'
 require 'logger'
 
 loader = Zeitwerk::Loader.for_gem(warn_on_extra_files: false)
+loader.do_not_eager_load("#{__dir__}/flora/plugins")
 loader.setup
 
 class Flora
@@ -16,19 +17,20 @@ class Flora
     dir = Pathname.new(dir)
 
     @logger = Logger.new(STDOUT, level: ENV['FLORA_LOG'] || 'info')
+    @plugin_manager = PluginManager.new(@logger)
 
     # Inject Lilac into the Kernel so it's available everywhere. Just
     # instance_eval isn't enough because it'll be missing in lib/ code.
     #
     # TODO: is there a less disruptive way to do this?
-    Kernel.prepend(Flora::Lilac)
+    @plugin_manager.global_load(Flora::Lilac)
 
     # The classes that are pluggable get their own instances to avoid conflicting
     # with other instances of Flora in the same process. This is mostly for the
     # unit tests. Maybe one day we can use Ruby::Box or something here instead.
-    @config_class = Class.new(Config)
-    @project_class = Class.new(Project)
-    @factory_class = Class.new(Factory)
+    @config_class = @plugin_manager.create_pluggable_class(Config)
+    @project_class = @plugin_manager.create_pluggable_class(Project)
+    @factory_class = @plugin_manager.create_pluggable_class(Factory)
 
     # This has to be loaded before Config so Config can reference lib/ code.
     @project_loader = Zeitwerk::Loader.new
@@ -38,7 +40,9 @@ class Flora
     @project_loader.enable_reloading
     @project_loader.setup
 
-    @config = @config_class.new(dir.join('_config.rb'), self)
+    @config = @config_class.new(dir.join('_config.rb'), @plugin_manager)
+    @config.load
+
     @project = @project_class.new(dir, @project_loader, @config)
     @factory = @factory_class.new(@project, @config, @logger)
   end
@@ -60,17 +64,6 @@ class Flora
   end
 
 
-  # TODO: it would be nice if this wasn't exposed here. It's just for Config#plugin.
-  def load_plugin(mod)
-    @config_class.include(mod::Config) if defined?(mod::Config)
-    @project_class.include(mod::ProjectMethods) if defined?(mod::ProjectMethods)
-    @factory_class.include(mod::FactoryMethods) if defined?(mod::FactoryMethods)
-
-    # TODO: make this a little more resilient (like the other classes).
-    Flora::Project::Blueprint.include(mod::BlueprintMethods) if defined?(mod::BlueprintMethods)
-  end
-
-
   private
 
     def bench
@@ -80,8 +73,3 @@ class Flora
     end
 
 end
-
-# Built-in Blueprints need to be explicitly loaded or else they won't show up
-# in Blueprint.types.
-loader.load_file("#{__dir__}/flora/project/blueprint/ruby_html.rb")
-loader.load_file("#{__dir__}/flora/project/blueprint/markdown.rb")

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: flora
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Nick Vladimiroff
@@ -142,6 +142,7 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".woodpecker.yml"
 - LICENSE.txt
 - README.md
 - Rakefile
@@ -152,14 +153,15 @@ files:
 - lib/flora/config.rb
 - lib/flora/factory.rb
 - lib/flora/lilac.rb
+- lib/flora/plugin_manager.rb
 - lib/flora/plugins/blog.rb
 - lib/flora/plugins/blog/post.rb
 - lib/flora/plugins/redirector.rb
 - lib/flora/plugins/static_files.rb
 - lib/flora/project.rb
 - lib/flora/project/blueprint.rb
+- lib/flora/project/blueprint/has_layout.rb
 - lib/flora/project/blueprint/markdown.rb
-- lib/flora/project/blueprint/nestable.rb
 - lib/flora/project/blueprint/ruby_html.rb
 - lib/flora/version.rb
 - tmp/.keep
@@ -176,7 +178,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.2.0
+      version: 3.4.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="