RubyGems - sade - Versions diffs - 0.1.0.pre - Mend

sade 0.1.0.pre

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (36) hide show

checksums.yaml +7 -0
data/LICENSE +24 -0
data/README.md +14 -0
data/VERSION +1 -0
data/bin/sade +179 -0
data/lib/sade/attr_block_reader.rb +67 -0
data/lib/sade/attr_read_helper.rb +33 -0
data/lib/sade/attr_shortcut_reader.rb +76 -0
data/lib/sade/attr_value_reader.rb +50 -0
data/lib/sade/composite_builder.rb +66 -0
data/lib/sade/document.rb +23 -0
data/lib/sade/document_iterator.rb +35 -0
data/lib/sade/element_builder.rb +81 -0
data/lib/sade/else_builder.rb +25 -0
data/lib/sade/exception.rb +5 -0
data/lib/sade/for_builder.rb +33 -0
data/lib/sade/heredoc_builder.rb +27 -0
data/lib/sade/heredoc_reader.rb +70 -0
data/lib/sade/if_builder.rb +45 -0
data/lib/sade/import_builder.rb +41 -0
data/lib/sade/include_builder.rb +82 -0
data/lib/sade/interpolation.rb +38 -0
data/lib/sade/iterator.rb +49 -0
data/lib/sade/lexer.rb +13 -0
data/lib/sade/node.rb +12 -0
data/lib/sade/parser.rb +134 -0
data/lib/sade/parser_helper.rb +40 -0
data/lib/sade/quoted_string_reader.rb +38 -0
data/lib/sade/renderer.rb +185 -0
data/lib/sade/token.rb +7 -0
data/lib/sade/token_stream.rb +36 -0
data/lib/sade/token_stream_iterator.rb +82 -0
data/lib/sade/tokenizer.rb +250 -0
data/lib/sade/version.rb +3 -0
data/lib/sade.rb +21 -0
metadata +79 -0

checksums.yaml ADDED Viewed

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9807167655e58ad5e58b785bc420b4135a435759376185086d9da0a5ec4d15d8
+  data.tar.gz: aa10c7e97c88928a943371aaedcb8a3e6df6b8a326cb5ab893af9483728217a3
+SHA512:
+  metadata.gz: 619cd3fca2000ad0dab421dc020b888d72ce55d72495fb46b2c0ab5a73c0271d6051cd29bd442aa2e48a5fa89d494b3700124777f9a1567632fd19dd3032477b
+  data.tar.gz: 9fe60a2aa87cf1662cdf2e337be27caf3a9ccff2d12a6758d2d0248c51ebc31115f7ad67666e86ef955982095f04cd167c323279e917f52192cfe7ee9a4d0c96

data/LICENSE ADDED Viewed

@@ -0,0 +1,24 @@
+BSD 2-Clause License
+Copyright (c) 2026, Takanobu Maekawa
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md ADDED Viewed

@@ -0,0 +1,14 @@
+# Sade
+An HTML template language for static page generation.
+---
+Sade is a template language designed to make writing HTML easier and more readable.
+- It uses an S-expression based syntax, which requires parentheses, but allows flexible
+indentation and line breaks.
+- Templates and raw HTML can be embedded directly, making reuse straightforward.
+- Additional shorthand notations help reduce the number of
+parentheses, and the id/class shortcuts follow the style popularized by Haml.

data/VERSION ADDED Viewed

	@@ -0,0 +1 @@
1	+ 0.1.0.pre

data/bin/sade ADDED Viewed

