chore: bump version to 1.0.1 and modernize to Python 3.10+

BREAKING CHANGE: Now requires Python 3.10 or higher

- Updated Python requirement from 3.8+ to 3.10+
- Modernized type hints using built-in types (str | None, dict[], list[])
- Removed legacy typing imports (Optional, Dict, List)
- Updated GitHub Actions to test only Python 3.10, 3.11, 3.12, 3.13
- Updated all documentation to reflect new Python requirement

This change ensures Windows CI tests pass and positions the project
for the future with cleaner, more maintainable code.

Author: IBN5100-0

.github/workflows/tests.yml

@@ -13,8 +13,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
-        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12']
-        # Note: Python 3.13 not yet fully supported by GitHub Actions
+        python-version: ['3.10', '3.11', '3.12', '3.13']
 
     steps:
     - uses: actions/checkout@v3

CONTRIBUTING.md

@@ -62,7 +62,7 @@ If applicable, add screenshots to help explain your problem.
 
 **Environment:**
  - OS: [e.g. Windows 10, Ubuntu 22.04]
- - Python Version: [e.g. 3.9.7]
+ - Python Version: [e.g. 3.10.0 or higher]
  - nmap Version: [e.g. 7.92]
  - Simple LAN Scanner Version: [e.g. 1.0.0]
 

README.md

@@ -1,7 +1,8 @@
 # Simple LAN Scanner
 
