ruby_wasm 2.5.0-arm64-darwin

data/sig/ruby_wasm/build.rbs

@@ -0,0 +1,318 @@
+module RubyWasm
+  VERSION: String
+
+  interface _Cacheable
+    def cache_key: (Digest::SHA256 digest) -> void
+  end
+
+  class Build
+    include _Cacheable
+
+    @target: String
+    @build_dir: String
+    @rubies_dir: String
+    @toolchain: Toolchain
+    @libyaml: LibYAMLProduct
+    @zlib: ZlibProduct
+    @openssl: OpenSSLProduct
+    @wasi_vfs: WasiVfsProduct
+    @baseruby: BaseRubyProduct
+    @crossruby: CrossRubyProduct
+    @source: BuildSource
+
+    attr_reader toolchain: Toolchain
+
+    def initialize: (
+      string name,
+      target: String,
+      src: Packager::build_source,
+      toolchain: Toolchain?,
+      build_dir: string,
+      rubies_dir: string,
+      **untyped
+    ) -> void
+    def crossruby: () -> CrossRubyProduct
+  end
+
+  class BuildParams
+    attr_accessor name: String
+    attr_accessor target: String
+    attr_accessor default_exts: String
+
+    def initialize: (name: string, target: string, default_exts: string) -> void
+  end
+
+  class BuildProduct
+    def name: -> String
+  end
+
+  class AutoconfProduct < BuildProduct
+    @target: String
+    @toolchain: Toolchain
+
+    def initialize: (String target, Toolchain toolchain) -> void
+    def system_triplet_args: -> Array[String]
+                           | -> Array[String]
+    def tools_args: -> Array[String]
+                  | -> Array[String]
+    def configure_args: -> Array[String]
+                      | -> Array[String]
+  end
+
+  class BuildSource < BuildProduct
+    @params: Hash[untyped, untyped]
+    @build_dir: String
+
+    def initialize: (untyped params, String build_dir) -> void
+    def name: -> String
+    def cache_key: (Digest::SHA256 digest) -> void
+    def src_dir: -> String
+    def configure_file: -> String
+    def fetch: (BuildExecutor executor) -> void
+    def build: (BuildExecutor executor) -> void
+  end
+
+  class BaseRubyProduct < BuildProduct
+    @build_dir: String
+    @source: BuildSource
+    @channel: String
+
+    def initialize: (String build_dir, BuildSource source) -> void
+    def product_build_dir: -> String
+    def install_dir: -> String
+    def name: -> String
+    def build: (BuildExecutor executor) -> void
+  end
+
+  class ZlibProduct < AutoconfProduct
+    ZLIB_VERSION: String
+    @build_dir: String
+
+    attr_reader target: String
+    def initialize: (String build_dir, String target, Toolchain toolchain) -> void
+    def product_build_dir: -> String
+    def destdir: -> String
+    def install_root: -> String
+    def name: -> String
+    def configure_args: -> Array[String]
+    def build: (BuildExecutor executor) -> void
+  end
+
+  class LibYAMLProduct < AutoconfProduct
+    LIBYAML_VERSION: String
+    @build_dir: String
+
+    attr_reader target: String
+    def initialize: (String build_dir, String target, Toolchain toolchain) -> void
+    def product_build_dir: -> String
+    def destdir: -> String
+    def install_root: -> String
+    def name: -> String
+    def build: (BuildExecutor executor) -> void
+  end
+
+  class OpenSSLProduct < AutoconfProduct
+    OPENSSL_VERSION: String
+    @build_dir: String
+
+    attr_reader target: String
+    def initialize: (String build_dir, String target, Toolchain toolchain) -> void
+    def product_build_dir: -> String
+    def destdir: -> String
+    def install_root: -> String
+    def name: -> String
+    def configure_args: -> Array[String]
+    def build: (BuildExecutor executor) -> void
+  end
+
+  class WasiVfsProduct < BuildProduct
+    WASI_VFS_VERSION: String
+    @build_dir: String
+    @need_fetch_lib: bool
+    @cli_path: String
+    @need_fetch_cli: bool
+
+    def initialize: (String build_dir) -> void
+    def lib_product_build_dir: -> String
+    def lib_wasi_vfs_a: -> String
+    def name: -> String
+    def build: (BuildExecutor executor) -> void
+  end
+
+  class CrossRubyExtProduct < BuildProduct
+    include RubyWasm::_Cacheable
+
+    @toolchain: Toolchain
+    @srcdir: String
+    @ext_relative_path: String
+
+    attr_reader name: String
+    def initialize: (String srcdir, Toolchain toolchain, ?ext_relative_path: String?) -> void
+    def product_build_dir: (CrossRubyProduct crossruby) -> String
+    def linklist: (CrossRubyProduct crossruby) -> String
+    def metadata_json: (CrossRubyProduct crossruby) -> String
+    def feature_name: (CrossRubyProduct crossruby) -> String
+
+    def make_args: (CrossRubyProduct crossruby) -> Array[String]
+    def build: (BuildExecutor executor, CrossRubyProduct crossruby) -> void
+    def do_extconf: (BuildExecutor executor, CrossRubyProduct crossruby) -> void
+    def do_install_rb: (BuildExecutor executor, CrossRubyProduct crossruby) -> void
+  end
+
+  class CrossRubyProduct < AutoconfProduct
+    include RubyWasm::_Cacheable
+
+    @params: BuildParams
+    @rubies_dir: String
+    @build_dir: String
+    @baseruby: BaseRubyProduct
+    @libyaml: LibYAMLProduct
+    @zlib: ZlibProduct
+    @openssl: OpenSSLProduct
+    @wasi_vfs: WasiVfsProduct
+
+    attr_reader source: BuildSource
+    attr_reader toolchain: Toolchain
+    attr_accessor user_exts: Array[CrossRubyExtProduct]
+    attr_accessor wasmoptflags: Array[String]
+    attr_accessor cppflags: Array[String]
+    attr_accessor cflags: Array[String]
+    attr_accessor ldflags: Array[String]
+    attr_accessor debugflags: Array[String]
+    attr_accessor xcflags: Array[String]
+    attr_accessor xldflags: Array[String]
+    def initialize: (BuildParams params, String build_dir, String rubies_dir, BaseRubyProduct baseruby, BuildSource source, Toolchain toolchain) -> void
+    def configure: (BuildExecutor executor, ?reconfigure: bool) -> void
+    def build_exts: (BuildExecutor executor) -> void
+    def build: (BuildExecutor executor, ?remake: bool, ?reconfigure: bool) -> void
+    def clean: (BuildExecutor executor) -> void
+    def name: -> String
+    def build_dir: -> String
+    def ext_build_dir: -> String
+    def with_libyaml: (LibYAMLProduct libyaml) -> LibYAMLProduct
+    def with_zlib: (ZlibProduct zlib) -> ZlibProduct
+    def with_wasi_vfs: (WasiVfsProduct wasi_vfs) -> WasiVfsProduct
+    def with_openssl: (OpenSSLProduct openssl) -> OpenSSLProduct
+    def dest_dir: -> String
+    def artifact: -> String
+    def extinit_obj: -> String
+    def extinit_c_erb: -> String
+    def baseruby_path: -> String
+    def configure_args: (String build_triple, Toolchain toolchain) -> Array[String]
+  end
+
+  class WitBindgen
+    @build_dir: String
+    @tool_dir: String
+    @revision: String
+
+    attr_reader bin_path: String
+    def initialize: (build_dir: String, ?revision: String) -> void
+    def install: -> void
+  end
+
+  class Toolchain
+    @tools: Hash[untyped, untyped]
+    @tools_cache: Hash[untyped, untyped]
+
+    attr_reader name: String
+    def initialize: -> void
+    def find_tool: (Symbol name) -> String
+    def check_envvar: (untyped name) -> void
+    def self.get: (String target, ?String? build_dir) -> (Toolchain)
+    def self.find_path: (String command) -> String?
+    def self.check_executable: (String command) -> String
+    def cc: -> String
+    def ranlib: -> String
+    def ld: -> String
+    def ar: -> String
+
+    def install: -> void
+  end
+
+  class WASISDK < Toolchain
+    @wasm_opt_path: String
+    @need_fetch_wasi_sdk: bool
+    @need_fetch_binaryen: bool
+    @tools: Hash[Symbol, String]
+    @wasi_sdk_path: String
+    @binaryen_version: Integer
+    @version_major: Integer
+    @version_minor: Integer
+    @binaryen_path: String
+
+    def initialize: (?String? wasi_sdk_path, ?build_dir: String?, ?version_major: Integer, ?version_minor: Integer, ?binaryen_version: Integer) -> void
+    def find_tool: (Symbol name) -> String
+    def wasm_opt: -> String
+    def wasi_sdk_path: -> String
+    def download_url: (Integer? version_major, Integer? version_minor) -> String
+    def binaryen_download_url: (Integer? version) -> String
+    def install_wasi_sdk: ->  void
+    def install_binaryen: ->  void
+  end
+
+  class Emscripten < Toolchain
+    @tools: Hash[Symbol, String]
+
+    def initialize: -> void
+    def find_tool: (Symbol name) -> String
+  end
+
+  class BuildExecutor
+    @verbose: bool
+    @github_actions_markup: bool
+    @process_count: Integer
+    @start_times: Hash[[Class, String], Time]
+
+    attr_reader process_count: Integer
+
+    def initialize: (?verbose: bool) -> void
+    def system: (*_ToS args, ?chdir: String?, ?env: Hash[String, String]?) -> void
+    def rm_rf: (FileUtils::pathlist list) -> void
+    def rm_f: (FileUtils::pathlist list) -> void
+    def cp_r: (FileUtils::pathlist src, path dest) -> void
+    def mv: (FileUtils::pathlist src, path dest) -> void
+    def mkdir_p: (FileUtils::pathlist list) -> void
+    def write: (String path, _ToS data) -> void
+
+    def begin_section: (Class klass, String name, String note) -> void
+    def end_section: (Class klass, String name) -> void
+
+    private def _print_command: (Array[_ToS] command, Hash[String, String]? env) -> void
+  end
+
+  class StatusPrinter
+    @mutex: Mutex
+    @counter: Integer
+    @indicators: String
+
+    def initialize: () -> void
+    def stdout: (String message) -> void
+    def stderr: (String message) -> void
+    def done: () -> void
+  end
+
+  class Downloader
+    def format_size: (Integer size) -> String
+
+    def download: (String url, String dest, String message) -> void
+  end
+
+  class BuildTask
+    @build_dir: String
+    @rubies_dir: String
+    @openssl: OpenSSLProduct
+
+    attr_accessor name: String
+    attr_reader source: BuildSource
+    attr_reader target: String
+    attr_reader toolchain: Toolchain
+    attr_reader libyaml: LibYAMLProduct
+    attr_reader zlib: ZlibProduct
+    attr_reader wasi_vfs: WasiVfsProduct
+    attr_reader baseruby: BaseRubyProduct
+    attr_reader crossruby: CrossRubyProduct
+    def initialize: (String name, target: String, src: untyped, ?toolchain: Toolchain?, ?build_dir: String?, ?rubies_dir: String?, **untyped) -> void
+    def hexdigest: -> String
+  end
+end

