Giter Club home page Giter Club logo

changelog-keeper's Introduction

Changelog Keeper

Command line utility for keeping your changelog tidy

About the project

This tool aims to:

  1. make your changelog file standardized; and
  2. reduce the time spent on updating the changelog file by providing a suite of basic commands.

The Changelog standard is based on the keep-a-changelog convention with few adjustments, described in this document.

It is also possible (with some additional scripting/tooling) to incorporate this utility into your Continuous Integration & Continuous Delivery routines. There are few things to consider, mentioned in this document.

Getting started

Prerequisites

  • Python >= 3.7
  • Pip

Installation

# general installation
pip install changelog-keeper

# with specific version
pip install changelog-keeper==1.0.0

Usage

Changelog Keeper provides five simple commands allowing basic operations on the changelog file:

# Create new, empty changelog file
clkpr create [-f PATH]

# Add new entry to the changelog file
clkpr add [-f PATH] CHANGE_TYPE ENTRY

# Validate and (if needed and possible) fix the changelog file
clkpr check [-f PATH]

# Release a version (with optional link)
clkpr release [-f PATH] [-r URL] VERSION_NAME

# Yank released version
clkpr yank [-f PATH] VERSION_NAME

# For more details, one can check the help messages for the tool: `clkpr -h`
# and for a particular command: `clkpr <command> -h`

Contributing

Please have a look into CONTRIBUTING file for detailed suggestions regarding project contribution.

License

Distributed under the MIT License. See LICENSE file for more information.

changelog-keeper's People

Contributors

nulljax avatar

Stargazers

 avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.