@@ -0,0 +1,179 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+require "optparse"
+require "json"
+require "sade"
+require "sade/version"
+#
+# Struct → JSON 変換（AST 用）
+#
+def ast_to_h(node)
+  case node
+  when Struct
+    {
+      "__type__" => node.class.name.split("::").last,
+      **node.to_h.transform_values { |v| ast_to_h(v) }
+    }
+  when Array
+    node.map { |v| ast_to_h(v) }
+  else
+    node
+  end
+end
+#
+# CLI オプション
+#
+options = {
+  mode: :render,
+  escape: true,
+  doctype: false,
+  include_path: ".",
+  import_path: ".",
+  context_json: nil,
+  context_file: nil
+}
+parser = OptionParser.new do |opt|
+  opt.banner = "Usage: sade [options] < input.sd > output.html"
+  opt.on("-l", "--lex", "Run lexer only (JSON output)") do
+    options[:mode] = :lex
+  end
+  opt.on("-p", "--parse", "Run parser only (JSON output)") do
+    options[:mode] = :parse
+  end
+  opt.on("--noescape", "Disable HTML escaping") do
+    options[:escape] = false
+  end
+  opt.on("-d", "--doctype", "Add <!DOCTYPE html> to output") do
+    options[:doctype] = true
+  end
+  opt.on("--include-path PATH", "Base directory for %include") do |v|
+    options[:include_path] = v
+  end
+  opt.on("--import-path PATH", "Base directory for %import") do |v|
+    options[:import_path] = v
+  end
+  opt.on("--context-json JSON", "Inline JSON context") do |v|
+    options[:context_json] = v
+  end
+  opt.on("--context-file PATH", "Load JSON context from file") do |v|
+    options[:context_file] = v
+  end
+  opt.on("-v", "--version") do
+    puts Sade::VERSION
+    exit(0)
+  end
+  opt.on("-h", "--help", "Show help") do
+    puts opt
+    exit 0
+  end
+end
+begin
+  parser.parse!
+rescue OptionParser::InvalidOption => e
+  warn e.message
+  warn parser
+  exit 1
+end
+#
+# context の排他チェック
+#
+if options[:context_json] && options[:context_file]
+  warn "Error: --context-json と --context-file は同時に指定できません"
+  exit 1
+end
+#
+# context の読み込み
+#
+context = {}
+if options[:context_json]
+  begin
+    context = JSON.parse(options[:context_json])
+  rescue JSON::ParserError => e
+    warn "JSON parse error in --context-json: #{e.message}"
+    exit 1
+  end
+elsif options[:context_file]
+  begin
+    context = JSON.parse(File.read(options[:context_file]))
+  rescue Errno::ENOENT
+    warn "JSON file not found: #{options[:context_file]}"
+    exit 1
+  rescue JSON::ParserError => e
+    warn "JSON parse error in file #{options[:context_file]}: #{e.message}"
+    exit 1
+  end
+end
+#
+# 標準入力を読む
+#
+input = STDIN.read
+#
+# Engine 準備
+#
+engine = Sade::Engine.new(
+  include_path: options[:include_path],
+  import_path:  options[:import_path]
+)
+lexer  = engine.lexer
+parser = engine.parser
+#
+# lex モード
+#
+if options[:mode] == :lex
+  token_stream = lexer.lex(input)
+  it = token_stream.begin
+  until it.eof?
+    puts JSON.pretty_generate(it.current)
+    it.next
+  end
+  exit 0
+end
+#
+# parse モード
+#
+if options[:mode] == :parse
+  tokens = lexer.lex(input)
+  ast    = parser.parse(tokens)
+  puts JSON.pretty_generate(ast_to_h(ast))
+  exit 0
+end
+#
+# render モード（デフォルト）
+#
+begin
+html = engine.render(
+  input,
+  context,
+  escape:  options[:escape],
+  doctype: options[:doctype]
+)
+puts html
+rescue => e
+  puts e.message
+  exit(1)
+end

data/lib/sade/attr_block_reader.rb ADDED Viewed

