tep 0.11.0

data/test/test_websocket_echo.rb

@@ -0,0 +1,138 @@
+# End-to-end smoke test for the bin/tep `websocket '/path' do ... end`
+# DSL hook. Boots a translated echo app on a random port, opens a raw
+# TCP socket, performs the RFC 6455 handshake, sends a masked TEXT
+# frame, asserts the unmasked echo comes back.
+#
+# Lives next to the unit-level test/test_websocket.rb (which covers
+# the codec + handshake math in isolation). This file covers the
+# Driver+Connection+Server integration path that those tests skipped.
+require "minitest/autorun"
+require "socket"
+require "securerandom"
+require "base64"
+require "digest/sha1"
+
+class TestWebSocketEcho < Minitest::Test
+  GUID = "258EAFA5-E914-47DA-95CA-C5AB0DC85B11".freeze
+  ROOT = File.expand_path("..", __dir__)
+  BIN  = File.join(ROOT, "examples", "websocket_echo")
+
+  def setup
+    skip "examples/websocket_echo not built" unless File.executable?(BIN)
+    @port = 40000 + rand(10_000)
+    @pid = spawn(BIN, "-p", @port.to_s, "-q", out: "/dev/null", err: "/dev/null")
+    deadline = Time.now + 5
+    loop do
+      begin
+        s = TCPSocket.new("127.0.0.1", @port)
+        s.close
+        break
+      rescue Errno::ECONNREFUSED
+        raise "server failed to start" if Time.now > deadline
+        sleep 0.05
+      end
+    end
+  end
+
+  def teardown
+    return unless @pid
+    # Bounded reap: TERM, wait up to 5s, then SIGKILL. A bare
+    # Process.wait can hang forever if the server ignores TERM
+    # (single-process here, so the pid signal suffices -- no pgroup).
+    Process.kill("TERM", @pid) rescue nil
+    deadline = Time.now + 5
+    reaped = false
+    until Time.now > deadline
+      got = (Process.waitpid(@pid, Process::WNOHANG) rescue :gone)
+      if got
+        reaped = true
+        break
+      end
+      sleep 0.02
+    end
+    unless reaped
+      Process.kill("KILL", @pid) rescue nil
+      Process.wait(@pid) rescue nil
+    end
+  end
+
+  def expected_accept(key)
+    Base64.strict_encode64(Digest::SHA1.digest(key + GUID))
+  end
+
+  def send_handshake(sock, key)
+    req =
+      "GET /echo HTTP/1.1\r\n" \
+      "Host: 127.0.0.1:#{@port}\r\n" \
+      "Upgrade: websocket\r\n" \
+      "Connection: Upgrade\r\n" \
+      "Sec-WebSocket-Key: #{key}\r\n" \
+      "Sec-WebSocket-Version: 13\r\n" \
+      "\r\n"
+    sock.write(req)
+  end
+
+  def read_until_double_crlf(sock)
+    buf = String.new
+    while !buf.include?("\r\n\r\n")
+      chunk = sock.readpartial(4096)
+      buf << chunk
+    end
+    head, rest = buf.split("\r\n\r\n", 2)
+    [head, rest || ""]
+  end
+
+  def encode_masked_text(payload)
+    mask = SecureRandom.bytes(4)
+    masked = payload.bytes.each_with_index.map { |b, i| b ^ mask.bytes[i & 3] }.pack("C*")
+    [0x81, 0x80 | payload.bytesize].pack("C*") + mask + masked
+  end
+
+  def parse_unmasked_text_frame(buf)
+    raise "frame too short" if buf.bytesize < 2
+    b0 = buf.getbyte(0)
+    b1 = buf.getbyte(1)
+    raise "expected FIN+text (0x81), got 0x#{b0.to_s(16)}" unless b0 == 0x81
+    raise "server frame must not be masked" if (b1 & 0x80) != 0
+    len = b1 & 0x7f
+    pos = 2
+    if len == 126
+      len = (buf.getbyte(pos) << 8) | buf.getbyte(pos + 1)
+      pos += 2
+    elsif len == 127
+      raise "64-bit length not expected in this test"
+    end
+    buf.byteslice(pos, len)
+  end
+
+  def test_handshake_and_echo_round_trip
+    sock = TCPSocket.new("127.0.0.1", @port)
+    key = Base64.strict_encode64(SecureRandom.bytes(16))
+    send_handshake(sock, key)
+
+    head, leftover = read_until_double_crlf(sock)
+    assert_includes head, "HTTP/1.1 101 Switching Protocols", "handshake failed: #{head}"
+    assert_includes head, "Upgrade: websocket"
+    assert_includes head, "Sec-WebSocket-Accept: #{expected_accept(key)}"
+
+    # Server emits a synthetic "welcome" on open.
+    buf = leftover.dup
+    deadline = Time.now + 2
+    while buf.bytesize < 9 && Time.now < deadline
+      buf << sock.readpartial(4096)
+    end
+    welcome = parse_unmasked_text_frame(buf)
+    assert_equal "welcome", welcome
+
+    sock.write(encode_masked_text("hello"))
+    buf2 = String.new
+    deadline = Time.now + 2
+    while buf2.bytesize < 13 && Time.now < deadline
+      buf2 << sock.readpartial(4096)
+    end
+    echo = parse_unmasked_text_frame(buf2)
+    assert_equal "echo: hello", echo
+
+    sock.close
+  end
+end

