portune 0.1.2__py3-none-any.whl → 0.1.4__py3-none-any.whl

portune/portune.py

@@ -38,7 +38,9 @@ body {
     font-family: Arial, sans-serif;
     overflow: auto;
 }
-
+.hidden {
+    display: none;
+}
 .icon {
     border-radius: 25px;
     background-color: #444;
@@ -78,7 +80,16 @@ div {
     text-align: right;
     padding-right: 8px;
 }
-
+.desc {
+    text-overflow: ellipsis;
+    max-width: 300px;
+    white-space: nowrap;
+    overflow: hidden;
+}
+.desc:hover {
+    overflow: visible;
+    white-space: normal;
+}
 .table-container { 
     height: 90%;
     overflow-y: auto;
@@ -299,6 +310,7 @@ function toggleSort(table, colIndex, sortBtn) {
 }
 
 function applyFilters(table) {
+    table.classList.add('hidden');
     const rows = Array.from(table.querySelectorAll('tbody tr'));
     const filters = Array.from(table.querySelectorAll('.column-filter'))
         .map(filter => ({
@@ -313,10 +325,10 @@ function applyFilters(table) {
     // First apply filters
     const filteredRows = rows.filter(row => {
         // If no filters are active, show all rows
-        if (filters.every(f => !f.value)) {
-            row.style.display = '';
-            return true;
-        }
+        //if (filters.every(f => !f.value)) {
+        //    row.classList.remove('hidden');
+        //    return true;
+        //}
         const cells = row.cells;
         const shouldShow = !filters.some(filter => {
             if (!filter.value) return false;
@@ -324,7 +336,11 @@ function applyFilters(table) {
             if (filter.regexp) return !filter.regexp.test(cellText);
             return !cellText.toLowerCase().includes(filter.value);
         });
-        row.style.display = shouldShow ? '' : 'none';
+        if (shouldShow) {
+            row.classList.remove('hidden');
+        } else {
+            row.classList.add('hidden');
+        }
         return shouldShow;
     });
 
@@ -362,6 +378,7 @@ function applyFilters(table) {
         const tbody = table.querySelector('tbody');
         filteredRows.forEach(row => tbody.appendChild(row));
     }
+    table.classList.remove('hidden');
 }
 
 function processHtmlContent(element) {
@@ -600,6 +617,7 @@ def parse_input_file(filename: str) -> List[Tuple[str, List[int]]]:
         A list of tuples, each containing:
             - hostname (str): The target hostname or IP address
             - ports (List[int]): List of ports to scan for that host
+            - desc (str): Optional description for the host
 
     Examples:
         Input file format:
@@ -615,19 +633,26 @@ def parse_input_file(filename: str) -> List[Tuple[str, List[int]]]:
                 ('host3', [8080])
             ]
     """
-    hosts = []
+    host_dict = {}
     with open(filename, 'r') as f:
         for line in f:
-            line = line.strip().lower()
+            line = line.strip()
             if not line or line.startswith('#'):
                 continue
-            try:
-                host, ports = line.split()
-                port_list = [int(p) for p in ports.split(',')]
-                hosts.append((host, port_list))
-            except Exception:
-                hosts.append((line, [22]))  # Default port 22 if parsing fails
-                continue
+            words = line.split()
+            fqdn = words[0].lower()
+            ports = words[1] if len(words) > 1 else '22'
+            port_list = [int(p) for p in ports.split(',')]
+            desc = ' '.join(words[2:]).strip() if len(words) > 2 else ''
+            if fqdn in host_dict:
+                existing_ports, existing_desc = host_dict[fqdn]
+                host_dict[fqdn] = (list(set(existing_ports + port_list)), existing_desc or desc)
+            else:
+                host_dict[fqdn] = (port_list, desc)            
+    hosts = []
+    for fqdn in  host_dict:
+        ports, desc = host_dict[fqdn]
+        hosts.append((fqdn, sorted(ports), desc))
     return hosts
 
 def ping_host(ip: str, timeout: float = 2.0) -> bool:
@@ -698,7 +723,7 @@ def resolve_and_ping_host(hostname: str, timeout: float = 2.0, noping: bool = Fa
     except Exception:
         return hostname, {'ip': 'N/A', 'ping': False}
 
-def ping_hosts(hosts: List[Tuple[str, List[int]]], 
+def ping_hosts(hosts: List[Tuple[str, List[int], str]], 
              timeout: float = 2.0, 
              parallelism: int = 10, 
              noping: bool = False) -> Dict[str, Dict[str, Union[str, bool]]]:
@@ -739,7 +764,7 @@ def ping_hosts(hosts: List[Tuple[str, List[int]]],
     with ThreadPoolExecutor(max_workers=parallelism) as executor:
         future_to_host = {
             executor.submit(resolve_and_ping_host, hostname, timeout, noping): hostname
-            for hostname, _ in hosts
+            for hostname, _, _ in hosts
         }
         
         # Add callback to update progress bar when each future completes
@@ -760,7 +785,8 @@ def ping_hosts(hosts: List[Tuple[str, List[int]]],
 
 def check_port(hostname: str, 
              port: int, 
-             host_info: Dict[str, Union[str, bool]], 
+             host_info: Dict[str, Union[str, bool]],
+             desc: str,
              timeout: float = 2.0) -> Tuple[str, str, int, str, bool]:
     """Check if a specific TCP port is accessible on a host.
 
@@ -774,6 +800,7 @@ def check_port(hostname: str,
             - 'ip': IP address or 'N/A' if resolution failed
             - 'ping': Boolean indicating ping status
             - 'hostname': Optional resolved hostname from reverse DNS
+        desc: Optional description for the host
         timeout: Maximum time to wait for connection in seconds
 
     Returns:
@@ -783,6 +810,7 @@ def check_port(hostname: str,
             - port: The port number that was checked
             - status: Connection status (CONNECTED/TIMEOUT/REFUSED/UNREACHABLE)
             - ping: Boolean indicating if the host responded to ping
+            - desc: Optional description for the host
         
     Status meanings:
         CONNECTED: Successfully established TCP connection
@@ -792,7 +820,7 @@ def check_port(hostname: str,
         RESOLVE_FAIL: Could not resolve hostname to IP
     """
     if host_info['ip'] == 'N/A':
-        return (hostname, host_info['ip'], port, 'RESOLVE_FAIL', host_info['ping'])
+        return (hostname, host_info['ip'], port, 'RESOLVE_FAIL', host_info['ping'], desc)
     
     # Use resolved hostname if available
     display_hostname = host_info.get('hostname', hostname)
@@ -802,16 +830,16 @@ def check_port(hostname: str,
     try:
         s.connect((host_info['ip'], port))
         s.close()
-        return (display_hostname, host_info['ip'], port, 'CONNECTED', host_info['ping'])
+        return (display_hostname, host_info['ip'], port, 'CONNECTED', host_info['ping'], desc)
     except ConnectionAbortedError:
-        return (display_hostname, host_info['ip'], port, 'CONNECTED', host_info['ping'])
+        return (display_hostname, host_info['ip'], port, 'CONNECTED', host_info['ping'], desc)
     except (TimeoutError, socket.timeout):
-        return (display_hostname, host_info['ip'], port, 'TIMEOUT', host_info['ping'])
+        return (display_hostname, host_info['ip'], port, 'TIMEOUT', host_info['ping'], desc)
     except ConnectionRefusedError:
-        return (display_hostname, host_info['ip'], port, 'REFUSED', host_info['ping'])
+        return (display_hostname, host_info['ip'], port, 'REFUSED', host_info['ping'], desc)
     except Exception:
         # Handle other network errors (filtered, network unreachable, etc)
-        return (display_hostname, host_info['ip'], port, 'UNREACHABLE', host_info['ping'])
+        return (display_hostname, host_info['ip'], port, 'UNREACHABLE', host_info['ping'], desc)
 
 def send_email_report(
     output_file: str,
@@ -979,7 +1007,7 @@ def compute_stats(
 
 
     # Collect VLAN statistics for timeouts
-    for hostname, ip, port, status, _ in results:
+    for hostname, ip, port, status, _, _ in results:
         if ip != 'N/A':
             try:
                 vlan = get_vlan_base(ip, bits)
@@ -993,7 +1021,7 @@ def compute_stats(
     # Group results by hostname for host statistics
     host_stats = defaultdict(lambda: {'statuses': [], 'ping': False})
     for result in results:
-        hostname, _, _, status, ping = result
+        hostname, _, _, status, ping, _ = result
         host_stats[hostname]['statuses'].append(status)
         host_stats[hostname]['ping'] |= ping
 
@@ -1020,7 +1048,7 @@ def compute_stats(
         })
     })
     
-    for hostname, ip, port, status, _ in results:
+    for hostname, ip, port, status, _, _ in results:
         # For IP addresses, use VLAN/16 as domain
         try:
             socket.inet_aton(hostname)
@@ -1138,7 +1166,8 @@ def generate_html_report(
     parallelism: int,
     noping: bool,
     stats: Dict[str, Any],
-    input_file: str = ''
+    input_file: str = '',
+    desc_titles: List[str] = [],
 ) -> None:
     """Generate a complete HTML report of the port scan results.
 
@@ -1183,6 +1212,9 @@ def generate_html_report(
         f.write(f'<h3 class="icon">Port Accessibility Report from {HOSTNAME} ({MY_IP}) to {os.path.basename(input_file)} - {time.strftime("%Y-%m-%d %H:%M:%S", scan_time)}</h3>\n')
         
         # Write detailed results table
+        if not desc_titles:
+            _, _, _, _, _, desc = results[0]
+            desc_titles = ["Description" for d in desc.split("|")]
         f.write(f'''
         <div class="table-container" id="result-container">
             <table id="commandTable">
@@ -1194,13 +1226,14 @@ def generate_html_report(
                         <th>Port</th>
                         <th>Status</th>
                         <th>Ping</th>
+                        {"\n".join([f"<th>{d}</th>" for d in desc_titles])}
                     </tr>
                 </thead>
                 <tbody>
         ''')
 
         # Add result rows
-        for hostname, ip, port, status, ping in results:
+        for hostname, ip, port, status, ping, desc in results:
             ping_status = 'UP' if ping else 'N/A' if noping else 'DOWN'
             ping_class = 'green' if ping else 'blue' if noping else 'red'
             status_class = 'green' if status == 'CONNECTED' else 'blue' if status == 'REFUSED' else 'red'
@@ -1212,6 +1245,7 @@ def generate_html_report(
                     <td style="text-align: right;">{port}</td>
                     <td style="text-align: center;"><span class="{status_class} status">{escape(status)}</span></td>
                     <td style="text-align: center;"><span class="{ping_class} ping">{ping_status}</span></td>
+                    {"\n".join([f'<td class="desc">{escape(str(d))}</td>' for d in desc.split("|")])}
                 </tr>
             ''')
 
@@ -1374,7 +1408,7 @@ def format_table_output(
     table.append(separator)
     
     # Add data rows
-    for hostname, ip, port, status, ping in results:
+    for hostname, ip, port, status, ping, desc in results:
         ping_status = 'UP' if ping else 'N/A' if noping else 'DOWN'
         table.append(row_format.format(
             str(hostname), widths['Hostname'],
@@ -1395,7 +1429,7 @@ def main():
     parser.add_argument('-n', '--noping', action="store_true", help='No ping check')
     parser.add_argument('-s', '--summary', action="store_true", help='Print scan summary information')
     parser.add_argument('-b', '--bits', type=int, default=16, help='VLAN bits for timeout summary (default: 16)')
-
+    parser.add_argument('-d', '--desc_titles', type=str, nargs='*', help='List of custom description titles for hosts (optional)')
     # Email related arguments
     email_group = parser.add_argument_group('Email Options')
     email_group.add_argument('--email-to', help='Comma-separated list of email recipients')
@@ -1420,14 +1454,14 @@ def main():
     host_info = ping_hosts(hosts, args.timeout, args.parallelism, args.noping)
     
     # Calculate total tasks and initialize progress bar
-    total_tasks = sum(len(ports) for _, ports in hosts)
+    total_tasks = sum(len(ports) for _, ports, _ in hosts)
     print(f"Preparing to scan {len(hosts)} hosts with {total_tasks} total ports...", file=sys.stderr)
     
     # Prepare tasks with pre-resolved data
     tasks = []
-    for hostname, ports in hosts:
+    for hostname, ports, desc in hosts:
         for port in ports:
-            tasks.append((hostname, port, host_info[hostname]))
+            tasks.append((hostname, port, host_info[hostname], desc))
 
     results = []
     lock = threading.Lock()
@@ -1436,8 +1470,8 @@ def main():
     progress_bar = ProgressBar(total_tasks, prefix='Scanning')
     
     with ThreadPoolExecutor(max_workers=args.parallelism) as executor:
-        future_to_task = {executor.submit(check_port, hostname, port, info, args.timeout): (hostname, port, info) 
-                         for hostname, port, info in tasks}
+        future_to_task = {executor.submit(check_port, hostname, port, info, desc, args.timeout): (hostname, port, info) 
+                         for hostname, port, info, desc in tasks}
         
         for future in as_completed(future_to_task):
             res = future.result()
@@ -1453,7 +1487,17 @@ def main():
     
     # Generate report
     results.sort(key=lambda x: (x[0], x[2]))
-    generate_html_report(results, args.output, time.localtime(start_time), args.timeout, args.parallelism, args.noping, stats, args.input_file)
+    generate_html_report(
+        results,
+        args.output,
+        time.localtime(start_time),
+        args.timeout,
+        args.parallelism,
+        args.noping,
+        stats,
+        args.input_file,
+        args.desc_titles,
+    )
     
     # Print summary
     # Display detailed results in table format

portune/version.py

@@ -17,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.1.2'
-__version_tuple__ = version_tuple = (0, 1, 2)
+__version__ = version = '0.1.4'
+__version_tuple__ = version_tuple = (0, 1, 4)

{portune-0.1.2.dist-info → portune-0.1.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: portune
-Version: 0.1.2
+Version: 0.1.4
 Summary: Simple Python HTTP Exec Server
 Author: Franck Jouvanceau
 Maintainer: Franck Jouvanceau
@@ -58,7 +58,7 @@ Multitreaded port scanner
 
 # features
 
-* parallel check of port availability against server/ports
+* parallel check of port availability against servers/ports
 * console output result / summary
 * html full report / dns domain summary / vlan timeout summary
 * mail with html summary / report attachment (mailhost relay)

portune-0.1.4.dist-info/RECORD

@@ -0,0 +1,9 @@
+portune/__init__.py,sha256=RfXuNfHBqfRt_z4IukwN1a0oeCXahuMOO8_eBt4T8NM,58
+portune/portune.py,sha256=Ar5GLB8hCTV9C1NbFKRKoK2nlyRReiDz5uMK5yXmb28,63495
+portune/version.py,sha256=hcPkC9vIGgfrKK6ft7ysLT7iOCjpFmCBmyKLmXiaZ1g,511
+portune-0.1.4.dist-info/licenses/LICENSE,sha256=gRJf0JPT_wsZJsUGlWPTS8Vypfl9vQ1qjp6sNbKykuA,1064
+portune-0.1.4.dist-info/METADATA,sha256=qtTM2_95cVJjfAELw9v7QP7hQijJUotJEGnC2SGq2hQ,2838
+portune-0.1.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+portune-0.1.4.dist-info/entry_points.txt,sha256=6j7jAf5fOZrLPbVIs3z92R1tT891WyY9YxQ6OVnPKG0,80
+portune-0.1.4.dist-info/top_level.txt,sha256=CITDikHhRKAsSOGmNJzD-xSp6D5iBhSr9ZS1qy8-SL0,8
+portune-0.1.4.dist-info/RECORD,,

portune-0.1.2.dist-info/RECORD

@@ -1,9 +0,0 @@
-portune/__init__.py,sha256=RfXuNfHBqfRt_z4IukwN1a0oeCXahuMOO8_eBt4T8NM,58
-portune/portune.py,sha256=ODPpO7E9-pXoFRxKavyn22_b9dhVjxUp-aIxKhnxamY,61908
-portune/version.py,sha256=bSmADqydH8nBu-J4lG8UVuR7hnU_zcwhnSav2oQ0W0A,511
-portune-0.1.2.dist-info/licenses/LICENSE,sha256=gRJf0JPT_wsZJsUGlWPTS8Vypfl9vQ1qjp6sNbKykuA,1064
-portune-0.1.2.dist-info/METADATA,sha256=qEkffZiY8znnWihHuYtJlzf7t4bRPFTPvCcajLqmYBs,2837
-portune-0.1.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-portune-0.1.2.dist-info/entry_points.txt,sha256=6j7jAf5fOZrLPbVIs3z92R1tT891WyY9YxQ6OVnPKG0,80
-portune-0.1.2.dist-info/top_level.txt,sha256=CITDikHhRKAsSOGmNJzD-xSp6D5iBhSr9ZS1qy8-SL0,8
-portune-0.1.2.dist-info/RECORD,,