@@ -0,0 +1,67 @@
+require_relative 'attr_read_helper'
+require_relative 'parser_helper'
+module Sade
+  class AttrBlockReader
+    attr_reader :parser
+    include AttrReadHelper
+    include ParserHelper
+    def initialize(parser) = @parser = parser
+    def read(it)
+      return nil unless it.lbrace?
+      attrs = {}
+      it.next
+      while not it.rbrace?
+        eof_error(it) if it.eof?
+        it.skip_space
+        name = read_attr_name(it)
+        it.skip_space
+        val  = read_attr_val(it)
+        merge_attrs(attrs, name, val) if name && val
+        it.skip_space
+      end
+      return nil if attrs.empty?
+      attrs
+    end
+    def read_attr_name(it)
+      name = String.new
+      until it.rbrace? || it.space? || it.eof?  do
+        type = it.type
+        val  = it.val
+        error("'#{val}' cannot be included as the attribute name", it) unless valid_name_token?(type)
+        name << val
+        it.next
+      end
+      error("collon(:) should be placed at the end of '#{name}'", it) if name[-1] !=":"
+      name.chop.to_sym
+    end
+    def read_attr_val(it) = parser.attr_value_reader.read(it)
+    def merge_attrs(attrs, name, node)
+      if name == :class
+        attrs[:class] = attrs.fetch(:class, []) + [node]
+      else
+        attrs[name] = node
+      end
+    end
+  end
+end

data/lib/sade/attr_read_helper.rb ADDED Viewed

@@ -0,0 +1,33 @@
+module Sade
+  module AttrReadHelper
+    def unpermitted_attr_name_token_types
+      @unpermitted_attr_name_token_types ||= Set.new %i[
+        lparen rparen lbrace rbrace equal lt gt
+      ]
+    end
+    def unpermitted_attr_val_token_types
+      @unpermitted_attr_val_token_types ||= Set.new %i[
+        space lparen rparen lbrace rbrace eof
+      ]
+    end
+    def unpermitted_attr_val_token_types_for_shortcut
+      @unpermitted_attr_val_token_types_for_shortcut ||= Set.new %i[
+        dot hash space lparen rparen lbrace rbrace eof slash
+      ]
+    end
+    def valid_name_token?(type)
+      not unpermitted_attr_name_token_types.include?(type)
+    end
+    def valid_value_token?(type)
+      not unpermitted_attr_val_token_types.include?(type)
+    end
+    def valid_value_token_for_shortcut?(type)
+      not unpermitted_attr_val_token_types_for_shortcut.include?(type)
+    end
+  end
+end

data/lib/sade/attr_shortcut_reader.rb ADDED Viewed

@@ -0,0 +1,76 @@
+require_relative 'attr_read_helper'
+require_relative 'parser_helper'
+module Sade
+  class AttrShortcutReader
+    attr_reader :parser
+    include AttrReadHelper
+    include ParserHelper
+    def initialize(parser) = @parser = parser
+    def read(it, aditional_delimiters: [])
+      attrs = {}
+      while (hash?(it) || dot?(it)) && valid_attr_val?(it)
+        read_id(it, attrs)    if hash?(it)
+        read_class(it, attrs) if dot?(it)
+        skip_space(it)        if next_shortcut?(it)
+      end
+      return nil if attrs.empty?
+      attrs
+    end
+    def hash?(it)  = it.hash?
+    def dot?(it)   = it.dot?
+    def eof?(it)   = it.eof?
+    def space?(it) = it.space?
+    def forward(it)     = it.next
+    def skip_space(it)  = it.skip_space
+    def valid_attr_val?(it)
+      next_token = it.peek(1)
+      val        = next_token.val
+      type       = next_token.type
+      return false if %i[space eof].include?(type)
+      tmp = it.clone
+      tmp.next
+      return true if if_expr?(tmp) || for_expr?(tmp)
+      unless valid_value_token_for_shortcut?(type)
+        error("'#{val}' is not expected after '#{it.val}'", it)
+      end
+      true
+    end
+    def next_shortcut?(it)
+      _it = it.clone
+      _it.next while _it.space?
+      _it.hash? || _it.dot?
+    end
+    def read_id(it, attrs)
+      forward(it)
+      val = read_attr_val(it)
+      attrs[:id] = val unless val.nil?
+    end
+    def read_class(it, attrs)
+      forward(it)
+      val = read_attr_val(it)
+      attrs[:class] = attrs.fetch(:class, []).push(val) unless val.nil?
+    end
+    def read_attr_val(it)
+      parser.attr_value_reader.read(it, additional_delimiters: %i[dot hash slash lbrace rparen])
+    end
+  end
+end

