soupbot/README.md

61 lines
1.5 KiB
Markdown
Raw Normal View History

2018-01-22 03:01:32 +01:00
**soupbot** is a soup-recommending bot.
# Install
## Dependencies
* Tested OS: Linux
* C++ compiler (tested: gcc 6.4)
* [cmake](https://cmake.org/) (tested: 3.9.6)
* [boost](http://www.boost.org/) (tested: 1.63.0)
* [mastodon-cpp](https://github.com/tastytea/mastodon-cpp) (at least: 0.1.4)
## Get sourcecode
### Release
Download the current release at [GitHub](https://github.com/tastytea/soupbot/releases).
### Development version
git clone https://github.com/tastytea/soupbot-cpp.git
## Compile
mkdir build
cd build/
cmake ..
make
cmake options:
* `-DCMAKE_BUILD_TYPE=Debug` for a debug build
Install with `make install`.
# Usage
Copy `ingredients.json` to `~/.config/soupbot/ingredients.json`.
## Error codes
| Code | Explanation |
| --------: |:------------------------------|
| 0 | No error |
| 1 | Invalid call |
| 2 | Not implemented |
| 16 | Connection failed |
| 17 | TLS error |
| 18 | Invalid response from server |
| 100 - 999 | HTTP status codes |
| 65535 | Unknown exception |
If you use a debug build, you get more verbose error messages.
# Copyright
Copyright © 2018 tastytea <tastytea@tastytea.de>.
License GPLv3: GNU GPL version 3 <https://www.gnu.org/licenses/gpl-3.0.html>.
This program comes with ABSOLUTELY NO WARRANTY. This is free software,
and you are welcome to redistribute it under certain conditions.