data/sig/ruby_wasm/cli.rbs

@@ -0,0 +1,27 @@
+module RubyWasm
+  class CLI
+    DEFAULT_RUBIES_DIR: string
+
+    @stdout: IO
+    @stderr: IO
+
+    def initialize: (stdout: IO, stderr: IO) -> void
+
+    def build: (Array[String] args) -> void
+    def pack: (Array[String] args) -> void
+
+    private
+
+    def build_config: (Hash[untyped, untyped] options) -> Hash[untyped, untyped]
+
+    def derive_packager: (Hash[untyped, untyped] options) -> Packager
+    def do_print_ruby_cache_key: (Packager) -> void
+    def do_build: (BuildExecutor, string tmpdir, Packager, Hash[untyped, untyped] options) -> void
+
+    def require_extension: () -> void
+  end
+
+  self.@logger: Logger?
+  def self.logger: () -> Logger
+  attr_accessor self.log_level: Symbol
+end

data/sig/ruby_wasm/ext.rbs

@@ -0,0 +1,13 @@
+module RubyWasmExt
+  def self.preinitialize: (Array[Integer] module_bytes) -> Array[Integer]
+
+  class WasiVfs
+    def initialize: () -> void
+
+    def self.run_cli: (Array[String] args) -> void
+
+    def map_dir: (String guest_path, String host_path) -> void
+
+    def pack: (Array[Integer] module_bytes) -> Array[Integer]
+  end
+end

