badline 0.12.1 → 0.13.0

data/lib/badline/kernal_trap/dos/channel.rb

@@ -0,0 +1,183 @@
+# frozen_string_literal: true
+
+module Badline
+  module KernalTrap
+    class DOS
+      # One open channel on the virtual drive, holding a file, a block buffer
+      # or the command channel's status message. It gives out one byte at a
+      # time and flags the last one, so the bus can raise EOI with it. A
+      # channel cut short by a read error never flags one, and holds the
+      # error for the drive to report once its bytes run out.
+      class Channel
+        attr_accessor :buffer
+        attr_reader :error, :pointer
+        attr_writer :lead
+
+        def initialize(bytes = [], error: nil, writable: false, base: 0)
+          @base = base
+          replace(bytes)
+          @error = error
+          @writable = writable
+        end
+
+        # A block buffer opened with "#", which reads and writes one of the
+        # drive's buffers in its RAM, so M-R and M-W reach the same bytes. It
+        # hands out the whole block unless a B-R sets a shorter end, and
+        # flags that byte as the last. The DOS opens it with the pointer at 1
+        # and the buffer's number as the byte to send, so the first read
+        # answers with the number and the next one moves on to the third
+        # byte.
+        def self.buffer(memory, number)
+          new(memory.ram, writable: true, base: Memory.buffer_address(number)).tap do |channel|
+            channel.buffer = number
+            channel.rewind(BLOCK_SIZE)
+            channel.pointer = 1
+            channel.lead = number
+          end
+        end
+
+        # A file's bytes, up to the first block its chain can't read. The
+        # drive reads a block ahead before sending the last byte of the one
+        # before, so a bad block holds that byte back too, and a bad first
+        # block or a missing file leaves nothing to send.
+        def self.for_file(storage, name, type)
+          data = storage.read_file(name, type:)
+          return new([], error: [FILE_NOT_FOUND]) unless data
+
+          failure = storage.respond_to?(:read_error) && storage.read_error(name, type:)
+          return new(data) unless failure
+
+          new(data[0, failure[:offset] - 1] || [], error: failure.values_at(:error, :track, :sector))
+        end
+
+        # The file an open names. The drive keeps the first block of the file
+        # a LOAD (secondary address 0) opens at $7E and $026F of its memory,
+        # and a LOAD of a name starting with "*" reopens that file rather than
+        # the first one on the disk. Loaders write the block there with M-W
+        # to load a file the directory doesn't list. A LOAD of "$" reads the
+        # directory as a BASIC program, which a pattern after a colon narrows
+        # to the files it names.
+        def self.for_name(storage, memory, secondary, name, type)
+          return new(storage.directory.bytes(name)) if listing?(storage, secondary, name)
+
+          file = Storage.parse_name(name).first
+          return for_file(storage, file, type) unless secondary.zero? && storage.respond_to?(:first_block)
+
+          last = memory.last_program if name.start_with?("*")
+          return at_block(storage, *last) if last
+
+          block = storage.first_block(file, type:)
+          memory.last_program = block if block
+          for_file(storage, file, type)
+        end
+
+        def self.listing?(storage, secondary, name)
+          secondary.zero? && name.start_with?("$") && storage.respond_to?(:directory)
+        end
+
+        # The file whose chain starts at the block.
+        def self.at_block(storage, track, sector)
+          data = storage.read_file_at(track, sector)
+          data ? new(data) : new([], error: [ILLEGAL_TRACK_OR_SECTOR, track, sector])
+        end
+
+        # Reads what save_state wrote after the flag that marks a file open
+        # for writing (Channels.channel_from_state). A buffer channel
+        # takes its block in `ram`, the drive's RAM, again.
+        def self.from_state(input, ram)
+          new.tap { |channel| channel.load_state(input, ram) }
+        end
+
+        # A buffer channel's bytes are the drive's RAM, which the drive
+        # writes itself.
+        def save_state(out)
+          out.boolean(false).boolean(@writable).int(@base).int(@length).int(@pointer)
+          out.optional_int(@lead).optional_int(@buffer).boolean(!@error.nil?)
+          out.ints(@error) if @error
+          out.blob(@bytes) unless @writable
+        end
+
+        def load_state(input, ram)
+          @writable = input.boolean?
+          @base = input.int
+          @length = input.int
+          @pointer = input.int
+          @lead = input.optional_int
+          @buffer = input.optional_int
+          @error = input.boolean? ? input.ints : nil
+          @bytes = @writable ? ram : input.blob
+        end
+
+        def replace(bytes, length = bytes.length)
+          @bytes = bytes
+          rewind(length)
+        end
+
+        def rewind(length)
+          @length = length
+          self.pointer = 0
+        end
+
+        def pointer=(position)
+          @pointer = position
+          @lead = nil
+        end
+
+        # A block read into the channel. A buffer channel takes it into its
+        # buffer, a file channel hands it out in place of the file.
+        def load(block, length)
+          return replace(block.dup, length) unless @writable
+
+          @bytes[@base, block.length] = block
+          rewind(length)
+        end
+
+        def writable? = @writable
+
+        # A buffer channel's block, as a block write puts it on the disk.
+        def block = @bytes[@base, BLOCK_SIZE]
+
+        def exhausted?
+          @pointer >= @length
+        end
+
+        # A file that holds nothing but its error never opened.
+        def failed?
+          exhausted? && !@error.nil?
+        end
+
+        # Each byte lands at the pointer, which wraps within the block.
+        def write(bytes)
+          @lead = nil
+          bytes.each do |byte|
+            @bytes[@base + @pointer] = byte
+            @pointer = (@pointer + 1) & 0xff
+          end
+        end
+
+        def read
+          return read_buffer if @writable
+          return if exhausted?
+
+          byte = @lead || @bytes[@base + @pointer]
+          @lead = nil
+          @pointer += 1
+          [byte, exhausted? && !@error]
+        end
+
+        private
+
+        # A buffer never runs out. Past its last byte, which goes out with
+        # EOI, the pointer wraps back to the second, and a pointer set past
+        # the end runs on around the block to it.
+        def read_buffer
+          byte = @lead || @bytes[@base + @pointer]
+          @lead = nil
+          last = @pointer == @length - 1
+          @pointer = last ? 1 : (@pointer + 1) & 0xff
+          [byte, last]
+        end
+      end
+    end
+  end
+end

