coreutils-wasm 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a271d6f528a786685d21a08bd7f54d8004a98ddc879a1aa238e0a3cec7abe470
+  data.tar.gz: e4e9b233ee13a2d2ab4bb771a638fb08d633a017ec9aab87f9b329d7025c9da2
+SHA512:
+  metadata.gz: b4f1c045e53050c8a445fd30320e77ed0ebfb058d10a633e42ed2a2d67f8ed9dd887a0f3f29e2a9194e1f71a7f532dace6c37e21b4c9ac3937b7e7c6b301115a
+  data.tar.gz: b46ed7493b0e048c46482fdea77d413fd35e2b9af7cba6719982cafcf1af60146ebc84274aa8b184c7afaa1e7f62ec72f486f8fd861011dbe46cb7c884fc440f

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nathan Himpens
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,145 @@
+# CoreutilsWasm
+
+GNU Coreutils compiled to WebAssembly.
+
+This gem provides the WASM binary for GNU coreutils. It includes 100+ commands like `ls`, `cat`, `head`, `tail`, `wc`, `cp`, `mv`, `rm`, etc.
+
+**This gem only provides the WASM binary.** You choose how to run it with your preferred WebAssembly runtime.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'coreutils-wasm'
+```
+
+And then execute:
+
+```bash
+bundle install
+```
+
+Or install it yourself:
+
+```bash
+gem install coreutils-wasm
+```
+
+## Usage
+
+### Get the WASM binary path or bytes
+
+```ruby
+require 'coreutils_wasm'
+
+# Get the file path (useful for CLI runtimes)
+wasm_path = CoreutilsWasm.wasm_path
+# => "/path/to/gems/coreutils-wasm-1.0.0/wasm/coreutils.wasm"
+
+# Get as binary string
+wasm_bytes = CoreutilsWasm.wasm_bytes
+
+# Get file size
+wasm_size = CoreutilsWasm.wasm_size
+# => 4705003
+
+# Check if file exists
+CoreutilsWasm.wasm_exists?
+# => true
+```
+
+### List available commands
+
+```ruby
+CoreutilsWasm.commands
+# => ["arch", "base32", "base64", "basename", "cat", "chmod", "cp", "ls", ...]
+```
+
+## Running with different runtimes
+
+### With Wasmer CLI
+
+```bash
+# Install wasmer
+curl https://get.wasmer.io -sSfL | sh
+
+# Run a command
+wasmer run $(ruby -r coreutils_wasm -e "puts CoreutilsWasm.wasm_path") -- ls -la
+```
+
+### With Wasmtime CLI
+
+```bash
+# Install wasmtime
+curl https://wasmtime.dev/install.sh -sSf | bash
+
+# Run a command
+wasmtime $(ruby -r coreutils_wasm -e "puts CoreutilsWasm.wasm_path") -- ls -la
+```
+
+### With wasmer gem (Ruby runtime)
+
+```ruby
+require 'wasmer'
+require 'coreutils_wasm'
+
+# Load the WASM binary
+wasm_bytes = CoreutilsWasm.wasm_bytes
+store = Wasmer::Store.new
+module_ = Wasmer::Module.new store, wasm_bytes
+
+# Create WASI environment
+wasi_env = Wasmer::Wasi::StateBuilder.new("ls")
+  .argument("-la")
+  .preopen_directory(".")
+  .finalize
+
+# Instantiate with WASI imports
+import_object = wasi_env.generate_import_object(store, module_)
+instance = Wasmer::Instance.new(module_, import_object)
+
+# Run
+wasi_env.start(instance)
+```
+
+### With shell execution
+
+```ruby
+require 'coreutils_wasm'
+
+# Simple shell execution with wasmer
+def run_coreutils(command, *args)
+  wasm = CoreutilsWasm.wasm_path
+  `wasmer run #{wasm} -- #{command} #{args.join(' ')}`
+end
+
+puts run_coreutils('ls', '-la')
+puts run_coreutils('cat', 'Gemfile')
+```
+
+## Available Commands
+
+This binary includes all GNU coreutils commands:
+
+`arch`, `base32`, `base64`, `baseenc`, `basename`, `cat`, `chcon`, `chgrp`, `chmod`, `chown`, `chroot`, `cksum`, `comm`, `cp`, `csplit`, `cut`, `date`, `dd`, `df`, `dircolors`, `dirname`, `du`, `echo`, `env`, `expand`, `expr`, `factor`, `false`, `fmt`, `fold`, `groups`, `hashsum`, `head`, `hostid`, `hostname`, `id`, `install`, `join`, `kill`, `link`, `ln`, `logname`, `ls`, `mkdir`, `mkfifo`, `mknod`, `mktemp`, `more`, `mv`, `nice`, `nl`, `nohup`, `nproc`, `numfmt`, `od`, `paste`, `pathchk`, `pinky`, `pr`, `printenv`, `printf`, `ptx`, `pwd`, `readlink`, `realpath`, `relpath`, `rm`, `rmdir`, `runcon`, `seq`, `shred`, `shuf`, `sleep`, `sort`, `split`, `stat`, `stdbuf`, `sum`, `sync`, `tac`, `tail`, `tee`, `test`, `timeout`, `touch`, `tr`, `true`, `truncate`, `tsort`, `tty`, `uname`, `unexpand`, `uniq`, `unlink`, `uptime`, `users`, `wc`, `who`, `whoami`, `yes`
+
+**Note:** `grep` is not included as it's not part of GNU coreutils.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/NathanHimpens/coreutils-wasm.
+
+## License
+
+MIT
+
+## Credits
+
+- [GNU Coreutils](https://www.gnu.org/software/coreutils/)
+- [uutils/coreutils](https://github.com/uutils/coreutils) - Rust implementation compiled to WASM
+- [Wasmer](https://wasmer.io/) - Original WASM package source

data/lib/coreutils_wasm/commands.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CoreutilsWasm
+  module Commands
+    # All available coreutils commands
+    ALL = %w[
+      arch base32 base64 baseenc basename cat chcon chgrp chmod chown chroot
+      cksum comm cp csplit cut date dd df dircolors dirname du echo env expand
+      expr factor false fmt fold groups hashsum head hostid hostname id install
+      join kill link ln logname ls mkdir mkfifo mknod mktemp more mv nice nl
+      nohup nproc numfmt od paste pathchk pinky pr printenv printf ptx pwd
+      readlink realpath relpath rm rmdir runcon seq shred shuf sleep sort split
+      stat stdbuf sum sync tac tail tee test timeout touch tr true truncate
+      tsort tty uname unexpand uniq unlink uptime users wc who whoami yes
+    ].freeze
+  end
+end

data/lib/coreutils_wasm/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module CoreutilsWasm
+  VERSION = "1.0.0"
+end

data/lib/coreutils_wasm.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require_relative "coreutils_wasm/version"
+require_relative "coreutils_wasm/commands"
+
+# CoreutilsWasm provides GNU coreutils WASM binaries
+#
+# This gem only provides the WASM binary. You choose how to run it
+# with your preferred WebAssembly runtime (wasmer, wasmtime, etc.)
+module CoreutilsWasm
+  class Error < StandardError; end
+
+  class << self
+    # Get the absolute path to the coreutils WASM binary
+    # @return [String] Absolute path to coreutils.wasm
+    def wasm_path
+      @wasm_path ||= File.expand_path("../wasm/coreutils.wasm", __dir__)
+    end
+
+    # Get the raw WASM binary as a string of bytes
+    # @return [String] Binary string containing the WASM binary
+    def wasm_bytes
+      File.binread(wasm_path)
+    end
+
+    # Get the WASM file size in bytes
+    # @return [Integer] Size in bytes
+    def wasm_size
+      File.size(wasm_path)
+    end
+
+    # Check if the WASM binary exists
+    # @return [Boolean]
+    def wasm_exists?
+      File.exist?(wasm_path)
+    end
+
+    # List of all available commands in this binary
+    # @return [Array<String>]
+    def commands
+      Commands::ALL
+    end
+  end
+end

metadata

@@ -0,0 +1,106 @@
+--- !ruby/object:Gem::Specification
+name: coreutils-wasm
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Nathan Himpens
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description: Provides GNU coreutils commands (ls, cat, head, tail, wc, etc.) running
+  in a WebAssembly sandbox via Wasmer CLI.
+email:
+- nathan@example.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/coreutils_wasm.rb
+- lib/coreutils_wasm/commands.rb
+- lib/coreutils_wasm/version.rb
+- wasm/coreutils.wasm
+homepage: https://github.com/NathanHimpens/coreutils-wasm
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/NathanHimpens/coreutils-wasm
+  source_code_uri: https://github.com/NathanHimpens/coreutils-wasm
+  changelog_uri: https://github.com/NathanHimpens/coreutils-wasm/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: GNU Coreutils compiled to WebAssembly for Ruby
+test_files: []