kompo 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 824cb5818444206e527f8a70d899c53b922f05a2ee44b1433b9103e2bc00dec9
-  data.tar.gz: bc82fea90c7f254f3f1e2221cadd4dedb9ec0e0c64ae4a68163e5784a0de35d1
+  metadata.gz: 9810a7219117daa1c6a82c2741df55d16acb20a7d59b6dec0609f2f6a68418dd
+  data.tar.gz: 0b304b0510ec458f50c75e94528d604f71fa9cc7f5cdbb7386bcf1671495ca02
 SHA512:
-  metadata.gz: 164750a94ce03e80d4dbdbd6c88a33ea76e92e5ddcd0a7ee2170aa76e2c24c3471616739a21adcd37724a49a0af93bb3805b73e14446159dc218cb514fb0fc9a
-  data.tar.gz: 7668b48ea202b6f21dccceb8a67097d1df27b6661295c36b756f9a537c09f5479ed326f86c0374b7bb5fef860d62f54a599c520212798a31b02c03ddb6bc295a
+  metadata.gz: d678007c08242abee43dc8dd74a70a425701287336782b87f55e60624fa605ce1d844b345f14f70583e11dbccbcf507aec307b3cdcfc9a1472f5eab356d0c80c
+  data.tar.gz: ef31ac68e4ef6e15d1b98b1e71d97faf8385b36c3f75d85c918e970a0f47331845f4b994c1a4a68144ed730ca18331b21794b8c9dd543c881639c71c8042df02

data/.devcontainer/Dockerfile

@@ -3,9 +3,7 @@ FROM mcr.microsoft.com/devcontainers/base:ubuntu
 RUN apt-get update && apt-get install -y clang
 RUN curl https://sh.rustup.rs -sSf | sh -s -- -y
 ENV PATH="/root/.cargo/bin:$PATH"
-RUN git clone https://github.com/ahogappa0613/kompo-vfs.git && \
+RUN git clone https://github.com/ahogappa/kompo-vfs.git && \
   cd kompo-vfs && \
-  sudo /root/.cargo/bin/cargo build --release && \
-  sudo cp target/release/kompo-cli /usr/local/bin && \
-  sudo cp target/release/libkompo.a /usr/local/lib
+  sudo /root/.cargo/bin/cargo build --release
 

data/.devcontainer/devcontainer.json

@@ -13,8 +13,8 @@
   },
   "containerEnv": {
     // "PATH": "/usr/local/cargo/bin:${containerEnv:PATH}",
-    "KOMPO_CLI": "/usr/local/bin/kompo-cli",
-    "LIB_KOMPO_DIR": "/usr/local/lib",
+    // "KOMPO_CLI": "/usr/local/bin/kompo-cli",
+    // "LIB_KOMPO_DIR": "/usr/local/lib",
   },
   // Features to add to the dev container. More info: https://containers.dev/features.
   // "features": {},

data/.standard.yml

@@ -0,0 +1,2 @@
+ignore:
+  - "samples/**/*"

