syntropy 0.43.0 → 0.44.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6109ea0e6322adfd9467ba0aed2b85f04182556dc24efa07eaa6982a19a05480
-  data.tar.gz: 24520d125bf9f1c2bf54af4def8e2b7f2f0027da3e2508f58f754e46d48e6610
+  metadata.gz: 277eab69875c267230dd9c936c17d0bfcb4ee53a3b8baa5a3bea632a8a1517d4
+  data.tar.gz: 753ca178d4d5be205ee2d71ee08509b1f8745db80bba1b23785e08a0c7608265
 SHA512:
-  metadata.gz: 1af2662580cac682ca0162c2d7088ad2756d0738b8f16cbf41102b3ee06d9283118bafcac36fe24b388f46801481d279833e9bd3b44b6394b2af1ecca7a4856a
-  data.tar.gz: 26a62a199095a62dcdda41a811991a0818934959f2fd4851d224e83790b26beb305a0e258cbae63e08d018742727d9b789444754e3d99cfb3c5c9291b6804d2e
+  metadata.gz: f80177d7e93d797a0ef12644e62265b198275ceac4c0621dc10ab692806bb0f98eb99c4082c84fcada831deaee27d86b1fe9323228fa745b609e4ad18ba94987
+  data.tar.gz: 296a00998843af0e1a900ff51419613c6fdb6b4e68c0cd6e14d557ed04c9598e5826c50925954b65d56e8353efdfeb3fb7cea87406d4fe76f829ea092ef47f1b

data/CHANGELOG.md

@@ -1,3 +1,12 @@
+# 0.44.0 2026-11-05
+
+- Rename `Request#json_pretty_response` to `Request#respond_json_pretty`
+- Rename `Request#method` to `Request#http_method`
+- Add `Request#respond_sse` and `Request#send_event` methods
+- Add `Error.bad_request` helper method
+- Prevent multiple redundant `return nil` statements at end of router proc code
+- Implement `Request#rel_path` for wildcard routes
+
 # 0.43.0 2026-10-07
 
 - Fix logging

data/TODO.md

@@ -1,3 +1,30 @@
+## Immediate
+
+- Datastar-specific APIs:
+
+  ```ruby
+  req.respond_sse {
+    req.send_datastar_event(patch_signals: { _states: { '/time' => Time.now.to_i } })
+  }
+
+  # and also without a block (for non-streaming datastar events)
+  req.respond_sse(
+    'datastar-patch-signals' => 'signals { _states: { '/time': #{Time.now.to_i} } }'
+  )
+
+  # more sugar:
+  req.respond_datastar(
+    patch_signals: { _states: { '/time' => Time.now.to_i } }
+  )
+  ```
+
+- gitshabbos
+  - main (README) page `/[repo]`
+  - commits page       `/[repo]/commits`
+  - file page          `/[repo]/tree/**`
+  - raw page           `/[repo]/raw/**`
+  - git protocol       `/[repo]/git/**`
+
 ## Extralite doc site
 
 - Similar to Papercraft site
@@ -98,6 +125,39 @@ Verbose output (`-v`):
 - CLI command `syntropy background`
 - Run automatically when running `syntropy serve` in dev mode
 
+```sql
+create table jobs (
+  id blob primary key not null,
+  due_stamp integer,
+  interval integer,
+  retry_count integer not null,
+  state integer not null, -- pending/running/done
+  payload jsonb not null
+) strict;
+
+create index idx_jobs_pending on jobs (state) where state = 1;
+
+create table job_receipts (
+  id integer primary key autoincrement,
+  stamp integer not null,
+  job_id blob not null,
+  retry_count integer not null,
+  payload jsonb not null,
+  result jsonb not null
+) strict;
+
+create index idx_job_receipts_stamp on job_receipts (stamp);
+create index idx_job_receipts_job_id on job_receipts (job_id);
+```
+
+Create a UUID (not really conforming to UUID v4 RFC 4122, just 16 random bytes):
+
+```ruby
+require 'securerandom'
+
+uuid = SecureRandom.random_bytes(16)
+```
+
 ## Admin Dashboard
 
 - Server state / stats

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

