pinter 0.1.0__tar.gz → 0.2.0__tar.gz

pinter-0.2.0/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: pinter
+Version: 0.2.0
+Summary: Print INTERfaces and ip addresses
+License: MIT
+License-File: LICENSE
+Author: Marcin Marzec
+Requires-Python: >=3.8,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Requires-Dist: psutil (>=5.9.6,<6.0.0)
+Project-URL: Homepage, https://github.com/mmarzec/pinter
+Description-Content-Type: text/markdown
+
+# Pinter - Print INTERfaces
+
+Pinter is a small CLI tool that prints your network interfaces and their IP addresses in a clean, colored table. Forget about digging through `ifconfig` or `ip addr` output.
+
+By default it shows only the interfaces that usually matter (Ethernet, Wi-Fi, bridges, VPN tunnels) and hides noise such as loopback, Docker and other virtual interfaces.
+
+## Features
+
+- One line per interface, aligned columns, colored output
+- All IPv4 addresses of an interface, when it has more than one
+- Optional MAC addresses
+- Optional view of all interfaces, without filtering
+- Only one dependency: [psutil](https://github.com/giampaolo/psutil)
+
+## Installation
+
+Install with `pipx` (preferred) or `pip`:
+
+```console
+pipx install pinter
+```
+
+```console
+pip install pinter
+```
+
+Requires Python 3.8 or newer.
+
+## Usage
+
+```console
+pinter [options]
+```
+
+Options are single letters and can be combined in one argument, for example `pinter am`:
+
+| Option | Description                                         |
+|--------|-----------------------------------------------------|
+| `a`    | Show all interfaces (no filtering)                  |
+| `m`    | Also print MAC addresses                            |
+| `h`    | Print help                                          |
+
+### Default view
+
+Shows only the important interfaces:
+
+```console
+$ pinter
+enp1s0  192.168.1.23
+        192.168.1.24
+wlp2s0  192.168.1.57
+tun0    10.8.0.2
+```
+
+Important addreses starts with: (`br`, `eno`, `enp`, `eth`, `wl`, `tun`).
+Other addresses are hidden.
+
+
+### All interfaces
+
+```console
+$ pinter a
+lo       127.0.0.1
+enp1s0   192.168.1.23
+wlp2s0   192.168.1.57
+docker0  172.17.0.1
+```
+
+### With MAC addresses
+
+```console
+$ pinter m
+enp1s0  192.168.1.23  52:54:00:12:34:56
+wlp2s0  192.168.1.57  a4:c3:f0:65:43:21
+```
+
+### All interfaces with MAC addresses
+
+```console
+$ pinter am
+lo       127.0.0.1     00:00:00:00:00:00
+enp1s0   192.168.1.23  52:54:00:12:34:56
+wlp2s0   192.168.1.57  a4:c3:f0:65:43:21
+docker0  172.17.0.1    02:42:7a:1b:2c:3d
+```
+
+## License
+
+MIT, see [LICENSE](LICENSE).
+

pinter-0.2.0/README.md

@@ -0,0 +1,89 @@
+# Pinter - Print INTERfaces
+
+Pinter is a small CLI tool that prints your network interfaces and their IP addresses in a clean, colored table. Forget about digging through `ifconfig` or `ip addr` output.
+
+By default it shows only the interfaces that usually matter (Ethernet, Wi-Fi, bridges, VPN tunnels) and hides noise such as loopback, Docker and other virtual interfaces.
+
+## Features
+
+- One line per interface, aligned columns, colored output
+- All IPv4 addresses of an interface, when it has more than one
+- Optional MAC addresses
+- Optional view of all interfaces, without filtering
+- Only one dependency: [psutil](https://github.com/giampaolo/psutil)
+
+## Installation
+
+Install with `pipx` (preferred) or `pip`:
+
+```console
+pipx install pinter
+```
+
+```console
+pip install pinter
+```
+
+Requires Python 3.8 or newer.
+
+## Usage
+
+```console
+pinter [options]
+```
+
+Options are single letters and can be combined in one argument, for example `pinter am`:
+
+| Option | Description                                         |
+|--------|-----------------------------------------------------|
+| `a`    | Show all interfaces (no filtering)                  |
+| `m`    | Also print MAC addresses                            |
+| `h`    | Print help                                          |
+
+### Default view
+
+Shows only the important interfaces:
+
+```console
+$ pinter
+enp1s0  192.168.1.23
+        192.168.1.24
+wlp2s0  192.168.1.57
+tun0    10.8.0.2
+```
+
+Important addreses starts with: (`br`, `eno`, `enp`, `eth`, `wl`, `tun`).
+Other addresses are hidden.
+
+
+### All interfaces
+
+```console
+$ pinter a
+lo       127.0.0.1
+enp1s0   192.168.1.23
+wlp2s0   192.168.1.57
+docker0  172.17.0.1
+```
+
+### With MAC addresses
+
+```console
+$ pinter m
+enp1s0  192.168.1.23  52:54:00:12:34:56
+wlp2s0  192.168.1.57  a4:c3:f0:65:43:21
+```
+
+### All interfaces with MAC addresses
+
+```console
+$ pinter am
+lo       127.0.0.1     00:00:00:00:00:00
+enp1s0   192.168.1.23  52:54:00:12:34:56
+wlp2s0   192.168.1.57  a4:c3:f0:65:43:21
+docker0  172.17.0.1    02:42:7a:1b:2c:3d
+```
+
+## License
+
+MIT, see [LICENSE](LICENSE).

pinter-0.2.0/pinter/__main__.py

@@ -0,0 +1,86 @@
+import psutil
+import socket
+import sys
+
+
+def collect_intf_addresses(include_all=False):
+    interfaces_psutil = psutil.net_if_addrs()
+
+    intf_addresses = {}
+
+    # get all interfaces names
+    intf_names = (intf[1] for intf in socket.if_nameindex())
+
+    # filter
+    if not include_all:
+        intf_names = (intf for intf in intf_names if intf.startswith(('enp', 'eth', 'wl', 'eno', 'br', 'tun')))
+        intf_names = (intf for intf in intf_names if not intf.startswith(('br-')))
+
+    # get addresses
+    for intf in intf_names:
+        intf_addresses[intf] = {'ip': [], 'mac': ''}
+        for address in interfaces_psutil[intf]:
+            if address.family == socket.AF_INET:
+                intf_addresses[intf]['ip'].append(address.address)
+            elif address.family == socket.AF_PACKET:
+                intf_addresses[intf]['mac'] = address.address
+
+    return intf_addresses
+
+
+def print_help():
+    print(f'''Description:
+  Print network interfaces and ip addresses
+
+Usage:
+  pinter [options]
+
+Options:
+  a  all interfaces
+  h  help
+  m  print mac addresses
+
+''')
+
+
+def cli():
+
+    # cli options
+    options = ''
+    if len(sys.argv) > 1:
+        options = sys.argv[1]
+
+    include_all = None
+    if 'a' in options:
+        include_all = True
+
+    if 'h' in options:
+        print_help()
+        return
+
+    include_mac = False
+    if 'm' in options:
+        include_mac = True
+
+    intf_addresses = collect_intf_addresses(include_all)
+    intf_col_width = len(max(intf_addresses.keys(), key=len, default=''))
+    ip_col_width = len(max([ip for intf in intf_addresses for ip in intf_addresses[intf]['ip']], key=len, default=''))
+
+    for intf in intf_addresses:
+        if not intf_addresses[intf]['ip']:
+            intf_addresses[intf]['ip'].append('')
+
+        # print first row
+        row = f'{intf:<{intf_col_width}}  \033[36m{intf_addresses[intf]["ip"][0]:<{ip_col_width}}\033[0m'
+
+        if include_mac:
+            row = f'{row}  \033[35m{intf_addresses[intf]["mac"]}\033[0m'
+        print(row)
+
+        # print rest rows
+        for ip_addr in intf_addresses[intf]['ip'][1:]:
+            print(f'{"":<{intf_col_width}}  \033[36m{ip_addr}\033[0m')
+
+
+if __name__ == "__main__":
+    cli()

{pinter-0.1.0 → pinter-0.2.0}/pyproject.toml

@@ -1,15 +1,16 @@
 [tool.poetry]
 name = "pinter"
-version = "0.1.0"
+version = "0.2.0"
+license = "MIT"
 description = "Print INTERfaces and ip addresses"
 authors = ["Marcin Marzec"]
 readme = "README.md"
+homepage = "https://github.com/mmarzec/pinter"
 
 
 [tool.poetry.dependencies]
 python = "^3.8"
 psutil = "^5.9.6"
-rich = "^13.7.0"
 
 
 [build-system]

pinter-0.1.0/PKG-INFO

@@ -1,37 +0,0 @@
-Metadata-Version: 2.1
-Name: pinter
-Version: 0.1.0
-Summary: Print INTERfaces and ip addresses
-Author: Marcin Marzec
-Requires-Python: >=3.8,<4.0
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Requires-Dist: psutil (>=5.9.6,<6.0.0)
-Requires-Dist: rich (>=13.7.0,<14.0.0)
-Description-Content-Type: text/markdown
-
-# Pinter - Print INTERfaces
-
-Pinter is a CLI tool to print nicely your network interfaces and ip addresses. Forget about `ifconfig` or `ip addr`. It will filter out the ones that are not important like those create by docker, etc.
-
-
-## Installation
-Install with `pipx`(prefered) or `pip`.
-```console
-pipx install pinter
-```
-
-```console
-pip install pinter
-```
-
-## Usage
-Just run
-```console
-pinter
-```
-

pinter-0.1.0/README.md

@@ -1,20 +0,0 @@
-# Pinter - Print INTERfaces
-
-Pinter is a CLI tool to print nicely your network interfaces and ip addresses. Forget about `ifconfig` or `ip addr`. It will filter out the ones that are not important like those create by docker, etc.
-
-
-## Installation
-Install with `pipx`(prefered) or `pip`.
-```console
-pipx install pinter
-```
-
-```console
-pip install pinter
-```
-
-## Usage
-Just run
-```console
-pinter
-```

pinter-0.1.0/pinter/__main__.py

@@ -1,37 +0,0 @@
-import psutil
-import socket
-from rich.console import Console
-from rich.table import Table
-
-
-def collect_intf_addresses():
-    interfaces_psutil = psutil.net_if_addrs()
-
-    intf_addresses = {}
-
-    # get all interfaces names
-    intf_names = (intf[1] for intf in socket.if_nameindex())
-
-    # filter
-    intf_names = (intf for intf in intf_names if intf.startswith(('enp', 'eth', 'wl', 'eno', 'br', 'tun')))
-    intf_names = (intf for intf in intf_names if not intf.startswith(('br-')))
-
-    # get addresses
-    for intf in intf_names:
-        intf_addresses[intf] = None
-        for address in interfaces_psutil[intf]:
-            if address.family == socket.AF_INET:
-                intf_addresses[intf] = address.address
-
-    return intf_addresses
-
-
-def cli():
-    table = Table(box=None)
-    table.add_column()
-    table.add_column(style="cyan")
-    intf_addresses = collect_intf_addresses()
-    for intf in intf_addresses:
-        table.add_row(intf, intf_addresses[intf])
-    console = Console()
-    console.print(table)