rundoc 3.0.2 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 87495a9fcbdf3fa9a146b633d84f62294bd400b32f806d975db0b372ce6c4f31
-  data.tar.gz: c50e2b6dbcbb2e313753d1341a17b56208118b10bd20462768348cae56cb3dda
+  metadata.gz: 7e89c8353e4727ae39613f24c38bf3a69f027c6d1e533e64e281a588405ff57f
+  data.tar.gz: 34df7f620c446901596deec889b9c8f785bd10e0441a54e1904b799ae9b8f0cd
 SHA512:
-  metadata.gz: 3e34467cf37d802daf82bb6fd8e81a4ecb4af426bc1645151e7d420dec131e4493b4e5f8ba78de3393bdc84a4de97dbc908434f4e1f06a895fc9002ca72611a5
-  data.tar.gz: 6971fa4915f79d81d1b6e6dd05f10e45e116f7388ae4c5ffd8b8ad1e9dc28be9c7882b11c6f315934b210281508fc17edb722969497fd951780befcb1d66eef2
+  metadata.gz: beb56a43157798ba53c4e63d715fd75892bc6d2b93bd0b8d379168c4dcc8807af3c31a5b8ac1a8af6215fa738bad6f8b4e2df525bae1c6590ef8bf7d3e94b29d
+  data.tar.gz: 8f6555c197fc600cc5cbf60af7d558213f50ec2a01b3d72f57e09eec628ba3169a512230b9ae106071afb2b536a6b7a314b3a8a832eb64e158565d977ab28e06

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 ## HEAD
 
+## 3.1.0
+
+- Add: `--with-contents` flag that accepts a directory. The **contents** of the directory (and not the directory itself) will be copied into the working dir before execution. This is useful for debugging a single rundoc step. ()
+
+For example if `RUNDOC.md` features many smaller docs:
+
+```
+:::>> rundoc.require "./intro.md"
+:::>> rundoc.require "../shared/install_cli.md"
+:::>> rundoc.require "./clone_app.md"
+```
+
+If the command fails on `clone_app.md` then you can rapidly iterate by calling `$ rundoc ./clone_app.md --with-contents failed/my-app` but be careful to not use the same failure directory etc or it will be replaced.
+
 ## 3.0.2
 
 - Fix: Partial output of the document is now written to disk in a `RUNDOC_FAILED.md` file (https://github.com/zombocom/rundoc/pull/69)

data/lib/rundoc/cli.rb

@@ -24,6 +24,7 @@ module Rundoc
       on_success_dir: nil,
       on_failure_dir: nil,
       output_filename: nil,
+      with_contents_dir: nil,
       screenshots_dirname: nil
     )
       @io = io
@@ -37,6 +38,7 @@ module Rundoc
       @execution_context = Rundoc::Context::Execution.new(
         output_dir: Dir.mktmpdir,
         source_path: source_path,
+        with_contents_dir: with_contents_dir,
         screenshots_dirname: screenshots_dirname
       )
 
@@ -136,13 +138,23 @@ module Rundoc
 
       source_contents = execution_context.source_path.read
       if on_failure_dir.exist? && !Dir.empty?(on_failure_dir)
-        io.puts "## earing on failure directory #{on_failure_dir}"
+        io.puts "## erring on failure directory #{on_failure_dir}"
         clean_dir(
           dir: on_failure_dir,
           description: "on failure directory"
         )
       end
 
