reflex-packager 0.1.5 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e5a41cc121e4bdb9a3d4437663fa3700cdf9e079b5e26de80bec5c45bbd3f60
-  data.tar.gz: ee3536084179c5e6ad5427eaebd8b46a39a90f95b7367d78b45d92e9ca18ae41
+  metadata.gz: 10cd5f3004ed2ad53e97c3192fdd570c278a55fffec18e95362a9ba103d73157
+  data.tar.gz: 5a944112ad9c122f14273acc46f871c866499f81ee9bbac9fc77a08cc23ab2c2
 SHA512:
-  metadata.gz: 9795746fb85982c571b0969e85bd3512ba8e5bab592de62dcde40c0ef32742974cb587e5501f834e915398f3f3962e07eb560f998b8320dcac2ca6fa8592bf05
-  data.tar.gz: 570c220c7785456a496c941afe16f9c0d0723d9bfbecc98ee18f5fa8ea71569834209261f592c10e30f51ce95eabc3c8bf204d3de480204c423fbdf2e79716d0
+  metadata.gz: 40515957ed04d11936455f04f6256c37bca7f92d999d72b2e7d39d7e60c3bc5aff26d90be6ce5e5693c33274a1dc28bbcded01ea2684ee957dcbe258e1bac0d4
+  data.tar.gz: 45ed0fa02849953d1efee9e9d4f4da15fc1d270b753dcff949d6ebc89d6c84c4621b62d3f535df034627d7fedf8d31f23c2aeb960ed6d60461a3a4da8aa79430

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

@@ -26,8 +26,17 @@ jobs:
       - name: setup dependencies
         run: "ruby -I.github/workflows -rutils -e 'setup_dependencies'"
 
+      - name: packages
+        run: bundle exec rake packages
+
+      - name: setup zig
+        if: github.event.repository.name == 'reflex-terminal'
+        uses: mlugg/setup-zig@v2
+        with:
+          version: 0.16.0
+
       - name: test
-        run: bundle exec rake packages test
+        run: bundle exec rake test
 
       - name: create gem
         id: gem

data/.github/workflows/test.yml

@@ -27,6 +27,15 @@ jobs:
       - name: packages
         run: bundle exec rake verbose packages
 
+      - name: setup zig
+        if: github.event.repository.name == 'reflex-terminal'
+        uses: mlugg/setup-zig@v2
+        with:
+          version: 0.16.0
+
+      - name: vendor
+        run: bundle exec rake vendor
+
       - name: lib
         run: bundle exec rake verbose lib
 

data/ChangeLog.md

@@ -1,6 +1,13 @@
 # reflex-packager ChangeLog
 
 
+## [v0.2.0] - 2026-08-04
+
+- [BREAKING] Replace Profile#template with a templates Hash
+- Add boot script support to Profile
+- Add command field to Profile for the CLI display name
+
+
 ## [v0.1.5] - 2026-06-23
 
 - Update dependencies

data/VERSION

@@ -1 +1 @@
-0.1.5
+0.2.0

data/bin/reflex

@@ -11,12 +11,27 @@ profile = Reflex::Packager::Profile.new(
   libraries:    %w[Xot Rucy Rays Reflex],
   extensions:   %w[rays_ext reflex_ext],
   config_files: %w[reflex.yml reflex.yaml],
-  template:     <<~RUBY)
+  templates:    {'main.rb': <<~MAIN, 'reflex.yml': <<~CONFIG})
     require 'reflex'
 
-    Reflex.start do
-      Reflex::Window.new(title: '{{name}}', frame: [100, 100, 400, 300]).show
+    view = Reflex::View.new
+    def view.on_draw(e)
+      e.painter.font nil, 48
+      e.painter.text 'hello, world!', 100, 100
     end
-  RUBY
+
+    win = Reflex::Window.new
+    win.title = '{{name}}'
+    win.frame = [100, 100, 400, 300]
+    win.add view
+    win.show
+
+    Reflex.start
+  MAIN
+    name: {{name}}
+    version: 1.0.0
+    #bundle_id: org.xord.reflex.example.{{name_id}}
+    #icon: icon.png
+  CONFIG
 
 Reflex::Packager::CLI.new(profile).run ARGV.dup

data/lib/reflex/packager/cli.rb

@@ -40,42 +40,39 @@ module Reflex
       end
 
       def create(argv)
-        argv, = parse argv, "Usage: #{@profile.pod_key} new NAME"
+        argv, = parse argv, "Usage: #{@profile.command} 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
+        @profile.templates.each do |path, content|
+          File.write File.join(name, path.to_s), gsub_template(content, name)
+        end
+
         puts "Created #{name}/"
-        puts "  cd #{name} && ruby main.rb                 # run the application"
-        puts "  cd #{name} && #{@profile.pod_key} package .   # package as an application"
+        hints = [
+          ["cd #{name} && ruby #{@profile.templates.keys.first}", "run the application"],
+          ["cd #{name} && #{@profile.command} package .",         "package as an application"]
+        ]
+        max = hints.map {|cmd,| cmd.length}.max
+        hints.each {|cmd, desc| puts "  #{cmd.ljust max}  # #{desc}"}
       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
