raintron 0.1.0

data/templates/bin/desktop.erb

@@ -0,0 +1,22 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'raintron'
+
+# This file is deliberately thin -- all reusable logic (fork/webview lifecycle, the
+# tty/Tebako compatibility shims) lives in the raintron gem, so fixes ship via
+# `bundle update` rather than by regenerating this file. host/port are read live from
+# config/config.yaml on every run (not baked in at generation time), so they always
+# match whatever `rain server` actually uses.
+app_root = File.expand_path('..', __dir__)
+
+Raintron.launch(
+  title: '<%= app_name %>',
+  size: [<%= width %>, <%= height %>],
+  host: Raintron::AppConfig.host(app_root:),
+  port: Raintron::AppConfig.port(app_root:),
+  app_root:
+) do
+  require_relative '../config/boot'
+  Providers['low.loop'].start
+end

data/templates/github/workflows/build.yml.erb

@@ -0,0 +1,100 @@
+name: Build cross-platform executables
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+env:
+  RUBY_VERSION: "<%= ruby_version %>"
+
+jobs:
+  press:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: macos-latest
+            name: macos
+          # Not ubuntu-latest: Ubuntu 24.04 dropped the libwebkit2gtk-4.0-dev
+          # package entirely (only 4.1 dev headers ship now), and webview_ruby's
+          # own native extension Rakefile hardcodes a `pkg-config ... webkit2gtk-4.0`
+          # query -- verified directly against a real failed CI run and the gem's
+          # upstream source. 22.04 is still a supported LTS (through 2027) and still
+          # has the 4.0 package, so pin to it until webview_ruby targets 4.1.
+          - os: ubuntu-22.04
+            name: linux
+          - os: windows-latest
+            name: windows
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+
+      # webview_ruby's Windows build attempts to compile via ffi-compiler's generic
+      # MinGW path, but fails -- confirmed via a real CI run, not assumed:
+      # webview.h's Windows/Edge backend #includes winrt/Windows.Foundation.Collections.h,
+      # a C++/WinRT header the MinGW toolchain RubyInstaller for Windows ships
+      # doesn't provide (needs MSVC + the Windows SDK instead). Tebako's Windows
+      # release leg is also still "in flight" upstream, independently.
+      # Both remaining steps on this leg are best-effort so the workflow doesn't
+      # block on a combination nobody currently ships, but starts passing on its
+      # own the moment either upstream gap closes.
+
+      - name: Install Linux build prerequisites
+        if: matrix.name == 'linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y build-essential pkg-config libgtk-3-dev libwebkit2gtk-4.0-dev
+
+      - name: Install Tebako
+        if: matrix.name != 'windows'
+        shell: bash
+        run: |
+          curl -fsSL https://tebako.org/install.sh -o /tmp/tebako_install.sh
+          # Not `sh`: macOS's /bin/sh is an ancient bash (3.2) that mis-parses a
+          # multibyte character in the installer's own output strings. dash (present
+          # on macOS and Linux runners) doesn't have that bug; see install.sh's own
+          # shebang note if this ever needs revisiting.
+          dash /tmp/tebako_install.sh
+          echo "$HOME/.local/bin" >> "$GITHUB_PATH"
+
+      - name: Install Tebako (Windows, best-effort)
+        if: matrix.name == 'windows'
+        shell: bash
+        continue-on-error: true
+        run: |
+          curl -fsSL https://tebako.org/install.sh -o /tmp/tebako_install.sh
+          bash /tmp/tebako_install.sh
+          echo "$HOME/.local/bin" >> "$GITHUB_PATH"
+
+      - name: Press
+        if: matrix.name != 'windows'
+        shell: bash
+        run: |
+          mkdir -p dist
+          tebako press -r . -e bin/desktop -o "dist/<%= app_name %>-${{ matrix.name }}" -R "$RUBY_VERSION" --format dwarfs
+
+      - name: Press (Windows, best-effort)
+        if: matrix.name == 'windows'
+        shell: bash
+        continue-on-error: true
+        run: |
+          mkdir -p dist
+          tebako press -r . -e bin/desktop -o "dist/<%= app_name %>-windows.exe" -R "$RUBY_VERSION" --format dwarfs
+
+      - name: Upload artifact
+        if: matrix.name != 'windows'
+        uses: actions/upload-artifact@v4
+        with:
+          name: <%= app_name %>-${{ matrix.name }}
+          path: dist/<%= app_name %>-${{ matrix.name }}*
+          if-no-files-found: error
+
+      - name: Upload artifact (Windows, best-effort)
+        if: matrix.name == 'windows'
+        continue-on-error: true
+        uses: actions/upload-artifact@v4
+        with:
+          name: <%= app_name %>-windows
+          path: dist/<%= app_name %>-windows.exe
+          if-no-files-found: ignore

data/templates/icons/app.desktop.erb

@@ -0,0 +1,10 @@
+[Desktop Entry]
+Type=Application
+Name=<%= app_name %>
+Comment=<%= app_name %> desktop app
+# Update this to wherever the packed executable actually gets installed
+# (e.g. /usr/local/bin/<%= app_name %> or ~/.local/bin/<%= app_name %>).
+Exec=/usr/local/bin/<%= app_name %>
+Icon=/usr/local/share/icons/<%= app_name %>.png
+Terminal=false
+Categories=Utility;

metadata

@@ -0,0 +1,118 @@
+--- !ruby/object:Gem::Specification
+name: raintron
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- maedi
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: raindeer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: trees
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webview_ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: "Raintron wraps a Raindeer web app in a native desktop window (via webview_ruby)
+  and \npackages it into a single cross-platform executable (via Tebako). Add it to
+  an existing \nRaindeer app's Gemfile, run `raintron install`, and `bin/desktop`
+  opens your app in a \nwindow instead of a browser tab.\n"
+email:
+- maediprichard@gmail.com
+executables:
+- raintron
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/bump
+- bin/raintron
+- lib/app_config/app_config.rb
+- lib/cli/cli.rb
+- lib/commands/doctor.rb
+- lib/commands/icons.rb
+- lib/commands/install.rb
+- lib/commands/press.rb
+- lib/generator/generator.rb
+- lib/icons/icns_writer.rb
+- lib/icons/ico_writer.rb
+- lib/icons/icon_generator.rb
+- lib/icons/png_decoder.rb
+- lib/icons/png_writer.rb
+- lib/icons/renderer.rb
+- lib/icons/resampler.rb
+- lib/launcher/launcher.rb
+- lib/launcher/loading.html
+- lib/preflight/preflight.rb
+- lib/raintron.rb
+- lib/shims/console_shim.rb
+- lib/shims/packed_fs_shim.rb
+- lib/shims/shims.rb
+- lib/version.rb
+- lib/window_chrome/window_chrome.rb
+- templates/app/Contents/Info.plist.erb
+- templates/app/Contents/MacOS/launch.erb
+- templates/bin/desktop.erb
+- templates/github/workflows/build.yml.erb
+- templates/icons/app.desktop.erb
+homepage: https://github.com/raindeer-rb/raintron
+licenses:
+- MPL-2.0
+metadata:
+  homepage_uri: https://github.com/raindeer-rb/raintron
+  source_code_uri: https://github.com/raindeer-rb/raintron
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.6
+specification_version: 4
+summary: 'Electron for Ruby: ship a Raindeer app as a native desktop app.'
+test_files: []