data/lib/badline/kernal_trap/{drive → dos}/channels.rb

@@ -2,7 +2,7 @@
 
 module Badline
   module KernalTrap
-    class Drive
+    class DOS
       # The drive's open data channels by secondary address, and the five
       # buffers they hold. The DOS hands out the highest free buffer.
       # Reading the BAM when it initializes the disk takes buffer 4, so

data/lib/badline/kernal_trap/{drive → dos}/memory.rb

@@ -2,7 +2,7 @@
 
 module Badline
   module KernalTrap
-    class Drive
+    class DOS
       # The drive's 2K of RAM, as M-W and M-R reach it, with the job queue
       # that runs a read job written into it: a job code for each of five
       # buffers at $00, their track and sector pairs from $06, and the

data/lib/badline/kernal_trap/{drive → dos}/parameters.rb

@@ -2,7 +2,7 @@
 
 module Badline
   module KernalTrap
-    class Drive
+    class DOS
       # The numbers a DOS command takes. The DOS skips spaces, commas and
       # cursor-rights before a parameter, reads it from the characters $30
       # to $3F that follow, the low nibble of each, and skips whatever

data/lib/badline/kernal_trap/{drive → dos}/status.rb

@@ -2,7 +2,7 @@
 
 module Badline
   module KernalTrap
-    class Drive
+    class DOS
       # The command channel's side of the drive: the last DOS error with the
       # track and sector it happened at, or the bytes an M-R read. Once its
       # last byte has been read, it holds OK again.