data/lib/sade/attr_value_reader.rb ADDED Viewed

@@ -0,0 +1,50 @@
+require_relative 'attr_read_helper'
+require_relative 'parser_helper'
+module Sade
+  class AttrValueReader
+    attr_reader :parser
+    include AttrReadHelper
+    include ParserHelper
+    def initialize(parser) = @parser = parser
+    def read(it, additional_delimiters: [])
+      error("attribute value not found", it) if it.rbrace? || it.eof?
+      if if_expr?(it)
+        node = parser.if_builder.build(it)
+        it.next
+        return node
+      end
+      if for_expr?(it)
+        node = parser.for_builder.build(it)
+        it.next
+        return node
+      end
+      if it.heredoc?
+        heredoc = parser.heredoc_builder.build(it)
+        it.next
+        return heredoc
+      end
+      delimiters = %i[space rbrace].concat(additional_delimiters)
+      composite =
+        parser.composite_builder.build(it, additional_delimiters: delimiters) do |_it|
+          if not valid_value_token?(_it.type)
+            error("#{_it.val} cannot be included as the attribute value", _it)
+          end
+        end
+      return nil if composite.nil?
+      return nil if composite.contents.empty?
+      return composite.contents.first if composite.contents.size == 1
+      composite
+    end
+  end
+end

data/lib/sade/composite_builder.rb ADDED Viewed

@@ -0,0 +1,66 @@
+require_relative 'node'
+require_relative 'exception'
+require_relative 'interpolation'
+require_relative 'parser_helper'
+module Sade
+  class CompositeBuilder
+    include ParserHelper
+    include Interpolation
+    def build(itr, has_parent: false, additional_delimiters: [], &validator)
+      str = String.new
+      buf = []
+      last_token_type = nil
+      delimiters = %i[eof lparen heredoc] + additional_delimiters
+      until delimiters.include?(itr.type)
+        break if itr.type == :rparen && has_parent
+        validator.call(itr) if block_given?
+        val = itr.val
+        if itr.variable?
+          buf.push(Text.new(str)) if str.size.positive?
+          buf.push(Variable.new(val[1..-1]))
+          str = String.new
+        elsif itr.text? && include_interpolation?(val)
+          # ここでいったんバッファ中の素のテキストを flush
+          buf.push(Text.new(str)) if str.size.positive?
+          # 補完入りテキストをフラットなノード列に分解して buf に展開
+          parse_interpolated_text(val, itr).each do |node|
+            buf << node
+          end
+          str = String.new
+        else
+          str << val unless last_token_type == :space && itr.space?
+        end
+        last_token_type = itr.type
+        itr.next
+      end
+      # 親タグ式から呼び出されて ) で閉じずにEOFの場合、例外を出す必要がある
+      eof_error(itr) if itr.eof? && has_parent
+      # 親タグ式から呼び出されて ) の前にスペーストークンがあるなら削除
+      tmp = if last_token_type == :space && itr.type == :rparen && has_parent
+              str.chop
+            else
+              str
+            end
+      buf.push(Text.new(tmp)) if tmp.size.positive?
+      return nil if buf.size.zero?
+      Composite.new(buf)
+    end
+  end
+end

data/lib/sade/document.rb ADDED Viewed

@@ -0,0 +1,23 @@
+require_relative 'document_iterator'
+module Sade
+  class Document
+    attr_reader :buff
+    def initialize(string)
+      @buff =  string
+    end
+    def begin
+      DocumentIterator.new(buff, 0, 1, 1)
+    end
+    def substr(first, last)
+      buff[first.offset...last.offset]
+    end
+    def match?(first, last, str)
+      buff[first.offset...last.offset] == str
+    end
+  end
+end

