multiCMD 1.22__tar.gz → 1.24__tar.gz

{multicmd-1.22 → multicmd-1.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: multiCMD
-Version: 1.22
+Version: 1.24
 Summary: Run commands simultaneously
 Home-page: https://github.com/yufei-pan/multiCMD
 Author: Yufei Pan

{multicmd-1.22 → multicmd-1.24}/multiCMD.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: multiCMD
-Version: 1.22
+Version: 1.24
 Summary: Run commands simultaneously
 Home-page: https://github.com/yufei-pan/multiCMD
 Author: Yufei Pan

{multicmd-1.22 → multicmd-1.24}/multiCMD.py

@@ -18,7 +18,7 @@ import re
 import itertools
 import signal
 
-version = '1.22'
+version = '1.24'
 __version__ = version
 
 __running_threads = []
@@ -28,6 +28,7 @@ class Task:
 		self.returncode = None
 		self.stdout = []
 		self.stderr = []
+		self.thread = None
 		self.stop = False
 	def __iter__(self):
 		return zip(['command', 'returncode', 'stdout', 'stderr'], [self.command, self.returncode, self.stdout, self.stderr])
@@ -35,6 +36,10 @@ class Task:
 		return f'Task(command={self.command}, returncode={self.returncode}, stdout={self.stdout}, stderr={self.stderr}, stop={self.stop})'
 	def __str__(self):
 		return str(dict(self))
+	def is_alive(self):
+		if self.thread is not None:
+			return self.thread.is_alive()
+		return False
 
 def _expand_ranges(inStr):
 	'''
@@ -259,6 +264,31 @@ def __run_command(task,sem, timeout=60, quiet=False,dry_run=False,with_stdErr=Fa
 		else:
 			return task.stdout
 
+def ping(hosts,timeout=1,max_threads=0,quiet=True,dry_run=False,with_stdErr=False,
+				return_code_only=True,return_object=False,wait_for_return=True):
+	'''
+	Ping multiple hosts
+
+	@params:
+		hosts: The hosts to ping
+		timeout: The timeout for the command
+		max_threads: The maximum number of threads to use
+		quiet: Whether to suppress output
+		dry_run: Whether to simulate running the command
+		with_stdErr: Whether to append the standard error output to the standard output
+		return_code_only: Whether to return only the return code
+		return_object: Whether to return the Task object
+		wait_for_return: Whether to wait for the return of the command
+
+	@returns:
+		None | int | list[str] | Task: The output of the command
+	'''
+	commands = [f'ping -c 1 {host}' for host in hosts]
+	return run_commands(commands, timeout=timeout, max_threads=max_threads, quiet=quiet,
+						dry_run=dry_run, with_stdErr=with_stdErr, return_code_only=return_code_only, 
+						return_object=return_object,wait_for_return=wait_for_return)
+
+
 def run_command(command, timeout=0,max_threads=1,quiet=False,dry_run=False,with_stdErr=False,
 				return_code_only=False,return_object=False,wait_for_return=True):
 	'''
@@ -350,7 +380,8 @@ def run_commands(commands, timeout=0,max_threads=1,quiet=False,dry_run=False,wit
 	if max_threads > 1 or not wait_for_return:
 		sem = threading.Semaphore(max_threads)  # Limit concurrent sessions
 		threads = [threading.Thread(target=__run_command, args=(task,sem,timeout,quiet,dry_run,...),daemon=True) for task in tasks]
-		for thread in threads:
+		for thread,task in zip(threads,tasks):
+			task.thread = thread
 			thread.start()
 		if wait_for_return:
 			for thread in threads: