ocran 1.3.15 → 1.3.16

data/lib/ocran/stub_builder.rb

@@ -0,0 +1,224 @@
+# frozen_string_literal: true
+require "tempfile"
+require_relative "file_path_set"
+
+module Ocran
+  # Utility class that produces the actual executable. Opcodes
+  # (create_file, mkdir etc) are added by invoking methods on an
+  # instance of OcranBuilder.
+  class StubBuilder
+    Signature = [0x41, 0xb6, 0xba, 0x4e].freeze
+    OP_END = 0
+    OP_CREATE_DIRECTORY = 1
+    OP_CREATE_FILE = 2
+    OP_SETENV = 3
+    OP_SET_SCRIPT = 4
+
+    DEBUG_MODE          = 0x01
+    EXTRACT_TO_EXE_DIR  = 0x02
+    AUTO_CLEAN_INST_DIR = 0x04
+    CHDIR_BEFORE_SCRIPT = 0x08
+    DATA_COMPRESSED     = 0x10
+
+    base_dir = File.expand_path("../../share/ocran", File.dirname(__FILE__))
+    STUB_PATH = File.expand_path("stub.exe", base_dir)
+    STUBW_PATH = File.expand_path("stubw.exe", base_dir)
+    LZMA_PATH = File.expand_path("lzma.exe", base_dir)
+    EDICON_PATH = File.expand_path("edicon.exe", base_dir)
+
+    attr_reader :data_size
+
+    # chdir_before:
+    # When set to true, the working directory is changed to the application's
+    # deployment location at runtime.
+    #
+    # debug_mode:
+    # When the debug_mode option is set to true, the stub will output debug information
+    # when the exe file is executed. Debug mode can also be enabled within the directive
+    # code using the enable_debug_mode method. This option is provided to transition to
+    # debug mode from the initialization point of the stub.
+    #
+    # debug_extract:
+    # When set to true, the runtime file is extracted to the directory where the executable resides,
+    # and the extracted files remain even after the application exits.
+    # When set to false, the runtime file is extracted to the system's temporary directory,
+    # and the extracted files are deleted after the application exits.
+    #
+    # gui_mode:
+    # When set to true, the stub does not display a console window at startup. Errors are shown in a dialog window.
+    # When set to false, the stub reports errors through the console window.
+    #
+    # icon_path:
+    # Specifies the path to the icon file to be embedded in the stub's resources.
+    #
+    def initialize(path, chdir_before: nil, debug_extract: nil, debug_mode: nil,
+                   enable_compression: nil, gui_mode: nil, icon_path: nil)
+      @dirs = FilePathSet.new
+      @files = FilePathSet.new
+      @data_size = 0
+
+      if icon_path && !File.exist?(icon_path)
+        raise "Icon file #{icon_path} not found"
+      end
+
+      stub = Tempfile.new("", File.dirname(path))
+      IO.copy_stream(gui_mode ? STUBW_PATH : STUB_PATH, stub)
+      stub.close
+
+      if icon_path
+        system(EDICON_PATH, stub.path, icon_path.to_s, exception: true)
+      end
+
+      File.open(stub, "ab") do |of|
+        @of = of
+        @opcode_offset = @of.size
+
+        write_header(debug_mode, debug_extract, chdir_before, enable_compression)
+
+        b = proc {
+          yield(self)
+          write_opcode(OP_END)
+        }
+
+        if enable_compression
+          compress(&b)
+        else
+          b.yield
+        end
+
+        write_footer
+      end
+
+      File.rename(stub, path)
+    end
+
+    def mkdir(target)
+      return unless @dirs.add?("/", target)
+
+      write_opcode(OP_CREATE_DIRECTORY)
+      write_path(target)
+    end
+
+    def cp(source, target)
+      unless File.exist?(source)
+        raise "The file does not exist (#{source})"
+      end
+
+      return unless @files.add?(source, target)
+
+      write_opcode(OP_CREATE_FILE)
+      write_path(target)
+      write_file(source)
+    end
+
+    # Specifies the final application script to be launched, which can be called
+    # from any position in the data stream. It cannot be specified more than once.
+    #
+    # You can omit setting OP_SET_SCRIPT without issues, in which case
+    # the stub terminates without launching anything after performing other
+    # runtime operations.
+    def exec(image, script, *argv)
+      if @script_set
+        raise "Script is already set"
+      end
+      @script_set = true
+
+      write_opcode(OP_SET_SCRIPT)
+      write_string_array(convert_to_native(image), convert_to_native(script), *argv)
+    end
+
+    def export(name, value)
+      write_opcode(OP_SETENV)
+      write_string(name.to_s)
+      write_string(value.to_s)
+    end
+
+    def compress
+      IO.popen([LZMA_PATH, "e", "-si", "-so"], "r+b") do |lzma|
+        _of, @of = @of, lzma
+        Thread.new { yield(self); lzma.close_write }
+        IO.copy_stream(lzma, _of)
+        @of = _of
+      end
+
+      # Calculate the position to write the LZMA decompressed size (64-bit unsigned integer)
+      # @opcode_offset: start position of the data section
+      # 1: size of the header byte
+      # 5: size of the LZMA header in bytes
+      File.binwrite(@of.path, [@data_size].pack("Q<"), @opcode_offset + 1 + 5)
+    end
+    private :compress
+
+    def write_header(debug_mode, debug_extract, chdir_before, compressed)
+      next_to_exe, delete_after = debug_extract, !debug_extract
+      @of << [0 |
+                (debug_mode ? DEBUG_MODE : 0) |
+                (next_to_exe ? EXTRACT_TO_EXE_DIR : 0) |
+                (delete_after ? AUTO_CLEAN_INST_DIR : 0) |
+                (chdir_before ? CHDIR_BEFORE_SCRIPT : 0) |
+                (compressed ? DATA_COMPRESSED : 0)
+      ].pack("C")
+    end
+    private :write_header
+
+    def write_opcode(op)
+      @of << [op].pack("C")
+      @data_size += 1
+    end
+    private :write_opcode
+
+    def write_size(i)
+      if i > 0xFFFF_FFFF
+        raise ArgumentError, "Size #{i} is too large: must be 32-bit unsigned integer (0 to 4294967295)"
+      end
+
+      @of << [i].pack("V")
+      @data_size += 4
+    end
+    private :write_size
+
+    def write_string(str)
+      len = str.bytesize + 1 # +1 to account for the null terminator
+
+      if len > 0xFFFF
+        raise ArgumentError, "String length #{len} is too large: must be less than or equal to 65535 bytes including null terminator"
+      end
+
+      @of << [len, str].pack("vZ*")
+      @data_size += 2 + len
+    end
+    private :write_string
+
+    def write_string_array(*str_array)
+      ary = str_array.map(&:to_s)
+      size = ary.sum(0) { |s| s.bytesize + 1 }
+      write_size(size)
+      ary.each_slice(1) { |a| @of << a.pack("Z*") }
+      @data_size += size
+    end
+    private :write_string_array
+
+    def write_file(src)
+      size = File.size(src)
+      write_size(size)
+      IO.copy_stream(src, @of)
+      @data_size += size
+    end
+    private :write_file
+
+    def write_path(path)
+      write_string(convert_to_native(path))
+    end
+    private :write_path
+
+    def write_footer
+      @of << ([@opcode_offset] + Signature).pack("VC*")
+    end
+    private :write_footer
+
+    def convert_to_native(path)
+      path.to_s.tr(File::SEPARATOR, "\\")
+    end
+    private :convert_to_native
+  end
+end

