Cargo Features

[dependencies]
blazesym = { version = "0.2.0-alpha.11", default-features = false, features = ["apk", "backtrace", "breakpad", "demangle", "dwarf", "gsym", "generate-unit-test-files", "generate-large-test-files", "dont-generate-unit-test-files", "nightly", "tracing"] }
default = backtrace, demangle, dwarf

These default features are set whenever blazesym is added without default-features = false somewhere in the dependency tree.

apk

Enable this feature to enable APK support (mostly relevant for Android).

backtrace default

Enable this feature to compile in support for capturing backtraces in errors.
Note that by default backtraces will not be collected unless opted in with environment variables.

breakpad = circular, nom

Enable this feature to enable Breakpad support.

demangle default = cpp_demangle, rustc-demangle

Enable this feature to get transparent symbol demangling.

dwarf default = gimli

Enable this feature to enable DWARF support.

gsym

Enable this feature to enable Gsym support.

generate-unit-test-files = dump_syms, xz2, zip

Below here are dev-mostly features that should not be needed by regular users.

Enable this feature to opt in to the generation of unit test files.
Having these test files created is necessary for running tests.

generate-large-test-files = dump_syms, reqwest, xz2

Enable this feature to opt in to the generation of large benchmark files (also used for regression testing).

dont-generate-unit-test-files

Disable generation of test files. This feature takes preference over generate-unit-test-files.

nightly

Enable code paths requiring a nightly toolchain. This feature is only meant to be used for testing and benchmarking purposes, not for the core library, which is expected to work on stable.

Features from optional dependencies

In crates that don't use the dep: syntax, optional dependencies automatically become Cargo features. These features may have been created by mistake, and this functionality may be removed in the future.

circular breakpad?
cpp_demangle demangle
gimli dwarf

Enables gimli ^0.28

nom breakpad?
rustc-demangle demangle
tracing implicit feature

Enables tracing

tracing:

Application-level tracing for Rust

dump_syms build generate-large-test-files? generate-unit-test-files?
reqwest build generate-large-test-files?

Enables reqwest ^0.11.18

xz2 build generate-large-test-files? generate-unit-test-files?
zip build generate-unit-test-files?

Enables zip ^0.6.4