How to supply images to documents unpacked by l3build

Question

I have an module that I want to manage with l3build. Unpacking a docstrip file generates a tex file. l3build doc typesets that generated tex file. But I can't figure out how to configure build.lua to enable that process to see any images that should be included.

My MWE is four files (all in a Github repo for ease)

file tree

├── build.lua
├── foo.dtx
├── foo.ins
└── support
    └── duck.png

foo.dtx

%<*foo>
\documentclass{article}
\usepackage{graphicx}
\usepackage{lipsum}
\begin{document}
\lipsum[1]
\includegraphics[
    width=\textwidth,
%<bar>angle=180,
]{duck}
\end{document}
%</foo>

foo.ins

\input docstrip.tex
\askforoverwritefalse
\generate{\file{bar.tex}{\from{\jobname.dtx}{foo,bar}}}
\endbatchfile

So bar.tex has one extra line, which should rotate the image 180 degrees.

build.lua

module = "foo"

typesetsuppfiles = {"duck.png"}
typesetfiles = {"foo.dtx","bar.tex"}

duck.png

Command:

l3build doc foo

• duck.png is copied into typesetdir
• foo.dtx is typeset in typesetdir (I think)
• result: success. foo.pdf is moved into maindir.

Command:

l3build doc bar

• bar.tex is unpacked into unpackdir
• tex is run on bar.tex in unpackdir
• result: failure because duck.png is not found.

Answer 1

This should be your build.lua:

module = "foo"

typesetsuppfiles = { "duck.png" }
typesetfiles = {"foo.dtx"}

and the directory structure should be:

├── build.lua
├── foo.dtx
├── foo.ins
└── support
    └── duck.png

support is the official directory name supported by the l3build program.

Answer 2

The following code (yes it's ugly) works for the specific case you present:

module = "foo"

--typesetsuppfiles = {"duck.png"}
typesetfiles = {"foo.dtx","bar.tex"}

function docinit_hook()
  errorlevel = cp("duck.png", "./support", unpackdir)
  if errorlevel ~= 0 then
    error("** Error!!: Can't copy duck.png from ./support to "..unpackdir)
    return errorlevel
  end
  errorlevel = cp("duck.png", "./support", typesetdir)
  if errorlevel ~= 0 then
    error("** Error!!: Can't copy duck.png from ./support to "..typesetdir)
    return errorlevel
  end
  return 0
end

Answer 3

I submitted an issue to the l3build github and it has been fixed. Thanks Joseph and Marcel!