data/test/views/greet.erb

@@ -0,0 +1,5 @@
+<h1>hi, <%= @name %>!</h1>
+<p>you visited <%= @count %> times.</p>
+<% if @count == "1" %>
+<p>welcome.</p>
+<% end %>

data/test/views/hello.erb

@@ -0,0 +1,5 @@
+<h1>hello, <%= locals["name"] %>!</h1>
+<% if locals["mood"] == "happy" %>
+<p>You seem cheerful.</p>
+<% end %>
+<p>Thanks <%= locals["name"] %>.</p>

data/test/views/list.erb

@@ -0,0 +1,5 @@
+<ul>
+<% (locals["count"]).to_i.times do |i| %>
+<li>item <%= i.to_s %></li>
+<% end %>
+</ul>

data/test/views/m_ivars.mustache

@@ -0,0 +1,3 @@
+<h1>hi, {{@name}}</h1>
+<p>visited: {{@count}}</p>
+<p>raw ivar: {{{@raw}}}</p>

data/test/views/m_simple.mustache

@@ -0,0 +1,4 @@
+<h1>hello, {{name}}!</h1>
+<p>greeting: {{greeting}}</p>
+{{! this comment is dropped }}
+<p>raw html: {{{snippet}}}</p>

data/test/views/mixed.erb

@@ -0,0 +1,3 @@
+<h1>hello, <%= @name %></h1>
+<p>locals greeting: <%= locals["greeting"] %></p>
+<p>ivar greeting: <%= @greeting %></p>

metadata

