gemba 0.1.0

data/test/test_tip_service.rb

@@ -0,0 +1,138 @@
+# frozen_string_literal: true
+
+require "minitest/autorun"
+require_relative "shared/tk_test_helper"
+
+class TestTipService < Minitest::Test
+  include TeekTestHelper
+
+  def test_register_sets_underline_font
+    assert_tk_app("register sets underlined font") do
+      require "gemba/tip_service"
+      tips = Gemba::TipService.new(app)
+
+      lbl = ".test_lbl"
+      app.command('ttk::label', lbl, text: "Test")
+      app.command(:pack, lbl)
+      app.update
+
+      tips.register(lbl, "Help text")
+      app.update
+
+      font = app.command(lbl, 'cget', '-font')
+      underline = app.tcl_eval("font actual #{font} -underline")
+      assert_equal '1', underline
+    end
+  end
+
+  def test_show_creates_tooltip
+    assert_tk_app("show creates a tooltip toplevel") do
+      require "gemba/tip_service"
+      tips = Gemba::TipService.new(app)
+
+      lbl = ".test_lbl"
+      app.command('ttk::label', lbl, text: "Test")
+      app.command(:pack, lbl)
+      app.show
+      app.update
+
+      refute tips.showing?
+      tips.show(lbl, "Help text")
+      app.update
+
+      assert tips.showing?
+      assert_equal lbl, tips.target
+    end
+  end
+
+  def test_hide_destroys_tooltip
+    assert_tk_app("hide destroys tooltip") do
+      require "gemba/tip_service"
+      tips = Gemba::TipService.new(app)
+
+      lbl = ".test_lbl"
+      app.command('ttk::label', lbl, text: "Test")
+      app.command(:pack, lbl)
+      app.show
+      app.update
+
+      tips.show(lbl, "Help text")
+      app.update
+      assert tips.showing?
+
+      tips.hide
+      app.update
+      refute tips.showing?
+      assert_nil tips.target
+    end
+  end
+
+  def test_toggle_behavior
+    assert_tk_app("clicking same label toggles tooltip") do
+      require "gemba/tip_service"
+      tips = Gemba::TipService.new(app)
+
+      lbl = ".test_lbl"
+      app.command('ttk::label', lbl, text: "Test")
+      app.command(:pack, lbl)
+      app.show
+      app.update
+
+      tips.register(lbl, "Help text")
+      app.update
+
+      # First click — show
+      app.command(:event, 'generate', lbl, '<Button-1>')
+      app.update
+      assert tips.showing?
+      assert_equal lbl, tips.target
+
+      # Second click — hide
+      app.command(:event, 'generate', lbl, '<Button-1>')
+      app.update
+      refute tips.showing?
+    end
+  end
+
+  def test_only_one_tooltip_at_a_time
+    assert_tk_app("showing a second tooltip hides the first") do
+      require "gemba/tip_service"
+      tips = Gemba::TipService.new(app)
+
+      lbl1 = ".test_lbl1"
+      lbl2 = ".test_lbl2"
+      app.command('ttk::label', lbl1, text: "Label 1")
+      app.command('ttk::label', lbl2, text: "Label 2")
+      app.command(:pack, lbl1)
+      app.command(:pack, lbl2)
+      app.show
+      app.update
+
+      tips.register(lbl1, "Help 1")
+      tips.register(lbl2, "Help 2")
+      app.update
+
+      # Show first tooltip
+      tips.show(lbl1, "Help 1")
+      app.update
+      assert_equal lbl1, tips.target
+
+      # Show second — first should be gone
+      tips.show(lbl2, "Help 2")
+      app.update
+      assert_equal lbl2, tips.target
+    end
+  end
+
+  def test_dismiss_ms_is_configurable
+    assert_tk_app("dismiss_ms is configurable") do
+      require "gemba/tip_service"
+      tips = Gemba::TipService.new(app, dismiss_ms: 2000)
+
+      assert_equal 2000, tips.dismiss_ms
+
+      tips.dismiss_ms = 5000
+      assert_equal 5000, tips.dismiss_ms
+    end
+  end
+end

data/test/test_toast_overlay.rb

