script/tool/lib/src/common/plugin_utils.dart

// Copyright 2013 The Flutter Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

import 'package:yaml/yaml.dart';
import 'package:yaml_edit/yaml_edit.dart';

import 'core.dart';
import 'repository_package.dart';

/// Possible plugin support options for a platform.
enum PlatformSupport {
  /// The platform has an implementation in the package.
  inline,

  /// The platform has an endorsed federated implementation in another package.
  federated,
}

/// Returns true if [package] is a Flutter plugin.
bool isFlutterPlugin(RepositoryPackage package) {
  return _readPluginPubspecSection(package) != null;
}

/// Returns true if [package] is a Flutter [platform] plugin.
///
/// It checks this by looking for the following pattern in the pubspec:
///
///     flutter:
///       plugin:
///         platforms:
///           [platform]:
///
/// If [requiredMode] is provided, the plugin must have the given type of
/// implementation in order to return true.
bool pluginSupportsPlatform(
  String platform,
  RepositoryPackage plugin, {
  PlatformSupport? requiredMode,
}) {
  assert(
    platform == platformIOS ||
        platform == platformAndroid ||
        platform == platformWeb ||
        platform == platformMacOS ||
        platform == platformWindows ||
        platform == platformLinux,
  );

  final YamlMap? platformEntry = _readPlatformPubspecSectionForPlugin(platform, plugin);
  if (platformEntry == null) {
    return false;
  }

  // If the platform entry is present, then it supports the platform. Check
  // for required mode if specified.
  if (requiredMode != null) {
    final bool federated = platformEntry.containsKey('default_package');
    if (federated != (requiredMode == PlatformSupport.federated)) {
      return false;
    }
  }

  return true;
}

/// Returns true if [plugin] includes native code for [platform], as opposed to
/// being implemented entirely in Dart.
bool pluginHasNativeCodeForPlatform(String platform, RepositoryPackage plugin) {
  if (platform == platformWeb) {
    // Web plugins are always Dart-only.
    return false;
  }
  final YamlMap? platformEntry = _readPlatformPubspecSectionForPlugin(platform, plugin);
  if (platformEntry == null) {
    return false;
  }
  // All other platforms currently use pluginClass for indicating the native
  // code in the plugin.
  final pluginClass = platformEntry['pluginClass'] as String?;
  // TODO(stuartmorgan): Remove the check for 'none' once none of the plugins
  // in the repository use that workaround. See
  // https://github.com/flutter/flutter/issues/57497 for context.
  return pluginClass != null && pluginClass != 'none';
}

/// Adds or removes a package-level Swift Package Manager override to the given
/// package.
///
/// A null enabled state clears the package-local override, defaulting to whatever the
/// global state is.
void setSwiftPackageManagerState(RepositoryPackage package, {required bool? enabled}) {
  const swiftPMFlag = 'enable-swift-package-manager';
  const flutterKey = 'flutter';
  const flutterPath = <String>[flutterKey];
  const configPath = <String>[flutterKey, 'config'];

  final editablePubspec = YamlEditor(package.pubspecFile.readAsStringSync());
  final configMap = editablePubspec.parseAt(configPath, orElse: () => YamlMap()) as YamlMap;
  if (enabled == null) {
    if (!configMap.containsKey(swiftPMFlag)) {
      // Nothing to do.
      return;
    } else if (configMap.length == 1) {
      // The config section only exists for this override, so remove the whole
      // section.
      editablePubspec.remove(configPath);
      // The entire flutter: section may also only have been added for the
      // config, in which case it should be removed as well.
      final flutterMap = editablePubspec.parseAt(flutterPath, orElse: () => YamlMap()) as YamlMap;
      if (flutterMap.isEmpty) {
        editablePubspec.remove(flutterPath);
      }
    } else {
      // Remove the specific entry, leaving the rest of the config section.
      editablePubspec.remove(<String>[...configPath, swiftPMFlag]);
    }
  } else {
    // Ensure that the section exists.
    if (configMap.isEmpty) {
      final root = editablePubspec.parseAt(<String>[]) as YamlMap;
      if (!root.containsKey(flutterKey)) {
        editablePubspec.update(flutterPath, YamlMap());
      }
      editablePubspec.update(configPath, YamlMap());
    }
    // Then add the flag.
    editablePubspec.update(<String>[...configPath, swiftPMFlag], enabled);
  }

  package.pubspecFile.writeAsStringSync(editablePubspec.toString());
}

/// Returns the
///   flutter:
///     plugin:
///       platforms:
///         [platform]:
/// section from [plugin]'s pubspec.yaml, or null if either it is not present,
/// or the pubspec couldn't be read.
YamlMap? _readPlatformPubspecSectionForPlugin(String platform, RepositoryPackage plugin) {
  final YamlMap? pluginSection = _readPluginPubspecSection(plugin);
  if (pluginSection == null) {
    return null;
  }
  final platforms = pluginSection['platforms'] as YamlMap?;
  if (platforms == null) {
    return null;
  }
  return platforms[platform] as YamlMap?;
}

/// Returns the
///   flutter:
///     plugin:
///       platforms:
/// section from [plugin]'s pubspec.yaml, or null if either it is not present,
/// or the pubspec couldn't be read.
YamlMap? _readPluginPubspecSection(RepositoryPackage package) {
  final Pubspec pubspec = package.parsePubspec();
  final Map<String, dynamic>? flutterSection = pubspec.flutter;
  if (flutterSection == null) {
    return null;
  }
  return flutterSection['plugin'] as YamlMap?;
}