Nachos Preventing Motivation

    @postman/yankee

    1.1.0 • Public • Published

    yankee

    Easy release management with YAML changelogs

    Installation

    # As a global command:
    npm install --global @postman/yankee
    
    # …or locally for an npm project:
    npm install --save-dev @postman/yankee

    Usage

    yankee [<path>]
    yankee --help

    Description

    The file Changelog.yaml is the single source of information about your releases. It should be an object with one key per release and an optional unreleased: key at the top. Here’s an example:

    unreleased:
      new features:
        - The cool new flag `--verbose`.
    
    2.0.1:
      date: 1992-02-09
      fixed bugs:
        - Got rid of a nasty IO bug.
        - Improved the docs.
    
    2.0.0:
      date: 1982-03-15
      breaking changes:
        - API redesign. See the readme for details.
    
    1.0.0:
      date: 1970-01-01
      note: Initial release.

    When you call yankee, we’ll determine what version number comes next and update the file accordingly. We’ll replace unreleased: with the new version and add a date: property with the current day right below that.

    If the unreleased: object contains the key breaking changes:, we’ll make it a major release (X.y.z). If it contains the key new features:, we’ll make a minor bump (x.Y.z). Otherwise, make sure your unreleased: changelog has the key fixed bugs: - we’ll release it as a patch (x.y.Z).

    The version number against which we’ll be bumping is the first key in your Changelog.yaml except unreleased:. If there’s no other key, we’ll always tag the release as 1.0.0.

    If you call yankee without any options, we’ll only output the version number, so that it’s easy for you to process with scripts.

    Options

    [path]

    The path to your project directory. Should contain a Changelog.yaml. Default: $(pwd).

    -n, --npm

    Attempt to update the version field in package.json and npm-shrinkwrap.json.

    -c, --commit

    Commit changes. The commit message will be the raw version number.

    -t, --tag

    Tag the commit with an annotated tag. The tag name will be the raw version number preceeded with a “v”. Implies --commit.

    -h, --help

    You’re looking at it.

    Example

    Here a simple example using cat and here docs. When creating your package, you start off with a simple changelog:

    $ cat << --- > Changelog.yaml
      unreleased:
        note: Initial release.
      ---

    When you’re ready for a 1.0.0 release, just call yankee:

    $ yankee
      1.0.0
    
    $ cat Changelog.yaml
      1.0.0:
        date: 2016-05-20
        note: Initial release.

    Working on new stuff, update the changelog accordingly:

    $ cat << --- > Changelog.yaml
      unreleased:
        new features:
          - Cool new stuff!
    
      $(cat Changelog.yaml)
      ---

    When ready for a release, yankee will figure out what the release number should be:

    $ yankee
      1.1.0
    
    $ cat Changelog.yaml
      1.1.0:
        date: 2016-05-20
        new features:
          - Cool new stuff!
    
      1.0.0:
        date: 2016-05-20
        note: Initial release.

    Install

    npm i @postman/yankee

    DownloadsWeekly Downloads

    103

    Version

    1.1.0

    License

    MIT

    Unpacked Size

    12.8 kB

    Total Files

    6

    Last publish

    Collaborators

    • ruben.baraut
    • arsh_13
    • tapanchudasama
    • akash.rajpurohit_postman
    • gshigeto-postman
    • harsh.postman
    • gandharva2603
    • rtlockwood
    • harshit.kochar
    • auddypostman
    • patricksevat
    • sihanmin
    • akinard-pm
    • ayush.jain
    • anant-garg-2605
    • laszlogreczi
    • saurav-postman
    • bhoomikaduapostman
    • robertgzr
    • roy-himanshu
    • nidhi_goyal
    • manng
    • parthverma
    • alexander-rubia
    • arjun.golabhanvi
    • malvika2706
    • anil.jnanoji
    • gbadebo.bello
    • idemchenko2022
    • coltonanglin
    • ravi.prasad
    • jatin-postman
    • bharadwajpoduri7
    • src__459
    • sahil.choudhary
    • nikhil-motiani-postman
    • json_schema
    • liteshpatil17
    • tilak-patel-postman
    • cory.cooper.postman
    • hasnain.rajan
    • elizabeth.fung
    • manavbharambe
    • preetham.m
    • dhuhindhan.ilango
    • nishat.sayyed
    • rubencasas
    • liam_mode_postman
    • sterling.chin-postman
    • anubhav-vats
    • adityabaradwaj
    • timhall
    • asutosh.sahoo
    • chris_pm
    • prasant.patel
    • bot_marketing_engineering
    • shreyansh_post
    • vaishnavichalla
    • aditi_u
    • lorenzo.ambrosi
    • arnaudlauret_postman
    • christina.hastenrathplus1
    • postman-dakshraj.sharma
    • ekansh-01
    • ashutosh.vyas
    • devsharma
    • l0hit
    • ayushman9454
    • tonygo
    • ishan_singhal_
    • postmanian
    • davidtran33
    • rutvik_gs
    • dsanders11
    • ajeetpostman
    • pranshu-sharma
    • akkeshavan
    • rishabh.shukla
    • shub_postman
    • samay_v
    • kapilsinghsisodiya
    • riyasaini
    • anshu.rai
    • yash-postman
    • karnsharma
    • ajmalshah
    • anika_sharma
    • priyambadamadala
    • kmmanoj-pm
    • harini.ramprasad
    • nishant.arora
    • gaurav.rakheja
    • ishan.krishna
    • pallab82
    • suhas_gaikwad
    • umeshp7
    • darshan.sen
    • dhinesh.sridhar
    • yatin1997
    • kartikj
    • saswatds
    • sujayvenaik
    • kratigya
    • shubham.ranjan
    • postshubham
    • davidespi
    • numaanashraf
    • shamasis
    • godfrzero
    • abhijitkane
    • ankitjaggi
    • kunagpal
    • prashantagrawal
    • hg07
    • kamalaknn
    • joycifer
    • pratikmandrekar
    • nikithaachhini
    • shreyas.panduranga
    • ringo.tsang
    • pratiksolim
    • aman.dhembla
    • defcon007
    • sivcansingh
    • bhargavkaranam96
    • shubhamatpostman
    • raima.zachariah
    • anshuljain3141
    • ronak.npm
    • shivangibajpai
    • vinitshahdeo
    • codenirvana
    • ankurdengla
    • tristandenyer
    • kduffey
    • shivam_postman
    • sabih.siddiqui
    • shashwat.dixit
    • kriss1897
    • gunjan4542
    • meetdeveloper
    • pawanbana
    • shreyshah
    • vshingala
    • barshan23
    • coditva
    • skrpl
    • jibinmathews7
    • diuda
    • yashishdua
    • postbot-bitbucket
    • postbot-buildkite
    • dannydainton
    • brandonmcastillo
    • michaelclaus
    • devansh21
    • arshad.ayub
    • sharma.nikhil1997
    • twitharshil
    • smitshah173
    • prashansak
    • atishay-postman
    • saket_ranjan
    • dhawan29
    • abhiramh
    • saurabh.jayant
    • arlemi.postman
    • akshaytate01
    • pankajk0791
    • mdamankh
    • apoorvajain08
    • james-postman
    • arvind-kalra
    • shrek_7
    • deepank08
    • balpreet.singh
    • diptarag
    • dip_postman
    • akshay24
    • ekta.agrawal
    • shashankmanjunath
    • chetan.waingankar
    • axelonet
    • balakrishna.avulapati
    • tanmay-postman
    • harsha.dixit
    • saialekhya.yerragunta
    • pranav.singhal
    • amrindersandhu
    • prabhat3697
    • ameyt
    • sudarshan29
    • deepanshurana
    • karishag
    • mudit1804
    • anirudh.ms
    • prashant-raghu
    • waseem.siddiqui
    • sumeet.sarkar
    • hemendra.kumar
    • abhinaba-ghosh
    • mayuukhvarshney
    • bswisher
    • himanshu0809
    • avinashchoudhary
    • gouthamaj
    • shivani.maheshwari
    • shubham.joshi
    • ankitsaini
    • akshay-deo
    • dev-pawankumar
    • saeedgatson
    • tim.beauchamp
    • iamnishantgarg
    • bpedro
    • amrit_vyas
    • arghya.saha
    • joana.carvalho.postman
    • dev-kanishk
    • melahi
    • maaizelahi
    • ayush.raj
    • aakash.mallik
    • himanshu.s
    • harshit0410
    • shubham828
    • brent.cromarty
    • apoorvgarg17
    • sandeep.singh
    • raghav.garg.postman
    • raghumurthy
    • abhijeetborole
    • mehul.agrawal
    • hayk-sardaryan
    • bhargavkn
    • avanishpai
    • aayushv-98
    • sonymathew
    • pravinkk
    • hardik286
    • manang1203
    • vashanth
    • rishab_jain
    • appurvamurawat
    • poojat
    • abhravi
    • phani-postman
    • bikas.katwal
    • akira28
    • kshenderov
    • jviotti
    • chinmayj195
    • tirth_055
    • harsh_bansal
    • srinivas.kini
    • jony.cheung.postman
    • sakshitodwal
    • harshitbudhraja
    • yash.aggarwal
    • rrc083
    • suyashghuge
    • diya.ninan
    • mayank.chandra
    • pbdivyesh
    • shruti_paranjape
    • utsav.kapoor1994
    • akshatuppal
    • ravishankar_gp
    • vedkribhu
    • abhishek_s
    • subhash.yadav
    • pankajkumar05
    • shreyaskm
    • kamarajp
    • prithvi.tharun
    • ashish.gupta1
    • joshuawise_postman
    • bot.npm.cf.starship
    • divy.khare
    • meenakshi.dhanani
    • aditya.gurjar
    • dhwaneetbhatt
    • anukritigupta
    • virtualcharms
    • pm-chienleow
    • chinmay_cdj