dashboard/lib/logic/links.dart

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

import 'package:flutter/material.dart';
import 'package:url_launcher/url_launcher.dart';

import '../views/build_dashboard_page.dart';
import '../views/presubmit_view.dart';
import '../views/tree_status_page.dart';

/// List of links that are shown in the [DashboardNavigationDrawer].
List<CocoonLink> createCocoonLinks(BuildContext context) {
  return <CocoonLink>[
    CocoonLink(
      name: 'Build',
      route: BuildDashboardPage.routeName,
      icon: const Icon(Icons.build),
      action: () async {
        await Navigator.pushReplacementNamed(
          context,
          BuildDashboardPage.routeName,
        );
      },
    ),
    CocoonLink(
      name: 'PreSubmit',
      route: PreSubmitView.routeName,
      icon: const Icon(Icons.playlist_add_check),
      action: () async {
        await Navigator.pushReplacementNamed(context, PreSubmitView.routeName);
      },
    ),
    CocoonLink(
      name: 'Manual Tree Status',
      route: BuildDashboardPage.routeName,
      icon: const Icon(Icons.admin_panel_settings),
      action: () async {
        await Navigator.pushReplacementNamed(context, TreeStatusPage.routeName);
      },
    ),
    CocoonLink(
      name: 'Framework Benchmarks',
      icon: const Icon(Icons.show_chart),
      action: () async {
        await launchUrl(Uri.parse('https://flutter-flutter-perf.skia.org/'));
      },
    ),
    CocoonLink(
      name: 'Engine Benchmarks',
      icon: const Icon(Icons.show_chart),
      action: () async {
        await launchUrl(Uri.parse('https://flutter-engine-perf.skia.org/'));
      },
    ),
    CocoonLink(
      name: 'Source Code',
      icon: const Icon(Icons.code),
      action: () async {
        await launchUrl(Uri.parse('https://github.com/flutter/cocoon'));
      },
    ),
  ];
}

/// Data class for storing links on the Cocoon app.
class CocoonLink {
  const CocoonLink({this.name, this.route, this.action, this.icon});

  /// Text shown to users describing this link.
  final String? name;

  /// If the link is internal to this Flutter app, this can be passed to highlight on the [DashboardNavigationDrawer] the page the user is on.
  final String? route;

  /// An [Icon] to represent this link.
  final Icon? icon;

  /// Callback for when the link is activated.
  ///
  /// Can be used to redirect to internal or external routes. Will have acess to the [BuildContext].
  final void Function()? action;
}