release_checker/readme.md

77 lines
2.0 KiB
Markdown
Raw Permalink Normal View History

2023-02-02 20:26:03 +00:00
### 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.
2023-03-14 21:49:34 +00:00
Pleasee note: right now it will send one mail pr saved current. I am working on merging it to one mail.
2023-03-14 21:48:26 +00:00
2023-02-02 20:26:03 +00:00
### 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"
2022-12-16 13:56:01 +00:00
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.
2023-02-02 20:26:03 +00:00
### Beta
2022-12-16 14:00:00 +00:00
This is still beta. I use it and fixes the bugs when i find them.
2023-05-18 19:19:32 +00:00
### Version supported
The only version supported right now is semver, with or without a `v` prefix. Fx:
1. `1.2.3` or
2. `v1.2.3`
Not all github projects is doing tagging like this, so there is some projects that can't be watched right now.
2023-02-02 20:26:03 +00:00
### How to build
There is no releases yet, but clone the repo, cd to the root and run `cargo build`.
2023-02-02 20:26:03 +00:00
### Please notice
* The binary is named console for now, and will changed in future versions.
2022-12-18 10:06:15 +00:00
* 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. My next round of
cleanup is going to be on using `Result` correctly and do proper error handling
2023-05-18 19:19:32 +00:00
Happy hacking!