Python | Different ways to kill a Thread
Last Updated :
20 Jul, 2021
In general, killing threads abruptly is considered a bad programming practice. Killing a thread abruptly might leave a critical resource that must be closed properly, open. But you might want to kill a thread once some specific time period has passed or some interrupt has been generated. There are the various methods by which you can kill a thread in python.
- Raising exceptions in a python thread
- Set/Reset stop flag
- Using traces to kill threads
- Using the multiprocessing module to kill threads
- Killing Python thread by setting it as daemon
- Using a hidden function _stop()
Raising exceptions in a python thread :
This method uses the function PyThreadState_SetAsyncExc() to raise an exception in the a thread. For Example,
Python3
import threading
import ctypes
import time
class thread_with_exception(threading.Thread):
def __init__( self , name):
threading.Thread.__init__( self )
self .name = name
def run( self ):
try :
while True :
print ( 'running ' + self .name)
finally :
print ( 'ended' )
def get_id( self ):
if hasattr ( self , '_thread_id' ):
return self ._thread_id
for id , thread in threading._active.items():
if thread is self :
return id
def raise_exception( self ):
thread_id = self .get_id()
res = ctypes.pythonapi.PyThreadState_SetAsyncExc(thread_id,
ctypes.py_object(SystemExit))
if res > 1 :
ctypes.pythonapi.PyThreadState_SetAsyncExc(thread_id, 0 )
print ( 'Exception raise failure' )
t1 = thread_with_exception( 'Thread 1' )
t1.start()
time.sleep( 2 )
t1.raise_exception()
t1.join()
|
When we run the code above in a machine and you will notice, as soon as the function raise_exception() is called, the target function run() ends. This is because as soon as an exception is raised, program control jumps out of the try block and run() function is terminated. After that join() function can be called to kill the thread. In the absence of the function run_exception(), the target function run() keeps running forever and join() function is never called to kill the thread.
Set/Reset stop flag :
In order to kill a threads, we can declare a stop flag and this flag will be check occasionally by the thread. For Example
Python3
import threading
import time
def run():
while True :
print ( 'thread running' )
global stop_threads
if stop_threads:
break
stop_threads = False
t1 = threading.Thread(target = run)
t1.start()
time.sleep( 1 )
stop_threads = True
t1.join()
print ( 'thread killed' )
|
In the above code, as soon as the global variable stop_threads is set, the target function run() ends and the thread t1 can be killed by using t1.join(). But one may refrain from using global variable due to certain reasons. For those situations, function objects can be passed to provide a similar functionality as shown below.
Python3
import threading
import time
def run(stop):
while True :
print ( 'thread running' )
if stop():
break
def main():
stop_threads = False
t1 = threading.Thread(target = run, args = ( lambda : stop_threads, ))
t1.start()
time.sleep( 1 )
stop_threads = True
t1.join()
print ( 'thread killed' )
main()
|
The function object passed in the above code always returns the value of the local variable stop_threads. This value is checked in the function run(), and as soon as stop_threads is reset, the run() function ends and the thread can be killed.
Using traces to kill threads :
This methods works by installing traces in each thread. Each trace terminates itself on the detection of some stimulus or flag, thus instantly killing the associated thread. For Example
Python3
import sys
import trace
import threading
import time
class thread_with_trace(threading.Thread):
def __init__( self , * args, * * keywords):
threading.Thread.__init__( self , * args, * * keywords)
self .killed = False
def start( self ):
self .__run_backup = self .run
self .run = self .__run
threading.Thread.start( self )
def __run( self ):
sys.settrace( self .globaltrace)
self .__run_backup()
self .run = self .__run_backup
def globaltrace( self , frame, event, arg):
if event = = 'call' :
return self .localtrace
else :
return None
def localtrace( self , frame, event, arg):
if self .killed:
if event = = 'line' :
raise SystemExit()
return self .localtrace
def kill( self ):
self .killed = True
def func():
while True :
print ( 'thread running' )
t1 = thread_with_trace(target = func)
t1.start()
time.sleep( 2 )
t1.kill()
t1.join()
if not t1.isAlive():
print ( 'thread killed' )
|
In this code, start() is slightly modified to set the system trace function using settrace(). The local trace function is defined such that, whenever the kill flag (killed) of the respective thread is set, a SystemExit exception is raised upon the execution of the next line of code, which end the execution of the target function func. Now the thread can be killed with join().
Using the multiprocessing module to kill threads :
The multiprocessing module of Python allows you to spawn processes in the similar way you spawn threads using the threading module. The interface of the multithreading module is similar to that of the threading module. For Example, in a given code we created three threads(processes) which count from 1 to 9.
Python3
import threading
import time
def func(number):
for i in range ( 1 , 10 ):
time.sleep( 0.01 )
print ( 'Thread ' + str (number) + ': prints ' + str (number * i))
for i in range ( 0 , 3 ):
thread = threading.Thread(target = func, args = (i,))
thread.start()
|
The functionality of the above code can also be implemented by using the multiprocessing module in a similar manner, with very few changes. See the code given below.
Python3
import multiprocessing
import time
def func(number):
for i in range ( 1 , 10 ):
time.sleep( 0.01 )
print ( 'Processing ' + str (number) + ': prints ' + str (number * i))
for i in range ( 0 , 3 ):
process = multiprocessing.Process(target = func, args = (i,))
process.start()
|
Though the interface of the two modules is similar, the two modules have very different implementations. All the threads share global variables, whereas processes are completely separate from each other. Hence, killing processes is much safer as compared to killing threads. The Process class is provided a method, terminate(), to kill a process. Now, getting back to the initial problem. Suppose in the above code, we want to kill all the processes after 0.03s have passed. This functionality is achieved using the multiprocessing module in the following code.
Python3
import multiprocessing
import time
def func(number):
for i in range ( 1 , 10 ):
time.sleep( 0.01 )
print ( 'Processing ' + str (number) + ': prints ' + str (number * i))
all_processes = []
for i in range ( 0 , 3 ):
process = multiprocessing.Process(target = func, args = (i,))
process.start()
all_processes.append(process)
time.sleep( 0.03 )
for process in all_processes:
process.terminate()
|
Though the two modules have different implementations. This functionality provided by the multiprocessing module in the above code is similar to killing threads. Hence, the multiprocessing module can be used as a simple alternative whenever we are required to implement the killing of threads in Python.
Killing Python thread by setting it as daemon :
Daemon threads are those threads which are killed when the main program exits. For Example
Python3
import threading
import time
import sys
def func():
while True :
time.sleep( 0.5 )
print ( "Thread alive, and it won't die on program termination" )
t1 = threading.Thread(target = func)
t1.start()
time.sleep( 2 )
sys.exit()
|
Notice that, thread t1 stays alive and prevents the main program to exit via sys.exit(). In Python, any alive non-daemon thread blocks the main program to exit. Whereas, daemon threads themselves are killed as soon as the main program exits. In other words, as soon as the main program exits, all the daemon threads are killed. To declare a thread as daemon, we set the keyword argument, daemon as True. For Example in the given code it demonstrates the property of daemon threads.
Python3
import threading
import time
import sys
def func():
while True :
time.sleep( 0.5 )
print ( 'Thread alive, but it will die on program termination' )
t1 = threading.Thread(target = func)
t1.daemon = True
t1.start()
time.sleep( 2 )
sys.exit()
|
Notice that, as soon as the main program exits, the thread t1 is killed. This method proves to be extremely useful in cases where program termination can be used to trigger the killing of threads. Note that in Python, the main program terminates as soon as all the non-daemon threads are dead, irrespective of the number of daemon threads alive. Hence, the resources held by these daemon threads, such as open files, database transactions, etc. may not be released properly. The initial thread of control in a python program is not a daemon thread. Killing a thread forcibly is not recommended unless it is known for sure, that doing so will not cause any leaks or deadlocks.
Using a hidden function _stop() :
In order to kill a thread, we use hidden function _stop() this function is not documented but might disappear in the next version of python.
Python3
import time
import threading
class MyThread(threading.Thread):
def __init__( self , * args, * * kwargs):
super (MyThread, self ).__init__( * args, * * kwargs)
self ._stop = threading.Event()
def stop( self ):
self ._stop. set ()
def stopped( self ):
return self ._stop.isSet()
def run( self ):
while True :
if self .stopped():
return
print ( "Hello, world!" )
time.sleep( 1 )
t1 = MyThread()
t1.start()
time.sleep( 5 )
t1.stop()
t1.join()
|
Note: Above methods might not work in some situation or another, because python does not provide any direct method to kill threads.
Share your thoughts in the comments
Please Login to comment...