README

About this project

Remoteperf is a performanc emeasurement library written in python. It's designed to work on remote systems, connecting via ssh or adb and using basic tooling in order to extract performance data to then parse it. The ibrary is designed to work out-of-the-box on as wide variety of systems as possible by using basic shell-scripting and standard command-line tools (such as cat, grep, sed, ls etc).
Featres: measuring cpu and memory, system-wide or process-wise, in the background or single measurements, on linux, android, and QNX.
Limitations: Currently, spawning background processes on a target which produces data

Pytest is used to run python unit test together with Nox to create a virtual environments.

Execute

nox -e test

To run multithreaded with 8 threads:

nox -e test -- -n 8

To run integration tests, run

nox -e integration_test

To keep the container alive for debugging or avoiding startup and teardown each time, run

nox -e integration_test -- keep_container

Building remains a manual step for now:

nox -e build_integration_image

TODO

See the contributing guide for detailed instructions on how to get started with this project.

This project adheres to the Code of Conduct. By participating, you are expected to honor this code.