aura-lang 1.3.0

data/lib/aura/version.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Aura
+  # Single source of truth for the framework version. Referenced by the
+  # gemspec, the CLI banner, and the generated-code header so they can never
+  # drift apart again.
+  VERSION = "1.3.0"
+end

data/lib/aura.rb

@@ -0,0 +1,125 @@
+# frozen_string_literal: true
+
+# Aura -- the declarative AI web framework. This file is the loader and public
+# API surface; the compiler pipeline lives in the focused modules under
+# lib/aura/ (parser -> transformer -> analyzer -> codegen).
+
+require "json"
+require "fileutils"
+
+# Torch is only needed to *run* generated models. Transpilation, `check`, and
+# `build` all work without it, so a missing install is not fatal here.
+begin
+  require "torch"
+rescue LoadError
+  nil
+end
+
+require_relative "aura/version"
+require_relative "aura/diagnostics"
+require_relative "aura/emitter"
+require_relative "aura/parser"
+require_relative "aura/transformer"
+require_relative "aura/analyzer"
+require_relative "aura/codegen"
+require_relative "aura/docker"
+require_relative "aura/vercel"
+
+module Aura
+  # A small, fully-parseable starter app used by `aura init` and the
+  # "file not found" recovery path in `aura run`. Kept here so the CLI and the
+  # test-suite share a single source of truth.
+  STARTER_TEMPLATE = <<~AURA
+    environment production do
+      device :cpu
+      log_level :info
+    end
+
+    model greeter neural_network do
+      input text
+      output greeting "Hello from Aura!"
+    end
+
+    route "/hello" get do
+      output prediction from greeter.predict(input) format :json
+    end
+
+    run web on port: 3000
+  AURA
+
+  module_function
+
+  # Strip `#` comments before parsing -- both full-line and trailing/inline
+  # (e.g. `scheduler :step_lr # note`). A `#` inside a double-quoted string is
+  # left intact. Comment text is removed but newlines are preserved, so line
+  # numbers stay accurate for diagnostics. Also normalizes the source to UTF-8
+  # (examples may contain emoji, etc.).
+  def preprocess(source)
+    source.to_s.dup.force_encoding("UTF-8")
+          .each_line.map { |line| strip_comment(line) }.join
+  end
+
+  # Remove a trailing `# ...` comment from a single line, ignoring any `#` that
+  # sits inside a double-quoted string. Backslash escapes are honored so a `\"`
+  # inside a string does not prematurely end it. A trailing newline (if present)
+  # is preserved so downstream line numbers do not shift.
+  def strip_comment(line)
+    in_string = false
+    escaped   = false
+    line.each_char.with_index do |ch, i|
+      if escaped
+        escaped = false
+      elsif ch == "\\"
+        escaped = true
+      elsif ch == '"'
+        in_string = !in_string
+      elsif ch == "#" && !in_string
+        tail = line.end_with?("\n") ? "\n" : ""
+        return line[0...i].rstrip + tail
+      end
+    end
+    line
+  end
+
+  # Parse source into the raw Parslet tree, converting a Parslet failure into a
+  # friendly Aura::ParseError with line/column. Returns the raw tree so callers
+  # may run the Transformer themselves.
+  def parse(source)
+    clean = preprocess(source)
+    Parser.new.parse(clean)
+  rescue Parslet::ParseFailed => e
+    raise Diagnostics.from_parslet(e, clean)
+  end
+
+  # Full front-end: parse -> transform -> semantic analysis. Returns the flat
+  # list of semantic node hashes.
+  def to_nodes(source)
+    tree  = parse(source)
+    nodes = Transformer.new.apply(tree)
+    nodes = nodes.is_a?(Array) ? nodes : [nodes]
+    nodes = nodes.flatten.compact.select { |n| n.is_a?(Hash) }
+    Analyzer.analyze(nodes)
+  end
+
+  # Transpile Aura source to a Ruby program (String).
+  def transpile(source)
+    CodeGen.generate(to_nodes(source))
+  end
+
+  # Transpile and execute a .aura file. Generated code uses classic Sinatra,
+  # which boots the server at exit.
+  def run_file(filename)
+    eval(transpile(File.read(filename)), TOPLEVEL_BINDING, filename) # rubocop:disable Security/Eval
+  end
+
+  # Generate Docker deployment assets for a .aura file (backs `aura deploy`).
+  def build_docker(filename)
+    Docker.build(filename)
+  end
+
+  # Generate Vercel deployment assets for an LLM-only .aura file
+  # (backs `aura deploy <file> --target vercel`).
+  def build_vercel(filename)
+    Vercel.build(filename)
+  end
+end

metadata

@@ -0,0 +1,158 @@
+--- !ruby/object:Gem::Specification
+name: aura-lang
+version: !ruby/object:Gem::Version
+  version: 1.3.0
+platform: ruby
+authors:
+- John V. Teixido
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-06-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: parslet
+  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: sinatra
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+- !ruby/object:Gem::Dependency
+  name: puma
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+- !ruby/object:Gem::Dependency
+  name: red-datasets
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: dotenv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+description: A professional-grade framework for building AI pipelines and AI-integrated
+  web apps with Ruby and Torch. A RootSpace.app product founded and developed by John
+  V. Teixido.
+email: john@rootspace.app
+executables:
+- aura
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- Rakefile
+- aura-lang.gemspec
+- bin/aura
+- examples/assistant.aura
+- examples/chatbot.aura
+- examples/hello.aura
+- examples/mnist_classifier.aura
+- examples/sentiment.aura
+- examples/transfer_api.aura
+- lib/aura.rb
+- lib/aura/analyzer.rb
+- lib/aura/codegen.rb
+- lib/aura/diagnostics.rb
+- lib/aura/docker.rb
+- lib/aura/emitter.rb
+- lib/aura/parser.rb
+- lib/aura/transformer.rb
+- lib/aura/vercel.rb
+- lib/aura/version.rb
+homepage: https://rootspace.app
+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.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: 'Aura: The Declarative AI Web Framework. A RootSpace.app product founded
+  and developed by John V. Teixido.'
+test_files: []