data/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.3.0] - 2026-01-24
+
+### Changed
+- Use RTLD_NEXT for single binary creation process [#6](https://github.com/ahogappa/kompo/pull/6)
+- Rewrite kompo with Taski-based parallel task system [#6](https://github.com/ahogappa/kompo/pull/6)
+- Use ruby-build for Ruby installation [#5](https://github.com/ahogappa/kompo/pull/5)
+
+### Added
+- Ability to configure options for Ruby build
+
+### Fixed
+- Fix error messages

data/Gemfile

@@ -1,8 +1,16 @@
 # frozen_string_literal: true
 
-source "https://rubygems.org"
+source 'https://rubygems.org'
 
 # Specify your gem's dependencies in kompo.gemspec
 gemspec
 
-gem "rake", "~> 13.0"
+gem 'rake', '~> 13.0'
+gem 'taski', '~> 0.8.0'
+
+group :development, :test do
+  gem 'debug'
+  gem 'minitest'
+  gem 'simplecov', require: false
+  gem 'standard'
+end

data/Gemfile.lock

@@ -1,20 +1,132 @@
 PATH
   remote: .
   specs:
-    kompo (0.1.0)
+    kompo (0.3.0)
+      async
+      mini_portile2
+      pathspec
 
 GEM
   remote: https://rubygems.org/
   specs:
-    rake (13.1.0)
+    ast (2.4.3)
+    async (2.35.0)
+      console (~> 1.29)
+      fiber-annotation
+      io-event (~> 1.11)
+      metrics (~> 0.12)
+      traces (~> 0.18)
+    console (1.34.2)
+      fiber-annotation
+      fiber-local (~> 1.1)
+      json
+    date (3.5.1)
+    debug (1.11.1)
+      irb (~> 1.10)
+      reline (>= 0.3.8)
+    docile (1.4.1)
+    erb (6.0.1)
+    fiber-annotation (0.2.0)
+    fiber-local (1.1.0)
+      fiber-storage
+    fiber-storage (1.0.1)
+    io-console (0.8.2)
+    io-event (1.14.2)
+    irb (1.16.0)
+      pp (>= 0.6.0)
+      rdoc (>= 4.0.0)
+      reline (>= 0.4.2)
+    json (2.18.0)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    metrics (0.15.0)
+    mini_portile2 (2.8.9)
+    minitest (6.0.1)
+      prism (~> 1.5)
+    parallel (1.27.0)
+    parser (3.3.10.1)
+      ast (~> 2.4.1)
+      racc
+    pathspec (2.1.0)
+    pp (0.6.3)
+      prettyprint
+    prettyprint (0.2.0)
+    prism (1.8.0)
+    psych (5.3.1)
+      date
+      stringio
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.3.1)
+    rdoc (7.0.2)
+      erb
+      psych (>= 4.0.0)
+      tsort
+    regexp_parser (2.11.3)
+    reline (0.6.3)
+      io-console (~> 0.5)
+    rubocop (1.82.1)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.48.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.49.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    rubocop-performance (1.26.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
+    ruby-progressbar (1.13.0)
+    simplecov (0.22.0)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.13.2)
+    simplecov_json_formatter (0.1.4)
+    standard (1.53.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.82.0)
+      standard-custom (~> 1.0.0)
+      standard-performance (~> 1.8)
+    standard-custom (1.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.50)
+    standard-performance (1.9.0)
+      lint_roller (~> 1.1)
+      rubocop-performance (~> 1.26.0)
+    stringio (3.2.0)
+    taski (0.8.0)
+      prism (~> 1.4)
+      tsort
+    traces (0.18.2)
+    tsort (0.2.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
 
 PLATFORMS
   aarch64-linux
   arm64-darwin-23
+  arm64-darwin-24
+  arm64-darwin-25
+  x86_64-linux
 
 DEPENDENCIES
+  debug
   kompo!
+  minitest
   rake (~> 13.0)
+  simplecov
+  standard
+  taski (~> 0.8.0)
 
 BUNDLED WITH
-   2.4.10
+   2.6.9

data/README.md

@@ -1,6 +1,31 @@
 # Kompo
 A tool to pack Ruby and Ruby scripts in one binary. This tool is still under development.
 
+## Concept
+
+Kompo makes it dead simple to distribute Ruby applications. Just run one command, and you get a single binary that works anywhere—no Ruby installation required.
+
+```sh
+$ kompo
+$ ./main  # That's it!
+```
+
+### Why Kompo?
+
+- **Dead Simple**: One command to build, one file to distribute. No complex configuration, no build scripts, no Docker containers.
+
+- **Zero Dependencies for Users**: Your users just download and run. No Ruby, no gems, no environment setup—it just works.
+
+- **Full CRuby Compatibility**: Unlike mruby-based solutions, Kompo embeds the official CRuby interpreter. Your existing code, gems, and C extensions work without modification.
+
+- **Cross-Platform**: Build binaries for macOS and Linux. (Windows support is planned)
+
+- **Batteries Included**: All your gems, including native extensions, are bundled automatically.
+
+### How It Works
+
+Kompo uses a Virtual File System (VFS) to embed Ruby source code, gems, and the Ruby interpreter into a single binary. At runtime, the embedded VFS provides transparent access to these files, allowing Ruby to operate as if everything were installed normally on the filesystem.
+
 ## Installation
 ```sh
 $ gem install kompo
@@ -9,35 +34,117 @@ $ gem install kompo
 ## Usage
 
 ### prerequisites
-Install [komp-vfs](https://github.com/ahogappa0613/kompo-vfs).
+Install [kompo-vfs](https://github.com/ahogappa/kompo-vfs).
 
 #### Homebrew
 ```sh
-$ brew tap ahogappa0613/kompo-vfs https://github.com/ahogappa0613/kompo-vfs.git
-$ brew install ahogappa0613/kompo-vfs/kompo-vfs
+$ brew tap ahogappa/kompo-vfs https://github.com/ahogappa/kompo-vfs.git
+$ brew install ahogappa/kompo-vfs/kompo-vfs
 ```
 
 ### Building
 To build komp-vfs, you need to have cargo installation.
 ```sh
-$ git clone https://github.com/ahogappa0613/kompo-vfs.git
+$ git clone https://github.com/ahogappa/kompo-vfs.git
 $ cd kompo-vfs
 $ cargo build --release
 ```
-Set environment variables
+
+## Options
+
+```
+Usage: kompo [options] [files...]
+
+Options:
+    -e, --entrypoint=FILE        Entry point file (default: main.rb)
+    -o, --output=DIR             Output directory for the binary
+        --ruby-version=VERSION   Ruby version to use (default: current Ruby version)
+        --ruby-source=PATH       Path to Ruby source tarball or directory
+        --no-cache               Build Ruby from source, ignoring cache
+        --no-stdlib              Exclude Ruby standard library from binary
+        --local-vfs-path=PATH    Path to local kompo-vfs for development
+        --clean[=VERSION]        Clean cache (current version by default, or specify VERSION, or "all")
+    -t, --tree                   Show task dependency tree and exit
+    -h, --help                   Show help message
+
+Files:
+    Additional files and directories to include in the binary
+```
+
+### Option Details
+
+| Option | Description |
+|--------|-------------|
+| `-e, --entrypoint` | Specifies the main Ruby file to execute. Defaults to `main.rb`. |
+| `-o, --output` | Directory where the final binary will be placed. Defaults to current directory. |
+| `--ruby-version` | Ruby version to embed. Kompo will build and cache this version. |
+| `--ruby-source` | Use a local Ruby source instead of downloading. Useful for custom Ruby builds. |
+| `--no-cache` | Force a fresh Ruby build, ignoring any cached version. |
+| `--no-stdlib` | Reduce binary size by excluding Ruby standard library. Only use if your app doesn't need stdlib. |
+| `--local-vfs-path` | Use a local kompo-vfs build instead of Homebrew installation. Useful for development. |
+| `--clean` | Remove cached Ruby builds. Use `--clean=all` to remove all versions. |
+| `-t, --tree` | Display the task dependency graph and exit without building. |
+
+### Examples
+
 ```sh
-$ KOMPO_CLI=/path/to/kompo-vfs/target/release/kompo-cli
-$ LIB_KOMPO_DIR=/path/to/kompo-vfs/target/release
+# Basic usage - pack main.rb and lib/ directory
+$ kompo main.rb lib/
+
+# Specify entry point and output directory
+$ kompo -e app.rb -o ./dist src/ config/
+
+# Use a specific Ruby version
+$ kompo --ruby-version=3.3.0 main.rb
+
+# Development: use local kompo-vfs
+$ kompo --local-vfs-path=/path/to/kompo-vfs main.rb
+
+# Clean all cached Ruby builds
+$ kompo --clean=all
 ```
 
+## .kompoignore
+
+You can create a `.kompoignore` file in your project root to exclude files from the binary. This file follows the same syntax as `.gitignore`.
+
+### Syntax
+
+```gitignore
+# Comments start with #
+*.log           # Ignore all .log files
+tmp/            # Ignore tmp directory
+**/cache/       # Ignore cache directories at any depth
+!important.log  # Negate pattern (don't ignore important.log)
+spec/           # Ignore spec directory
+test/           # Ignore test directory
+node_modules/   # Ignore node_modules
+```
+
+### Supported Patterns
+
+| Pattern | Description |
+|---------|-------------|
+| `*.log` | Glob pattern - matches all .log files |
+| `tmp/` | Directory pattern - matches tmp directory and contents |
+| `**/cache/` | Double star - matches cache at any depth |
+| `!file` | Negation - excludes file from ignore list |
+| `/config.yml` | Anchored - matches only at root level |
+
+### Notes
+
+- `.kompoignore` only affects project files, not Ruby standard library or gems
+- Patterns are matched against paths relative to the project root
+- Comments and empty lines are ignored
+
 ## examples
 
 * hello
   * simple hello world script.
 * sinatra_and_sqlite
-  * sinatra app with sqlite3 with Gemfile.
+  * simple sinatra app with sqlite3.
 * rails
-  * 🚧
+  * simple Rails 7.1 application.
 
 ## Development
 
@@ -45,4 +152,4 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/ahogappa0613/kompo.
+Bug reports and pull requests are welcome on GitHub at https://github.com/ahogappa/kompo.

data/Rakefile

@@ -1,4 +1,14 @@
 # frozen_string_literal: true
 
-require "bundler/gem_tasks"
-task default: %i[]
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+require 'standard/rake'
+
+task default: %i[test standard]

data/docs/document.md.ja

@@ -0,0 +1,31 @@
+# 現状の仕様のまとめ
+
+## 基本情報
+kompoはワンバイナリにするファイルを作業ディレクトリにコピーします。
+その作業ディレクトリはワンバイナリ化したプログラムが実行した時のルートディレクトリとします。
+このとき作業ディレクトリのパス名やファイル名はプログラムの中に埋め込まれるため注意が必要です。(デフォルトではSecureRandomを使ってランダムなフォルダ名を生成します)
+
+## kompoの制約
+ワンバイナリ化したプログラム内にデータを書き込むことはできません。
+この制約があるため、一部のrubyプロジェクトの場合ファイルや設定を工夫する必要があります。
+
+例えばrailsのデータベースにsqliteを使う場合、デフォルトだとプロジェクトのtmp/以下にデータベースを配置します。
+さらにこのディレクトリにはrailsの起動時に必要なディレクトリやファイルをいくつか書き込みます。
+sampleにあるrailsではあらかじめtmp/以下に起動に必要なディレクトリやファイルを用意し、それをバイナリに含めることで起動時にディレクトリやファイルを作成しなくても良いようにしています。
+
+一方sqliteのデータベースもここに設置されるのですが、これには書き込みがなされるため、tmp/以下に設置することはできません。
+よってconfig/database.ymlを修正して、sqliteのデータベースは実行するマシンの絶対パスに配置するようにします。
+
+簡単なrailsをワンバイナリ化する具体的な方法はsample/rails/sampleのREADME.mdやsample/rails/sample/config/database.ymlを参照してください。
+
+## 拡張ライブラリが含まれる場合
+拡張ライブラリが含まれるRubyプロジェクトの場合、拡張ライブラリをbuildできる環境が必要です。また環境が整っていても拡張ライブラリによってはうまくワンバイナリ化できない場合があります。
+
+kompoは通常、拡張ライブラリを静的リンクするためにmkmf.rbを実行してMakefileを生成、コンパイルしアーカイブファイルを作ります。
+そしてワンバイナリ化したプログラムを作成するときには、そのMakefileに含まれている情報をもとにinclude/やlib/のパスを指定してコンパイルします。
+
+しかし、一部独自のbuild方法をとっているものがあり、Makefileから取得する情報が足りなかったりして失敗する可能性があります。
+これに関してはなるべく対応していくつもりですが、完全に対応できるものではないので、拡張ライブラリのbuild方法をパッチするなり、自前でbuildしたものを使ってワンバイナリ化するなどする必要があります。
+
+また当然ですが、拡張ライブラリ自体がクロスコンパイルに対応していない場合は、kompoを使ってもクロスコンパイルできません。
+

data/exe/kompo

@@ -1,20 +1,51 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
-require_relative '../lib/kompo'
 require 'optparse'
+require_relative '../lib/kompo'
 
-option = Kompo::Option.default
-
-Kompo::Tasks.cd_work_dir(option) do |task|
-  task.clone_ruby_src
-
-  task.fs_cli
-
-  task.make_main_c
-
-  task.packing
-
-  task.copy_to_dest_dir
+args = {}
+opt = OptionParser.new do |o|
+  o.banner = 'Usage: kompo [options] [files...]'
+  o.separator ''
+  o.separator 'Options:'
+
+  o.on('-e', '--entrypoint=FILE', 'Entry point file (default: main.rb)') { |v| args[:entrypoint] = v }
+  o.on('-o', '--output=DIR', 'Output directory for the binary') { |v| args[:output_dir] = File.expand_path(v) }
+  o.on('--ruby-version=VERSION', "Ruby version to use (default: #{RUBY_VERSION})") { |v| args[:ruby_version] = v }
+  o.on('--ruby-source=PATH', 'Path to Ruby source tarball or directory') do |v|
+    args[:ruby_source_path] = File.expand_path(v)
+  end
+  o.on('--no-cache', 'Build Ruby from source, ignoring cache') { |_v| args[:no_cache] = true }
+  o.on('--no-stdlib', 'Exclude Ruby standard library from binary') { |_v| args[:no_stdlib] = true }
+  o.on('--local-vfs-path=PATH', 'Path to local kompo-vfs for development') do |v|
+    args[:local_kompo_vfs_path] = File.expand_path(v)
+  end
+  o.on('--clean[=VERSION]', 'Clean cache (current Ruby version by default, or specify VERSION, or "all")') do |v|
+    args[:clean_cache] = v.nil? ? RUBY_VERSION : v
+  end
+  o.on('-t', '--tree', 'Show task dependency tree and exit') do
+    puts Kompo::Packing.tree
+    exit(0)
+  end
+  o.on('-v', '--version', 'Show version') do
+    puts "kompo #{Kompo::VERSION}"
+    exit(0)
+  end
+  o.on('-h', '--help', 'Show this help message') do
+    puts o
+    exit(0)
+  end
+
+  o.separator ''
+  o.separator 'Files:'
+  o.separator '  Additional files and directories to include in the binary'
 end
+opt.parse!(ARGV)
+args[:files] = ARGV
 
-puts 'info: Finish kompo!'
+if args[:clean_cache]
+  Kompo.clean_cache(args[:clean_cache])
+else
+  Kompo::Packing.run_and_clean(args:)
+end

data/lib/fs.c.erb

@@ -0,0 +1,6 @@
+const char FILES[] = {<%= @file_bytes.join(',') %>};
+const int FILES_SIZE = <%= @file_bytes.size %>;
+const unsigned long long FILES_SIZES[] = {<%= @file_sizes.join(',') %>};
+const char PATHS[] = {<%= @paths.join(',') %>};
+const int PATHS_SIZE = <%= @paths.size %>;
+const char WD[] = {<%= context.work_dir.bytes.join(',') %>,0};

data/lib/kompo/cache.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+require 'fileutils'
+
+module Kompo
+  # Clean the cache for specified Ruby version
+  # @param version [String] Ruby version to clean, or "all" to clean all caches
+  def self.clean_cache(version)
+    kompo_cache = File.expand_path('~/.kompo/cache')
+
+    unless Dir.exist?(kompo_cache)
+      puts "Cache directory does not exist: #{kompo_cache}"
+      return
+    end
+
+    if version == 'all'
+      clean_all_caches(kompo_cache)
+    else
+      clean_version_cache(kompo_cache, version)
+    end
+  end
+
+  # Clean all caches in the cache directory
+  def self.clean_all_caches(kompo_cache)
+    entries = Dir.glob(File.join(kompo_cache, '*'))
+    if entries.empty?
+      puts "No caches found in #{kompo_cache}"
+      return
+    end
+
+    entries.each do |entry|
+      FileUtils.rm_rf(entry)
+      puts "Removed: #{entry}"
+    end
+
+    puts 'All caches cleaned successfully'
+  end
+  private_class_method :clean_all_caches
+
+  # Clean cache for a specific Ruby version
+  # New structure: ~/.kompo/cache/{version}/ contains all caches for that version
+  def self.clean_version_cache(kompo_cache, version)
+    version_cache_dir = File.join(kompo_cache, version)
+
+    unless Dir.exist?(version_cache_dir)
+      puts "No cache found for Ruby #{version}"
+      return
+    end
+
+    # Validate that version_cache_dir is under kompo_cache to prevent path traversal
+    real_kompo_cache = File.realpath(kompo_cache)
+    real_version_cache = File.realpath(version_cache_dir)
+
+    unless real_version_cache.start_with?(real_kompo_cache + File::SEPARATOR) ||
+           real_version_cache == real_kompo_cache
+      puts 'Error: Invalid cache path detected (possible path traversal)'
+      return
+    end
+
+    FileUtils.rm_rf(real_version_cache)
+    puts "Removed: #{real_version_cache}"
+    puts "Cache for Ruby #{version} cleaned successfully"
+  end
+  private_class_method :clean_version_cache
+end

data/lib/kompo/kompo_ignore.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require 'pathspec'
+
+module Kompo
+  # Handler for .kompoignore file
+  # Uses pathspec gem for gitignore-compatible pattern matching
+  class KompoIgnore
+    FILENAME = '.kompoignore'
+
+    def initialize(project_dir)
+      @project_dir = project_dir
+      @pathspec = load_pathspec
+    end
+
+    # Check if the given relative path should be ignored
+    # @param relative_path [String] Path relative to work_dir
+    # @return [Boolean] true if the path should be ignored
+    def ignore?(relative_path)
+      return false unless @pathspec
+
+      @pathspec.match(relative_path)
+    end
+
+    # Check if .kompoignore file exists and is enabled
+    # @return [Boolean] true if .kompoignore file exists
+    def enabled?
+      !@pathspec.nil?
+    end
+
+    private
+
+    def load_pathspec
+      ignore_file = File.join(@project_dir, FILENAME)
+      return nil unless File.exist?(ignore_file)
+
+      PathSpec.from_filename(ignore_file)
+    end
+  end
+end