Finalize hot-reloading feature

- Rename live-reload to hot-reload
- Add debug logging about reloading
- Add documentation
- Version bump and changelog

Author: samogot

build_runner/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 0.10.2
+
+- `--live-reload` cli option is replaced with `--hot-reload` one with appropriate
+functionality. See [hot-module-reloading](../docs/hot_module_reloading.md) for more 
+info.
+
 ## 0.10.1+1
 
 - Added better error handling when a socket is already in use in `serve` mode.

build_runner/README.md

@@ -99,7 +99,8 @@ Some commands also have additional options:
 ##### serve
 
 - `--hostname`: The host to run the server on.
-- `--live-reload`: Enables automatic page reloading on rebuilds.
+- `--hot-reload`: Enables automatic module reloading on rebuilds. 
+See [hot-module-reloading](../docs/hot_module_reloading.md) for more info.
 
 Trailing args of the form `<directory>:<port>` are supported to customize what
 directories are served, and on what ports.

build_runner/lib/src/entrypoint/options.dart

@@ -14,7 +14,7 @@ import 'package:path/path.dart' as p;
 const assumeTtyOption = 'assume-tty';
 const defineOption = 'define';
 const deleteFilesByDefaultOption = 'delete-conflicting-outputs';
-const liveReloadOption = 'live-reload';
+const hotReloadOption = 'hot-reload';
 const logPerformanceOption = 'log-performance';
 const logRequestsOption = 'log-requests';
 const lowResourcesModeOption = 'low-resources-mode';
@@ -131,13 +131,13 @@ class SharedOptions {
 /// Options specific to the `serve` command.
 class ServeOptions extends SharedOptions {
   final String hostName;
-  final bool liveReload;
+  final bool hotReload;
   final bool logRequests;
   final List<ServeTarget> serveTargets;
 
   ServeOptions._({
     @required this.hostName,
-    @required this.liveReload,
+    @required this.hotReload,
     @required this.logRequests,
     @required this.serveTargets,
     @required bool assumeTty,
@@ -203,7 +203,7 @@ class ServeOptions extends SharedOptions {
 
     return ServeOptions._(
       hostName: argResults[hostnameOption] as String,
-      liveReload: argResults[liveReloadOption] as bool,
+      hotReload: argResults[hotReloadOption] as bool,
       logRequests: argResults[logRequestsOption] as bool,
       serveTargets: serveTargets,
       assumeTty: argResults[assumeTtyOption] as bool,

build_runner/lib/src/entrypoint/serve.dart

@@ -26,7 +26,7 @@ class ServeCommand extends WatchCommand {
           defaultsTo: false,
           negatable: false,
           help: 'Enables logging for each request to the server.')
-      ..addFlag(liveReloadOption,
+      ..addFlag(hotReloadOption,
           defaultsTo: false,
           negatable: false,
           help: 'Enables automatic page reloading on rebuilds.');
@@ -91,7 +91,7 @@ class ServeCommand extends WatchCommand {
           server,
           handler.handlerFor(target.dir,
               logRequests: options.logRequests,
-              liveReload: options.liveReload));
+              hotReload: options.hotReload));
     });
 
     _ensureBuildWebCompilersDependency(packageGraph, logger);

build_runner/lib/src/server/hot_reload_client/client.dart

@@ -17,7 +17,7 @@ import 'reload_handler.dart';
 import 'reloading_manager.dart';
 
 final _assetsDigestPath = r'$assetDigests';
-final _buildUpdatesProtocol = r'$livereload';
+final _buildUpdatesProtocol = r'$hotreload';
 
 @anonymous
 @JS()