| Index: pkg/logging/README.md
|
| diff --git a/pkg/logging/README.md b/pkg/logging/README.md
|
| deleted file mode 100644
|
| index f4781a7aecd36015edacbc5f10f25d051be49ae7..0000000000000000000000000000000000000000
|
| --- a/pkg/logging/README.md
|
| +++ /dev/null
|
| @@ -1,49 +0,0 @@
|
| -## Initializing
|
| -
|
| -By default, the logging package does not do anything useful with the
|
| -log messages. You must configure the logging level and add a handler
|
| -for the log messages.
|
| -
|
| -Here is a simple logging configuration that logs all messages
|
| -via `print`.
|
| -
|
| -```dart
|
| -Logger.root.level = Level.ALL;
|
| -Logger.root.onRecord.listen((LogRecord rec) {
|
| - print('${rec.level.name}: ${rec.time}: ${rec.message}');
|
| -});
|
| -```
|
| -
|
| -First, set the root [Level]. All messages at or above the level are
|
| -sent to the [onRecord] stream.
|
| -
|
| -Then, listen on the [onRecord] stream for [LogRecord] events. The
|
| -[LogRecord] class has various properties for the message, error,
|
| -logger name, and more.
|
| -
|
| -## Logging messages
|
| -
|
| -Create a [Logger] with a unique name to easily identify the source
|
| -of the log messages.
|
| -
|
| -```dart
|
| -final Logger log = new Logger('MyClassName');
|
| -```
|
| -
|
| -Here is an example of logging a debug message and an error:
|
| -
|
| -```dart
|
| -var future = doSomethingAsync().then((result) {
|
| - log.fine('Got the result: $result');
|
| - processResult(result);
|
| -}).catchError((e, stackTrace) => log.severe('Oh noes!', e, stackTrace));
|
| -```
|
| -
|
| -When logging more complex messages, you can pass a closure instead
|
| -that will be evaluated only if the message is actually logged:
|
| -
|
| -```dart
|
| - log.fine(() => [1, 2, 3, 4, 5].map((e) => e * 4).join("-"));
|
| -```
|
| -
|
| -See the [Logger] class for the different logging methods.
|
|
|