From a021d3e8ff545e1bc77e5486dbdb18ae1806f8df Mon Sep 17 00:00:00 2001 From: Simon Vieille Date: Wed, 24 Jul 2024 16:18:05 +0200 Subject: [PATCH 1/3] update readme --- README.md | 82 +++++++++++++++++++++++++++++++++++-------------------- 1 file changed, 53 insertions(+), 29 deletions(-) diff --git a/README.md b/README.md index b84f40f..17001c0 100644 --- a/README.md +++ b/README.md @@ -1,38 +1,62 @@ -Expiration check -================ +# ⏰ Expiration check -Checks the expiration dates of domains and certificates. +**Expiration-check** is a command-line tool designed to verify the expiration dates of domains and TLS certificates. -Domain expiration check uses [`RDAP`](https://about.rdap.org/) and fallback with a `whois` request. +For domain verification, it implements the [RDAP protocol](https://about.rdap.org/) whenever possible. If RDAP is unavailable, it falls back on the WHOIS protocol. -## Usage +## How to install the project -Go to [releases](https://gitnet.fr/deblan/expiration-check/releases) and download the latest version. +Pre-compiled versions are available in the [Releases](https://gitnet.fr/deblan/expiration-check/releases). Multiple operating systems are supported, including Linux, Windows, and macOS. For Debian users, a package is also provided. -```text -$ expiration-check domains -d example.com -d other-example.com -+-------------------+------+---------------------+ -| DOMAIN | DAYS | DATE | -+-------------------+------+---------------------+ -| example.com | XX | YYYY-MM-DD HH:MM:SS | -| other-example.com | XXX | YYYY-MM-DD HH:MM:SS | -+-------------------+------+---------------------+ +If you want to compile the project from source, you will need at least the GO compiler version 1.22. Clone the project and run the make command. The compiled output will be located in the build directory. -$ expiration-check certificates -d example.com -d other-example.com -d mail.example.com:993 -+-------------------+------+---------------------+ -| DOMAIN | DAYS | DATE | -+-------------------+------+---------------------+ -| example.com | XX | YYYY-MM-DD HH:MM:SS | -| other-example.com | XXX | YYYY-MM-DD HH:MM:SS | -| mail.example.com | XXX | YYYY-MM-DD HH:MM:SS | -+-------------------+------+---------------------+ +``` +$ git clone https://gitnet.fr/deblan/expiration-check +$ make ``` -You can specify an ouput format using `--format` or `-f`: +## How to use the Project -- `table` (default) -- `json` -- `csv` -- `tsv` -- `html` -- `markdown` +### Commands + +- `certificates`, `certificate`, `cert`, `certs`, `c`: Checks the expiration dates of TLS certificates. +- `domains`, `domain`, `d`: Checks the expiration dates of domain names. +- `help`, `h`: Displays a list of all commands or detailed help for a specific command. + +### Global Options + +- `--help`, `-h`: Shows the help message, providing information about the usage and available commands. + +Use the `--format` or `-f` option to specify the output format. Available formats are table, csv, tsv, html, json, and markdown. The default format is table. + +### Examples + +Check certificate expirations: + +``` +expiration-check certificate --domain example.com +``` + +Check domain expirations: + +``` +expiration-check domain --domain example.com +``` + +Check certificates for multiple domains with default table format: + +``` +expiration-check certificate --domain example.com --domain example.org +``` + +Check certificates and output results in JSON format: + +``` +expiration-check certificate --domain example.com --format json +``` + +Get help for a specific command: + +``` +expiration-check help certificate +``` From 1eabdf5aa1d9ae84bd2546553883a90b323166a8 Mon Sep 17 00:00:00 2001 From: Simon Vieille Date: Wed, 24 Jul 2024 16:21:44 +0200 Subject: [PATCH 2/3] update readme --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 17001c0..a6888e9 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,10 @@ -# ⏰ Expiration check +# 📅 Expiration check **Expiration-check** is a command-line tool designed to verify the expiration dates of domains and TLS certificates. For domain verification, it implements the [RDAP protocol](https://about.rdap.org/) whenever possible. If RDAP is unavailable, it falls back on the WHOIS protocol. -## How to install the project +## 📗 How to install the project Pre-compiled versions are available in the [Releases](https://gitnet.fr/deblan/expiration-check/releases). Multiple operating systems are supported, including Linux, Windows, and macOS. For Debian users, a package is also provided. @@ -15,7 +15,7 @@ $ git clone https://gitnet.fr/deblan/expiration-check $ make ``` -## How to use the Project +## 🧪 How to use the Project ### Commands From 867e8952f016ecd6ddbaf58e38e4550dc2d09512 Mon Sep 17 00:00:00 2001 From: Simon Vieille Date: Wed, 24 Jul 2024 16:23:14 +0200 Subject: [PATCH 3/3] update readme --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index a6888e9..a94e3aa 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# 📅 Expiration check +# 🗓️ Expiration check **Expiration-check** is a command-line tool designed to verify the expiration dates of domains and TLS certificates. @@ -15,7 +15,7 @@ $ git clone https://gitnet.fr/deblan/expiration-check $ make ``` -## 🧪 How to use the Project +## 🧪 How to use the Project ### Commands