SnakeScan 1.6.4__tar.gz → 1.6.6__tar.gz

{snakescan-1.6.4 → snakescan-1.6.6}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: SnakeScan
-Version: 1.6.4
-Summary: IPv4 address scanner for collecting address information.Use carefully for your network safety.Use to get IPV4 from IPV6  address.Don't use it to scan IPV6 because it's not designed for it. Scan only IPv4 or get the IPv4 address from the IPv6 host 
+Version: 1.6.6
+Summary: IPv4 address scanner for collecting address information.Use carefully for your network safety.Use to get IPV4 from IPV6  address.Don't use it to scan IPV6 because it's not designed for it. Scan only IPv4 or get the IPv4 address from the IPv6 host
 Author: Den*Ram
 Requires-Python: >=3.7
 Description-Content-Type: text/markdown
@@ -15,13 +15,15 @@ Project-URL: Repository, https://github.com/Den-Ram/SnakeScan
 
 # SnakeScan
 ![PyPI version](https://badge.fury.io/py/SnakeScan.svg)
-![Requires-python](https://img.shields.io/badge/requires--python-3.7+-red)
 ![License](https://img.shields.io/badge/License-MIT-blue.svg)
+![Requires-python](https://img.shields.io/badge/requires--python-3.7+-red)
+Use to scan Ports and use carefully.Use the library in the terminal, because that's what it's focused on. If you don't want to use the terminal, run it in code, but then some new functions won't be present there.You will need to use it differently.
+# Help with using the library 
+## If you use the library directly in your code:
  ```
 import SnakeScan
 SnakeScan.run()
 ```
-## Help
 - -l  need internet to view public ip you device
 - -t threading port search
 - -s single search ports
@@ -29,16 +31,46 @@ SnakeScan.run()
 - -help in host /-help port in host
 - -check [host] scan subnet in ip
 - exit in host or port off script
+
+## Watcher commands
+ ```
+ Watcher.start() - Starts checking ports
+ Watcher.stop() - Stops port checking
+ ```
+ ## Help with attributes
+```
+-P:
+snake -p 80,443 **Scanning specific ports**
+snake -p 80,3437,8080,20-30,79-443 **Scanning individual ports and ranges. If you use ranges, then one port from the beginning is not be taken into account. For example:80-443 then it will start with 81-443, so you need to enter it from 79-443, then it will be taken into account 
+snake -p 80,3437,10-0,20-10,443-79** **You can enter ranges the other way around: 80-443,443-80 but the first value will start one port higher**
+-H:
+**Displays a list of attribute usages**
+snake -h
+snake -help
+-SP:
+-sp:snake -sp **Uses selected pre-selected range and uses for scanning ProcessPoolExecutor**
+-V:
+snake -v **Shows the library version**
+-T:
+snake -t **Uses streams for port scanning**
+-CH:
+snake -ch **Scans the subnet for others IP**
+-L:
+snake -l **Shows your public internet IP address. Internet connection required for use**
+-I:
+snake www.google.com -i **Shows information about the IP address.Can receive information from IPV4 and IPV6**
+**You can also use all attributes in place:**
+```
+snake -p 100,200,79-443 www.google.com -i -l -t -ch -sp
+```
+# Library changes
+
 ## Added class Watcher:
  ```
  from SnakeScan import Watcher
  Watcher = Watcher(host="localhost",port="80",timeout=1)
  Watcher.start()
  ```
- ## Watcher commands
- ```
- Watcher.start() - Starts checking ports
- Watcher.stop() - Stops port checking
  ## Added multiple use Watcher:
  ```
  from SnakeScan import Watcher
@@ -48,7 +80,7 @@ SnakeScan.run()
  Watchers.append(Watcher("127.0.0.1",ports[i]))
  Watchers[i].start()
  ```
-## Added CLI command line use snake or Snake
+## Library added for use in terminal to use enter snake or Snake    
 ```
 usage: snake [-h] [-sp] [-v] [-i] [-p PORTS] [-t] [-ch]
              [-l]
@@ -70,19 +102,6 @@ options:
   -ch, --check       scan subnet
   -l, --local        view you public ip - need internet
 ```
-## Attributes snake-Snake
-```
--p:snake -p 80,443,3437,20-1000
--p:[20]-1000 will start from [21]-[1000]
--h:snake -h [snake usage]
--sp:snake -sp [use processpoolexecutir to scan host]
--v:snake -v [Build_version]
--t:snake -t [use thread pool to scan]
--ch:snake -ch [scan subnet in host]
--l:snake -l [view you public ip and to view need on internet]
--i:snake www.google.com -i [info ip of host]
-All:snake -p 100,200,79-443 www.google.com -i -l -t -ch -sp
-```
 ## Added Info about ipv6
 ```
 snake 2001:db8:: -i or snake [2001:4860:4860::8888] -i

snakescan-1.6.6/README.md

@@ -0,0 +1,93 @@
+# SnakeScan
+![PyPI version](https://badge.fury.io/py/SnakeScan.svg)
+![License](https://img.shields.io/badge/License-MIT-blue.svg)
+![Requires-python](https://img.shields.io/badge/requires--python-3.7+-red)
+Use to scan Ports and use carefully.Use the library in the terminal, because that's what it's focused on. If you don't want to use the terminal, run it in code, but then some new functions won't be present there.You will need to use it differently.
+# Help with using the library 
+## If you use the library directly in your code:
+ ```
+import SnakeScan
+SnakeScan.run()
+```
+- -l  need internet to view public ip you device
+- -t threading port search
+- -s single search ports
+- -i information about host
+- -help in host /-help port in host
+- -check [host] scan subnet in ip
+- exit in host or port off script
+
+## Watcher commands
+ ```
+ Watcher.start() - Starts checking ports
+ Watcher.stop() - Stops port checking
+ ```
+ ## Help with attributes
+```
+-P:
+snake -p 80,443 **Scanning specific ports**
+snake -p 80,3437,8080,20-30,79-443 **Scanning individual ports and ranges. If you use ranges, then one port from the beginning is not be taken into account. For example:80-443 then it will start with 81-443, so you need to enter it from 79-443, then it will be taken into account 
+snake -p 80,3437,10-0,20-10,443-79** **You can enter ranges the other way around: 80-443,443-80 but the first value will start one port higher**
+-H:
+**Displays a list of attribute usages**
+snake -h
+snake -help
+-SP:
+-sp:snake -sp **Uses selected pre-selected range and uses for scanning ProcessPoolExecutor**
+-V:
+snake -v **Shows the library version**
+-T:
+snake -t **Uses streams for port scanning**
+-CH:
+snake -ch **Scans the subnet for others IP**
+-L:
+snake -l **Shows your public internet IP address. Internet connection required for use**
+-I:
+snake www.google.com -i **Shows information about the IP address.Can receive information from IPV4 and IPV6**
+**You can also use all attributes in place:**
+```
+snake -p 100,200,79-443 www.google.com -i -l -t -ch -sp
+```
+# Library changes
+
+## Added class Watcher:
+ ```
+ from SnakeScan import Watcher
+ Watcher = Watcher(host="localhost",port="80",timeout=1)
+ Watcher.start()
+ ```
+ ## Added multiple use Watcher:
+ ```
+ from SnakeScan import Watcher
+ ports=[53,80,100,160]
+ Watchers=[]
+ for i in range(len(ports)):
+ Watchers.append(Watcher("127.0.0.1",ports[i]))
+ Watchers[i].start()
+ ```
+## Library added for use in terminal to use enter snake or Snake    
+```
+usage: snake [-h] [-sp] [-v] [-i] [-p PORTS] [-t] [-ch]
+             [-l]
+             [host]
+
+Snake - It's a command line module SnakeScan. Use him for
+more fast starting
+
+positional arguments:
+  host
+
+options:
+  -h, --help         show this help message and exit
+  -sp, --speed       speed scan
+  -v, --version      version
+  -i, --info         ip info
+  -p, --ports PORTS  range ports to scan host
+  -t, --thread       fast scan
+  -ch, --check       scan subnet
+  -l, --local        view you public ip - need internet
+```
+## Added Info about ipv6
+```
+snake 2001:db8:: -i or snake [2001:4860:4860::8888] -i
+```

{snakescan-1.6.4 → snakescan-1.6.6}/SnakeScan/CLI.py

@@ -66,7 +66,7 @@ ports = {
     8080: "Tomcat",
     10000: "Webmin",
 }
-version = "1.6.4"
+version = "1.6.6"
 
 
 def is_port_open(host, port):
@@ -92,28 +92,35 @@ def is_port_open_threads(host, port):
                 print(f"Closed{colored('|X|','red')}-->|{port}|")
         else:
             print(f"Open{colored('|√|','green')}-->{ports.get(port)}|{port}|")
+
+
 def Ports(str=""):
-    rangeports=[]
-    port=[]
-    str=str.split(",")
+    rangeports = []
+    rangeport = []
+    port = []
+    doneports = []
+    str = str.split(",")
     for p in range(len(str)):
-            if "-" in str[p]:
-                rangeports.append(str[p])
-            else:
-                port.append(str[p])
+        if "-" in str[p]:
+            rangeports.append(str[p])
+        else:
+            port.append(str[p])
     for n in range(len(port)):
         for i in string.punctuation:
             if i in port[n]:
-                port[n]=port[n].replace(i,"")
+                port[n] = port[n].replace(i, "")
     for r in range(len(rangeports)):
-        rangeport=rangeports[r].split("-")
+        rangeport = rangeports[r].split("-")
+        for i in range(len(rangeport)):
+            doneports.append(rangeport[i])
     try:
-          return rangeport,port
+        return doneports, port
     except Exception as e:
-        rangeport=""
-        return rangeport,port
+        rangeport = ""
+        return doneports, port
         sys.exit()
 
+
 def SnakeArgs():
     parser = argparse.ArgumentParser(
         description="Snake - It's a command line module SnakeScan. Use him for more fast starting"
@@ -158,45 +165,49 @@ if host.startswith("https://"):
 if host == "None":
     host = "localhost"
 if SnakeArgs().ports:
-    rangeports,port_user=Ports(port_user)
+    rangeports, port_user = Ports(port_user)
     for i in range(len(port_user)):
-        port_user[i]=int(port_user[i])
+        port_user[i] = int(port_user[i])
     for port in range(len(port_user)):
-            if is_port_open(host, port_user[port]):
+        if is_port_open(host, port_user[port]):
+            print(
+                f"Open{colored('|√|','green')}{host}-->{ports[port_user[port]]}|{port_user[port]}|"
+            )
+        else:
+            try:
                 print(
-                    f"Open{colored('|√|','green')}{host}-->{ports[port_user[port]]}|{port_user[port]}|"
+                    f"Closed{colored('|X|','red')}{host}-->{ports[port_user[port]]}|{port_user[port]}|"
                 )
-            else:
-                try:
-                    print(
-                        f"Closed{colored('|X|','red')}{host}-->{ports[port_user[port]]}|{port_user[port]}|"
-                    )
-                except:
-                    print(f"Closed{colored('|X|','red')}{host}-->|{port_user[port]}|")
+            except:
+                print(f"Closed{colored('|X|','red')}{host}-->|{port_user[port]}|")
     try:
-        if int(rangeports[0]) > int(rangeports[1]):
-            rangesave1=rangeports[0]
-            rangesave2=rangeports[1]
-            rangeports[1]=rangesave1
-            rangeports[0]=rangesave2
-        for port in tqdm(range(int(rangeports[0]) + 1, int(rangeports[1])+1)):
-            if is_port_open(host, port):
-                for name in ports:
-                    if port == name:
-                        OpenPorts = [port]
-                        portsopen += 1
+        first = rangeports[::2]
+        second = rangeports[1::2]
+        minimal = min(len(first), len(second))
+        for i in range(minimal):
+            if int(first[i]) > int(second[i]):
+                number = second[i]
+                second[i] = first[i]
+                first[i] = number
+        for i in range(minimal):
+            for port in tqdm(range(int(first[i]) + 1, int(second[i]) + 1)):
+                if is_port_open(host, port):
+                    for name in ports:
+                        if port == name:
+                            OpenPorts = [port]
+                            portsopen += 1
+                else:
+                    portsclosed += 1
+            if OpenPorts:
+                for i in OpenPorts:
+                    print(f"Open{colored('|√|','green')}-->{ports[i]}|{i}|")
+                print(f"{host}".center(60, "-"))
+                print(f"Closed{colored('|X|','red')}:{portsclosed}")
+                portsclosed = 0
+                print(f"Open{colored('|√|','green')}:{portsopen}")
+                portsopen = 0
+                print("-" * 60)
             else:
-                  portsclosed += 1
-        if OpenPorts:
-            for i in OpenPorts:
-                print(f"Open{colored('|√|','green')}-->{ports[i]}|{i}|")
-            print(f"{host}".center(60, "-"))
-            print(f"Closed{colored('|X|','red')}:{portsclosed}")
-            portsclosed = 0
-            print(f"Open{colored('|√|','green')}:{portsopen}")
-            portsopen = 0
-            print("-" * 60)
-        else:
                 print(f"{host}".center(60, "-"))
                 print(f"Closed{colored('|X|','red')}:{portsclosed}")
                 portsclosed = 0
@@ -204,6 +215,7 @@ if SnakeArgs().ports:
                 portsopen = 0
                 print("-" * 60)
     except Exception as e:
+        print(e)
         sys.exit()
 if SnakeArgs().check:
     Check_network(host)

{snakescan-1.6.4 → snakescan-1.6.6}/SnakeScan/Check_subnet.py

@@ -4,8 +4,11 @@ import platform
 import socket
 from termcolor import colored
 from concurrent.futures import ThreadPoolExecutor
+
 global threads
 threads = []
+
+
 def Check_network(host):
     def check_host(host):
         try:
@@ -25,6 +28,7 @@ def Check_network(host):
         except Exception as e:
             print(f"Check error {ip}: {e}")
             return False
+
     try:
         print("".center(60, "-"))
         try:
@@ -45,11 +49,11 @@ def Check_network(host):
         network = ipaddress.ip_network(network_str)
         print(f"Checking the IP addresses in the subset {network_str}...")
         with ThreadPoolExecutor(max_workers=None) as executor:
-                try:
-                    for ip in network.hosts():
-                        future = executor.submit(check_host, ip)
-                        future.result()        
-                except Exception as e:
-                    print(e)
+            try:
+                for ip in network.hosts():
+                    future = executor.submit(check_host, ip)
+                    future.result()
+            except Exception as e:
+                print(e)
     except ValueError as e:
         print(f"Error creating network object {e}")

{snakescan-1.6.4 → snakescan-1.6.6}/SnakeScan/__init__.py

@@ -1,6 +1,6 @@
-"""IPv4 address scanner for collecting address information.Use carefully for your network safety.Use to get IPV4 from IPV6  address.Don't use it to scan IPV6 because it's not designed for it. Scan only IPv4 or get the IPv4 address from the IPv6 host """
+"""IPv4 address scanner for collecting address information.Use carefully for your network safety.Use to get IPV4 from IPV6  address.Don't use it to scan IPV6 because it's not designed for it. Scan only IPv4 or get the IPv4 address from the IPv6 host"""
 
-__version__ = "1.6.4"
+__version__ = "1.6.6"
 import socket
 import ipaddress
 from art import tprint
@@ -12,35 +12,38 @@ from SnakeScan.Check_subnet import Check_network
 
 
 class Watcher:
-    def __init__(self, host, port_user, timeout = 1):
-        #Initialized class and variables host, port, and delay.
-        self.host = host #localhost
-        self.port_user = port_user #80
-        self.timeout = timeout #2 or 2.0
-        self.work = False # run value
+    def __init__(self, host, port_user, timeout=1):
+        # Initialized class and variables host, port, and delay.
+        self.host = host  # localhost
+        self.port_user = port_user  # 80
+        self.timeout = timeout  # 2 or 2.0
+        self.work = False  # run value
+
     def run(self):
-                #Basic process of connecting to a host and checking the port
-                previous = None
-                while self.work:
-                    try:
-                        with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as sock:
-                            connection = sock.connect_ex((self.host, self.port_user))
-                        if previous != connection:
-                            if connection == 0:
-                                print(f"Service is up {self.host}-->|{self.port_user}|")
-                            else:
-                                print(f"Service is down {self.host}-->|{self.port_user}|")
-                            previous = connection
-                    except Exception as e:
-                        print(f"Unable to create scanner object:{e}")
-                    sleep(self.timeout)
+        # Basic process of connecting to a host and checking the port
+        previous = None
+        while self.work:
+            try:
+                with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as sock:
+                    connection = sock.connect_ex((self.host, self.port_user))
+                if previous != connection:
+                    if connection == 0:
+                        print(f"Service is up {self.host}-->|{self.port_user}|")
+                    else:
+                        print(f"Service is down {self.host}-->|{self.port_user}|")
+                    previous = connection
+            except Exception as e:
+                print(f"Unable to create scanner object:{e}")
+            sleep(self.timeout)
+
     def start(self):
-        #Run a port check to see if it is running or offline.
+        # Run a port check to see if it is running or offline.
         self.work = True
         self.thread = Thread(target=self.run)
         self.thread.start()
+
     def stop(self):
-        #Stops port checking
+        # Stops port checking
         self.work = False
         self.thread.join()
 
@@ -49,11 +52,10 @@ def run():
     portsopen = 0
     portsclosed = 0
     Run_now = True
-    
-    
+
     global num
     num = 0
-    
+
     OpenPorts = []
     threads = []
     ports = {
@@ -98,26 +100,28 @@ def run():
         8080: "Tomcat",
         10000: "Webmin",
     }
+
     def Ports(str=""):
-        rangeports=[]
-        port=[]
-        str=str.split(",")
+        rangeports = []
+        port = []
+        str = str.split(",")
         for p in range(len(str)):
-                if "-" in str[p]:
-                    rangeports.append(str[p])
-                else:
-                    port.append(str[p])
+            if "-" in str[p]:
+                rangeports.append(str[p])
+            else:
+                port.append(str[p])
         for n in range(len(port)):
             for i in string.punctuation:
                 if i in port[n]:
-                    port[n]=port[n].replace(i,"")
+                    port[n] = port[n].replace(i, "")
         for r in range(len(rangeports)):
-            rangeport=rangeports[r].split("-")
+            rangeport = rangeports[r].split("-")
         try:
-              return rangeport,port
+            return rangeport, port
         except Exception as e:
             print("Error: invalid value")
             sys.exit()
+
     def is_port_open(host, port):
         with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
             try:
@@ -262,7 +266,6 @@ def run():
                         t.start()
                     for t in threads:
                         t.join()
-                
 
                 else:
                     if "-t" in port_user:
@@ -281,29 +284,29 @@ def run():
             length = port_user
         print(f"{colored('|!|','red')}Listening {host} please wait...")
         # |----------------starting---------------------|
-        rangeports,port_user=Ports(port_user)
+        rangeports, port_user = Ports(port_user)
         for i in range(len(port_user)):
-            port_user[i]=int(port_user[i])
+            port_user[i] = int(port_user[i])
         for port in range(len(port_user)):
-                if is_port_open(host, port_user[port]):
+            if is_port_open(host, port_user[port]):
+                print(
+                    f"Open{colored('|√|','green')}{host}-->{ports[port_user[port]]}|{port_user[port]}|"
+                )
+            else:
+                try:
                     print(
-                        f"Open{colored('|√|','green')}{host}-->{ports[port_user[port]]}|{port_user[port]}|"
+                        f"Closed{colored('|X|','red')}{host}-->{ports[port_user[port]]}|{port_user[port]}|"
                     )
-                else:
-                    try:
-                        print(
-                            f"Closed{colored('|X|','red')}{host}-->{ports[port_user[port]]}|{port_user[port]}|"
-                        )
-                    except:
-                        print(f"Closed{colored('|X|','red')}{host}-->|{port_user[port]}|")
-        for port in tqdm(range(int(rangeports[0]), int(rangeports[1])+1)):
+                except:
+                    print(f"Closed{colored('|X|','red')}{host}-->|{port_user[port]}|")
+        for port in tqdm(range(int(rangeports[0]), int(rangeports[1]) + 1)):
             if is_port_open(host, port):
                 for name in ports:
                     if port == name:
                         OpenPorts = [port]
                         portsopen += 1
             else:
-                  portsclosed += 1
+                portsclosed += 1
         if OpenPorts:
             for i in OpenPorts:
                 print(f"Open{colored('|√|','green')}-->{ports[i]}|{i}|")
@@ -314,9 +317,9 @@ def run():
             portsopen = 0
             print("-" * 60)
         else:
-                print(f"{host}".center(60, "-"))
-                print(f"Closed{colored('|X|','red')}:{portsclosed}")
-                portsclosed = 0
-                print(f"Open{colored('|√|','green')}:{portsopen}")
-                portsopen = 0
-                print("-" * 60)
+            print(f"{host}".center(60, "-"))
+            print(f"Closed{colored('|X|','red')}:{portsclosed}")
+            portsclosed = 0
+            print(f"Open{colored('|√|','green')}:{portsopen}")
+            portsopen = 0
+            print("-" * 60)

snakescan-1.6.4/README.md

@@ -1,74 +0,0 @@
-# SnakeScan
-![PyPI version](https://badge.fury.io/py/SnakeScan.svg)
-![Requires-python](https://img.shields.io/badge/requires--python-3.7+-red)
-![License](https://img.shields.io/badge/License-MIT-blue.svg)
- ```
-import SnakeScan
-SnakeScan.run()
-```
-## Help
-- -l  need internet to view public ip you device
-- -t threading port search
-- -s single search ports
-- -i information about host
-- -help in host /-help port in host
-- -check [host] scan subnet in ip
-- exit in host or port off script
-## Added class Watcher:
- ```
- from SnakeScan import Watcher
- Watcher = Watcher(host="localhost",port="80",timeout=1)
- Watcher.start()
- ```
- ## Watcher commands
- ```
- Watcher.start() - Starts checking ports
- Watcher.stop() - Stops port checking
- ## Added multiple use Watcher:
- ```
- from SnakeScan import Watcher
- ports=[53,80,100,160]
- Watchers=[]
- for i in range(len(ports)):
- Watchers.append(Watcher("127.0.0.1",ports[i]))
- Watchers[i].start()
- ```
-## Added CLI command line use snake or Snake
-```
-usage: snake [-h] [-sp] [-v] [-i] [-p PORTS] [-t] [-ch]
-             [-l]
-             [host]
-
-Snake - It's a command line module SnakeScan. Use him for
-more fast starting
-
-positional arguments:
-  host
-
-options:
-  -h, --help         show this help message and exit
-  -sp, --speed       speed scan
-  -v, --version      version
-  -i, --info         ip info
-  -p, --ports PORTS  range ports to scan host
-  -t, --thread       fast scan
-  -ch, --check       scan subnet
-  -l, --local        view you public ip - need internet
-```
-## Attributes snake-Snake
-```
--p:snake -p 80,443,3437,20-1000
--p:[20]-1000 will start from [21]-[1000]
--h:snake -h [snake usage]
--sp:snake -sp [use processpoolexecutir to scan host]
--v:snake -v [Build_version]
--t:snake -t [use thread pool to scan]
--ch:snake -ch [scan subnet in host]
--l:snake -l [view you public ip and to view need on internet]
--i:snake www.google.com -i [info ip of host]
-All:snake -p 100,200,79-443 www.google.com -i -l -t -ch -sp
-```
-## Added Info about ipv6
-```
-snake 2001:db8:: -i or snake [2001:4860:4860::8888] -i
-```