syntropy 0.32.0 → 0.34.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fbf52e43aad7bcf2dc6259fd40dac6fb6f70d2215513ae89a5e72b120c4b8585
-  data.tar.gz: 7a7fd31a1e47bf999d64ad3216bb2c77345a4eb3753df6e2a51384870d9f764f
+  metadata.gz: 29b7fe87a7350db0c154f0ee25b1c6992c81aead3938cec537e383dc5e3f6a62
+  data.tar.gz: 7dcf8de792102d368aefed72ced1ac3c2e5afd1fe0aea3ac106150fa59862a6b
 SHA512:
-  metadata.gz: ff3ac2fbb77785db855080dcd0302beb61332c067c30db6330540cda9a60a7ab72ad684b87772951e8498d5c6aa10b2cf57cce7f1a85932f95db889432c704a0
-  data.tar.gz: 84ee4aa581f46c84999109bb102d9c890f9dc45b2803a52f114357981edf9150b84c187ba3a62670691e3eb8629b6396bd8f1789f882857b1558089c198f2877
+  metadata.gz: 904b3740de777c83a631b4b0b37f72ee22b698b2f1618110a906c6ca5adf979f0c46c84af08d1ae228f8b9aa90bcb54093e88de9c18dcf3961d72ea7e0d94d2c
+  data.tar.gz: '0081303c531b38423d94f43423efcdcd80852201b0826f0078b276618b03dc7cde09e24dd599e8cee58ddf4ae8ce1f226d4684b4aa8592407728b9f911e30cc5'

data/CHANGELOG.md

@@ -1,3 +1,17 @@
+# 0.34.0 2026-06-03
+
+- Streamline options for CLI commands
+- Remove `App#setup_db`
+- Add support for config modules (e.g. `config/development.rb`)
+- Add support for running modes: production, development, test
+
+# 0.33.0 2026-06-02
+
+- Fix `ModuleLoader` to load a module only once
+- Improve testing tools, add `Syntropy::Test` class
+- Implement `Request#session`, `Request#flash`
+- Improve `Request#set_cookie`
+
 # 0.32.0 2026-06-01
 
 - Ensure HTTP request body is consumed (skipped) before treating next request

data/TODO.md

@@ -1,44 +1,5 @@
 ## Immediate
 
-- [ ] Session
-
-  https://guides.rubyonrails.org/action_controller_overview.html#session
-
-  We want something that offers the same features as in Ruby on Rails. A storage
-  space for session metadata which can include a user_id, flash messages etc.
-
-  - The session is attached to the request, and is valid for the browser
-    session.
-  - The session is a KV store. It can be used to store any data relevant to the
-    user's browser session.
-  - Each session has a unique ID and that ID is passed to the browser as a
-    non-persistent cookie.
-  - A session expires if not used (e.g. after 7 days)
-  - Session storage either in memory or in DB
-  - The session is generated (and session cookie set) upon first write to
-    session.
-  - Session `Set-Cookie` header should be injected into the HTTP response.
-  - The entire session info can be stored in a cookie, provided it does not
-    exceed 4KB.
-
-  ```ruby
-  req.session[:flash] = 'Title cannot be empty!'
-  req.redirect '/blah'
-  ```
-
-- [ ] Flash messages
-
-  - Flash messages are a sub-feature of session storage and are used to relay
-    messages from one request to the next in the same session.
-  - Flash messages have more complex semantics:
-    - There can be more than one.
-    - They have types - notice, alert, etc.
-    - They normally disappear on the next request (i.e. the session cookie
-      should be updated in the response with Set-Cookie).
-    - But, you can keep them for the next request with `req.session.flash.keep`
-    - The flash messages could be used for the current request with
-      `req.session.flash.now`
-
 - [ ] Collection - treat directories and files as collections of data.
 
   Kind of similar to the routing tree, but instead of routes it just takes a

data/cmd/console.rb

@@ -2,16 +2,28 @@
 
 require_relative '../lib/syntropy'
 require 'optparse'
+require 'fileutils'
 
 env = {
+  app_root:             File.join(FileUtils.pwd, 'app'),
+  config_root:          File.join(FileUtils.pwd, 'config'),
+  mode:                 ENV['SYNTROPY_MODE'] || 'development',
   mount_path:           '/',
-  logger:               true,
   builtin_applet_path:  '/.syntropy',
+  logger:               true,
   watch_files:          true
 }
 
 parser = OptionParser.new do |o|
-  o.banner = 'Usage: syntropy serve [options] DIR'
+  o.banner = 'Usage: syntropy serve [options]'
+
+  o.on('-a', '--app PATH', 'Set app directory (default: ./app') do |path|
+    env[:app_root] = path
+  end
+
+  o.on('-c', '--config PATH', 'Set config directory (default: ./config') do |path|
+    env[:config_root] = path
+  end
 
   o.on('-h', '--help', 'Show this help message') do
     puts o
@@ -19,7 +31,6 @@ parser = OptionParser.new do |o|
   end
 
   o.on('-m', '--mount PATH', 'Set mount path (default: /)') do |path|
-    p mount: path
     env[:mount_path] = path
     env[:builtin_applet_path] = File.join(path, '.syntropy')
   end
@@ -43,11 +54,11 @@ rescue StandardError => e
   exit
 end
 
-$syntropy_dev_mode = env[:dev_mode]
-env[:root_dir] = (ARGV.shift || '.').gsub(/\/$/, '')
+Syntropy.dev_mode = env[:mode] == 'development'
+Syntropy.load_config(env)
 
-if !File.directory?(env[:root_dir])
-  puts "#{File.expand_path(env[:root_dir])} Not a directory"
+if !File.directory?(env[:app_root])
+  puts "#{File.expand_path(env[:app_root])} Not a directory"
   exit
 end
 

data/cmd/serve.rb

@@ -2,19 +2,27 @@
 
 require_relative '../lib/syntropy'
 require 'optparse'
