Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

v0.10 Release #126

Merged
merged 3 commits into from
Jul 9, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/release_nightly.yml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
on:
push:
branches: [master, main]
# branches: [master, main]

name: Nightly Release

Expand Down
2 changes: 1 addition & 1 deletion Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ keywords = ["git", "log", "changelog", "parser", "parse"]
license = "MIT"
name = "clog-cli"
edition = "2021"
version = "0.9.3"
version = "0.10.0"
rust-version = "1.74.1" # msrv
authors = ["Christoph Burgdorf <[email protected]>"]
description = "A conventional changelog for the rest of us"
Expand Down
77 changes: 35 additions & 42 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -90,48 +90,41 @@ Otherwise, ensure you have the `clog` binary in the directory which you operatin
`clog` works by reading your `git` metadata and specially crafted commit messages and subjects to create a changelog. `clog` has the following options available.

```sh
USAGE:
clog [FLAGS] [OPTIONS]

FLAGS:
-F, --from-latest-tag use latest tag as start (instead of --from)
-h, --help Prints help information
-M, --major Increment major version by one (Sets minor and patch to 0)
-m, --minor Increment minor version by one (Sets patch to 0)
-p, --patch Increment patch version by one
-V, --version Prints version information

OPTIONS:
-C, --changelog <changelog> A previous changelog to prepend new changes to (this is like
using the same file for both --infile and --outfile and
should not be used in conjunction with either)
-c, --config <config> The Clog Configuration TOML file to use (Defaults to
'.clog.toml')**
-T, --format <format> The output format, defaults to markdown
(valid values: markdown, json)
-f, --from <from> e.g. 12a8546
-g, --git-dir <gitdir> Local .git directory (defaults to current dir + '.git')*
-i, --infile <infile> A changelog to append to, but *NOT* write to (Useful in
conjunction with --outfile)
-o, --outfile <outfile> Where to write the changelog (Defaults to stdout when omitted)
-r, --repository <repo> Repository used for generating commit and issue links
(without the .git, e.g. https://github.com/clog-tool/clog-cli)
-l, --link-style <style> The style of repository link to generate
(Defaults to github) [values: Github Gitlab Stash]
-s, --subtitle <subtitle> e.g. "Crazy Release Title"
-t, --to <to> e.g. 8057684 (Defaults to HEAD when omitted)
--setversion <ver> e.g. 1.0.1
-w, --work-tree <workdir> Local working tree of the git project
(defaults to current dir)*

* If your .git directory is a child of your project directory (most common, such as
/myproject/.git) AND not in the current working directory (i.e you need to use --work-tree or
--git-dir) you only need to specify either the --work-tree (i.e. /myproject) OR --git-dir (i.e.
/myproject/.git), you don't need to use both.

** If using the --config to specify a clog configuration TOML file NOT in the current working
directory (meaning you need to use --work-tree or --git-dir) AND the TOML file is inside your
project directory (i.e. /myproject/.clog.toml) you do not need to use --work-tree or --git-dir.
Usage: clog [OPTIONS]

Options:
-r, --repository <URL> Repository used for generating commit and issue links (without the .git, e.g.
https://github.com/thoughtram/clog)
-f, --from <COMMIT> e.g. 12a8546
-T, --format <STR> The output format, defaults to markdown [default: markdown] [possible values: markdown,
json]
-M, --major Increment major version by one (Sets minor and patch to 0)
-g, --git-dir <PATH> Local .git directory (defaults to "$(pwd)/.git")
-w, --work-tree <PATH> Local working tree of the git project (defaults to "$(pwd)")
-m, --minor Increment minor version by one (Sets patch to 0)
-p, --patch Increment patch version by one
-s, --subtitle <STR>
-t, --to <COMMIT> e.g. 8057684 [default: HEAD]
-o, --outfile <PATH> Where to write the changelog (Defaults to stdout when omitted)
-c, --config <COMMIT> The Clog Configuration TOML file to use [default: .clog.toml]
-i, --infile <PATH> A changelog to append to, but *NOT* write to (Useful in conjunction with --outfile)
--setversion <VER> e.g. 1.0.1
-F, --from-latest-tag use latest tag as start (instead of --from)
-l, --link-style <STR> The style of repository link to generate [default: github] [possible values: github,
gitlab, stash, cgit]
-C, --changelog <PATH> A previous changelog to prepend new changes to (this is like using the same file for both
--infile and --outfile and should not be used in conjunction with either)
-h, --help Print help
-V, --version Print version


If your .git directory is a child of your project directory (most common, such as /myproject/.git) AND not in the
current working directory (i.e you need to use --work-tree or --git-dir) you only need to specify either the
--work-tree (i.e. /myproject) OR --git-dir (i.e. /myproject/.git), you don't need to use both.

If using the --config to specify a clog configuration TOML file NOT in the current working directory (meaning you
need to use --work-tree or --git-dir) AND the TOML file is inside your project directory (i.e.
/myproject/.clog.toml) you do not need to use --work-tree or --git-dir.
```

#### Try it!
Expand Down
22 changes: 22 additions & 0 deletions changelog.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,25 @@
<a name="0.10.0"></a>
### 0.10.0 (2024-07-09)

#### Breaking Changes

* update MSRV to 1.74.1 ([f190944](https://github.com/clog-tool/clog-cli/commit/f190944))

#### Documentation

* **README.md**: update --help after migrating to clav v4 ([72a1aa1](https://github.com/clog-tool/clog-cli/commit/72a1aa1))
* fix typos ([8e58db2](https://github.com/clog-tool/clog-cli/commit/8e58db2))

#### Style Fixes

* update edition to 2021 ([abe1a8b](https://github.com/clog-tool/clog-cli/commit/abe1a8b))
* use same rustfmt config as clog-lib ([fea7545](https://github.com/clog-tool/clog-cli/commit/fea7545))

#### Improvements

* remove `time` dep ([bc6e283](https://github.com/clog-tool/clog-cli/commit/bc6e283))
* Update deps and fix compiling errors ([813ce80](https://github.com/clog-tool/clog-cli/commit/813ce80))

<a name="0.9.2"></a>
### 0.9.2 (2016-04-04)

Expand Down
Loading