yaclog


Nameyaclog JSON
Version 1.5.0 PyPI version JSON
download
home_pageNone
SummaryYet another changelog CLI tool.
upload_time2024-10-16 06:59:49
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseNone
keywords changelog commandline markdown
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Yaclog 

[![Documentation Status](https://readthedocs.org/projects/yaclog/badge/?version=latest)](https://yaclog.readthedocs.io/en/latest/?badge=latest)
[![Build Status](https://github.com/drewcassidy/yaclog/actions/workflows/build.yml/badge.svg)](https://github.com/drewcassidy/yaclog/actions/workflows/python-publish.yml)
[![PyPI version](https://badge.fury.io/py/yaclog.svg)](https://badge.fury.io/py/yaclog)

Yet another changelog command line tool

![a yak who is a log](https://github.com/drewcassidy/yaclog/raw/main/logo.png)

*Logo by Erin Cassidy*

## Installation

Install and update using [pip](https://pip.pypa.io/en/stable/quickstart/):

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

Add some new entries to the "Added" section of 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.8",
    "maintainer_email": null,
    "keywords": "changelog, commandline, markdown",
    "author": null,
    "author_email": "Andrew Cassidy <drewcassidy@me.com>",
    "download_url": "https://files.pythonhosted.org/packages/0f/86/acf86864d67739fa6785cfec340fc43cbf941871b2fcbf74efabe4a7156a/yaclog-1.5.0.tar.gz",
    "platform": null,
    "description": "# Yaclog \n\n[![Documentation Status](https://readthedocs.org/projects/yaclog/badge/?version=latest)](https://yaclog.readthedocs.io/en/latest/?badge=latest)\n[![Build Status](https://github.com/drewcassidy/yaclog/actions/workflows/build.yml/badge.svg)](https://github.com/drewcassidy/yaclog/actions/workflows/python-publish.yml)\n[![PyPI version](https://badge.fury.io/py/yaclog.svg)](https://badge.fury.io/py/yaclog)\n\nYet another changelog command line tool\n\n![a yak who is a log](https://github.com/drewcassidy/yaclog/raw/main/logo.png)\n\n*Logo by Erin Cassidy*\n\n## Installation\n\nInstall and update using [pip](https://pip.pypa.io/en/stable/quickstart/):\n\n```shell\n$ pip install -U 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 \"Added\" section of 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.5.0",
    "project_urls": {
        "Changelog": "https://github.com/drewcassidy/yaclog/blob/main/CHANGELOG.md",
        "Docs": "https://yaclog.readthedocs.io/",
        "Source": "https://github.com/drewcassidy/yaclog"
    },
    "split_keywords": [
        "changelog",
        " commandline",
        " markdown"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "01e1b883a32aadb1233fb1c367202900c93d3032fc05fdc5baaa09900dfaa03e",
                "md5": "0baaab6eeb280bd868b8bab825c95761",
                "sha256": "19cd072d2c9efaf01d191a110ee5554e74ac3e22bc1a9c6a61b640091bd2cbc3"
            },
            "downloads": -1,
            "filename": "yaclog-1.5.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "0baaab6eeb280bd868b8bab825c95761",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 20269,
            "upload_time": "2024-10-16T06:59:47",
            "upload_time_iso_8601": "2024-10-16T06:59:47.351838Z",
            "url": "https://files.pythonhosted.org/packages/01/e1/b883a32aadb1233fb1c367202900c93d3032fc05fdc5baaa09900dfaa03e/yaclog-1.5.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "0f86acf86864d67739fa6785cfec340fc43cbf941871b2fcbf74efabe4a7156a",
                "md5": "d9f0405eeaa8746f766e46971cae22b9",
                "sha256": "21f068ffc02616b56171b8cbccd7408e1344de235377982097e44cfefb11cc9e"
            },
            "downloads": -1,
            "filename": "yaclog-1.5.0.tar.gz",
            "has_sig": false,
            "md5_digest": "d9f0405eeaa8746f766e46971cae22b9",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 87571,
            "upload_time": "2024-10-16T06:59:49",
            "upload_time_iso_8601": "2024-10-16T06:59:49.113066Z",
            "url": "https://files.pythonhosted.org/packages/0f/86/acf86864d67739fa6785cfec340fc43cbf941871b2fcbf74efabe4a7156a/yaclog-1.5.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-10-16 06:59:49",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "drewcassidy",
    "github_project": "yaclog",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "yaclog"
}
        
Elapsed time: 0.33067s