JuliaDocs/Documenter.jl

Executing jldoctest blocks out of process

Open

#893 opened on 2018年11月27日

GitHub で見る
 (1 comment) (0 reactions) (0 assignees)Julia (513 forks)batch import
Status: SpeculativeType: Featurehelp wanted

Repository metrics

Stars
 (910 stars)
PR merge metrics
 (平均マージ 16d 9h) (30d で 3 merged PRs)

説明

It will be nice to have an option to execute jldoctest blocks in an external, spawned process. This would be an alternate option to wrapping the code block in a module before execution. Will help in addressing issues like https://github.com/JuliaLang/Distributed.jl/issues/19 . stdout of the spawned process can be used to check for correctness.

コントリビューターガイド

調査方針
Documenterが現在どのようにjldoctestブロックを実行しているかを調べてください。`Base.run`を使って別のJuliaプロセスを起動し、その標準出力をキャプチャし、それを代替実行モードとして統合する可能性を探ってください。既存のテストインフラストラクチャを確認し、コードベースに同様のプロセス起動パターンがあるかどうかを調べてください。
技術スタック
julia
領域
documentationtooling
Issue 種別
機能
難度新しい貢献者にとっての実装難度です。1 は非常に小さな変更、5 は専門的な作業です。
3
推定時間経験ある貢献者が調査、実装、テスト、pull request 準備にかけるおおよその時間範囲です。
半日
活動状況Issue が今どれだけ取り組みやすいかを示します。新しい、活発、古い、ブロック中、またはメンテナー入力待ちなどです。
アクティブ
明確さ期待される変更、受け入れ条件、次の手順がどれだけ明確かを示します。
明確
前提条件
Julia
初心者向け度初回貢献者にどれだけ取り組みやすいかを 1-100 で推定したスコアです。
45