ronin-code-asm 1.0.0.beta1 → 1.0.1

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ronin-code-asm
 version: !ruby/object:Gem::Version
-  version: 1.0.0.beta1
+  version: 1.0.1
 platform: ruby
 authors:
 - Postmodern
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-01-01 00:00:00.000000000 Z
+date: 2025-02-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby-yasm
@@ -86,27 +86,14 @@ files:
 - lib/ronin/code/asm/syntax/intel.rb
 - lib/ronin/code/asm/version.rb
 - ronin-code-asm.gemspec
-- spec/asm_spec.rb
-- spec/config_spec.rb
-- spec/immediate_operand_spec.rb
-- spec/instruction_spec.rb
-- spec/memory_operand_spec.rb
-- spec/os_spec.rb
-- spec/program_spec.rb
-- spec/register_spec.rb
-- spec/shellcode_spec.rb
-- spec/spec_helper.rb
-- spec/syntax/att_spec.rb
-- spec/syntax/common_spec.rb
-- spec/syntax/intel_spec.rb
 homepage: https://github.com/ronin-rb/ronin-code-asm#readme
 licenses:
-- LGPL-3.0
+- LGPL-3.0-or-later
 metadata:
-  documentation_uri: https://ronin-rb.dev/docs/ronin-code-asm/frames
+  documentation_uri: https://ronin-rb.dev/docs/ronin-code-asm
   source_code_uri: https://github.com/ronin-rb/ronin-code-asm
   bug_tracker_uri: https://github.com/ronin-rb/ronin-code-asm/issues
-  changelog_uri: https://github.com/ronin-rb/ronin-code-asm/blob/master/ChangeLog.md
+  changelog_uri: https://github.com/ronin-rb/ronin-code-asm/blob/main/ChangeLog.md
   rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
@@ -124,20 +111,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements:
 - yasm >= 0.6.0
-rubygems_version: 3.3.26
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: A Ruby DSL for crafting Assembly programs and Shellcode.
-test_files:
-- spec/asm_spec.rb
-- spec/config_spec.rb
-- spec/immediate_operand_spec.rb
-- spec/instruction_spec.rb
-- spec/memory_operand_spec.rb
-- spec/os_spec.rb
-- spec/program_spec.rb
-- spec/register_spec.rb
-- spec/shellcode_spec.rb
-- spec/syntax/att_spec.rb
-- spec/syntax/common_spec.rb
-- spec/syntax/intel_spec.rb
+test_files: []

data/spec/asm_spec.rb

@@ -1,14 +0,0 @@
-require 'spec_helper'
-require 'ronin/code/asm'
-
-describe Ronin::Code::ASM do
-  it "must have a version" do
-    expect(subject.const_defined?('VERSION')).to eq(true)
-  end
-
-  describe ".new" do
-    it "must return a new Ronin::Code::ASM::Program" do
-      expect(subject.new(arch: :x86)).to be_kind_of(Ronin::Code::ASM::Program)
-    end
-  end
-end

data/spec/config_spec.rb

@@ -1,10 +0,0 @@
-require 'spec_helper'
-require 'ronin/code/asm/config'
-
-describe Ronin::Code::ASM::Config do
-  describe "DATA_DIR" do
-    it "must be a directory" do
-      expect(File.directory?(subject::DATA_DIR)).to be(true)
-    end
-  end
-end

data/spec/immediate_operand_spec.rb

