c8dasm 0.99.0

data/spec/opcode_c_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+include C8dasm
+
+describe Opcode do
+
+  describe 'c201' do
+    before { @opcode = Opcode.new('c201') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq 'c201'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'RND V2, 01'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Puts random byte AND 01 into register V2.'
+    end
+  end
+
+end

data/spec/opcode_d_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+include C8dasm
+
+describe Opcode do
+
+  describe 'd014' do
+    before { @opcode = Opcode.new('d014') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq 'd014'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'DRW V0, V1, 4'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Draws 4-byte sprite from I at (V0, V1)'
+    end
+  end
+
+end

data/spec/opcode_e_spec.rb

@@ -0,0 +1,39 @@
+require 'spec_helper'
+
+include C8dasm
+
+describe Opcode do
+
+  describe 'e29e' do
+    before { @opcode = Opcode.new('e29e') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq 'e29e'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'SKP V2'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Skip next inst. if V2 key is pressed.'
+    end
+  end
+
+  describe 'eda1' do
+    before { @opcode = Opcode.new('eda1') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq 'eda1'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'SKNP Vd'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Skip next inst. if Vd key is not pressed.'
+    end
+  end
+
+end

data/spec/opcode_f_spec.rb

@@ -0,0 +1,151 @@
+require 'spec_helper'
+
+include C8dasm
+
+describe Opcode do
+
+  describe 'f607' do
+    before { @opcode = Opcode.new('f607') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq 'f607'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'LD V6, DT'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Set V6 = delay timer value.'
+    end
+  end
+
+  describe 'f00a' do
+    before { @opcode = Opcode.new('f00a') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq 'f00a'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'LD V0, KEY'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Wait key press, store its value in V0.'
+    end
+  end
+
+  describe 'f515' do
+    before { @opcode = Opcode.new('f515') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq 'f515'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'LD DT, V5'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Set delay timer = V5.'
+    end
+  end
+
+  describe 'fd18' do
+    before { @opcode = Opcode.new('fd18') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq 'fd18'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'LD ST, Vd'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Set sound timer = Vd.'
+    end
+  end
+
+  describe 'f61e' do
+    before { @opcode = Opcode.new('f61e') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq 'f61e'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'ADD I, V6'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Set I = I + V6.'
+    end
+  end
+
+  describe 'f029' do
+    before { @opcode = Opcode.new('f029') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq 'f029'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'LD F, V0'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Set I = location of sprite for digit V0.'
+    end
+  end
+
+  describe 'f733' do
+    before { @opcode = Opcode.new('f733') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq 'f733'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'LD B, V7'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Store BCD of V7 at I, I+1, and I+2.'
+    end
+  end
+
+  describe 'f265' do
+    before { @opcode = Opcode.new('f265') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq 'f265'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'LD V2, [I]'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Load registers V0..V2 starting from I.'
+    end
+  end
+
+  describe 'f055' do
+    before { @opcode = Opcode.new('f055') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq 'f055'
+    end
+
+    it 'returns the assembly' do
+      expect(@opcode.assembly).to eq 'LD [I], V0'
+    end
+
+    it 'returns a comment' do
+      expect(@opcode.comment).to eq 'Store registers V0..V0 starting at I.'
+    end
+  end
+
+end

data/spec/opcode_spec.rb

@@ -0,0 +1,45 @@
+require 'spec_helper'
+
+include C8dasm
+
+describe Opcode do
+
+  context 'with an explicit address' do
+    it 'returns the address in hexadecimal' do
+      opcode = Opcode.new('a21e', address: 1024)
+      expect(opcode.address).to eq '400'
+    end
+  end
+
+  context 'without an explicit address' do
+    it 'returns the default address in hexadecimal' do
+      opcode = Opcode.new('a21e')
+      expect(opcode.address).to eq '200'
+    end
+  end
+
+  describe '#line' do
+    it 'returns a fully formated line for the desassembly' do
+      opcode = Opcode.new('a21e', address: 1024)
+      expected = '400:a21e  LD I, 21e     ;Puts 21e into register I.'
+      expect(opcode.line).to eq expected
+    end
+  end
+
+  context 'with opcode 0000' do
+    before { @opcode = Opcode.new('0000') }
+
+    it 'returns the opcode' do
+      expect(@opcode.opcode).to eq '0000'
+    end
+
+    it 'returns no assembly' do
+      expect(@opcode.assembly).to eq ''
+    end
+
+    it 'returns special comment' do
+      expect(@opcode.comment).to eq '***WARNING*** UNKNOWN INSTRUCTION!'
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+require 'c8dasm'

metadata

@@ -0,0 +1,183 @@
+--- !ruby/object:Gem::Specification
+name: c8dasm
+version: !ruby/object:Gem::Version
+  version: 0.99.0
+platform: ruby
+authors:
+- lkdjiin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-01-31 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: c8dasm is a utility to disassemble a Chip8 binary file.
+email:
+- xavier.nayrac@gmail.com
+executables:
+- c8dasm
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/c8dasm
+- c8dasm.gemspec
+- lib/c8dasm.rb
+- lib/c8dasm/assemblies.rb
+- lib/c8dasm/assemblies/asm0.rb
+- lib/c8dasm/assemblies/asm1.rb
+- lib/c8dasm/assemblies/asm2.rb
+- lib/c8dasm/assemblies/asm3.rb
+- lib/c8dasm/assemblies/asm4.rb
+- lib/c8dasm/assemblies/asm5.rb
+- lib/c8dasm/assemblies/asm6.rb
+- lib/c8dasm/assemblies/asm7.rb
+- lib/c8dasm/assemblies/asm8.rb
+- lib/c8dasm/assemblies/asm9.rb
+- lib/c8dasm/assemblies/asm_base.rb
+- lib/c8dasm/assemblies/asma.rb
+- lib/c8dasm/assemblies/asmb.rb
+- lib/c8dasm/assemblies/asmc.rb
+- lib/c8dasm/assemblies/asmd.rb
+- lib/c8dasm/assemblies/asme.rb
+- lib/c8dasm/assemblies/asmf.rb
+- lib/c8dasm/assembly.rb
+- lib/c8dasm/chip8_reader.rb
+- lib/c8dasm/comment.rb
+- lib/c8dasm/comments.rb
+- lib/c8dasm/comments/comment0.rb
+- lib/c8dasm/comments/comment1.rb
+- lib/c8dasm/comments/comment2.rb
+- lib/c8dasm/comments/comment3.rb
+- lib/c8dasm/comments/comment4.rb
+- lib/c8dasm/comments/comment5.rb
+- lib/c8dasm/comments/comment6.rb
+- lib/c8dasm/comments/comment7.rb
+- lib/c8dasm/comments/comment8.rb
+- lib/c8dasm/comments/comment9.rb
+- lib/c8dasm/comments/comment_base.rb
+- lib/c8dasm/comments/commenta.rb
+- lib/c8dasm/comments/commentb.rb
+- lib/c8dasm/comments/commentc.rb
+- lib/c8dasm/comments/commentd.rb
+- lib/c8dasm/comments/commente.rb
+- lib/c8dasm/comments/commentf.rb
+- lib/c8dasm/opcode.rb
+- lib/c8dasm/version.rb
+- spec/15-puzzle.ch8
+- spec/MAZE
+- spec/c8dasm_spec.rb
+- spec/chip8_reader_spec.rb
+- spec/opcode_0_spec.rb
+- spec/opcode_1_spec.rb
+- spec/opcode_2_spec.rb
+- spec/opcode_3_spec.rb
+- spec/opcode_4_spec.rb
+- spec/opcode_5_spec.rb
+- spec/opcode_6_spec.rb
+- spec/opcode_7_spec.rb
+- spec/opcode_8_spec.rb
+- spec/opcode_9_spec.rb
+- spec/opcode_a_spec.rb
+- spec/opcode_b_spec.rb
+- spec/opcode_c_spec.rb
+- spec/opcode_d_spec.rb
+- spec/opcode_e_spec.rb
+- spec/opcode_f_spec.rb
+- spec/opcode_spec.rb
+- spec/spec_helper.rb
+homepage: ''
+licenses:
+- GPLv3
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: Disassembler for Chip8 binaries.
+test_files:
+- spec/15-puzzle.ch8
+- spec/MAZE
+- spec/c8dasm_spec.rb
+- spec/chip8_reader_spec.rb
+- spec/opcode_0_spec.rb
+- spec/opcode_1_spec.rb
+- spec/opcode_2_spec.rb
+- spec/opcode_3_spec.rb
+- spec/opcode_4_spec.rb
+- spec/opcode_5_spec.rb
+- spec/opcode_6_spec.rb
+- spec/opcode_7_spec.rb
+- spec/opcode_8_spec.rb
+- spec/opcode_9_spec.rb
+- spec/opcode_a_spec.rb
+- spec/opcode_b_spec.rb
+- spec/opcode_c_spec.rb
+- spec/opcode_d_spec.rb
+- spec/opcode_e_spec.rb
+- spec/opcode_f_spec.rb
+- spec/opcode_spec.rb
+- spec/spec_helper.rb
+has_rdoc: