Struct proguard::ProguardMapper

pub struct ProguardMapper<'s> { /* fields omitted */ }

A Proguard Remapper.

This can remap class names, stack frames one at a time, or the complete raw stacktrace.

Implementations

impl<'s> ProguardMapper<'s>

pub fn new(mapping: ProguardMapping<'s>) -> Self

Create a new ProguardMapper.

pub fn remap_class(&'s self, class: &str) -> Option<&'s str>

Remaps an obfuscated Class.

This works on the fully-qualified name of the class, with its complete module prefix.

Examples

let mapping = r#"android.arch.core.executor.ArchTaskExecutor -> a.a.a.a.c:"#;
let mapper = proguard::ProguardMapper::from(mapping);

let mapped = mapper.remap_class("a.a.a.a.c");
assert_eq!(mapped, Some("android.arch.core.executor.ArchTaskExecutor"));

pub fn remap_frame(&'s self, frame: &StackFrame<'s>) -> RemappedFrameIter<'s>

Remaps a single Stackframe.

Returns zero or more StackFrames, based on the information in the proguard mapping. This can return more than one frame in the case of inlined functions. In that case, frames are sorted top to bottom.

pub fn remap_throwable<'a>(
    &'a self,
    throwable: &Throwable<'a>
) -> Option<Throwable<'a>>

Remaps a throwable which is the first line of a full stacktrace.

Example

use proguard::{ProguardMapper, Throwable};

let mapping = "com.example.Mapper -> a.b:";
let mapper = ProguardMapper::from(mapping);

let throwable = Throwable::try_parse(b"a.b: Crash").unwrap();
let mapped = mapper.remap_throwable(&throwable);

assert_eq!(
    Some(Throwable::with_message("com.example.Mapper", "Crash")),
    mapped
);

pub fn remap_stacktrace(&self, input: &str) -> Result<String, Error>

Remaps a complete Java StackTrace, similar to Self::remap_stacktrace but instead works on strings as input and output.

pub fn remap_stacktrace_typed<'a>(
    &'a self,
    trace: &StackTrace<'a>
) -> StackTrace<'a>

Remaps a complete Java StackTrace.

Trait Implementations

impl<'s> Clone for ProguardMapper<'s>

fn clone(&self) -> ProguardMapper<'s>

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'s> Debug for ProguardMapper<'s>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'s> From<&'s str> for ProguardMapper<'s>

fn from(s: &'s str) -> Self

Performs the conversion.