frausto 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6175ca1a7aaec33d9d762997e3016e76be2892da7ca7b65585d7cdd8c05b6423
+  data.tar.gz: b0e41102e41bbb150a7d6ad48b841054577715b1ca1d2507b73b6ff2793c549f
+SHA512:
+  metadata.gz: 2dc4fe2223f141e4283eab56f517dc1611844436fe9a8ef0d60f7924a7e52c6276cc15d385c16873c96c697398e0dd03c949c1fe0a00fbef69efceedbfd6ea5f
+  data.tar.gz: 07ef3e6827676dd054b80895b8beb89a4d7394ca5c4e658494fbf3fed320b564b89749d877e8cfa54621aad4f49112bca0f76713874480d6fc597ff313f128c8

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024
+
+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,45 @@
+# Frausto
+
+A Ruby toolkit for Faust DSP: generate Faust code from Ruby, or convert Faust to Ruby.
+
+## Installation
+
+```bash
+gem install frausto
+```
+
+Or add to your Gemfile:
+
+```ruby
+gem 'frausto'
+```
+
+## Tools
+
+- **[ruby2faust](ruby2faust.md)** - Ruby DSL that generates Faust DSP code
+- **[faust2ruby](faust2ruby.md)** - Convert Faust DSP code to Ruby DSL
+
+## Quick Example
+
+```ruby
+require 'ruby2faust'
+
+code = Ruby2Faust.generate do
+  osc(440) >> lp(800) >> gain(0.3)
+end
+
+puts code
+# => import("stdfaust.lib");
+#    process = (os.osc(440) : fi.lowpass(1, 800) : *(0.3));
+```
+
+```ruby
+require 'faust2ruby'
+
+ruby_code = Faust2Ruby.to_ruby('process = os.osc(440) : *(0.5);')
+# => "osc(440) >> gain(0.5)"
+```
+
+## License
+
+MIT

data/bin/faust2ruby

@@ -0,0 +1,124 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "optparse"
+
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+require "faust2ruby"
+
+options = {
+  expression_only: false,
+  verbose: false
+}
+
+parser = OptionParser.new do |opts|
+  opts.banner = "Usage: faust2ruby [options] <input.dsp>"
+  opts.separator ""
+  opts.separator "Convert Faust DSP code to Ruby DSL code compatible with ruby2faust."
+  opts.separator ""
+  opts.separator "Options:"
+
+  opts.on("-o", "--output FILE", "Output Ruby file (default: stdout)") do |file|
+    options[:output] = file
+  end
+
+  opts.on("-e", "--expression", "Output only process expression (no boilerplate)") do
+    options[:expression_only] = true
+  end
+
+  opts.on("-v", "--verbose", "Verbose output (show parsing info)") do
+    options[:verbose] = true
+  end
+
+  opts.on("-t", "--tokens", "Show lexer tokens (debug mode)") do
+    options[:tokens] = true
+  end
+
+  opts.on("-a", "--ast", "Show AST (debug mode)") do
+    options[:ast] = true
+  end
+
+  opts.on("--version", "Show version") do
+    puts "faust2ruby #{Faust2Ruby::VERSION}"
+    exit
+  end
+
+  opts.on("-h", "--help", "Show this help") do
+    puts opts
+    exit
+  end
+end
+
+begin
+  parser.parse!
+rescue OptionParser::InvalidOption => e
+  warn e.message
+  warn parser
+  exit 1
+end
+
+# Read input
+if ARGV.empty?
+  if $stdin.tty?
+    warn "Error: No input file specified"
+    warn parser
+    exit 1
+  end
+  source = $stdin.read
+  input_name = "<stdin>"
+else
+  input_path = ARGV[0]
+  unless File.exist?(input_path)
+    warn "Error: File not found: #{input_path}"
+    exit 1
+  end
+  source = File.read(input_path)
+  input_name = input_path
+end
+
+begin
+  if options[:verbose]
+    warn "Parsing #{input_name}..."
+  end
+
+  # Debug: show tokens
+  if options[:tokens]
+    tokens = Faust2Ruby.tokenize(source)
+    puts "Tokens:"
+    tokens.each do |token|
+      puts "  #{token.type.to_s.ljust(12)} #{token.value.inspect.ljust(20)} line #{token.line}, col #{token.column}"
+    end
+    puts
+  end
+
+  # Debug: show AST
+  if options[:ast]
+    program = Faust2Ruby.parse(source)
+    puts "AST:"
+    program.statements.each do |stmt|
+      puts "  #{stmt.class.name.split('::').last}: #{stmt.inspect[0..100]}..."
+    end
+    puts
+  end
+
+  # Generate Ruby code
+  ruby_code = Faust2Ruby.to_ruby(source, expression_only: options[:expression_only])
+
+  if options[:output]
+    File.write(options[:output], ruby_code)
+    warn "Wrote #{options[:output]}" if options[:verbose]
+  else
+    puts ruby_code
+  end
+
+rescue Faust2Ruby::ParseError => e
+  warn "Parse error: #{e.message}"
+  exit 1
+rescue Faust2Ruby::Error => e
+  warn "Error: #{e.message}"
+  exit 1
+rescue StandardError => e
+  warn "Unexpected error: #{e.message}"
+  warn e.backtrace.first(5).join("\n") if options[:verbose]
+  exit 1
+end

