kport 2.0.0__py3-none-any.whl → 2.1.1__py3-none-any.whl

{kport-2.0.0.dist-info → kport-2.1.1.dist-info}/METADATA

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: kport
-Version: 2.0.0
+Version: 2.1.1
 Summary: A cross-platform command-line tool to inspect and kill processes using specific ports
 Home-page: https://github.com/farman20ali/port-killer
-Author: Farman Ali (Alien)
-Author-email: farman20ali@example.com
+Author: Farman Ali
+Author-email: farman20ali@gmail.com
 Project-URL: Bug Reports, https://github.com/farman20ali/port-killer/issues
 Project-URL: Source, https://github.com/farman20ali/port-killer
 Keywords: port,kill,process,network,cross-platform,cli
@@ -42,16 +42,24 @@ Dynamic: summary
 
 # 🔪 kport - Cross-Platform Port Inspector and Killer
 
+[![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)](https://github.com/farman20ali/port-killer)
+[![Python](https://img.shields.io/badge/python-3.6+-blue.svg)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)](https://github.com/farman20ali/port-killer)
+
 A simple, powerful command-line tool to inspect and kill processes using specific ports on Windows, Linux, and macOS.
 
 ## ✨ Features
 
 - 🔍 **Inspect ports** - Find which process is using a specific port
+- 🔎 **Inspect multiple ports** - Check multiple ports at once
+- 🔍 **Inspect port range** - Scan a range of ports (e.g., 3000-3010)
 - 🔎 **Inspect by process name** - Find all processes matching a name and their ports
 - 🔪 **Kill processes** - Terminate processes using specific ports
-- 📋 **List all ports** - View all listening ports and their processes
+- 💥 **Kill port range** - Terminate processes on a range of ports
+- 🔫 **Kill multiple ports** - Kill processes on multiple ports at once
 - 🎯 **Kill by process name** - Kill all processes matching a name (e.g., "node", "python")
-- 🔥 **Kill multiple ports** - Kill processes on multiple ports at once
+- 📋 **List all ports** - View all listening ports and their processes
 - 🎨 **Colorized output** - Easy-to-read colored terminal output
 - ✅ **Confirmation prompts** - Safety confirmation before killing processes
 - 🌍 **Cross-platform** - Works on Windows, Linux, and macOS
@@ -62,13 +70,17 @@ A simple, powerful command-line tool to inspect and kill processes using specifi
 ### Quick Install (Once Published to PyPI)
 
 ```bash
+# Recommended: Install to user directory
+pip install --user kport
+
+# Or install system-wide (requires admin/sudo)
 pip install kport
 ```
 
 ### Install from GitHub
 
 ```bash
-pip install git+https://github.com/farman20ali/port-killer.git
+pip install --user git+https://github.com/farman20ali/port-killer.git
 ```
 
 ### Install from Source
@@ -78,7 +90,10 @@ pip install git+https://github.com/farman20ali/port-killer.git
 git clone https://github.com/farman20ali/port-killer.git
 cd port-killer
 
-# Install
+# Install to user directory (recommended)
+pip install --user .
+
+# Or install system-wide (requires admin/sudo)
 pip install .
 ```
 
@@ -86,7 +101,7 @@ pip install .
 
 ```bash
 # Install in editable mode
-pip install -e .
+pip install --user -e .
 ```
 
 After installation, `kport` will be available globally in your terminal.
@@ -98,6 +113,8 @@ After installation, `kport` will be available globally in your terminal.
 python kport.py -h
 ```
 
+> 💡 **Tip:** If `kport` command doesn't work after installation, see [TROUBLESHOOTING.md](TROUBLESHOOTING.md)
+>
 > 📖 For detailed installation instructions, see [INSTALL.md](INSTALL.md)
 > 
 > 🚀 For publishing instructions, see [PUBLISH.md](PUBLISH.md)
@@ -150,6 +167,48 @@ PID        Process                   Port       State
 ✓ Total connections: 3
 ```
 
+### Inspect multiple ports
+
+Check multiple ports at once:
+
+```bash
+kport -im 3000 3001 8080 8081
+```
+
+Example output:
+```
+🔍 Inspecting 4 port(s)...
+
+Port       PID        Process                       
+────────────────────────────────────────────────────────────
+3000       12345      node.exe                      
+3001       12346      node.exe                      
+8080       12347      python.exe                    
+
+✓ Found processes on 3/4 port(s)
+```
+
+### Inspect port range
+
+Scan a range of ports:
+
+```bash
+kport -ir 3000-3010
+```
+
+Example output:
+```
+🔍 Inspecting port range 3000-3010 (11 ports)...
+
+Port       PID        Process                       
+────────────────────────────────────────────────────────────
+3000       12345      node.exe                      
+3001       12346      node.exe                      
+3005       12347      python.exe                    
+
+✓ Found processes on 3/11 port(s) in range
+```
+
 ### Kill a process on a port
 
 Terminate the process using a specific port:
@@ -249,6 +308,34 @@ Are you sure you want to kill 3 process(es)? (y/N): y
 Ports freed: 3000, 3001, 3002
 ```
 
+### Kill port range
+
+Kill all processes on a range of ports:
+
+```bash
+kport -kr 3000-3010
+```
+
+Example output:
+```
+🔪 Killing processes on port range 3000-3010 (11 ports)...
+
+Found processes on 3 port(s) in range:
+──────────────────────────────────────────────────
+  Port 3000: PID 12345 (node.exe)
+  Port 3001: PID 12346 (node.exe)
+  Port 3005: PID 12347 (python.exe)
+
+Are you sure you want to kill 3 process(es)? (y/N): y
+
+✓ Killed process on port 3000 (PID 12345)
+✓ Killed process on port 3001 (PID 12346)
+✓ Killed process on port 3005 (PID 12347)
+
+✓ Successfully killed 3/3 process(es)
+Ports freed: 3000, 3001, 3005
+```
+
 ### Show help
 
 ```bash
@@ -266,10 +353,13 @@ kport -v
 | Option | Long Form | Description |
 |--------|-----------|-------------|
 | `-i PORT` | `--inspect PORT` | Inspect which process is using the specified port |
+| `-im PORT [PORT ...]` | `--inspect-multiple PORT [PORT ...]` | Inspect multiple ports at once |
+| `-ir RANGE` | `--inspect-range RANGE` | Inspect port range (e.g., 3000-3010) |
 | `-ip NAME` | `--inspect-process NAME` | Inspect all processes matching the given name and their ports |
 | `-k PORT` | `--kill PORT` | Kill the process using the specified port |
 | `-kp NAME` | `--kill-process NAME` | Kill all processes matching the given name |
 | `-ka PORT [PORT ...]` | `--kill-all PORT [PORT ...]` | Kill processes on multiple ports at once |
+| `-kr RANGE` | `--kill-range RANGE` | Kill processes on port range (e.g., 3000-3010) |
 | `-l` | `--list` | List all listening ports and their processes |
 | `-v` | `--version` | Show version information |
 | `-h` | `--help` | Show help message |

kport-2.1.1.dist-info/RECORD

@@ -0,0 +1,7 @@
+kport.py,sha256=v477f5G3vcvW9SpKmx27agTIzqVXXrB6xM5kK8S39Y4,24192
+kport-2.1.1.dist-info/licenses/LICENSE,sha256=QQ8MyuCI55RKsPJcc50I2sT59jvpRtD9kvA031BtYs8,1083
+kport-2.1.1.dist-info/METADATA,sha256=-cY-7DN_BeBvIXKDQ9I8rerFxSJs6JpmqinwPP_3RjQ,13427
+kport-2.1.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+kport-2.1.1.dist-info/entry_points.txt,sha256=ppZIgJ1vrmYs2EO9NcVSFCaZj7oj7t6RnJo8ArPQiRo,37
+kport-2.1.1.dist-info/top_level.txt,sha256=yzlMBPZ7a-pcCN4DR5MRPO-VjY3fWnILtFUQpEuA2xY,6
+kport-2.1.1.dist-info/RECORD,,

kport.py

@@ -50,6 +50,35 @@ def validate_port(port):
         sys.exit(1)
 
 
+def parse_port_range(port_range):
+    """Parse port range string (e.g., '3000-3010') into list of ports"""
+    try:
+        if '-' in port_range:
+            start, end = port_range.split('-')
+            start_port = int(start.strip())
+            end_port = int(end.strip())
+            
+            if start_port > end_port:
+                print(colorize(f"Error: Invalid range {port_range}. Start port must be less than end port.", Colors.RED))
+                sys.exit(1)
+            
+            if end_port - start_port > 1000:
+                print(colorize(f"Error: Range too large ({end_port - start_port} ports). Maximum 1000 ports allowed.", Colors.RED))
+                sys.exit(1)
+            
+            ports = list(range(start_port, end_port + 1))
+            for port in ports:
+                validate_port(port)
+            return ports
+        else:
+            port = int(port_range)
+            validate_port(port)
+            return [port]
+    except ValueError:
+        print(colorize(f"Error: Invalid port or range format: {port_range}", Colors.RED))
+        sys.exit(1)
+
+
 def find_pid(port):
     """Find process ID using given port"""
     system = platform.system()
@@ -230,16 +259,23 @@ def main():
     parser = argparse.ArgumentParser(
         description="🔪 kport - Cross-platform port inspector and killer",
         epilog="Examples:\n"
-               "  kport -i 8080              Inspect port 8080\n"
-               "  kport -ip node             Inspect all processes matching 'node'\n"
-               "  kport -k 8080              Kill process using port 8080\n"
-               "  kport -l                   List all listening ports\n"
-               "  kport -kp node             Kill all processes matching 'node'\n"
-               "  kport -ka 3000 3001 3002   Kill processes on multiple ports\n",
+               "  kport -i 8080                  Inspect port 8080\n"
+               "  kport -im 3000 3001 3002       Inspect multiple ports\n"
+               "  kport -ir 3000-3010            Inspect port range\n"
+               "  kport -ip node                 Inspect all processes matching 'node'\n"
+               "  kport -k 8080                  Kill process using port 8080\n"
+               "  kport -ka 3000 3001 3002       Kill processes on multiple ports\n"
+               "  kport -kr 3000-3010            Kill processes on port range\n"
+               "  kport -kp node                 Kill all processes matching 'node'\n"
+               "  kport -l                       List all listening ports\n",
         formatter_class=argparse.RawDescriptionHelpFormatter
     )
     parser.add_argument("-i", "--inspect", type=int, metavar="PORT", 
                        help="Inspect which process is using the specified port")
+    parser.add_argument("-im", "--inspect-multiple", type=int, nargs="+", metavar="PORT",
+                       help="Inspect multiple ports")
+    parser.add_argument("-ir", "--inspect-range", type=str, metavar="RANGE",
+                       help="Inspect port range (e.g., 3000-3010)")
     parser.add_argument("-ip", "--inspect-process", type=str, metavar="NAME",
                        help="Inspect all processes matching the given name")
     parser.add_argument("-k", "--kill", type=int, metavar="PORT",
@@ -248,20 +284,67 @@ def main():
                        help="Kill all processes matching the given name")
     parser.add_argument("-ka", "--kill-all", type=int, nargs="+", metavar="PORT",
                        help="Kill processes on multiple ports")
+    parser.add_argument("-kr", "--kill-range", type=str, metavar="RANGE",
+                       help="Kill processes on port range (e.g., 3000-3010)")
     parser.add_argument("-l", "--list", action="store_true",
                        help="List all listening ports and their processes")
-    parser.add_argument("-v", "--version", action="version", version="kport 2.0.0")
+    parser.add_argument("-v", "--version", action="version", version="kport 2.1.1")
 
     args = parser.parse_args()
 
     # If no arguments provided, show help
-    if not (args.inspect or args.inspect_process or args.kill or args.list or args.kill_process or args.kill_all):
+    if not (args.inspect or args.inspect_multiple or args.inspect_range or args.inspect_process or 
+            args.kill or args.list or args.kill_process or args.kill_all or args.kill_range):
         parser.print_help()
         sys.exit(0)
 
     if args.list:
         list_all_ports()
 
+    if args.inspect_multiple:
+        print(colorize(f"\n🔍 Inspecting {len(args.inspect_multiple)} port(s)...\n", Colors.CYAN + Colors.BOLD))
+        
+        results = []
+        for port in args.inspect_multiple:
+            validate_port(port)
+            pid, info = find_pid(port)
+            if pid:
+                proc_name = get_process_name(pid)
+                results.append((port, pid, proc_name))
+        
+        if not results:
+            print(colorize(f"❌ No processes found on any of the specified ports", Colors.RED))
+        else:
+            print(colorize(f"{'Port':<10} {'PID':<10} {'Process':<30}", Colors.BOLD))
+            print("─" * 60)
+            
+            for port, pid, proc_name in results:
+                print(f"{colorize(str(port), Colors.CYAN):<19} {pid:<10} {proc_name:<30}")
+            
+            print(colorize(f"\n✓ Found processes on {len(results)}/{len(args.inspect_multiple)} port(s)", Colors.GREEN))
+
+    if args.inspect_range:
+        ports = parse_port_range(args.inspect_range)
+        print(colorize(f"\n🔍 Inspecting port range {args.inspect_range} ({len(ports)} ports)...\n", Colors.CYAN + Colors.BOLD))
+        
+        results = []
+        for port in ports:
+            pid, info = find_pid(port)
+            if pid:
+                proc_name = get_process_name(pid)
+                results.append((port, pid, proc_name))
+        
+        if not results:
+            print(colorize(f"❌ No processes found in port range {args.inspect_range}", Colors.RED))
+        else:
+            print(colorize(f"{'Port':<10} {'PID':<10} {'Process':<30}", Colors.BOLD))
+            print("─" * 60)
+            
+            for port, pid, proc_name in results:
+                print(f"{colorize(str(port), Colors.CYAN):<19} {pid:<10} {proc_name:<30}")
+            
+            print(colorize(f"\n✓ Found processes on {len(results)}/{len(ports)} port(s) in range", Colors.GREEN))
+
     if args.inspect_process:
         print(colorize(f"\n🔍 Inspecting processes matching '{args.inspect_process}'...\n", Colors.CYAN + Colors.BOLD))
         
@@ -381,6 +464,50 @@ def main():
             print(colorize(f"\n✓ Successfully killed {killed_count}/{len(port_pid_map)} process(es)", Colors.GREEN + Colors.BOLD))
             print(colorize(f"Ports freed: {', '.join(map(str, port_pid_map.keys()))}", Colors.GREEN))
 
+    if args.kill_range:
+        ports = parse_port_range(args.kill_range)
+        print(colorize(f"\n🔪 Killing processes on port range {args.kill_range} ({len(ports)} ports)...\n", Colors.CYAN + Colors.BOLD))
+        
+        # Find all PIDs in range
+        port_pid_map = {}
+        for port in ports:
+            pid, info = find_pid(port)
+            if pid:
+                port_pid_map[port] = (pid, info)
+        
+        if not port_pid_map:
+            print(colorize(f"❌ No processes found in port range {args.kill_range}", Colors.RED))
+        else:
+            print(colorize(f"Found processes on {len(port_pid_map)} port(s) in range:", Colors.YELLOW))
+            print("─" * 50)
+            
+            for port, (pid, info) in port_pid_map.items():
+                proc_name = get_process_name(pid)
+                print(colorize(f"  Port {port}: PID {pid} ({proc_name})", Colors.WHITE))
+            
+            # Ask for confirmation
+            try:
+                confirm = input(colorize(f"\nAre you sure you want to kill {len(port_pid_map)} process(es)? (y/N): ", Colors.MAGENTA))
+                if confirm.lower() not in ['y', 'yes']:
+                    print(colorize("Operation cancelled.", Colors.YELLOW))
+                    sys.exit(0)
+            except KeyboardInterrupt:
+                print(colorize("\n\nOperation cancelled.", Colors.YELLOW))
+                sys.exit(0)
+            
+            # Kill all processes
+            killed_count = 0
+            for port, (pid, info) in port_pid_map.items():
+                result = kill_pid(pid, silent=True)
+                if result or "SUCCESS" in str(result) or "killed" in str(result).lower():
+                    killed_count += 1
+                    print(colorize(f"✓ Killed process on port {port} (PID {pid})", Colors.GREEN))
+                else:
+                    print(colorize(f"✗ Failed to kill process on port {port} (PID {pid})", Colors.RED))
+            
+            print(colorize(f"\n✓ Successfully killed {killed_count}/{len(port_pid_map)} process(es)", Colors.GREEN + Colors.BOLD))
+            print(colorize(f"Ports freed: {', '.join(map(str, port_pid_map.keys()))}", Colors.GREEN))
+
     if args.inspect:
         validate_port(args.inspect)
         print(colorize(f"\n🔍 Inspecting port {args.inspect}...\n", Colors.CYAN + Colors.BOLD))

kport-2.0.0.dist-info/RECORD

@@ -1,7 +0,0 @@
-kport.py,sha256=pAqmxwtRO0FxyjYek9yFZDNBAeG1k8071h_ghGf5DiA,18043
-kport-2.0.0.dist-info/licenses/LICENSE,sha256=QQ8MyuCI55RKsPJcc50I2sT59jvpRtD9kvA031BtYs8,1083
-kport-2.0.0.dist-info/METADATA,sha256=m5wW2TWDKHoZ7HRFmqEbJVH_4wdJ0Q40wzFBbF_DArM,10182
-kport-2.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-kport-2.0.0.dist-info/entry_points.txt,sha256=ppZIgJ1vrmYs2EO9NcVSFCaZj7oj7t6RnJo8ArPQiRo,37
-kport-2.0.0.dist-info/top_level.txt,sha256=yzlMBPZ7a-pcCN4DR5MRPO-VjY3fWnILtFUQpEuA2xY,6
-kport-2.0.0.dist-info/RECORD,,