data/sig/ruby_wasm/packager.rbs

@@ -0,0 +1,91 @@
+
+class RubyWasm::Packager
+  @definition: untyped
+  @config: Hash[untyped, untyped]
+
+  def initialize: (untyped?, Hash[untyped, untyped]?) -> void
+
+  def package: (RubyWasm::BuildExecutor, string dest_dir, untyped options) -> Array[Integer]
+
+  @ruby_core_build: RubyWasm::Packager::Core?
+  def ruby_core_build: () -> RubyWasm::Packager::Core
+
+  EXCLUDED_GEMS: Array[string]
+
+  def specs: () -> Array[untyped]
+  def support_dynamic_linking?: () -> bool
+
+  def root: () -> string
+
+  type build_source = Hash[Symbol, (String | Array[String])]
+  def self.build_source_aliases: (string root) -> Hash[string, build_source]
+
+  ALL_DEFAULT_EXTS: string
+
+  def build_options: () -> Hash[Symbol, untyped]
+  def full_build_options: () -> Hash[Symbol, untyped]
+
+  class Core
+    include RubyWasm::_Cacheable
+
+    @packager: RubyWasm::Packager
+    def initialize: (RubyWasm::Packager) -> void
+    def build: (RubyWasm::BuildExecutor, untyped options) -> String
+
+    extend Forwardable
+
+    def artifact: () -> string
+
+    private
+
+    @build_strategy: BuildStrategy?
+    def build_strategy: () -> BuildStrategy
+
+    class BuildStrategy
+      @packager: RubyWasm::Packager
+      def initialize: (RubyWasm::Packager) -> void
+      def build: (RubyWasm::BuildExecutor, untyped options) -> String
+      def specs_with_extensions: () -> Array[[untyped, Array[string]]]
+    end
+
+    class DynamicLinking < RubyWasm::Packager::Core::BuildStrategy
+    end
+
+    class StaticLinking < RubyWasm::Packager::Core::BuildStrategy
+      @build: RubyWasm::Build
+      def derive_build: () -> RubyWasm::Build
+      @user_exts: Array[RubyWasm::CrossRubyExtProduct]?
+      def user_exts: (RubyWasm::Build) -> Array[RubyWasm::CrossRubyExtProduct]
+
+      def name: () -> string
+    end
+  end
+
+  class FileSystem
+    @dest_dir: string
+    @packager: RubyWasm::Packager
+    @ruby_root: string
+
+    def initialize: (string dest_dir, RubyWasm::Packager) -> void
+    def package_ruby_root: (String tarball, RubyWasm::BuildExecutor) -> void
+    def remove_stdlib: (RubyWasm::BuildExecutor) -> void
+    def package_gems: () -> void
+
+    def setup_rb_content: () -> String
+
+    def remove_non_runtime_files: (RubyWasm::BuildExecutor) -> void
+
+    def bundle_dir: () -> String
+    def ruby_root: () -> string
+
+    private
+
+    def each_gem_content_path: () { (String, String) -> void } -> void
+    def each_gem_require_path: () { (String, String) -> void } -> void
+    def each_gem_extension_path: () { (String, String) -> void } -> void
+
+    def bundle_relative_path: () -> String
+    def ruby_version: () -> String
+    def rubyarchdir: () -> String
+  end
+end

