rakpak 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 98de68901620153b4b19a5ff3ccf6b9757f8e718db3a4bcef3d70b81b75e5a76
-  data.tar.gz: 5b7a9592e10e1b4181d4ba5aceaba0dc8fc70e6b3286f6660e4e10cdc9b4c287
+  metadata.gz: 2eb31aeb19c23cee757195d888132a931ea62030b0df07e88585c9e15fa5eea1
+  data.tar.gz: 9edb48577409aa19d2f1cb03115c881b2a7a1c755ccc8005d419e95428266db3
 SHA512:
-  metadata.gz: 544d49d201309db5d5d90fb692f78e7e103280b06f7373ad872f21cc90374763c650da2f02fb5f006303e7dbd296df8d32f2f6d8eb7924b096d15d3960c5ef8b
-  data.tar.gz: 802d440f759bf5648199f07e6b98b934eda43e94b08133cdb3c07da9bed16b900cb2c0456c436ef9f2932bc4a3bcc26dbdd70b6c13b31722007864ee622c047f
+  metadata.gz: d629766dd61b2c108c34e500a38e73cb465262ec36454d1e8714572f6104359cecc8712fbef2314a784d2070681a15fa821c081e39e292eb42794bdd508e0f10
+  data.tar.gz: cd9fae98590a0d321f061588eebece2f015a74937a58c345a46d4f6b18b1a04492c85b7e1c11a474397d9fded85173bbb4d4fe1032974f03c3c33550eb08ffc4

data/README.md

@@ -76,13 +76,18 @@ exit status is non-zero if any of them failed.
 3. **Set the flags.** Compression method, level, and the switches for that
    format. Compressed tarballs default to gzip, the one every system can
    read.
-4. **Say where.** This directory, your home directory, or one you type
+4. **Leave things out.** Type names separated by commas, like
+   `node_modules, .cache, *.log`. Each one is left out wherever it turns
+   up, along with everything inside it. Or pick *Tag files and directories*
+   to walk the folders you are packing and press `space` on the exact spots
+   to skip; `p` brings you back. Skipped when only files are packed.
+5. **Say where.** This directory, your home directory, or one you type
    into the field right there. `~`, `$HOME` and absolute paths all work,
    and typing anything jumps to the field.
-5. **Name it.** The extension is added for you.
-6. **Confirm.** You see the exact command before anything runs. Only `enter`
+6. **Name it.** The extension is added for you.
+7. **Confirm.** You see the exact command before anything runs. Only `enter`
    starts it.
-7. **Watch it, or press `b`** to drop it into the background and keep browsing.
+8. **Watch it, or press `b`** to drop it into the background and keep browsing.
 
 If nothing is tagged, `p` archives whatever the cursor is on.
 
@@ -115,8 +120,9 @@ files that were already there are never touched.
 | `ctrl-d` `ctrl-u` | half page |
 | `gh` `~` / `gr` | home / root |
 | `space` | tag or untag, then move down |
+| `x` | exclude or include, then move down: left out of anything packed around it |
 | `a` / `d` | tag / untag everything in this folder |
-| `D` | clear all tags |
+| `D` | clear all tags and exclusions |
 | `T` | review tagged items (`space` removes) |
 | `t` | show or hide the queue pane |
 | `/` | filter this folder |

data/lib/rakpak/app.rb

@@ -11,8 +11,6 @@ require_relative "job"
 require_relative "sizer"
 
 module Rakpak
-  # Review panel for the tag set: the one place to see everything picked up
-  # across the filesystem, and drop entries without walking back to them.
   class TagsModal < Modal
     def initialize(tags:, sizer:)
       super(title: "tagged", footer: "space/d remove · D clear all · esc back")
@@ -63,11 +61,9 @@ module Rakpak
 
   class App
     SPINNER = "⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏"
-    WIZARD = %i[target options where output confirm].freeze
+    WIZARD = %i[target options exclude where output confirm].freeze
     UNPACK = %i[dest_where dest_name unpack_confirm].freeze
 
