Is it possible to execute @example bocks of different MD files in different processes?

[peremato]

I am documenting a package using a set of Markdown files (examples) that include @example blocks. This package interfaces with a C++ library, which is highly sensitive to proper cleanup and re-initialization due to extensive use of global variables on the C++ side.

Is it possible for the @example blocks in each .md file to be executed in separate Julia processes? While I understand they run in isolated namespaces, this isolation is not sufficient for my use case.

Thank you for your help!

[goerz]

No, this is not currently possible.

You might want to look at Literate.jl, which would allow you to run a document in a standalone process, and save the result as an .md file with both the inputs and output, suitable for inclusion in Documenter.

[fredrikekre]

Why can't you clean up at the end of the file?

[peremato]

You might want to look at Literate.jl, which would allow you to run a document in a standalone process, and save the result as an .md file with both the inputs and output, suitable for inclusion in Documenter.

Thanks very much. This is what I am currently doing executing Literate in a standalone progress.

[peremato]

Why can't you clean up at the end of the file?

Unfortunately not. There are singletons that will keep some history in the next .md file.

[fredrikekre]

So it is a limitation of th C++ code that you can't cleanup and restart in the same process? Then I think your current best bet is to use Literate for execution.

[peremato]

Thanks. Yes, it is a limitation in the C++ side. I was hoping to have a solution in Julia to overcome the limitation. I can close the issue.

[fredrikekre]

Ok, so then something like #2577 wouldn't really help you either.