+[![CI](https://github.com/IBN5100-0/simple-lan-scanner/actions/workflows/tests.yml/badge.svg)](https://github.com/IBN5100-0/simple-lan-scanner/actions/workflows/tests.yml)
 [![PyPI](https://img.shields.io/pypi/v/simple-lan-scanner.svg)](https://pypi.org/project/simple-lan-scanner/)
-[![Python](https://img.shields.io/badge/python-3.8%2B-blue)](https://www.python.org/downloads/)
+[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org/downloads/)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![Requires nmap](https://img.shields.io/badge/requires-nmap-orange.svg)](https://nmap.org/)
 [![Documentation](https://img.shields.io/badge/docs-latest-brightgreen)](docs/DOCUMENTATION.md)
@@ -41,7 +42,7 @@ pip install -e .[cli]
 
 ### Requirements
 
-- Python 3.8+
+- Python 3.10+
 - [nmap](https://nmap.org/download.html) installed and in PATH
 
 ### Basic Usage

docs/DOCUMENTATION.md

@@ -2,7 +2,7 @@
 
 [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![Version](https://img.shields.io/badge/version-1.0.0-green.svg)](https://github.com/IBN5100-0/simple-lan-scanner/releases/tag/v1.0.0)
-[![Python 3.7+](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![nmap required](https://img.shields.io/badge/requires-nmap-orange.svg)](https://nmap.org/)
 
 ## Table of Contents
@@ -53,7 +53,7 @@ The tool leverages the power of nmap for accurate network scanning while providi
 
 ### Prerequisites
 
-1. **Python 3.7 or higher**
+1. **Python 3.10 or higher**
    ```bash
    python --version  # Verify Python installation
    ```

pyproject.toml

@@ -1,21 +1,19 @@
 [project]
 name = "simple_lan_scanner"
-version = "1.0.0"
+version = "1.0.1"
 description = "A Python LAN scanning tool that uses nmap to discover devices on the local network"
 authors = [
     {name = "Adam Zalewski", email = "me@yamero.online"}
 ]
 license = {text = "MIT"}
 readme = "README.md"
-requires-python = ">=3.8"
+requires-python = ">=3.10"
 keywords = ["network", "scanner", "nmap", "lan", "monitoring"]
 classifiers = [
     "Development Status :: 5 - Production/Stable",
     "Intended Audience :: System Administrators",
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",

src/simple_scanner/gui.py

@@ -4,7 +4,7 @@
 from tkinter import ttk, filedialog, messagebox
 import datetime
 import threading
-from typing import Optional, Dict, Any
+from typing import Any
 import os
 import json
 from pathlib import Path
@@ -16,7 +16,7 @@
 class ModernSettingsDialog(tk.Toplevel):
     """Modern settings dialog with tabs and better organization."""
 
-    def __init__(self, parent: tk.Tk, settings: Dict[str, Any]) -> None:
+    def __init__(self, parent: tk.Tk, settings: dict[str, Any]) -> None:
         super().__init__(parent)
         self.title("Settings")
         self.geometry("600x500")
@@ -359,7 +359,7 @@ def __init__(self) -> None:
         self._running = False
         self._devices_cache: list[Device] = []
         self._last_device_count = 0
-        self.monitor: Optional[NetworkMonitor] = None
+        self.monitor: NetworkMonitor | None = None
         self.online_only_var = tk.BooleanVar(value=False)
 
         self._create_menu()
@@ -746,7 +746,7 @@ def _show_about(self) -> None:
                            "A modern network discovery tool\n\n"
                            "Built with Python and Tkinter")
 
-    def _load_settings(self) -> Dict[str, Any]:
+    def _load_settings(self) -> dict[str, Any]:
         """Load settings from disk or return defaults."""
         settings_file = get_user_data_dir() / "gui_settings.json"
 

src/simple_scanner/models.py

@@ -1,33 +1,32 @@
 import datetime
 from dataclasses import dataclass, field
-from typing import Optional
 
 @dataclass
 class Device:
     """Represents a network device discovered via nmap ping scan."""
     mac_address: str
     ip_address: str
-    hostname: Optional[str] = None
-    manufacturer: Optional[str] = None
+    hostname: str | None = None
+    manufacturer: str | None = None
     date_added: datetime.datetime = field(default_factory=lambda: datetime.datetime.now(datetime.timezone.utc))
     last_seen: datetime.datetime = field(default_factory=lambda: datetime.datetime.now(datetime.timezone.utc))
 
     def __post_init__(self):
         """Normalize MAC address to lowercase."""
         self.mac_address = self.mac_address.lower()
 
-    def update_last_seen(self, timestamp: Optional[datetime.datetime] = None) -> None:
+    def update_last_seen(self, timestamp: datetime.datetime | None = None) -> None:
         self.last_seen = timestamp or datetime.datetime.now(datetime.timezone.utc)
 
     def update_ip_address(self, ip_address: str) -> None:
         """Update the IP address (useful for DHCP changes)."""
         self.ip_address = ip_address
 
-    def update_hostname(self, hostname: Optional[str]) -> None:
+    def update_hostname(self, hostname: str | None) -> None:
         """Update the hostname."""
         self.hostname = hostname
 
-    def update_manufacturer(self, manufacturer: Optional[str]) -> None:
+    def update_manufacturer(self, manufacturer: str | None) -> None:
         """Update the manufacturer."""
         self.manufacturer = manufacturer
 

src/simple_scanner/scanner.py

@@ -7,7 +7,6 @@
 import json
 import os
 from pathlib import Path
-from typing import Dict, List, Optional
 from .models import Device
 
 
@@ -82,7 +81,7 @@ class NetworkMonitor:
 
     def __init__(
         self,
-        network: Optional[str] = None,
+        network: str | None = None,
         remove_stale: bool = False,
         verbose: bool = False,
         use_persistence: bool = True,
@@ -91,7 +90,7 @@ def __init__(
         self.remove_stale = remove_stale
         self.verbose = verbose
         self.use_persistence = use_persistence
-        self._devices: Dict[str, Device] = {}
+        self._devices: dict[str, Device] = {}
 
         # Locate nmap executable
         self._nmap_path = shutil.which('nmap')
@@ -190,8 +189,8 @@ def _parse(self, raw: str) -> None:
                 continue
             ip = host_match.group('ip')
             hostname = host_match.group('hostname')  # May be None
-            mac: Optional[str] = None
-            manufacturer: Optional[str] = None
+            mac: str | None = None
+            manufacturer: str | None = None
 
             # Look ahead for MAC Address line
             for j in range(i+1, min(i+1+self.MAC_LOOKAHEAD_LINES, len(lines))):
@@ -243,7 +242,7 @@ def scan(self) -> None:
             print(raw)
         self._parse(raw)
 
-    def devices(self) -> List[Device]:
+    def devices(self) -> list[Device]:
         """Return list of tracked devices."""
         return list(self._devices.values())