data/lib/ocran/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ocran
-  VERSION = "1.3.15"
+  VERSION = "1.3.16"
 end

data/lib/ocran/windows_command_escaping.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Ocran
+  module WindowsCommandEscaping
+    module_function
+
+    def escape_double_quotes(s)
+      s.to_s.gsub('"', '""')
+    end
+
+    def quote_and_escape(s)
+      "\"#{escape_double_quotes(s)}\""
+    end
+  end
+end

data/lib/ocran.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
-require_relative "ocran/version"
-
 module Ocran
+  autoload :VERSION, "ocran/version"
+
+  singleton_class.attr_accessor :option
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ocran
 version: !ruby/object:Gem::Version
-  version: 1.3.15
+  version: 1.3.16
 platform: ruby
 authors:
 - Andi Idogawa
@@ -9,13 +9,13 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-11-30 00:00:00.000000000 Z
+date: 2024-08-05 00:00:00.000000000 Z
 dependencies: []
 description: "OCRAN (One-Click Ruby Application Next) builds Windows executables from
   Ruby source code. \n  The executable is a self-extracting, self-running executable
   that contains the Ruby interpreter, your source code and any additionally needed
   ruby libraries or DLL.\n  \n  This is a fork of OCRA that is compatible with ruby
-  version after 2.6. \n  Migration guide: make sure to write ocran instead of ocra
+  version after 3.0.\n  Migration guide: make sure to write ocran instead of ocra
   in your code. For instance: OCRAN_EXECUTABLE\n\n  usage: \n    ocra helloworld.rb\n
   \   helloworld.exe\n\n  See readme at https://github.com/largo/ocran\n  Report problems
   in the github issues. Contributions welcome.\n  This gem contains executables. We
@@ -29,9 +29,26 @@ extra_rdoc_files: []
 files:
 - bin/ocran
 - lib/ocran.rb
+- lib/ocran/build_constants.rb
+- lib/ocran/build_facade.rb
+- lib/ocran/build_helper.rb
+- lib/ocran/command_output.rb
+- lib/ocran/direction.rb
+- lib/ocran/empty_source
+- lib/ocran/file_path_set.rb
+- lib/ocran/gem_spec_queryable.rb
+- lib/ocran/host_config_helper.rb
+- lib/ocran/inno_setup_script_builder.rb
+- lib/ocran/launcher_batch_builder.rb
+- lib/ocran/library_detector.rb
+- lib/ocran/option.rb
+- lib/ocran/refine_pathname.rb
+- lib/ocran/runner.rb
+- lib/ocran/runtime_environment.rb
+- lib/ocran/stub_builder.rb
 - lib/ocran/version.rb
+- lib/ocran/windows_command_escaping.rb
 - share/ocran/edicon.exe
-- share/ocran/empty-msys-2.0.dll
 - share/ocran/lzma.exe
 - share/ocran/stub.exe
 - share/ocran/stubw.exe
@@ -50,14 +67,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.6.0
+      version: 3.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
+rubygems_version: 3.5.3
 signing_key:
 specification_version: 4
 summary: OCRAN (One-Click Ruby Application Next) builds Windows executables from Ruby