Skip to content

Commit 8ba2ec1

Browse files
committed
Added a minimal readme.
1 parent 95e0e35 commit 8ba2ec1

2 files changed

Lines changed: 44 additions & 2 deletions

File tree

Makefile

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -50,8 +50,8 @@ endif
5050
generate-changelog
5151
$(call EDIT_CHANGELOG)
5252
export BRANCH_NAME=$(SHORT_BRANCH_NAME);bumpversion $(BUMPVERSION_OPTS) $(RELEASE_KIND) --allow-dirty
53-
#git push origin $(BRANCH_NAME)
54-
#git push --tags
53+
git push origin $(BRANCH_NAME)
54+
git push --tags
5555

5656
set-release-kind-major:
5757
$(eval RELEASE_KIND := major)

README.md

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
# Generate Changelog
2+
3+
Use your commit log to make a beautiful changelog file.
4+
5+
## Features
6+
7+
- Configurable to adapt to your changelog preferences.
8+
- Filter out commits and tags based on regular expression matching.
9+
- Classify commit messages into sections such as "New", "Fixes", and "Changes".
10+
- Templated using [Jinja](https://jinja.palletsprojects.com/en/3.0.x/) templates.
11+
- Rewrite commit summary or commit body using pipelines of actions.
12+
- Supports your merge or rebase workflows and complicated git histories.
13+
- Supports full or incremental changelog generation.
14+
- Parses [trailers key values](https://zerokspot.com/weblog/2020/10/24/git-commit-messages-with-attributes/)
15+
- Supports of multi-authors for one commit through configurable [trailers key values](https://git.wiki.kernel.org/index.php/CommitMessageConventions)
16+
17+
## Requirements
18+
19+
Python 3.8 or higher.
20+
21+
## Installation
22+
23+
```bash
24+
$ pip install generate-changelog
25+
```
26+
27+
28+
## Usage
29+
30+
Create a default configuration file.
31+
32+
```bash
33+
$ generate-changelog --generate-config
34+
```
35+
36+
This creates a file named `.changelog-config.yaml`. You can make changes to the default configuration.
37+
38+
Generate your changelog via:
39+
40+
```bash
41+
$ generate-changelog
42+
```

0 commit comments

Comments
 (0)