mirror of
https://github.com/thegeeklab/git-sv.git
synced 2024-11-28 06:30:35 +00:00
docs: first version of readme
This commit is contained in:
parent
9374b3addc
commit
918b871dfb
81
README.md
81
README.md
@ -1,2 +1,83 @@
|
|||||||
# sv4git
|
# sv4git
|
||||||
|
|
||||||
Semantic version for git
|
Semantic version for git
|
||||||
|
|
||||||
|
## Getting Started
|
||||||
|
|
||||||
|
### Installing
|
||||||
|
|
||||||
|
Comming soon...
|
||||||
|
|
||||||
|
## Running
|
||||||
|
|
||||||
|
run `git-sv` to get the list of available parameters
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git-sv
|
||||||
|
```
|
||||||
|
|
||||||
|
### Run as git command
|
||||||
|
|
||||||
|
if `git-sv` is configured on your path, you can use it like a git command
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git sv
|
||||||
|
git sv current-version
|
||||||
|
git sv next-version
|
||||||
|
```
|
||||||
|
|
||||||
|
## Development
|
||||||
|
|
||||||
|
### Makefile
|
||||||
|
|
||||||
|
run `make` to get the list of available actions
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Make configs
|
||||||
|
|
||||||
|
| Variable | description|
|
||||||
|
| --------- | ----------|
|
||||||
|
| BUILDOS | build OS |
|
||||||
|
| BUILDARCH | build arch |
|
||||||
|
| ECHOFLAGS | flags used on echo |
|
||||||
|
| BUILDENVS | var envs used on build |
|
||||||
|
| BUILDFLAGS | flags used on build |
|
||||||
|
|
||||||
|
| Parameters | description|
|
||||||
|
| --------- | ----------|
|
||||||
|
| args | parameters that will be used on run |
|
||||||
|
|
||||||
|
```bash
|
||||||
|
#variables
|
||||||
|
BUILDOS="linux" BUILDARCH="amd64" make build
|
||||||
|
|
||||||
|
#parameters
|
||||||
|
make run args="-h"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Build
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make build
|
||||||
|
```
|
||||||
|
|
||||||
|
the binary will be created on `bin/$BUILDOS_$BUILDARCH/git-sv`
|
||||||
|
|
||||||
|
### Tests
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make test
|
||||||
|
```
|
||||||
|
|
||||||
|
### Run
|
||||||
|
|
||||||
|
```bash
|
||||||
|
#without args
|
||||||
|
make run
|
||||||
|
|
||||||
|
#with args
|
||||||
|
make run args="-h"
|
||||||
|
```
|
||||||
|
Loading…
Reference in New Issue
Block a user