data/lib/badline/kernal_trap/{drive → dos}/write_file.rb

@@ -2,7 +2,7 @@
 
 module Badline
   module KernalTrap
-    class Drive
+    class DOS
       # A channel open for writing a file. It gathers the bytes sent to it,
       # and the drive writes the file to the disk when the channel closes.
       # An append starts from the file's end, a replace writes over the

data/lib/badline/kernal_trap/{drive → dos}/writes.rb

@@ -2,7 +2,7 @@
 
 module Badline
   module KernalTrap
-    class Drive
+    class DOS
       # Opens for writing, the S command and the reports a write makes. A
       # file open for writing takes the type its name asks for, or SEQ on a
       # data channel. On a write-protected disk, or storage that doesn't

data/lib/badline/kernal_trap/{drive.rb → dos.rb}

@@ -1,12 +1,13 @@
 # frozen_string_literal: true
 
-require "badline/kernal_trap/drive/block_commands"
-require "badline/kernal_trap/drive/channels"
-require "badline/kernal_trap/drive/memory"
-require "badline/kernal_trap/drive/parameters"
-require "badline/kernal_trap/drive/status"
-require "badline/kernal_trap/drive/writes"
-require "badline/kernal_trap/drive/write_file"
+require "badline/kernal_trap/dos/block_commands"
+require "badline/kernal_trap/dos/channel"
+require "badline/kernal_trap/dos/channels"
+require "badline/kernal_trap/dos/memory"
+require "badline/kernal_trap/dos/parameters"
+require "badline/kernal_trap/dos/status"
+require "badline/kernal_trap/dos/writes"
+require "badline/kernal_trap/dos/write_file"
 
 module Badline
   module KernalTrap
@@ -16,7 +17,7 @@ module Badline
     # LOAD. A disk image whose host file takes writes takes files, blocks
     # and BAM changes too. Other disks are write-protected, though storage
     # that can write files still takes a SAVE handed over whole.
-    class Drive
+    class DOS
       include BlockCommands
       include Writes
 
@@ -146,10 +147,10 @@ module Badline
       # vector, as U: does.
       def reset! = reset(cold: true)
 
-      # The mounted storage's setup, for Storage.reopen, then the drive's
+      # The mounted storage's setup (Snapshot::StorageSetup), then the drive's
       # RAM, its status and its open channels.
       def save_state(out)
-        @storage.save_setup(out)
+        Snapshot::StorageSetup.write(@storage, out)
         out.marker("TRAP DRIVE")
         @memory.save_state(out)
         @status.save_state(out)

data/lib/badline/kernal_trap/load.rb

@@ -23,9 +23,9 @@ module Badline
       # address even when the first one relocated.
       LOAD_SECONDARY = 0x60
 
-      def initialize(cpu:, bus:, layout:, drive:)
+      def initialize(cpu:, bus:, layout:, dos:)
         super(cpu:, bus:, layout:)
-        @drive = drive
+        @dos = dos
       end
 
       def call
@@ -38,7 +38,7 @@ module Badline
 
         data, complete = receive(name)
         if low_memory?(data)
-          @drive.close(0)
+          @dos.close(0)
         else
           finish(data, complete)
         end
@@ -50,10 +50,10 @@ module Badline
       # flagged EOI. A read error in the file's chain stops the bytes early,
       # with no EOI.
       def receive(name)
-        @drive.open(0, name)
+        @dos.open(0, name)
         data = []
         loop do
-          byte, eoi = @drive.read(0)
+          byte, eoi = @dos.read(0)
           return [data, false] unless byte
 
           data << byte

data/lib/badline/kernal_trap/save.rb

@@ -21,9 +21,9 @@ module Badline
       # ST bit at $90
       DEVICE_NOT_PRESENT = 0x80
 
-      def initialize(cpu:, bus:, layout:, drive:)
+      def initialize(cpu:, bus:, layout:, dos:)
         super(cpu:, bus:, layout:)
