tep 0.11.0 → 0.11.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 01e96933540bed51cfb5ef9b6edd91154c63d60bf2469eece6e1fbfff42815d5
-  data.tar.gz: 47005866b1f57933b4724c19eb1e387b2d3f0d9e52003cc0d155795ed522977a
+  metadata.gz: ed267cb0d611fda2cb1339ea9751dc723c8c8b2eda6c24b10f4ac3e19f0bb530
+  data.tar.gz: f1e52b916e06975569e4c1fd50ab2759c167fdc9209d8f4066a24c4da98284aa
 SHA512:
-  metadata.gz: 58cbe7986525f4eedd43a6b2e603dca7545a8b7d46d0b241a175e451bbcb9ee8d29e1de0e7b8d323f8cee75d93f4ce24a1f8344593affad0534c71f182f7f442
-  data.tar.gz: 0f31fe5463c71bef2ee00a1507ff2b9a4c45c49023810e3e2a206e10737b6f794bf89c2b09d1eebf3c23b05321f143bc652b117cf4493e4bf259c2f14bf3861e
+  metadata.gz: 980964ad55476805b33d78dc1623d777ee8b0d1205a9b779201ebb8bf71d9a6a5ecd7a2e1966372be11d8583778b026385dfaac56ef2b6d22f5989da34257f39
+  data.tar.gz: b0cceac7ec078c154af037c8484ad269a539dfb39c9a98805c7989846d2a6a0dc4be044cb7ae9053856deb9c4281888fe8f786ba7d9c9c22dd2786208f5f58c6

data/README.md

@@ -7,9 +7,10 @@
 A Sinatra-flavoured web framework that compiles to a native binary
 via [Spinel][spinel].
 
