flora 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 40ed44ae102275fee1de3f04afaced4471d977191202551df9e0f623b8b0964f
+  data.tar.gz: bdb9bde15da9c73dda13b5ec1fed25821ff8f66526e9d86abf75840673d44338
+SHA512:
+  metadata.gz: b744c499d5047e8f33ee77fab63c41a4ac812b10e464a38456cd45a302187aba1e9fc929241ac8a49da74e58d2b27d8eee7e84aeba33ba69d887374079bfa87f
+  data.tar.gz: 4a489b8bee42df766d7eaeff185df836f1f632f4aa483a1865021e107e43c4336bd7e62d5731d7b91886b334ad42ddf46f37e70b3ae6e1e1d49116a1db180667

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Nick Vladimiroff
+
+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/README.md

@@ -0,0 +1,3 @@
+# Flora
+
+A static site generator.

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+task default: :test

data/exe/flora

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+require 'flora'
+
+Flora::Cli.start

data/lib/flora/app.rb

@@ -0,0 +1,42 @@
+require 'rack'
+
+class Flora::App
+
+  # UGLY. Is there a better way to do this?
+  class StaticWithoutHtml
+
+    def initialize(app, dir)
+      @app = app
+      @dir = dir
+    end
+
+    def call(env)
+      # /about -> about.html
+      html_file = @dir.join(env['REQUEST_PATH'][1..] + '.html')
+      if html_file.exist?
+        [200, {'Content-Type' => 'text/html'}, [html_file.read]]
+      else
+        @app.call(env)
+      end
+    end
+
+  end
+
+
+  def self.app(path)
+    flora = Flora::Engine.new(path, '/tmp/flora/')
+    # TODO: rebuild every req?
+    flora.build
+
+    Rack::Builder.new do
+      use StaticWithoutHtml, flora.out_dir
+      use Rack::Static, urls: [''], root: flora.out_dir.to_s, index: 'index.html'
+      map "/" do
+        run ->(env) do
+          [404, {'Content-Type' => 'text/plain'}, ['Page Not Found!']]
+        end
+      end
+    end
+  end
+
+end

data/lib/flora/cli.rb

@@ -0,0 +1,24 @@
+require 'thor'
+
+class Flora::Cli < Thor
+
+  desc 'build OUT_DIR', 'Build a site'
+  def build(out_dir)
+    Flora::Engine.new('.', out_dir).build
+  end
+
+
+  desc 'serve', 'Serve a site'
+  def serve
+    require 'puma'
+    require 'puma/configuration'
+
+    conf = Puma::Configuration.new do |user_config|
+      user_config.log_requests(true)
+      user_config.bind('tcp://localhost:3000')
+      user_config.app(Flora::App.app('.'))
+    end
+    Puma::Launcher.new(conf, log_writer: Puma::LogWriter.stdio).run
+  end
+
+end

data/lib/flora/engine/config.rb

@@ -0,0 +1,15 @@
+class Flora::Engine::Config
+
+  attr_reader(:plugins)
+
+
+  def initialize
+    @plugins = []
+  end
+
+
+  def plugin(mod)
+    @plugins << mod
+  end
+
+end

data/lib/flora/engine/page/html.rb