-        @drive = drive
+        @dos = dos
         @saving = false
       end
 
@@ -38,7 +38,7 @@ module Badline
       def call
         return unless active?
         return finish if @saving
-        return unless @drive.saves?
+        return unless @dos.saves?
 
         @bus.poke(0xb9, SECONDARY)
         return @cpu.program_counter = @layout.missing_file_name_exit if name.empty?
@@ -56,7 +56,7 @@ module Badline
 
       def finish
         @saving = false
-        saved = @drive.save(name, payload, replace: full_filename.start_with?("@"))
+        saved = @dos.save(name, payload, replace: full_filename.start_with?("@"))
         @bus.poke(0x90, DEVICE_NOT_PRESENT) unless saved
         @bus.poke(0xac, @bus.peek(0xae))
         @bus.poke(0xad, @bus.peek(0xaf))

data/lib/badline/kernal_trap/serial.rb

@@ -23,9 +23,9 @@ module Badline
 
       NO_DATA = [0x0d, EOI | READ_TIMEOUT].freeze
 
-      def initialize(cpu:, bus:, layout:, drive:, device: DEVICE)
+      def initialize(cpu:, bus:, layout:, dos:, device: DEVICE)
         super(cpu:, bus:, layout:)
-        @drive = drive
+        @dos = dos
         @device = device
         @listening = false
         @talking = false
@@ -144,7 +144,7 @@ module Badline
       # takes data only on a channel it has open. Otherwise nothing holds
       # the data line when a byte starts, so the KERNAL finds no device.
       def accepted?
-        [OPEN, CLOSE].include?(@frame) || @drive.listening?(@listen_channel)
+        [OPEN, CLOSE].include?(@frame) || @dos.listening?(@listen_channel)
       end
 
       def unlisten
@@ -188,15 +188,15 @@ module Badline
         return unless @listen_channel
 
         case @frame
-        when OPEN then @drive.open(@listen_channel, @buffer.pack("C*"))
-        when CLOSE then @drive.close(@listen_channel)
-        else @drive.write(@listen_channel, @buffer)
+        when OPEN then @dos.open(@listen_channel, @buffer.pack("C*"))
+        when CLOSE then @dos.close(@listen_channel)
+        else @dos.write(@listen_channel, @buffer)
         end
         @buffer = []
       end
 
       def received
-        byte, eoi = @drive.read(@talk_channel)
+        byte, eoi = @dos.read(@talk_channel)
         return NO_DATA unless byte
 
         [byte, eoi ? EOI : 0]

data/lib/badline/kernal_trap.rb

@@ -2,8 +2,7 @@
 
 require "badline/kernal_trap/layout"
 require "badline/kernal_trap/routine"
-require "badline/kernal_trap/channel"
-require "badline/kernal_trap/drive"
+require "badline/kernal_trap/dos"
 require "badline/kernal_trap/file_routine"
 require "badline/kernal_trap/load"
 require "badline/kernal_trap/save"

data/lib/badline/machine/clocking.rb

@@ -3,7 +3,7 @@
 module Badline
   module Machine
     # Running a machine from outside its own #cycle!, and the handlers that
-    # wait for its KERNAL to boot. Computer, Vic20 and C128 each include it
+    # wait for its KERNAL to boot. C64, Vic20 and C128 each include it
     # and answer #cycle!, #cycles and #init_threshold, the cycle at which
     # #on_init's handlers run, and keep the handlers in @init_handlers.
     module Clocking

data/lib/badline/machine.rb

@@ -6,7 +6,7 @@ module Badline
   # = Machine
   #
   # The machines badline builds by family, as the command line's
-  # subcommand names them: the C64, Computer, the VIC-20, Vic20, and the
+  # subcommand names them: the C64, Badline::C64, the VIC-20, Vic20, and the
   # C128 in C64 mode, C128.
   #
   # A machine answers what the front end, Media, the runners and the