-    # `pack` is a list of paths to tag before the first frame; when it is
-    # non-empty the archive prompts open immediately (rakpak -p).
     def initialize(start_dir = Dir.home, pack: [])
       @sizer = Sizer.new
       @browser = Browser.new(start_dir, sizer: @sizer)
@@ -113,8 +109,7 @@ module Rakpak
 
     private
 
-    # The quit dialog promises running jobs are stopped. Give each a moment
-    # to remove its half-written archive before the terminal is handed back.
+    # Give jobs a moment to remove half-written archives before the terminal is restored.
     def stop_jobs
       running = @jobs.select(&:running?)
       return if running.empty?
@@ -160,8 +155,6 @@ module Rakpak
        "#{Text.bytes(j.output_size)} · #{Text.duration(j.elapsed)}#{more}   [b] jobs", Theme::ACCENT]
     end
 
-    # ------------------------------------------------------------- drawing
-
     MIN_W = 40
     MIN_H = 10
 
@@ -197,8 +190,6 @@ module Rakpak
       @screen.put([(@screen.w - Text.width(want)) / 2, 0].max, (@screen.h / 2) + 1, want, Theme::DIM)
     end
 
-    # Only the running state says which direction the work goes; the rest
-    # read the same either way.
     def job_title(job, state)
       case state
       when :running then job.plan.gerund
@@ -218,7 +209,6 @@ module Rakpak
 
       y = 2
       job.plan.outputs.each do |out|
-        # A folder being extracted into has no size worth showing.
         size = begin
           File.directory?(out) ? nil : File.size(out)
         rescue StandardError
@@ -260,7 +250,7 @@ module Rakpak
 
       s.hline(0, y, s.w, Theme::BORDER)
       y += 1
-      rows = [s.h - y - 1, 0].max # a very short terminal leaves no room at all
+      rows = [s.h - y - 1, 0].max
       job.tail(rows).each_with_index do |line, i|
         style = if line.start_with?("▸") then Theme::ACCENT
                 elsif line.match?(/error|cannot|denied|warning/i) then Theme::WARN
@@ -287,8 +277,6 @@ module Rakpak
       end
     end
 
-    # ------------------------------------------------------------ dispatch
-
     def dispatch(key)
       return modal_key(key) if @modal
       return job_key(key) if @mode == :job
@@ -300,6 +288,8 @@ module Rakpak
       when :tags then open_tags
       when :help then open_help
       when :jobs then open_jobs
+      when :resume then resume_wizard
+      when :unmarkable then notify("that one is being packed; untag it instead", Theme::WARN)
       end
     end
 
@@ -316,12 +306,12 @@ module Rakpak
         end
       when :enter
         @mode = :browse unless job.running?
-      when "q" then request_quit # the footer says quit, so it quits
+      when "q" then request_quit
       end
     end
 
     def modal_key(key)
-      # ctrl-c backs out of any panel; raw mode delivers it as a keystroke.
+      # Raw mode delivers ctrl-c as a keystroke.
       res = key == :ctrl_c ? :cancel : @modal.handle(key)
       return if res.nil?
 
@@ -340,13 +330,12 @@ module Rakpak
         return
       end
 
-      return unless @wizard_pos
+      # While exclusions are being marked the wizard is paused; help closing must not move it.
+      return if @wizard_pos.nil? || @browser.scoped?
 
       res == :done ? wizard_forward(modal) : wizard_back
     end
 
-    # -------------------------------------------------------------- wizard
-
     def start_wizard
       sel = @browser.selection
       if sel.empty?
@@ -359,6 +348,7 @@ module Rakpak
       sel.each { |p| @sizer.request(p) }
       @plan = Plan.new(paths: sel, outdir: @browser.cwd)
       @name_edited = false
+      @exclude_text = ""
       @where = 0
       @where_text = ""
       @wizard = WIZARD
