reflex-packager 0.1.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f5b9334c8f2959003958be6fed84204918e8e8e30c1f7354f5e01834aeb0d985
+  data.tar.gz: d4a4efe7e3ea26f0de8958c0e1c39e9a4afa4909d6d8b72fcf46059a3b616f21
+SHA512:
+  metadata.gz: 963784c653d3af8eb62017ab139263a0ca2139cf9004f9756f6815bc8abc9ae5d7feb76a653ec8aa38b0c642f1f35e1a2fa08d6222878817a6dda0c86f3213b5
+  data.tar.gz: 2f5c2559229709a09ac563c4f709daf59b7734b97018110d2d72ce92ebb910381eb201468c747a28953b1cbbf6404e8cdc2aaa1ec1c0484a7a7bd5811695323d

data/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,12 @@
+## Pull Requests Not Accepted
+
+Thank you for your interest in contributing!
+However, this repository does not accept pull requests directly.
+
+### Where to Contribute?
+
+Please submit your changes to the [xord/all](https://github.com/xord/all) monorepo, which serves as the primary repository for all our main libraries.
+
+For more details, please refer to our [contribution guidelines](../CONTRIBUTING.md).
+
+Thanks for your understanding!

data/.github/workflows/release-gem.yml

@@ -0,0 +1,51 @@
+name: Release Gem
+
+on:
+  push:
+    tags: ['v[0-9]*']
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: macos-latest
+
+    steps:
+      - name: ruby 3.2
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.2
+
+      - name: checkout
+        uses: actions/checkout@v4
+
+      - name: setup gems
+        run: bundle install
+
+      - name: setup dependencies
+        run: "ruby -I.github/workflows -rutils -e 'setup_dependencies'"
+
+      - name: test
+        run: bundle exec rake packages test
+
+      - name: create gem
+        id: gem
+        run: |
+          bundle exec rake gem
+          echo path=$(ruby -e 'print Dir.glob("*.gem").first') >> $GITHUB_OUTPUT
+
+      - name: create github release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: ruby -I.github/workflows -rutils -e 'release(*ARGV)' ./${{ steps.gem.outputs.path }}
+
+      - name: upload to rubygems
+        env:
+          GEM_HOST_API_KEY: ${{ secrets.RUBYGEMS_AUTH_TOKEN }}
+        run: |
+          mkdir -p $HOME/.gem
+          touch $HOME/.gem/credentials
+          chmod 0600 $HOME/.gem/credentials
+          printf -- "---\n:rubygems_api_key: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
+          bundle exec rake upload

data/.github/workflows/tag.yml

@@ -0,0 +1,35 @@
+name: Tag
+
+on:
+  push:
+    branches: [master]
+
+jobs:
+  tag:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: ruby 3.2
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.2
+
+      - name: checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.PAT }}
+
+      - name: setup dependencies
+        run: "ruby -I.github/workflows -rutils -e 'setup_dependencies only: :xot'"
+
+      - name: setup user name and email
+        run: |
+          git config --global user.email "xordog@gmail.com"
+          git config --global user.name "xord"
+
+      - name: tag versions
+        run: "ruby -I.github/workflows -rutils -e 'tag_versions'"
+
+      - name: push tags
+        run: git push origin --tags

data/.github/workflows/test.yml

@@ -0,0 +1,37 @@
+name: Test
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: macos-latest
+
+    steps:
+      - name: ruby 3.2
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.2
+
+      - name: checkout
+        uses: actions/checkout@v4
+
+      - name: setup gems
+        run: bundle install
+
+      - name: setup dependencies
+        run: "ruby -I.github/workflows -rutils -e 'setup_dependencies'"
+
+      - name: packages
+        run: bundle exec rake verbose packages
+
+      - name: lib
+        run: bundle exec rake verbose lib
+
+      - name: ext
+        run: bundle exec rake verbose ext
+
+      - name: test
+        run: bundle exec rake verbose test

data/.github/workflows/utils.rb

