separate the project to modules

Author: daniilbug

flutter_clock_helper/.metadata

@@ -0,0 +1,10 @@
+# This file tracks properties of this Flutter project.
+# Used by Flutter tool to assess capabilities and perform upgrades etc.
+#
+# This file should be version controlled and should not be manually edited.
+
+version:
+  revision: 9bd02a1787bd264fde13a445a900ca28d08e3cef
+  channel: master
+
+project_type: package

flutter_clock_helper/CHANGELOG.md

@@ -0,0 +1,3 @@
+## [0.0.1] - TODO: Add release date.
+
+* TODO: Describe initial release.

flutter_clock_helper/README.md

@@ -0,0 +1,33 @@
+# Flutter Clock Helper
+
+This package provides scaffolding code for the clock in the Flutter Clock contest.
+
+Contestants: Do not edit this code.
+
+
+## Model
+Provides data that can change in the clock. Look in model.dart for more details.
+
+ * Time format (12- or 24-hour)
+ * Location
+ * Temperature
+ * Temperature high
+ * Temperature low
+ * Temperature unit
+ * Weather unit
+
+
+## Clock Customizer
+Provides customizations for your clock (based on the model).
+You can change the behavior of your clock based on these customizations.
+
+<img src='customizer.png' width='350'>
+
+To use inside your app's `main.dart`:
+
+```
+  runApp(ClockCustomizer((ClockModel model) => AnalogClock(model)));
+```
+
+For more information, see the code inside [lib/](lib).
+For a full example, see the [Analog Clock](../analog_clock) or [Digital Clock](../digital_clock) in this GitHub repo.

flutter_clock_helper/customizer.png

@@ -0,0 +1,226 @@
+// Copyright 2019 The Chromium 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 'model.dart';
+
+/// Returns a clock [Widget] with [ClockModel].
+///
+/// Example:
+///   final myClockBuilder = (ClockModel model) => AnalogClock(model);
+///
+/// Contestants: Do not edit this.
+typedef Widget ClockBuilder(ClockModel model);
+
+/// Wrapper for clock widget to allow for customizations.
+///
+/// Puts the clock in landscape orientation with an aspect ratio of 5:3.
+/// Provides a drawer where users can customize the data that is sent to the
+/// clock. To show/hide the drawer, double-tap the clock.
+///
+/// To use the [ClockCustomizer], pass your clock into it, using a ClockBuilder.
+///
+/// ```
+///   final myClockBuilder = (ClockModel model) => AnalogClock(model);
+///   return ClockCustomizer(myClockBuilder);
+/// ```
+/// Contestants: Do not edit this.
+class ClockCustomizer extends StatefulWidget {
+  const ClockCustomizer(this._clock);
+
+  /// The clock widget with [ClockModel], to update and display.
+  final ClockBuilder _clock;
+
+  @override
+  _ClockCustomizerState createState() => _ClockCustomizerState();
+}
+
+class _ClockCustomizerState extends State<ClockCustomizer> {
+  final _model = ClockModel();
+  ThemeMode _themeMode = ThemeMode.light;
+  bool _configButtonShown = false;
+
+  @override
+  void initState() {
+    super.initState();
+    _model.addListener(_handleModelChange);
+  }
+
+  @override
+  void dispose() {
+    _model.removeListener(_handleModelChange);
+    _model.dispose();
+    super.dispose();
+  }
+
+  void _handleModelChange() => setState(() {});
+
+  Widget _enumMenu<T>(
+      String label, T value, List<T> items, ValueChanged<T> onChanged) {
+    return InputDecorator(
+      decoration: InputDecoration(
+        labelText: label,
+      ),
+      child: DropdownButtonHideUnderline(
+        child: DropdownButton<T>(
+          value: value,
+          isDense: true,
+          onChanged: onChanged,
+          items: items.map((T item) {
+            return DropdownMenuItem<T>(
+              value: item,
+              child: Text(enumToString(item)),
+            );
+          }).toList(),
+        ),
+      ),
+    );
+  }
+
+  Widget _switch(String label, bool value, ValueChanged<bool> onChanged) {
+    return Row(
+      children: <Widget>[
+        Expanded(child: Text(label)),
+        Switch(
+          value: value,
+          onChanged: onChanged,
+        ),
+      ],
+    );
+  }
+
+  Widget _textField(
+      String currentValue, String label, ValueChanged<Null> onChanged) {
+    return TextField(
+      decoration: InputDecoration(
+        hintText: currentValue,
+        helperText: label,
+      ),
+      onChanged: onChanged,
+    );
+  }
+
+  Widget _configDrawer(BuildContext context) {
+    return SafeArea(
+      child: Drawer(
+        child: Padding(
+          padding: const EdgeInsets.all(16.0),
+          child: SingleChildScrollView(
+            child: Column(
+              children: <Widget>[
+                _textField(_model.location, 'Location', (String location) {
+                  setState(() {
+                    _model.location = location;
+                  });
+                }),
+                _textField(_model.temperature.toString(), 'Temperature',
+                    (String temperature) {
+                  setState(() {
+                    _model.temperature = double.parse(temperature);
+                  });
+                }),
+                _enumMenu('Theme', _themeMode,
+                    ThemeMode.values.toList()..remove(ThemeMode.system),
+                    (ThemeMode mode) {
+                  setState(() {
+                    _themeMode = mode;
+                  });
+                }),
+                _switch('24-hour format', _model.is24HourFormat, (bool value) {
+                  setState(() {
+                    _model.is24HourFormat = value;
+                  });
+                }),
+                _enumMenu(
+                    'Weather', _model.weatherCondition, WeatherCondition.values,
+                    (WeatherCondition condition) {
+                  setState(() {
+                    _model.weatherCondition = condition;
+                  });
+                }),
+                _enumMenu('Units', _model.unit, TemperatureUnit.values,
+                    (TemperatureUnit unit) {
+                  setState(() {
+                    _model.unit = unit;
+                  });
+                }),
+              ],
+            ),
+          ),
+        ),
+      ),
+    );
+  }
+
+  Widget _configButton() {
+    return Builder(
+      builder: (BuildContext context) {
+        return IconButton(
+          icon: Icon(Icons.settings),
+          tooltip: 'Configure clock',
+          onPressed: () {
+            Scaffold.of(context).openEndDrawer();
+            setState(() {
+              _configButtonShown = false;
+            });
+          },
+        );
+      },
+    );
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final clock = Center(
+      child: AspectRatio(
+        aspectRatio: 5 / 3,
+        child: Container(
+          decoration: BoxDecoration(
+            border: Border.all(
+              width: 2,
+              color: Theme.of(context).unselectedWidgetColor,
+            ),
+          ),
+          child: widget._clock(_model),
+        ),
+      ),
+    );
+
+    return MaterialApp(
+      theme: ThemeData.light(),
+      darkTheme: ThemeData.dark(),
+      themeMode: _themeMode,
+      debugShowCheckedModeBanner: false,
+      home: Scaffold(
+        resizeToAvoidBottomPadding: false,
+        endDrawer: _configDrawer(context),
+        body: SafeArea(
+          child: GestureDetector(
+            behavior: HitTestBehavior.opaque,
+            onTap: () {
+              setState(() {
+                _configButtonShown = !_configButtonShown;
+              });
+            },
+            child: Stack(
+              children: [
+                clock,
+                if (_configButtonShown)
+                  Positioned(
+                    top: 0,
+                    right: 0,
+                    child: Opacity(
+                      opacity: 0.7,
+                      child: _configButton(),
+                    ),
+                  ),
+              ],
+            ),
+          ),
+        ),
+      ),
+    );
+  }
+}