@@ -366,8 +356,6 @@ module Rakpak
       open_wizard_step
     end
 
-    # Unpacking follows the cursor rather than the tag set: an archive is one
-    # thing with one destination, not a pile to gather up.
     def start_unpack
       e = @browser.current
       unless e && File.file?(e.path) && Unpack.archive?(e.path)
@@ -391,10 +379,6 @@ module Rakpak
       open_wizard_step
     end
 
-    # A lone file loses its extension ("notes.txt" becomes notes.tar.gz)
-    # unless the output is that file compressed on its own (notes.txt.gz).
-    # A folder keeps its name whole, dots and all. Several items take the
-    # folder name.
     def default_basename(sel)
       name = if sel.size > 1 then File.basename(@browser.cwd)
              elsif File.directory?(sel.first) || @plan&.single_compress? then File.basename(sel.first)
@@ -419,8 +403,8 @@ module Rakpak
     end
 
     def wizard_forward(modal)
-      apply_step(@wizard[@wizard_pos], modal)
-      return if @wizard_pos.nil? # a step may have ended the wizard itself
+      # A step may have ended the wizard itself, or paused it.
+      return if apply_step(@wizard[@wizard_pos], modal) == :paused || @wizard_pos.nil?
 
       @wizard_pos += 1
       open_wizard_step
@@ -446,6 +430,7 @@ module Rakpak
       case step
       when :target then target_modal
       when :options then options_modal
+      when :exclude then exclude_modal
       when :where then where_modal
       when :output then output_modal
       when :confirm then confirm_modal
@@ -458,11 +443,15 @@ module Rakpak
     def apply_step(step, modal)
       case step
       when :target then @plan.target = modal.result
+      when :exclude
+        @exclude_text = modal.text
+        return pick_excludes if modal.result == :tag
+
+        @plan.excludes = Plan.parse_excludes(modal.text)
       when :where
         @where = modal.index
         @where_text = modal.text
-        # ~ and $HOME are for typed text; a browsed folder is taken as is,
-        # even one with a dollar sign in its name.
+        # Only typed text expands ~ and $HOME; a browsed folder may contain a literal $.
         @plan.outdir = @where == 2 ? Rakpak.expand_dir(modal.result) : modal.result
       when :output
         @name_edited = true
@@ -518,7 +507,6 @@ module Rakpak
       end
     end
 
-    # A codec, its level, then that format's switches.
     def codec_form(side, title:, label:, flags_label:, flags_when_container: false)
       rows = [
         FormModal::Row.new(kind: :choice, label: label, hint: "", values: side.choices,
@@ -540,6 +528,25 @@ module Rakpak
       end
     end
 
+    # Nothing to exclude from inside a lone file.
+    def exclude_modal
+      return nil unless @plan.paths.any? { |p| File.directory?(p) }
+
+      @plan.excluded = @browser.excludes.to_a
+      ExcludeModal.new(text: @exclude_text,
+                       marked: @plan.excluded.map { |p| @plan.relative(p) })
+    end
+
+    def pick_excludes
+      @browser.scope_to(@plan.paths, @plan.base)
+      :paused
+    end
+
+    def resume_wizard
+      @browser.leave_scope
+      open_wizard_step
+    end
+
     def where_modal
       WhereModal.new(here: @browser.cwd, home: Dir.home, index: @where, text: @where_text,
                      validate: method(:writable_folder))
@@ -557,7 +564,6 @@ module Rakpak
                      validate: method(:writable_folder), title: "unpack it where?")
     end
 
-    # nil when there is no folder to name, which open_wizard_step skips over.
     def dest_name_modal
       return nil if @plan.single?
 
@@ -565,16 +571,12 @@ module Rakpak
                      value: @dest_name,
                      hint: "a new folder in #{Text.tilde(@dest_parent)}  ·  . unpacks straight in",
                      validate: lambda { |name|
-                       # The folder was chosen on the previous screen, so this
-                       # is a bare name and can never reach outside it.
                        if name.include?("/") then "just a name, no slashes; the folder was picked already"
                        elsif name.include?("\0") || name == ".." then "not a valid name"
                        end
                      })
     end
 
