@brightcove/kacl

    0.1.11 • Public • Published

    Version Downloads Build Status Coverage Greenkeeper badge

    kacl

    Keep a Changelog tooling for linting and automatically releasing changelogs

    Usage

    Requirements

    • Node 8+
    • package.json contains a valid git repository URL

    Installation

    npm i -D @brightcove/kacl

    You can also install globally to easily initialize changelogs in your projects:

    npm i -g @brightcove/kacl

    CLI Usage

    If installed globally, you can run the kacl command. If not, you can run it from your project's node_modules folder: ./node_modules/.bin/kacl

    Usage: kacl init|lint|prerelease|release
    
      init       - Initializes a new CHANGELOG.md
      lint       - Lints your changelog for errors
      prerelease - Checks the requirements for creating a new release (should be added to the "preversion" script)
      release    - Creates a new release matching your package.json version (should be added to the "version" script)
    

    Usage in package.json

    kacl is most effective when added to package.json scripts as it can be used to completely automate changelog changes when running npm version. The following is a recommendation for setting up package.json scripts to use kacl.

    {
      "scripts": {
        "posttest": "kacl lint",
        "preversion": "kacl prerelease",
        "version": "kacl release && git add CHANGELOG.md"
      }
    }

    This setup does the following:

    • Lints your changelog after running tests
    • Checks the changelog before bumping the version with npm version to ensure there is an unreleased entry
    • Updates the changelog and adds it to git after the version has been bumped with npm version. The changelog changes will automatically be committed as part of npm version.

    Usage with gh-release

    gh-release is a tool which will automatically create a tag and release on GitHub. It pairs nicely with kacl, and with both tools you can completely automate your version bumping. The following is a recommendation for setting up package.json scripts to use kacl with gh-release.

    {
      "scripts": {
        "posttest": "kacl lint",
        "preversion": "kacl prerelease",
        "version": "kacl release && git add CHANGELOG.md",
        "postversion": "git push && gh-release"
      }
    }

    This performs the same steps as what's laid out in the Usage in package.json section, with the addition of the following:

    • Pushes the new version to GitHub and creates a GitHub release using the updated changelog.

    Info

    Maintainers

    None. The former lead maintainer, who has left Brightcove, is

    Contributions

    Contributions are welcome, please see the contributing guidelines.

    Issues and Questions

    This project uses github issues, please file issues and questions here.

    Attributions and Thanks

    This project uses the keep-a-changelog library from Oscar Otero for parsing and manipulating changelogs. It's an awesome library which you should definitely check out if you're interested in helping improve project changelogs.

    Install

    npm i @brightcove/kacl

    DownloadsWeekly Downloads

    318

    Version

    0.1.11

    License

    Apache-2.0

    Unpacked Size

    23.6 kB

    Total Files

    6

    Last publish

    Collaborators

    • a_castillo_h
    • salleko
    • aperezbrightcove
    • jack.terranova
    • ireyes94
    • brightcove-admin
    • gkatsev
    • tedk
    • abradley-brightcove
    • bc-alive
    • ytaye
    • misteroneill
    • mrocajr
    • forbesjo
    • brandonocasey
    • gesinger
    • lasanchezc
    • apadhye
    • marguinbc
    • brightcove-user
    • kmason
    • tomruggs
    • bsahlas
    • cbarstow
    • hikeh
    • myerramalla
    • pdias
    • misterben
    • twalling
    • jwhisenant
    • mjneil
    • abarstow
    • jordanramey
    • rtezera1
    • tfelippe
    • rjune
    • larsmaultsby
    • amanningbcov
    • jonbwalsh
    • khaipham
    • wswanbeck
    • mjholland
    • gastafurov
    • adalwani
    • revinkey
    • ekelson-bcove
    • syseng
    • bc_rpeck
    • zhongqil
    • mcarreiro
    • elbadawimustafa
    • asinclair
    • jedwards53
    • hwoodbury
    • jcapitao
    • jblaker
    • mdeltorob
    • bcmauleon
    • paco_oblea_bc
    • jsepulveda
    • dchavez
    • bzhang-bcov
    • biswaranjan
    • barroyo
    • jgouveia
    • bmartinez
    • tteixeira
    • bc-jcarlson
    • eledezma
    • jcueto
    • erodrigues
    • psousa
    • acruzr
    • sgopalakrishna
    • egoulding
    • marcogaray
    • ipadilla
    • jorduno
    • diegocruz1991
    • javibright
    • bcpsalas
    • etobin
    • ackbabe
    • cvillasenor
    • vchistyakov
    • omartinez
    • mgonzalez_bc
    • pdohertybcov
    • muthukumar.bc
    • dmkelly
    • bzizmond
    • jmpmacedo
    • scorreia
    • lescorcio
    • cavieira
    • mbalasubramaniam
    • arunjeyaprasad
    • bvilvanathan
    • anand.gangadharan
    • rahul.yadav
    • rociosantos
    • fdelgado_bc
    • syurishi
    • agarciabcov
    • priyadharsshini
    • attinder
    • quillad
    • vnavarro
    • lauralopez
    • granganathan
    • skumar85
    • hrodriguez2
    • nhaseena.mohamed
    • jasilvaantonio
    • palvarezbc
    • ericramos
    • carlosabajo
    • tomson.george
    • ingrid.s.cruz
    • hkanagarajan
    • jcarfagno-bc
    • luis_fernando_lopez_ruiz
    • vishal64
    • sarathy.a
    • geethu.karthik
    • esvarez
    • tresa.baji
    • chaselounge
    • yhernandez01
    • luis.garcia.brightcove
    • rodrigofdz
    • pgutierrezgil
    • harish17
    • jjeyaprakash
    • rrajendran1698
    • jlomeli
    • jhurtado
    • lgudino
    • sjimenez
    • rwenger_brightcove
    • rujordan
    • brivn
    • eperez-bc
    • stuartmh
    • jherrerabcov
    • mshiwal
    • jmartinezbrightcove
    • divyaudhayakumar
    • ptamizh
    • akamalakkannan
    • luiscruzbc
    • dflores
    • akatare
    • roman-bc
    • hugo.schoch.bc
    • alexbrightcove
    • chrislarocque
    • tnwanna
    • neethu.n
    • bsahlas.npm
    • dherrera1109
    • hswaminathan
    • lramirez-bc
    • hatondo-bcov
    • echengbc
    • sbarrettbc