Git Product home page Git Product logo

braudel's Introduction

Braudel

Foreword

Braudel is at the same time a learning experience and a tool to scratch my own itch. It might not work for you for various reasons. I'll try to make it robust in the future. But currently it serves me kind of-well.

Braudel does not follow semVer.

What's Braudel?

A git log Changelog, News & New contributors Generator.

  • When heavy guns (e.g. release-please or semantic-release) aren't necessary.
  • When you don't want a full-blown system with GitHub bot, PR and Releases...
  • When you use squash merging (you get a much more cleaner changelog)
  • When you want to add special news to your changelog
  • When you want an UPDATES.md to be some commits behind ๐Ÿ˜…
  • Minimal. Bugged (almost no error catching). No dependencies. No fuss.

Usage

Require Node.js > 18.x or Bun.sh.
Braudel works (best) if commits follow conventional commits.

Generate an UPDATES.md

  1. Use git as usual and whenever you feel it's the right moment:
  2. npx braudel@latest --gh "{username}/{repo}" (e.g. charnould/braudel)
    You can add a --group flag (day|week|month|year)
  3. It will output UPDATES.md in your root directory.

Add a news to your UPDATES.md

  1. npx braudel@latest --news "A Headline" --message "Some content"
    It will create an empty commit with above headline and content

Demo

Braudel UPDATES.md is generated using itself!
But I've just cleaned up my git history (was a mess!)

Todo/roadmap

  • Catch errors
  • Add tests
  • Allow to add link in news
  • Make it work better: regex, sorting, etc.
  • Generate a 'new contributors' chapter
  • Be able to modify output file
  • Lookup between git user and GitHub username (?)
  • Be able to disable 'new contributors' and/or 'changelog'

Licence

MIT.
Copyright (c) 2023-present, Charles-Henri Arnould

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.