epub_tools 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cbc80ed0690251633b8f12d80fa256922cac6092c12d3a910cd998e61ce38ea0
-  data.tar.gz: b0da7dd401516d3a1074268c7495d02d1a3532ea3e6f4bd9b49b9e62772e280c
+  metadata.gz: 67e06b8c37f922205445fb328c172184eb14436d876514e306892e17faf767e2
+  data.tar.gz: b0eb25344c96cca09889bc7854b40f48dca2bc49449583a1259dd7ac30803309
 SHA512:
-  metadata.gz: 66de9b943051874b87a1a32bf7fba1391eefad09e21a20f1e5a9265cdcb77d65bc453342787dc25944a265a81cf1119ecfe37a78713221d6d869aae4896982d9
-  data.tar.gz: db68ab8011facd49ef7314d1b6e7ce0c2b645a62a3a4ae213048af2500546622b55153cc4598747d234a972c05738927ec7f9b9efb047feb0c60c3022a6f21fa
+  metadata.gz: b36393dbb0fcc6888a10a2bdb93d30fe88eb423034aacc7455bdb8338e4a0fccdfc8fac70b9998ccd66c1758956afcef0bd8ecd404aabe5eacfa4326b5f3b847
+  data.tar.gz: f9b2071dc6a832b178fa77c8982f43f645a9ebed4059cd023863cde8ed6220300df1155cfea39ee35455188b2fcd6672abf56f3682a5f46c606891e4e1bb0347

data/.document

@@ -0,0 +1,2 @@
+lib
+bin

data/.github/workflows/ci.yml

@@ -2,20 +2,21 @@ name: CI
 
 on:
   push:
-    branches: ["main"]
+    branches: [ main ]
   pull_request:
-    branches: ["main"]
+    branches: [ main ]
 
 jobs:
   test:
     runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby: ['3.2', '3.3', '3.4']
     steps:
       - uses: actions/checkout@v3
       - uses: ruby/setup-ruby@v1
         with:
-          ruby-version: '3.4.3'
-          bundler-cache: true
-      - name: Install dependencies
-        run: bundle install --jobs 4 --retry 3
-      - name: Run tests
-        run: bundle exec rake test
+          ruby-version: ${{ matrix.ruby }}
+      - run: gem install bundler
+      - run: bundle install --jobs 4 --retry 3
+      - run: bundle exec rake test

data/.gitignore

@@ -1,7 +1,11 @@
 .DS_Store
 /.bundle/
 /coverage/
+/doc/
+/.yardoc/
 vendor/bundle/
 *.gem
 
 text_style_classes.yaml
+
+**/.claude/settings.local.json

data/.rubocop.yml

@@ -0,0 +1,41 @@
+# The behavior of RuboCop can be controlled via the .rubocop.yml
+# configuration file. It makes it possible to enable/disable
+# certain cops (checks) and to alter their behavior if they accept
+# any parameters. The file can be placed either in your home
+# directory or in some project directory.
+#
+# RuboCop will start looking for the configuration file in the directory
+# where the inspected file is and continue its way up to the root directory.
+#
+# See https://docs.rubocop.org/rubocop/configuration
+
+AllCops:
+  NewCops: enable
+
+plugins:
+  - rubocop-minitest
+  - rubocop-rake
+
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+Metrics/MethodLength:
+  Enabled: false
+
+Metrics/ClassLength:
+  Enabled: false
+
+Metrics/AbcSize:
+  Enabled: false
+
+Metrics/CyclomaticComplexity:
+  Enabled: false
+
+Metrics/PerceivedComplexity:
+  Enabled: false
+
+Style/OptionalBooleanParameter:
+  Enabled: false
+
+Minitest/MultipleAssertions:
+  Enabled: false

data/Gemfile

@@ -1,14 +1,23 @@
 # frozen_string_literal: true
 
-ruby '3.4.3'
+ruby '>= 3.2'
 
-source "https://rubygems.org"
+source 'https://rubygems.org'
 
