matte 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e4906e09f73262265f07c904dacd094d7bbcfe7e45bcf5c502bb9df908bea0bc
+  data.tar.gz: cdb023e7db2121980795407e44ae84f97effe69503ab147335eb299ef14d7a38
+SHA512:
+  metadata.gz: d1f08ecab410b5d23273e0fd81e22e92b1f85f63b35d15614fca9f9bfc24a869e11dc71064081b1089321112a838cd2bb908ea8dc3ea512856c199b499cc7786
+  data.tar.gz: 7cfdb1bfa8d017860130a083b72d84db8d3fdf8764da6d0fb03fb385320717212c8bd6ed948de6994d9580ce8d412816a19b57f5515a0d9e8f902a6de29d49f5

data/README.md

@@ -0,0 +1,3 @@
+# matte
+
+macro assembler for HTML

data/lib/matte.rb

@@ -0,0 +1,164 @@
+require 'temple'
+
+class Array
+    def start_with? other
+        take(other.length) == other
+    end
+
+    # like find, but recursive
+    def select_recursive &proc
+        results = []
+        each do |element|
+            if proc.call element
+                results << element
+            end 
+            if element.is_a? Array
+                results.push *(element.select_recursive(&proc))
+            end
+        end
+
+        results
+    end
+end
+
+module Matte
+
+    def self.find_all_sexps container, prefix
+        return nil unless container.is_a? Array
+        container.select_recursive { |e| Matte.sexp_is? e, prefix }
+    end
+
+    def self.find_first_sexp container, prefix
+        return nil unless container.is_a? Array
+        find_all_sexps(container, prefix).first
+    end
+
+    def self.sexp_is? sexp, prefix
+        sexp.is_a? Array and sexp.start_with? prefix
+    end
+
+    def self.get_attr_for_html html, key
+        find_first_sexp(find_first_sexp(html[3], [:html, :attr, key]), [:static])&.last
+    end
+
+    # statically includes mixins in HTML.
+    class IncludeMixins
+        def initialize options = {}
+            @conf = options
+        end
+
+        def call document
+            Matte.find_all_sexps(document, [:matte, :placeholder]).each do |placeholder|
+                placeholder_name = placeholder[2]
+                body = [:multi]
+                # include all mixins with same name
+                Matte.find_all_sexps(document, [:matte, :mixin, placeholder_name]).each do |mixin|
+                    body << mixin[3]
+                    mixin.clear
+                    mixin << :multi
+                end
+
+                placeholder.clear
+                placeholder.push :multi, body
+            end
+
+            # if there are any remaining mixins without corresponding placeholder, error
+            raise Temple::InvalidExpression.new "found mixin without corresponding placeholder" unless Matte.find_all_sexps(document, [:matte, :mixin]).empty?
+            
+            document
+        end
+    end
+    class IncludeMixins
+        def initialize options = {}
+            @conf = options
+        end
+
+        def call document
+            Matte.find_all_sexps(document, [:matte, :placeholder]).each do |placeholder|
+                placeholder_name = placeholder[2]
+                body = [:multi]
+                # include all mixins with same name
+                Matte.find_all_sexps(document, [:matte, :mixin, placeholder_name]).each do |mixin|
+                    body << mixin[3]
+                    mixin.clear
+                    mixin << :multi
+                end
+
+                placeholder.clear
+                placeholder.push :multi, body
+            end
+
+            # if there are any remaining mixins without corresponding placeholder, error
+            raise Temple::InvalidExpression.new "found mixin without corresponding placeholder" unless Matte.find_all_sexps(document, [:matte, :mixin]).empty?
+            
+            document
+        end
+    end
+
+    class ExpandMacros
+        def initialize options = {}
+            @conf = options
+        end
+
+        def call exp
+            # TODO
+            exp
+        end
+    end
+
+    class Test
+        def initialize options = {}; end
+
+        def call exp
+            pp exp
+            exp
+        end
+    end
+
+    # convert [:html] s-expressions into [:matte] s-expressions
+    class FromHTML
+        def initialize options = {}
+            @conf = options
+        end
+
+        def call document
+            # document = Marshal.load Marshal.dump document # not the best solution, but at least it works!
+
+            Matte.find_all_sexps(document, [:html, :tag]).each do |tag|
+                next unless tag[2].start_with? 'matte:'
+
+                tag_name = tag[2].split(':').last.downcase
+
+                case tag_name
+
+                when "ph"
+                    # get placeholder name
+                    id = Matte.get_attr_for_html(tag, "id")
+                    raise Temple::InvalidExpression.new "placeholder must have a constant name" unless id.is_a? String
+
+                    tag.clear
+                    tag.push :matte, :placeholder, id
+                
+                when "mixin"
+                    id = Matte.get_attr_for_html(tag, "id")
+                    body = tag[4]
+                    raise Temple::InvalidExpression.new "mixin must have a constant name" unless id.is_a? String
+
+                    tag.clear
+                    tag.push :matte, :mixin, id, body
+                end
+            end
+            
+            pp document
+            document
+        end
+    end
+end
+
+# initialization
+if defined? Slim
+    # Slim::Engine.after Slim::CodeAttributes, Matte::Test
+    Slim::Engine.after Slim::CodeAttributes, Matte::ExpandMacros
+    Slim::Engine.after Slim::CodeAttributes, Matte::IncludeMixins
+    Slim::Engine.after Slim::CodeAttributes, Matte::FromHTML
+end

metadata

@@ -0,0 +1,59 @@
+--- !ruby/object:Gem::Specification
+name: matte
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- fmixolydian
+bindir: bin
+cert_chain: []
+date: 2026-01-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: temple
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+description: |2
+      Matte is a Temple compiler that processes macros (basically tags) and mixins in an HTML document
+      (formatted as an s-expression) and returns the resulting HTML, which is then compiled into Ruby by Temple.
+
+      Note that this doesn't actually come with a full built-in markup language compiler; rather it only contains a
+      compiler for processing Matte macros.
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/matte.rb
+homepage: https://git.disroot.org/acrylic/matte
+licenses:
+- BSD-3-Clause
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.3
+specification_version: 4
+summary: HTML Macro assembler for Temple
+test_files: []