@@ -0,0 +1,90 @@
+module Flora::Engine::Page::Html
+
+  TAGS = %i[
+    a abbr address area article aside audio
+    b bdi bdo blockquote body br button
+    canvas caption cite code col colgroup command
+    datalist dd del details dfn div dl dt
+    em embed
+    fieldset figcaption figure footer form
+    h1 h2 h3 h4 h5 h6 head header hr html i iframe img input ins
+    kbd keygen
+    label legend li
+    main map mark menu meter
+    nav
+    object ol optgroup option output
+    p param pre progress
+    q
+    rp rt ruby
+    s samp section select small source span strong sub summary sup
+    table tbody td textarea tfoot th thead time tr track
+    u ul
+    var video
+    wbr
+  ]
+
+
+  class << self
+
+    def to_html(tree)
+      document = Nokogiri::HTML5::Document.new
+      root = to_html_inner(tree, document)
+      document.add_child(root)
+      document.to_html
+    end
+
+
+    private
+
+      def to_html_inner(tree, document)
+        if tree[:text]
+          return document.create_text_node(tree[:text])
+        end
+
+        if tree[:html]
+          return document.fragment("<div>#{tree[:html]}</div>")
+        end
+
+        node = document.create_element(tree[:tag].to_s, **tree[:opts])
+
+        tree[:children].each do |child|
+          child_node = to_html_inner(child, document)
+          node.add_child(child_node)
+        end
+
+        node
+      end
+
+  end
+
+
+  TAGS.each do |tag|
+    define_method(tag) do |*args, **opts, &block|
+      children = []
+
+      if block
+        old_added = $flora_added
+        $flora_added = []
+        result = block.call
+        if result.is_a?(String)
+          children = [{ tag: 'text', opts: {}, text: result, children: [] }]
+        else
+          children = $flora_added
+        end
+        $flora_added = old_added
+      end
+
+      node = { tag:, opts:, children: }
+      $flora_added << node
+      node
+    end
+  end
+
+
+  def raw_html(string)
+    node = { tag: 'raw', opts: {}, html: string, children: [] }
+    $flora_added << node
+    node
+  end
+
+end

data/lib/flora/engine/page/layout.rb

@@ -0,0 +1,29 @@
+class Flora::Engine::Page::Layout
+
+  def initialize(layouts)
+    @layouts = layouts
+  end
+
+
+  def render(&block)
+    render_internal(@layouts.size - 1, &block)
+  end
+
+
+  private
+
+    def render_internal(i, &block)
+      if i <= 0
+        return block.call
+      end
+
+      cont = -> { render_internal(i-1, &block) }
+      eval_with_block(@layouts[i].read, &cont)
+    end
+
+
+    def eval_with_block(str, &block)
+      eval(str)
+    end
+
+end

data/lib/flora/engine/page/markdown_page.rb

@@ -0,0 +1,20 @@
+class Flora::Engine::Page::MarkdownPage < Flora::Engine::Page
+
+  def render
+    silence_warnings do
+      raw_html(Kramdown::Document.new(@file.read).to_html)
+    end
+  end
+
+
+  private
+
+    # Remove this if kramdown ever fixes its one warning.
+    def silence_warnings
+      old_verbose, $VERBOSE = $VERBOSE, nil
+      yield
+    ensure
+      $VERBOSE = old_verbose
+    end
+
+end

data/lib/flora/engine/page/plugin_hooks.rb

@@ -0,0 +1,10 @@
+module Flora::Engine::Page::PluginHooks
+
+  def before_render
+  end
+
+
+  def after_render(html)
+  end
+
+end

data/lib/flora/engine/page/ruby_page.rb

@@ -0,0 +1,8 @@
+class Flora::Engine::Page::RubyPage < Flora::Engine::Page
+
+  def render
+    super
+    instance_eval(@file.read)
+  end
+
+end

data/lib/flora/engine/page.rb

@@ -0,0 +1,56 @@
+# A page is something can be turned into HTML. It might also have a layout to render into.
+class Flora::Engine::Page
+
+  IGNORES = ['.git/*', 'lib/*', '**_layout.rb', '_config.rb']
+
+
+  class << self
+
+    def each(path)
+      path.find do |file|
+        next if IGNORES.any? { file.fnmatch((path / it).to_s) }
+        next if file.directory?
+
+        yield(self.for(path, file))
+      end
+    end
+
+
+    def for(root, file)
+      case file.extname
+      when '.rb'
+        RubyPage.new(root, file)
+      when '.md'
+        MarkdownPage.new(root, file)
+      end
+    end
+
+  end
+
+
+  def initialize(root, file)
+    @root = root
+    @file = file
+  end
+
+
+  def render
+  end
+
+
+  def outname
+    # TODO: this might sub something in the middle instead of just the ext.
+    @file.relative_path_from(@root).sub(@file.extname, '.html')
+  end
+
+
+  def url
+    @file.relative_path_from(@root).sub(@file.extname, '')
+  end
+
+
+  def dir
+    @file.dirname
+  end
+
+end

data/lib/flora/engine.rb

