py-nic-manager 0.1.0__tar.gz

py_nic_manager-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GGN_2015
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

py_nic_manager-0.1.0/PKG-INFO

@@ -0,0 +1,171 @@
+Metadata-Version: 2.4
+Name: py-nic-manager
+Version: 0.1.0
+Summary: A cross-platform GUI network adapter and route manager.
+Author: GGN_2015
+License: MIT
+Keywords: network,gui,nic,route,loopback
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Environment :: MacOS X
+Classifier: Environment :: X11 Applications
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: System :: Networking
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: is-admin-user>=0.1.0
+Dynamic: license-file
+
+# Py NIC Manager
+
+Py NIC Manager is a cross-platform Python GUI for viewing and changing network
+adapter settings, loopback-style adapters, route tables, and saved network
+configuration snapshots.
+
+The application is written in English and uses the Python standard `tkinter`
+GUI toolkit. It can run on Windows and POSIX systems. Administrative actions
+require Administrator/root privileges; when the app is started without those
+privileges, it opens in read-only mode and clearly asks the user to restart it
+with elevated permissions.
+
+## Features
+
+- View network adapters, IPv4 addresses, MAC addresses, gateways, DNS servers,
+  DHCP state, and loopback status.
+- Edit existing adapter IPv4 address, prefix length, gateway, DNS servers, MAC
+  address, and DHCP mode where the operating system backend supports it.
+- Create, edit, and delete loopback-style adapters:
+  - Windows: Microsoft KM-TEST Loopback Adapter through `devcon.exe`.
+  - Linux: dummy interfaces through `ip link`.
+  - macOS and generic POSIX: loopback aliases on `lo0`.
+- View, add, update, and delete IPv4 routes through a visual route table editor.
+- Export the current adapters and routes to a JSON configuration snapshot.
+- Import a saved snapshot and apply it as a best-effort one-click restore after
+  previewing the system commands that will run.
+- Preview every mutating command before execution.
+
+## Installation
+
+```powershell
+python -m venv .venv
+.\.venv\Scripts\Activate.ps1
+python -m pip install -e .
+```
+
+On Linux or macOS:
+
+```bash
+python3 -m venv .venv
+. .venv/bin/activate
+python -m pip install -e .
+```
+
+The project depends on
+[`is-admin-user`](https://pypi.org/project/is-admin-user/) for privilege
+detection.
+
+## Running
+
+```bash
+py-nic-manager
+```
+
+Or:
+
+```bash
+python -m py_nic_manager
+```
+
+Use an elevated shell when you want to change system settings:
+
+- Windows: run PowerShell or Command Prompt as Administrator.
+- Linux/macOS/POSIX: run with `sudo`, `doas`, or an equivalent root session.
+
+Without elevation, the app can still view adapters/routes and export
+configuration snapshots.
+
+## Platform Notes
+
+### Windows
+
+The Windows backend uses PowerShell networking cmdlets, `netsh`, `route`, and
+`pnputil`.
+
+Creating a Microsoft KM-TEST Loopback Adapter requires `devcon.exe` from the
+Windows Driver Kit to be available on `PATH`. Windows does not provide a simple
+built-in `netsh` command that reliably creates this adapter on every version.
+
+### Linux
+
+The Linux backend uses `ip` from iproute2. DNS and DHCP persistence are handled
+through NetworkManager (`nmcli`) when available, with `resolvectl` used as a DNS
+fallback.
+
+Loopback-style adapters are implemented as Linux dummy interfaces.
+
+### macOS
+
+The macOS backend uses `networksetup`, `ifconfig`, `route`, and `netstat`.
+Loopback creation is implemented as an address alias on `lo0`, because macOS
+does not create independent loopback NICs in the same way Linux creates dummy
+interfaces.
+
+### Generic POSIX
+
+For POSIX systems that are not Linux or macOS, the app uses a conservative
+`ifconfig`/`route` fallback. Viewing should work on many Unix-like systems, but
+some mutating operations are intentionally limited because network management
+varies widely across BSDs and commercial Unix systems.
+
+## Configuration Snapshots
+
+Exported files are JSON documents with this high-level shape:
+
+```json
+{
+  "schema_version": 1,
+  "platform": "Windows",
+  "captured_at": "2026-06-17T02:00:00+00:00",
+  "adapters": [],
+  "routes": []
+}
+```
+
+When applying an imported snapshot, Py NIC Manager:
+
+1. Matches adapters by backend ID first, then by adapter name.
+2. Updates matched adapters with the saved IPv4, gateway, DNS, MAC, and DHCP
+   values where supported.
+3. Adds saved IPv4 routes.
+4. Shows skipped adapters and platform limitations in the command preview.
+
+Applying a snapshot from another operating system is allowed only after a
+warning and is best-effort.
+
+## Development
+
+Run tests:
+
+```bash
+python -m pytest -q
+```
+
+Run a syntax check:
+
+```bash
+python -m compileall py_nic_manager tests
+```
+
+## Safety
+
+Network configuration changes can disconnect the machine, break DNS resolution,
+or remove routes that are needed for remote access. Always review the command
+preview before applying changes, and export a known-good snapshot before making
+large edits.
+

py_nic_manager-0.1.0/README.md

@@ -0,0 +1,147 @@
+# Py NIC Manager
+
+Py NIC Manager is a cross-platform Python GUI for viewing and changing network
+adapter settings, loopback-style adapters, route tables, and saved network
+configuration snapshots.
+
+The application is written in English and uses the Python standard `tkinter`
+GUI toolkit. It can run on Windows and POSIX systems. Administrative actions
+require Administrator/root privileges; when the app is started without those
+privileges, it opens in read-only mode and clearly asks the user to restart it
+with elevated permissions.
+
+## Features
+
+- View network adapters, IPv4 addresses, MAC addresses, gateways, DNS servers,
+  DHCP state, and loopback status.
+- Edit existing adapter IPv4 address, prefix length, gateway, DNS servers, MAC
+  address, and DHCP mode where the operating system backend supports it.
+- Create, edit, and delete loopback-style adapters:
+  - Windows: Microsoft KM-TEST Loopback Adapter through `devcon.exe`.
+  - Linux: dummy interfaces through `ip link`.
+  - macOS and generic POSIX: loopback aliases on `lo0`.
+- View, add, update, and delete IPv4 routes through a visual route table editor.
+- Export the current adapters and routes to a JSON configuration snapshot.
+- Import a saved snapshot and apply it as a best-effort one-click restore after
+  previewing the system commands that will run.
+- Preview every mutating command before execution.
+
+## Installation
+
+```powershell
+python -m venv .venv
+.\.venv\Scripts\Activate.ps1
+python -m pip install -e .
+```
+
+On Linux or macOS:
+
+```bash
+python3 -m venv .venv
+. .venv/bin/activate
+python -m pip install -e .
+```
+
+The project depends on
+[`is-admin-user`](https://pypi.org/project/is-admin-user/) for privilege
+detection.
+
+## Running
+
+```bash
+py-nic-manager
+```
+
+Or:
+
+```bash
+python -m py_nic_manager
+```
+
+Use an elevated shell when you want to change system settings:
+
+- Windows: run PowerShell or Command Prompt as Administrator.
+- Linux/macOS/POSIX: run with `sudo`, `doas`, or an equivalent root session.
+
+Without elevation, the app can still view adapters/routes and export
+configuration snapshots.
+
+## Platform Notes
+
+### Windows
+
+The Windows backend uses PowerShell networking cmdlets, `netsh`, `route`, and
+`pnputil`.
+
+Creating a Microsoft KM-TEST Loopback Adapter requires `devcon.exe` from the
+Windows Driver Kit to be available on `PATH`. Windows does not provide a simple
+built-in `netsh` command that reliably creates this adapter on every version.
+
+### Linux
+
+The Linux backend uses `ip` from iproute2. DNS and DHCP persistence are handled
+through NetworkManager (`nmcli`) when available, with `resolvectl` used as a DNS
+fallback.
+
+Loopback-style adapters are implemented as Linux dummy interfaces.
+
+### macOS
+
+The macOS backend uses `networksetup`, `ifconfig`, `route`, and `netstat`.
+Loopback creation is implemented as an address alias on `lo0`, because macOS
+does not create independent loopback NICs in the same way Linux creates dummy
+interfaces.
+
+### Generic POSIX
+
+For POSIX systems that are not Linux or macOS, the app uses a conservative
+`ifconfig`/`route` fallback. Viewing should work on many Unix-like systems, but
+some mutating operations are intentionally limited because network management
+varies widely across BSDs and commercial Unix systems.
+
+## Configuration Snapshots
+
+Exported files are JSON documents with this high-level shape:
+
+```json
+{
+  "schema_version": 1,
+  "platform": "Windows",
+  "captured_at": "2026-06-17T02:00:00+00:00",
+  "adapters": [],
+  "routes": []
+}
+```
+
+When applying an imported snapshot, Py NIC Manager:
+
+1. Matches adapters by backend ID first, then by adapter name.
+2. Updates matched adapters with the saved IPv4, gateway, DNS, MAC, and DHCP
+   values where supported.
+3. Adds saved IPv4 routes.
+4. Shows skipped adapters and platform limitations in the command preview.
+
+Applying a snapshot from another operating system is allowed only after a
+warning and is best-effort.
+
+## Development
+
+Run tests:
+
+```bash
+python -m pytest -q
+```
+
+Run a syntax check:
+
+```bash
+python -m compileall py_nic_manager tests
+```
+
+## Safety
+
+Network configuration changes can disconnect the machine, break DNS resolution,
+or remove routes that are needed for remote access. Always review the command
+preview before applying changes, and export a known-good snapshot before making
+large edits.
+

py_nic_manager-0.1.0/py_nic_manager/__init__.py

@@ -0,0 +1,6 @@
+"""Cross-platform GUI network adapter manager."""
+
+__all__ = ["__version__"]
+
+__version__ = "0.1.0"
+

py_nic_manager-0.1.0/py_nic_manager/__main__.py

@@ -0,0 +1,6 @@
+from .app import main
+
+
+if __name__ == "__main__":
+    main()
+

py_nic_manager-0.1.0/py_nic_manager/admin.py

@@ -0,0 +1,28 @@
+from __future__ import annotations
+
+import os
+import platform
+
+
+def is_admin() -> bool:
+    try:
+        from is_admin_user import is_admin_user
+
+        return bool(is_admin_user())
+    except Exception:
+        return _fallback_is_admin()
+
+
+def _fallback_is_admin() -> bool:
+    if platform.system().lower() == "windows":
+        try:
+            import ctypes
+
+            return bool(ctypes.windll.shell32.IsUserAnAdmin())
+        except Exception:
+            return False
+    geteuid = getattr(os, "geteuid", None)
+    if geteuid is None:
+        return False
+    return geteuid() == 0
+