@@ -0,0 +1,264 @@
+--- !ruby/object:Gem::Specification
+name: tep
+version: !ruby/object:Gem::Version
+  version: 0.11.0
+platform: ruby
+authors:
+- Ori Pekelman
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-06-01 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'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description: |-
+  tep is a small Sinatra-style DSL targeting the Spinel AOT Ruby
+  compiler. The translator turns a Sinatra-classic source file into
+  a self-contained native binary -- ~80 KB on Linux, no Ruby runtime.
+  Pre-alpha: primary purpose is exercising Spinel against real-world
+  Ruby usage; the framework is the test vehicle.
+email:
+- ori@pekelman.com
+executables:
+- tep
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- Makefile
+- README.md
+- SINATRA_COMPAT.md
+- bin/tep
+- examples/agentic_chat/README.md
+- examples/agentic_chat/app.rb
+- examples/api_gateway/README.md
+- examples/api_gateway/app.rb
+- examples/blog/app.rb
+- examples/blog/views/index.erb
+- examples/blog/views/login.erb
+- examples/blog/views/new_post.erb
+- examples/blog/views/show.erb
+- examples/chat/app.rb
+- examples/chat/assets/logo.svg
+- examples/chat/assets/style.css
+- examples/chat/views/index.erb
+- examples/chatbot/README.md
+- examples/chatbot/app.rb
+- examples/chatbot/assets/chat.js
+- examples/chatbot/assets/compare.js
+- examples/chatbot/assets/markdown.js
+- examples/chatbot/assets/style.css
+- examples/chatbot/schema.sql
+- examples/chatbot/views/compare.erb
+- examples/chatbot/views/index.erb
+- examples/chatbot/views/login.erb
+- examples/chatbot/views/setup.erb
+- examples/counter/README.md
+- examples/counter/app.rb
+- examples/experiments/AGENTS.md
+- examples/experiments/README.md
+- examples/experiments/app.rb
+- examples/geohash/Gemfile
+- examples/geohash/Gemfile.lock
+- examples/geohash/README.md
+- examples/geohash/app.rb
+- examples/hello.rb
+- examples/llm_gateway/README.md
+- examples/llm_gateway/app.rb
+- examples/maidenhead/Gemfile
+- examples/maidenhead/Gemfile.lock
+- examples/maidenhead/README.md
+- examples/maidenhead/app.rb
+- examples/pg_hello.rb
+- examples/qdrant/Gemfile
+- examples/qdrant/Gemfile.lock
+- examples/qdrant/README.md
+- examples/sinatra_style.rb
+- examples/websocket_echo.rb
+- lib/tep.rb
+- lib/tep/agent_delegation.rb
+- lib/tep/app.rb
+- lib/tep/assets.rb
+- lib/tep/auth.rb
+- lib/tep/auth_bearer_token.rb
+- lib/tep/auth_oauth2.rb
+- lib/tep/auth_oauth2_client.rb
+- lib/tep/auth_oauth2_code.rb
+- lib/tep/auth_session_cookie.rb
+- lib/tep/broadcast.rb
+- lib/tep/broadcast_subscription.rb
+- lib/tep/cache.rb
+- lib/tep/events.rb
+- lib/tep/filter.rb
+- lib/tep/handler.rb
+- lib/tep/http.rb
+- lib/tep/identity.rb
+- lib/tep/job.rb
+- lib/tep/json.rb
+- lib/tep/jwt.rb
+- lib/tep/live_view.rb
+- lib/tep/llm.rb
+- lib/tep/logger.rb
+- lib/tep/mcp.rb
+- lib/tep/multipart.rb
+- lib/tep/net.rb
+- lib/tep/openai_server.rb
+- lib/tep/parallel.rb
+- lib/tep/parser.rb
+- lib/tep/password.rb
+- lib/tep/pg.rb
+- lib/tep/presence.rb
+- lib/tep/presence_entry.rb
+- lib/tep/proxy.rb
+- lib/tep/request.rb
+- lib/tep/response.rb
+- lib/tep/router.rb
+- lib/tep/scheduler.rb
+- lib/tep/security.rb
+- lib/tep/server.rb
+- lib/tep/server_scheduled.rb
+- lib/tep/session.rb
+- lib/tep/shell.rb
+- lib/tep/sphttp.c
+- lib/tep/sqlite.rb
+- lib/tep/streamer.rb
+- lib/tep/tep_pg.c
+- lib/tep/tep_sqlite.c
+- lib/tep/url.rb
+- lib/tep/version.rb
+- lib/tep/websocket.rb
+- lib/tep/websocket/connection.rb
+- lib/tep/websocket/driver.rb
+- lib/tep/websocket/frame.rb
+- lib/tep/websocket/handshake.rb
+- public/hello.txt
+- public/style.css
+- spinel-ext.json
+- test/helper.rb
+- test/real_world/01_simple.rb
+- test/real_world/02_lifecycle.rb
+- test/real_world/03_chat.rb
+- test/real_world/04_health_api.rb
+- test/real_world/05_todo_api.rb
+- test/real_world/06_basic_auth.rb
+- test/real_world/07_bbc_rest_api.rb
+- test/real_world/07_sklise_things.rb
+- test/real_world/08_jwd83_helloworld.rb
+- test/run_all.rb
+- test/run_parallel.rb
+- test/spinel_scheduled_burst_segv_repro.rb
+- test/test_api_gateway.rb
+- test/test_auth.rb
+- test/test_auth_oauth2.rb
+- test/test_auth_session_cookie.rb
+- test/test_broadcast.rb
+- test/test_broadcast_pg.rb
+- test/test_cache.rb
+- test/test_cache_static.rb
+- test/test_cookies.rb
+- test/test_erb.rb
+- test/test_erb_ivars.rb
+- test/test_events.rb
+- test/test_filters.rb
+- test/test_geohash_example.rb
+- test/test_http.rb
+- test/test_http_pool.rb
+- test/test_http_pool_send.rb
+- test/test_identity.rb
+- test/test_inbound_tls.rb
+- test/test_inbound_tls_scheduled.rb
+- test/test_job.rb
+- test/test_json.rb
+- test/test_jwt.rb
+- test/test_live_view.rb
+- test/test_llm.rb
+- test/test_llm_gateway.rb
+- test/test_logger.rb
+- test/test_maidenhead_example.rb
+- test/test_mcp.rb
+- test/test_misc_v02.rb
+- test/test_modular.rb
+- test/test_multi_filters.rb
+- test/test_mustache.rb
+- test/test_openai_server.rb
+- test/test_optional_segments.rb
+- test/test_parallel.rb
+- test/test_params.rb
+- test/test_pass.rb
+- test/test_password.rb
+- test/test_pg.rb
+- test/test_presence.rb
+- test/test_presence_pg.rb
+- test/test_proxy.rb
+- test/test_proxy_dsl.rb
+- test/test_proxy_streaming.rb
+- test/test_real_world.rb
+- test/test_regex_routes.rb
+- test/test_request_methods.rb
+- test/test_response.rb
+- test/test_routing.rb
+- test/test_scheduler.rb
+- test/test_security.rb
+- test/test_server_scheduled.rb
+- test/test_sessions.rb
+- test/test_shell.rb
+- test/test_sqlite.rb
+- test/test_sqlite_cached.rb
+- test/test_static.rb
+- test/test_streaming.rb
+- test/test_unsupported.rb
+- test/test_websocket.rb
+- test/test_websocket_echo.rb
+- test/views/greet.erb
+- test/views/hello.erb
+- test/views/list.erb
+- test/views/m_ivars.mustache
+- test/views/m_simple.mustache
+- test/views/mixed.erb
+homepage: https://github.com/OriPekelman/tep
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/OriPekelman/tep
+  bug_tracker_uri: https://github.com/OriPekelman/tep/issues
+  documentation_uri: https://github.com/OriPekelman/tep#readme
+  rubygems_mfa_required: 'true'
+post_install_message: |
+  tep is a Spinel-AOT framework: it compiles your Sinatra-style app to
+  a native binary -- there is no `require "tep"` runtime under CRuby.
+    build an app:   tep build app.rb && ./app -p 4567
+    or vendor it:   declare `gem "tep"` in a bundler-spinel (spinelgems)
+                    Gemfile, then `spinel-compat vendor`.
+  Docs: https://github.com/OriPekelman/tep
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.20
+signing_key:
+specification_version: 4
+summary: A Sinatra-flavoured web framework that compiles to a native binary via Spinel
+test_files: []