Added a readme. I am now officially an open source maintainer! I LOVE THIS!!!!
ci/woodpecker/push/woodpecker Pipeline was successful Details

This commit is contained in:
Martin Slot 2022-12-15 16:22:35 +01:00
parent 75d00b3856
commit 2b4f980a9a
1 changed files with 63 additions and 0 deletions

63
readme.md Normal file
View File

@ -0,0 +1,63 @@
# What
This is a simple cli program where you can
1. register what you currently have,
2. register where the latest version can be found,
3. and send an email when it changes
for now this only conforms to:
1. github, with
2. semver release tags, and
3. email
but i have some updates to it in my mind in the future.
# How
Create a settings.toml in the same directory as the `console`:
```toml
[database]
connection_string = "version_checker_db"
in_memory = false
[email]
from = "from@address.ltd"
smtp_username = "your_smtp_username"
smtp_password = "your_smtp_password
smtp_relay = "your_smtp_realy"
```
Register where to find release tags
```bash
./console register origin github gitea go-gitea gitea
```
Register what you have
```bash
./console register current github gitea 1.2.3 mail@domain.tld
```
And make a request
```bash
./console request
```
This will send an email if the versions differ. Remember to update the version with the checker when you have updated your software.
You can now add it as a cron job, and make a daily request.
# Beta
This is still beta. I use it and fixes the bugs when i find it.
# How to build
There is no releases yet, but clone the repo, cd to the root and run `cargo build`.
# Please notice
* The binary is named console for now, and will changed in future versions.
* It will drop a sqlite database in the same folder as the console. This can't be overridden yet (but this is on my todo list to change that)
* I am new to rust, so the code i produce is not ferris on wheels, but i will get there eventually
Happy hacking!