githubmr/facebook-react-native: A framework for building native applications using React

scripts/diff-api-snapshot/index.js

61 строка1 KB

Dawid Małecki

Add diff-api-snapshot for public API breaking change detection (#51972)

17 июн 2025, 12:27

17 июн 2025, 12:276b40f35

/**
 * Copyright (c) Meta Platforms, Inc. and affiliates.
 *
 * This source code is licensed under the MIT license found in the
 * LICENSE file in the root directory of this source tree.
 *
 * @flow
 * @format
 * @oncall react_native
 */

require('../babel-register').registerForScript();

const {diffApiSnapshot} = require('./diffApiSnapshot');
const fs = require('fs');
const {parseArgs} = require('util');

const config = {
  allowPositionals: true,
  options: {
    help: {type: 'boolean'},
  },
};

async function main() {
  const {
    positionals: [prevSnapshot, newSnapshot],
    values: {help},
    /* $FlowFixMe[incompatible-call] Natural Inference rollout. See
     * https://fburl.com/workplace/6291gfvu */
  } = parseArgs(config);

  if (help) {
    console.log(`
  Usage: node ./scripts/diff-api-snapshot <prev-snapshot> <new-snapshot>

  Analyze changes between two versions of React Native's JavaScript API
  snapshot (yarn build-types). Returns a JSON object with the following
  fields:
    - result: 'BREAKING', 'POTENTIALLY_NON_BREAKING' or 'NON_BREAKING'.
    - changedApis: List of changed APIs.
    `);
    process.exitCode = 0;
    return;
  }

  try {
    const result = diffApiSnapshot(
      fs.readFileSync(prevSnapshot, 'utf8'),
      fs.readFileSync(newSnapshot, 'utf8'),
    );
    console.log(JSON.stringify(result, null, 2));
  } catch (e) {
    console.error('Error parsing API snapshot:', e);
    process.exitCode = 1;
  }
}

if (require.main === module) {
  void main();
}