mirror of
https://github.com/dart-lang/sdk
synced 2024-09-19 21:01:50 +00:00
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:
parent
61d702cc89
commit
9794937636
42
pkg/logging/README.md
Normal file
42
pkg/logging/README.md
Normal 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.
|
|
@ -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
|
||||
|
|
|
@ -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'
|
||||
|
|
Loading…
Reference in a new issue