lldb 0.0.8

Rust-like bindings to the public LLDB API. LLDB is the debugger from the LLVM project and is the system debugger on Mac OS X.
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

# lldb

[![](http://meritbadge.herokuapp.com/lldb)](https://crates.io/crates/lldb)

This crate provides a safe binding to the public API for [LLDB](https://lldb.llvm.org/) the
debugger provided by the [LLVM project](https://llvm.org/). LLDB provides a modern, high
performance debugger framework and is the default debugger for macOS
and iOS.

This builds upon a lower level crate [`lldb-sys`](https://github.com/endoli/lldb-sys.rs/).

Dual licensed under the MIT and Apache 2 licenses.

## Documentation

The API is fully documented with examples:
[https://endoli.github.io/lldb.rs/](https://endoli.github.io/lldb.rs/)

## Installation

This crate works with Cargo and is on
[crates.io](https://crates.io/crates/lldb).
Add it to your `Cargo.toml` like so:

```toml
[dependencies]
lldb = "0.0.8"
```

On macOS, the `LLDB.framework` requires that an `@rpath`
be configured for your application so that the `LLDB.framework`
can be found. This isn't directly supported by Cargo today, but
for local work and development, you can do this:

```shell
export DYLD_FRAMEWORK_PATH=/Applications/Xcode.app/Contents/SharedFrameworks
```

## Development Guidelines

The official LLDB bindings for C++ and Python maintain very
strict backwards compatibility. This has resulted in them
having methods that are considered to be deprecated in favor
of newer methods with more comprehensive arguments. The Rust
bindings don't have that problem (yet), so we should try to
only write bindings for the recommended usages and not the
deprecated methods.

The documentation for the official bindings is also somewhat
spotty. While it would be great to contribute upstream to
improve that, we should seek to have these bindings be well
documented and with more examples.

People should be jealous of the quality of our bindings.
Sic itur ad astra.

## Status of Implementation

Things are under active development. This project is not quite
usable yet as some of the basic functionality is being written.

## Support and Maintenance

I am developing this library largely on my own so far. I am able
to offer support and maintenance, but would very much appreciate
donations via [Patreon](https://patreon.com/endoli). I can also
provide commercial support, so feel free to
[contact me](mailto:bruce.mitchener@gmail.com).

## Contribution

Unless you explicitly state otherwise, any contribution
intentionally submitted for inclusion in the work by you,
as defined in the Apache-2.0 license, shall be dual licensed
as above, without any additional terms or conditions.