+require 'fileutils'
 
 env = {
-  mount_path: '/',
-  logger: true,
-  builtin_applet_path: '/.syntropy',
-  server_extensions: {
+  app_root:             File.join(FileUtils.pwd, 'app'),
+  config_root:          File.join(FileUtils.pwd, 'config'),
+  mode:                 ENV['SYNTROPY_MODE'] || 'development',
+  mount_path:           '/',
+  builtin_applet_path:  '/.syntropy',
+  logger:               true,
+  server_extensions:    {
     date: true,
     name: 'Syntropy'
   }
 }
 
 parser = OptionParser.new do |o|
-  o.banner = 'Usage: syntropy serve [options] DIR'
+  o.banner = 'Usage: syntropy serve [options]'
+
+  o.on('-a', '--app PATH', 'Set app directory (default: ./app') do |path|
+    env[:app_root] = path
+  end
 
   o.on('-b', '--bind BIND', String,
        'Bind address (default: http://0.0.0.0:1234). You can specify this flag multiple times to bind to multiple addresses.') do
@@ -22,14 +30,8 @@ parser = OptionParser.new do |o|
     env[:bind] << it
   end
 
-  o.on('-s', '--silent', 'Silent mode') do
-    env[:banner] = nil
-    env[:logger] = nil
-  end
-
-  o.on('-d', '--dev', 'Development mode') do
-    env[:dev_mode] = true
-    env[:watch_files] = true
+  o.on('-c', '--config PATH', 'Set config directory (default: ./config') do |path|
+    env[:config_root] = path
   end
 
   o.on('-h', '--help', 'Show this help message') do
@@ -38,7 +40,6 @@ parser = OptionParser.new do |o|
   end
 
   o.on('-m', '--mount PATH', 'Set mount path (default: /)') do |path|
-    p mount: path
     env[:mount_path] = path
     env[:builtin_applet_path] = File.join(path, '.syntropy')
   end
@@ -51,6 +52,11 @@ parser = OptionParser.new do |o|
     env[:server_extensions] = nil
   end
 
+  o.on('-s', '--silent', 'Silent mode') do
+    env[:banner] = nil
+    env[:logger] = nil
+  end
+
   o.on('-v', '--version', 'Show version') do
     require 'syntropy/version'
     puts "Syntropy version #{Syntropy::VERSION}"
@@ -72,24 +78,24 @@ rescue StandardError => e
   exit
 end
 
-$syntropy_dev_mode = env[:dev_mode]
-env[:root_dir] = (ARGV.shift || '.').gsub(/\/$/, '')
+Syntropy.dev_mode = env[:mode] == 'development'
+Syntropy.load_config(env)
+env[:watch_files] = Syntropy.dev_mode
 
-if !File.directory?(env[:root_dir])
-  puts "#{File.expand_path(env[:root_dir])} Not a directory"
+if !File.directory?(env[:app_root])
+  puts "#{File.expand_path(env[:app_root])} Not a directory"
   exit
 end
 
 puts env[:banner] if env[:banner]
 env[:banner] = false
 
-
 # We set Syntropy.machine so we can reference it from anywhere
 env[:machine] = Syntropy.machine = UM.new
 env[:logger] = env[:logger] && Syntropy::Logger.new(env[:machine], **env)
 
 require 'syntropy/version'
-require 'syntropy/dev_mode' if env[:dev_mode]
+require 'syntropy/dev_mode' if Syntropy.dev_mode
 
 app = Syntropy::App.load(env)
 Syntropy.run(env) { app.call(it) }

data/cmd/test.rb

@@ -1,40 +1,109 @@
 # frozen_string_literal: true
 
-env = {}
+require 'fileutils'
+require 'optparse'
+
+pwd = FileUtils.pwd
+env = {
+  app_root:             File.join(FileUtils.pwd, 'app'),
+  config_root:          File.join(FileUtils.pwd, 'config'),
+  test_root:             File.join(pwd, 'test'),
+  mode:                 'test',
+  mount_path:           '/'
+}
+MINITEST_ARGV = []
+
+parser = OptionParser.new do |o|
+  o.banner = 'Usage: syntropy test [options]'
+
+  o.on('-a', '--app PATH', 'Set app directory (default: ./app') do |path|
+    env[:app_root] = path
+  end
+
+  o.on('-c', '--config PATH', 'Set config directory (default: ./config') do |path|
+    env[:config_root] = path
+  end
+
+  o.on('-h', '--help', 'Show this help message') do
+    puts o
+    exit
+  end
+
+  o.on('-m', '--mount PATH', 'Set mount path (default: /)') do |path|
+    env[:mount_path] = path
+    env[:builtin_applet_path] = File.join(path, '.syntropy')
+  end
+
+  o.on('-n', '--name NAME', 'Specify test to run') do |name|
+    MINITEST_ARGV << '--name' << name
+  end
+
+  o.on('-s', '--seed SEED', 'Specify random seed') do |seed|
+    MINITEST_ARGV << '--seed' << seed
+  end
+
+  o.on('-t', '--test PATH', 'Set test directory (default: ./test)') do |path|
+    env[:test_root] = path
+  end
+
+  o.on('-V', '--verbose', 'Verbose test output') do
+    MINITEST_ARGV << '--verbose'
+  end
+
+  o.on('-v', '--version', 'Show version') do
+    require 'syntropy/version'
+    puts "Syntropy version #{Syntropy::VERSION}"
+    exit
+  end
+
+  o.on('-w', '--watch', 'Watch for file changes') do
+    env[:watch_mode] = true
+  end
+end
+
 argv_copy = ARGV.dup
-case ARGV[0]
-when '-w', '--watch'
-  env[:watch_mode] = true
-  ARGV.shift
-when '-h', '--help'
-  puts <<~MSG
-    Usage: syntropy test [options] [minitest options]
-        -w, --watch         Rerun tests on file system changes
-        -h, --help          Show this help message
-  MSG
+begin
+  parser.parse!
+rescue OptionParser::InvalidOption
+  puts parser
+  exit
+rescue StandardError => e
+  p e
+  puts e.message
+  puts e.backtrace.join("\n")
   exit
 end
 
 require_relative '../lib/syntropy'
 require_relative '../lib/syntropy/test'
 
+Syntropy.load_config(env)
+
 $stdout.sync = true
 $stderr.sync = true
 
-Dir.glob("./test/test_*.rb").each { require(it) }
+Dir.glob("#{File.expand_path(env[:test_root])}/test_*.rb").each { require(it) }
+
+def restart_on_file_change(machine, dir, restart_argv)
 
-def watch_for_file_changes
-  m = UM.new
-  puts "Waiting for file changes in #{FileUtils.pwd}"
-  m.file_watch(FileUtils.pwd, UM::IN_CREATE | UM::IN_DELETE | UM::IN_CLOSE_WRITE) {
-    puts "Detected changes to #{it[:fn]}, restarting"
+  machine.file_watch(dir, UM::IN_CREATE | UM::IN_DELETE | UM::IN_CLOSE_WRITE) {
+    machine.write(UM::STDOUT_FILENO, "File changed: #{it[:fn]}\n")
     break
   }
+  exec('ruby', __FILE__, *restart_argv)
 end
 
-Minitest.run ARGV
+Syntropy::Test.env = (env)
+Minitest.run MINITEST_ARGV
+
 if env[:watch_mode]
-  puts
-  watch_for_file_changes
-  exec("ruby", __FILE__, *argv_copy)
+  m = UM.new(size: 4)
+  m.write(UM::STDOUT_FILENO, "\n")
+  trap('SIGINT') { m.write(UM::STDOUT_FILENO, "\n"); exit! }
+
+  machine.write(UM::STDOUT_FILENO, "Waiting for file changes...\n")
+  m.join(
+    m.spin { restart_on_file_change(m, env[:app_root], argv_copy) },
+    m.spin { restart_on_file_change(m, env[:test_root], argv_copy) }
+  )
 end

data/examples/blog/.gitignore

@@ -0,0 +1 @@
+storage/*

data/examples/blog/app/_lib/database.rb

@@ -0,0 +1,13 @@
+export self
+
+def connection_pool
+  @connection_pool ||= DB::ConnectionPool.new(@machine, @env[:config][:storage][:path], 4)
+end
+
+def schema
+  DB::Schema.new(module_loader: @module_loader, schema_root: '_schema')
+end
+
+def migrate!
+  schema.apply(connection_pool)
+end

data/examples/blog/app/_lib/{post_store.rb → posts.rb}

@@ -1,3 +1,5 @@
+DB = import '/_lib/database'
+
 class PostStore < Syntropy::DB::Store
   # @return [Integer] post id
   def create(title, body)
@@ -44,4 +46,4 @@ class PostStore < Syntropy::DB::Store
   end
 end
 
-export PostStore.new(@app.connection_pool)
+export PostStore.new(DB.connection_pool)

data/examples/blog/app/posts/[id]/edit.rb

@@ -1,11 +1,11 @@
-@post_store = import '/_lib/post_store'
+@posts = import '/_lib/posts'
 @layout = import '/_layout/default'
 
 export http_methods
 
 def get(req)
   id = req.route_params['id'].to_i
-  post = @post_store.get(id)
+  post = @posts.get(id)
   raise Syntropy::Error.not_found if !post
 
   req.respond_html(

data/examples/blog/app/posts/[id]/index.rb

@@ -1,15 +1,15 @@
-@post_store = import '/_lib/post_store'
+@posts = import '/_lib/posts'
 @layout = import '/_layout/default'
 
 export http_methods
 
 def get(req)
   id = req.route_params['id'].to_i
-  post = @post_store.get(id)
+  post = @posts.get(id)
   raise Syntropy::Error.not_found if !post
 
   req.respond_html(
-    @template.render(post:)
+    @template.render(post:, req:)
   )
 end
 
@@ -21,23 +21,26 @@ def post(req)
   title = req.validate(data['title'], String, /.+/)
   body = req.validate(data['body'], String, /.+/)
 
-  updated = @post_store.update(id, title, body)
+  updated = @posts.update(id, title, body)
   raise BadRequestError, "Failed to update post" if updated != 1
 
+  req.flash[:notice] = 'Post was successfully updated.'
   req.redirect "/posts/#{id}", Syntropy::HTTP::SEE_OTHER
 end
 
 def delete(req)
   id = req.route_params['id'].to_i
 
-  deleted = @post_store.delete(id)
+  deleted = @posts.delete(id)
   raise BadRequestError, "Failed to delete post" if deleted != 1
 
+  req.flash[:notice] = 'Post was successfully destroyed.'
   req.redirect "/posts", Syntropy::HTTP::SEE_OTHER
 end
 
 @template = @layout.apply { |post:, **props|
   h1 "My blog"
+  p props[:req]&.flash[:notice], style: 'color: green'
   div {
     h2 {
       a post[:title]

data/examples/blog/app/posts/index.rb

@@ -1,12 +1,12 @@
-@post_store = import '_lib/post_store'
+@posts = import '_lib/posts'
 @layout = import '_layout/default'
 
 export http_methods
 
 def get(req)
-  posts = @post_store.get_all
+  posts = @posts.get_all
   req.respond_html(
-    @template.render(posts:)
+    @template.render(posts:, req:)
   )
 end
 
@@ -14,13 +14,15 @@ def post(req)
   data = req.get_form_data
   title = req.validate(data['title'], String, /.+/)
   body = req.validate(data['body'], String, /.+/)
-  id = @post_store.create(title, body)
+  id = @posts.create(title, body)
 
+  req.flash[:notice] = 'Post was successfully created.'
   req.redirect("posts/#{id}")
 end
 
 @template = @layout.apply { |**props|
-  h1 "My blog"
+  h1 "My awesome blog"
+  p props[:req]&.flash[:notice], style: 'color: green'
   props[:posts].each { |post|
     div {
       h2 {

data/examples/blog/app/posts/new.rb

@@ -1,4 +1,4 @@
-@post_store = import '/_lib/post_store'
+@posts = import '/_lib/posts'
 @layout = import '/_layout/default'
 
 export http_methods

data/examples/blog/config/development.rb

@@ -0,0 +1,5 @@
+export(
+  storage: {
+    path: ENV['DATABASE_PATH'] || 'storage/development.db'
+  }
+)

data/examples/blog/config/production.rb

@@ -0,0 +1,4 @@
+export(
+  storage:
+    path: ENV['DATABASE_PATH'] || 'storage/production.db'
+)

data/examples/blog/config/test.rb

@@ -0,0 +1,5 @@
+export({
+  storage: {
+    path: ENV['DATABASE_PATH'] || Syntropy.tmp_path('test-db')
+  }
+})

data/examples/blog/test/test_posts.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+class PostsTest < Syntropy::Test
+  def setup
+    super
+    @posts = load_module('/_lib/posts')
+  end
+
+  def test_get_all
+    assert_equal [], @posts.get_all
+
+    @posts.create('foo', 'bar')
+
+    assert_equal [
+      { id: 1, title: 'foo', body: 'bar' }
+    ], @posts.get_all
+  end
+
+  def test_get
+    assert_nil @posts.get(1)
+    assert_nil @posts.get(2)
+
+    @posts.create('foo', 'bar')
+
+    assert_equal(
+      { id: 1, title: 'foo', body: 'bar' },
+      @posts.get(1)
+    )
+    assert_nil @posts.get(2)
+
+    @posts.create('bar', 'baz')
+
+    assert_equal(
+      { id: 1, title: 'foo', body: 'bar' },
+      @posts.get(1)
+    )
+    assert_equal(
+      { id: 2, title: 'bar', body: 'baz' },
+      @posts.get(2)
+    )
+  end
+
+  def test_update
+    assert_equal 0, @posts.update(1, 'qqq', 'ttt')
+
+    @posts.create('foo', 'bar')
+    assert_equal 1, @posts.update(1, 'qqq', 'ttt')
+
+    assert_equal [
+      { id: 1, title: 'qqq', body: 'ttt' }
+    ], @posts.get_all
+  end
+
+  def test_delete
+    assert_equal 0, @posts.delete(1)
+
+    @posts.create('foo', 'bar')
+    @posts.create('bar', 'baz')
+
+    assert_equal 1, @posts.delete(1)
+    assert_equal [
+      { id: 2, title: 'bar', body: 'baz' }
+    ], @posts.get_all
+  end
+end

data/examples/mcp-oauth/app/oauth/token.rb

@@ -65,7 +65,7 @@ rescue ValidationError => e
     },
     ':status' => Syntropy::HTTP::BAD_REQUEST
   )
-rescue => e
+rescue StandardError => e
   status = Syntropy::Error.http_status(e)
   raise if status == HTTP::INTERNAL_SERVER_ERROR
 

data/examples/mcp-oauth/test/test_app.rb

@@ -1,26 +1,8 @@
 # frozen_string_literal: true
 
-require_relative 'helper'
-
-class AppTest < Minitest::Test
-  APP_ROOT = File.expand_path(File.join(__dir__, '../app'))
-  HTTP = Syntropy::HTTP
-
-  def setup
-    @machine = UM.new
-    @app = Syntropy::App.new(
-      root_dir: APP_ROOT,
-      mount_path: '/',
-      machine: @machine
-    )
-    @test_harness = Syntropy::TestHarness.new(@app)
-  end
-
+class AppTest < Syntropy::Test
   def test_root
-    req = @test_harness.request(
-      ':method' => 'GET',
-      ':path'   => '/'
-    )
+    req = get('/')
     assert_equal HTTP::OK, req.response_status
     assert_match /Syntropy/, req.response_body
   end