+      if execution_context.with_contents_dir
+        io.puts "## Copying contents from #{execution_context.with_contents_dir} to tmp working dir"
+        Dir.chdir(execution_context.with_contents_dir) do
+          FileUtils.cp_r(
+            ".",
+            execution_context.output_dir
+          )
+        end
+      end
+
       io.puts "## Working dir is #{execution_context.output_dir}"
       Dir.chdir(execution_context.output_dir) do
         parser = Rundoc::Parser.new(

data/lib/rundoc/cli_argument_parser.rb

@@ -8,7 +8,8 @@ module Rundoc
   #
   # Example:
   #
-  #   cli = CLIArgumentParser.new(argv: ARGV).to_cli
+  #   options = Rundoc::CLIArgumentParser.new(argv: ARGV).call.options
+  #   cli = Rundoc::CLI.new(**options)
   #   cli.call
   #
   class CLIArgumentParser
@@ -109,6 +110,10 @@ module Rundoc
           @exit_obj.exit(0)
         end
 
+        opts.on("--with-contents <dir>", "Copies contents of directory into the tmp working dir") do |v|
+          options[:with_contents_dir] = v
+        end
+
         opts.on("--on-success-dir <dir>", "Success dir, relative to CWD. i.e. `<rundoc.md/dir>/#{CLI::DEFAULTS::ON_SUCCESS_DIR}/`.") do |v|
           options[:on_success_dir] = v
         end

data/lib/rundoc/code_command/background/process_spawn.rb

@@ -43,7 +43,7 @@ class Rundoc::CodeCommand::Background
       @tasks[name]
     end
 
-    attr_reader :log, :pid
+    attr_reader :log, :pid, :command
 
     def initialize(command, timeout: 5, log: Tempfile.new("log"), out: "2>&1")
       @command = command
@@ -68,7 +68,7 @@ class Rundoc::CodeCommand::Background
         end
       end
     rescue Timeout::Error
-      raise "Timeout waiting for #{@command.inspect} to find a match using #{wait_value.inspect} in \n'#{log.read}'"
+      raise "Timeout (#{timeout_value}s) waiting for #{@command.inspect} to find a match using #{wait_value.inspect} in \n'#{log.read}'"
     end
 
     def alive?

data/lib/rundoc/code_command/background/start.rb

@@ -15,6 +15,7 @@ class Rundoc::CodeCommand::Background
         log: log,
         out: out
       )
+      puts "Spawning commmand: `#{@spawn.command}`"
       ProcessSpawn.add(@name, @spawn)
     end
 

data/lib/rundoc/context/execution.rb

@@ -9,13 +9,16 @@ module Rundoc
         # The directory we are actively manipulating
         :output_dir,
         # Directory to store screenshots, relative to output_dir
-        :screenshots_dir
+        :screenshots_dir,
+        # Directory we are copying from, i.e. a directory to source from could be nil
+        :with_contents_dir
 
-      def initialize(source_path:, output_dir:, screenshots_dirname:)
+      def initialize(source_path:, output_dir:, screenshots_dirname:, with_contents_dir:)
         @source_path = Pathname(source_path).expand_path
         @source_dir = @source_path.parent
         @output_dir = Pathname(output_dir).expand_path
         @screenshots_dir = @output_dir.join(screenshots_dirname).expand_path
+        @with_contents_dir = with_contents_dir
       end
     end
   end

data/lib/rundoc/version.rb

@@ -1,3 +1,3 @@
 module Rundoc
-  VERSION = "3.0.2"
+  VERSION = "3.1.0"
 end

data/test/integration/with_contents_flag_test.rb

@@ -0,0 +1,35 @@
+require "test_helper"
+
+class WithContentsFlagTest < Minitest::Test
+  def test_with_contents_flag
+    Dir.mktmpdir do |dir|
+      Dir.chdir(dir) do
+        dir = Pathname(dir)
+
+        contents_dir = dir.join("contents").tap { |p| p.mkpath }
+        FileUtils.touch(contents_dir.join("file1.txt"))
+
+        source_path = dir.join("RUNDOC.md")
+        source_path.write <<~EOF
+          ```
+          :::>> $ ls
+          ```
+        EOF
+
+        refute dir.join(SUCCESS_DIRNAME).join("file1.txt").exist?
+
+        io = StringIO.new
+        Rundoc::CLI.new(
+          io: io,
+          source_path: source_path,
+          on_success_dir: dir.join(SUCCESS_DIRNAME),
+          with_contents_dir: contents_dir
+        ).call
+
+        doc = dir.join(SUCCESS_DIRNAME).join("README.md").read
+        assert_includes doc, "$ ls"
+        assert_includes doc, "file1.txt"
+      end
+    end
+  end
+end

data/test/test_helper.rb

@@ -23,6 +23,7 @@ class Minitest::Test
     Rundoc::Context::Execution.new(
       output_dir: output_dir || Pathname("/dev/null"),
       source_path: source_path || Pathname("/dev/null"),
+      with_contents_dir: nil,
       screenshots_dirname: screenshots_dirname || Pathname("/dev/null")
     )
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rundoc
 version: !ruby/object:Gem::Version
-  version: 3.0.2
+  version: 3.1.0
 platform: ruby
 authors:
 - Richard Schneeman
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-20 00:00:00.000000000 Z
+date: 2024-11-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -265,6 +265,7 @@ files:
 - test/integration/print_test.rb
 - test/integration/require_test.rb
 - test/integration/website_test.rb
+- test/integration/with_contents_flag_test.rb
 - test/rundoc/cli_argument_parser_test.rb
 - test/rundoc/code_commands/append_file_test.rb
 - test/rundoc/code_commands/background_test.rb