+        profile      = @profile
+        argv, params = parse argv, "Usage: #{profile.command} 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'
+          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    = PLATFORMS[platform] || raise(Error, "unknown platform: '#{platform}'")
+        config   = Config.load profile, dir, params[:config]
         klass.new(config, verbose: params[:verbose])
           .package generate_only: params[:'generate-only']
       end
@@ -84,7 +81,7 @@ module Reflex
 
       def usage()
         <<~END
-          Usage: #{@profile.pod_key} <command> [options]
+          Usage: #{@profile.command} <command> [options]
 
           Commands:
             new NAME       create a new application project
@@ -105,6 +102,16 @@ module Reflex
         return argv, params
       end
 
+      def gsub_template(str, name)
+        {
+          name:    name,
+          name_id: Config.name2id(name)
+        }.each do |from, to|
+          str = str.gsub "{{#{from}}}", to
+        end
+        str
+      end
+
     end# CLI
 
 

data/lib/reflex/packager/config.rb

@@ -21,7 +21,7 @@ module Reflex
           name:      name,
           bundle_id: hash[:bundle_id] || default_bundle_id(profile, name),
           version:   '0.1.0',
-          main:      'main.rb',
+          main:      profile.main,
           icon:      nil,
           files:     nil,
           pods: {
@@ -88,8 +88,12 @@ module Reflex
 
       private
 
+      def self.name2id(name)
+        name.downcase.gsub(/[^a-z0-9\-]+/, '')
+      end
+
       def self.default_bundle_id(profile, name)
-        id = name.downcase.gsub(/[^a-z0-9\-]+/, '')
+        id = name2id name
         if id.empty?
           raise Error, "cannot derive a bundle_id from name '#{name}', " +
             "set 'bundle_id' in #{profile.config_files.first}"

data/lib/reflex/packager/macos.rb

@@ -130,6 +130,8 @@ module Reflex
           FileUtils.mkdir_p File.dirname(dest)
           FileUtils.cp_r File.join(config.dir, file), dest
         end
+        File.write File.join(dir, profile.boot_main), profile.boot if
+          profile.boot_main && profile.boot
       end
 
       def generate_icon()

data/lib/reflex/packager/profile.rb

@@ -13,20 +13,45 @@ module Reflex
     #
     class Profile
 
-      # @param [String]        pod          umbrella pod name (e.g. 'Reflex')
-      # @param [String]        git          umbrella pod git repository
-      # @param [String]        version      umbrella pod version (for the tag)
-      # @param [Array<String>] libraries    ruby lib bundles to add to load path
-      # @param [Array<String>] extensions   native exts to register (Init_<name>)
-      # @param [Array<String>] config_files config file names, preferred first
-      # @param [String]        template     'new' main script template ({{name}})
+      # @param [String]               pod          umbrella pod name (e.g. 'Reflex')
+      # @param [String]               git          umbrella pod git repository
+      # @param [String]               version      umbrella pod version (for the tag)
+      # @param [Array<String>]        libraries    ruby lib bundles to add to load path
+      # @param [Array<String>]        extensions   native exts to register (Init_<name>)
+      # @param [Array<String>]        config_files config file names, preferred first
+      # @param [Hash{String=>String}] templates    'new' scaffold files ({filename => content})
+      # @param [String, nil]          command      CLI command name (default: pod_key)
+      # @param [String, nil]          boot         boot script overrides config main (default: nil)
       #
-      def initialize(pod:, git:, version:, libraries:, extensions:, config_files:, template:)
-        @pod, @git, @version, @libraries, @extensions, @config_files, @template =
-          pod, git, version, libraries, extensions, config_files, template
+      def initialize(
+        pod:, git:, version:, libraries:, extensions:, config_files:, templates:,
+        command: nil, boot: nil)
+
+        @pod          = pod
+        @git          = git
+        @version      = version
+        @libraries    = libraries
+        @extensions   = extensions
+        @config_files = config_files
+        @templates    = templates
+        @command      = command
+        @boot         = boot
+      end
+
+      attr_reader :pod, :git, :version, :libraries, :extensions, :config_files,
+        :templates, :boot
+
+      def command()
+        @command || pod_key
       end
 
-      attr_reader :pod, :git, :version, :libraries, :extensions, :config_files, :template
+      def main()
+        templates.keys.first
+      end
+
+      def boot_main()
+        @boot ? '__reflex_main__.rb' : nil
+      end
 
       def pod_key()
         pod.downcase.to_sym

data/lib/reflex/packager/templates/macos/main.mm.erb

@@ -16,28 +16,18 @@ main (int argc, const char* argv[])
 {
 	@autoreleasepool
 	{
-		NSString* appDir =
-			[NSBundle.mainBundle.resourcePath stringByAppendingPathComponent:@"app"];
-
-		// the application loads images by paths relative to the script
+		NSString* appDir = [NSBundle.mainBundle.resourcePath stringByAppendingPathComponent:@"app"];
 		[NSFileManager.defaultManager changeCurrentDirectoryPath:appDir];
 
 <%- extensions.each do |ext| -%>
 		[CRuby addExtension:@"<%= ext %>" init:^{Init_<%= ext %>();}];
 <%- end -%>
 
-		for (NSString* lib in @[<%= libraries.map {|l| "@\"#{l}\""}.join ', ' %>])
+		for (NSString* lib in @[<%= libraries.map {"@\"#{_1}\""}.join ', ' %>])
 			[CRuby addLibrary:lib bundle:NSBundle.mainBundle];
 
-		NSString* main = [appDir stringByAppendingPathComponent:@"<%= config.main %>"];
-
-		// add the script directory to the load path so that apps split
-		// into multiple files can require each other
 		[CRuby evaluate:[NSString stringWithFormat:@"$LOAD_PATH.unshift '%@'", appDir]];
-
-		// the script calls Reflex.start, which runs [NSApp run] and blocks
-		// here until the application quits
-		[CRuby start:main];
+		[CRuby start:[appDir stringByAppendingPathComponent:@"<%= profile.boot_main || config.main %>"]];
 	}
 	return 0;
 }

data/reflex-packager.gemspec

@@ -25,10 +25,10 @@ Gem::Specification.new do |s|
   s.platform              = Gem::Platform::RUBY
   s.required_ruby_version = '>= 3.0.0'
 
-  s.add_dependency 'xot',       '~> 0.3.15'
-  s.add_dependency 'rucy',      '~> 0.3.15'
-  s.add_dependency 'rays',      '~> 0.3.16'
-  s.add_dependency 'reflexion', '~> 0.5.3'
+  s.add_dependency 'xot',       '~> 0.4.0'
+  s.add_dependency 'rucy',      '~> 0.4.0'
+  s.add_dependency 'rays',      '~> 0.4.0'
+  s.add_dependency 'reflexion', '~> 0.6.0'
 
   s.files            = `git ls-files`.split $/
   s.executables      = s.files.grep(%r{^bin/}) {|f| File.basename f}

data/test/helper.rb

@@ -19,10 +19,12 @@ TEST_PROFILE = Reflex::Packager::Profile.new(
   libraries:    %w[Xot Rucy Rays Reflex],
   extensions:   %w[rays_ext reflex_ext],
   config_files: %w[reflex.yml reflex.yaml],
-  template:     <<~RUBY)
+  templates:    {'main.rb': <<~MAIN, 'reflex.yml': <<~CONFIG})
     require 'reflex'
 
     Reflex.start do
       Reflex::Window.new(title: '{{name}}', frame: [100, 100, 400, 300]).show
     end
