From f9e434067c6de173cc8b057fde0497f3981ccce8 Mon Sep 17 00:00:00 2001 From: Lars Wirzenius Date: Sat, 19 Jun 2021 10:54:18 +0300 Subject: docs: document dependencies in README Sponsored-by: author --- README.md | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 50 insertions(+) (limited to 'README.md') diff --git a/README.md b/README.md index ef960c4..9858c4f 100644 --- a/README.md +++ b/README.md @@ -13,6 +13,56 @@ implementation details, see the [obnam.md][] subplot file. [tutorial.md]: https://doc.obnam.org/tutorial.html [obnam.md]: https://doc.obnam.org/obnam.html +# Dependencies for build and test + +The up-to-date, tested list of dependencies for building and testing +Obnam are listed in the file [debian/control](debian/control), in +terms of Debian packages, and in [Cargo.toml](Cargo.toml) for Rust. +The Rust dependencies are handled automatically by the Cargo tool on +all platforms. The other dependencies are, not including ones needed +merely for building Debian packages: + +* [daemonize](http://software.clapper.org/daemonize/) – a tool + for running a command as a daemon in the background; needed for + testing, so that the Obnam server can be started and stopped by the + Obnam test suite. + +* [SQLite](https://sqlite.org), specifically its development library + component – an SQL database engine that stores the whole + database in a file and can be used as a library rather then run as a + service. + +* [OpenSSL](https://www.openssl.org), specifically its development + library component known as `libssl-dev` – a library that + implments TLS, which Obnam uses for communication between its client + and server parts. + +* [moreutils](https://joeyh.name/code/moreutils/) – a collection + of handy utilities, of which the Obnam test suite uses the `chronic` + tool to hide output of successful commands. + +* [pkg-config](http://pkg-config.freedesktop.org) – a tool for + managing compile and link time flags; needed so that the OpenSSL + library can be linked into the Obnam binaries. + +* [Python 3](https://www.python.org/), + [Requests](http://python-requests.org), + [PYYAML](https://github.com/yaml/pyyaml) – programming + language and libraries for it, used by the Obnam test suite. + +* [Subplot](https://subplot.liw.fi) – a tool for documenting + acceptance criteria and verifying that they are met. + +* [TeX Live](http://www.tug.org/texlive/) – a typesetting system + for generating PDF versions of documentation. The LaTeX + implementation and fonts are needed, not the full suite. None of Tex + Live is needed, if PDFs aren't needed, but `./check` does not + currently have a way to be told not to generate PDFs. + +* [Summain](https://summain.liw.fi) – a tool for generating + manifests of files. Used by the Obnam test suite to verify restored + data matches the original data. + ## Legalese Copyright 2020-2021 Lars Wirzenius -- cgit v1.2.1