data/bin/ruby2faust

@@ -0,0 +1,129 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "optparse"
+require_relative "../lib/ruby2faust"
+
+module Ruby2Faust
+  class CLI
+    def initialize(args)
+      @args = args
+      @options = { target: :cpp }
+    end
+
+    def run
+      command = @args.shift
+
+      case command
+      when "compile", "c"
+        compile_command
+      when "run", "r"
+        run_command
+      when "version", "-v", "--version"
+        puts "ruby2faust #{VERSION}"
+      when "help", "-h", "--help", nil
+        print_help
+      else
+        puts "Unknown command: #{command}"
+        print_help
+        exit 1
+      end
+    end
+
+    private
+
+    def compile_command
+      parser = OptionParser.new do |opts|
+        opts.banner = "Usage: ruby2faust compile [options] <file.rb>"
+
+        opts.on("-o", "--output FILE", "Output .dsp file") do |f|
+          @options[:output] = f
+        end
+
+        opts.on("-t", "--target TARGET", [:cpp, :wasm, :llvm], "Compilation target (cpp, wasm, llvm)") do |t|
+          @options[:target] = t
+        end
+      end
+      parser.parse!(@args)
+
+      input_file = @args.shift
+      unless input_file
+        puts "Error: No input file specified"
+        puts parser.help
+        exit 1
+      end
+
+      unless File.exist?(input_file)
+        puts "Error: File not found: #{input_file}"
+        exit 1
+      end
+
+      output_file = @options[:output] || input_file.sub(/\.rb$/, ".dsp")
+
+      # Load and evaluate the Ruby DSL file
+      dsl_code = File.read(input_file)
+      context = Object.new
+      context.extend(DSL)
+      process = context.instance_eval(dsl_code, input_file)
+
+      # Generate Faust code
+      faust_code = Emitter.program(process)
+      File.write(output_file, faust_code)
+
+      puts "Generated: #{output_file}"
+    end
+
+    def run_command
+      parser = OptionParser.new do |opts|
+        opts.banner = "Usage: ruby2faust run [options] <file.rb>"
+
+        opts.on("-t", "--target TARGET", [:cpp, :wasm], "Run target (cpp, wasm)") do |t|
+          @options[:target] = t
+        end
+      end
+      parser.parse!(@args)
+
+      input_file = @args.shift
+      unless input_file
+        puts "Error: No input file specified"
+        puts parser.help
+        exit 1
+      end
+
+      # First compile to .dsp
+      @options[:output] = nil
+      @args.unshift(input_file)
+      compile_command
+
+      # Then run Faust compiler
+      dsp_file = input_file.sub(/\.rb$/, ".dsp")
+      puts "Compiling with Faust..."
+      Live.faust_compile(dsp_file, target: @options[:target])
+    end
+
+    def print_help
+      puts <<~HELP
+        ruby2faust - A Ruby DSL for generating Faust DSP code
+
+        Usage:
+          ruby2faust <command> [options] [arguments]
+
+        Commands:
+          compile, c    Compile a Ruby DSL file to Faust .dsp
+          run, r        Compile to .dsp and run Faust compiler
+          version       Show version
+          help          Show this help
+
+        Examples:
+          ruby2faust compile synth.rb
+          ruby2faust compile -o output.dsp synth.rb
+          ruby2faust run --target wasm synth.rb
+
+        For command-specific help:
+          ruby2faust compile --help
+      HELP
+    end
+  end
+end
+
+Ruby2Faust::CLI.new(ARGV).run