RubyGems - fresco - Versions diffs - 0.0.1 - Mend

fresco 0.0.1

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 (48) hide show

checksums.yaml +7 -0
data/exe/fresco +3 -0
data/lib/fresco/application.rb +12 -0
data/lib/fresco/cli/build.rb +682 -0
data/lib/fresco/cli/dev.rb +17 -0
data/lib/fresco/cli/dev_loop.rb +815 -0
data/lib/fresco/cli/new.rb +120 -0
data/lib/fresco/cli/release.rb +76 -0
data/lib/fresco/cli.rb +56 -0
data/lib/fresco/database_config.rb +34 -0
data/lib/fresco/generators/app/Gemfile.tt +18 -0
data/lib/fresco/generators/app/README.md.tt +32 -0
data/lib/fresco/generators/app/app/action.rb.tt +20 -0
data/lib/fresco/generators/app/app/actions/root_path.rb.tt +5 -0
data/lib/fresco/generators/app/app/views/layouts/application.html.erb +29 -0
data/lib/fresco/generators/app/app/views/root_path.html.erb +8 -0
data/lib/fresco/generators/app/app.rb.tt +15 -0
data/lib/fresco/generators/app/bin/build +2 -0
data/lib/fresco/generators/app/bin/dev +2 -0
data/lib/fresco/generators/app/bin/release +2 -0
data/lib/fresco/generators/app/config/app.rb.tt +26 -0
data/lib/fresco/generators/app/config/database.rb +17 -0
data/lib/fresco/generators/app/config/routes.rb +11 -0
data/lib/fresco/generators/app/db/schema.rb +14 -0
data/lib/fresco/generators/app/public/404.html +87 -0
data/lib/fresco/generators/app/public/500.html +84 -0
data/lib/fresco/migration_builder.rb +55 -0
data/lib/fresco/model_builder.rb +54 -0
data/lib/fresco/paths.rb +20 -0
data/lib/fresco/router.rb +67 -0
data/lib/fresco/runtime/boot.rb +34 -0
data/lib/fresco/runtime/db_postgres.rb +403 -0
data/lib/fresco/runtime/db_sqlite.rb +495 -0
data/lib/fresco/runtime/http.c +456 -0
data/lib/fresco/runtime/postgres.c +339 -0
data/lib/fresco/runtime/runtime.rb +1810 -0
data/lib/fresco/runtime/sqlite.c +220 -0
data/lib/fresco/runtime/welcome.rb +152 -0
data/lib/fresco/schema_builder.rb +71 -0
data/lib/fresco/templates/dispatch.rb.erb +32 -0
data/lib/fresco/templates/layout_dispatch.rb.erb +16 -0
data/lib/fresco/templates/manifest.rb.erb +5 -0
data/lib/fresco/templates/migrations.rb.erb +152 -0
data/lib/fresco/templates/model.rb.erb +223 -0
data/lib/fresco/templates/view.rb.erb +5 -0
data/lib/fresco/version.rb +3 -0
data/lib/fresco.rb +61 -0
metadata +115 -0

data/lib/fresco/generators/app/public/500.html ADDED Viewed

@@ -0,0 +1,84 @@
+<!doctype html>
+<html>
+  <head>
+    <meta charset="utf-8">
+    <title>500 — Internal Server Error</title>
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500;700&display=swap" rel="stylesheet">
+    <script>
+      (function () {
+        var t = localStorage.getItem("theme");
+        if (!t) {
+          t = (window.matchMedia && window.matchMedia("(prefers-color-scheme: dark)").matches) ? "dark" : "light";
+          localStorage.setItem("theme", t);
+        }
+        document.documentElement.setAttribute("data-theme", t);
+      })();
+    </script>
+    <style>
+      :root {
+        --bg: #fff; --fg: #222; --muted: #888;
+        --border: #eee; --code-bg: #f7f7f7;
+        --accent: #0066cc; --status: #b00020;
+      }
+      :root[data-theme="dark"] {
+        --bg: #141414; --fg: #e8e8e8; --muted: #9a9a9a;
+        --border: #2a2a2a; --code-bg: #1f1f1f;
+        --accent: #6ab0ff; --status: #ff6680;
+      }
+      body {
+        font-family: 'IBM Plex Mono', ui-monospace, SFMono-Regular, Menlo, monospace;
+        max-width: 40rem;
+        margin: 4rem auto;
+        padding: 0 1.5rem;
+        background: var(--bg);
+        color: var(--fg);
+        transition: background 0.15s, color 0.15s;
+      }
+      h1 { font-weight: 700; font-size: 1.5rem; margin-bottom: 0.25rem; }
+      .status { color: var(--status); font-size: 0.9rem; letter-spacing: 0.05em; text-transform: uppercase; }
+      p { line-height: 1.5; }
+      code { background: var(--code-bg); padding: 0.1rem 0.3rem; border-radius: 3px; }
+      a { color: var(--accent); }
+      a:hover { text-decoration: underline; }
+      hr { border: none; border-top: 1px solid var(--border); margin: 2rem 0; }
+      footer { color: var(--muted); font-size: 0.85rem; }
+      #theme-toggle {
+        position: fixed; top: 1rem; right: 1rem;
+        background: transparent; border: 1px solid var(--border);
+        color: var(--fg); border-radius: 6px;
+        padding: 0.4rem; cursor: pointer;
+        display: inline-flex; align-items: center; justify-content: center;
+      }
+      #theme-toggle:hover { background: var(--code-bg); }
+      #theme-toggle svg { width: 18px; height: 18px; display: none; }
+      :root[data-theme="light"] #theme-toggle .icon-moon { display: inline-block; }
+      :root[data-theme="dark"]  #theme-toggle .icon-sun  { display: inline-block; }
+    </style>
+  </head>
+  <body>
+    <button id="theme-toggle" aria-label="Toggle color theme" title="Toggle color theme">
+      <svg class="icon-sun" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="4"/><path d="M12 2v2"/><path d="M12 20v2"/><path d="m4.93 4.93 1.41 1.41"/><path d="m17.66 17.66 1.41 1.41"/><path d="M2 12h2"/><path d="M20 12h2"/><path d="m6.34 17.66-1.41 1.41"/><path d="m19.07 4.93-1.41 1.41"/></svg>
+      <svg class="icon-moon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"/></svg>
+    </button>
+    <div class="status">500 &middot; Internal Server Error</div>
+    <h1>Something went wrong on our end.</h1>
+    <p>An action raised an exception while handling the request. The error has been logged; the page you tried to load couldn't be rendered.</p>
+    <p><a href="/">Back to home</a></p>
+    <hr>
+    <footer>Powered by Spinel + Fresco.</footer>
+    <script>
+      (function () {
+        document.getElementById("theme-toggle").addEventListener("click", function () {
+          var cur = document.documentElement.getAttribute("data-theme");
+          var nxt = cur === "dark" ? "light" : "dark";
+          document.documentElement.setAttribute("data-theme", nxt);
+          localStorage.setItem("theme", nxt);
+        });
+      })();
+    </script>
+  </body>
+</html>

data/lib/fresco/migration_builder.rb ADDED Viewed

@@ -0,0 +1,55 @@
+# Build-time migration DSL. db/migrations/<NNNN>_<name>.rb files
+# each call `Fresco.migration "<NNNN>_<name>" do ... end`. `fresco build`
+# loads all migration files in sorted order and emits the captured
+# SQL into generated/migrations.rb, which the runtime runs via
+# `./app db:migrate` / `./app db:rollback`.
+#
+# Each migration captures two ordered Arrays of SQL strings (up and
+# down). No DSL helpers for ALTER / ADD / RENAME yet — write raw SQL
+# in the block. Adapter-specific syntax goes in the file the
+# developer wrote; we don't translate. (M6+ could add adapter-aware
+# helpers, but raw SQL covers the M5 footprint.)
+module Fresco
+  @migrations = []
+  def self.migrations
+    @migrations
+  end
+  def self.migration(name, &blk)
+    builder = Fresco::MigrationBuilder.new
+    builder.instance_eval(&blk) if blk
+    @migrations << {
+      name:     name,
+      up_sql:   builder.up_sql,
+      down_sql: builder.down_sql,
+    }
+  end
+end
+class Fresco::MigrationBuilder
+  attr_reader :up_sql, :down_sql
+  def initialize
+    @up_sql   = []
+    @down_sql = []
+    @current  = nil
+  end
+  def up(&blk)
+    @current = @up_sql
+    instance_eval(&blk) if blk
+    @current = nil
+  end
+  def down(&blk)
+    @current = @down_sql
+    instance_eval(&blk) if blk
+    @current = nil
+  end
+  def sql(stmt)
+    abort "[build] `sql` called outside `up` / `down` block" if @current.nil?
+    @current << stmt
+  end
+end

data/lib/fresco/model_builder.rb ADDED Viewed

@@ -0,0 +1,54 @@
+# Build-time model DSL. Captured by `app/models/*.rb` files; each
+# calls `Fresco.model :User, table: :users do ... end`. `fresco build`
+# iterates `Fresco.models` and emits one generated/models/*.rb
+# per entry, with adapter-specific SQL baked in.
+#
+# Shape captured per model:
+#   { name: :User, table: :users, finders: [:email, :name] }
+module Fresco
+  @models = []
+  def self.models
+    @models
+  end
+  def self.model(name, table:, &blk)
+    builder = Fresco::ModelBuilder.new
+    builder.instance_eval(&blk) if blk
+    @models << {
+      name:       name,
+      table:      table,
+      finders:    builder.finders,
+      validators: builder.validators,
+    }
+  end
+end
+class Fresco::ModelBuilder
+  attr_reader :finders, :validators
+  def initialize
+    @finders    = []
+    @validators = []
+  end
+  # Each call adds one indexed column that gets a `where_<col>`
+  # finder method on the generated model class. Spinel-shape
+  # constraint: each finder is its own typed method, single arity —
+  # we don't generate a dynamic `where(hash)` because hash dispatch
+  # widens to RbVal.
+  def finder(column_name)
+    @finders << column_name
+  end
+  # M4 validations DSL. Currently supports `validates :col, presence:
+  # true` — emitted as a top-of-method early-return guard inside
+  # insert/update. All validation is pure-Ruby (no DB roundtrip);
+  # rules expand to monomorphic `==` / `.length` checks so Spinel
+  # doesn't widen the param types.
+  def validates(column_name, **opts)
+    if opts[:presence]
+      @validators << { column: column_name, rule: :presence }
+    end
+  end
+end

data/lib/fresco/paths.rb ADDED Viewed

@@ -0,0 +1,20 @@
+# Resolves paths into the installed gem so the CLI never hardcodes
+# anything cwd-relative. Codegen reads templates and verbatim runtime
+# files from here; `fresco new` reads the app skeleton from here.
+module Fresco
+  module Paths
+    GEM_ROOT = File.expand_path("../..", __dir__)
+    def self.template_root
+      File.join(GEM_ROOT, "lib/fresco/templates")
+    end
+    def self.runtime_root
+      File.join(GEM_ROOT, "lib/fresco/runtime")
+    end
+    def self.generator_root
+      File.join(GEM_ROOT, "lib/fresco/generators/app")
+    end
+  end
+end

data/lib/fresco/router.rb ADDED Viewed