-    # "." is how you say "no subfolder, straight into the folder I picked",
-    # and a lone compressed file never has one to begin with.
     def sync_dest
       @plan.dest = @dest_name == "." ? @dest_parent : File.join(@dest_parent, @dest_name)
     end
@@ -599,8 +601,6 @@ module Rakpak
                      value: @plan.basename,
                      hint: "in #{Text.tilde(@plan.outdir)}  ·  #{@plan.ext} added automatically",
                      validate: lambda { |name|
-                       # The folder was chosen on the previous screen; this is
-                       # a bare filename, so it can never reach outside it.
                        if name.include?("/") then "just a name, no slashes; the folder was picked already"
                        elsif name.include?("\0") || [".", ".."].include?(name) then "not a valid name"
                        end
@@ -611,9 +611,12 @@ module Rakpak
       lines = []
       lines << [:head, "#{@plan.paths.size} item#{'s' unless @plan.paths.size == 1} " \
                        "from #{Text.tilde(@plan.base)}"]
-      @plan.members.first(6).each { |m| lines << [:key, "   #{m}"] }
-      lines << [:key, "   … #{@plan.members.size - 6} more"] if @plan.members.size > 6
-      lines << [:key, ""]
+      lines.concat(listing(@plan.members))
+      if @plan.excludes.any? || @plan.excluded.any?
+        lines << [:head, "leaves out"]
+        lines << [:key, "   #{@plan.excludes.join(', ')}"] if @plan.excludes.any?
+        lines.concat(listing(@plan.excluded.map { |p| @plan.relative(p) }))
+      end
       lines << [:head, "writes #{Text.tilde(@plan.output)}"]
       lines << [:key, ""]
       @plan.preview.each do |label, cmd|
@@ -625,11 +628,16 @@ module Rakpak
                        warnings: @plan.warnings, errors: @plan.problems)
     end
 
+    def listing(names)
+      lines = names.first(6).map { |m| [:key, "   #{m}"] }
+      lines << [:key, "   … #{names.size - 6} more"] if names.size > 6
+      lines << [:key, ""]
+    end
+
     def finish_wizard
       @wizard_pos = nil
     end
 
-    # Always opens the job view; b from there sends it to the background.
     def launch
       job = Job.new(@plan, total_files: @plan.total_members(@sizer)).start
       @jobs << job
@@ -654,8 +662,6 @@ module Rakpak
       end
     end
 
-    # --------------------------------------------------------------- panels
-
     def open_tags
       list = @browser.tags.to_a.sort
       modal = TagsModal.new(tags: list, sizer: @sizer)
@@ -679,8 +685,9 @@ module Rakpak
         ["g g", "top"], ["G", "bottom"], ["ctrl-d ctrl-u", "half page"],
         ["g h", "home"], ["g r", "root"], ["~", "home"],
         ["space", "tag / untag, then move down"],
+        ["x", "exclude / include, then move down"],
         ["a", "tag everything here"], ["d", "untag everything here"],
-        ["D", "clear all tags"], ["T", "review tagged items"],
+        ["D", "clear all tags and exclusions"], ["T", "review tagged items"],
         ["t", "show / hide the queue pane"],
         ["/", "filter this folder"], [".", "show hidden"],
         ["ctrl-r", "reload"],
@@ -714,16 +721,12 @@ module Rakpak
       return if done.empty?
 
       done.each do |j|
-        # Printed after the TUI has gone, straight to the shell, so a folder
-        # or file name carrying an escape sequence must be defanged.
+        # Printed to the shell after the TUI exits, so defang escape sequences in names.
         puts "#{Text.plain(j.plan.outputs.first)}  #{Text.plain(j.plan.report_note)}"
       end
     end
   end
 
