Struct proguard::ProguardMapper

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

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_method( &'s self, class: &str, method: &str ) -> Option<(&'s str, &'s str)>

Remaps an obfuscated Class Method.

The class argument has to be the fully-qualified obfuscated name of the class, with its complete module prefix.

If the method can be resolved unambiguously, it will be returned alongside the remapped class, otherwise None is being returned.

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_typed 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.

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

Converts to this type from the input type.