@@ -0,0 +1,216 @@
+# frozen_string_literal: true
+
+require "minitest/autorun"
+require_relative "../lib/gemba/toast_overlay"
+
+class TestToastOverlay < Minitest::Test
+  # Minimal texture mock — records destroy calls.
+  class MockTexture
+    attr_reader :calls, :width, :height
+    attr_accessor :blend_mode
+
+    def initialize(w, h)
+      @width = w
+      @height = h
+      @blend_mode = nil
+      @calls = []
+    end
+
+    def update(pixels)
+      @calls << [:update, pixels.bytesize]
+    end
+
+    def destroy
+      @calls << [:destroy]
+    end
+  end
+
+  # Recording renderer mock.
+  class MockRenderer
+    attr_reader :calls, :textures
+
+    def initialize
+      @calls = []
+      @textures = []
+    end
+
+    def create_texture(w, h, mode)
+      tex = MockTexture.new(w, h)
+      @textures << tex
+      @calls << [:create_texture, w, h, mode]
+      tex
+    end
+
+    def output_size
+      [720, 480]
+    end
+
+    def copy(tex, src, dst)
+      @calls << [:copy, src, dst]
+    end
+  end
+
+  # Recording font mock.
+  class MockFont
+    attr_reader :calls
+
+    def initialize
+      @calls = []
+    end
+
+    def ascent
+      10
+    end
+
+    def measure(_text)
+      [100, 14]
+    end
+
+    def render_text(text, r, g, b)
+      @calls << [:render_text, text, r, g, b]
+      MockTexture.new(text.length * 7, 14)
+    end
+  end
+
+  # Stub for the C-implemented toast_background — returns dummy ARGB pixels.
+  STUB_BG_FN = ->(w, h, _radius) { "\x00".b * (w * h * 4) }
+
+  def setup
+    @renderer = MockRenderer.new
+    @font = MockFont.new
+    @toast = Gemba::ToastOverlay.new(
+      renderer: @renderer, font: @font, duration: 1.5, bg_fn: STUB_BG_FN
+    )
+  end
+
+  # -- visibility ------------------------------------------------------------
+
+  def test_not_visible_initially
+    refute @toast.visible?
+  end
+
+  def test_visible_after_show
+    @toast.show("Hello")
+    assert @toast.visible?
+  end
+
+  def test_not_visible_after_destroy
+    @toast.show("Hello")
+    @toast.destroy
+    refute @toast.visible?
+  end
+
+  # -- show ------------------------------------------------------------------
+
+  def test_show_renders_text
+    @toast.show("Saved")
+    render_calls = @font.calls.select { |c| c[0] == :render_text }
+    assert_equal 1, render_calls.size
+    assert_equal "Saved", render_calls[0][1]
+    # White text
+    assert_equal [255, 255, 255], render_calls[0][2..4]
+  end
+
+  def test_show_creates_background_texture
+    @toast.show("Saved")
+    create_calls = @renderer.calls.select { |c| c[0] == :create_texture }
+    assert_equal 1, create_calls.size
+    # Background should be wider than text (padded)
+    assert create_calls[0][1] > 0
+    assert create_calls[0][2] > 0
+    assert_equal :streaming, create_calls[0][3]
+  end
+
+  def test_show_replaces_previous_toast
+    @toast.show("First")
+    @toast.show("Second")
+    # Should have rendered text twice
+    render_calls = @font.calls.select { |c| c[0] == :render_text }
+    assert_equal 2, render_calls.size
+    assert_equal "Second", render_calls[1][1]
+    # First toast's textures should have been destroyed
+    first_bg = @renderer.textures[0]
+    assert first_bg.calls.any? { |c| c[0] == :destroy }
+  end
+
+  # -- draw ------------------------------------------------------------------
+
+  def test_draw_does_nothing_when_no_toast
+    r = MockRenderer.new
+    @toast.draw(r, nil)
+    assert_empty r.calls
+  end
+
+  def test_draw_copies_bg_and_text
+    @toast.show("Hello")
+    r = MockRenderer.new
+    @toast.draw(r, [0, 0, 720, 480])
+    copy_calls = r.calls.select { |c| c[0] == :copy }
+    assert_equal 2, copy_calls.size  # background + text
+  end
+
+  def test_draw_centers_in_dest_rect
+    @toast.show("Hi")
+    r = MockRenderer.new
+    @toast.draw(r, [100, 0, 500, 400])
+    copy_calls = r.calls.select { |c| c[0] == :copy }
+    # Background dest rect x should be centered around 100 + 250 = 350
+    bg_dst = copy_calls[0][2]
+    cx = 100 + 500 / 2
+    assert_equal cx - bg_dst[2] / 2, bg_dst[0]
+  end
+
+  def test_draw_uses_output_size_when_no_dest
+    @toast.show("Hi")
+    r = MockRenderer.new
+    @toast.draw(r, nil)
+    copy_calls = r.calls.select { |c| c[0] == :copy }
+    bg_dst = copy_calls[0][2]
+    # Should center around output_size width / 2 = 360
+    assert_equal 360 - bg_dst[2] / 2, bg_dst[0]
+  end
+
+  # -- expiration ------------------------------------------------------------
+
+  def test_draw_destroys_expired_toast
+    @toast.show("Bye", duration: 0.0)
+    sleep 0.01  # ensure expired
+    r = MockRenderer.new
+    @toast.draw(r, nil)
+    # Should have self-destroyed, no copy calls
+    assert_empty r.calls.select { |c| c[0] == :copy }
+    refute @toast.visible?
+  end
+
+  def test_permanent_toast_does_not_expire
+    @toast.show("Wait", permanent: true)
+    sleep 0.01
+    r = MockRenderer.new
+    @toast.draw(r, [0, 0, 720, 480])
+    copy_calls = r.calls.select { |c| c[0] == :copy }
+    assert_equal 2, copy_calls.size
+    assert @toast.visible?
+  end
+
+  # -- destroy ---------------------------------------------------------------
+
+  def test_destroy_frees_textures
+    @toast.show("Hello")
+    bg_tex = @renderer.textures.last
+    @toast.destroy
+    assert bg_tex.calls.any? { |c| c[0] == :destroy }
+  end
+
+  def test_destroy_is_safe_when_empty
+    @toast.destroy  # no-op, should not raise
+    refute @toast.visible?
+  end
+
+  # -- duration accessor -----------------------------------------------------
+
+  def test_duration_accessor
+    assert_in_delta 1.5, @toast.duration
+    @toast.duration = 3.0
+    assert_in_delta 3.0, @toast.duration
+  end
+end

