ruby_wasm 2.5.1-aarch64-linux-musl

data/sig/ruby_wasm/build.rbs

@@ -0,0 +1,327 @@
+module RubyWasm
+  VERSION: String
+
+  interface _Cacheable
+    def cache_key: (Digest::SHA256 digest) -> void
+  end
+
+  class Target
+    include _Cacheable
+
+    @triple: String
+    @pic: bool
+
+    attr_reader triple: String
+
+    def initialize: (String triple, ?pic: bool) -> void
+    def pic?: -> bool
+  end
+
+  class Build
+    include _Cacheable
+
+    @target: Target
+    @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: Target,
+      src: Packager::build_source,
+      toolchain: Toolchain?,
+      build_dir: string,
+      rubies_dir: string,
+      ?wasi_vfs: :default | WasiVfsProduct?,
+      **untyped
+    ) -> void
+    def crossruby: () -> CrossRubyProduct
+  end
+
+  class BuildParams
+    attr_accessor name: String
+    attr_accessor target: Target
+    attr_accessor default_exts: String
+
+    def initialize: (name: string, target: Target, default_exts: string) -> void
+  end
+
+  class BuildProduct
+    def name: -> String
+  end
+
+  class AutoconfProduct < BuildProduct
+    @target: Target
+    @toolchain: Toolchain
+
+    def initialize: (Target 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: Target
+    def initialize: (String build_dir, Target 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: Target
+    def initialize: (String build_dir, Target 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: Target
+    def initialize: (String build_dir, Target 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
+
+    private def do_legacy_extconf: (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 target: Target
+    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 need_exts_build?: -> bool
+    def need_extinit_obj?: -> bool
+    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: (Target 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 ln_s: (String src, String dest) -> 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: Build
+    attr_accessor name: String
+
+    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,51 @@
+module RubyWasm
+  class CLI
+    type cli_options = {
+      print_ruby_cache_key: bool,
+      save_temps: bool,
+      output: String,
+
+      optimize: bool,
+      remake: bool,
+      reconfigure: bool,
+      clean: bool,
+
+      ruby_version: String,
+      target_triplet: String,
+      profile: String,
+      stdlib: bool,
+      disable_gems: bool,
+      gemfile: String?,
+      patches: Array[String],
+      format: String,
+    }
+
+    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: (cli_options options) -> Packager::build_config
+    def compute_build_source: (cli_options options) -> Packager::build_source
+    def self.build_source_aliases: (string root) -> Hash[string, Packager::build_source]
+    def self.bundled_patches_path: () -> string
+    def root: () -> string
+
+    def derive_packager: (cli_options options) -> Packager
+    def do_print_ruby_cache_key: (Packager) -> void
+    def do_build: (BuildExecutor, string tmpdir, Packager, cli_options 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,26 @@
+module RubyWasmExt
+  type bytes = String
+
+  def self.preinitialize: (bytes module_bytes) -> bytes
+
+  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: (bytes module_bytes) -> bytes
+  end
+
+  class ComponentLink
+    def initialize: () -> void
+    def library: (String name, bytes module, bool dl_openable) -> void
+    def adapter: (String name, bytes module) -> void
+    def validate: (bool) -> void
+    def stack_size: (Integer) -> void
+    def stub_missing_functions: (bool) -> void
+    def use_built_in_libdl: (bool) -> void
+    def encode: () -> bytes
+  end
+end

data/sig/ruby_wasm/packager.rbs

@@ -0,0 +1,122 @@
+
+class RubyWasm::Packager
+  type build_source_github = {
+    type: "github",
+    repo: String,
+    rev: String,
+  }
+  type build_source_tarball = {
+    type: "tarball",
+    url: String,
+  }
+  type build_source_local = {
+    type: "local",
+    path: String,
+  }
+  type build_source = (build_source_github | build_source_tarball | build_source_local) & {
+    name: string,
+    patches: Array[String],
+  }
+
+  type build_config = Hash[untyped, untyped]
+
+  type bytes = String
+
+  @definition: untyped
+  @config: build_config
+
+  def initialize: (string root, build_config?, untyped? definition) -> void
+
+  def package: (RubyWasm::BuildExecutor, string dest_dir, untyped options) -> bytes
+
+  @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
+
+  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
+    def build_and_link_exts: (RubyWasm::BuildExecutor) -> bytes
+
+    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]]]
+      def build_and_link_exts: (RubyWasm::BuildExecutor) -> bytes
+    end
+
+    class DynamicLinking < RubyWasm::Packager::Core::BuildStrategy
+      @build: RubyWasm::Build
+      def derive_build: () -> RubyWasm::Build
+      def build_exts: (RubyWasm::BuildExecutor, RubyWasm::Build) -> void
+      def name: () -> string
+
+      private def link_exts: (RubyWasm::BuildExecutor, RubyWasm::Build) -> bytes
+    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
+
+  module ComponentAdapter
+    def self.wasi_snapshot_preview1: (String exec_model) -> 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