@@ -0,0 +1,67 @@
+class Fresco::Router
+  # Rails-style CRUD expansion table. Verb / suffix / class suffix
+  # for each of the seven canonical resource actions.
+  RESOURCE_ROUTES = [
+    [:index,   "GET",    "",          "Index"],
+    [:new,     "GET",    "/new",      "New"],
+    [:create,  "POST",   "",          "Create"],
+    [:show,    "GET",    "/:id",      "Show"],
+    [:edit,    "GET",    "/:id/edit", "Edit"],
+    [:update,  "PATCH",  "/:id",      "Update"],
+    [:destroy, "DELETE", "/:id",      "Destroy"],
+  ].freeze
+  # Each entry: [verb, pattern, klass, constraints]. `fresco build` reads
+  # this and emits generated/dispatch.rb.
+  attr_reader :entries
+  def initialize
+    @entries = []
+  end
+  %i[get post put delete patch].each do |verb|
+    define_method(verb) do |pattern, to:, constraints: {}|
+      @entries << [verb.to_s.upcase, pattern, to, constraints]
+    end
+  end
+  # Sugar for `get "/", to: ...`. Mirrors Rails' `root to: Foo`.
+  def root(to:)
+    @entries << ["GET", "/", to, {}]
+  end
+  # Expand `resources :users` into the seven CRUD routes. `only:` /
+  # `except:` filter the set. Each generated route expects a matching
+  # action file under app/actions/ — missing files fail the build
+  # with a path-and-suggestion message rather than emitting a
+  # dispatch line that references a non-existent class.
+  # `resources :users` resolves to namespaced classes — `Users::Index`
+  # at `app/actions/users/index.rb`, not `UsersIndex` flat. Mixing
+  # `resources` with flat files isn't supported on purpose: if you
+  # opt into the resources DSL, you opt into the folder convention.
+  def resources(name, only: nil, except: nil)
+    base_path  = "/#{name}"
+    base_class = camelize(name)
+    RESOURCE_ROUTES.each do |action, verb, suffix, class_suffix|
+      next if only && !only.include?(action)
+      next if except && except.include?(action)
+      class_name = "#{base_class}::#{class_suffix}"
+      file_path  = "app/actions/#{Fresco.class_to_path(class_name)}.rb"
+      unless File.exist?(file_path)
+        raise "[build] resources :#{name} expects #{file_path} for :#{action} " \
+              "(add the file or use `only:`/`except:`)"
+      end
+      Fresco.const_set_path(class_name, Class.new)
+      @entries << [verb, base_path + suffix, Fresco.const_get_path(class_name), {}]
+    end
+  end
+  private
+  def camelize(name)
+    name.to_s.split("_").map(&:capitalize).join
+  end
+end

data/lib/fresco/runtime/boot.rb ADDED Viewed

@@ -0,0 +1,34 @@
+# Fresco: boot sequence. Auto-generated by `fresco build`; do not edit.
+#
+# Source of truth: lib/fresco/runtime/boot.rb in the fresco gem —
+# `fresco build` copies this file verbatim into generated/boot.rb.
+# app.rb requires it and then hands off to App::Base.run.
+#
+# Load order matters:
+#   runtime         → Fresco::Action, Fresco::App, Request, Response, Sock
+#   views           → render_<name> helpers (depend on Spinel::View)
+#   layout_dispatch → dispatch_layout (depends on render_layouts_<name>)
+#   db_adapter      → Fresco::Db::Active + adapter FFI module (Sqlite or Pg);
+#                     empty when no config/database.rb is present
+#   migrations      → Fresco::DbMigrations runner with embedded SQL;
+#                     consumed by `./app db:migrate` / `db:rollback`
+#                     and depends on Fresco::Db.exec being defined
+#   config/app      → App::Base < Fresco::App (depends on runtime)
+#   config/database → Fresco.database :sqlite/:postgres call; sets
+#                     Fresco.app.database_config so actions and (later)
+#                     generated code can read the configured DSN at
+#                     runtime via ENV.fetch
+#   requires        → models + app/action.rb + app/actions/*.rb (depend
+#                     on Fresco::App, dispatch_layout, Fresco::Db, and
+#                     any view helpers actions may call)
+#   dispatch        → dispatch_request (depends on action classes being defined)
+require_relative "runtime"
+require_relative "views"
+require_relative "layout_dispatch"
+require_relative "db_adapter"
+require_relative "migrations"
+require_relative "../config/app"
+require_relative "../config/database"
+require_relative "requires"
+require_relative "dispatch"