yaclog


Nameyaclog JSON
Version 1.6.2 PyPI version JSON
download
home_pageNone
SummaryYet another changelog CLI tool.
upload_time2025-10-22 07:30:48
maintainerNone
docs_urlNone
authorNone
requires_python>=3.10
licenseNone
keywords changelog commandline markdown
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Yaclog: Yet Another Commandline Changelog Tool

[![Documentation Status](https://readthedocs.org/projects/yaclog/badge/?version=latest)](https://yaclog.readthedocs.io/en/)
[![CI Status](https://git.offworldcolonies.nexus/drewcassidy/yaclog/badges/workflows/build.yml/badge.svg?branch=main&label=build)](https://git.offworldcolonies.nexus/drewcassidy/yaclog/actions)
[![PyPI version](https://img.shields.io/pypi/v/yaclog)](https://pypi.org/project/yaclog/)

Yaclog is a python library and command line tool to make it easier to keep track of changes to your projects. It includes commands for appending new changes to a markdown changelog file, as well as releasing new versions for deployment via git tags.

![a yak who is a log](https://git.offworldcolonies.nexus/drewcassidy/yaclog/raw/branch/main/logo.png)

*Logo by Erin Cassidy*

## Installation

Install and update with [pip](https://pip.pypa.io/en/stable/getting-started/):

```shell
$ pip install -U yaclog
```

Or with [uv](https://docs.astral.sh/uv/getting-started/):

```shell
$ uv tool install 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:
```shell
$ yaclog init
```

Add some new entries to the current unreleased version:
```shell
$ yaclog entry -b 'Introduced some more bugs'
$ yaclog entry -b 'Introduced some more features'
```

Show the current version:

```shell
$ yaclog show
```
```
Unreleased

- Introduced some more bugs
- Introduced some more features
```

Release the current version and make a git tag for it

```shell
$ 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".
```

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "yaclog",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": null,
    "keywords": "changelog, commandline, markdown",
    "author": null,
    "author_email": "Andrew Cassidy <drewcassidy@me.com>",
    "download_url": "https://files.pythonhosted.org/packages/80/38/1c734802772229d6fd30c83e82df217ffc206acd78b1ba26854ba2dc8836/yaclog-1.6.2.tar.gz",
    "platform": null,
    "description": "# Yaclog: Yet Another Commandline Changelog Tool\n\n[![Documentation Status](https://readthedocs.org/projects/yaclog/badge/?version=latest)](https://yaclog.readthedocs.io/en/)\n[![CI Status](https://git.offworldcolonies.nexus/drewcassidy/yaclog/badges/workflows/build.yml/badge.svg?branch=main&label=build)](https://git.offworldcolonies.nexus/drewcassidy/yaclog/actions)\n[![PyPI version](https://img.shields.io/pypi/v/yaclog)](https://pypi.org/project/yaclog/)\n\nYaclog is a python library and command line tool to make it easier to keep track of changes to your projects. It includes commands for appending new changes to a markdown changelog file, as well as releasing new versions for deployment via git tags.\n\n![a yak who is a log](https://git.offworldcolonies.nexus/drewcassidy/yaclog/raw/branch/main/logo.png)\n\n*Logo by Erin Cassidy*\n\n## Installation\n\nInstall and update with [pip](https://pip.pypa.io/en/stable/getting-started/):\n\n```shell\n$ pip install -U yaclog\n```\n\nOr with [uv](https://docs.astral.sh/uv/getting-started/):\n\n```shell\n$ uv tool install yaclog\n```\n\n## Usage\n\nFor usage from the command line, yaclog provides the `yaclog` command:\n```\nUsage: yaclog [OPTIONS] COMMAND [ARGS]...\n\n  Manipulate markdown changelog files.\n\nOptions:\n  --path FILE  Location of the changelog file.  [default: CHANGELOG.md]\n  --version    Show the version and exit.\n  --help       Show this message and exit.\n\nCommands:\n  entry    Add entries to the changelog.\n  format   Reformat the changelog file.\n  init     Create a new changelog file.\n  release  Release versions.\n  show     Show changes from the changelog file\n  tag      Modify version tags\n```\n\n### Example workflow\n\nCreate a new changelog:\n```shell\n$ yaclog init\n```\n\nAdd some new entries to the current unreleased version:\n```shell\n$ yaclog entry -b 'Introduced some more bugs'\n$ yaclog entry -b 'Introduced some more features'\n```\n\nShow the current version:\n\n```shell\n$ yaclog show\n```\n```\nUnreleased\n\n- Introduced some more bugs\n- Introduced some more features\n```\n\nRelease the current version and make a git tag for it\n\n```shell\n$ yaclog release 0.0.1 -c\n```\n```\nRenamed version \"Unreleased\" to \"0.0.1\".\nCommit and create tag for version 0.0.1? [y/N]: y\nCreated commit a7b6789\nCreated tag \"0.0.1\".\n```\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Yet another changelog CLI tool.",
    "version": "1.6.2",
    "project_urls": {
        "Changelog": "https://yaclog.readthedocs.io/en/stable/changelog.html",
        "Docs": "https://yaclog.readthedocs.io/",
        "Source": "https://git.offworldcolonies.nexus/drewcassidy/yaclog"
    },
    "split_keywords": [
        "changelog",
        " commandline",
        " markdown"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "dee97d7f5f3aeea1c9b6155c4a0db8a7d02bfa9e3cc897df97fae340080784f9",
                "md5": "11456a5f124e61b3cbd3848939738f9c",
                "sha256": "7b9781487eca4703992d407f79912938980efa110c7b29f049d9cd6830d7fde3"
            },
            "downloads": -1,
            "filename": "yaclog-1.6.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "11456a5f124e61b3cbd3848939738f9c",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 21139,
            "upload_time": "2025-10-22T07:30:46",
            "upload_time_iso_8601": "2025-10-22T07:30:46.347545Z",
            "url": "https://files.pythonhosted.org/packages/de/e9/7d7f5f3aeea1c9b6155c4a0db8a7d02bfa9e3cc897df97fae340080784f9/yaclog-1.6.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "80381c734802772229d6fd30c83e82df217ffc206acd78b1ba26854ba2dc8836",
                "md5": "ece81504cd5c28007b32fdd3c2a875ab",
                "sha256": "4f5731a49ef6d0d95afe487e7f6f9953f6f7526e8170b7e5dc643ad76e253b13"
            },
            "downloads": -1,
            "filename": "yaclog-1.6.2.tar.gz",
            "has_sig": false,
            "md5_digest": "ece81504cd5c28007b32fdd3c2a875ab",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 129225,
            "upload_time": "2025-10-22T07:30:48",
            "upload_time_iso_8601": "2025-10-22T07:30:48.130787Z",
            "url": "https://files.pythonhosted.org/packages/80/38/1c734802772229d6fd30c83e82df217ffc206acd78b1ba26854ba2dc8836/yaclog-1.6.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-10-22 07:30:48",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "yaclog"
}
        
Elapsed time: 2.32402s