@@ -4,7 +4,7 @@
 export dispatch_by_http_method
 
 def get(req)
-  id = req.route_params['id'].to_i
+  id = req.route_params[:id].to_i
   post = @posts.get(id)
   raise Syntropy::Error.not_found if !post
 

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

@@ -4,7 +4,7 @@
 export dispatch_by_http_method
 
 def get(req)
-  id = req.route_params['id'].to_i
+  id = req.route_params[:id].to_i
   post = @posts.get(id)
   raise Syntropy::Error.not_found if !post
 
@@ -15,7 +15,7 @@ def post(req)
   data = req.get_form_data
   return delete(req) if data['method'] == 'delete'
 
-  id = req.route_params['id'].to_i
+  id = req.route_params[:id].to_i
   title = req.validate(data['title'], String, /.+/)
   body = req.validate(data['body'], String, /.+/)
 
@@ -27,7 +27,7 @@ def post(req)
 end
 
 def delete(req)
-  id = req.route_params['id'].to_i
+  id = req.route_params[:id].to_i
 
   deleted = @posts.delete(id)
   raise BadRequestError, 'Failed to delete post' if deleted != 1

data/examples/gitshabbos/Dockerfile

@@ -0,0 +1,25 @@
+FROM ruby:4.0-slim AS base
+WORKDIR /syntropy
+RUN apt-get update -qq && apt-get install -y \
+    curl \
+    build-essential \
+    libpq-dev \
+    libsqlite3-dev \
+    libssl-dev \
+    libyaml-dev \
+    pkg-config && \
+    rm -rf /var/lib/apt/lists /var/cache/apt/archives
+
+ENV BUNDLE_PATH="/usr/local/bundle"
+COPY Gemfile Gemfile.lock ./
+RUN bundle install
+
+RUN groupadd --system --gid 1000 syntropy && \
+    useradd syntropy --uid 1000 --gid 1000 --create-home --shell /bin/bash
+USER 1000:1000
+
+EXPOSE 1234
+
+# Start the main process
+# CMD ["bash"]
+CMD ["bundle", "exec", "syntropy", "serve"]

data/examples/gitshabbos/Gemfile

@@ -0,0 +1,3 @@
+source 'https://gem.coop'
+
+gem 'syntropy', path: '../..'

data/examples/gitshabbos/README.md

@@ -0,0 +1,40 @@
+# My awesome Syntropy app
+
+## Installation
+
+```bash
+$ bundle install
+```
+
+## Running the web server
+
+```bash
+$ bundle exec syntropy serve
+```
+
+## Starting the app console
+
+```bash
+$ bundle exec syntropy console
+```
+
+### Running tests
+
+```bash
+$ bundle exec syntropy tests
+```
+
+### Usage with Docker Compose
+
+You can also run the app on Docker Compose:
+
+```bash
+# run the app server
+$ docker compose up
+
+# run the console
+$ docker compose run --remove-orphans console
+
+# run tests
+$ docker compose run --remove-orphans test
+```

data/examples/gitshabbos/app/[repo]/commits.rb

@@ -0,0 +1,23 @@
+layout  = import '../_layout/repo'
+repos   = import '../../_repos'
+
+template = layout.apply { |commits:, **props|
+  commits {
+    ul {
+      commits.each {
+        li it
+      }
+    }
+  }
+}
+
+export ->(req) {
+  repo = repos[req.route_params[:repo]]
+  raise Error.not_found if !repo
+
+  commits = repo.commits[0..15]
+  title = repo.name
+  repo_url = File.join('/', repo.name)
+
+  req.respond_html(template.render(title:, repo:, repo_url:, commits:))
+}

data/examples/gitshabbos/app/[repo]/index.rb

@@ -0,0 +1,32 @@
+layout  = import '../_layout/repo'
+repos   = import '../../_repos'
+
+template = layout.apply { |md:, files:, **props|
+  main {
+    markdown(md)
+  }
+  sidebar {
+    ul {
+      files.each { |r, u|
+        li { a r, href: u }
+      }
+    }
+  }
+}
+
+export ->(req) {
+  repo = repos[req.route_params[:repo]]
+  raise Error.not_found if !repo
+  
+  item = repo.get('README.md')
+  md = item ? @machine.file_read(item[:fn]).force_encoding('UTF-8') : ''
+
+  files = repo.list.each_with_object({}) { |r, h|
+    h[r[:ref]] = File.join(req.path, 'tree', r[:ref])
+  }.sort_by { |k, v| k }
+
+  title = repo.name
+  repo_url = req.path
+
+  req.respond_html(template.render(title:, repo:, repo_url:, md:, files:))
+}

data/examples/gitshabbos/app/[repo]/raw+.rb

@@ -0,0 +1,11 @@
+repos   = import '../../_repos'
+
+export ->(req) {
+  repo = repos[req.route_params[:repo]]
+  raise Error.not_found if !repo
+
+  item = repo.get(req.rel_path)
+  raise Error.not_found if !item 
+
+  req.respond(@machine.file_read(item[:fn]), 'Content-Type' => item[:mime_type])
+}

data/examples/gitshabbos/app/[repo]/tree+.rb

@@ -0,0 +1,37 @@
+layout  = import '../_layout/repo'
+repos   = import '../../_repos'
+
+template = layout.apply { |title:, item:, content:, url_raw:, **props|
+  p(class: 'single-file') { strong title }
+  p { a 'Download raw file', href: url_raw }
+
+  file_content {
+    if item[:fn] =~ /\.(png|jpe?g|gif|svg)\z/i
+      img(src: url_raw, alt: '')
+    elsif item[:binary]
+      p 'Binary file, not shown.'
+    else
+      pre {
+        code {
+          content.lines.each.each { span it, class: 'line' }
+        }
+      }
+    end
+  }
+}
+
+export ->(req) {
+  repo = repos[req.route_params[:repo]]
+  raise Error.not_found if !repo
+
+  item = repo.get(req.rel_path)
+  raise Error.not_found if !item 
+  content = @machine.file_read(item[:fn]).force_encoding('UTF-8')
+
+  title = "#{repo.name} - #{req.rel_path}"
+  url_raw = File.join('/', req.route_params[:repo], 'raw', req.rel_path)
+
+  repo_url = File.join('/', repo.name)
+
+  req.respond_html(template.render(title:, repo:, repo_url:, item:, content:, url_raw:))
+}

data/examples/gitshabbos/app/_layout/default.rb

@@ -0,0 +1,14 @@
+export template { |**props|
+  html {
+    head {
+      title "Gitshabbos - #{props[:title]}"
+      meta charset: 'utf-8'
+      meta name: 'viewport', content: 'width=device-width, initial-scale=1.0'
+      link rel: "stylesheet", type: "text/css", href: "/assets/style.css"
+    }
+    body {
+      render_children(**props)
+      auto_refresh!
+    }
+  }
+}

data/examples/gitshabbos/app/_layout/repo.rb

@@ -0,0 +1,27 @@
+default = import './default'
+
+export default.apply { |repo:, **props|
+  nav {
+    a '← index', href: '/'
+    text ' | '
+    a 'about', href: props[:repo_url]
+    text ' | '
+    a 'commits', href: File.join(props[:repo_url], 'commits')
+  }
+  if props[:header] != false
+    header {
+      h3 repo.name
+      p repo.description
+      p { code "git clone https://git.noteflakes.com/#{repo.name}/.git" }
+    }
+  end
+  content {
+    render_children(**props)
+  }
+  footer {
+    p {
+      text 'Powered by '
+      a 'Syntropy', href: 'https://github.com/digital-fabric/syntropy'
+    }
+  }
+}