SnakeScan 1.6.3__tar.gz → 1.6.5__tar.gz

{snakescan-1.6.3 → snakescan-1.6.5}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: SnakeScan
-Version: 1.6.3
-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. 
+Version: 1.6.5
+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
@@ -14,9 +14,11 @@ Project-URL: Homepage, https://github.com/Den-Ram/SnakeScan
 Project-URL: Repository, https://github.com/Den-Ram/SnakeScan
 
 # SnakeScan
+Use to scan Ports and use carefully
 ![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)
+This is the final release version, which already has full functionality. Further work will include bug fixes and the creation of more user-friendly documentation for the code and functions. AI was not used in this code.It was used only to gain knowledge on how to implement this. After all, I did not find more convenient libraries for port scanning on the Internet, so the library was created to make scanning easier. If you want, you can improve it at your discretion. Enjoy using it! \|•√•|/
  ```
 import SnakeScan
 SnakeScan.run()
@@ -24,21 +26,30 @@ 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:
  ```
- for SnakeScan import Watcher
- Watcher(host:str,port:int)
+ 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)):
- Watcher("127.0.0.1",ports[i])
+ Watchers.append(Watcher("127.0.0.1",ports[i]))
+ Watchers[i].start()
  ```
 ## Added CLI command line use snake or Snake
 ```
@@ -62,10 +73,19 @@ options:
   -ch, --check       scan subnet
   -l, --local        view you public ip - need internet
 ```
-## Attributes
+## Attributes snake-Snake
+```
+-p:snake -p 80,443,3437,20-1000,300-400
+-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
 ```
---p:snake -p 80,443,3437,20-1000
---p:[20]-1000 will start from [21]-[1000]
 ## Added Info about ipv6
 ```
 snake 2001:db8:: -i or snake [2001:4860:4860::8888] -i

snakescan-1.6.5/README.md

@@ -0,0 +1,77 @@
+# SnakeScan
+Use to scan Ports and use carefully
+![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)
+This is the final release version, which already has full functionality. Further work will include bug fixes and the creation of more user-friendly documentation for the code and functions. AI was not used in this code.It was used only to gain knowledge on how to implement this. After all, I did not find more convenient libraries for port scanning on the Internet, so the library was created to make scanning easier. If you want, you can improve it at your discretion. Enjoy using it! \|•√•|/
+ ```
+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,300-400
+-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.3 → snakescan-1.6.5}/SnakeScan/CLI.py

@@ -66,7 +66,7 @@ ports = {
     8080: "Tomcat",
     10000: "Webmin",
 }
-version = "1.6.2"
+version = "1.6.5"
 
 
 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,44 @@ 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):
+            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

{snakescan-1.6.3 → snakescan-1.6.5}/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.3 → snakescan-1.6.5}/SnakeScan/__init__.py

@@ -1,9 +1,10 @@
-"""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. """
+"""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.3"
+__version__ = "1.6.5"
 import socket
 import ipaddress
 from art import tprint
+from time import sleep
 from tqdm import tqdm
 from termcolor import colored
 from threading import Thread
@@ -11,35 +12,50 @@ from SnakeScan.Check_subnet import Check_network
 
 
 class Watcher:
-    def __init__(self, host, port_user):
-        self.host = host
-        self.port_user = port_user
+    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(host, port_user):
-            previous = None
-            while True:
+    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((host, port_user))
+                    connection = sock.connect_ex((self.host, self.port_user))
                 if previous != connection:
                     if connection == 0:
-                        print(f"Service is up {host}-->|{port_user}|")
+                        print(f"Service is up {self.host}-->|{self.port_user}|")
                     else:
-                        print(f"Service is down {host}-->|{port_user}|")
+                        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)
 
-        w = Thread(target=run, kwargs={"host": self.host, "port_user": self.port_user})
-        w.start()
+    def start(self):
+        # 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
+        self.work = False
+        self.thread.join()
 
 
 def run():
     portsopen = 0
     portsclosed = 0
     Run_now = True
-    
-    
+
     global num
     num = 0
-    
+
     OpenPorts = []
     threads = []
     ports = {
@@ -84,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:
@@ -248,7 +266,6 @@ def run():
                         t.start()
                     for t in threads:
                         t.join()
-                
 
                 else:
                     if "-t" in port_user:
@@ -267,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}|")
@@ -300,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.3/README.md

@@ -1,57 +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
-- -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:
- ```
- for SnakeScan import Watcher
- Watcher(host:str,port:int)
- ```
- ## Added multiple use Watcher:
- ```
- from SnakeScan import Watcher
- ports=[53,80,100,160]
- for i in range(len(ports)):
- Watcher("127.0.0.1",ports[i])
- ```
-## 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
-```
---p:snake -p 80,443,3437,20-1000
---p:[20]-1000 will start from [21]-[1000]
-## Added Info about ipv6
-```
-snake 2001:db8:: -i or snake [2001:4860:4860::8888] -i
-```