data/test/test_virtual_keyboard.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require "minitest/autorun"
+require_relative "../lib/gemba/input_mappings"
+
+class TestVirtualKeyboard < Minitest::Test
+  def setup
+    @kb = Gemba::VirtualKeyboard.new
+  end
+
+  def test_button_false_initially
+    refute @kb.button?('z')
+  end
+
+  def test_press_makes_button_true
+    @kb.press('z')
+    assert @kb.button?('z')
+  end
+
+  def test_release_makes_button_false
+    @kb.press('z')
+    @kb.release('z')
+    refute @kb.button?('z')
+  end
+
+  def test_multiple_keys
+    @kb.press('z')
+    @kb.press('x')
+    assert @kb.button?('z')
+    assert @kb.button?('x')
+    @kb.release('z')
+    refute @kb.button?('z')
+    assert @kb.button?('x')
+  end
+
+  def test_never_closed
+    refute @kb.closed?
+  end
+end

data/test/test_xor_delta.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require "minitest/autorun"
+require "gemba/headless"
+
+class TestXorDelta < Minitest::Test
+  def test_xor_identical_strings_produces_zeros
+    a = "\xFF\x00\xAB".b
+    b = "\xFF\x00\xAB".b
+    result = Gemba.xor_delta(a, b)
+    assert_equal "\x00\x00\x00".b, result
+  end
+
+  def test_xor_against_zeros_returns_original
+    a = "\xDE\xAD\xBE\xEF".b
+    b = "\x00\x00\x00\x00".b
+    result = Gemba.xor_delta(a, b)
+    assert_equal a, result
+  end
+
+  def test_xor_is_reversible
+    a = "hello world!".b
+    b = "goodbye!!!12".b
+    delta = Gemba.xor_delta(a, b)
+    restored = Gemba.xor_delta(delta, b)
+    assert_equal a, restored
+  end
+
+  def test_xor_mismatched_lengths_raises
+    assert_raises(ArgumentError) do
+      Gemba.xor_delta("abc", "ab")
+    end
+  end
+
+  def test_xor_empty_strings
+    result = Gemba.xor_delta("".b, "".b)
+    assert_equal "".b, result
+  end
+
+  # -- count_changed_pixels --
+
+  def test_count_all_zeros
+    delta = "\x00\x00\x00\x00\x00\x00\x00\x00".b # 2 pixels, both zero
+    assert_equal 0, Gemba.count_changed_pixels(delta)
+  end
+
+  def test_count_all_changed
+    delta = "\xFF\x00\x00\x00\x00\xFF\x00\x00".b # 2 pixels, both non-zero
+    assert_equal 2, Gemba.count_changed_pixels(delta)
+  end
+
+  def test_count_mixed
+    # 3 pixels: changed, zero, changed
+    delta = "\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x01".b
+    assert_equal 2, Gemba.count_changed_pixels(delta)
+  end
+
+  def test_count_empty
+    assert_equal 0, Gemba.count_changed_pixels("".b)
+  end
+end

