xaba 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0a4a201394557976db4185f74720f9d5fbe0a3f6d5ba46d5d915293fc9e2a79a
+  data.tar.gz: 7d47f78b0a26305abd7aa7537dfbe81e28a145847656bb0ae2a5eb7d8d6830ba
+SHA512:
+  metadata.gz: 5da843576b823b0e7eef843a1e230c78c42be8910f5955e470137b98132eccd9bbc6b807d36020c3b0617890279b22b17555209d8a91244f8fadf66fb87af49a
+  data.tar.gz: c0ba45f8f366439ba38db54038ad4e0a180e3b222462ed21a7d2b5a06c67349c2a938640ce90e576d88d4e1f01ec17295f4c0d23dd9f550372ad6b354ace9c08

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,64 @@
+require:
+  - rubocop-rspec
+  - rubocop-rake
+
+AllCops:
+  TargetRubyVersion: 2.7
+  NewCops: enable
+
+Style/StringLiterals:
+  Enabled: true
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  Enabled: true
+  EnforcedStyle: double_quotes
+
+Style/Documentation:
+  Enabled: false
+
+Style/FormatString:
+  Enabled: false
+
+Style/FormatStringToken:
+  Enabled: false
+
+Style/MultilineBlockChain:
+  Enabled: false
+
+Metrics/AbcSize:
+  Enabled: false
+
+Metrics/BlockLength:
+  Enabled: false
+
+Metrics/ClassLength:
+  Enabled: false
+
+Metrics/CyclomaticComplexity:
+  Enabled: false
+
+Metrics/MethodLength:
+  Enabled: false
+
+Metrics/PerceivedComplexity:
+  Enabled: false
+
+Naming/MethodParameterName:
+  Enabled: false
+
+Layout/LineLength:
+  Max: 120
+
+RSpec/ContextWording:
+  Enabled: false
+
+RSpec/DescribeClass:
+  Enabled: false
+
+RSpec/ExampleLength:
+  Enabled: false
+
+RSpec/MultipleExpectations:
+  Enabled: false
+

data/Gemfile

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in xaba.gemspec
+gemspec
+
+group :development, :test do
+  gem "rake", "~> 13.0"
+  gem "rspec", "~> 3.0"
+  gem "rubocop", "~> 1.21"
+  gem "rubocop-rake", "~> 0.6.0"
+  gem "rubocop-rspec", "~> 2.26"
+end

data/Gemfile.lock

