3 ms·
Practically speaking how useful are the Rust doctests? I thought they looked like a genius idea but I don’t get how they work 95% of the time when examples don
by Waterluvian 5y ago
Practically speaking how useful are the Rust doctests?
I thought they looked like a genius idea but I don’t get how they work 95% of the time when examples don’t come with all the plumbing required to make valid state for a function to actually work on.
- justinpombrio 5y agoThere's a feature for that: you prefix the plumbing with `#`, and it runs in the doctest but doesn't render on the doc page. https://doc.rust-lang.org/rustdoc/documentation-tests.html#hiding-portions-of-the-example https://doc.rust-lang.org/rustdoc/documentation-tests.html#h...
- Waterluvian 5y agoThat would help. I’ll have to experiment to better understand if it all works well enough. I’m thinking about Python unittest having setUp function for preparing every test without repeating myself. Maybe Rust has a similar way to define setup code for every test.