multiCMD 1.18__py3-none-any.whl → 1.20__py3-none-any.whl

{multiCMD-1.18.dist-info → multiCMD-1.20.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: multiCMD
-Version: 1.18
+Version: 1.20
 Summary: Run commands simultaneously
 Home-page: https://github.com/yufei-pan/multiCMD
 Author: Yufei Pan
@@ -25,31 +25,24 @@ Dynamic: requires-python
 Dynamic: summary
 
 # multiCMD
-A simple script that is able to issue multiple commands and execute them at the same time locally.
-
-multiCMD can display realtime-ish outputs in color if running multiple commands at the same time.
-
-Can be used in bash scripts for automation actions.
-
-Also able to be imported and act as a wrapper for subprocess.
 
-Use return_object=True with run_commands or run_command to get the Task Object (definition below)
-
-Use quiet=True and wait_for_return=False to create a daemon thread that async updates the return list / objects when return comes 
-
-For each process, it will initialize a thread if using -m/--max_threads > 1
+A simple script that is able to issue multiple commands and execute them at the same time locally.
 
-For each thread, it will use subprocess lib to open a process for the command task
+`multiCMD` can display realtime-ish outputs in color if running multiple commands at the same time.
 
-And it will open two sub threads for processing input and output for the task.
+It can be used in bash scripts for automation actions, and it can also be imported and act as a wrapper for `subprocess`.
 
-They input / output threads will be non-blocking.
+- Use `return_object=True` with `run_commands` or `run_command` to get the Task Object (definition below).
+- Use `quiet=True` and `wait_for_return=False` to create a daemon thread that asynchronously updates the return list / objects when commands finish.
 
-Thus using -t/--timeout will work more reliably.
+For each process, a thread will be initialized if using `-m/--max_threads > 1`.  
+For each thread, `subprocess` is used to open a process for the command task.  
+Two additional threads are opened for processing input and output for the task.  
 
-Note: timeout specifies how many seconds multiCMD will kill the command if NO COMMITTED OUTPUT was detected from the program for this long.
+The input / output threads are non-blocking.  
+Thus, using `-t/--timeout` will work more reliably.
 
-An output line is considered committed if steram hanlder encounters a '\n' or '\r' character.
+**Note:** `timeout` specifies how many seconds `multiCMD` will wait before killing the command if **no committed output** was detected for this duration. An output line is considered committed if the **stream handler** encounters a `\n` or `\r` character.
 
 
 Install via

multiCMD-1.20.dist-info/RECORD

@@ -0,0 +1,6 @@
+multiCMD.py,sha256=5OOmn_3szuEQp4RVS9nDDeEL9cfzQzSLRDJ_qIM0_tw,16788
+multiCMD-1.20.dist-info/METADATA,sha256=-8Yhw0mFiNK6-YiJocXtWV9ANLHGGdSGwoU6XLtRXdw,5640
+multiCMD-1.20.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+multiCMD-1.20.dist-info/entry_points.txt,sha256=nSLBkYrcUCQxt1w3LIJkvgOhpRYEC0xAPqNG7u4OYs8,89
+multiCMD-1.20.dist-info/top_level.txt,sha256=DSqgftD40G09F3qEjpHRCUNUsGUvGZZG69Sm3YEUiWI,9
+multiCMD-1.20.dist-info/RECORD,,

multiCMD.py

@@ -12,7 +12,7 @@ import re
 import itertools
 import signal
 
-version = '1.18'
+version = '1.20'
 __version__ = version
 
 __running_threads = []
@@ -194,7 +194,7 @@ def __run_command(task,sem, timeout=60, quiet=False,dry_run=False,with_stdErr=Fa
 			start_time = time.time()
 			outLength = len(task.stdout) + len(task.stderr)
 			time.sleep(0)
-			sleep_time = 1.0e-8 # 10 nanoseconds
+			sleep_time = 1.0e-7 # 100 nanoseconds
 			while proc.poll() is None:  # while the process is still running
 				if task.stop:
 					proc.send_signal(signal.SIGINT)
@@ -226,7 +226,13 @@ def __run_command(task,sem, timeout=60, quiet=False,dry_run=False,with_stdErr=Fa
 			if stderr:
 				__handle_stream(io.BytesIO(stderr),task.stderr, task)
 			if task.returncode is None:
-				task.returncode = -1
+				# process been killed via timeout or sigkill
+				if task.stderr and task.stderr[-1].strip().startswith('Timeout!'):
+					task.returncode = 124
+				elif task.stderr and task.stderr[-1].strip().startswith('Ctrl C detected, Emergency Stop!'):
+					task.returncode = 137
+				else:
+					task.returncode = -1
 			if not quiet:
 				print(pre+'\n'+ '-'*100+post)
 				print(pre+f'Process exited with return code {task.returncode}'+post)

multiCMD-1.18.dist-info/RECORD

@@ -1,6 +0,0 @@
-multiCMD.py,sha256=BWFxhvkhHA0MGxIDGoMTjNLlr0R-pK7iwSIb7SQQpBQ,16505
-multiCMD-1.18.dist-info/METADATA,sha256=i2MkVTo5eCfUpW0KmFS6wlHo-a78j_nxZG8ZTgFdam4,5580
-multiCMD-1.18.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-multiCMD-1.18.dist-info/entry_points.txt,sha256=nSLBkYrcUCQxt1w3LIJkvgOhpRYEC0xAPqNG7u4OYs8,89
-multiCMD-1.18.dist-info/top_level.txt,sha256=DSqgftD40G09F3qEjpHRCUNUsGUvGZZG69Sm3YEUiWI,9
-multiCMD-1.18.dist-info/RECORD,,