data/lib/sade/document_iterator.rb ADDED Viewed

@@ -0,0 +1,35 @@
+require_relative 'iterator'
+module Sade
+  class DocumentIterator < Iterator
+    attr_reader :line, :col
+    def initialize(buf, offset, line = 1, col = 1)
+      super(buf, offset)
+      @line = line
+      @col  = col
+    end
+    def newline
+      self.next
+      @line += 1
+      @col  = 1
+    end
+    def next
+      super
+      @col += 1
+      self
+    end
+    def step(count)
+      super
+      @col += count
+      self
+    end
+    def clone
+      self.class.new(state.buf, state.offset, line, col)
+    end
+  end
+end

data/lib/sade/element_builder.rb ADDED Viewed

@@ -0,0 +1,81 @@
+require_relative 'node'
+require_relative 'token'
+require_relative 'parser_helper'
+module Sade
+  class ElementBuilder
+    attr_reader :parser
+    include ParserHelper
+    def initialize(parser) = @parser = parser
+    def build(it)
+      last_it = it.matching_rparen
+      return nil unless it.lparen?
+      error("')' that should match '(' is not found", it) if last_it.nil?
+      it.next.skip_space
+      name = read_name(it)
+      return nil if  %w[%if %else %for %include].include?(name)
+      it.next.skip_space
+      shortcut_attrs = parser.attr_shortcut_reader.read(it) || {}
+      it.skip_space unless shortcut_attrs.empty?
+      block_attrs = parser.attr_block_reader.read(it) || {}
+      attrs = merge_attrs(shortcut_attrs, block_attrs)
+      it.next.skip_space unless block_attrs.empty?
+      children = if it.slash?
+                   it.next.skip_space
+                   create_pseude_child(it, last_it)
+                 else
+                   parser.read_children(it, last_it)
+                 end
+      Element.new(name, attrs, children)
+    end
+    def read_name(it)
+      error("unexpected character '#{it.val}'", it) unless it.symbol?
+      it.val
+    end
+    def merge_attrs(first, second)
+      return first  if second.empty?
+      return second if first.empty?
+      second.each do |name, node|
+        if name == :class
+          first[:class] = first.fetch(:class, []).concat(node)
+        else
+          first[name] = node
+        end
+      end
+      first
+    end
+    def create_pseude_child(it, last_it)
+      sub_stream = TokenStream.from_iterators(it, last_it)
+      sub_stream.push_front(Token.new(type: :lparen, val: '(', line: -1, col: -1))
+      sub_stream.push_back(Token.new(type: :rparen, val: ')', line: -1, col: -1))
+      element = read_child_element(sub_stream.begin)
+      it.step(sub_stream.size - 2)
+      [element].compact
+    end
+    def read_child_element(it) = parser.element_builder.build(it)
+  end
+end

data/lib/sade/else_builder.rb ADDED Viewed

@@ -0,0 +1,25 @@
+require_relative 'parser_helper'
+module Sade
+  class ElseBuilder
+    attr_reader :parser
+    include ParserHelper
+    def initialize(parser)
+      @parser = parser
+    end
+    def build(it)
+      last_it    = it.matching_rparen
+      return nil unless else_expr?(it)
+      error("')' that should match '(' is not found", it) if last_it.nil?
+      it.next.skip_space  # ( とその後ろのスペースをスキップ
+      it.next.skip_space  # %else とその後ろのスペースをスキップ
+      Else.new(parser.read_children(it, last_it))
+    end
+  end
+end

data/lib/sade/exception.rb ADDED Viewed

@@ -0,0 +1,5 @@
+module Sade
+  class LexerError < StandardError; end
+  class ParseError < StandardError; end
+  class RenderError < StandardError; end
+end