Code Monkey home page Code Monkey logo

changeling's Introduction

Changeling - A Changelog Generator

Generates changelogs between commit hashes and creates a clean markdown file with commit prefix sections

Build Status Build Status Stars Forks


Changeling helps you to generate changelogs between commit hashes easily. Depending on your commit message prefixes, your changelog will be created with markdown sections and commit messages with corresponding hashes.

How To Install:

  • Requirements
  • Clone or Download this repository
  • Within the directory, from your favorite terminal
    • npm install
    • npm link (might ask for permission depending on your OS)
  • Now you can use clog or changelog right from your terminal!

How To Use:

In order to use the app, please follow How To Install steps above.

When you complete installation, you can run commands below

Available Commands:

Command Description
clog Run Changeling
clog -s Open Settings File In Editor
clog -h Display This Help

Generating Log File

Whenever you run clog app will run by default. You need to fill required fields to generate your changelog. When you are done, changelog will be saved in your git directory.

Settings Description
Title Title for your new changelog (ie. Milestone 5)
From Commit Hash Pick from which commit you want to include commits
To Commit Hash Pick which commit you want to end fetching commits
Append or Create If you generated a changelog before, you can append to it or create a new changelog
Check Settings Check your settings before creating

Settings

You can update settings by using clog -s command. This will open config file within your beloved editor. Default Settings:

Key Value
prefixes Add
Remove
Improve
Change
Update
Refactor
Fix
defaultFileName Changelog.md
tempFileName tempLog.txt

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

changeling's People

Contributors

excalith avatar

Stargazers

 avatar

Watchers

 avatar

changeling's Issues

Custom Prefix Support

Ability to add users own prefixes will be invaluable since everyone has different prefix settings for their projects. To store settings in local, configstore is a great dependency to use.

Notes:

  • Would be necessary to update whole prefix system to work with dictionary instead of constant array variables for each prefix.
  • Need help and settings arguments to reach settings file and a simple help to explain what is required etc.

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.