diff options
author | Lars Wirzenius <liw@liw.fi> | 2021-06-19 10:54:18 +0300 |
---|---|---|
committer | Lars Wirzenius <liw@liw.fi> | 2021-06-19 10:54:18 +0300 |
commit | f9e434067c6de173cc8b057fde0497f3981ccce8 (patch) | |
tree | d82c02ebf826e4d048f13871bc36a486f1d9d1f1 | |
parent | 0536ceaf7ae28d9b0db36b58719d74c58518f949 (diff) | |
download | obnam2-f9e434067c6de173cc8b057fde0497f3981ccce8.tar.gz |
docs: document dependencies in README
Sponsored-by: author
-rw-r--r-- | README.md | 50 |
1 files changed, 50 insertions, 0 deletions
@@ -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 |