yass 0.0.1

data/lib/template/site/index.default.html.liquid

@@ -0,0 +1 @@
+<h1>Home</h1>

data/lib/template/templates/css_links.liquid

@@ -0,0 +1,4 @@
+{% assign css_files = files | where: "extname", ".css" -%}
+{% for file in css_files %}
+    <link rel="stylesheet" href="{{ file.url | relative_to: page.url }}">
+{% endfor %}

data/lib/template/templates/js_scripts.liquid

@@ -0,0 +1,4 @@
+{% assign js_files = files | where: "extname", ".js" -%}
+{% for file in js_files %}
+    <script src="{{ file.url | relative_to: page.url }}"></script>
+{% endfor %}

data/lib/yass/cli/helpers.rb

@@ -0,0 +1,71 @@
+require 'optparse'
+
+module Yass
+  module CLI
+    module Helpers
+      def self.get_cmd(argv)
+        argv[0].to_s.to_sym
+      end
+
+      def self.get_args!(argv, max: nil)
+        args = argv[1..]
+        if max && args.size > max
+          $stderr.puts "Expected no more than #{max} args, found #{args.size}"
+          exit 1
+        end
+        args
+      end
+
+      def self.get_opts!
+        config = default_config
+        parser = option_parser config
+        parser.parse!
+        config
+      end
+
+      def self.help!
+        config = default_config
+        parser = option_parser config
+        config.stdout.puts parser.help
+        exit 1
+      end
+
+      def self.option_parser(config)
+        OptionParser.new { |opts|
+          opts.banner = %(
+Yet Another Static Site (generator)
+
+yass <command> [options] [path/to/dir]
+
+  Build the site:
+      yass build
+      yass build path/to/dir
+
+  Create a new site:
+      yass init <path/to/dir>
+
+  Options:
+          ).strip
+          opts.on("--local", "Build in local mode (with links to /index.html's)") { |l| config.local = true }
+          opts.on("--debug", "Print stack traces") { |l| config.debug = true }
+          opts.on("-h", "--help", "Prints this help") { config.stdout.puts opts; exit }
+        }
+      end
+
+      def self.default_config
+        Config.new({
+          root: Pathname.new(Dir.pwd),
+          src: "site",
+          layouts: "layouts",
+          templates: "templates",
+          dest: "dist",
+          local: false,
+          stdin: $stdin,
+          stdout: $stdout,
+          stderr: $stderr,
+          debug: false,
+        })
+      end
+    end
+  end
+end

data/lib/yass/cli/runner.rb

@@ -0,0 +1,38 @@
+require 'fileutils'
+
+module Yass
+  module CLI
+    module Runner
+      INIT_DIR = Pathname.new(File.expand_path(File.join("..", "..", "..", "template"), __FILE__))
+
+      def self.build(config, argv:)
+        args = Helpers.get_args!(argv, max: 1)
+        config.root = Pathname.new(args[0] || Dir.pwd)
+        Generator.new(config).generate!
+        return 0
+      rescue => e
+        raise e if config.debug
+        config.stderr.puts "#{e.class.name}: #{e.message}"
+        return 1
+      end
+
+      def self.init(config, argv:)
+        args = Helpers.get_args!(argv, max: 1)
+        config.root = Pathname.new(args[0] || Dir.pwd)
+
+        Dir[INIT_DIR.join("**/*.*")].each do |path|
+          dest = config.root.join Pathname.new(path).relative_path_from(INIT_DIR)
+          config.stdout.puts "Creating #{dest}"
+          FileUtils.mkdir_p dest.dirname unless dest.dirname.exist?
+          FileUtils.cp(path, dest) unless dest.exist?
+        end
+
+        return 0
+      rescue => e
+        raise e if config.debug
+        config.stderr.puts "#{e.class.name}: #{e.message}"
+        return 1
+      end
+    end
+  end
+end

data/lib/yass/cli.rb

@@ -0,0 +1,6 @@
+module Yass
+  module CLI
+    autoload :Helpers, 'yass/cli/helpers'
+    autoload :Runner, 'yass/cli/runner'
+  end
+end

data/lib/yass/config.rb

