rbe-tebako 0.15.0

data/lib/tebako/cli.rb

@@ -0,0 +1,220 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Copyright (c) 2021-2025 [Ribose Inc](https://www.ribose.com).
+# All rights reserved.
+# This file is a part of the Tebako project.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+# 1. Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright
+#    notice, this list of conditions and the following disclaimer in the
+#    documentation and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS
+# BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+require "digest"
+require "fileutils"
+require "find"
+require "pathname"
+require "open3"
+require "thor"
+require "yaml"
+
+require_relative "cache_manager"
+require_relative "cli_helpers"
+require_relative "error"
+require_relative "ruby_version"
+require_relative "scenario_manager"
+require_relative "version"
+
+# Tebako - an executable packager
+# Implementation of tebako command-line interface
+module Tebako
+  DEFAULT_TEBAFILE = ".tebako.yml"
+  # Tebako packager front-end
+  class Cli < Thor # rubocop:disable Metrics/ClassLength
+    package_name "Tebako"
+    class_option :prefix, type: :string, aliases: "-p", required: false,
+                          desc: "A path to tebako packaging environment, '~/.tebako' ('$HOME/.tebako') by default"
+    class_option :devmode, type: :boolean, aliases: "-D",
+                           desc: "Developer mode, please do not use if unsure"
+    class_option :tebafile, type: :string, aliases: "-t", required: false,
+                            desc: "tebako configuration file 'tebafile', '$PWD/.tebako.yml' by default"
+    desc "clean", "Clean tebako packaging environment"
+    def clean
+      (om, cm) = bootstrap(clean: true)
+      cm.clean_cache
+      extra_win_clean([om.deps])
+    end
+
+    desc "clean_ruby", "Clean Ruby source from tebako packaging environment"
+    method_option :Ruby, type: :string, aliases: "-R", required: false,
+                         enum: Tebako::RubyVersion::RUBY_VERSIONS.keys,
+                         desc: "Ruby version to clean, all available versions by default"
+    def clean_ruby
+      puts "Cleaning Ruby sources from tebako packaging environment"
+      (om,) = bootstrap(clean: true)
+
+      suffix = options["Ruby"].nil? ? "" : "_#{options["Ruby"]}"
+      nmr = Dir.glob(File.join(om.deps, "src", "_ruby#{suffix}*"))
+      nms = Dir.glob(File.join(om.deps, "stash#{suffix}*"))
+
+      FileUtils.rm_rf(nmr + nms, secure: true)
+      extra_win_clean(nmr)
+    end
+
+    desc "hash", "Print build script hash (ci cache key)"
+    def hash
+      print Digest::SHA256.hexdigest [File.read(File.join(source, "CMakeLists.txt")), Tebako::VERSION].join
+    end
+
+    CWD_DESCRIPTION = <<~DESC
+      Current working directory for packaged application. This directory shall be specified relative to root.
+      #{" " * 65}# If this parameter is not set, the application will start in the current directory of the host file system.
+    DESC
+
+    REF_DESCRIPTION = <<~DESC
+      "Referenced tebako run-time package; 'tebako-runtime' by default".
+      #{" " * 65}# This option specifies the tebako runtime to be used by the application on Windows and if mode is 'application' only .
+    DESC
+
+    RGP_DESCRIPTION = <<~DESC
+      Current working directory for packaged application. This directory shall be specified relative to root.
+      #{" " * 65}# If this parameter is not set, the application will start in the current directory of the host file system.
+    DESC
+
+    desc "press", "Press tebako image"
+    method_option :cwd, type: :string, aliases: "-c", required: false, desc: CWD_DESCRIPTION
+    method_option :"log-level", type: :string, aliases: "-l", required: false, enum: %w[error warn debug trace],
+                                desc: "Tebako memfs logging level, 'error' by default"
+    method_option :output, type: :string, aliases: "-o", required: false,
+                           desc: "Tebako package file name, entry point base file name in the current folder by default"
+    method_option :"entry-point", type: :string, aliases: ["-e", "--entry"], required: false,
+                                  desc: "Ruby application entry point"
+    method_option :root, type: :string, aliases: "-r", required: false, desc: "Root folder of the Ruby application"
+    method_option :Ruby, type: :string, aliases: "-R", required: false,
+                         enum: Tebako::RubyVersion::RUBY_VERSIONS.keys,
+                         desc: "Tebako package Ruby version, #{Tebako::RubyVersion::DEFAULT_RUBY_VERSION} by default"
+    method_option :patchelf, aliases: "-P", type: :boolean, desc: RGP_DESCRIPTION
+    method_option :mode, type: :string, aliases: "-m", required: false, enum: %w[bundle both runtime application],
+                         desc: "Tebako press mode, 'bundle' by default"
+    method_option :ref, type: :string, aliases: "-u", required: false, desc: REF_DESCRIPTION
+
+    def press
+      validate_press_options
+      (om, cm) = bootstrap
+
+      do_press(om)
+      cm.ensure_version_file
+    rescue Tebako::Error => e
+      puts "Tebako script failed: #{e.message} [#{e.error_code}]"
+      exit e.error_code
+    end
+
+    desc "setup", "Set up tebako packaging environment"
+    method_option :Ruby, type: :string, aliases: "-R", required: false,
+                         enum: Tebako::RubyVersion::RUBY_VERSIONS.keys,
+                         desc: "Tebako package Ruby version, #{Tebako::RubyVersion::DEFAULT_RUBY_VERSION} by default."
+    def setup
+      (om, cm) = bootstrap
+
+      do_setup(om)
+      cm.ensure_version_file
+    rescue Tebako::Error => e
+      puts "Tebako script failed: #{e.message} [#{e.error_code}]"
+      exit e.error_code
+    end
+
+    def self.exit_on_failure?
+      true
+    end
+
+    no_commands do
+      def bootstrap(clean: false)
+        options_manager = Tebako::OptionsManager.new(options)
+        cache_manager = Tebako::CacheManager.new(options_manager.deps, options_manager.source,
+                                                 options_manager.output_folder)
+        cache_manager.version_cache_check unless options[:devmode] || clean
+        [options_manager, cache_manager]
+      end
+
+      # Ruby extension maker sometimes creates files with 'NUL' name on Windows
+      # This method removes such files
+      def extra_win_clean(nmr)
+        return unless nmr.any? && ScenarioManagerBase.new.msys?
+
+        nmr.each do |path|
+          next unless File.directory?(path)
+
+          extra_win_clean_dir(path)
+        end
+
+        FileUtils.rm_rf(nmr, secure: true)
+      end
+
+      def extra_win_clean_dir(path)
+        Find.find(path) do |file_path|
+          full_path = "//?/#{file_path}"
+          next unless File.file?(full_path) && File.basename(full_path) == "NUL"
+
+          FileUtils.rm_f(full_path)
+        end
+      end
+    end
+
+    no_commands do
+      def initialize(*args)
+        super
+        return if args[2][:current_command].name.include?("hash")
+
+        puts "Tebako executable packager version #{Tebako::VERSION}"
+      end
+
+      def options
+        original_options = super
+        tebafile = original_options["tebafile"].nil? ? DEFAULT_TEBAFILE : original_options["tebafile"]
+        if File.exist?(tebafile)
+          Thor::CoreExt::HashWithIndifferentAccess.new(options_from_tebafile(tebafile).merge(original_options))
+        else
+          puts "Warning: Tebako configuration file '#{tebafile}' not found." unless original_options["tebafile"].nil?
+          original_options
+        end
+      end
+
+      def source
+        c_path = Pathname.new(__FILE__).realpath
+        @source ||= File.expand_path("../../..", c_path)
+      end
+    end
+
+    no_commands do
+      def validate_press_options
+        return unless options["mode"] != "runtime"
+
+        opts = ""
+        opts += " '--root'" if options["root"].nil?
+        if options["entry-point"].nil?
+          opts += ", " unless opts.empty?
+          opts += " '--entry-point'"
+        end
+        raise Thor::Error, "No value provided for required options #{opts}" unless opts.empty?
+      end
+
+      include Tebako::CliHelpers
+    end
+  end
+end

data/lib/tebako/cli_helpers.rb

@@ -0,0 +1,165 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2023-2025 [Ribose Inc](https://www.ribose.com).
+# All rights reserved.
+# This file is a part of the Tebako project.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+# 1. Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright
+#    notice, this list of conditions and the following disclaimer in the
+#    documentation and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS
+# BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+require "etc"
+require "fileutils"
+require "pathname"
+require "rbconfig"
+
+require_relative "codegen"
+require_relative "error"
+require_relative "options_manager"
+require_relative "scenario_manager"
+require_relative "packager_lite"
+
+# Tebako - an executable packager
+# Command-line interface methods
+module Tebako
+  # Cli helpers
+  module CliHelpers
+    WARN = <<~WARN
+
+      ******************************************************************************************************************
+      *                                                                                                                *
+      *  WARNING: You are packaging in-place, i.e.: tebako package will be placed inside application root.             *
+      *  It is not an error but we do not recommend it because it is a way to keep packaging old versions recrsively.  *
+      *                                                                                                                *
+      *  For example, ensure that `--root=` differs from `--output=` as described in README.adoc:                      *
+      *  tebako press --root='~/projects/myproject' --entry=start.rb --output=/temp/myproject.tebako                   *
+      *                                                                                                                *
+      ******************************************************************************************************************
+
+    WARN
+
+    WARN2 = <<~WARN
+
+      ******************************************************************************************************************
+      *                                                                                                                *
+      *  WARNING: You are creating packaging environment inside application root.                                      *
+      *  It is not an error but it means that all build-time artifacts will ne included in tebako package.             *
+      *  You do not need it unless under very special circumstances like tebako packaging tebako itself.               *
+      *                                                                                                                *
+      *  Please consider removing your exisitng `--prefix` folder abd use another one that points outside of `--root`  *
+      *  like tebako press --r ~/projects/myproject -e start.rb -o /temp/myproject.tebako -p ~/.tebako                 *
+      *                                                                                                                *
+      ******************************************************************************************************************
+
+    WARN
+
+    def check_warnings(options_manager)
+      return unless options_manager.mode != "runtime"
+
+      puts WARN if options_manager.package_within_root?
+      puts WARN2 if options_manager.prefix_within_root?
+      sleep 5
+    end
+
+    def do_press(options_manager)
+      scenario_manager = Tebako::ScenarioManager.new(options_manager.root, options_manager.fs_entrance)
+      scenario_manager.configure_scenario
+      options_manager.process_gemfile(scenario_manager.gemfile_path) if scenario_manager.with_gemfile
+      check_warnings(options_manager)
+      puts options_manager.press_announce(scenario_manager.msys?)
+
+      do_press_runtime(options_manager, scenario_manager)
+      do_press_application(options_manager, scenario_manager)
+    end
+
+    def do_press_application(options_manager, scenario_manager)
+      return unless %w[both application].include?(options_manager.mode)
+
+      packager = Tebako::PackagerLite.new(options_manager, scenario_manager)
+      packager.create_package
+    end
+
+    def do_press_runtime(options_manager, scenario_manager)
+      return unless %w[both runtime bundle].include?(options_manager.mode)
+
+      generate_files(options_manager, scenario_manager)
+      merged_env = ENV.to_h.merge(scenario_manager.b_env)
+      Tebako.packaging_error(103) unless system(merged_env, press_cfg_cmd(options_manager))
+      Tebako.packaging_error(104) unless system(merged_env, press_build_cmd(options_manager))
+      finalize(options_manager, scenario_manager)
+    end
+
+    def do_setup(options_manager)
+      puts "Setting up tebako packaging environment"
+
+      merged_env = ENV.to_h.merge(Tebako::ScenarioManagerBase.new.b_env)
+      Tebako.packaging_error(101) unless system(merged_env, setup_cfg_cmd(options_manager))
+      Tebako.packaging_error(102) unless system(merged_env, setup_build_cmd(options_manager))
+    end
+
+    def generate_files(options_manager, scenario_manager)
+      puts "-- Generating files"
+
+      v_parts = Tebako::VERSION.split(".")
+      Tebako::Codegen.generate_tebako_version_h(options_manager, v_parts)
+      Tebako::Codegen.generate_tebako_fs_cpp(options_manager, scenario_manager)
+      Tebako::Codegen.generate_deploy_rb(options_manager, scenario_manager)
+
+      return unless %w[both runtime].include?(options_manager.mode)
+
+      Tebako::Codegen.generate_stub_rb(options_manager)
+    end
+
+    def finalize(options_manager, scenario_manager)
+      use_patchelf = options_manager.patchelf? && scenario_manager.linux_gnu?
+      patchelf = use_patchelf ? "#{options_manager.deps_bin_dir}/patchelf" : nil
+      Tebako::Packager.finalize(options_manager.ruby_src_dir, options_manager.package,
+                                options_manager.rv, patchelf, options_manager.output_type_first)
+    end
+
+    def options_from_tebafile(tebafile)
+      ::YAML.load_file(tebafile)["options"] || {}
+    rescue Psych::SyntaxError => e
+      puts "Warning: The tebafile '#{tebafile}' contains invalid YAML syntax."
+      puts e.message
+      {}
+    rescue StandardError => e
+      puts "An unexpected error occurred while loading the tebafile '#{tebafile}'."
+      puts e.message
+      {}
+    end
+
+    def press_build_cmd(options_manager)
+      "cmake --build #{options_manager.output_folder} --target tebako --parallel #{Etc.nprocessors}"
+    end
+
+    def press_cfg_cmd(options_manager)
+      "cmake -DSETUP_MODE:BOOLEAN=OFF #{options_manager.cfg_options} #{options_manager.press_options}"
+    end
+
+    def setup_build_cmd(options_manager)
+      "cmake --build \"#{options_manager.output_folder}\" --target setup --parallel #{Etc.nprocessors}"
+    end
+
+    def setup_cfg_cmd(options_manager)
+      "cmake -DSETUP_MODE:BOOLEAN=ON #{options_manager.cfg_options}"
+    end
+  end
+end

data/lib/tebako/codegen.rb

@@ -0,0 +1,252 @@
+# frozen_string_literal: true
+
+# Copyright (c)  2024-2025 [Ribose Inc](https://www.ribose.com).
+# All rights reserved.
+# This file is a part of the Tebako project.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+# 1. Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright
+#    notice, this list of conditions and the following disclaimer in the
+#    documentation and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS
+# BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+require "pathname"
+require "fileutils"
+
+require_relative "package_descriptor"
+
+# Tebako - an executable packager
+module Tebako
+  # Code geberation
+  module Codegen
+    COMMON_C_HEADER = <<~SUBST
+      /**
+      * THIS FILE WAS GENERATED AUTOMATICALLY BY TEBAKO. DO NOT CHANGE IT, PLEASE
+      **/
+
+    SUBST
+
+    COMMON_RUBY_HEADER = <<~SUBST
+      #!/usr/bin/env ruby
+      # frozen_string_literal: true
+
+      # THIS FILE WAS GENERATED AUTOMATICALLY BY TEBAKO. DO NOT CHANGE IT, PLEASE
+
+    SUBST
+
+    class << self # rubocop:disable Metrics/ClassLength
+      def deploy_crt_implib(opt, scm)
+        crt = ""
+        if scm.msys?
+          crt = <<~SUBST
+            Tebako::Packager.create_implib("#{opt.ruby_src_dir}", "#{opt.data_src_dir}",
+                                           "#{opt.package}", rv)
+          SUBST
+        end
+        crt
+      end
+
+      def deploy_mk(opt, scm)
+        case opt.mode
+        when "bundle"
+          deploy_mk_bundle(opt, scm)
+        when /runtime|both/
+          deploy_mk_stub(opt)
+        end
+      end
+
+      def deploy_mk_bundle(opt, scm)
+        <<~SUBST
+          Tebako::Packager.deploy("#{opt.data_src_dir}", "#{opt.data_pre_dir}",
+                                  rv , "#{opt.root}", "#{scm.fs_entrance}", "#{opt.cwd}")
+          Tebako::Packager.mkdwarfs("#{opt.deps_bin_dir}", "#{opt.data_bundle_file}",
+                                    "#{opt.data_src_dir}")
+        SUBST
+      end
+
+      def deploy_mk_stub(opt)
+        <<~SUBST
+          Tebako::Packager.deploy("#{opt.data_src_dir}", "#{opt.data_pre_dir}",
+                                  rv, "#{File.join(opt.deps, "src", "tebako", "local")}", "stub.rb", nil)
+          Tebako::Packager.mkdwarfs("#{opt.deps_bin_dir}", "#{opt.data_stub_file}", "#{opt.data_src_dir}")
+        SUBST
+      end
+
+      def deploy_rb(opt, scm)
+        <<~SUBST
+          #{deploy_rq}
+
+          begin
+            #{deploy_rb_inner(opt, scm)}
+          rescue Tebako::Error => e
+            puts "deploy script failed: \#{e.message} [\#{e.error_code}]"
+            exit(e.error_code)
+          end
+        SUBST
+      end
+
+      def deploy_rb_inner(opt, scm)
+        <<~SUBST
+          rv = Tebako::RubyVersion.new(ARGV[0])
+          stash = File.join("#{opt.deps}", "stash_\#{ARGV[0]}")
+          Tebako::Packager::init(stash.to_s, "#{opt.data_src_dir}",
+                               "#{opt.data_pre_dir}", "#{opt.data_bin_dir}")
+          #{deploy_crt_implib(opt, scm)}
+          #{deploy_mk(opt, scm)}
+        SUBST
+      end
+
+      def deploy_rq
+        <<~SUBST
+          require "#{File.join(__dir__, "error.rb")}"
+          require "#{File.join(__dir__, "package_descriptor.rb")}"
+          require "#{File.join(__dir__, "packager.rb")}"
+          require "#{File.join(__dir__, "ruby_version.rb")}"
+        SUBST
+      end
+
+      def stub_rb(opt)
+        <<~SUBST
+          puts "Copyright (c) 2024-2025 Ribose Inc (https://www.ribose.com)"
+          puts "Tebako runtime stub v#{Tebako::VERSION}"
+          puts "To run your application please call #{File.basename(opt.package)} --tebako-run <your tebako package>"
+        SUBST
+      end
+
+      def generate_stub_rb(options_manager)
+        puts "   ... stub.rb"
+
+        fname = File.join(options_manager.deps, "src", "tebako", "local", "stub.rb")
+        FileUtils.mkdir_p(File.dirname(fname))
+
+        File.open(fname, "w") do |file|
+          file.write(COMMON_RUBY_HEADER)
+          file.write(stub_rb(options_manager))
+        end
+      end
+
+      def generate_deploy_rb(options_manager, scenario_manager)
+        puts "   ... deploy.rb"
+
+        fname = File.join(options_manager.deps, "bin", "deploy.rb")
+        FileUtils.mkdir_p(File.dirname(fname))
+
+        File.open(fname, "w") do |file|
+          file.write(COMMON_RUBY_HEADER)
+          file.write(deploy_rb(options_manager, scenario_manager))
+        end
+      end
+
+      def generate_package_descriptor(options_manager, scenario_manager)
+        puts "   ... package_descriptor"
+        fname = File.join(options_manager.deps, "src", "tebako", "package_descriptor")
+        FileUtils.mkdir_p(File.dirname(fname))
+        descriptor = Tebako::PackageDescriptor.new(options_manager.ruby_ver, Tebako::VERSION,
+                                                   scenario_manager.fs_mount_point, scenario_manager.fs_entry_point,
+                                                   options_manager.cwd)
+        File.binwrite(fname, descriptor.serialize)
+        fname
+      end
+
+      def generate_tebako_fs_cpp(options_manager, scenario_manager)
+        puts "   ... tebako-fs.cpp"
+
+        fname = File.join(options_manager.deps, "src", "tebako", "tebako-fs.cpp")
+        FileUtils.mkdir_p(File.dirname(fname))
+
+        File.open(fname, "w") do |file|
+          file.write(COMMON_C_HEADER)
+          file.write(tebako_fs_cpp(options_manager, scenario_manager))
+        end
+      end
+
+      def generate_tebako_version_h(options_manager, v_parts)
+        puts "   ... tebako-version.h"
+
+        fname = File.join(options_manager.deps, "include", "tebako", "tebako-version.h")
+        FileUtils.mkdir_p(File.dirname(fname))
+
+        File.open(fname, "w") do |file|
+          file.write(COMMON_C_HEADER)
+          file.write(tebako_version_h(v_parts))
+        end
+      end
+
+      def package_cwd(options_manager, scenario_manager)
+        if options_manager.cwd.nil?
+          "nullptr"
+        else
+          "\"#{scenario_manager.fs_mount_point}/#{options_manager.cwd}\""
+        end
+      end
+
+      def tebako_fs_cpp(options_manager, scenario_manager)
+        case options_manager.mode
+        when "bundle"
+          tebako_fs_cpp_bundle(options_manager, scenario_manager)
+        when /runtime|both/
+          tebako_fs_cpp_stub(options_manager, scenario_manager)
+        end
+      end
+
+      def tebako_fs_cpp_bundle(options_manager, scenario_manager)
+        <<~SUBST
+          #include <limits.h>
+          #include <incbin/incbin.h>
+
+          namespace tebako {
+            const  char * fs_log_level   = "#{options_manager.l_level}";
+            const  char * fs_mount_point = "#{scenario_manager.fs_mount_point}";
+            const  char * fs_entry_point = "#{scenario_manager.fs_entry_point}";
+            const  char * package_cwd 	 = #{package_cwd(options_manager, scenario_manager)};
+            char   original_cwd[PATH_MAX];
+
+            INCBIN(fs, "#{options_manager.data_bundle_file}");
+          }
+        SUBST
+      end
+
+      def tebako_fs_cpp_stub(options_manager, scenario_manager)
+        <<~SUBST
+          #include <limits.h>
+          #include <incbin/incbin.h>
+
+          namespace tebako {
+            const  char * fs_log_level   = "#{options_manager.l_level}";
+            const  char * fs_mount_point = "#{scenario_manager.fs_mount_point}";
+            const  char * fs_entry_point = "/local/stub.rb";
+            const  char * package_cwd 	 = nullptr;
+            char   original_cwd[PATH_MAX];
+
+            INCBIN(fs, "#{options_manager.data_stub_file}");
+          }
+        SUBST
+      end
+
+      def tebako_version_h(v_parts)
+        <<~SUBST
+          #pragma once
+
+          const unsigned int tebako_version_major = #{v_parts[0]};
+          const unsigned int tebako_version_minor = #{v_parts[1]};
+          const unsigned int tebako_version_teeny = #{v_parts[2]};
+        SUBST
+      end
+    end
+  end
+end