@@ -0,0 +1,127 @@
+require 'shellwords'
+
+ALL_REPO        = 'xord/all'
+ALL_DIR         = '../all'
+ALL_FETCH_DEPTH = 100
+
+RENAMES = {reflex: 'reflexion'}
+
+def sh(cmd)
+  puts cmd
+  system cmd
+end
+
+def setup_dependencies(only: nil)
+  gemspec_path = `git ls-files`.lines(chomp: true).find {|l| l =~ /\.gemspec$/}
+  return unless gemspec_path
+
+  gemspec = File.read gemspec_path
+  name    = File.basename gemspec_path, '.gemspec'
+
+  exts = File.readlines('Rakefile')
+    .map {|l| l[%r|^\s*require\W+([\w\-\_]+)/extension\W+$|, 1]}
+    .compact
+    .reject {|ext| ext == name}
+  exts = exts & [only].flatten.map(&:to_s) if only
+  return if exts.empty?
+
+  unless setup_dependencies_via_monorepo(exts)
+    setup_dependencies_via_each_repo_by_version(gemspec, exts)
+  end
+
+  exts.each {|ext| sh %( cd ../#{ext} && rake ext )}
+end
+
+def setup_dependencies_via_monorepo(exts)
+  return false unless checkout_monorepo
+  exts.each {|ext| sh %( ln -snf all/#{ext} ../#{ext} )}
+  true
+end
+
+def checkout_monorepo()
+  uuid = `git log -1 --format=%B`[/^\[\[([0-9a-fA-F-]+)\]\]$/, 1]
+  return false unless uuid
+
+  commit = setup_monorepo uuid
+  return false unless commit
+
+  Dir.chdir(ALL_DIR) {sh %( git checkout -q #{commit} )}
+  true
+end
+
+def setup_monorepo(uuid)
+  unless File.directory? ALL_DIR
+    url = "https://github.com/#{ALL_REPO}.git"
+    sh %( git clone --no-tags --depth #{ALL_FETCH_DEPTH} #{url} #{ALL_DIR} )
+  end
+  loop do
+    commit = find_monorepo_commit uuid
+    return commit if commit
+
+    deepened = Dir.chdir ALL_DIR do
+      before = `git rev-list --count HEAD`.to_i
+      sh %( git fetch --deepen #{ALL_FETCH_DEPTH} )
+      `git rev-list --count HEAD`.to_i > before
+    end
+    return nil unless deepened
+  end
+end
+
+def find_monorepo_commit(uuid)
+  Dir.chdir ALL_DIR do
+    out = `git log origin/HEAD -F --grep="[[#{uuid}]]" --format=%H -1`.strip
+    out.empty? ? nil : out
+  end
+end
+
+def setup_dependencies_via_each_repo_by_version(gemspec, exts)
+  exts.each do |ext|
+    gem   = RENAMES[ext.to_sym].then {|s| s || ext}
+    ver   = gemspec[/add_dependency.*['"]#{gem}['"].*['"]\s*~>\s*([\d\.]+)\s*['"]/, 1]
+    opts  = '-c advice.detachedHead=false --depth 1'
+    clone = "git clone #{opts} https://github.com/xord/#{ext}.git ../#{ext}"
+
+    # 'rake subtree:push' pushes all subrepos, so cloning by new tag
+    # often fails before tagging each new tag
+    sh %( #{clone} --branch v#{ver} || #{clone} )
+  end
+end
+
+def tag_versions()
+  changes = changelogs
+  tags    = `git tag`.lines chomp: true
+  vers    = `git log --oneline ./VERSION`
+    .lines(chomp: true)
+    .map {|line| line.split.first[/^\w+$/]}
+    .map {|sha| [`git cat-file -p #{sha}:./VERSION 2>/dev/null`[/[\d\.]+/], sha]}
+    .select {|ver, sha| ver && sha}
+    .reverse
+    .to_h
+
+  vers.to_a.reverse.each do |ver, sha|
+    tag = "v#{ver}"
+    break if tags.include?(tag)
+    sh %( git tag -a -m \"#{changes[tag]&.gsub '"', '\\"'}\" #{tag} #{sha} )
+  end
+end
+
+def release(*paths)
+  tag   = ENV['GITHUB_REF']&.sub(%r|^refs/tags/|, '') || raise('GITHUB_REF tag not set')
+  notes = (changelogs[tag] || '').shellescape
+  paths = paths.flatten.join ' '
+
+  sh(%( gh release create #{tag} #{paths} --notes #{notes} )) ||
+    sh(%( gh release upload #{tag} #{paths} --clobber )) ||
+    raise('failed to upload to releases')
+end
+
+def changelogs()
+  File.read('ChangeLog.md')
+    .split(/^\s*##\s*\[\s*(v[\d\.]+)\s*\].*$/)
+    .slice(1..)
+    .each_slice(2)
+    .to_h
+    .transform_values(&:strip!)
+rescue Errno::ENOENT
+  raise 'failed to get changelogs'
+end

data/.gitignore

@@ -0,0 +1,6 @@
+*.gem
+*~
+
+.yardoc
+.DS_Store
+doc

data/CONTRIBUTING.md

@@ -0,0 +1,7 @@
+# Contribution Guide
+
+Thank you for your interest in contributing!
+However, this repository does not accept pull requests.
+Instead, please submit your changes to the [xord/all](https://github.com/xord/all) monorepo, which serves as the primary repository for all our main libraries.
+
+For any questions, feel free to open an issue.

data/ChangeLog.md

@@ -0,0 +1,16 @@
+# reflex-packager ChangeLog
+
+
+## [v0.1.2] - 2026-06-23
+
+- Add yard to Gemfile for doc generation in CI
+
+
+## [v0.1.1] - 2026-06-23
+
+- First gem release
+
+
+## [v0.1.0] - 2026-06-23
+
+- Initial release

data/Gemfile

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+
+gem 'rake'
+gem 'test-unit'
+gem 'yard'

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xord.org
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,166 @@
+# Reflex Packager - Package Reflex apps as native macOS bundles
+
+![License](https://img.shields.io/github/license/xord/reflex-packager)
+![Gem Version](https://badge.fury.io/rb/reflex-packager.svg)
+
+## :warning:  Notice
+
+This repository is a read-only mirror of our monorepo.
+We do not accept pull requests or direct contributions here.
+
+### :repeat: Where to Contribute?
+
+All development happens in our [xord/all](https://github.com/xord/all) monorepo, which contains all our main libraries.
+If you'd like to contribute, please submit your changes there.
+
+For more details, check out our [Contribution Guidelines](./CONTRIBUTING.md).
+
+## :rocket: About
+
+**Reflex Packager** is a CLI tool that packages [Reflex](https://github.com/xord/reflex) applications as native macOS `.app` bundles. It generates an Xcode project, fetches [CRuby](https://github.com/xord/cruby) and Reflex via CocoaPods, and builds a self-contained application that embeds the Ruby runtime.
+
+The packager is runtime-agnostic — each gem (Reflex, [RubySketch](https://github.com/xord/rubysketch), ...) supplies its own profile and reuses this packager as the engine.
+
+## :clipboard: Requirements
+
+- Ruby **3.0.0** or later
+- [XcodeGen](https://github.com/yonaskolb/XcodeGen) (`brew install xcodegen`)
+- [CocoaPods](https://cocoapods.org/) (`brew install cocoapods`)
+- Xcode (with command line tools)
+- The dependent gems are installed automatically: `xot`, `rucy`, `rays`, `reflexion`
+
+## :package: Installation
+
+Add this line to your Gemfile:
+```ruby
+gem 'reflex-packager'
+```
+
+Then install:
+```bash
+$ bundle install
+```
+
+Or install it directly:
+```bash
+$ gem install reflex-packager
+```
+
+## :bulb: Usage
+
+### Create a new project
+
+```bash
+$ reflex new myapp
+$ cd myapp
+$ ruby main.rb          # run the application directly
+```
+
+This generates a project directory with `main.rb` and `reflex.yml`.
+
+### Package as a macOS app
+
+```bash
+$ cd myapp
+$ reflex package .
+```
+
+The built `.app` bundle is placed in `dist/`.
+
+### CLI options
+
+```
+Usage: reflex <command> [options]
+
+Commands:
+  new NAME       create a new application project
+  package [DIR]  package the application in DIR (default: .) as an app
+
+Options:
+  -h, --help     show this message
+  --version      show version
+```
+
+Package command options:
+
+```
+reflex package [options] [DIR]
+
+  --platform PLATFORM   target platform (default: macos)
+  --config PATH         config file path (default: DIR/reflex.yml)
+  --generate-only       generate project files but do not build
+  --verbose             verbose output
+```
+
+## :gear: Configuration
+
+The project is configured via `reflex.yml` (or `reflex.yaml`) in the project directory.
+
+```yaml
+name: MyApp
+bundle_id: com.example.myapp
+version: 1.0.0
+icon: icon.png
+# main: main.rb
+# files:
+#   - "lib/**/*.rb"
+
+# macos:
+#   deployment_target: "11.0"
+#   archs: arm64
+#   codesign:
+#     identity: "-"
+#     team_id: XXXXXXXXXX
+
+# pods:
+#   cruby:
+#     path: /path/to/cruby
+#   reflex:
+#     path: /path/to/reflex
+```
+
+| Key | Default | Description |
+|-----|---------|-------------|
+| `name` | directory name | Application name |
+| `bundle_id` | `org.xord.reflex.<name>` | macOS bundle identifier |
+| `version` | `0.1.0` | Application version |
+| `main` | `main.rb` | Entry point script |
+| `icon` | none | Path to an icon image (PNG) |
+| `files` | none | Additional files to bundle (glob patterns) |
+| `macos.deployment_target` | `11.0` | Minimum macOS version |
+| `macos.archs` | `arm64` | Target architectures |
+| `macos.codesign.identity` | `-` | Code signing identity |
+| `macos.codesign.team_id` | none | Development team ID |
+
+### Pod overrides
+
+By default the packager fetches CRuby and Reflex pods from their git repositories. To use local checkouts instead, set paths in the config or via the `REFLEX_PODS_PATH` environment variable:
+
+```bash
+$ export REFLEX_PODS_PATH=/path/to/pods
+$ reflex package .
+```
+
+## :wrench: How it works
+
+1. Copies application files into a build directory
+2. Generates an Xcode project (via XcodeGen) and a Podfile
+3. Runs `pod install` to fetch CRuby and Reflex pods
+4. Builds the `.app` bundle with `xcodebuild`
+5. Copies the result to `dist/`
+
+The generated native wrapper embeds CRuby, registers the Reflex extensions, and runs the application's `main.rb` at launch.
+
+## :hammer_and_wrench: Development
+
+```bash
+$ rake test         # run the test suite
+$ rake              # default task
+```
+
+In the [`xord/all`](https://github.com/xord/all) monorepo you can scope by module.
+
+## :scroll: License
+
+**Reflex Packager** is licensed under the MIT License.
+See the [LICENSE](./LICENSE) file for details.

data/Rakefile

@@ -0,0 +1,25 @@
+# -*- mode: ruby -*-
+
+%w[../xot ../rucy ../rays ../reflex .]
+  .map  {|s| File.expand_path "#{s}/lib", __dir__}
+  .each {|s| $:.unshift s if !$:.include?(s) && File.directory?(s)}
+
+require 'rake/testtask'
+require 'rucy/rake'
+
+require 'xot/extension'
+require 'rucy/extension'
+require 'rays/extension'
+require 'reflex/extension'
+require 'reflex/packager/extension'
+
+
+EXTENSIONS = [Xot, Rucy, Rays, Reflex, Reflex::Packager]
+
+ENV['RDOC'] = 'yardoc --no-private'
+
+default_tasks
+use_bundler
+test_ruby_extension
+generate_documents
+build_ruby_gem

data/VERSION

@@ -0,0 +1 @@
+0.1.2

data/bin/reflex

@@ -0,0 +1,22 @@
+#!/usr/bin/env ruby
+
+require 'reflex/extension'
+require 'reflex/packager'
+
+
+profile = Reflex::Packager::Profile.new(
+  pod:          'Reflex',
+  git:          'https://github.com/xord/reflex',
+  version:      Reflex::Extension.version,
+  libraries:    %w[Xot Rucy Rays Reflex],
+  extensions:   %w[rays_ext reflex_ext],
+  config_files: %w[reflex.yml reflex.yaml],
+  template:     <<~RUBY)
+    require 'reflex'
+
+    Reflex.start do
+      Reflex::Window.new(title: '{{name}}', frame: [100, 100, 400, 300]).show
+    end
+  RUBY
+
+Reflex::Packager::CLI.new(profile).run ARGV.dup

data/lib/reflex/packager/cli.rb

@@ -0,0 +1,114 @@
+require 'optparse'
+require 'fileutils'
+require 'xot/block_util'
+
+
+module Reflex
+
+
+  module Packager
+
+
+    # Command line interface for a packager executable. Instantiated with the
+    # runtime profile to package for (Reflex by default).
+    #
+    class CLI
+
+      def initialize(profile)
+        @profile = profile
+      end
+
+      def run(argv)
+        argv   = argv.dup
+        parser = OptionParser.new do |o|
+          o.on('--version')    {puts @profile.version; return}
+          o.on('-h', '--help') {puts usage;            return}
+        end
+        parser.order! argv
+
+        case command = argv.shift
+        when 'new'     then create  argv
+        when 'package' then package argv
+        when nil       then puts usage
+        else
+          $stderr.puts "unknown command: '#{command}'", '', usage
+          exit 1
+        end
+      rescue OptionParser::ParseError, Error => e
+        $stderr.puts "Error: #{e.message}"
+        exit 1
+      end
+
+      def create(argv)
+        argv, = parse argv, "Usage: #{@profile.pod_key} new NAME"
+
+        name = argv.shift
+        raise Error, 'project name required' unless name
+        raise Error, "'#{name}' already exists" if File.exist? name
+
+        FileUtils.mkdir_p name
+        File.write File.join(name, 'main.rb'),
+          @profile.template.gsub('{{name}}') {name}
+        File.write File.join(name, @profile.config_files.first), <<~END
+          name: #{name}
+          #bundle_id: com.example.#{name.downcase.gsub(/[^a-z0-9]+/, '')}
+          #version: 1.0.0
+          #icon: icon.png
+        END
+        puts "Created #{name}/"
+        puts "  cd #{name} && ruby main.rb                 # run the application"
+        puts "  cd #{name} && #{@profile.pod_key} package .   # package as an application"
+      end
+
+      def package(argv)
+        profile = @profile # capture for the instance_eval'd parse block below
+        argv, params = parse argv, "Usage: #{profile.pod_key} package [options] [DIR]" do
+          on '--platform PLATFORM', 'target platform (default: macos)'
+          on '--config PATH',
+            "config file path (default: DIR/#{profile.config_files.first})"
+          on '--generate-only', 'generate project files but do not build'
+          on '--verbose',       'verbose output'
+        end
+
+        dir      = argv.shift || '.'
+        platform = (params[:platform] || 'macos').to_sym
+        klass    = PLATFORMS[platform]
+        raise Error, "unknown platform: '#{platform}'" unless klass
+
+        config = Config.load @profile, dir, params[:config]
+        klass.new(config, verbose: params[:verbose])
+          .package generate_only: params[:'generate-only']
+      end
+
+      private
+
+      def usage()
+        <<~END
+          Usage: #{@profile.pod_key} <command> [options]
+
+          Commands:
+            new NAME       create a new application project
+            package [DIR]  package the application in DIR (default: .) as an app
+
+          Options:
+            -h, --help     show this message
+            --version      show version
+        END
+      end
+
+      def parse(argv, banner = nil, &block)
+        opt        = OptionParser.new
+        opt.banner = banner if banner
+        Xot::BlockUtil.instance_eval_or_block_call opt, &block if block
+        params     = {}
+        argv       = opt.parse argv.dup, into: params
+        return argv, params
+      end
+
+    end# CLI
+
+
+  end# Packager
+
+
+end# Reflex