@@ -0,0 +1,79 @@
+PATH
+  remote: .
+  specs:
+    xaba (0.1.0)
+      extlz4 (~> 0.3.4)
+      iostruct (~> 0.0.5)
+      xxhash (~> 0.5.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.2)
+    diff-lcs (1.5.0)
+    extlz4 (0.3.4)
+    iostruct (0.0.5)
+    json (2.7.1)
+    language_server-protocol (3.17.0.3)
+    parallel (1.24.0)
+    parser (3.3.0.4)
+      ast (~> 2.4.1)
+      racc
+    racc (1.7.3)
+    rainbow (3.1.1)
+    rake (13.1.0)
+    regexp_parser (2.9.0)
+    rexml (3.2.6)
+    rspec (3.12.0)
+      rspec-core (~> 3.12.0)
+      rspec-expectations (~> 3.12.0)
+      rspec-mocks (~> 3.12.0)
+    rspec-core (3.12.2)
+      rspec-support (~> 3.12.0)
+    rspec-expectations (3.12.3)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-mocks (3.12.6)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-support (3.12.1)
+    rubocop (1.60.1)
+      json (~> 2.3)
+      language_server-protocol (>= 3.17.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.30.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.30.0)
+      parser (>= 3.2.1.0)
+    rubocop-capybara (2.20.0)
+      rubocop (~> 1.41)
+    rubocop-factory_bot (2.25.1)
+      rubocop (~> 1.41)
+    rubocop-rake (0.6.0)
+      rubocop (~> 1.0)
+    rubocop-rspec (2.26.1)
+      rubocop (~> 1.40)
+      rubocop-capybara (~> 2.17)
+      rubocop-factory_bot (~> 2.22)
+    ruby-progressbar (1.13.0)
+    unicode-display_width (2.5.0)
+    xxhash (0.5.0)
+
+PLATFORMS
+  arm64-darwin-21
+
+DEPENDENCIES
+  rake (~> 13.0)
+  rspec (~> 3.0)
+  rubocop (~> 1.21)
+  rubocop-rake (~> 0.6.0)
+  rubocop-rspec (~> 2.26)
+  xaba!
+
+BUNDLED WITH
+   2.3.7

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 Andrey "Zed" Zaikin
+
+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,36 @@
+xaba
+======
+
+Description
+-----------
+(un)packer for [Xamarin assemblies.blob](https://github.com/xamarin/xamarin-android/blob/main/Documentation/project-docs/AssemblyStores.md)
+
+Installation
+------------
+
+    gem install xaba
+
+Usage
+-----
+
+    # xaba -h
+
+    Usage: xaba [options] [files]
+    Commands:
+        -l, --list                       List assemblies in the blob
+        -u, --unpack                     Unpack all or specified file(s)
+        -r, --replace                    Replace file(s) in the blob
+    
+    Options:
+        -m, --manifest PATH              Pathname of the input assemblies.manifest file
+        -b, --blob PATH                  [and/or] pathname of the input assemblies.blob file
+    
+        -o, --output PATH                Pathname for the output assemblies.blob file when replacing
+                                         Pathname for the output dir when unpacking
+        -v, --verbose                    Increase verbosity
+            --version                    Prints the version
+        -h, --help                       Prints this help
+
+License
+-------
+MIT

data/README.md.tpl

@@ -0,0 +1,20 @@
+xaba
+======
+
+Description
+-----------
+(un)packer for [Xamarin assemblies.blob](https://github.com/xamarin/xamarin-android/blob/main/Documentation/project-docs/AssemblyStores.md)
+
+Installation
+------------
+
+    gem install xaba
+
+Usage
+-----
+
+% xaba -h
+
+License
+-------
+MIT

data/Rakefile

@@ -0,0 +1,150 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop readme]
+
+desc "generate sample files"
+task :generate_sample_files do
+  require "xaba"
+
+  name = "test"
+  data = "A" * 1024
+  compressed_data = LZ4.block_compress(data)
+
+  c = XABA::Container.new
+  c.file_header = XABA::FileHeader.new magic: "XABA", version: 1, local_entry_count: 1, global_entry_count: 1,
+                                       store_id: 0
+  c.descriptors = [
+    XABA::AssemblyDescriptor.new(
+      data_offset: XABA::FileHeader::SIZE + XABA::AssemblyDescriptor::SIZE + (XABA::HashEntry::SIZE * 2),
+      data_size: compressed_data.size + XABA::DataEntry::SIZE,
+      debug_data_offset: 0,
+      debug_data_size: 0,
+      config_data_offset: 0,
+      config_data_size: 0
+    )
+  ]
+  c.hash32_entries = [
+    XABA::HashEntry.new(
+      hash: XXhash.xxh32(name),
+      mapping_index: 0,
+      local_store_index: 0,
+      store_id: 0
+    )
+  ]
+  c.hash64_entries = [
+    XABA::HashEntry.new(
+      hash: XXhash.xxh64(name),
+      mapping_index: 0,
+      local_store_index: 0,
+      store_id: 0
+    )
+  ]
+  de = XABA::DataEntry.new(
+    original_size: data.size,
+    index: 0,
+    magic: "XALZ"
+  )
+  de.data = compressed_data
+  c.data_entries = [de]
+  File.open("spec/samples/1.blob", "wb") do |f|
+    c.write(f)
+  end
+
+  m = XABA::Manifest.new
+  m.assemblies = [
+    XABA::Manifest::AssemblyInfo.new(
+      "0x%x" % XXhash.xxh32(name),
+      "0x%x" % XXhash.xxh64(name),
+      0,
+      0,
+      name
+    )
+  ]
+  File.open(fname1 = "spec/samples/1.manifest", "wb") do |f|
+    m.write(f)
+  end
+
+  ### 2nd file
+
+  name = "test2"
+  data = name
+  compressed_data = LZ4.block_compress(data)
+
+  m.assemblies << XABA::Manifest::AssemblyInfo.new(
+    "0x%x" % XXhash.xxh32(name),
+    "0x%x" % XXhash.xxh64(name),
+    0,
+    1,
+    name
+  )
+
+  File.open("spec/samples/2.manifest", "wb") do |f|
+    m.write(f)
+  end
+
+  c.file_header.local_entry_count += 1
+  c.file_header.global_entry_count += 1
+
+  c.descriptors << XABA::AssemblyDescriptor.new(
+    data_offset: File.size(fname1) + XABA::AssemblyDescriptor::SIZE + (XABA::HashEntry::SIZE * 2),
+    data_size: compressed_data.size + XABA::DataEntry::SIZE,
+    debug_data_offset: 0,
+    debug_data_size: 0,
+    config_data_offset: 0,
+    config_data_size: 0
+  )
+  c.hash32_entries << XABA::HashEntry.new(
+    hash: XXhash.xxh32(name),
+    mapping_index: 0,
+    local_store_index: 0,
+    store_id: 0
+  )
+
+  c.hash64_entries << XABA::HashEntry.new(
+    hash: XXhash.xxh64(name),
+    mapping_index: 0,
+    local_store_index: 0,
+    store_id: 0
+  )
+  de = XABA::DataEntry.new(
+    original_size: data.size,
+    index: 0,
+    magic: "XALZ"
+  )
+  de.data = compressed_data
+  c.data_entries << de
+  File.open("spec/samples/2.blob", "wb") do |f|
+    c.write(f)
+  end
+end
+
+desc "build readme"
+task :readme do
+  require "erb"
+  tpl = File.read("README.md.tpl").gsub(/^%\s+(.+)/) do |x|
+    x.sub!(/^%/, "")
+    "<%= run(\"#{x}\") %>"
+  end
+  result = ERB.new(tpl, trim_mode: "%>").result
+  File.write("README.md", result)
+end
+
+def run(cmd)
+  cmd.strip!
+  puts "[.] #{cmd}"
+  r = "    # #{cmd}\n\n"
+  cmd.sub!(/^xaba/, "./exe/xaba")
+  lines = `#{cmd}`.sub(/\A\n+/m, "").sub(/\s+\Z/, "").split("\n")
+  lines = lines[0, 25] + ["..."] if lines.size > 50
+  r << lines.map { |x| "    #{x}" }.join("\n")
+  r << "\n"
+end

data/exe/xaba

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "xaba"
+
+XABA::CLI.new.run

data/lib/xaba/cli.rb

@@ -0,0 +1,203 @@
+# frozen_string_literal: true
+
+require "optparse"
+require "fileutils"
+
+module XABA
+  class CLI
+    def initialize
+      @options = { verbosity: 0 }
+    end
+
+    def parse_args(args)
+      OptionParser.new do |opts|
+        opts.banner = "Usage: xaba [options] [files]"
+
+        opts.separator "Commands:"
+
+        opts.on("-l", "--list", "List assemblies in the blob") do
+          @options[:command] = :list
+        end
+
+        opts.on("-u", "--unpack", "Unpack all or specified file(s)") do |_file|
+          @options[:command] = :unpack
+        end
+
+        opts.on("-r", "--replace", "Replace file(s) in the blob") do |_file|
+          @options[:command] = :replace
+        end
+
+        opts.separator ""
+        opts.separator "Options:"
+
+        opts.on("-m", "--manifest PATH", "Pathname of the input assemblies.manifest file") do |path|
+          @options[:manifest] = path
+        end
+
+        opts.on("-b", "--blob PATH", "[and/or] pathname of the input assemblies.blob file") do |path|
+          @options[:blob] = path
+        end
+
+        opts.separator ""
+
+        opts.on("-o", "--output PATH",
+                "Pathname for the output assemblies.blob file when replacing",
+                "Pathname for the output dir when unpacking") do |path|
+          @options[:output] = path
+        end
+
+        opts.on("-v", "--verbose", "Increase verbosity") do
+          @options[:verbosity] += 1
+        end
+
+        opts.on("--version", "Prints the version") do
+          @options[:command] = :version
+        end
+
+        opts.on("-h", "--help", "Prints this help") do
+          # intentonally left blank
+        end
+      end.tap { |o| o.parse!(args) }
+    end
+
+    def guess_missing_file_paths
+      if @options[:blob] && @options[:manifest]
+        # OK
+      elsif @options[:blob] && !@options[:manifest]
+        @options[:manifest] = "#{@options[:blob].sub(/\.blob$/, "")}.manifest"
+
+      elsif @options[:manifest] && !@options[:blob]
+        @options[:blob] = "#{@options[:manifest].sub(/\.manifest$/, "")}.blob"
+      else
+        abort "[!] The --blob or --manifest option is required"
+      end
+    end
+
+    def read_manifest
+      Manifest.read(@options[:manifest])
+    end
+
+    def read_blob
+      Container.read(@options[:blob])
+    end
+
+    def read_all
+      guess_missing_file_paths
+      @manifest = read_manifest
+      @blob = read_blob
+    end
+
+    ### run
+
+    def run(args = ARGV)
+      option_parser = parse_args(args)
+      @args = args
+      unless @options[:command]
+        puts option_parser
+        return
+      end
+
+      send @options[:command]
+    end
+
+    ### commands
+
+    def version
+      puts XABA::VERSION
+    end
+
+    def list
+      read_all
+
+      case @options[:verbosity]
+      when 2..Float::INFINITY
+        puts "[.] manifest:"
+        @manifest.assemblies.each_with_index do |e, i|
+          printf "%5d: %s\n", i, e.inspect
+        end
+
+        puts
+        puts "[.] blob file header:"
+        printf "    %s\n", @blob.file_header.inspect
+
+        puts
+        puts "[.] assembly descriptors:"
+        @blob.descriptors.each_with_index do |e, i|
+          printf "%5d: %s\n", i, e.inspect
+        end
+
+        puts
+        puts "[.] hash32 entries:"
+        @blob.hash32_entries.each_with_index do |e, i|
+          printf "%5d: %s\n", i, e.inspect
+        end
+
+        puts
+        puts "[.] hash64 entries:"
+        @blob.hash64_entries.each_with_index do |e, i|
+          printf "%5d: %s\n", i, e.inspect
+        end
+
+        puts
+        puts "[.] data entries:"
+        @blob.data_entries.each_with_index do |e, i|
+          printf "%5d: %s\n", i, e.inspect
+        end
+      when 1
+        printf "%4s %8s %8s %s\n", "idx", "compsz", "origsz", "name"
+        @manifest.assemblies.each_with_index do |a, i|
+          compsz = @blob.descriptors[i].data_size
+          origsz = @blob.data_entries[i].original_size
+          printf "%4d %8d %8d %s\n", a.blob_idx, compsz, origsz, a.name
+        end
+      else
+        # minimal verbosity
+        printf "%4s %s\n", "idx", "name"
+        @manifest.assemblies.each do |a|
+          printf "%4d %s\n", a.blob_idx, a.name
+        end
+      end
+    end
+
+    def unpack
+      abort "[!] The --output option is required for the replace command" unless @options[:output]
+      read_all
+
+      FileUtils.mkdir_p(@options[:output])
+
+      @blob.data_entries.each_with_index do |de, idx|
+        name = @manifest.assemblies[idx].name
+        next if @args.any? && !@args.include?(name) && !@args.include?("#{name}.dll")
+
+        decompressed = LZ4.block_decode(de.data)
+        dll_fname = File.join(@options[:output], "#{name}.dll")
+        File.binwrite dll_fname, decompressed
+      end
+    end
+
+    def replace
+      abort "[!] The --output option is required for the replace command" unless @options[:output]
+      abort "[!] No files specified for the replace command" if @args.empty?
+      read_all
+
+      # convert args to hash
+      h = {}
+      @args.each do |arg|
+        if File.exist?(arg)
+          h[File.basename(arg, ".dll")] = File.binread(arg)
+        else
+          abort "[!] cannot find #{arg}"
+        end
+      end
+
+      @blob.data_entries.each_with_index do |_de, idx|
+        name = @manifest.assemblies[idx].name
+        @blob.replace!(idx, h[name]) if h[name]
+      end
+
+      File.open(@options[:output], "wb") do |f|
+        @blob.write(f)
+      end
+    end
+  end
+end

data/lib/xaba/container.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+module XABA
+  class Container
+    attr_accessor :file_header, :descriptors, :hash32_entries, :hash64_entries, :data_entries
+
+    def read(f)
+      return if f.nil?
+
+      @file_header = FileHeader.read(f)
+      @descriptors = @file_header.local_entry_count.times.map { AssemblyDescriptor.read(f) }
+      @hash32_entries = @file_header.local_entry_count.times.map { HashEntry.read(f) }
+      @hash64_entries = @file_header.local_entry_count.times.map { HashEntry.read(f) }
+
+      @data_entries = @descriptors.map do |d|
+        DataEntry.read(f).tap do |de|
+          de.data = f.read(d.data_size - DataEntry::SIZE)
+        end
+      end
+      self
+    end
+
+    def replace!(idx, newdata)
+      compressed_data = LZ4.block_compress(newdata)
+      delta = compressed_data.bytesize - data_entries[idx].data.bytesize
+      descriptors[idx].data_size += delta
+      data_entries[idx].original_size = newdata.bytesize
+      data_entries[idx].data = compressed_data
+
+      descriptors[idx + 1..].each do |d|
+        d.data_offset += delta
+      end
+    end
+
+    def write(f)
+      f.write @file_header.pack
+      @descriptors.each do |d|
+        f.write d.pack
+      end
+      @hash32_entries.each do |e|
+        f.write e.pack
+      end
+      @hash64_entries.each do |e|
+        f.write e.pack
+      end
+      @data_entries.each do |e|
+        f.write e.pack
+      end
+    end
+
+    def self.read(fname)
+      File.open(fname, "rb") do |f|
+        new.read(f)
+      end
+    end
+  end
+
+  class FileHeader < IOStruct.new("a4LLLL", :magic, :version, :local_entry_count, :global_entry_count, :store_id)
+    def inspect
+      super.sub(/^#<struct /, "<")
+    end
+
+    def self.read(f)
+      r = super
+      raise "invalid magic: #{r.magic}" if r.magic != "XABA"
+
+      r
+    end
+  end
+
+  class AssemblyDescriptor < IOStruct.new(
+    "llllll",
+    :data_offset, :data_size,
+    :debug_data_offset, :debug_data_size,
+    :config_data_offset, :config_data_size
+  )
+    def inspect
+      super.sub(/^#<struct /, "<")
+    end
+  end
+
+  # hashes of assembly _name_
+  # same entry for hash32 and hash64
+  class HashEntry < IOStruct.new("QLLL", :hash, :mapping_index, :local_store_index, :store_id)
+    def inspect
+      format("<HashEntry hash=%016x mapping_index=%3d local_store_index=%3d store_id=%d>", hash, mapping_index,
+             local_store_index, store_id)
+    end
+  end
+
+  class DataEntry < IOStruct.new("a4LL", :magic, :index, :original_size)
+    attr_accessor :data
+
+    def inspect
+      super.sub(/^#<struct /, "<")
+    end
+
+    def pack
+      super + data
+    end
+
+    def self.read(f)
+      r = super
+      raise "invalid magic: #{r.magic}" if r.magic != "XALZ"
+
+      r
+    end
+  end
+end

data/lib/xaba/manifest.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module XABA
+  class Manifest
+    attr_accessor :assemblies
+
+    class AssemblyInfo
+      attr_accessor :hash32, :hash64, :blob_id, :blob_idx, :name
+
+      def initialize(hash32, hash64, blob_id, blob_idx, name)
+        @hash32 = hash32.to_i(16)
+        @hash64 = hash64.to_i(16)
+        @blob_id = blob_id.to_i
+        @blob_idx = blob_idx.to_i
+        @name = name
+        raise unless valid?
+      end
+
+      def inspect
+        format("<AssemblyInfo hash32=%08x hash64=%016x blob_id=%d blob_idx=%3d name=%s>", hash32, hash64, blob_id,
+               blob_idx, name.inspect)
+      end
+
+      def valid?
+        XXhash.xxh32(name) == hash32 && XXhash.xxh64(name) == hash64
+      end
+    end
+
+    HEADER = "Hash 32     Hash 64             Blob ID  Blob idx  Name"
+
+    def self.read(fname = "assemblies.manifest")
+      lines = File.readlines(fname).map(&:chomp).map(&:split)
+      header = lines.shift
+      raise "invalid header: #{header.inspect}" if header != HEADER.split
+
+      assemblies = lines.map do |line|
+        AssemblyInfo.new(*line)
+      end
+
+      new assemblies
+    end
+
+    def write(f)
+      data = [HEADER] + @assemblies.map do |a|
+                          format("0x%08x  0x%016x  %03d      %04d      %s",
+                                 a.hash32, a.hash64, a.blob_id, a.blob_idx, a.name)
+                        end
+      f.write("#{data.join("\n")}\n")
+    end
+
+    def initialize(assemblies = nil)
+      @assemblies = assemblies
+    end
+
+    def each(&block)
+      @assemblies.each(&block)
+    end
+  end
+end

data/lib/xaba/version.rb

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

data/lib/xaba.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require "iostruct"
+require "extlz4"
+require "xxhash"
+
+require_relative "xaba/cli"
+require_relative "xaba/container"
+require_relative "xaba/manifest"
+require_relative "xaba/version"

data/sig/xaba.rbs

@@ -0,0 +1,4 @@
+module XABA
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

data/xaba.gemspec

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require_relative "lib/xaba/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "xaba"
+  spec.version = XABA::VERSION
+  spec.authors = ["Andrey \"Zed\" Zaikin"]
+  spec.email = ["zed.0xff@gmail.com"]
+
+  spec.summary = "(un)packer for Xamarin assemblies.blob"
+  spec.description = spec.summary
+  spec.homepage = "https://github.com/zed-0xff/xaba"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 2.7.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
+    end
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "extlz4", "~> 0.3.4"
+  spec.add_dependency "iostruct", "~> 0.0.5"
+  spec.add_dependency "xxhash", "~> 0.5.0"
+
+  spec.metadata["rubygems_mfa_required"] = "true"
+end

metadata

@@ -0,0 +1,105 @@
+--- !ruby/object:Gem::Specification
+name: xaba
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Andrey "Zed" Zaikin
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2024-01-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: extlz4
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.3.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.3.4
+- !ruby/object:Gem::Dependency
+  name: iostruct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.5
+- !ruby/object:Gem::Dependency
+  name: xxhash
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.0
+description: "(un)packer for Xamarin assemblies.blob"
+email:
+- zed.0xff@gmail.com
+executables:
+- xaba
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- README.md.tpl
+- Rakefile
+- exe/xaba
+- lib/xaba.rb
+- lib/xaba/cli.rb
+- lib/xaba/container.rb
+- lib/xaba/manifest.rb
+- lib/xaba/version.rb
+- sig/xaba.rbs
+- xaba.gemspec
+homepage: https://github.com/zed-0xff/xaba
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/zed-0xff/xaba
+  source_code_uri: https://github.com/zed-0xff/xaba
+  rubygems_mfa_required: 'true'
+post_install_message:
+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.3.7
+signing_key:
+specification_version: 4
+summary: "(un)packer for Xamarin assemblies.blob"
+test_files: []