blob: 8a037f65680be3deb9fbc0c321dabbd1698aee96 (
plain)
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
|
# BinaryNinja-rs
<img align="right" src="./under_construction.png" width="175" height="175">
> :warning: **These bindings are in a very early beta, only have partial support for the core APIs and are still actively under development. Compatibility _will_ break and conventions _will_ change! They are being used for core Binary Ninja features however, so we expect much of what is already there to be reliable enough to build on, just don't be surprised if your plugins/scripts need to hit a moving target.**
> :warning: This project runs on Rust version `1.77.0`
## Contributing
:warning: If you're thinking of contributing to the Rust API, we encourage you to join the #rust-api channel in our Slack: https://slack.binary.ninja, especially for large-effort PRs.
Add a "Contributing" section to the Rust API readme
## Dependencies
Having BinaryNinja installed (and your license registered)
Clang
Rust
## How to use
See [`examples/template`](examples/template) for more details.
### To write a plugin:
`Cargo.toml`:
```
[lib]
crate-type = ["cdylib"]
[dependencies]
binaryninja = {git = "https://github.com/Vector35/binaryninja-api.git", branch = "dev"}
```
See the `./examples/`. Plugin registration commands are in `binaryninja::command::*`
### To write a standalone executable:
`Cargo.toml`:
```
[dependencies]
binaryninja = { git = "https://github.com/Vector35/binaryninja-api.git", branch = "dev"}
```
All standalone binaries should call both `binaryninja::headless::init()` and `binaryninja::headless::shutdown()`.
All standalone binaries need to provide a `build.rs`.
See [`examples/template`](examples/template) for details.
## Docs
Docs can be found at https://dev-rust.binary.ninja/
---
#### Attribution
This project makes use of:
- [log] ([log license] - MIT)
- [rayon] ([rayon license] - MIT)
[log]: https://github.com/rust-lang/log
[log license]: https://github.com/rust-lang/log/blob/master/LICENSE-MIT
[rayon]: https://github.com/rayon-rs/rayon
[rayon license]: https://github.com/rayon-rs/rayon/blob/master/LICENSE-MIT
|