-gem "nokogiri", "~> 1.18"
-gem "rake", "~> 13.2"
-gem "rubyzip", "~> 2.4"
+gem 'nokogiri', '~> 1.18'
+gem 'rake', '~> 13.2'
+gem 'rubyzip', '~> 2.4'
 
-group :test do
-  gem "minitest", "~> 5.25"
-  gem "simplecov", require: false
+group :test, :development do
+  gem 'minitest', '~> 5.25'
+  gem 'rubocop', '~> 1.75', require: false
+  gem 'rubocop-minitest', '~> 0.38.0', require: false
+  gem 'rubocop-rake', '~> 0.7.1', require: false
+  gem 'simplecov', require: false
+end
+
+group :doc do
+  gem 'rdoc', '~> 6.13'
+  gem 'webrick', '~> 1.9'
+  gem 'yard', '~> 0.9.37'
 end

data/Gemfile.lock

@@ -1,7 +1,12 @@
 GEM
   remote: https://rubygems.org/
   specs:
+    ast (2.4.3)
+    date (3.4.1)
     docile (1.4.1)
+    json (2.11.3)
+    language_server-protocol (3.17.0.4)
+    lint_roller (1.1.0)
     minitest (5.25.5)
     nokogiri (1.18.8-aarch64-linux-gnu)
       racc (~> 1.4)
@@ -19,8 +24,42 @@ GEM
       racc (~> 1.4)
     nokogiri (1.18.8-x86_64-linux-musl)
       racc (~> 1.4)
+    parallel (1.27.0)
+    parser (3.3.8.0)
+      ast (~> 2.4.1)
+      racc
+    prism (1.4.0)
+    psych (5.2.3)
+      date
+      stringio
     racc (1.8.1)
+    rainbow (3.1.1)
     rake (13.2.1)
+    rdoc (6.13.1)
+      psych (>= 4.0.0)
+    regexp_parser (2.10.0)
+    rubocop (1.75.4)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.44.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.44.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    rubocop-minitest (0.38.0)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
+    rubocop-rake (0.7.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.72.1)
+    ruby-progressbar (1.13.0)
     rubyzip (2.4.1)
     simplecov (0.22.0)
       docile (~> 1.1)
@@ -28,6 +67,12 @@ GEM
       simplecov_json_formatter (~> 0.1)
     simplecov-html (0.13.1)
     simplecov_json_formatter (0.1.4)
+    stringio (3.1.7)
+    unicode-display_width (3.1.4)
+      unicode-emoji (~> 4.0, >= 4.0.4)
+    unicode-emoji (4.0.4)
+    webrick (1.9.1)
+    yard (0.9.37)
 
 PLATFORMS
   aarch64-linux-gnu
@@ -43,8 +88,14 @@ DEPENDENCIES
   minitest (~> 5.25)
   nokogiri (~> 1.18)
   rake (~> 13.2)
+  rdoc (~> 6.13)
+  rubocop (~> 1.75)
+  rubocop-minitest (~> 0.38.0)
+  rubocop-rake (~> 0.7.1)
   rubyzip (~> 2.4)
   simplecov
+  webrick (~> 1.9)
+  yard (~> 0.9.37)
 
 RUBY VERSION
    ruby 3.4.3p32

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Jaime Rodas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -1,6 +1,8 @@
  # EPUB Tools
 
