smacro 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2f5c8cb7f5f7c4c6deec9cf8f0d023d4bcdc152e8cf7378c2b624fd7a5c473eb
+  data.tar.gz: 1120a714fab2e01ee6e682e972e6e3d86e1b62c8c461311f6805adc91af627d3
+SHA512:
+  metadata.gz: 4737d41ed76a54a289fd41a8490b2caea1fe502664b29e7d7a0ac24dbe32b960437dd3a412e92dfca477f4b4cce11c96ea2ed202e0717780c39f44fef8788157
+  data.tar.gz: d07b412b1968f1fc6b2b7a68458b1494b1bab273964551b0fd5da4878019a3d530a3143c13132604fc04daeabac7a20337882b44968a625209c9c42dc5a03858

data/README.md

@@ -0,0 +1,41 @@
+# smacro
+
+`smacro` expands Ruby macros before handing the resulting source to the Spinel AOT compiler. Macro definitions run under CRuby at build time; the generated program does not need the gem at runtime.
+
+## Install locally
+
+```sh
+gem build smacro.gemspec
+gem install ./smacro-0.1.0.gem
+```
+
+The gem requires Ruby 3.0 or later and Prism. Spinel is needed to compile the expanded result.
+
+## Use
+
+Put macro definitions in `app.smacro.rb` next to `app.rb`:
+
+```ruby
+Smacro.define(:fields) do |*names|
+  "attr_accessor " + names.map { |name| ":#{name}" }.join(", ")
+end
+```
+
+Call the macro in `app.rb`:
+
+```ruby
+class User
+  fields :name, :email
+end
+```
+
+Expand and compile:
+
+```sh
+smacro app.rb -o app.expanded.rb
+spinel app.expanded.rb
+```
+
+Pass a macro file as the second argument when its name differs from `app.smacro.rb`. The existing `ruby smacro.rb app.rb` command still works. For Ruby code, use `require "smacro"` to access `Smacro.define` and `Smacro.expand`.
+
+The current prototype accepts literal macro arguments (symbols, strings, integers, booleans, nil, and arrays). It does not yet support macro definitions inside the source file, nested macro calls, or Crystal's AST template syntax. `sh run.sh` compares the sample's CRuby and Spinel results.

data/exe/smacro

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+require "smacro/cli"
+
+Smacro::CLI.run(ARGV)

data/lib/smacro/cli.rb

@@ -0,0 +1,24 @@
+require "optparse"
+require_relative "../smacro"
+
+module Smacro
+  module CLI
+    def self.run(argv)
+      options = {}
+      parser = OptionParser.new do |opts|
+        opts.banner = "Usage: smacro [options] app.rb [app.smacro.rb]"
+        opts.on("-o", "--output FILE", "Write expanded Ruby to FILE") { |path| options[:output] = path }
+        opts.on("-v", "--version", "Print version") { puts Smacro::VERSION; return }
+        opts.on("-h", "--help", "Show help") { puts opts; return }
+      end
+      parser.parse!(argv)
+      abort parser.to_s unless (1..2).cover?(argv.length)
+
+      app, macro_file = argv
+      macro_file ||= app.sub(/\.rb\z/, ".smacro.rb")
+      load File.expand_path(macro_file) if File.exist?(macro_file)
+      expanded = Smacro.expand(File.read(app))
+      options[:output] ? File.write(options[:output], expanded) : print(expanded)
+    end
+  end
+end

data/lib/smacro/version.rb

@@ -0,0 +1,3 @@
+module Smacro
+  VERSION = "0.1.0"
+end

data/lib/smacro.rb

@@ -0,0 +1,62 @@
+#!/usr/bin/env ruby
+# smacro: build-time macro expander for Spinel (PoC)
+#   ruby smacro.rb app.rb [app.smacro.rb] > app.expanded.rb
+#   spinel app.expanded.rb
+require "prism"
+require_relative "smacro/version"
+
+module Smacro
+  MACROS = {}
+
+  def self.define(name, &blk)
+    MACROS[name] = blk
+  end
+
+  # AST literal -> Ruby value. Anything not known at build time is an error.
+  def self.const_value(node)
+    case node
+    when Prism::SymbolNode  then node.unescaped.to_sym
+    when Prism::StringNode  then node.unescaped
+    when Prism::IntegerNode then node.value
+    when Prism::TrueNode    then true
+    when Prism::FalseNode   then false
+    when Prism::NilNode     then nil
+    when Prism::ArrayNode   then node.elements.map { |e| const_value(e) }
+    else
+      raise ArgumentError,
+            "macro arg is not a compile-time literal (#{node.class}) at line #{node.location.start_line}"
+    end
+  end
+
+  class Collector < Prism::Visitor
+    attr_reader :hits
+
+    def initialize
+      @hits = []
+    end
+
+    def visit_call_node(node)
+      if node.receiver.nil? && node.block.nil? && MACROS.key?(node.name)
+        @hits << node # nested macros are not handled in the PoC
+      else
+        super
+      end
+    end
+  end
+
+  def self.expand(src)
+    collector = Collector.new
+    Prism.parse(src).value.accept(collector)
+
+    bytes = src.b # Prism offsets are byte offsets
+    collector.hits.sort_by { |n| -n.location.start_offset }.each do |n|
+      args = (n.arguments ? n.arguments.arguments : []).map { |a| const_value(a) }
+      code = MACROS[n.name].call(*args).to_s
+      # Collapse to one line with ";" so every line number stays identical
+      # to the original file (free source map for error messages).
+      oneline = code.lines.map(&:strip).reject(&:empty?).join("; ")
+      bytes[n.location.start_offset, n.location.length] = oneline.b
+    end
+    bytes.force_encoding(Encoding::UTF_8)
+  end
+end

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification
+name: smacro
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- femto
+bindir: exe
+cert_chain: []
+date: 2026-09-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: prism
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: Expand Ruby source macros before compiling the result with Spinel.
+executables:
+- smacro
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- exe/smacro
+- lib/smacro.rb
+- lib/smacro/cli.rb
+- lib/smacro/version.rb
+homepage: https://github.com/femto/smacro
+licenses: []
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: Build-time Ruby macros for Spinel
+test_files: []