-  # The option form follows the codec the user just picked: the level row
-  # takes that codec's range, and rows that only apply to a zip container
-  # (its switches) appear only while a container method is selected.
   class DynamicForm < FormModal
     def initialize(title:, rows:, side:, extra: [], extra_when_container: false)
       super(title: title, rows: rows + extra)

data/lib/rakpak/browser.rb

@@ -2,24 +2,28 @@
 
 require "set"
 require_relative "dir_cache"
+require_relative "plan"
 require_relative "theme"
 require_relative "text"
 
 module Rakpak
-  # The yazi-style three-pane file browser: parent, current, preview.
-  # Owns navigation and the tag set; knows nothing about archiving.
   class Browser
-    attr_reader :cwd, :tags, :filter
+    # Marking exclusions mid-pack: walking stays under root, back is where to return.
+    Scope = Struct.new(:root, :paths, :back)
+
+    attr_reader :cwd, :tags, :excludes, :filter
 
     def initialize(start_dir = Dir.pwd, sizer: nil)
       @dirs = DirCache.new
       @sizer = sizer
       @tags = Set.new
+      @excludes = Set.new
+      @scope = nil
       @cursor = {}
       @show_hidden = false
       @filter = nil
       @filtering = false
-      @show_queue = true # on until someone presses t
+      @show_queue = true
       @pending = nil
       @preview_cache = {}
       @cwd = resolve(start_dir)
@@ -31,10 +35,12 @@ module Rakpak
       d
     end
 
-    # ---------------------------------------------------------------- state
-
     def entries
       list = @dirs.list(@cwd, hidden: @show_hidden) || []
+      # Above the packed items, only they are reachable.
+      if @scope && @cwd == @scope.root && !@scope.paths.include?(@cwd)
+        list = list.select { |e| @scope.paths.include?(e.path) }
+      end
       return list unless @filter && !@filter.empty?
 
       needle = @filter.downcase
@@ -54,18 +60,19 @@ module Rakpak
     def show_queue? = @show_queue
     def filtering? = @filtering
 
+    def scoped? = !@scope.nil?
+
     def tag(path)
       path = File.expand_path(path)
+      @excludes.delete(path)
       return unless @tags.add?(path)
 
-      # A figure may linger from a cursor-only pack of this path; a new tag
-      # must not trust it.
+      # A figure may linger from a cursor-only pack of this path; don't trust it.
       @sizer&.forget(path)
       @sizer&.request(path)
     end
 
-    # Every path out of the tag set goes through here so the sizer drops
-    # its figure; re-tagging later must measure again, not serve a stale one.
+    # All tag removals must pass here so the sizer drops its now-stale figure.
     def untag(path)
       return unless @tags.delete?(path)
 
@@ -78,17 +85,55 @@ module Rakpak
       @tags.include?(entry.path) ? untag(entry.path) : tag(entry.path)
     end
 
+    def exclude(path)
+      path = File.expand_path(path)
+      untag(path)
+      @excludes << path
+    end
+
+    def toggle_exclude(entry = current)
+      return unless entry
+
+      @excludes.delete?(entry.path) || exclude(entry.path)
+    end
+
     def tag_all = entries.each { |e| tag(e.path) }
     def untag_all_here = entries.each { |e| untag(e.path) }
-    def clear_tags = @tags.to_a.each { |p| untag(p) }
+
+    def clear_tags
+      @tags.to_a.each { |p| untag(p) }
+      @excludes.clear
+    end
+
+    # One packed folder opens inside it; several open at their common parent.
+    def scope_to(paths, base)
+      root = paths.size == 1 && File.directory?(paths.first) ? paths.first : base
+      @scope = Scope.new(root, paths, [@cwd, @cursor[@cwd], @filter])
+      @cwd = root
+      @filter = nil
+    end
+
+    def leave_scope
+      @cwd, cursor, @filter = @scope.back
+      @cursor[@cwd] = cursor
+      @scope = nil
+    end
+
+    def mark_in_scope
+      e = current
+      return unless e
+      return :unmarkable unless @scope.paths.any? { |p| Plan.inside?(e.path, p) }
+
+      toggle_exclude(e)
+      move(1)
+      nil
+    end
 
     def replace_tags(list)
       (@tags.to_a - list).each { |p| untag(p) }
       list.each { |p| tag(p) }
     end
 