- **TL;DR:** A Ruby gem and CLI for working with EPUB files: extract, split, initialize, add chapters, pack, and unpack EPUB books.
+[![Build Status](https://github.com/jaimerodas/epub_tools/actions/workflows/ci.yml/badge.svg)](https://github.com/jaimerodas/epub_tools/actions) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+**TL;DR:** A Ruby gem and CLI for working with EPUB files: extract, split, initialize, add chapters, pack, and unpack EPUB books.
 
 ## Installation
 Install the gem via RubyGems:
@@ -52,7 +54,7 @@ epub-tools pack -i epub_dir -o MyBook.epub
 
 # Unpack EPUB
 epub-tools unpack -i MyBook.epub -o unpacked_dir
-  
+
 # Full compile workflow: extract, split, initialize, add, and pack into one EPUB
 epub-tools compile -t "My Book" -a "Author Name" -s source_epubs -c cover.jpg -o MyBook.epub
 ```
@@ -88,7 +90,7 @@ EpubTools::EpubInitializer.new(
 ).run
 
 # Add chapters
-EpubTools::AddChaptersToEpub.new('chapters', 'epub_dir/OEBPS').run
+EpubTools::AddChapters.new('chapters', 'epub_dir/OEBPS').run
 
 # Pack EPUB
 EpubTools::PackEbook.new('epub_dir', 'MyBook.epub').run
@@ -113,6 +115,22 @@ Enable coverage reporting:
 ```bash
 COVERAGE=true bundle exec rake test
 ```
+## Documentation
+
+Detailed API documentation can be generated using YARD. To view the docs locally, serve the documentation locally with YARD:
+
+```bash
+bundle exec yard server --reload
+```
+
+Then navigate to http://localhost:8808 in your browser.
+
+To (re)generate the documentation, install the documentation dependencies and run:
+
+```bash
+bundle install --with doc
+bundle exec yard doc
+```
 
 ## Contributing
 Pull requests welcome! Please open an issue for major changes.

data/bin/epub-tools

@@ -1,112 +1,6 @@
 #!/usr/bin/env ruby
 require_relative '../lib/epub_tools'
 
-prog = File.basename($PROGRAM_NAME)
-# Global version flag: print version and exit if invoked as `epub-tools -v/--version`
-if ARGV[0] == '-v' || ARGV[0] == '--version'
-  puts EpubTools::VERSION
-  exit 0
-end
-script_dir = File.expand_path(File.join(__dir__, '..'))
-commands = %w[add extract init split pack unpack compile]
-
-if ARGV.empty? || !commands.include?(ARGV[0])
-  puts <<~USAGE
-    Usage: #{prog} COMMAND [options]
-    Commands:
-      init      Initialize a bare-bones EPUB
-      extract   Extract XHTML files from EPUBs
-      split     Split XHTML into separate XHTMLs per chapter
-      add       Add chapter XHTML files into an EPUB
-      pack      Package an EPUB directory into a .epub file
-      unpack    Unpack an EPUB file into a directory
-      compile   Takes EPUBs in a dir and splits, cleans, and compiles into a single EPUB.
-  USAGE
-  exit 1
-end
-
-cmd = ARGV.shift
-
-case cmd
-when 'add'
-options = {}
-EpubTools::CLIHelper.parse(options, [:chapters_dir, :epub_oebps_dir]) do |opts, o|
-  opts.banner = "Usage: #{prog} add [options]"
-  opts.on('-c DIR', '--chapters-dir DIR', 'Chapters directory (required)') { |v| o[:chapters_dir] = v }
-  opts.on('-e DIR', '--epub-oebps-dir DIR', 'EPUB OEBPS directory (required)') { |v| o[:epub_oebps_dir] = v }
-end
-
-EpubTools::AddChaptersToEpub.new(options[:chapters_dir], options[:epub_oebps_dir]).run
-
-when 'extract'
-  options = { verbose: true }
-  EpubTools::CLIHelper.parse(options, [:source_dir, :target_dir]) do |opts, o|
-    opts.banner = "Usage: #{prog} extract [options]"
-    opts.on('-s DIR', '--source-dir DIR', 'Directory with EPUBs to extract XHTMLs from (required)') { |v| o[:source_dir] = v }
-    opts.on('-t DIR', '--target-dir DIR', 'Directory where the XHTML files will be extracted to (required)') { |v| o[:target_dir] = v }
-    opts.on('-q', '--quiet', 'Run quietly (default: verbose)') { |v| o[:verbose] = !v }
-  end
-  EpubTools::XHTMLExtractor.new(
-    source_dir: options[:source_dir],
-    target_dir: options[:target_dir],
-    verbose: options[:verbose]
-  ).extract_all
-
-when 'split'
-  options = { output_dir: './chapters', prefix: 'chapter', verbose: true }
-  EpubTools::CLIHelper.parse(options, [:input_file, :book_title]) do |opts, o|
-    opts.banner = "Usage: #{prog} split [options]"
-    opts.on('-i FILE', '--input FILE', 'Source XHTML file (required)') { |v| options[:input_file] = v }
-    opts.on('-t TITLE', '--title TITLE', 'Book title for HTML <title> tags (required)') { |v| options[:book_title] = v }
-    opts.on('-o DIR', '--output-dir DIR', "Output directory for chapter files (default: #{options[:output_dir]})") { |v| options[:output_dir] = v }
-    opts.on('-p PREFIX', '--prefix PREFIX', "Filename prefix for chapters (default: #{options[:prefix]})") { |v| options[:prefix] = v }
-    opts.on('-q', '--quiet', 'Run quietly (default: verbose)') { |v| o[:verbose] = !v }
-  end
-  EpubTools::SplitChapters.new(options[:input_file], options[:book_title], options[:output_dir], options[:prefix], options[:verbose]).run
-
-when 'init'
-  options = {}
-  EpubTools::CLIHelper.parse(options, [:title, :author, :destination]) do |opts, o|
-    opts.banner = "Usage: #{prog} init [options]"
-    opts.on('-t TITLE', '--title TITLE', 'Book title (required)') { |v| o[:title] = v }
-    opts.on('-a AUTHOR', '--author AUTHOR', 'Author name (required)') { |v| o[:author] = v }
-    opts.on('-o DIR', '--output-dir DIR', 'Destination EPUB directory (required)') { |v| o[:destination] = v }
-    opts.on('-c PATH', '--cover PATH', 'Cover image file path (optional)') { |v| o[:cover_image] = v }
-  end
-
-  EpubTools::EpubInitializer.new(options[:title], options[:author], options[:destination], options[:cover_image]).run
-
-when 'pack'
-  options = {verbose: true}
-  EpubTools::CLIHelper.parse(options, [:input_dir, :output_file]) do |opts, o|
-    opts.banner = "Usage: #{prog} pack [options]"
-    opts.on('-i DIR', '--input-dir DIR', 'EPUB directory to package (required)') { |v| o[:input_dir] = v }
-    opts.on('-o FILE', '--output-file FILE', 'Output EPUB file path (required)') { |v| o[:output_file] = v }
-    opts.on('-q', '--quiet', 'Run quietly (default: verbose)') { |v| o[:verbose] = !v }
-  end
-
-  EpubTools::PackEbook.new(options[:input_dir], options[:output_file], verbose: options[:verbose]).run
-
-when 'unpack'
-  options = {verbose: true}
-  EpubTools::CLIHelper.parse(options, [:epub_file]) do |opts, o|
-    opts.banner = "Usage: #{prog} unpack [options]"
-    opts.on('-i FILE', '--input-file FILE', 'EPUB file to unpack (required)') { |v| o[:epub_file] = v }
-    opts.on('-o DIR', '--output-dir DIR', 'Output directory to extract into (default: basename of epub)') { |v| o[:output_dir] = v }
-    opts.on('-q', '--quiet', 'Run quietly (default: verbose)') { |v| o[:verbose] = !v }
-  end
-  EpubTools::UnpackEbook.new(options[:epub_file], options[:output_dir], verbose: options[:verbose]).run
-
-when 'compile'
-  options = {verbose: true}
-  EpubTools::CLIHelper.parse(options, %i(title author source_dir)) do |opts, o|
-    opts.banner = "Usage: #{prog} compile [options]"
-    opts.on('-t TITLE', '--title TITLE', 'Book title (required)') { |v| o[:title] = v }
-    opts.on('-a AUTHOR', '--author AUTHOR', 'Author name (required)') { |v| o[:author] = v }
-    opts.on('-s DIR', '--source-dir DIR', 'Directory with EPUBs to extract XHTMLs from (required)') { |v| o[:source_dir] = v }
-    opts.on('-o FILE', '--output FILE', 'EPUB to create (default: book title in source dir)') { |v| o[:output_file] = v }
-    opts.on('-c PATH', '--cover PATH', 'Cover image file path (optional)') { |v| o[:cover_image] = v }
-    opts.on('-q', '--quiet', 'Run quietly (default: verbose)') { |v| o[:verbose] = !v }
-  end
-  EpubTools::CompileBook.new(**options).run
-end
+# Use the new object-oriented CLI architecture
+runner = EpubTools::CLI.create_runner
+runner.run(ARGV)

data/epub_tools.gemspec

@@ -11,16 +11,14 @@ Gem::Specification.new do |spec|
   spec.files         = `git ls-files`.split("\n")
   spec.require_paths = ['lib']
   spec.executables   = ['epub-tools']
-  spec.required_ruby_version = ">= 3.0"
-  spec.metadata    = {
-    "source_code_uri" => "https://github.com/jaimerodas/epub_tools/tree/main",
-    "homepage_uri" => "https://github.com/jaimerodas/epub_tools"
+  spec.required_ruby_version = '>= 3.2'
+  spec.metadata = {
+    'source_code_uri' => 'https://github.com/jaimerodas/epub_tools/tree/main',
+    'homepage_uri' => 'https://github.com/jaimerodas/epub_tools',
+    'rubygems_mfa_required' => 'true'
   }
 
   spec.add_dependency 'nokogiri', '~> 1.18'
-  spec.add_dependency 'rubyzip', '~> 2.4'
   spec.add_dependency 'rake', '~> 13.2'
-
-  spec.add_development_dependency 'minitest', '~> 5.25'
-  spec.add_development_dependency 'simplecov', '~> 0'
+  spec.add_dependency 'rubyzip', '~> 2.4'
 end

data/lib/epub_tools/add_chapters.rb

@@ -0,0 +1,124 @@
+#!/usr/bin/env ruby
+require 'nokogiri'
+require 'fileutils'
+require_relative 'loggable'
+
+module EpubTools
+  # Moves new chapters into an unpacked EPUB
+  class AddChapters
+    include Loggable
+    # Initializes the class
+    # @param options [Hash] Configuration options
+    # @option options [String] :chapters_dir Directory from which to move the xhtml chapters.
+    #                          It assumes the directory will contain one or more files named
+    #                          +chapter_XX.xhtml+, where +XX+ is a number. (default: './chapters')
+    # @option options [String] :epub_dir Unpacked EPUB directory to move the chapters to. It should
+    #                          be the same directory that contains the +package.opf+ and +nav.xhtml+
+    #                          files. (default: './epub/OEBPS')
+    # @option options [Boolean] :verbose Whether to log progress to STDOUT (default: false)
+    def initialize(options = {})
+      @chapters_dir = File.expand_path(options[:chapters_dir] || './chapters')
+      @epub_dir = File.expand_path(options[:epub_dir] || './epub/OEBPS')
+      @opf_file = File.join(@epub_dir, 'package.opf')
+      @nav_file = File.join(@epub_dir, 'nav.xhtml')
+      @verbose = options[:verbose] || false
+
+      validate_directories!
+    end
+
+    # It works like this:
+    # - First, the *.xhtml files are moved from +chapters_dir+ over to +epub_dir+
+    # - Then, new entries will be added to the manifest and spine of the EPUB's +package.opf+ file.
+    #   It will sort the files by extracting the chapter number.
+    # - Finally, it will update the +nav.xhtml+ file with the new chapters. Note that if there's a
+    #   file named +chapter_0.xhtml+, it will be added to the +nav.xhtml+ as the Prologue.
+    # @return [Array<String>] List of moved chapter filenames
+    def run
+      moved_files = move_chapters
+      update_package_opf(moved_files)
+      update_nav_xhtml(moved_files)
+      moved_files.each { |f| log("Moved: #{f}") }
+      moved_files
+    end
+
+    private
+
+    def validate_directories!
+      raise ArgumentError, "Chapters directory '#{@chapters_dir}' does not exist" unless Dir.exist?(@chapters_dir)
+
+      raise ArgumentError, "EPUB directory '#{@epub_dir}' does not exist" unless Dir.exist?(@epub_dir)
+
+      raise ArgumentError, "EPUB package.opf file missing at '#{@opf_file}'" unless File.exist?(@opf_file)
+
+      return if File.exist?(@nav_file)
+
+      raise ArgumentError, "EPUB nav.xhtml file missing at '#{@nav_file}'"
+    end
+
+    def move_chapters
+      # Sort by chapter number (numeric)
+      chapter_files = Dir.glob(File.join(@chapters_dir, '*.xhtml')).sort_by do |path|
+        # extract first integer from filename (e.g. chapter_10.xhtml -> 10)
+        File.basename(path)[/\d+/].to_i
+      end
+
+      raise ArgumentError, "No .xhtml files found in '#{@chapters_dir}'" if chapter_files.empty?
+
+      chapter_files.each do |file|
+        FileUtils.mv(file, @epub_dir)
+      end
+      chapter_files.map { |f| File.basename(f) }
+    end
+
+    def chapter_id(filename)
+      match = filename.match(/chapter_(\d+)\.xhtml/)
+      match ? "chap#{match[1]}" : File.basename(filename, '.xhtml')
+    end
+
+    def update_package_opf(filenames)
+      doc = Nokogiri::XML(File.read(@opf_file)) { |config| config.default_xml.noblanks }
+      manifest = doc.at_xpath('//xmlns:manifest')
+      spine = doc.at_xpath('//xmlns:spine')
+
+      filenames.each do |filename|
+        id = chapter_id(filename)
+        # Add <item> to the manifest if missing
+        unless doc.at_xpath("//xmlns:item[@href='#{filename}']")
+          item = Nokogiri::XML::Node.new('item', doc)
+          item['id'] = id
+          item['href'] = filename
+          item['media-type'] = 'application/xhtml+xml'
+          manifest.add_child(item)
+        end
+
+        # Add <itemref> to the spine if missing
+        next if doc.at_xpath("//xmlns:itemref[@idref='#{id}']")
+
+        itemref = Nokogiri::XML::Node.new('itemref', doc)
+        itemref['idref'] = id
+        spine.add_child(itemref)
+      end
+
+      File.write(@opf_file, doc.to_xml(indent: 2))
+    end
+
+    def update_nav_xhtml(filenames)
+      doc = Nokogiri::XML(File.read(@nav_file)) { |config| config.default_xml.noblanks }
+      nav = doc.at_xpath('//xmlns:nav[@epub:type="toc"]/xmlns:ol')
+
+      filenames.each do |filename|
+        # Create a new <li><a href="...">Label</a></li> element
+        label = File.basename(filename, '.xhtml').gsub('_', ' ').capitalize
+        label = 'Prologue' if label == 'Chapter 0'
+        li = Nokogiri::XML::Node.new('li', doc)
+        a  = Nokogiri::XML::Node.new('a', doc)
+        a['href'] = filename
+        a.content = label
+        li.add_child(a)
+        nav.add_child(li)
+      end
+
+      File.write(@nav_file, doc.to_xml(indent: 2))
+    end
+  end
+end

data/lib/epub_tools/cli/command_registry.rb

@@ -0,0 +1,47 @@
+module EpubTools
+  module CLI
+    # Manages the registration and retrieval of commands
+    class CommandRegistry
+      attr_reader :commands
+
+      def initialize
+        @commands = {}
+      end
+
+      # Register a new command in the registry
+      # @param name [String] the command name
+      # @param command_class [Class] the class that implements the command
+      # @param required_keys [Array<Symbol>] keys that must be present in options
+      # @param default_options [Hash] default options for the command
+      # @return [self]
+      def register(name, command_class, required_keys = [], default_options = {})
+        @commands[name] = {
+          class: command_class,
+          required_keys: required_keys,
+          default_options: default_options
+        }
+        self
+      end
+
+      # Get a command by name
+      # @param name [String] the command name
+      # @return [Hash, nil] the command configuration or nil if not found
+      def get(name)
+        @commands[name]
+      end
+
+      # Get all available command names
+      # @return [Array<String>] list of registered command names
+      def available_commands
+        @commands.keys
+      end
+
+      # Check if a command is registered
+      # @param name [String] the command name
+      # @return [Boolean] true if command exists
+      def command_exists?(name)
+        @commands.key?(name)
+      end
+    end
+  end
+end