@@ -28,7 +28,7 @@ module Badline
   #   +press_cartridge_button+, +release_cartridge_button+,
   #   +attach_drive1541+, +drive1541+, +true_drive+ and +plug_true_drive+
   #   for the drive Media::TrueDrive plugs in, +attach_drive1581+,
-  #   +drive1581+ and +plug_drive1581+ for a 1581 (Drive1581::Slot), and
+  #   +drive1581+ and +plug_drive1581+ for a 1581 (Drives::Model1581::Slot), and
   #   +address_bus+ for its +cartridge+ and +detach_cartridge+.
   # - Snapshots and tests: +snapshot+, +restore+, +save_snapshot+,
   #   +install_debug_register+ and +capture_output+.
@@ -65,9 +65,9 @@ module Badline
       raise ArgumentError, "no machine family named #{family}" unless family == :c64
 
       profile = Model.named(model)
-      Computer.new(vic_model: profile.vic_model, cia_model: profile.cia_model,
-                   sid_model: sid_model || profile.sid_model, region: profile.region, reu:,
-                   kernal: profile.kernal, datasette: profile.datasette, board: profile.board)
+      C64.new(vic_model: profile.vic_model, cia_model: profile.cia_model,
+              sid_model: sid_model || profile.sid_model, region: profile.region, reu:,
+              kernal: profile.kernal, datasette: profile.datasette, board: profile.board)
     end
 
     # The machine the command line's `options` name, to start `media`, a

data/lib/badline/media/true_drive.rb

@@ -9,7 +9,7 @@ module Badline
     # disk's raw GCR, which only a true drive reads, so it plugs one in
     # when there's none yet. The 1541 reads only .d64 and .g64 images, the
     # 1571 .d71 and .g71 as well, and the 1581 only .d81, so a .d81 swaps
-    # the drive on device 8 for a 1581 (Drive1581::Slot), and another disk
+    # the drive on device 8 for a 1581 (Drives::Model1581::Slot), and another disk
     # image swaps a 1581 back for the machine's own drive. The traps' other
     # disk media, a .t64 or a host directory, raise Error.
     module TrueDrive

data/lib/badline/media/tune.rb

@@ -10,9 +10,9 @@ module Badline
         # Plays `subtune`, or the tune's own start subtune, and says what
         # plays. A tune for more than one SID raises FormatError.
         def attach(computer, path, autostart:, subtune:)
-          tune = Storage::SIDFile.new(path)
+          tune = SIDTune::File.new(path)
           if tune.sids > 1
-            raise Storage::SIDFile::FormatError, "Written for #{tune.sids} SIDs, which only the SID player plays"
+            raise SIDTune::File::FormatError, "Written for #{tune.sids} SIDs, which only the SID player plays"
           end
 
           subtune = (subtune || tune.start_subtune).clamp(1, tune.subtunes)

data/lib/badline/media.rb

@@ -4,7 +4,7 @@ require "badline/media/extensions"
 require "badline/media/true_drive"
 require "badline/media/boot_disk"
 require "badline/media/not_disk"
-require "badline/media/queue"
+require "badline/audio/queue"
 require "badline/media/disk_set"
 require "badline/media/disk_list"
 require "badline/media/vic20_basic"
@@ -83,7 +83,7 @@ module Badline
       def sid_model(path, otherwise: :mos6581)
         return otherwise unless path && Extensions.kind(path) == :tune
 
-        Storage::SIDFile.new(path).sid_model
+        SIDTune::File.new(path).sid_model
       end
 
       # What the medium at `path` is to `computer`, which attach goes by:
@@ -156,7 +156,7 @@ module Badline
         if computer.family == :vic20
           computer.attach_cartridge(Storage::CRTFile.new(path, machine: :vic20).chips)
         else
-          computer.attach_cartridge(Cartridge.from_file(path, **options))
+          computer.attach_cartridge(C64::Cartridge.from_file(path, **options))
         end
         "Attached cartridge #{path}"
       end