-> **Current release:** [v0.10.0](https://github.com/OriPekelman/tep/releases/tag/v0.10.0)
-> — the Proxy + OpenAI-server + Events batteries on top of the agentic
-> surface (Auth, Broadcast, Presence, LiveView, MCP).
+> **Current release:** [v0.11.0](https://github.com/OriPekelman/tep/releases/tag/v0.11.0)
+> — now on [RubyGems](https://rubygems.org/gems/tep) (`gem install tep`):
+> TLS, HTTP caching, connection pooling, PG raise-on-error + embeddings,
+> on top of the agentic surface (Auth, Broadcast, Presence, LiveView, MCP).
 > Pre-alpha; API still in motion.
 
 > **Why Tep exists.** Two complementary goals:
@@ -39,22 +40,25 @@ via [Spinel][spinel].
 
 ## Quick start
 
-```sh
-# 1. install Spinel
-git clone https://github.com/matz/spinel
-cd spinel && make all
-export PATH="$PWD:$PATH"
+**A new project (the simple path).** The Spinel toolbelt
+([bundler-spinel](https://github.com/OriPekelman/spinelgems)) scaffolds a
+project and provisions the Spinel compiler for you:
 
-# 2. install Tep
-git clone https://github.com/OriPekelman/tep
-cd tep && make all
-./examples/hello -p 4567
+```sh
+gem install bundler-spinel
+spinel-compat init my_app && cd my_app
+./bin/build            # ensures tep, vendors deps, provisions Spinel, compiles → ./app
+./app -p 4567
 ```
 
-Your own app:
+`spinel-compat init` writes a `Gemfile` (`gem "tep"`), an `app.rb`, and a
+`bin/build`. The build step provisions a pinned Spinel compiler (cached under
+`~/.cache/spinel`), vendors dependencies where Spinel can follow them, and
+compiles `app.rb` to a native binary — no Ruby runtime in the result.
+
+Your `app.rb` is plain Sinatra-flavoured Ruby:
 
 ```ruby
-# hello.rb
 require 'sinatra'
 
 get '/' do
@@ -66,10 +70,35 @@ get '/hi/:name' do
 end
 ```
 
+**Already have a Sinatra app?** Scaffold a project and use your source as its
+`app.rb` — the build reports any Spinel-incompatible patterns:
+
 ```sh
-tep build hello.rb       # -> ./hello (~80 KB binary, no Ruby runtime)
-./hello -p 4567
+gem install bundler-spinel
+spinel-compat init my_app && cd my_app
+cp /path/to/your_app.rb app.rb
+./bin/build                      # → ./app  (or a clear report of what won't translate)
+```
+
+The `tep` translator is also on RubyGems on its own (`gem install tep`) for use
+in your own build scripts, once a Spinel engine is on `$SPINEL` / PATH.
+
+<details>
+<summary><b>From source</b> (hacking on tep itself, or no bundler)</summary>
+
+```sh
+# 1. Spinel (the AOT compiler)
+git clone https://github.com/matz/spinel && cd spinel && make all
+export PATH="$PWD:$PATH"
+
+# 2. tep
+git clone https://github.com/OriPekelman/tep && cd tep && make all
+./examples/hello -p 4567
+
+# your own app
+tep build hello.rb       # → ./hello (~80 KB binary, no Ruby runtime)
 ```
+</details>
 
 The translator (`bin/tep`) needs CRuby >= 3.2 with the `prism` gem
 installed (a development-only dependency — `bundle install` brings it

data/bin/tep

@@ -55,14 +55,23 @@ require "json"
 
 # Resolve spinel: explicit env var wins, then a sibling
 # `../spinel/spinel` checkout (matches the typical dev layout where
-# tep and spinel are checked out side by side), then plain `spinel`
-# on PATH. The Makefile exports SPINEL=spinel by default; treat the
-# literal placeholder as unset so the sibling fallback still fires.
+# tep and spinel are checked out side by side), then the engine
+# provisioned by `spinel-compat install-engine` (spinelgems) at
+# `~/.cache/spinel/current/spinel`, then plain `spinel` on PATH. The
+# Makefile exports SPINEL=spinel by default; treat the literal
+# placeholder as unset so the fallbacks still fire.
 def self.locate_spinel
   e = ENV["SPINEL"]
   return e if e && !e.empty? && e != "spinel"
   sibling = File.expand_path("../../spinel/spinel", __dir__)
   return sibling if File.executable?(sibling)
+  # Engine provisioned by `spinel-compat install-engine`. Honor
+  # SPINEL_CACHE like bundler-spinel does so a relocated cache resolves
+  # for both tools (default ~/.cache/spinel; `current` -> the pinned rev).
+  cache_root = ENV["SPINEL_CACHE"]
+  cache_root = "~/.cache/spinel" if cache_root.nil? || cache_root.empty?
+  provisioned = File.expand_path(cache_root + "/current/spinel")
+  return provisioned if File.executable?(provisioned)
   "spinel"
 end
 SPINEL = locate_spinel
@@ -1928,13 +1937,13 @@ end
 def tep_ext_subs
   ext_path = File.join(REPO_ROOT, "spinel-ext.json")
   return {} unless File.exist?(ext_path)
+  entries = JSON.parse(File.read(ext_path))
   subs = {}
-  JSON.parse(File.read(ext_path)).each do |entry|
+  entries.each do |entry|
     placeholder = entry["placeholder"]
     env_var = placeholder.delete("@")          # @TEP_SPHTTP_O@ -> TEP_SPHTTP_O
     if entry["source"]
-      default_o = File.expand_path(entry["source"].sub(/\.c\z/, ".o"), REPO_ROOT)
-      subs[placeholder] = ENV.fetch(env_var, default_o)
+      subs[placeholder] = resolve_ext_o(entry, entries, env_var)
     else
       cflags       = ENV.fetch(env_var, "")
       libs_var     = env_var.sub(/_CFLAGS\z/, "_LIBS")
@@ -1946,6 +1955,53 @@ def tep_ext_subs
   subs
 end
 
+# Resolve a helper `.o`. An explicit env override or a prebuilt `make helper`
+# artifact wins; otherwise build it on demand. The published gem ships the C
+# *sources* but no `.o` (a `gem install tep` user has no `make helper` step), so
+# without this `tep build` fails at link with `cannot find lib/tep/<x>.o`.
+# Compiles into a writable per-gem cache (the installed gem's lib/ is often
+# read-only). Returns the `.o` path, or "" for an optional ext whose system dep
+# is missing (required exts are fatal).
+def resolve_ext_o(entry, entries, env_var)
+  if (o = ENV[env_var]) && !o.empty?
+    return o if File.exist?(o)
+  end
+  prebuilt = File.expand_path(entry["source"].sub(/\.c\z/, ".o"), REPO_ROOT)
+  return prebuilt if File.exist?(prebuilt)
+
+  src = File.expand_path(entry["source"], REPO_ROOT)
+  fatal("ext source missing: #{entry["source"]}") unless File.exist?(src)
+
+  # own cflags + any same-name sibling's pkg_config include path (the split
+  # @MOD_O@ / @MOD_CFLAGS@ pair — e.g. pg's libpq lives on @TEP_PG_CFLAGS@).
+  cflags = Array(entry["cflags"]).dup
+  missing = nil
+  entries.each do |sib|
+    next unless sib["name"] == entry["name"] && sib["pkg_config"]
+    pc = `pkg-config --cflags #{sib["pkg_config"]} 2>/dev/null`
+    $?.success? ? cflags.concat(pc.split) : (missing = sib["pkg_config"])
+  end
+  if missing
+    return "" if entry["optional"]
+    fatal("ext '#{entry["name"]}' needs #{missing} — install its -dev headers")
+  end
+
+  cache = File.join(ENV["HOME"] || Dir.tmpdir, ".cache", "tep", "ext", File.basename(REPO_ROOT))
+  FileUtils.mkdir_p(cache)
+  out = File.join(cache, File.basename(prebuilt))
+  return out if File.exist?(out) && File.mtime(out) >= File.mtime(src)
+
+  warn "[tep] building ext '#{entry["name"]}' on demand (#{entry["source"]})"
+  if system(ENV.fetch("CC", "cc"), *cflags, "-c", src, "-o", out) && File.exist?(out)
+    out
+  elsif entry["optional"]
+    warn "[tep] optional ext '#{entry["name"]}' failed to build — disabling"
+    ""
+  else
+    fatal("failed to build required ext '#{entry["name"]}' (#{entry["source"]})")
+  end
+end
+
 # Split a Sinatra-style source on `__END__` and parse the trailing
 # `@@ name` blocks into a {name => template_body} hash.
 def split_inline_views(raw)

data/lib/tep/version.rb

@@ -1,3 +1,3 @@
 module Tep
-  VERSION = "0.11.0"
+  VERSION = "0.11.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tep
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.11.1
 platform: ruby
 authors:
 - Ori Pekelman