feat: Open source Celest CLI

.github/workflows/celest_cli.yaml

@@ -0,0 +1,60 @@
+name: celest_cli
+on:
+  pull_request:
+    paths:
+      - ".github/workflows/apps_cli.yaml"
+      - "apps/cli/**"
+      - "packages/**"
+      - "services/**"
+
+# Prevent duplicate runs due to Graphite
+# https://graphite.dev/docs/troubleshooting#why-are-my-actions-running-twice
+concurrency:
+  group: ${{ github.repository }}-${{ github.workflow }}-${{ github.ref }}-${{ github.ref == 'refs/heads/main' && github.sha || ''}}
+  cancel-in-progress: true
+
+env:
+  CELEST_LOCAL_PATH: ${{ github.workspace }}
+
+jobs:
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        os:
+          - ubuntu-latest
+          - macos-14
+          # TODO: Need to fix tests on Windows
+          # - windows-latest
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 15
+    steps:
+      - name: Git Checkout
+        uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # 4.1.7
+        with:
+          submodules: recursive
+      # Needed for flutter-version-file: https://github.com/subosito/flutter-action?tab=readme-ov-file#use-version-from-pubspecyaml
+      - name: Install yq
+        if: runner.os == 'Windows'
+        shell: bash
+        run: |
+          curl -sL "https://github.com/mikefarah/yq/releases/download/v4.43.1/yq_windows_amd64.exe" -o yq.exe
+          echo "$PWD" >> "$GITHUB_PATH"
+      - name: Setup Flutter
+        uses: subosito/flutter-action@44ac965b96f18d999802d4b807e3256d5a3f9fa1 # 2.16.0
+        with:
+          cache: true
+          # Locks version to repo constraint (for golden test alignment)
+          flutter-version-file: pubspec.yaml
+      - name: Setup Libsecret
+        if: runner.os == 'Linux'
+        run: tool/setup-ci.sh
+      - name: Get Packages
+        working-directory: apps/cli
+        run: dart pub upgrade
+      - name: Test
+        working-directory: apps/cli
+        run: dart test -x e2e --fail-fast -j 1
+      # - name: Test (Fixtures)
+      #   working-directory: apps/cli
+      #   run: dart test fixtures/legacy/fixtures_test.dart --fail-fast -j 1

apps/cli/.gitignore

@@ -0,0 +1,11 @@
+# https://dart.dev/guides/libraries/private-files
+# Created by `dart pub`
+.dart_tool/
+
+# Build dir
+build/
+
+tool/debug
+**/*.dill
+**/*.pkg
+vm_service_info.json

apps/cli/.vscode/launch.json

@@ -0,0 +1,23 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "CLI / E2E (--update-goldens)",
+      "request": "launch",
+      "type": "dart",
+      "program": "fixtures/legacy/fixtures_test.dart",
+      "env": {
+        "UPDATE_GOLDENS": "true",
+        "INCLUDE_TESTS": "flutter"
+      },
+      "args": ["--timeout=none"]
+    },
+    {
+      "name": "CLI (test/analyzer)",
+      "request": "launch",
+      "type": "dart",
+      "program": "test/analyzer/celest_analyzer_test.dart",
+      "args": ["--timeout=none"]
+    }
+  ]
+}

apps/cli/.vscode/settings.json

@@ -0,0 +1,8 @@
+{
+  // -- Dart --
+  "dart.analysisExcludedFolders": ["test/openapi/goldens"],
+
+  "files.associations": {
+    "*.drift": "sql"
+  }
+}

apps/cli/CHANGELOG.md

@@ -0,0 +1,3 @@
+## 0.1.0
+
+- Initial version.

apps/cli/Makefile

@@ -0,0 +1,12 @@
+.PHONY: database
+
+database:
+	@echo "Generating Dart Drift classes..."
+	@dart run build_runner build --delete-conflicting-outputs
+	@for DB in cache cloud project; do \
+		echo "Generating schema JSON for $${DB} database..."; \
+		mkdir -p lib/database/$${DB}/schema/; \
+		dart run drift_dev schema dump lib/database/$${DB}/$${DB}_database.dart lib/database/$${DB}/schema/; \
+		echo "Generating migration file for $${DB} database..."; \
+		dart run drift_dev schema steps lib/database/$${DB}/schema/ lib/database/$${DB}/$${DB}.migrations.dart; \
+	done

apps/cli/README.md

@@ -0,0 +1,3 @@
+## Celest CLI
+
+The command line interface for Celest.

apps/cli/analysis_options.yaml

@@ -0,0 +1,12 @@
+include: package:celest_lints/app.yaml
+
+analyzer:
+  exclude:
+    - "**/*.g.dart"
+  errors:
+    implementation_imports: ignore
+    avoid_print: ignore
+    avoid_catches_without_on_clauses: ignore
+    camel_case_types: ignore
+    require_trailing_commas: ignore # TODO: Conflicts with 3.7 formatting
+    unused_element: info

apps/cli/bin/celest.dart

