Make pecos crate doctests more stable?

Author: ciaranra

Makefile

@@ -134,6 +134,10 @@ clean-unix:
 	@find . -type d -name "junit" -exec rm -rf {} +
 	@find python -name "*.so" -delete
 	@find python -name "*.pyd" -delete
+	@# Clean all target directories in crates (in case they were built independently)
+	@find crates -type d -name "target" -exec rm -rf {} +
+	@find python -type d -name "target" -exec rm -rf {} +
+	@# Clean the root workspace target directory
 	@cargo clean
 
 .PHONY: clean-windows-ps
@@ -149,6 +153,9 @@ clean-windows-ps:
 	@powershell -Command "Get-ChildItem -Path . -Recurse -Directory -Filter '.hypothesis' | Remove-Item -Recurse -Force -ErrorAction SilentlyContinue"
 	@powershell -Command "Get-ChildItem -Path . -Recurse -Directory -Filter 'junit' | Remove-Item -Recurse -Force -ErrorAction SilentlyContinue"
 	@powershell -Command "Get-ChildItem -Path python -Recurse -File -Include '*.so','*.pyd' | Remove-Item -Force -ErrorAction SilentlyContinue"
+	@# Clean all target directories in crates
+	@powershell -Command "Get-ChildItem -Path crates -Recurse -Directory -Filter 'target' | Remove-Item -Recurse -Force -ErrorAction SilentlyContinue"
+	@powershell -Command "Get-ChildItem -Path python -Recurse -Directory -Filter 'target' | Remove-Item -Recurse -Force -ErrorAction SilentlyContinue"
 	@cargo clean
 
 .PHONY: clean-windows-cmd
@@ -164,6 +171,9 @@ clean-windows-cmd:
 	-@for /f "delims=" %%d in ('dir /s /b /ad .hypothesis 2^>nul') do @rd /s /q "%%d" 2>nul
 	-@for /f "delims=" %%d in ('dir /s /b /ad junit 2^>nul') do @rd /s /q "%%d" 2>nul
 	-@for /f "delims=" %%f in ('dir /s /b python\*.so python\*.pyd 2^>nul') do @del "%%f" 2>nul
+	-@REM Clean all target directories in crates
+	-@for /f "delims=" %%d in ('dir /s /b /ad crates\target 2^>nul') do @rd /s /q "%%d" 2>nul
+	-@for /f "delims=" %%d in ('dir /s /b /ad python\target 2^>nul') do @rd /s /q "%%d" 2>nul
 	-@cargo clean
 
 .PHONY: pip-install-uv

crates/pecos/Cargo.toml

@@ -11,6 +11,10 @@ categories.workspace = true
 readme = "../../README.md"
 description = "A crate for evaluating and exploring quantum error correction."
 
+[lib]
+doctest = true
+test = true
+
 [dependencies]
 pecos-core.workspace = true
 pecos-qsim.workspace = true
@@ -25,9 +29,12 @@ serde_json.workspace = true
 tempfile = "3.8"
 # Required for doctests
 pecos-core.workspace = true
+pecos-qsim.workspace = true
 pecos-engines.workspace = true
+pecos-qasm.workspace = true
 pecos-qir.workspace = true
 pecos-phir.workspace = true
+log.workspace = true
 serde_json.workspace = true
 
 [lints]

crates/pecos/src/lib.rs

@@ -10,6 +10,24 @@
 // or implied. See the License for the specific language governing permissions and limitations under
 // the License.
 
+//! The PECOS crate provides unified access to quantum error correction functionality.
+//!
+//! This crate serves as the main entry point for the PECOS ecosystem, re-exporting
+//! the primary functionality from the various specialized crates.
+
+#[cfg(doctest)]
+extern crate pecos_core;
+#[cfg(doctest)]
+extern crate pecos_engines;
+#[cfg(doctest)]
+extern crate pecos_phir;
+#[cfg(doctest)]
+extern crate pecos_qasm;
+#[cfg(doctest)]
+extern crate pecos_qir;
+#[cfg(doctest)]
+extern crate pecos_qsim;
+
 pub mod engines;
 pub mod prelude;
 pub mod program;