Plugin to run pystack after a timeout for a test suite.
Project description
pytest-pystack
A pytest plug-in for easy integration of PyStack in your test suite.
It can be used to automatically dump the stack trace of a hanging test in your suite (with exception to test using pytester
fixture).
See PyStack for further information about the tool.
Installation
To install the PyStack pytest plug-in, just run the following command in your venv:
python -m pip install pytest-pystack
Quick Start
After you have installed the pytest plug-in, you can have PyStack monitor your test suite and output a stack trace if a test takes more than 5
seconds, simply by running pytest with argument --pystack-threshold=5
.
Configuration
The PyStack plug-in can be configured via the command line with the following options:
--pystack-threshold
: Enables the plug-in and monitors all tests, generating a stack trace if they take longer than the specified threshold. Note, this neither stops nor fails the test case after the specified threshold.--pystack-output-file
: Appends PyStack output to a file.--pystack-path
: Path to thepystack
executable.--pystack-args
: Additional args to pass topystack remote <pid>
, like--native
or--native-all
.
And through any pytest config file, see an example of pyproject.toml
:
[tool.pytest.ini_options]
pystack_threshold=60
pystack_path="custom-version-of-pystack"
pystack_output_file="./pystack.log"
pystack_args="--native"
License
This project is Apache-2.0 licensed, as found in the LICENSE file.
Code of Conduct
This project has adopted a Code of Conduct. If you have any concerns about the Code, or behavior that you have experienced in the project, please contact us at opensource@bloomberg.net.
Contributing
We welcome your contributions to help us improve and extend this project!
Below you will find some basic steps required to be able to contribute to the project. If you have any questions about this process or any other aspect of contributing to a Bloomberg open source project, feel free to send an email to opensource@bloomberg.net and we'll get your questions answered as quickly as we can.
Contribution Licensing
Since this project is distributed under the terms of an open source license, contributions that you make are licensed under the same terms. For us to be able to accept your contributions, we will need explicit confirmation from you that you are able and willing to provide them under these terms, and the mechanism we use to do this is called a Developer's Certificate of Origin (DCO). This is similar to the process used by the Linux kernel, Samba, and many other major open source projects.
To participate under these terms, all that you must do is include a line like the following as the last line of the commit message for each commit in your contribution:
Signed-Off-By: Random J. Developer <random@developer.example.org>
The simplest way to accomplish this is to add -s
or --signoff
to your git commit
command.
You must use your real name (sorry, no pseudonyms, and no anonymous contributions).
Steps
- Create an Issue, select 'Feature Request', and explain the proposed change.
- Follow the guidelines in the issue template presented to you.
- Submit the Issue.
- Submit a Pull Request and link it to the Issue by including "#" in the Pull Request summary.
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
Built Distribution
File details
Details for the file pytest_pystack-1.0.2.tar.gz
.
File metadata
- Download URL: pytest_pystack-1.0.2.tar.gz
- Upload date:
- Size: 18.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.10
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 04b310cf26fcdbe55581c55ef50722677c7698fbb4b6854868b4ec2e8e938d91 |
|
MD5 | df63785ebdadf9e03359a6354d848285 |
|
BLAKE2b-256 | a84ff9560584a4e14af46e43984adf99b51a1da544ff3b5c1a050224cd791604 |
File details
Details for the file pytest_pystack-1.0.2-py3-none-any.whl
.
File metadata
- Download URL: pytest_pystack-1.0.2-py3-none-any.whl
- Upload date:
- Size: 14.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.10
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | f3b565c62c297a1ff716fe9bb4c3f8dd594b57f21df261230cc3f941d38a97bb |
|
MD5 | 5eb27519604d67f6542ae7768b59e473 |
|
BLAKE2b-256 | 39adacae22b651ef3c505a0a676d953a7a730a663f6c2ce3590aa00178fc8ba6 |