yarn-outdated-notifier

    1.1.0 • Public • Published

    🚀 yarn-outdated-notifier

    npm CircleCI

    Add link to CHANGELOG the result of $ yarn outdated, and notify to GitHub Issue.

    Example Issue

    2018-03-01 Yarn Outdated Notifier

    Issue URL: https://github.com/tsuyoshiwada/yarn-outdated-notifier-with-circleci/issues/2

    Motivation

    Overview

    yarn-outdated-notifier will help you update the npm package on which you depend.

    1. Keeping fresh package

    yarn has a useful toolset for updating npm packages like yarn outdated and yarn upgrade-interactive. Utilize these tool sets to visualize packages that need updating and register them to GitHub Issue.

    2. Understand the changes

    The problem with updating the npm package is that unintended changes destroy the project. By checking CHANGELOG prepared by each package, it is possible to solve this problem to a certain extent.

    Therefore, yarn-outdated-notifier adds a link to CHANGELOG to the result of yarn outdated and notifies.


    Since CircleCI and TravisCI have the function of cron, you can use it to make periodic package update notifications 🎉

    Installation

    $ yarn add -D yarn-outdated-notifier

    Usage

    Please access the page of Personal access tokens and issue a token. You need the scope of repo.

    By passing the issued token to the --api-token option and executing the command, we will inform GitHub's Issue of the result of $ yarn outdated.

    $ yarn outdated-notifier --help
     
      Add link to CHANGELOG the result of `$ yarn outdated`, and notify to GitHub Issue.
     
      USAGE:
        $ outdated-notifier [options]
     
      OPTIONS:
        --api-token         API token for GitHub (required)
        --github-api-url    provide url for GitHub enterprise (default: "api.github.com")
        --owner,      -o    repository owner name (default: "git config --get remote.origin.url" infomation)
        --repository, -r    repository name (default: "git config --get remote.origin.url" infomation)
        --title,      -t    issue title for GitHub
        --labels,     -l    issue labels name for GitHub
        --assignees,  -a    issue assignees name for GitHub
        --excludes,   -e    path to yaml file which specify package names to exclude
        --changelogs, -c    path to yaml file which specify changelog uris for the packages
        --template          path to the template to use for notification
        --dry-run           do not register on issue, output contents to stdout
        --help,       -h    show help
        --version,    -v    print the version
     
      EXAMPLES:
        $ yarn outdated-notifier --api-token <your_personal_token>
        $ yarn outdated-notifier --api-token <your_personal_token> --labels "label_name" --assignees "assignee_name"
        $ yarn outdated-notifier --api-token <your_personal_token> --template "./template.hbs"
        $ yarn outdated-notifier --api-token <your_personal_token> --changelogs "./changelogs.yml"
        $ yarn outdated-notifier --api-token <your_personal_token> --changelogs "./changelogs.yml" --excludes "./excludes.yml"

    Prepare the CHANGELOG link

    Please create a YAML file with the package name and the link to CHANGELOG in the format shown below and specify it in the --changelogs option. (e.g. changelogs.yml)

    react: https://github.com/facebook/react/blob/master/CHANGELOG.md
    lodash: https://github.com/lodash/lodash/wiki/Changelog
    moment: https://github.com/moment/moment/blob/develop/CHANGELOG.md
    ...

    Thanks

    Contribute

    1. Fork it!
    2. Create your feature branch: git checkout -b my-new-feature
    3. Commit your changes: git commit -am 'Add some feature'
    4. Push to the branch: git push origin my-new-feature
    5. Submit a pull request 💌

    Bugs, feature requests and comments are more than welcome in the issues.

    License

    MIT © Cyberagent, Inc

    Install

    npm i yarn-outdated-notifier

    DownloadsWeekly Downloads

    150

    Version

    1.1.0

    License

    MIT

    Unpacked Size

    758 kB

    Total Files

    17

    Last publish

    Collaborators

    • avatar