-  RUBY
+  MAIN
+    name: myapp
+  CONFIG

data/test/test_packager_cli.rb

@@ -40,8 +40,8 @@ class TestPackagerCLI < Test::Unit::TestCase
   def test_new()
     tmpdir do
       capture {cli.create ['myapp']}
-      assert File.file?('myapp/main.rb')
-      assert File.file?('myapp/reflex.yml')
+      assert_true File.file?('myapp/main.rb')
+      assert_true File.file?('myapp/reflex.yml')
 
       main = File.read('myapp/main.rb')
       assert_include main, "require 'reflex'"

data/test/test_packager_macos.rb

@@ -160,13 +160,12 @@ class TestPackagerMacOS < Test::Unit::TestCase
     packager "main: app.rb", files: %w[app.rb] do |pkg, dir|
       pkg.generate
       str = read dir, 'src/main.mm'
-      assert_include str, '@"app.rb"'                  # the entry script
+      assert_include str, '@"app"'                     # the bundled app dir
       assert_include str, 'Init_reflex_ext'            # native ext registered
       assert_include str, 'Init_rays_ext'
       assert_include str, '@"Reflex"'                  # library bundle added
       assert_include str, 'changeCurrentDirectoryPath' # cwd set to app dir
-      assert_include str, '@"app"'                     # the bundled app dir
-      assert_include str, '[CRuby start:main]'
+      assert_include str, '@"app.rb"'                  # the entry script
     end
   end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: reflex-packager
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.2.0
 platform: ruby
 authors:
 - xordog
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-23 00:00:00.000000000 Z
+date: 2026-08-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: xot
@@ -16,56 +16,56 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.15
+        version: 0.4.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.15
+        version: 0.4.0
 - !ruby/object:Gem::Dependency
   name: rucy
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.15
+        version: 0.4.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.15
+        version: 0.4.0
 - !ruby/object:Gem::Dependency
   name: rays
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.16
+        version: 0.4.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.16
+        version: 0.4.0
 - !ruby/object:Gem::Dependency
   name: reflexion
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.5.3
+        version: 0.6.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.5.3
+        version: 0.6.0
 description: CLI tool to package Reflex applications as native macOS application bundles.
 email: xordog@gmail.com
 executables: