Reads the output of a process line-by-line with a time limit
Project description
bgprocess
Reads the output of a process line-by-line with a time limit.
Tested on Linux and macOS with Python 3.7-3.9.
Install
$ pip3 install bgprocess
Use
from bgprocess import BackgroundProcess, LineWaitingTimeout
with BackgroundProcess(["some_program", "arg1", "arg2"]) as process:
# The process is already up and running in background.
# We can continue to perform operations in our program
do_something()
do_something_more()
# ok, let's check how the process is doing
try:
# getting for the first line from the process output.
# If no line was output, this call will wait for the line
# and only then will return the result
str1 = process.next_line()
# waiting for the second line from the process output
str2 = process.next_line()
# waiting for the next line, but not too long.
# If the line does not appear in 0.25 seconds,
# LineWaitingTimeout exception will be raised
str3 = process.next_line(read_timeout = 0.25) # 0.25 seconds
# skipping lines until we get the line matching the condition
str4 = bp.next_line(match = lambda line: line.startswith('a'))
# skipping lines until we get the line matching the condition.
# If the mathing line does not appear in 3 seconds,
# LineWaitingTimeout exception will be raised
str5 = process.next_line(
match = lambda line: line.startswith('a'),
match_timeout = 3)
except LineWaitingTimeout:
# we may get this exception when running next_line with
# read_timeout or match_timeout
print("Timeout!")
If the process is finished, next_line
returns None
instead of a str
.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
bgprocess-1.1.0.tar.gz
(6.1 kB
view hashes)
Built Distribution
Close
Hashes for bgprocess-1.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ba24e0a14abd8ed16c8b70ec220c74b04c47b0dfa3ee4a70e80764393d6de85d |
|
MD5 | c99a50091fc63550638651b99c57c248 |
|
BLAKE2b-256 | 5cf5d61e3008f9327763feb766cf90ffa140c8f8c1845066062c1482316034c8 |