Socket
Socket
Sign inDemoInstall

@rnx-kit/rn-changelog-generator

Package Overview
Dependencies
0
Maintainers
8
Versions
9
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

@rnx-kit/rn-changelog-generator


Version published
Weekly downloads
6.3K
increased by92.02%
Maintainers
8
Install size
273 kB
Created
Weekly downloads
 

Readme

Source

@rnx-kit/rn-changelog-generator

Build npm version

🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧

This tool is EXPERIMENTAL - USE WITH CAUTION

🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧

This script used to live in react-native-community/releases, and has moved here as part of deprecating that repo.

Motivation

This script generates a markdown-formatted list of changes between two given git references (e.g. tags).

The script is a little more complex than one might expect for the following reasons:

  • Attributing changes to the author’s github handle requires fetching the commit metadata from the github API, rather than relying on a local clone of the react-native repo.

  • Due to how react-native’s release process works, we want to be able to exclude previously cherry-picked commits from the changelog entry of the next version.

    However, with git, cherry-picked commits will have different commit hashes than their original counterparts – as they exist in the main branch. Because of this, the next version’s stable branch will include the same changes, except using their original commit hash. This makes it impossible to exclude these commits without further work.

    For this reason, the script will parse the ‘referential revision’ – which is added to each commit message by Facebook’s infrastructure – and use it to resolve to the original commit in the main branch. This resolved commit’s hash is then used in the changelog entry, so the script can find and exclude it from the next version’s entry.

    This cannot be done via the github API and thus relies on a local clone of the react-native repo.

You can read more of the old documentation about it here.

Setup

If you don’t already have a checkout of the react-native repo in a nearby folder:

git clone https://github.com/facebook/react-native.git

Ensure the repo is up-to-date:

pushd react-native
git checkout main
git pull
popd

Usage

Generate a changelog for react-native commits between versions 0.65.0 and 0.66.0:

npx @rnx-kit/rn-changelog-generator --base v0.65.0 --compare v0.66.0 --repo ../../../react-native --changelog ../../../react-native/CHANGELOG.md

As explained above, you will need to have a local clone of react-native, which is referenced by the --repo parameter.

[Optional] Get a Github 'personal acccess token'

This script uses the Github API to fetch commit metadata. This data is accessable without authentication as its public.

You can optionally provide a GitHub personal access token for the --token parameter which may be necessary in case Github API rate-limits your requests.

Instructions to create a GitHub ‘personal access token’:

  1. Visit the token settings page.
  2. Generate a new token and only give it the public_repo scope.
  3. Store this token somewhere secure for future usage.

FAQs

Last updated on 14 Apr 2023

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc