main function

Implementation

Future<void> main() async {
  // The `main` entry point into any dart app.
  //
  // This is required to be [async] since we use [await] below to initalise the window manager.

  WidgetsFlutterBinding.ensureInitialized();

  bool isRInstalled = await checkRInstallation();

  // If R is not installed, show an error and exit the app.

  if (!isRInstalled) {
    runApp(
      MaterialApp(
        home: Builder(
          builder: (context) {
            Future.delayed(
              Duration.zero,
              () => showError(
                content: '''

                R is **not installed** or it was not found in the **PATH** environment variable.

                Please install R and ensure it is in the PATH before using Rattle.

                See the

                [survival guide](https://survivor.togaware.com/datascience/installing-rattle.html)

                for details.

                ''',
                context: context,
                title: 'R Installation Error',
                onOkPressed: () {
                  exit(0);
                },
              ),
            );

            return Scaffold();
          },
        ),
      ),
    );

    return;
  }

  // In production do not display [debugPrint] messages.

  if (isProduction) {
    debugPrint = (String? message, {int? wrapWidth}) {
      null;
    };
  }

  // TODO: check for updates
  // debugPrint('Current directory: ${p.current}');
  // // retrieve the latest bump version from git commit history
  // if (await GitDir.isGitDir(p.current)) {
  //   final gitDir = await GitDir.fromExisting(p.current);
  //   final commitCount = await gitDir.commitCount();
  //   final commitHistory = await gitDir.commits();

  //   for (var commit in commitHistory.values) {
  //     if (commit.message.toLowerCase().contains('bump version')) {
  //       debugPrint(commit.message);
  //       break;
  //     }
  //   }

  //   debugPrint('Git commit count: $commitCount');
  // } else {
  //   debugPrint('Not a Git directory');
  // }

  // Tune the window manager before runApp() to avoid a lag in the UI.
  //
  // For desktop (non-web) versions re-size to a comfortable initial window.

  if (isDesktop) {
    WidgetsFlutterBinding.ensureInitialized();

    await windowManager.ensureInitialized();

    WindowOptions windowOptions = const WindowOptions(
      // Setting [alwaysOnTop] here will ensure the desktop app starts on top of
      // other apps on the desktop so that it is visible.
      //
      // We later turn it off as we don't want to force it always on top.

      alwaysOnTop: true,

      // We can override the size in the first instance by, for example in
      // Linux, editing linux/my_application.cc.
      //
      // Setting it here has effect when Restarting the app while debugging.

      // However, since Windows has 1280x720 by default in the windows-specific
      // windows/runner/main.cpp, line 29, it is best not to override it here
      // since under Windows 950x600 is too small.

      // size: Size(950, 600),

      // The [title] is used for the window manager's window title.

      title: 'RattleNG - Data Science with R',
    );

    // The window should be on top now, so show the window, give it focus, and
    // then turn always on top off.

    windowManager.waitUntilReadyToShow(windowOptions, () async {
      await windowManager.show();
      await windowManager.focus();
      await windowManager.setAlwaysOnTop(false);
    });
  }

  // Initialise a global temporary directory where generated files, such as
  // charts, are saved and can be removed on exit from rattleng or on loading a
  // new dataset.
  //
  // Notice on Windows the path is of the form `C:\AppDir\Users\...` which is
  // not acceptable by R (which requires `\\`) so map them to `/` which is
  // accepted by R on Windows.

  final rattleDir = await Directory.systemTemp.createTemp('rattle');
  tempDir = rattleDir.path.replaceAll(r'\', '/');

  // Set up the app's color scheme.
  Flavor flavor = catppuccin.latte;

  // The runApp() function takes the given Widget and makes it the root of the
  // widget tree.
  //
  // Here we wrap the app within RiverPod's ProviderScope() to support state
  // management.
  //
  // We also set up the app's theme through it being a [MaterialApp] and return
  // the [MaterialApp] widget that serves as the root of the app.

  runApp(
    ProviderScope(
      // 20240923 gjw [MaterialApp] was moved here from app.dart on implementing
      // the close dialog, since it needs a MaterialLocalizations to be in the
      // parentage which MaterialApp ensures, and it makes sense for it to be
      // the root.

      child: MaterialApp(
        theme: ThemeData(
          // Material 3 is the current (2024) flutter default theme for colours
          // and Google fonts. We can stay with this as the default for now
          // while we experiment with options.
          //
          // We could turn the new material theme off to get the older look.
          //
          // useMaterial3: false,

          colorScheme: ColorScheme.fromSeed(
            seedColor: flavor.mantle,
          ),

          // primarySwatch: createMaterialColor(Colors.black),

          // The default font size seems rather small. So increase it here.
          // textTheme: Theme.of(context).textTheme.apply(
          //       fontSizeFactor: 1.1,
          //       fontSizeDelta: 2.0,
          //     ),
        ),
        home: const RattleApp(),
      ),
    ),
  );
}