tebako 0.5.0

data/Gemfile

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2023 [Ribose Inc](https://www.ribose.com).
+# All rights reserved.
+# This file is a part of tebako
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+# 1. Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright
+#    notice, this list of conditions and the following disclaimer in the
+#    documentation and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS
+# BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in tebako.gemspec
+gemspec
+gem "hoe"
+gem "minitest"
+gem "rubocop", "~> 1.52"
+gem "rubocop-rubycw"

data/README.adoc

@@ -0,0 +1,389 @@
+= Tebako: an image packager
+
+image:https://github.com/tamatebako/tebako/actions/workflows/ubuntu.yml/badge.svg["Ubuntu amd64", link="https://github.com/tamatebako/tebako/actions/workflows/ubuntu.yml"]
+image:https://github.com/tamatebako/tebako/actions/workflows/alpine.yml/badge.svg["Alpine", link="https://github.com/tamatebako/tebako/actions/workflows/alpine.yml"]
+image:https://github.com/tamatebako/tebako/actions/workflows/macos.yml/badge.svg["MacOS amd64", link="https://github.com/tamatebako/tebako/actions/workflows/macos.yml"]
+image:https://github.com/tamatebako/tebako/actions/workflows/lint.yml/badge.svg["lint", link="https://github.com/tamatebako/tebako/actions/workflows/lint.yml"]
+
+image:https://api.cirrus-ci.com/github/tamatebako/tebako.svg?branch=main&task=ubuntu-aarch64["Ubuntu aarch64", link="https://cirrus-ci.com/github/tamatebako/tebako"]
+image:https://api.cirrus-ci.com/github/tamatebako/tebako.svg?branch=main&task=macos-arm64["MacOS arm64", link="https://cirrus-ci.com/github/tamatebako/tebako"]
+
+== Purpose
+
+Tebako is an executable packager. It packages a set of files into a DwarFS file
+system for read-only purposes.
+
+After packaging the file system into an image, Tebako produces a single
+executable binary that allows the user to execute a selected file from the
+packaged software from a point in the file system.
+
+The packaged binary should support:
+
+* Packaging a default DwarFS image inside the binary
+* Support signing of the binary on macOS (via notarization)
+
+In the future:
+
+* Downloading new DwarFS images to be stored in the local home directory
+* Allowing loading multiple DwarFS images in a stacked way
+* Supporting a COW mechanism that the newly written files are stored
+  in a separate image that can be loaded on top of the read-only file systems.
+
+== Supported platforms
+
+The Tebako packager is tested on the following platforms:
+
+* Linux: Ubuntu 20.04; Alpine 3.16
+* macOS: macOS 11.0 (Monterey)
+* Windows: TBD
+
+== Supported Ruby versions
+
+The Tebako packager supports the following versions of Ruby for packaging:
+* 2.7.7
+* 3.0.6
+* 3.1.4
+
+Support of specific version including minor release requires some effort, sometimes extensive
+but our goal is to be able to package all maintained Ruby releases.
+
+== Prerequisites
+
+=== Ubuntu
+
+==== GNU C/C++ 9+ or Clang C/C++ 11+
+
+==== CMake version 3.20+
+
+Tebako relies on CMake 3.20+, which may not be available as a default package.
+
+If it is not available as default package it can be set up as follows:
+
+[source,sh]
+----
+apt-get remove --purge --auto-remove cmake
+apt-get update
+apt-get install -y software-properties-common lsb-release curl
+apt-get clean all
+curl https://apt.kitware.com/kitware-archive.sh | bash
+apt-get install cmake
+----
+
+==== Other development tools and libraries
+
+[source,sh]
+----
+apt-get install -y curl git ruby ruby-dev pkg-config bison flex make autoconf
+apt-get install -y binutils-dev libarchive-dev libevent-dev libjemalloc-dev acl-dev \
+  libdouble-conversion-dev libiberty-dev liblz4-dev liblzma-dev libssl-dev \
+  libboost-context-dev libboost-filesystem-dev libboost-program-options-dev \
+  libboost-regex-dev libboost-system-dev libboost-thread-dev \
+  libunwind-dev libdwarf-dev libelf-dev libfuse-dev libgoogle-glog-dev \
+  libffi-dev libgdbm-dev libyaml-dev libncurses-dev libreadline-dev \
+  libfmt-dev
+----
+
+
+== Installation
+
+=== General
+
+Just clone this repository, install Ruby bundle and run `tebako setup` as follows.
+
+[source,sh]
+----
+git clone https://github.com/tamatebako/tebako
+bundle install
+tebako/exe/tebako setup
+----
+
+=== Quick setup on Ubuntu 20.04 on Docker
+
+Launch a container on the target platform:
+
+[source,sh]
+----
+# For x86_64
+docker run -it --platform linux/x86_64 ubuntu bash
+
+# For Apple M1
+docker run -it --platform linux/aarch64 ubuntu bash
+----
+
+In the container:
+
+[source,sh]
+----
+export DEBIAN_FRONTEND=noninteractive
+export TZ=Etc/UTC
+
+apt-get update
+apt-get install -y software-properties-common
+add-apt-repository -y ppa:ubuntu-toolchain-r/test
+apt-get install -y gcc-9 g++-9
+
+update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-9 100 --slave /usr/bin/g++ g++ /usr/bin/g++-9 --slave /usr/bin/gcov gcov /usr/bin/gcov-9
+update-alternatives --set gcc /usr/bin/gcc-9
+
+apt-get install -y curl git ruby ruby-dev pkg-config bison flex make autoconf
+curl https://apt.kitware.com/kitware-archive.sh | bash
+apt-get install -y cmake
+
+apt-get install -y binutils-dev libarchive-dev libevent-dev libjemalloc-dev acl-dev \
+  libdouble-conversion-dev libiberty-dev liblz4-dev liblzma-dev libssl-dev \
+  libboost-context-dev libboost-filesystem-dev libboost-program-options-dev \
+  libboost-regex-dev libboost-system-dev libboost-thread-dev \
+  libunwind-dev libdwarf-dev libelf-dev libfuse-dev libgoogle-glog-dev \
+  libffi-dev libgdbm-dev libyaml-dev libncurses-dev libreadline-dev \
+  libsqlite3-dev
+
+apt-get install -y libfmt-dev
+
+git clone https://github.com/tamatebako/tebako
+bundle install
+tebako/exe/tebako setup
+----
+
+== Usage
+
+=== Commands
+
+==== Installation
+
+[source,sh]
+----
+gem install tebako
+----
+
+==== Press
+
+This command "presses" a Ruby project using the Tebako setup from the Tebako root
+folder (`<tebako-root-folder>`).
+Please note that upon the first invocation of press command tebako collects required packages,
+builds the and creates packaging environment. This is a lengthly task that can take significant
+time, up to 1 hour.
+Upon the next invocation tebako will use previously created packaging environment. The press process
+itself takes minutes.
+You can manage setup of packaging environment manually; please refer to description of setup and clean
+cmmands below.
+
+[source,sh]
+----
+<install-folder>/exe/tebako press     \
+  [-p |--prefix=<tebako-root-folder>] \
+  [-R | --Ruby=<2.7.7|3.0.6|3.1.4>]   \
+  -r|--root=<project-root-folder>     \
+  -e|--entry-point=<entry-point>      \
+  [-o |--output=<packaged file name>] \
+  [-l|--log-level=<error|warn|debug|trace>]
+----
+
+Where:
+
+* `<tebako-root-folder>`, the Tebako setup folder (optional, defaults to current
+folder)
+
+* `Ruby` parameter defines Ruby version that will be packaged (optional, defaults to 3.0.6)
+
+* `<project-root>`, a folder at the host source file system where project files
+are located
+
+* `<entry-point>`, an executable file (binary executable or script) that shall
+be started when packaged file is called
+
+* `output`, the output file name (optional, defaults to `<current folder>/<entry
+point base name`)
+
+* `log-level`, the logging level for tebako built-in memory filesystem driver (optional, defaults to `error`)
+
+[example]
+====
+[source,sh]
+----
+exe/tebako press \
+  --root='~/projects/myproject' \
+  --entry=start.rb \
+  --output=/temp/myproject.tebako
+----
+====
+
+==== Setup
+
+Collects required packages, builds the and creates packaging environment. This is a lengthly
+task that can take significant time, up to 1 hour.
+Tebako supports several configurations at a single system given that their root
+directories differ and nultiple Ruby versions within single configuration
+
+This command is optional, tebako creates packaging environment automatically upon the first
+invocation of press command.
+
+[source,sh]
+----
+<install-folder>/exe/tebako setup     \
+  [-p |--prefix=<tebako-root-folder>] \
+  [-R | --Ruby=<2.7.7|3.0.6|3.1.4>]
+----
+
+Where:
+
+* `<tebako-root-folder>`, the Tebako setup folder (optional, defaults to current
+folder)
+
+* `Ruby` parameter defines Ruby version that will be packaged (optional, defaults to 3.0.6)
+
+
+
+==== Clean
+
+This command deletes tebako artifacts created by setup and press commands.
+Normally you do not need to do it since tebako packager optimizes artifacts lifecycle on its own.
+
+[source,sh]
+----
+exe/tebako press \
+  [-p |--prefix=<tebako-root-folder>]
+----
+
+Where:
+
+* `<tebako-root-folder>`, the Tebako setup folder (optional, defaults to current
+folder)
+
+[example]
+====
+[source,sh]
+----
+exe/tebako clean --root='~/projects/myproject'
+----
+====
+
+=== Exit codes
+
+[cols,"a,a"]
+|===
+| Code | Condition
+
+| 0    | No error
+| 1    | Invalid command line
+| 101  | `tebako setup` failed at configuration step
+| 102  | `tebako setup` failed at build step
+| 103  | `tebako press` failed at configuration step
+| 104  | `tebako press` failed at build step
+| 253  | Unsupported Ruby version
+| 254  | Unsupported operating systems
+| 255  | Internal error
+
+|===
+
+== Image extraction
+
+Tebako provides an option to an extract filesystem from a package to local
+folder for verification or execution.
+
+[source,sh]
+----
+<tebako-packaged-executable> --tebako-extract [<root folder for extracted filesystem>]
+----
+
+Where,
+
+* `<root folder for extracted filesystem>` is optional and defaults to
+  `source_filesystem`
+
+[example]
+====
+Extracting Tebako content from the `metanorma` package:
+
+[source,sh]
+----
+metanorma --tebako-extract temp-image
+----
+====
+
+The `--tebako-extract` option actually runs the following Ruby script:
+
+[source,ruby]
+----
+require 'fileutils'
+FileUtils.copy_entry '<in-memory filesystem root>', ARGV[2] || 'source_filesystem'
+----
+
+== Ruby packaging specification
+
+This is high-level description of the Tebako Ruby packaging mechanism.
+This specification was inspired by the `ruby-packer` approach.
+
+NOTE: For various reasons, Tebako Ruby is a fully separate implementation,
+no line of code was copied from `ruby-packer`.
+
+Depending on the configuration files that are present in the root project folder,
+the Tebako Ruby packager support five different scenarios:
+
+[cols="a,a,a,a"]
+|===
+| Scenario | `*.gemspec` | `Gemfile`  | `*.gem`
+
+| 1        |     No    |   No     |   No
+| 2        |     No    |   No     |   One
+| 3        |    One    |   No     |   Any
+| 4        |    One    |   One    |   Any
+| 5        |     No    |   One    |   Any
+| Error    |     No    |   No     |Two or more
+| Error    |Two or more|   Any    |   Any
+
+|===
+
+These scenarios differ in what files are packaged and where the entry point is
+located, as follows:
+
+[cols="a,a,a,a"]
+|===
+| Scenario | Description | Packaging | Entry point
+
+| 1
+| Simple ruby script
+| Copy `<project-root>` with all sub-folders to packaged filesystem
+| `<mount_point>/local/<entry_point base name>`
+
+| 2
+| Packaged gem
+| Install the gem with `gem install` to packaged filesystem
+| `<mount_point>/bin/<entry_point base name>` (i.e., binstub is expected)
+
+| 3
+| Gem source, no `bundler`
+|
+. Build the gem using `gem build` command at the host
+. Install it with `gem install` to packaged filesystem
+
+| `<mount_point>/bin/<entry_point base name>` (i.e., binstub is expected)
+
+| 4
+| Gem source, `bundler`
+|
+. Collect dependencies at the host with `bundle install`
+. Build the gem using `gem build` command
+. Install it with `gem install` to packaged file system
+
+| `<mount_point>/bin/<entry_point base name>` (i.e., binstub is expected)
+
+| 5
+| Rails project
+| Deploy project to packaged filesystem using `bundle install`
+| `<mount_point>/local/<entry_point base name>`
+
+|===
+
+
+== Trivia: origin of name
+
+"tamatebako" (玉手箱) is the treasure box given to Urashima Taro in the Ryugu,
+for which he was asked not to open if he wished to return. He opened the box
+upon the shock from his return that three hundred years has passed. Apparently
+what was stored in the box was his age.
+
+This packager was made to store Ruby and its gems, and therefore named after
+the said treasure box (storing gems inside a treasure box).
+
+Since "tamatebako" is rather long for the non-Japanese speaker, we use "tebako"
+(手箱, also "tehako") instead, the generic term for a personal box.

data/Rakefile

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2023 [Ribose Inc](https://www.ribose.com).
+# All rights reserved.
+# This file is a part of tebako
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+# 1. Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright
+#    notice, this list of conditions and the following disclaimer in the
+#    documentation and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS
+# BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+require "bundler/gem_tasks"
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[rubocop]

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "tebako"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/cmake/copy_dir.cmake

@@ -0,0 +1,29 @@
+# Copyright (c) 2021, [Ribose Inc](https://www.ribose.com).
+# All rights reserved.
+# This file is a part of tebako
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+# 1. Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright
+#    notice, this list of conditions and the following disclaimer in the
+#    documentation and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS
+# BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+# https://cmake.org/Bug/view.php?id=13204
+# note the trailing slash after ${SOURCE_DIR}
+
+file (COPY "${SOURCE_DIR}/" DESTINATION "${TARGET_DIR}")

data/cmake/def_tty_colours.cmake

@@ -0,0 +1,19 @@
+if(NOT WIN32)
+  string(ASCII 27 Escape)
+  set(ColourReset       "${Escape}[m")
+  set(ColourBold        "${Escape}[1m")
+  set(ColourRed         "${Escape}[31m")
+  set(ColourGreen       "${Escape}[32m")
+  set(ColourYellow      "${Escape}[33m")
+  set(ColourBlue        "${Escape}[34m")
+  set(ColourMagenta     "${Escape}[35m")
+  set(ColourCyan        "${Escape}[36m")
+  set(ColourWhite       "${Escape}[37m")
+  set(ColourBoldRed     "${Escape}[1;31m")
+  set(ColourBoldGreen   "${Escape}[1;32m")
+  set(ColourBoldYellow  "${Escape}[1;33m")
+  set(ColourBoldBlue    "${Escape}[1;34m")
+  set(ColourBoldMagenta "${Escape}[1;35m")
+  set(ColourBoldCyan    "${Escape}[1;36m")
+  set(ColourBoldWhite   "${Escape}[1;37m")
+endif()

data/common.env

@@ -0,0 +1,6 @@
+BUILD_TYPE=Release
+DEPS=deps
+INCBIN_TAG=348e36b
+DWARFS_WR_TAG=v0.3.4
+BUNDLER_VER=2.3.22
+RUBY_VER=3.0.6

data/exe/tebako

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Copyright (c) 2023 [Ribose Inc](https://www.ribose.com).
+# All rights reserved.
+# This file is a part of tebako
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+# 1. Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright
+#    notice, this list of conditions and the following disclaimer in the
+#    documentation and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS
+# BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+require_relative "../lib/cli"
+
+Tebako::TebakoCli.start

data/include/tebako/tebako-fs.h

@@ -0,0 +1,40 @@
+/**
+ *
+ * Copyright (c) 2021, [Ribose Inc](https://www.ribose.com).
+ * All rights reserved.
+ * This file is a part of tebako
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+ * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS
+ * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ */
+
+#pragma once
+
+#include <incbin/incbin.h>
+
+INCBIN_EXTERN(fs);
+
+namespace tebako {
+	extern const char* fs_log_level;
+	extern const char* fs_mount_point;
+	extern const char* fs_entry_point;
+}

data/include/tebako/tebako-main.h

@@ -0,0 +1,40 @@
+/**
+ *
+ * Copyright (c) 2021, [Ribose Inc](https://www.ribose.com).
+ * All rights reserved.
+ * This file is a part of tebako
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+ * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS
+ * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ */
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+	int tebako_main(int* argc, char*** argv);
+	const char* tebako_mount_point(void);
+#ifdef RB_W32
+	int tebako_file_load_ok(const char *path);
+#endif
+#ifdef __cplusplus
+}
+#endif

data/lib/cli.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2023 [Ribose Inc](https://www.ribose.com).
+# All rights reserved.
+# This file is a part of tebako
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+# 1. Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright
+#    notice, this list of conditions and the following disclaimer in the
+#    documentation and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS
+# BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+require_relative "tebako/cli"