feat : ping function added

Author: sepandhaghighi

README.md

@@ -15,6 +15,7 @@
 # Orangetool
 
 Consist of some useful script for Orangepi/Raspberrypi boards (Under Development)
+Tested on Lubuntu
 
 ----------
 
@@ -27,7 +28,7 @@ By [Moduland Co](http://www.moduland.ir)
 
 - [Download](https://github.com/Moduland/Orangetool/archive/master.zip) source from github
 
-## Functions ##
+## IP Functions ##
 
 ```python
 import orangetool
@@ -39,22 +40,50 @@ local_ip=orange_tool.local_ip() # this function return local ip of board as stri
 #2- global_ip
 
 global_ip=orange_tool.global_ip() # this function return global ip of board as string
+
+#3- internet 
+
+status=orangetool.internet() #this function check internet connection and return True if internet connection is stable
+
+```
+
+## RAM Functions ##			
+
+```python
 
-#3- get_temp
+#4- total ram
 
-temp=orangetool.get_temp() # this function return cpu temperature as string
+ram=orangetool.ram_total() #this function return total ram of the board
 
-#4- internet 
+#5- free ram
 
-status=orangetool.internet() #this function check internet connection and return True if internet connection is stable
+ram=orangetool.ram_free() # this function return how much ram is available in the board
+
+#6- ram percentage
+
+ram=orangetool.ram_percent() # this function return available ram percentage
+
+```
+
+## Other Functions ##				
+
+```python
+
+#7- get_temp
+
+temp=orangetool.get_temp() # this function return cpu temperature as string
+
+#8- uptime
 
+time=orangetool.uptime() # this function return uptime of system
 
 ```
 
 
 
 - All of the functions in error state return `Error` String
 - local_ip() and global_ip() originally are available in ipz package [Link](http://github.com/sepandhaghighi/ipz)
+- RAM Functions in this version need psutil package
 
 			
 

requirements.txt

@@ -0,0 +1,5 @@
+psutil
+subprocess
+platform
+requests
+

src/orangetool.py

@@ -4,6 +4,7 @@
 import re
 import platform
 import psutil
+import multiprocessing as mu
 ip_pattern=r"(?:[0-9]{1,3}\.){3}[0-9]{1,3}"
 api_1="http://ipinfo.io/ip"
 
@@ -188,7 +189,28 @@ def uptime(DEBUG=False):
         if DEBUG==True:
             print(str(e))
         return "Error"
-
-
+def ping(ip,packet_number=3,DEBUG=False):
+    '''
+    This function ping ip and return True if this ip is available and False otherwise
+    :param ip: target ip
+    :param packet_number: numer of packet to size
+    :param DEBUG: Flag for using Debug mode
+    :type ip :str
+    :type packet_number:int
+    :type DEBUG:bool
+    :return: a boolean value (True if ip is available and False otherwise)
+    '''
+    try:
+        if re.match(ip_pattern,ip)==False:
+            raise Exception
+        output=str(list(sub.Popen(["ping",ip,"-c",str(packet_number)],stdout=sub.PIPE,stderr=sub.PIPE).communicate())[0])
+        if output.find("Unreachable")==-1:
+            return True
+        else:
+            return False
+    except Exception as e:
+        if DEBUG==True:
+            print(str(e))
+        return "Error"