Development Status
- 5 - Production/Stable
Intended Audience
- Developers
License
- OSI Approved :: BSD License
Operating System
- Unix
- POSIX
- Microsoft :: Windows
Programming Language
- Python
- Python :: 3
- Python :: 3 :: Only
- Python :: 3.8
- Python :: 3.9
- Python :: 3.10
- Python :: 3.11
- Python :: 3.12
- Python :: Implementation :: CPython
- Python :: Implementation :: PyPy
Topic
- Utilities
Tools for testing processes.
Free software: BSD 2-Clause License
Usage
from process_tests import ProcessTestCase
from process_tests import TestProcess
class MyTestCase(ProcessTestCase):
def test_simple(self):
with TestProcess('mydaemon', 'arg1', 'arg2') as proc:
with self.dump_on_error(proc.read):
self.wait_for_strings(proc.read, 10, # wait 10 seconds for process to output lines with these strings
'Started',
'Working',
'Done',
)
Features
TODO
Examples
https://github.com/ionelmc/python-redis-lock/blob/master/tests/test_redis_lock.py
https://github.com/ionelmc/python-manhole/blob/master/tests/test_manhole.py
https://github.com/ionelmc/python-stampede/blob/master/tests/test_stampede.py
https://github.com/ionelmc/python-remote-pdb/blob/master/tests/test_remote_pdb.py
TODO
tests
docs
Requirements
- OS:
Any
- Runtime:
Python 2.6, 2.7, 3.2, 3.3 or PyPy
Similar projects
TODO
Changelog
3.0.0 (2023-11-01)
Dropped Python 2 support.
Added an optional non-pipe TestProcess mode. You can use file objects for processes that are too verbose for a pipe.
Added some tests.
2.1.2 (2021-05-02)
Fixed another regression caused by the universal_newlines for Windows.
2.1.1 (2020-07-23)
Fixed regression caused by the universal_newlines (now the internals don’t decode strings).
2.1.0 (2020-07-23)
Applied the cookiecutter-pylibrary templates.
TestProcess will use universal_newlines by default for the contained subprocess.Popen to make sure line buffering is actually used. This also fixes warnings on Python 3.
2.x (???)
Lots of wild stuff.