@@ -1,79 +0,0 @@
-require 'spec_helper'
-
-require 'ronin/code/asm/immediate_operand'
-
-describe Ronin::Code::ASM::ImmediateOperand do
-  let(:value) { 0xff }
-
-  describe "#initialize" do
-    context "with a width" do
-      let(:width) { 2 }
-
-      subject { described_class.new(value,width) }
-
-      it "must set the width" do
-        expect(subject.width).to eq(width)
-      end
-    end
-  end
-
-  describe "#width" do
-    describe "default width for" do
-      context "0x100000000 .. 0xffffffffffffffff" do
-        subject { described_class.new(0xffffffffffffffff).width }
-
-        it { expect(subject).to be == 8 }
-      end
-
-      context "-0x800000000 .. -0x7fffffffffffffff" do
-        subject { described_class.new(-0x7fffffffffffffff).width }
-
-        it { expect(subject).to be == 8 }
-      end
-
-      context "0x10000 .. 0xffffffff" do
-        subject { described_class.new(0xffffffff).width }
-
-        it { expect(subject).to be == 4 }
-      end
-
-      context "-0x80000 .. -0x7fffffff" do
-        subject { described_class.new(-0x7fffffff).width }
-
-        it { expect(subject).to be == 4 }
-      end
-
-      context "0x100 .. 0xffff" do
-        subject { described_class.new(0xffff).width }
-
-        it { expect(subject).to be == 2 }
-      end
-
-      context "-0x80 .. -0x7fff" do
-        subject { described_class.new(-0x7fff).width }
-
-        it { expect(subject).to be == 2 }
-      end
-
-      context "0x0 .. 0xff" do
-        subject { described_class.new(0xff).width }
-
-        it { expect(subject).to be == 1 }
-      end
-
-      context "0x0 .. -0x7f" do
-        subject { described_class.new(-0x7f).width }
-
-        it { expect(subject).to be == 1 }
-      end
-    end
-  end
-
-  describe "#to_i" do
-    subject { described_class.new(value) }
-
-    it "must return the value" do
-      expect(subject.to_i).to eq(value)
-    end
-  end
-end

data/spec/instruction_spec.rb

@@ -1,62 +0,0 @@
-require 'spec_helper'
-
-require 'ronin/code/asm/instruction'
-require 'ronin/code/asm/register'
-require 'ronin/code/asm/immediate_operand'
-require 'ronin/code/asm/memory_operand'
-
-describe Ronin::Code::ASM::Instruction do
-  let(:register)  { Ronin::Code::ASM::Register.new(:eax, 4) }
-  let(:immediate) { Ronin::Code::ASM::ImmediateOperand.new(0xff, 1) }
-
-  describe "#initialize" do
-    let(:name)     { :mov }
-    let(:operands) { [immediate, register] }
-
-    subject { described_class.new(name,operands) }
-
-    it "must set the name" do
-      expect(subject.name).to eq(:mov)
-    end
-
-    it "must set the operands" do
-      expect(subject.operands).to eq(operands)
-    end
-
-    context "when given an Integer operand" do
-      let(:integer) { 0xff }
-
-      subject { described_class.new(name, [integer, register]) }
-
-      it "must wrap the operand to in a Ronin::Code::ASM::ImmediateOperand" do
-        expect(subject.operands[0]).to be_kind_of(Ronin::Code::ASM::ImmediateOperand)
-        expect(subject.operands[0].value).to eq(integer)
-      end
-    end
-
-    context "when given a nil operand" do
-      subject { described_class.new(name, [nil, register]) }
-
-      it "must wrap the operand to in a Ronin::Code::ASM::ImmediateOperand" do
-        expect(subject.operands[0]).to be_kind_of(Ronin::Code::ASM::ImmediateOperand)
-        expect(subject.operands[0].value).to eq(0)
-      end
-    end
-  end
-
-  describe "#width" do
-    subject { described_class.new(:mov, [immediate, register]) }
-
-    it "must return the maximum width of the operands" do
-      expect(subject.width).to eq(register.width)
-    end
-
-    context "when one of the operands does not define #width" do
-      subject { described_class.new(:mov, [:label, register]) }
-
-      it "must ignore them" do
-        expect(subject.width).to eq(register.width)
-      end
-    end
-  end
-end

data/spec/memory_operand_spec.rb

