aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorLukasz Kasprzak <lukas@labunix.xyz>2026-09-15 00:02:37 +0200
committerLukasz Kasprzak <lukas@labunix.xyz>2026-09-15 00:02:37 +0200
commit8a046c897e42e9459aa99377589c80c773601efc (patch)
tree94d959aa7b0d456402363d57d6c97f64ff9eea22 /docs
parent5310c857d7531986c806404103f118b3c5e364f3 (diff)
downloadkrino-8a046c897e42e9459aa99377589c80c773601efc.tar.gz
krino-8a046c897e42e9459aa99377589c80c773601efc.zip
tests read real documents from LibreOffice and pandoc; antiword's short-document limit documented
Diffstat (limited to 'docs')
-rw-r--r--docs/design.md11
1 files changed, 8 insertions, 3 deletions
diff --git a/docs/design.md b/docs/design.md
index 59c64bd..ca8d550 100644
--- a/docs/design.md
+++ b/docs/design.md
@@ -861,10 +861,15 @@ placeholder numbers, screenshots by date, cleaning up old installers).
path against `git check-ignore --no-index` (skipped if git is absent).
- **Conditions:** truth tables; a property test that random condition trees
give the same result with and without cost reordering.
-- **Extraction:** the tests generate their fixtures in temporary
+- **Extraction:** most tests generate their fixtures in temporary
directories and use fake tools for PDF and the legacy formats (doc, xls,
- ppt); the real `pdftotext` test skips when the tool is missing. Real
- office-suite files and real legacy-tool runs are not tested in 0.0.1.
+ ppt). `testdata/real` holds documents LibreOffice and pandoc made from
+ invented text (docx, odt, ods, xlsx, pptx, epub, pdf, doc, xls); each is
+ read, the tool formats only when a tool for them is installed. There is no
+ real `.ppt` or `.odp` fixture (LibreOffice could not convert pandoc's
+ pptx), and xls/ppt have only run through fake tools where `catdoc` is not
+ installed. antiword refuses a `.doc` with very little text; catdoc reads
+ it.
- **Plan, apply, undo:** in temporary directories: build a tree, plan,
apply, check; undo; check the tree is identical to the start (paths,
contents, modes, mtimes). A cross-filesystem move test runs when a tmpfs is