ic-logger 0.1.0

A logger for the Internet Computer
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

[![](https://img.shields.io/github/tag/zvolin/ic-logger)](https://github.com/zvolin/ic-logger/tags) [![](https://img.shields.io/docsrs/ic-logger/latest)](https://docs.rs/ic-logger/latest/ic_logger/) [![](https://img.shields.io/crates/d/ic-logger)](https://crates.io/crates/ic-logger)

# ic-logger 

A simple logging backend for [ICP](https://internetcomputer.org) canisters.

Usage
-----

```rust
use ic_cdk::{init, query};

mod foo {
    pub fn bar() {
        log::warn!("sample log");
    }
}

#[init]
async fn init() {
    ic_cdk::setup();
}

#[update]
async fn baz() -> Result<()> {
    let _ = ic_logger::init();

    foo::bar();
}
```

This outputs:

```txt
2023-07-27 23:08:09.718590904 UTC: [Canister bkyz2-fmaaa-aaaaa-qaaaq-cai] [WARN  my_canister::foo] sample log
```

You can run the above example with:

```sh
dfx start --clean --background
dfx deploy
dfx call my_canister baz
```

As the canister's flexible memory may be dropped, it's suggested to call `ic_logger::init()` (or equivalent)
in each canister function and drop the result in case the logger was already initialized.

Licence
-------

`ic-logger` is licenced under the [MIT Licence](http://opensource.org/licenses/MIT).

Credits
-------

Forked from [simple_logger](https://github.com/borntyping/rust-simple_logger) written by [Sam Clements](sam@borntyping.co.uk).