pkg/logging: use UnmodifiableMapView from dart:collection remove documentation URL remove (now) unused collection pkg import move intro docs to README.md R=sethladd@google.com Review URL: https://codereview.chromium.org//413193002 git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart/pkg/logging@38546 260f80e4-7a28-3924-810f-c04153c831b5
diff --git a/README.md b/README.md new file mode 100644 index 0000000..9d6c978 --- /dev/null +++ b/README.md
@@ -0,0 +1,42 @@ +## 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)); +``` + +See the [Logger] class for the different logging methods.
diff --git a/lib/logging.dart b/lib/logging.dart index ba342f7..d1fb452 100644 --- a/lib/logging.dart +++ b/lib/logging.dart
@@ -3,55 +3,11 @@ // BSD-style license that can be found in the LICENSE file. /** - * Support for logging. - * - * For information on installing and importing this library, see the - * [logging package on pub.dartlang.org] - * (http://pub.dartlang.org/packages/logging). - * - * ## 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`. - * - * 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. - * - * final Logger log = new Logger('MyClassName'); - * - * Here is an example of logging a debug message and an error: - * - * Future future = doSomethingAsync(); - * future.then((result) { - * log.fine('Got the result: $result'); - * processResult(result); - * }) - * .catchError((e, stackTrace) => log.severe('Oh noes!', e, stackTrace)); - * - * See the [Logger] class for the different logging methods. */ library logging; import 'dart:async'; -import 'package:collection/wrappers.dart'; +import 'dart:collection'; /** * Whether to allow fine-grain logging and configuration of loggers in a
diff --git a/pubspec.yaml b/pubspec.yaml index 199f653..678ceef 100644 --- a/pubspec.yaml +++ b/pubspec.yaml
@@ -1,15 +1,12 @@ name: logging -version: 0.9.1+1 +version: 0.9.1+2 author: Dart Team <misc@dartlang.org> description: > Provides APIs for debugging and error logging. This library introduces abstractions similar to those used in other languages, such as the Closure JS Logger and java.util.logging.Logger. -homepage: http://www.dartlang.org -documentation: http://api.dartlang.org/docs/pkg/logging +homepage: https://pub.dartlang.org/packages/logging environment: - sdk: '>=1.0.0 <2.0.0' -dependencies: - collection: '>=0.9.0 <0.10.0' + sdk: '>=1.5.0 <2.0.0' dev_dependencies: - unittest: '>=0.9.0 <0.10.0' + unittest: '>=0.9.0 <0.12.0'