@@ -1,80 +0,0 @@
-require 'spec_helper'
-
-require 'ronin/code/asm/memory_operand'
-require 'ronin/code/asm/register'
-
-describe Ronin::Code::ASM::MemoryOperand do
-  let(:register) { Ronin::Code::ASM::Register.new(:eax, 4) }
-
-  describe "#initialize" do
-    it { expect(subject.base).to   be_nil }
-    it { expect(subject.offset).to eq(0)  }
-    it { expect(subject.index).to  be_nil }
-    it { expect(subject.scale).to  eq(1)  }
-
-    it "must only accept nil and a Register for base" do
-      expect {
-        described_class.new(Object.new)
-      }.to raise_error(TypeError)
-    end
-
-    it "must only accept Integers for offset" do
-      expect {
-        described_class.new(register,2.0)
-      }.to raise_error(TypeError)
-    end
-
-    it "must only accept nil and a Register for index" do
-      expect {
-        described_class.new(register,0,Object.new)
-      }.to raise_error(TypeError)
-    end
-
-    it "must only accept Integers for offset" do
-      expect {
-        described_class.new(register,0,nil,2.0)
-      }.to raise_error(TypeError)
-    end
-
-  end
-
-  describe "#+" do
-    let(:operand) { described_class.new(register,4,register,2) }
-
-    subject { operand + 4 }
-
-    it "must add to offset" do
-      expect(subject.offset).to eq(8)
-    end
-
-    it "must not change base, index or scale" do
-      expect(subject.base).to  eq(operand.base)
-      expect(subject.index).to eq(operand.index)
-      expect(subject.scale).to eq(operand.scale)
-    end
-  end
-
-  describe "#-" do
-    let(:operand) { described_class.new(register,4,register,2) }
-
-    subject { operand - 2 }
-
-    it "must subtract from offset" do
-      expect(subject.offset).to eq(2)
-    end
-
-    it "must not change base, index or scale" do
-      expect(subject.base).to  eq(operand.base)
-      expect(subject.index).to eq(operand.index)
-      expect(subject.scale).to eq(operand.scale)
-    end
-  end
-
-  describe "#width" do
-    subject { described_class.new(register,10) }
-
-    it "must return the width of base" do
-      expect(subject.width).to eq(register.width)
-    end
-  end
-end

data/spec/os_spec.rb

@@ -1,68 +0,0 @@
-require 'spec_helper'
-require 'ronin/code/asm/os'
-
-describe Ronin::Code::ASM::OS do
-  describe "SYSCALLS" do
-    subject { described_class::SYSCALLS }
-
-    let(:data_dir) { Ronin::Code::ASM::Config::DATA_DIR }
-
-    it { expect(subject).to be_kind_of(Hash) }
-
-    it "must load syscalls for :freebsd and :amd64" do
-      expect(subject[:freebsd][:amd64]).to eq(
-        YAML.load_file(
-          File.join(data_dir,'os','freebsd','amd64','syscalls.yml')
-        )
-      )
-    end
-
-    it "must load syscalls for :freebsd and :x86" do
-      expect(subject[:freebsd][:amd64]).to eq(
-        YAML.load_file(
-          File.join(data_dir,'os','freebsd','x86','syscalls.yml')
-        )
-      )
-    end
-
-    it "must load syscalls for :linux and :amd64" do
-      expect(subject[:linux][:amd64]).to eq(
-        YAML.load_file(
-          File.join(data_dir,'os','linux','amd64','syscalls.yml')
-        )
-      )
-    end
-
-    it "must load syscalls for :linux and :x86" do
-      expect(subject[:linux][:x86]).to eq(
-        YAML.load_file(
-          File.join(data_dir,'os','linux','x86','syscalls.yml')
-        )
-      )
-    end
-  end
-
-  describe ".[]" do
-    context "when given :linux" do
-      it "must return #{described_class}::Linux" do
-        expect(subject[:linux]).to be(described_class::Linux)
-      end
-    end
-
-    context "when given :freebsd" do
-      it "must return #{described_class}::FreeBSD" do
-        expect(subject[:freebsd]).to be(described_class::FreeBSD)
-      end
-    end
-
-    context "when given an unknown Symbol" do
-      let(:name) { :foo }
-
-      it do
-        expect {
-          subject[name]
-        }.to raise_error(ArgumentError,"unknown OS name: #{name.inspect}")
-      end
-    end
-  end
-end