Skip to content

Commit

Permalink
docs: Update examples in the README.md file
Browse files Browse the repository at this point in the history
  • Loading branch information
panpuchkov committed Dec 28, 2023
1 parent d18cc7b commit a3d8ea2
Showing 1 changed file with 68 additions and 3 deletions.
71 changes: 68 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,22 @@ Features:

You may use it as a Python package or a Docker container.

## PIP Package
## Usage as PIP Package (python is required)

### Check commit message

```shell
$ pygitver --check-commit-message "feat: conventional commmit example"
$ echo $?
0
$ pygitver --check-commit-message "non-conventional commmit example"
ERROR: Commit does not fit Conventional Commits requirements
More about Conventional Commits: https://www.conventionalcommits.org/en/v1.0.0/
$ echo $?
1
```

### Get current/next version
```shell
$ git tag -l
v0.0.1
Expand All @@ -19,11 +33,62 @@ $ pygitver --curr-ver
v0.0.2
$ pygitver --next-ver
v0.0.3

```

### Generate changelog
```shell
$ pygitver changelog
##########
Change Log
##########

Version v0.0.3
=============

Features
--------

* Allow to trigger job manually

Bug Fixes
---------

* Path for the default changelog template

* Readme.md usage

Improved Documentation
----------------------

* Add examples to the readme.md

$ pygitver changelog --format json | jq .
{
"version": "v0.0.3",
"bump_rules": {
"major": false,
"minor": false,
"patch": true
},
"changelog": {
"features": [
"allow to trigger job manually"
],
"bugfixes": [
"path for the default changelog template",
"README.md usage"
],
"deprecations": [],
"others": [],
"docs": [
"Add examples to the README.md"
],
"non_conventional_commit": []
}
}
```

## Docker Container
## Usage as Docker container (docker engine is required)

```shell
$ git tag -l
Expand Down

0 comments on commit a3d8ea2

Please sign in to comment.