metadata

@@ -0,0 +1,234 @@
+--- !ruby/object:Gem::Specification
+name: gemba
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- James Cook
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: teek
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.2
+- !ruby/object:Gem::Dependency
+  name: teek-sdl2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.3
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rake-compiler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: method_source
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: listen
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubyzip
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.4'
+description: Wraps libmgba's mCore C API and provides a full-featured GBA player with
+  SDL2 rendering, input, save states, and a Tk-based settings UI
+email:
+- jcook.rubyist@gmail.com
+executables:
+- gemba
+extensions:
+- ext/gemba/extconf.rb
+extra_rdoc_files: []
+files:
+- THIRD_PARTY_NOTICES
+- assets/JetBrainsMonoNL-Regular.ttf
+- assets/ark-pixel-12px-monospaced-ja.ttf
+- bin/gemba
+- ext/gemba/extconf.rb
+- ext/gemba/gemba_ext.c
+- ext/gemba/gemba_ext.h
+- gemba.gemspec
+- lib/gemba.rb
+- lib/gemba/child_window.rb
+- lib/gemba/cli.rb
+- lib/gemba/config.rb
+- lib/gemba/core.rb
+- lib/gemba/headless.rb
+- lib/gemba/headless_player.rb
+- lib/gemba/hotkey_map.rb
+- lib/gemba/input_mappings.rb
+- lib/gemba/locale.rb
+- lib/gemba/locales/en.yml
+- lib/gemba/locales/ja.yml
+- lib/gemba/method_coverage_service.rb
+- lib/gemba/overlay_renderer.rb
+- lib/gemba/player.rb
+- lib/gemba/recorder.rb
+- lib/gemba/recorder_decoder.rb
+- lib/gemba/rom_info_window.rb
+- lib/gemba/rom_loader.rb
+- lib/gemba/runtime.rb
+- lib/gemba/save_state_manager.rb
+- lib/gemba/save_state_picker.rb
+- lib/gemba/settings_window.rb
+- lib/gemba/tip_service.rb
+- lib/gemba/toast_overlay.rb
+- lib/gemba/version.rb
+- test/fixtures/test.gba
+- test/fixtures/test.sav
+- test/shared/screenshot_helper.rb
+- test/shared/simplecov_config.rb
+- test/shared/teek_test_worker.rb
+- test/shared/tk_test_helper.rb
+- test/support/input_mocks.rb
+- test/support/player_helpers.rb
+- test/test_cli.rb
+- test/test_config.rb
+- test/test_core.rb
+- test/test_gamepad_map.rb
+- test/test_headless_player.rb
+- test/test_helper.rb
+- test/test_hotkey_map.rb
+- test/test_keyboard_map.rb
+- test/test_locale.rb
+- test/test_mgba.rb
+- test/test_overlay_renderer.rb
+- test/test_player.rb
+- test/test_recorder.rb
+- test/test_rom_loader.rb
+- test/test_save_state_manager.rb
+- test/test_settings_hotkeys.rb
+- test/test_settings_window.rb
+- test/test_tip_service.rb
+- test/test_toast_overlay.rb
+- test/test_virtual_keyboard.rb
+- test/test_xor_delta.rb
+homepage: https://github.com/jamescook/gemba
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements:
+- libmgba development headers
+- rubyzip gem >= 2.4 (optional, for loading ROMs from .zip files)
+rubygems_version: 4.0.3
+specification_version: 4
+summary: GBA emulator frontend powered by teek and libmgba
+test_files: []