Memfault Compact Log Library
Project description
Memfault Compact Log Library
This library enables decoding Memfault-flavored compact logs. For background information on compact logs, see here:
Usage
Some brief usage information below. See the source for detailed usage.
Extracting compact log format strings from .elf
To extract the format strings from the symbol file:
from mflt_compact_log.log_fmt import LogFormatElfSectionParser
elf = "path to elf file"
# parse the elf file
mappings = LogFormatElfSectionParser.get_mapping_from_elf_file(elf)
# 'mappings' is a dictionary mapping log id to LogFormatInfo data
print(mappings)
>>> {8: LogFormatInfo(filename='./main/console_example_main.c', line=245, n_args=0, fmt='This is a compact log example')}
Decoding compact logs
To apply the format string to raw compact log data:
from mflt_compact_log.compact import CompactLogDecoder
# example format string; this could instead be retrieved from the elf file
fmt = "An Integer Format String: %d"
# compact log hex encoded raw data
compact_log = "820A0B"
# decode the log!
compact_log_as_bytes = bytes.fromhex(compact_log)
log = CompactLogDecoder.from_cbor_array(fmt, compact_log_as_bytes)
log.decode()
>>> 'An Integer Format String: 11'
Changes
0.0.2
- support Python 3.9 and 3.10
- update
prettytable
dependency from0.7.2
to3.4.1
- update
pyelftools
dependency from^0.28.0
to^0.29.0
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
mflt_compact_log-0.0.3.tar.gz
(41.8 kB
view hashes)
Built Distribution
Close
Hashes for mflt_compact_log-0.0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b2d6b8d20e4e3c961d72ecf1bc2a0803c4529f465809e09444aea59f23a36238 |
|
MD5 | c6986d38aacf911efebebcd1d1fbc507 |
|
BLAKE2b-256 | 05b0adbe7d2cf0c7ca93a62ef00a9f43f7f4c3fc959138eceb3484a174baf086 |