None if X is None else Y is quite the Python idiom.

To my perl eyes X and Y reads easier (if that's the point?):

tl.process.compiler and tl.process.compiler.compiler_string

Not sure what is more readable for me ... the "if X is something falsish, return X, otherwise return Y" is common in Perl, but in Python I always stumble about "What was it again ... didn't and return True/False ..."

BTW, I think it was a failure to design Python like this - because it is Perl dialact ;-)

Isn't it generally easier+safer to check once here if api_args has content then add the & separator, compared to starting api_args with & in each caller of this function?

Not sure. I am fine with both

For reference, there's a module: urllib.parse.urlencode

Not sure that is needed here, since we control what makes up the api call, so we know that we don't have spaces to quote etc. IMHO that would only obfuscate things.

Concerning the args, do you think that is better:

    if not api_args:
        # check for empty string or empty list
        final_api_args = ""
    else:
        if isinstance(api_args, str):
            if api_args.startswith('&'):
                final_api_args = api_args
            else:
                final_api_args = '&' + api_args
        else:
            final_api_args = "&".join(["", *api_args])

I am not sure ... it is not for public consumption but testing.

Well, maybe go with a dict as argument and do

    params_dict = { "timeout": tex2pdf_timeout }
    params_dict.update(api_args)
    params = urllib.parse.urlencode(params_dict)
    url = f"{service}/?{params}"

Will do that.

Done that now.

These are nice.
I also want to suggest a slightly more painful preamble/postamble test:

preamble.tex

\def\hello{world}
\documentclass{book}

postamble.tex

%\printbibliography
\end{document}

main.tex

\def\main{macros}
\input{preamble}

\begin{document}
some content
\input{postamble}

Very nice example, added.
And fixed a bug in the toplevel file detection when the main.tex is not definitive on tex vs latex.
Added unittest usng this example.

curious why?

That was a comment from Tai who originally wrote the code ;-)

Looking at the os.path.* methods convention, it seems a single path is the common argument expectation - rather than a path_list. Maybe downgrade to a single path argument to avoid surprises? Use could then switch from

 assembly.append(strip_to_basename([fn], ".pdf")[0])

to

 assembly.append(strip_to_basename(fn, ".pdf"))

tHmm, indeed. tex2pdf.doc_converter has the very same definition and tex2pdf uses it with lists.

Maybe better to import it from zzrm to tex2pdf.doc_convert? Or use separate function names (add _list` to the doc_converter version.

@dginev WDYT?

The list variant is just not really needed... This function is barely needed as it is :)

On a list one could:

[strip_to_basename(path) for path in paths]

Ok, I have changed the zerozeroreadme's strip_to_basename to take only one path