Name | yaclog JSON |
Version |
1.5.0
JSON |
| download |
home_page | None |
Summary | Yet another changelog CLI tool. |
upload_time | 2024-10-16 06:59:49 |
maintainer | None |
docs_url | None |
author | None |
requires_python | >=3.8 |
license | None |
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"
}