@@ -0,0 +1,27 @@
+import 'package:celest_cli/commands/analysis_server_command.dart';
+import 'package:celest_cli/commands/build_command.dart';
+import 'package:celest_cli/commands/init_command.dart';
+import 'package:celest_cli/commands/precache_command.dart';
+import 'package:celest_cli/commands/start_command.dart';
+import 'package:celest_cli/commands/uninstall_command.dart';
+import 'package:celest_cli/commands/upgrade_command.dart';
+import 'package:celest_cli/src/cli.dart';
+import 'package:celest_cli/src/version.dart';
+
+void main(List<String> args) async {
+  final cli =
+      Cli(
+          'celest',
+          'A command-line interface for Celest, the Flutter cloud platform.',
+          version: packageVersion,
+        )
+        ..addCommand(InitCommand())
+        ..addCommand(StartCommand())
+        ..addCommand(BuildCommand())
+        ..addCommand(AnalysisServerCommand())
+        ..addCommand(UpgradeCommand())
+        ..addCommand(UninstallCommand())
+        ..addCommand(PrecacheCommand());
+
+  await cli.run(args);
+}

apps/cli/build.yaml

@@ -0,0 +1,37 @@
+targets:
+  json:
+    sources:
+      exclude:
+        - "fixtures/**"
+        - "lib/database/**"
+    auto_apply_builders: false
+    builders:
+      json_serializable:
+        enabled: true
+        options:
+          explicit_to_json: true
+
+  $default:
+    sources:
+      include:
+        - "lib/database/**"
+    dependencies:
+      - ":json"
+    builders:
+      drift_dev:
+        enabled: true
+        options:
+          named_parameters: true
+          store_date_time_values_as_text: false
+          sql:
+            dialect: sqlite
+            options:
+              version: "3.38"
+              modules:
+                - json1
+              known_functions:
+                typeid: text(text)
+
+          # Reduces generated code
+          skip_verification_code: true
+          data_class_to_companions: false

apps/cli/dart_test.yaml

@@ -0,0 +1,11 @@
+tags:
+  e2e:
+    timeout: 15m
+  e2e-installed:
+    timeout: 5m
+  e2e-local:
+    timeout: 15m
+  openapi:
+    timeout: 5m
+  goldens:
+    timeout: 20m

apps/cli/fixtures/.gitattributes

@@ -0,0 +1,10 @@
+# Outputs from golden tests
+**/goldens/**                               linguist-generated
+
+# Platform files generated by Flutter during `flutter create`
+**/android/**                       linguist-generated
+**/ios/**                           linguist-generated
+**/linux/**                         linguist-generated
+**/macos/**                         linguist-generated
+**/windows/**                       linguist-generated
+**/web/**                           linguist-generated

apps/cli/fixtures/legacy/_common/lib/_common.dart

@@ -0,0 +1,68 @@
+/// Common types and functions, used for testing APIs which reference other
+/// packages.
+library;
+
+final class CustomException implements Exception {
+  CustomException(this.message);
+
+  final String message;
+
+  @override
+  String toString() => 'CustomException: $message';
+}
+
+final class CommonException implements Exception {
+  CommonException(this.message);
+
+  final String message;
+
+  @override
+  String toString() => 'CommonException: $message';
+}
+
+void throwsCustomException() {
+  throw CustomException('message');
+}
+
+void throwsCommonException() {
+  throw CommonException('message');
+}
+
+final class NestedParent {
+  const NestedParent(this.child);
+
+  factory NestedParent.fromJson(String value) =>
+      NestedParent(NestedChild(value));
+
+  final NestedChild child;
+
+  String toJson() => child.value;
+}
+
+final class NestedChild {
+  const NestedChild(this.value);
+
+  factory NestedChild.fromJson(String value) => NestedChild(value);
+
+  final String value;
+
+  String toJson() => value;
+}
+
+final class OverriddenException implements Exception {
+  const OverriddenException(this.message);
+
+  factory OverriddenException.fromJson(String value) =>
+      OverriddenException(value);
+
+  final String message;
+
+  String toJson() => message;
+
+  @override
+  String toString() => 'OverriddenException: $message';
+}
+
+void throwsOverriddenException() {
+  throw const OverriddenException('message');
+}

apps/cli/fixtures/legacy/_common/lib/marcelo.dart

@@ -0,0 +1,8 @@
+export 'src/models/available_stock.dart';
+export 'src/models/available_stocks.dart';
+export 'src/models/buy_or_sell.dart';
+export 'src/models/cash_balance.dart';
+export 'src/models/errors_and_exceptions.dart';
+export 'src/models/portfolio.dart';
+export 'src/models/stock.dart';
+export 'src/models/ui.dart';

apps/cli/fixtures/legacy/_common/lib/src/models/available_stock.dart

@@ -0,0 +1,37 @@
+import 'package:_common/src/utils/utils.dart';
+import 'package:meta/meta.dart';
+
+@immutable
+class AvailableStock {
+  AvailableStock(
+    this.ticker, {
+    required this.name,
+    required double currentPrice,
+  }) : currentPrice = round(currentPrice);
+
+  AvailableStock.from(({String ticker, String name, double price}) stock)
+      : this(stock.ticker, name: stock.name, currentPrice: stock.price);
+  final String ticker;
+  final String name;
+  final double currentPrice;
+
+  String get currentPriceStr => 'US\$ ${currentPrice.toStringAsFixed(2)}';
+
+  AvailableStock withCurrentPrice(double price) =>
+      AvailableStock(ticker, name: name, currentPrice: round(price));
+
+  @override
+  String toString() => '$ticker ($name)';
+
+  @override
+  bool operator ==(Object other) =>
+      identical(this, other) ||
+      other is AvailableStock &&
+          runtimeType == other.runtimeType &&
+          ticker == other.ticker &&
+          name == other.name &&
+          currentPrice == other.currentPrice;
+
+  @override
+  int get hashCode => ticker.hashCode ^ name.hashCode ^ currentPrice.hashCode;
+}