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@38546 260f80e4-7a28-3924-810f-c04153c831b5
This commit is contained in:
kevmoo@google.com 2014-07-24 17:44:30 +00:00
parent 61d702cc89
commit 9794937636
3 changed files with 47 additions and 52 deletions

42
pkg/logging/README.md Normal file
View file

@ -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.

View file

@ -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

View file

@ -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'