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'