-    # Selections implied by the current state: explicit tags, else whatever
-    # the cursor is sitting on.
     def selection
       return @tags.to_a.sort if @tags.any?
 
@@ -104,14 +149,10 @@ module Rakpak
       @tags.each { |p| @sizer.request(p) }
     end
 
-    # ----------------------------------------------------------- navigation
-
     def move(delta)
       self.index = index + delta
     end
 
-    # One step at a time wraps: up from the top lands on the last entry,
-    # down from the bottom on the first. Page moves still stop at the ends.
     def step(delta)
       n = entries.size
       return if n.zero?
@@ -130,7 +171,7 @@ module Rakpak
     end
 
     def ascend
-      return if @cwd == "/"
+      return if @cwd == "/" || @cwd == @scope&.root
 
       child = @cwd
       @cwd = File.dirname(@cwd)
@@ -142,13 +183,13 @@ module Rakpak
     def goto(dir)
       d = File.expand_path(dir)
       return false unless File.directory?(d) && File.readable?(d)
+      return false if @scope && d != @scope.root && !Plan.inside?(d, @scope.root)
 
       @cwd = d
       @filter = nil
       true
     end
 
-    # Open the folder holding `path` with the cursor on it.
     def jump_to(path)
       path = File.expand_path(path)
       return false unless goto(File.dirname(path))
@@ -159,7 +200,6 @@ module Rakpak
       !idx.nil?
     end
 
-    # Returns :quit, :archive, :unpack, :tags, :help, :jobs or nil.
     def handle(key)
       return handle_filter(key) if @filtering
 
@@ -170,8 +210,15 @@ module Rakpak
         when "h" then return goto(Dir.home) && nil
         when "r" then return goto("/") && nil
         end
-        # Anything else was not a chord: treat it as its own keystroke, so
-        # a stray g never swallows q, p or space.
+        # Not a chord: handle it as its own key so a stray g never swallows q, p or space.
+      end
+
+      if @scope
+        case key
+        when :space, "x" then return mark_in_scope
+        when "p", :esc then return :resume
+        when "a", "d", "D", "u", "T", "b" then return nil
+        end
       end
 
       result = case key
@@ -188,6 +235,9 @@ module Rakpak
       when :space
         toggle_tag
         move(1)
+      when "x"
+        toggle_exclude
+        move(1)
       when "a" then tag_all
       when "d" then untag_all_here
       when "D" then clear_tags
@@ -238,8 +288,6 @@ module Rakpak
 
     def page = @page_size || 10
 
-    # -------------------------------------------------------------- drawing
-
     def draw(screen, status_line)
       @page_size = screen.h - 5
       draw_header(screen)
@@ -250,8 +298,6 @@ module Rakpak
       draw_footer(screen, screen.h - 1, status_line)
     end
 
-    # Left to right: the queue (when shown), parent, current, preview. The
-    # queue takes its slice first and the usual three share what is left.
     def layout(w)
       panes = []
       x = 0
@@ -281,7 +327,10 @@ module Rakpak
     def draw_header(screen)
       screen.fill(0, 0, screen.w, 1, " ", Theme::HEAD)
       screen.put(1, 0, "rakpak", Theme::HEAD + "\e[1;38;5;39m")
-      right = tag_summary
+      right = if @scope then "marking exclusions"
+              elsif @excludes.any? then "#{tag_summary} · #{@excludes.size} excluded"
+              else tag_summary
+              end
       avail = screen.w - 10 - Text.width(right) - 3
       screen.put(9, 0, Text.fit_left(Text.tilde(@cwd), [avail, 1].max), Theme::HEAD + "\e[38;5;231m")
       screen.put(screen.w - Text.width(right) - 1, 0, right,
@@ -309,9 +358,6 @@ module Rakpak
       end
     end
 
-    # Everything queued for the next pack, wherever on the disk it lives:
-    # the name, then where it is, with the size at the edge and the running
-    # total on top. Stays put while you keep browsing.
     def draw_queue(screen, pane, y, h)
       x = pane[:x]
       w = pane[:w]
@@ -363,12 +409,16 @@ module Rakpak
         row = y + i
         sel = (top + i) == cur
         tagged = @tags.include?(e.path)
+        excluded = @excludes.include?(e.path)
         bg = if sel && active then Theme::CUR_BG
              elsif sel then Theme::SEL_BG
              end
         screen.fill(x, row, w, 1, " ", bg) if bg
-        mark_style = tagged ? (bg.to_s + Theme::TAG) : (bg.to_s + Theme::FAINT)
-        screen.put(x, row, tagged ? " ▌" : "  ", mark_style)
+        mark, mark_style = if tagged then [" ▌", Theme::TAG]
+                           elsif excluded then [" ✗", Theme::ERR]
+                           else ["  ", Theme::FAINT]
+                           end
+        screen.put(x, row, mark, bg.to_s + mark_style)
         name_style = bg ? bg + (sel && active ? "\e[1;38;5;231m" : e.style) : e.style
         avail = w - 3
         avail -= 5 unless pane[:kind] == :parent
@@ -423,8 +473,7 @@ module Rakpak
     end
 
     def file_preview(entry, w, h)
-      # Reading a FIFO or a device blocks until someone writes to it, which
-      # would freeze the UI with the cursor merely resting on the entry.
+      # Reading a FIFO or device blocks and would freeze the UI.
       kind = entry.target_stat
       return [["not a regular file", Theme::FAINT]] unless kind&.file?
 
@@ -444,7 +493,6 @@ module Rakpak
       [[e.class.name.split("::").last, Theme::ERR]]
     end
 
-    # Bytes per row adapts to the pane so the ASCII column always fits.
     def hexdump(bytes, rows, width)
       return [] if rows <= 0
 
@@ -489,6 +537,8 @@ module Rakpak
 
     HINTS = [["space", "tag"], ["←→", "nav"], ["a", "all"], ["t", "queue"], ["/", "find"],
              [".", "hidden"], ["p", "pack"], ["u", "unpack"], ["?", "help"]].freeze
+    SCOPE_HINTS = [["space", "exclude"], ["←→", "nav"], ["/", "find"], [".", "hidden"],
+                   ["p", "back to pack"], ["?", "help"]].freeze
 
     def draw_footer(screen, y, status_line)
       screen.fill(0, y, screen.w, 1, " ", nil)
@@ -497,7 +547,7 @@ module Rakpak
         return
       end
       x = 1
-      HINTS.each do |k, label|
+      (@scope ? SCOPE_HINTS : HINTS).each do |k, label|
         break if x + Text.width(k) + Text.width(label) + 3 > screen.w
 
         x = screen.put(x, y, k, Theme::KEY)

data/lib/rakpak/dir_cache.rb

@@ -3,8 +3,6 @@
 require_relative "entry"
 
 module Rakpak
-  # Directory listings, memoised per (path, show_hidden). Cheap enough that
-  # the parent/preview panes can ask on every keystroke.
   class DirCache
     MAX_ENTRIES = 20_000
 
@@ -31,7 +29,7 @@ module Rakpak
       names.reject! { |n| n.start_with?(".") } unless hidden
       names = names.first(MAX_ENTRIES)
       names.map { |n| Entry.new(File.join(path, n), n) }.sort_by(&:sort_key)
-    rescue StandardError # EACCES, ENOENT, ENOTDIR, ELOOP and the rest
+    rescue StandardError
       nil
     end
   end