data/sig/ruby_wasm/util.rbs

@@ -0,0 +1,5 @@
+module RubyWasm
+  module SizeFormatter
+    def self?.format: (Integer size) -> String
+  end
+end

data/tools/clang-format-diff.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+
+set -eo pipefail
+
+if [ -n "$1" ]; then
+  BASE_BRANCH="$1"
+elif [ -n "$GITHUB_EVENT_BEFORE" ] && [ "push" = "$GITHUB_EVENT_NAME" ]; then
+  BASE_BRANCH="$GITHUB_EVENT_BEFORE"
+elif [ -n "$GITHUB_BASE_REF" ]; then
+  BASE_BRANCH="origin/$GITHUB_BASE_REF"
+else
+  BASE_BRANCH="@{upstream}"
+fi
+
+MERGE_BASE=$(git merge-base $BASE_BRANCH HEAD)
+
+git diff -U0 --no-color $MERGE_BASE -- '*.c' '*.h' | clang-format-diff -i -p1
+exit $?

data/tools/exe/rbminify

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH << File.join(File.dirname(__FILE__), "../lib")
+
+require "syntax_tree"
+require "syntax_tree/cli"
+require "syntax_tree/minify_ruby"
+
+# Override the default formatter with our own.
+SyntaxTree.register_handler(".rb", SyntaxTree::MinifyRuby)
+
+exit(SyntaxTree::CLI.run(ARGV))

data/tools/lib/syntax_tree/minify_ruby.rb

