README.md file is added.

This commit is contained in:
Foil-hat-guy 2025-04-20 12:13:03 +03:00
parent 25ff46d0ed
commit c170fd46b3
No known key found for this signature in database
GPG key ID: 221CC305A7B23591

38
README.md Normal file
View file

@ -0,0 +1,38 @@
### The "Version" package
=============
This package provides --version flag feature to your cli.
It recognize both short and long flags. Version number is
automatically added from the latest tag in your git repo.
-------------
### Usage
1. Download the package by **go get** command:
```shell
go get code.foilhatguy.casa/pub/version
```
2. Add the package as a tool dependency to your project,
tools.go:
```go
// +build tools
package tools
import (
_ "code.foilhatguy.casa/pub/version"
)
```
3. In the main package add a go:generate directive:
```go
//go:generate go run code.foilhatguy.casa/pub/version
```
4. Run code generator by **go generate** command:
```shell
go generate ./...
```
The package will detect a version number from the latest git
tag from your project. Then it will generate a **version.go**
file as a part of the main package. It will contain a version
number as a constant and code for --version flag detection.
5. Build and run your application with the --version flag.
```shell
go run . --version
```