@@ -0,0 +1,61 @@
+class Flora::Engine
+
+  attr_reader(:out_dir)
+
+
+  def initialize(path, out_dir)
+    @path = Pathname.new(path)
+    @out_dir = Pathname.new(out_dir)
+    @out_dir.mkdir unless @out_dir.exist?
+    @config = Config.new
+
+    Kernel.prepend(Flora::Engine::Page::Html)
+  end
+
+
+  def build
+    with_load_path(@path) do
+      config_file = @path.join('_config.rb')
+      @config.instance_eval(config_file.read)  if config_file.exist?
+
+      init_plugins
+
+      Page.each(@path) do |page|
+        layouts = []
+        page.dir.ascend do |dir|
+          maybe_layout = dir.join('_layout.rb')
+          layouts << maybe_layout if maybe_layout.exist?
+          break if dir == @path
+        end
+
+        $flora_added = []
+        tree = Page::Layout.new(layouts).render do
+          page.render
+        end
+        html = Page::Html.to_html(tree)
+
+        out_filename = @out_dir.join(page.outname)
+        out_filename.dirname.mkdir unless out_filename.dirname.exist?
+        out_filename.write(html)
+      end
+    end
+  end
+
+
+  private
+
+    def with_load_path(path)
+      $LOAD_PATH << path.to_s
+      yield
+      $LOAD_PATH.delete(path.to_s)
+    end
+
+
+    def init_plugins
+      @config.plugins.each do |plugin|
+        Page.include(plugin::Page) if self.class.const_defined?("#{plugin}::Page")
+        Page::RubyPage.include(plugin::RubyPage) if self.class.const_defined?("#{plugin}::RubyPage")
+      end
+    end
+
+end

data/lib/flora/version.rb

@@ -0,0 +1,3 @@
+module Flora
+  VERSION = "0.1.1"
+end

data/lib/flora.rb

@@ -0,0 +1,9 @@
+require 'zeitwerk'
+require 'nokogiri'
+require 'kramdown'
+
+loader = Zeitwerk::Loader.for_gem(warn_on_extra_files: false)
+loader.setup
+
+module Flora
+end

data/lib/flora_blog/post.rb

@@ -0,0 +1,37 @@
+class FloraBlog::Post
+
+  def initialize(page)
+    @page = page
+    @frontmatter = parse_frontmatter
+  end
+
+
+  def url
+    'https://google.com'
+  end
+
+
+  def title
+    'google'
+  end
+
+
+  def method_missing(name, ...)
+    return @frontmatter[name] if @frontmatter[name]
+
+    super(name, ...)
+  end
+
+
+  private
+
+    def parse_frontmatter
+      page_data = @page.read
+
+      return {} unless page_data.start_with?('---')
+      /(?<=---\n)(?<yaml>.*)(?=---\n)/m =~ @page.read
+
+      YAML.load(yaml)
+    end
+
+end

data/lib/flora_blog.rb

@@ -0,0 +1,13 @@
+module FloraBlog
+
+  module RubyPage
+
+    def render
+      @posts = @root.glob('posts/**').map { Post.new(it) }
+
+      super
+    end
+
+  end
+
+end

metadata

@@ -0,0 +1,145 @@
+--- !ruby/object:Gem::Specification
+name: flora
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Nick Vladimiroff
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  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: thor
+  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: nokogiri
+  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: kramdown
+  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: rack
+  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'
+- !ruby/object:Gem::Dependency
+  name: puma
+  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'
+email:
+- nickvladimiroff@hey.com
+executables:
+- flora
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- Rakefile
+- exe/flora
+- lib/flora.rb
+- lib/flora/app.rb
+- lib/flora/cli.rb
+- lib/flora/engine.rb
+- lib/flora/engine/config.rb
+- lib/flora/engine/page.rb
+- lib/flora/engine/page/html.rb
+- lib/flora/engine/page/layout.rb
+- lib/flora/engine/page/markdown_page.rb
+- lib/flora/engine/page/plugin_hooks.rb
+- lib/flora/engine/page/ruby_page.rb
+- lib/flora/version.rb
+- lib/flora_blog.rb
+- lib/flora_blog/post.rb
+- tmp/.keep
+homepage: https://code.kat5.dev/nick/flora
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://code.kat5.dev/nick/flora
+  source_code_uri: https://code.kat5.dev/nick/flora
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.0.dev
+specification_version: 4
+summary: A static site generator.
+test_files: []