Go to file
dependabot[bot] 683ccbf916 Bump actions/setup-python from 5.1.0 to 5.1.1
Bumps [actions/setup-python](https://github.com/actions/setup-python) from 5.1.0 to 5.1.1.
- [Release notes](https://github.com/actions/setup-python/releases)
- [Commits](https://github.com/actions/setup-python/compare/v5.1.0...v5.1.1)

---
updated-dependencies:
- dependency-name: actions/setup-python
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
2024-08-08 00:44:10 -07:00
.github Bump actions/setup-python from 5.1.0 to 5.1.1 2024-08-08 00:44:10 -07:00
docs Update docs 2021-05-11 19:12:31 -07:00
tests Add -s, -n, and -y options to release 2024-04-15 23:45:24 -07:00
yaclog Infer version number for unreleased versions 2024-08-08 00:43:16 -07:00
.gitignore Ignore .idea 2021-04-12 22:44:20 -07:00
.readthedocs.yaml Readthedocs broke their dang config schema? 2024-04-16 00:08:25 -07:00
CHANGELOG.md add "--version" option to yaclog show 2024-08-08 00:30:18 -07:00
LICENSE.md Make license markdown 2021-04-12 22:43:09 -07:00
logo.png Add logo 2021-04-18 16:57:55 -07:00
pyproject.toml Add cargo.toml support 2022-08-13 20:02:45 -07:00
README.md Version 1.0.0 2021-05-07 14:52:28 -07:00

Yaclog

Documentation Status Build Status PyPI version

Yet another changelog command line tool

a yak who is a log

Logo by Erin Cassidy

Installation

Install and update using pip:

$ pip install -U yaclog

Usage

For usage from the command line, yaclog provides the yaclog command:

Usage: yaclog [OPTIONS] COMMAND [ARGS]...

  Manipulate markdown changelog files.

Options:
  --path FILE  Location of the changelog file.  [default: CHANGELOG.md]
  --version    Show the version and exit.
  --help       Show this message and exit.

Commands:
  entry    Add entries to the changelog.
  format   Reformat the changelog file.
  init     Create a new changelog file.
  release  Release versions.
  show     Show changes from the changelog file
  tag      Modify version tags

Example workflow

Create a new changelog:

$ yaclog init

Add some new entries to the "Added" section of the current unreleased version:

$ yaclog entry -b 'Introduced some more bugs'
$ yaclog entry -b 'Introduced some more features'

Show the current version:

$ yaclog show
Unreleased

- Introduced some more bugs
- Introduced some more features

Release the current version and make a git tag for it

$ yaclog release 0.0.1 -c
Renamed version "Unreleased" to "0.0.1".
Commit and create tag for version 0.0.1? [y/N]: y
Created commit a7b6789
Created tag "0.0.1".