recrep
Generate crash reports with ease.
recrep uses the AppCenter API to compile a crash report for a given organization, application and optional version. When no version is specified, the latest version is used.
How To
The easiest way to run recrep is using cargo. Clone this repository and prefix your commands with cargo run --.
$ cargo run -- --help
Finished dev [unoptimized + debuginfo] target(s) in 0.27s
Running `target/debug/recrep --help`
recrep 0.1.1
The Mobile Releases Team of XING SE <[email protected]>
Recycled Crep: Look at your crashes.
USAGE:
recrep [OPTIONS] --application <application> --organization <organization> --token <token>
FLAGS:
--arithmetic-mean Use the arithmetic mean as threshold value, and only show crashes exceeding this value.
This flag is incompatible with `--threshold`.
-h, --help Prints help information
OPTIONS:
-a, --application <application> The application identifier as seen in AppCenter urls.
-g, --group <distribution-group> Distribution group used to search for the latest version released into this
distribution group.
-c, --organization <organization> The organization the app belongs to.
-o, --outfile <outfile> An optional filename to write the report to instead of printing it to the
console.
-m, --threshold <threshold> Set a threshold value determining a maximum amount of crashes and show a
percentage of how many percent are reached for each crash in the crash list.
-t, --token <token> The AppCenter API token [env: RECREP_APPCENTER_API_TOKEN=]
-v, --version <version> The app version. If none is specified, the latest available version will be
picked - be aware that the latest version might not have crashes yet.The token can be provided as environment variable: RECREP_APPCENTER_API_TOKEN.
Example:
This will retrieve the crashes for the latest available version for the given organization. If you want to retrieve crashes of a certain version you may provide it using an additional parameter: --version 1.2.3.
$ cargo run -- --organization XING-SE-Organization --application XING
Finished dev [unoptimized + debuginfo] target(s) in 0.27s
Running `target/debug/recrep --organization XING-SE-Organization --application XING`
Hello everyone!
This is the crash newsletter of v7.41.3 💌
First appeared on 2019-05-17T04:03:49Z and occurred 329 times in 7.41.3/10167 and affected 330 devices.
File: NSManagedObjectContext+XNGManagedObjectContextObservable.m
Class: XNGManagedObjectContextObservable
Method: notifyObserversWithContext:changeInfo:
More on AppCenter: https://appcenter.ms/orgs/XING-SE-Organization/apps/XING/crashes/errors/1005734617u/overview.
-------------------------------
First appeared on 2019-05-16T18:35:54Z and occurred 123 times in 7.41.3/...Test
You can execute all tests by running cargo test.
Build
muslrust allows us to build Rust binaries using the musl toolchain, which is nice if you want to cross-compile for Linux.
- muslrust is dockerized, so start Docker
- build the app:
docker pull clux/muslrust
docker run -v $PWD:/volume --rm -t clux/muslrust cargo build --release- this builds a release build of recrep and places it to
./target/x86_64-unknown-linux-musl/release/ - copy the
recrepexecutable to whereever it will be executed
Documentation
You can generate and open the documentation by running cargo doc --open