c8dasm 0.99.0

data/lib/c8dasm/version.rb

@@ -0,0 +1,3 @@
+module C8dasm
+  VERSION = "0.99.0"
+end

data/spec/c8dasm_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+
+describe C8dasm do
+  it 'has a version number' do
+    expect(C8dasm::VERSION).not_to be nil
+  end
+end

data/spec/chip8_reader_spec.rb

@@ -0,0 +1,27 @@
+require 'spec_helper'
+
+include C8dasm
+
+describe Chip8Reader do
+
+  before do
+    reader = Chip8Reader.new('./spec/MAZE')
+    @opcodes = reader.opcodes
+  end
+
+  it 'returns the right amount of opcodes' do
+    expect(@opcodes.size).to eq 17
+  end
+
+  specify 'an opcode is a string' do
+    expect(@opcodes.first).to be_a String
+  end
+
+  describe "MAZE's opcodes" do
+    specify { expect(@opcodes[0]).to eq 'a21e' }
+    specify { expect(@opcodes[2]).to eq '3201' }
+    specify { expect(@opcodes[8]).to eq '6000' }
+    specify { expect(@opcodes[16]).to eq '8010' }
+  end
+
+end

data/spec/opcode_0_spec.rb

@@ -0,0 +1,39 @@
+require 'spec_helper'
+
+include C8dasm
+
+describe Opcode do
+
+  describe '00e0' do
+    before { @opcode = Opcode.new('00e0') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq '00e0'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'CLS'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Clear the display.'
+    end
+  end
+
+  describe '00ee' do
+    before { @opcode = Opcode.new('00ee') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq '00ee'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'RET'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Returns from this subroutine.'
+    end
+  end
+
+end

data/spec/opcode_1_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+include C8dasm
+
+describe Opcode do
+
+  describe '1200' do
+    before { @opcode = Opcode.new('1200') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq '1200'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'JP 200'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Jump to location 200.'
+    end
+  end
+
+end

data/spec/opcode_2_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+include C8dasm
+
+describe Opcode do
+
+  describe '22a2' do
+    before { @opcode = Opcode.new('22a2') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq '22a2'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'CALL 2a2'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Call subroutine at 2a2.'
+    end
+  end
+
+end

data/spec/opcode_3_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+include C8dasm
+
+describe Opcode do
+
+  describe '3201' do
+    before { @opcode = Opcode.new('3201') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq '3201'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'SE V2, 01'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Skip next instruction if V2 = 01.'
+    end
+  end
+
+end

data/spec/opcode_4_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+include C8dasm
+
+describe Opcode do
+
+  describe '4800' do
+    before { @opcode = Opcode.new('4800') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq '4800'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'SNE V8, 00'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Skip next instruction if V8 != 00.'
+    end
+  end
+
+end

data/spec/opcode_5_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+
+include C8dasm
+
+describe Opcode do
+
+  describe '5210' do
+    before { @opcode = Opcode.new('5210') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq '5210'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'SE V2, V1'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Skip next instruction if V2 = V1.'
+    end
+  end
+
+end
+
+

data/spec/opcode_6_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+include C8dasm
+
+describe Opcode do
+
+  describe '6012' do
+    before { @opcode = Opcode.new('6012') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq '6012'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'LD V0, 12'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Puts the value 12 into register V0.'
+    end
+  end
+
+end

data/spec/opcode_7_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+include C8dasm
+
+describe Opcode do
+
+  describe '7004' do
+    before { @opcode = Opcode.new('7004') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq '7004'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'ADD V0, 04'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'V0 = V0 + 04.'
+    end
+  end
+
+end

data/spec/opcode_8_spec.rb

@@ -0,0 +1,119 @@
+require 'spec_helper'
+
+include C8dasm
+
+describe Opcode do
+
+  describe '8a10' do
+    before { @opcode = Opcode.new('8a10') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq '8a10'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'LD Va, V1'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Set Va = V1.'
+    end
+  end
+
+  describe '8d52' do
+    before { @opcode = Opcode.new('8d52') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq '8d52'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'AND Vd, V5'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Set Vd = Vd AND V5.'
+    end
+  end
+
+  describe '8903' do
+    before { @opcode = Opcode.new('8903') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq '8903'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'XOR V9, V0'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Set V9 = V9 XOR V0.'
+    end
+  end
+
+  describe '8bd4' do
+    before { @opcode = Opcode.new('8bd4') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq '8bd4'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'ADD Vb, Vd'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Set Vb = Vb + Vd, set VF = carry.'
+    end
+  end
+
+  describe '8b25' do
+    before { @opcode = Opcode.new('8b25') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq '8b25'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'SUB Vb, V2'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Set Vb = Vb - V2, set VF = NOT borrow.'
+    end
+  end
+
+  describe '87a6' do
+    before { @opcode = Opcode.new('87a6') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq '87a6'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'SHR V7, Va'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Set V7 = Va SHR 1.'
+    end
+  end
+
+  describe '87ae' do
+    before { @opcode = Opcode.new('87ae') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq '87ae'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'SHL V7, Va'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Set V7 = Va SHL 1.'
+    end
+  end
+
+end

data/spec/opcode_9_spec.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+include C8dasm
+
+describe Opcode do
+
+  describe '9210' do
+    before { @opcode = Opcode.new('9210') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq '9210'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'SNE V2, V1'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Skip next instruction if V2 != V1.'
+    end
+  end
+
+end
+

data/spec/opcode_a_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+include C8dasm
+
+describe Opcode do
+
+  describe 'a21e' do
+    before { @opcode = Opcode.new('a21e') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq 'a21e'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'LD I, 21e'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Puts 21e into register I.'
+    end
+  end
+
+end

data/spec/opcode_b_spec.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+include C8dasm
+
+describe Opcode do
+
+  describe 'b123' do
+    before { @opcode = Opcode.new('b123') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq 'b123'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'JP V0, 123'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Jump to location 123 + V0.'
+    end
+  end
+
+end
+