@@ -0,0 +1,63 @@
+require "syntax_tree"
+
+module SyntaxTree
+  module MinifyRuby
+
+    # This is a required API for syntax tree which just delegates to SyntaxTree.parse.
+    def self.parse(source)
+      ::SyntaxTree.parse(source)
+    end
+
+    # This is the main entrypoint for the formatter. It parses the source,
+    # builds a formatter, then prints the result.
+    def self.format(source, _maxwidth = nil)
+      formatter = Formatter.new(source)
+      program = parse(source)
+      CommentStrippingVisitor.new.visit(program)
+      program.format(formatter)
+
+      formatter.flush
+      formatter.output.join
+    end
+
+    # This is a required API for syntax tree which just delegates to SyntaxTree.read.
+    def self.read(filepath)
+      ::SyntaxTree.read(filepath)
+    end
+
+    class CommentStrippingVisitor < SyntaxTree::Visitor
+      def visit(node)
+        if node and node.comments.any?
+          node.comments.clear
+        end
+        super(node)
+      end
+
+      def visit_statements(node)
+        node.body.delete_if { _1.is_a?(SyntaxTree::Comment) }
+        super(node)
+      end
+    end
+
+    class Formatter < SyntaxTree::Formatter
+      def initialize(source)
+        super(source, [], Float::INFINITY) do |n|
+          # This block, called `genspace`, is used to generate indentation for `n` depth.
+          ""
+        end
+      end
+
+      def breakable(
+        separator = " ",
+        _width = separator.length,
+        indent: nil,
+        force: nil
+      )
+        # Don't break when already broken
+        return if target.last.is_a?(PrettierPrint::BreakParent)
+        return if not force and separator == ""
+        super(separator, _width, indent: indent, force: force)
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,114 @@
+--- !ruby/object:Gem::Specification
+name: ruby_wasm
+version: !ruby/object:Gem::Version
+  version: 2.5.0
+platform: arm64-darwin
+authors:
+- Yuta Saito
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2024-01-28 00:00:00.000000000 Z
+dependencies: []
+description: Ruby to WebAssembly toolkit. This gem takes Ruby code and Gemfile, and
+  packages them with Ruby runtime into a WebAssembly binary.
+email:
+- kateinoigakukun@gmail.com
+executables:
+- rbwasm
+extensions: []
+extra_rdoc_files: []
+files:
+- ".clang-format"
+- CONTRIBUTING.md
+- Gemfile
+- LICENSE
+- NOTICE
+- README.md
+- Rakefile
+- Steepfile
+- benchmarks/vm_deep_call.rb
+- builders/wasm32-unknown-emscripten/Dockerfile
+- builders/wasm32-unknown-emscripten/entrypoint.sh
+- builders/wasm32-unknown-wasi/Dockerfile
+- builders/wasm32-unknown-wasi/entrypoint.sh
+- docs/api.md
+- docs/cheat_sheet.md
+- docs/faq.md
+- exe/rbwasm
+- ext/.gitignore
+- ext/README.md
+- ext/extinit.c.erb
+- lib/ruby_wasm.rb
+- lib/ruby_wasm/3.0/ruby_wasm.bundle
+- lib/ruby_wasm/3.1/ruby_wasm.bundle
+- lib/ruby_wasm/3.2/ruby_wasm.bundle
+- lib/ruby_wasm/build.rb
+- lib/ruby_wasm/build/build_params.rb
+- lib/ruby_wasm/build/downloader.rb
+- lib/ruby_wasm/build/executor.rb
+- lib/ruby_wasm/build/product.rb
+- lib/ruby_wasm/build/product/baseruby.rb
+- lib/ruby_wasm/build/product/crossruby.rb
+- lib/ruby_wasm/build/product/libyaml.rb
+- lib/ruby_wasm/build/product/openssl.rb
+- lib/ruby_wasm/build/product/product.rb
+- lib/ruby_wasm/build/product/ruby_source.rb
+- lib/ruby_wasm/build/product/wasi_vfs.rb
+- lib/ruby_wasm/build/product/zlib.rb
+- lib/ruby_wasm/build/toolchain.rb
+- lib/ruby_wasm/build/toolchain/wit_bindgen.rb
+- lib/ruby_wasm/cli.rb
+- lib/ruby_wasm/packager.rb
+- lib/ruby_wasm/packager/core.rb
+- lib/ruby_wasm/packager/file_system.rb
+- lib/ruby_wasm/rake_task.rb
+- lib/ruby_wasm/util.rb
+- lib/ruby_wasm/version.rb
+- package-lock.json
+- package.json
+- rakelib/check.rake
+- rakelib/ci.rake
+- rakelib/doc.rake
+- rakelib/format.rake
+- rakelib/gem.rake
+- rakelib/packaging.rake
+- rakelib/version.rake
+- sig/open_uri.rbs
+- sig/ruby_wasm/build.rbs
+- sig/ruby_wasm/cli.rbs
+- sig/ruby_wasm/ext.rbs
+- sig/ruby_wasm/packager.rbs
+- sig/ruby_wasm/util.rbs
+- tools/clang-format-diff.sh
+- tools/exe/rbminify
+- tools/lib/syntax_tree/minify_ruby.rb
+homepage: https://github.com/ruby/ruby.wasm
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/ruby/ruby.wasm
+  source_code_uri: https://github.com/ruby/ruby.wasm
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: 3.3.dev
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.4
+signing_key: 
+specification_version: 4
+summary: Ruby to WebAssembly toolkit
+test_files: []