data/lib/badline/model.rb

@@ -7,7 +7,7 @@ module Badline
   # each was sold with, its video standard, its KERNAL and whether it has
   # a datasette. The names are x64sc's.
   module Model
-    # Each field but the name is a keyword Computer.new takes.
+    # Each field but the name is a keyword C64.new takes.
     Profile = Data.define(:name, :vic_model, :cia_model, :sid_model, :region, :kernal, :datasette, :board)
 
     # The breadbin PAL C64: the 6569 VIC-II, 6526 CIAs and the 6581 SID.

data/lib/badline/roms/README

@@ -20,7 +20,7 @@ The character generator ROM.
 kernal-sx64.rom
 ---------------
 The SX-64's KERNAL, 251104-04. It boots with the SX-64's banner and
-colours, and loads from device 8 rather than tape. Computer.new(kernal:
+colours, and loads from device 8 rather than tape. C64.new(kernal:
 :sx64) fits it, as --model sx64 does.
 
 Downloaded from
@@ -32,7 +32,7 @@ kernal-pet64.rom
 The KERNAL of the PET 64, 4064 and Educator 64, 901246-01. It boots
 with the "**** COMMODORE 4064  BASIC V2.0 ****" banner and a white
 cursor, and its interrupt routine keeps the border, background and
-sprite colours black unless bit 7 of $0286 is set. Computer.new(kernal:
+sprite colours black unless bit 7 of $0286 is set. C64.new(kernal:
 :pet64) fits it, as --model pet64 does.
 
 Downloaded from
@@ -45,7 +45,7 @@ The C64GS's BASIC and KERNAL, 390852-01, 16 KB: BASIC for $A000-$BFFF
 followed by the KERNAL for $E000-$FFFF. Its BASIC is 901226-01's but
 for 30 unused bytes. Its KERNAL is 901227-03's with most changes in
 $F72C-$FC92, the cassette routines' place, and many jumps redirected to
-I/O error 5. Computer.new(kernal: :gs) fits both, as --model c64gs does.
+I/O error 5. C64.new(kernal: :gs) fits both, as --model c64gs does.
 
 Downloaded from
 https://www.zimmers.net/anonftp/pub/cbm/firmware/computers/c64/64gs.390852-01.bin
@@ -54,7 +54,7 @@ MD5 049e657afafbdd802e8c6a4f88f3d730.
 dos1541.rom
 -----------
 The 1541 disk drive's DOS 2.6, 16 KB for $C000-$FFFF: 325302-01
-($C000-$DFFF) followed by 901229-05 ($E000-$FFFF). Drive1541 loads it.
+($C000-$DFFF) followed by 901229-05 ($E000-$FFFF). Drives::Model1541 loads it.
 
 Both halves downloaded from
 https://www.zimmers.net/anonftp/pub/cbm/firmware/drives/new/1541/
@@ -64,7 +64,7 @@ SHA-1 ab16f56989b27d89babe5f89c5a8cb3da71a82f0.
 dos1571.rom
 -----------
 The 1571 disk drive's DOS 3.0, 310654-05, 32 KB for $8000-$FFFF.
-Drive1571 loads it.
+Drives::Model1571 loads it.
 
 Downloaded from
 https://www.zimmers.net/anonftp/pub/cbm/firmware/drives/new/1571/1571-rom.310654-05.bin
@@ -73,7 +73,7 @@ SHA-1 f1be619c106641a685f6609e4d43d6fc9eac1e70.
 dos1581.rom
 -----------
 The 1581 disk drive's DOS, 318045-02, 32 KB for $8000-$FFFF.
-Drive1581 loads it.
+Drives::Model1581 loads it.
 
 Downloaded from
 https://www.zimmers.net/anonftp/pub/cbm/firmware/drives/new/1581/1581-rom.318045-02.bin

data/lib/badline/sdl.rb

@@ -58,6 +58,7 @@ module Badline
     ffi_func :SDL_ClearQueuedAudio, [:uint32], :void
     ffi_func :SDL_PushEvent, [:ptr], :int
     ffi_func :SDL_GetKeyName, [:int], :str
+    ffi_func :SDL_StopTextInput, [], :void
 
     ffi_buffer :rect, 16
     ffi_write_i32 :rect_x, 0

data/lib/badline/{storage/sid_file.rb → sid_tune/file.rb}

@@ -3,10 +3,10 @@
 require "digest"
 
 module Badline
-  module Storage
+  module SIDTune
     # PSID/RSID tunes: a memory image plus the addresses of the routines
     # that initialise it and produce one frame of music.
-    class SIDFile
+    class File
       include IntegerHelper
 
       class FormatError < StandardError; end
@@ -147,7 +147,7 @@ module Badline
       attr_reader :format
 
       def initialize(path)
-        @bytes = File.binread(path).bytes
+        @bytes = ::File.binread(path).bytes
         @format = @bytes[0, 4].pack("C*")
         raise FormatError, "Missing PSID or RSID signature" unless %w[PSID RSID].include?(@format)
         raise FormatError, "Truncated header" if truncated?

data/lib/badline/{storage → sid_tune}/hvsc.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Badline
-  module Storage
+  module SIDTune
     # The layout of an HVSC collection: tunes in directories under its root,
     # and databases about them in `DOCUMENTS`. A tune's HVSC path is its path
     # from the root, as `/MUSICIANS/H/Hubbard_Rob/Commando.sid`.
@@ -10,15 +10,15 @@ module Badline
         # The named file in the DOCUMENTS directory of a collection above the
         # tune, or else of the one `$HVSC_BASE` points at.
         def document(tune_path, name)
-          candidates(tune_path).map { |dir| File.join(dir, "DOCUMENTS", name) }
-                               .find { |path| File.file?(path) }
+          candidates(tune_path).map { |dir| ::File.join(dir, "DOCUMENTS", name) }
+                               .find { |path| ::File.file?(path) }
         end
 
         # The tune's HVSC path in the collection that holds the document, or
         # nil when the tune lies outside it.
         def path(tune_path, document)
-          root = File.dirname(File.expand_path(document), 2)
-          tune = File.expand_path(tune_path)
+          root = ::File.dirname(::File.expand_path(document), 2)
+          tune = ::File.expand_path(tune_path)
           tune.start_with?("#{root}/") ? tune[root.length..] : nil
         end
 
@@ -26,10 +26,10 @@ module Badline
 
         def candidates(tune_path)
           dirs = []
-          dir = File.dirname(File.expand_path(tune_path))
+          dir = ::File.dirname(::File.expand_path(tune_path))
           until dirs.last == dir
             dirs << dir
-            dir = File.dirname(dir)
+            dir = ::File.dirname(dir)
           end
           base = ENV.fetch("HVSC_BASE", nil)
           dirs << base if base

data/lib/badline/{storage → sid_tune}/song_lengths.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Badline
-  module Storage
+  module SIDTune
     # HVSC's subtune length database. Each tune gets a comment naming its path
     # and a line keyed by the MD5 of the whole `.sid` file, holding one
     # `m:ss` time per subtune, optionally down to milliseconds:
@@ -23,7 +23,7 @@ module Badline
       # The tune's per-subtune lengths in seconds, or nil when it isn't listed.
       def lengths(md5)
         prefix = "#{md5.downcase}="
-        File.foreach(@path) do |line|
+        ::File.foreach(@path) do |line|
           next unless line.start_with?(prefix)
 
           return line[prefix.length..].split.map { |time| seconds(time) }

data/lib/badline/{storage → sid_tune}/stil/credit.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Badline
-  module Storage
+  module SIDTune
     class STIL
       # A TITLE in a STIL entry, the tune a subtune covers, with the ARTIST
       # after it, and the stretch of the subtune it covers when the title