Add sidekick cli

Author: MatthaiosSait

am

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+set -e
+
+# Attempt to set ENTRYPOINT_HOME
+# Resolve links: $0 may be a link
+PRG="$0"
+# Need this for relative symlinks.
+while [ -h "$PRG" ]; do
+  ls=$(ls -ld "$PRG")
+  link=$(expr "$ls" : '.*-> \(.*\)$')
+  if expr "$link" : '/.*' >/dev/null; then
+    PRG="$link"
+  else
+    PRG=$(dirname "$PRG")"/$link"
+  fi
+done
+SAVED="$(pwd)"
+cd "$(dirname "$PRG")/" >/dev/null
+export SIDEKICK_ENTRYPOINT_FILE="${PRG}"
+export SIDEKICK_ENTRYPOINT_HOME="$(pwd -P)"
+cd "$SAVED" >/dev/null
+
+"${SIDEKICK_ENTRYPOINT_HOME}/am_sidekick/tool/run.sh" "$@"

am_sidekick/.gitignore

@@ -0,0 +1,9 @@
+# Files and directories created by pub
+.dart_tool/
+.packages
+
+# Conventional directory for build outputs
+build/
+
+# Directory created by dartdoc
+doc/api/

am_sidekick/analysis_options.yaml

@@ -0,0 +1,11 @@
+# TODO: Add back as soon as sidekick supports dart 3.0.0
+# include: package:lint/analysis_options.yaml
+
+linter:
+  rules:
+    avoid_print: false
+
+analyzer:
+  exclude:
+    - build/**
+

am_sidekick/bin/main.dart

@@ -0,0 +1,5 @@
+import 'package:am_sidekick/am_sidekick.dart';
+
+Future<void> main(List<String> arguments) async {
+  await runAm(arguments);
+}

am_sidekick/lib/am_sidekick.dart

@@ -0,0 +1,43 @@
+import 'dart:async';
+
+import 'package:am_sidekick/src/arcgis_flutter_project.dart';
+import 'package:am_sidekick/src/commands/clean_command.dart';
+import 'package:am_sidekick/src/commands/generate_arcgis_webpack.dart';
+import 'package:am_sidekick/src/commands/release/bump_version_command.dart';
+import 'package:am_sidekick/src/commands/release/edit_dependency_overrides_command.dart';
+import 'package:am_sidekick/src/commands/release/publish_command.dart';
+import 'package:am_sidekick/src/commands/release/release_command.dart';
+import 'package:am_sidekick/src/commands/test_command.dart';
+import 'package:sidekick_core/sidekick_core.dart';
+
+ArcgisFlutterProject afProject =
+    ArcgisFlutterProject(SidekickContext.projectRoot);
+
+Future<void> runAm(List<String> args) async {
+  final runner = initializeSidekick(
+    mainProjectPath: 'arcgis_map',
+    flutterSdkPath: systemFlutterSdkPath(),
+  );
+
+  runner
+    ..addCommand(FlutterCommand())
+    ..addCommand(DartCommand())
+    ..addCommand(DepsCommand())
+    ..addCommand(CleanCommand())
+    ..addCommand(DartAnalyzeCommand())
+    ..addCommand(FormatCommand())
+    ..addCommand(BumpVersionCommand())
+    ..addCommand(SidekickCommand())
+    ..addCommand(EditDependencyOverridesCommand())
+    ..addCommand(PublishCommand())
+    ..addCommand(ReleaseCommand())
+    ..addCommand(TestCommand())
+    ..addCommand(GenerateArcgisWebpack());
+
+  try {
+    return await runner.run(args);
+  } on UsageException catch (e) {
+    print(e);
+    exit(64); // usage error
+  }
+}

am_sidekick/lib/src/arcgis_flutter_project.dart

@@ -0,0 +1,36 @@
+import 'package:sidekick_core/sidekick_core.dart';
+
+class ArcgisFlutterProject {
+  ArcgisFlutterProject(this.root);
+
+  final Directory root;
+
+  DartPackage get arcgisMap =>
+      DartPackage.fromDirectory(root.directory('arcgis_map'))!;
+
+  DartPackage get arcgisMapExample =>
+      DartPackage.fromDirectory(root.directory('arcgis_map/example'))!;
+
+  DartPackage get arcgisMapPlatformInterface => DartPackage.fromDirectory(
+        root.directory('arcgis_map_platform_interface'),
+      )!;
+
+  DartPackage get arcgisMapWeb =>
+      DartPackage.fromDirectory(root.directory('arcgis_map_web'))!;
+
+  DartPackage get afSidekickPackage =>
+      DartPackage.fromDirectory(root.directory('af_sidekick'))!;
+
+  File get flutterw => root.file('flutterw');
+
+  List<DartPackage>? _packages;
+  List<DartPackage> get allPackages {
+    return _packages ??= root
+        .directory('')
+        .listSync()
+        .whereType<Directory>()
+        .mapNotNull((it) => DartPackage.fromDirectory(it))
+        .toList()
+      ..add(arcgisMapExample);
+  }
+}

am_sidekick/lib/src/commands/clean_command.dart

@@ -0,0 +1,16 @@
+import 'package:sidekick_core/sidekick_core.dart';
+
+class CleanCommand extends Command {
+  @override
+  final String description = 'Cleans the project';
+
+  @override
+  final String name = 'clean';
+
+  @override
+  Future<void> run() async {
+    flutter(['clean'], workingDirectory: mainProject?.root);
+
+    print('✔️Cleaned project');
+  }
+}

am_sidekick/lib/src/commands/cli/cli_flags.dart

@@ -0,0 +1,76 @@
+import 'package:sidekick_core/sidekick_core.dart';
+
+/// Create main class for CliFlag and CliOption
+abstract class CliBabo {
+  final String name;
+  final String help;
+
+  CliBabo({
+    required this.name,
+    required this.help,
+  });
+
+  void registerWith(ArgParser parser);
+
+  /// Returns the value of the flag
+  T getFrom<T>(ArgResults? results);
+}
+
+/// Create CliFlag
+class CliFlag extends CliBabo {
+  final bool negatable;
+
+  CliFlag({
+    required super.name,
+    required super.help,
+    this.negatable = false,
+  });
+
+  @override
+  void registerWith(ArgParser parser) {
+    parser.addFlag(
+      name,
+      help: help,
+      negatable: negatable,
+    );
+  }
+
+  /// Returns as command line arg
+  String asCommandlineArg(ArgResults? results) {
+    final bool flag = results?[name] as bool? ?? false;
+    return flag ? '--$name' : '';
+  }
+
+  @override
+  bool getFrom<bool>(ArgResults? results) {
+    return results?[name] as bool? ?? false as bool;
+  }
+}
+
+/// Create CliOption
+class CliOption extends CliBabo {
+  CliOption({
+    required super.name,
+    required super.help,
+  });
+
+  @override
+  void registerWith(ArgParser parser) {
+    parser.addOption(
+      name,
+      help: help,
+    );
+  }
+
+  /// Returns as command line arg
+  String asCommandlineArg(ArgResults? results) {
+    final String flagResult = (results?[name] as String?) ?? '';
+    final bool flag = (results?[name] as String?)?.isNotEmpty ?? false;
+    return flag ? '--$name=$flagResult' : '';
+  }
+
+  @override
+  String getFrom<String>(ArgResults? results) {
+    return (results?[name] as String?) ?? '' as String;
+  }
+}

am_sidekick/lib/src/commands/generate_arcgis_webpack.dart

@@ -0,0 +1,49 @@
+import 'package:am_sidekick/am_sidekick.dart';
+import 'package:dcli/dcli.dart' as dcli;
+import 'package:sidekick_core/sidekick_core.dart';
+
+/// Command to generate the ArcGIS Webpack files
+class GenerateArcgisWebpack extends Command {
+  @override
+  String get description => 'Generates the ArcGIS Webpack files';
+
+  @override
+  String get name => 'gen:arcgis-webpack';
+
+  @override
+  Future<void> run() async {
+    final root = afProject.root;
+    final arcgisWebpackPath = root.directory('arcgis_webpack').path;
+    final arcgisMapWebPath = root.directory('arcgis_map_web').path;
+    print('Root path: $arcgisWebpackPath');
+
+    /// Check if NPM is installed
+    if (which('npm').notfound)
+      throw 'NPM is not installed. Please install NPM to continue.';
+    print(green('Generate ArcGIS Webpack'));
+    print('');
+    print(orange('Run npm install ...'));
+    dcli.run('npm i', workingDirectory: arcgisWebpackPath);
+    print('');
+    print(orange('Run npm build ...'));
+    dcli.run('npm run build', workingDirectory: arcgisWebpackPath);
+
+    print(green('Generating ArcGIS Webpack files Done!'));
+    print('');
+
+    print(green('Check assets folder for new files'));
+    print('');
+
+    print(orange('Install assets_generator ...'));
+    dcli.run('dart pub global activate assets_generator',
+        workingDirectory: arcgisMapWebPath);
+
+    print(orange('Generate assets ...'));
+    dcli.run('$HOME/.pub-cache/bin/agen -t d -s -r lwu --no-watch',
+        workingDirectory: arcgisMapWebPath);
+
+    print('');
+    print(green('Checking asset files Done!'));
+    print('');
+  }
+}