@@ -0,0 +1,32 @@
+module Yass
+  Config = Struct.new(:root, :src, :dest, :layouts, :templates, :local, :stdin, :stdout, :stderr, :debug, keyword_init: true) do
+    def src_dir = root.join src
+    def dest_dir = root.join dest
+    def template_dir = root.join templates
+    def layout_dir = root.join layouts
+
+    def layout_cache
+      @layout_cache ||= Dir[layout_dir.join("*.liquid")].each_with_object({}) do |path, acc|
+        path = Pathname.new(path)
+        name = path.basename.to_s
+        acc[name.sub(/\.liquid$/, "")] = LiquidTemplate.compile(self, name, path.read)
+      end.freeze
+    end
+
+    def sources
+      @sources ||= Dir[src_dir.join("**", "*")]
+        .reject { |path| Dir.exist? path }
+        .map { |path| Pathname.new path }
+        .map { |path| Source.new(self, path) }
+    end
+
+    def liquid_env
+      @liquid_env ||= Liquid::Environment.build do |env|
+        env.error_mode = :strict
+        env.file_system = Liquid::LocalFileSystem.new(template_dir.to_s, "%s.liquid")
+        env.register_filter LiquidFilters
+        env.register_tag 'highlight', LiquidHighlightTag
+      end
+    end
+  end
+end

data/lib/yass/generator.rb

@@ -0,0 +1,47 @@
+require 'fileutils'
+
+module Yass
+  class Generator
+    attr_reader :config
+
+    def initialize(config)
+      @config = config
+    end
+
+    def generate!
+      dest_dirs.each { |dir| FileUtils.mkdir_p dir }
+      config.sources.each do |source|
+        outfile = config.dest_dir.join(source.relative_path)
+        if source.dynamic?
+          outfile, content = generate(source, outfile)
+          outfile.write content
+        else
+          FileUtils.cp(source.path, outfile)
+        end
+      end
+    end
+
+    private
+
+    def generate(source, outfile, content = source.path.read)
+      case outfile.extname
+      when ".md"
+        content = Kramdown::Document.new(content).to_html
+        return generate(source, outfile.sub(/\.md$/, ".html"), content)
+      when ".liquid"
+        template = LiquidTemplate.compile(config, source.relative_path, content)
+        content = template.render(source)
+        return generate(source, outfile.sub(/\.liquid$/, ""), content)
+      else
+        return outfile, content if source.layout.nil?
+
+        page = source.layout.render(source) { content }
+        return outfile.dirname.join(source.rendered_filename), page
+      end
+    end
+
+    def dest_dirs
+      config.sources.map { |s| config.dest_dir.join(s.relative_path).dirname }.uniq
+    end
+  end
+end

data/lib/yass/liquid_filters.rb

@@ -0,0 +1,10 @@
+module Yass
+  module LiquidFilters
+    def relative_to(url, to)
+      url, to = Pathname.new(url), Pathname.new(to)
+      in_root = to.dirname.to_s == "."
+      updirs = in_root ? [] : to.dirname.to_s.split("/").map { ".." }
+      Pathname.new([*updirs, url].join("/")).to_s
+    end
+  end
+end

data/lib/yass/liquid_highlight_tag.rb

@@ -0,0 +1,14 @@
+module Yass
+  class LiquidHighlightTag < Liquid::Block
+    attr_reader :lang
+
+    def initialize(_tag_name, lang, _tokens)
+      super
+      @lang = lang.strip
+    end
+
+    def render(_context)
+      %(<pre><code class="language-#{lang}">#{super}</code></pre>)
+    end
+  end
+end

data/lib/yass/liquid_template.rb

@@ -0,0 +1,49 @@
+module Yass
+  class LiquidTemplate
+    def self.compile(config, name, src)
+      template = Liquid::Template.parse(src, environment: config.liquid_env)
+      new(name, template)
+    end
+
+    attr_reader :name
+
+    def initialize(name, template)
+      @name = name
+      @template = template
+    end
+
+    def render(source)
+      vars = { "page" => page_attrs(source), "files" => files_attrs(source.config.sources) }
+      vars["content"] = yield if block_given?
+      content = @template.render(vars, { strict_variables: true, strict_filters: true })
+      if @template.errors.any?
+        source.config.stderr.puts "Errors found in #{name}:"
+        source.config.stderr.puts @template.errors.map { |e| "  #{e}" }.join("\n")
+      end
+      content
+    end
+
+    private
+
+    def page_attrs(source)
+      {
+        "title" => source.title,
+        "url" => source.url.to_s,
+        "path" => source.relative_path.dirname.join(source.rendered_filename).to_s,
+      }
+    end
+
+    def files_attrs(sources)
+      sources.map do |source|
+        {
+          "url" => source.url.to_s,
+          "path" => source.relative_path.dirname.join(source.rendered_filename).to_s,
+          "dirname" => source.relative_path.dirname.to_s,
+          "filename" => source.rendered_filename,
+          "extname" => source.rendered_filename[/\.[^.]+$/],
+          "title" => source.title,
+        }
+      end
+    end
+  end
+end

data/lib/yass/source.rb

@@ -0,0 +1,44 @@
+module Yass
+  class Source
+    EXT_CONVERSIONS = {"md" => "html"}.freeze
+    attr_reader :config, :path, :layout, :relative_path, :rendered_filename
+
+    def initialize(config, path)
+      @config = config
+      @path = path
+      @relative_path = path.relative_path_from config.src_dir
+      @layout, @rendered_filename = parse_name
+    end
+
+    def url
+      url = relative_path.dirname.join(rendered_filename)
+      index? && !config.local ? url.dirname : url
+    end
+
+    def title
+      fname = rendered_filename.sub(/\..+$/, "").to_s
+      fname = relative_path.dirname.basename.to_s if fname == "index"
+      fname = "Home" if fname == "."
+      fname.sub(/[_-]+/, " ").split(/ +/).map(&:capitalize).join(" ")
+    end
+
+    def dynamic? = !!(/\.(liquid|md)(\..*)?$/ =~ path.basename.to_s || layout)
+
+    def index? = rendered_filename == "index.html"
+
+    private
+
+    def parse_name
+      name, exts = path.basename.to_s.split(".", 2)
+      return nil, name if exts.nil?
+
+      exts = exts.split(".").map { |x| EXT_CONVERSIONS[x] || x } - %w[liquid]
+      return nil, "#{name}.#{exts.join "."}" if exts.size < 2
+
+      layout = config.layout_cache["#{exts[-2..].join(".")}"]
+      exts.delete_at(-2) if layout
+
+      return layout, "#{name}.#{exts.join "."}"
+    end
+  end
+end

data/lib/yass/version.rb

@@ -0,0 +1,3 @@
+module Yass
+  VERSION = "0.0.1".freeze
+end

data/lib/yass.rb

@@ -0,0 +1,14 @@
+require 'pathname'
+require 'kramdown'
+require 'liquid'
+
+module Yass
+  autoload :CLI, 'yass/cli'
+  autoload :Config, 'yass/config'
+  autoload :Generator, 'yass/generator'
+  autoload :LiquidFilters, 'yass/liquid_filters'
+  autoload :LiquidHighlightTag, 'yass/liquid_highlight_tag'
+  autoload :LiquidTemplate, 'yass/liquid_template'
+  autoload :Source, 'yass/source'
+  autoload :VERSION, 'yass/version'
+end

metadata

@@ -0,0 +1,90 @@
+--- !ruby/object:Gem::Specification
+name: yass
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Jordan Hollinger
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-05-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: kramdown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: liquid
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+description: A dead-simple static site generator
+email: jordan.hollinger@gmail.com
+executables:
+- yass
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- bin/yass
+- lib/template/layouts/default.html.liquid
+- lib/template/site/assets/highlight-default.css
+- lib/template/site/assets/highlight.min.js
+- lib/template/site/index.default.html.liquid
+- lib/template/templates/css_links.liquid
+- lib/template/templates/js_scripts.liquid
+- lib/yass.rb
+- lib/yass/cli.rb
+- lib/yass/cli/helpers.rb
+- lib/yass/cli/runner.rb
+- lib/yass/config.rb
+- lib/yass/generator.rb
+- lib/yass/liquid_filters.rb
+- lib/yass/liquid_highlight_tag.rb
+- lib/yass/liquid_template.rb
+- lib/yass/source.rb
+- lib/yass/version.rb
+homepage: https://github.com/jhollinger/yass
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.19
+signing_key:
+specification_version: 4
+summary: Yet Another Static Site (generator)
+test_files: []