hotload 0.15.6

Zero cost hot update dynamic library; supporting DLL, SO
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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

# hotload

[![crates.io](https://crates.io/crates/hotload)

## Quick example


```rust
use dlopen2::wrapper::{Container, WrapperApi};
use hotload::types::Hotload;

// Generate the following rust calling methods
hotload::gen_rust_no_mangle!((MyApi, "../call_lib/src/lib.rs"));

// #[derive(WrapperApi)]
// struct MyApi {
//     test_print: fn(msg: String),
//     init_data: fn(msg: String),
//     stop_runtime: fn(),
// }

fn main(){
    let dll: Hotload<MyApi> = Hotload::new("../call_lib/target/release/call_lib.dll");

    // "dll created" or "file rename to" is actively loaded
    dll.init_load(|_, _| {}).unwrap();

    let mut count = 0;
    loop {
        count += 1;
        dll.test_print(format!("msg{count}"));
    }
}
```

## Features


### Main features


* Zero cost hot update dynamic library; supporting DLL, SO


## Comparison with other libraries


| Feature                            | dlopen2    | [hotload](https://gitee.com/guoyucode/hotload) | hot-lib-reloader |
|------------------------------------|------------|---------------------------------------------------------|-------------------------------------------------|
| Basic functionality                | Yes        | Yes        | Yes       |
| Multiplatform                      | Yes        | Yes        | Yes       |
| Dangling symbol prevention         | Yes        | Yes        | Yes       |
| Thread safety                      | Yes        | Yes | Yes
| Loading of symbols into structures | Yes        | Yes    | Yes |
| Overhead                           | Minimal    | Minimal    | Minimal |
| Low-level, unsafe API              | Yes        | Yes        | Yes       |
| Object-oriented friendly           | Yes        | Yes       | Yes     |
| Load from the program itself       | Yes        | Yes       | Yes  |
| Obtaining address information (dladdr) | Yes    | Yes | Yes |
| Auto reload | **No**    | Yes | Yes |
| Is haved load new dll event | **No**    | Yes | **No** |
| Zero cost, Is not lock | **No**    | Yes | **No** |
| Generate rust call method | **No**    | Yes | Yes |


## Usage


Cargo.toml:

```toml
[dependencies]
dlopen2 = "0.6"
hotload = "0.9"
```

## Documentation


[Cargo documentation](https://docs.rs/hotload)

## License


This code is licensed under the [MIT](./LICENSE) license.

## Changelog


[GitHub](https://gitee.com/guoyucode/hotload)

## Acknowledgement


Special thanks to [dlopen2](https://github.com/nagisa) and [hot-lib-reloader](https://crates.io/crates/hot-lib-reloader)