router-cli 0.1.0__py3-none-any.whl → 0.3.0__py3-none-any.whl

{router_cli-0.1.0.dist-info → router_cli-0.3.0.dist-info}/METADATA

@@ -1,11 +1,26 @@
 Metadata-Version: 2.3
 Name: router-cli
-Version: 0.1.0
+Version: 0.3.0
 Summary: CLI tool to manage D-Link DSL-2750U router
+Keywords: router,cli,dlink,dsl-2750u,network,admin
 Author: d3vr
 Author-email: d3vr <hi@f3.al>
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Networking
 Requires-Dist: tomli>=2.0.0 ; python_full_version < '3.11'
 Requires-Python: >=3.10
+Project-URL: Homepage, https://github.com/d3vr/router-cli
+Project-URL: Repository, https://github.com/d3vr/router-cli
+Project-URL: Issues, https://github.com/d3vr/router-cli/issues
 Description-Content-Type: text/markdown
 
 # router-cli
@@ -25,7 +40,7 @@ Since the router doesn't provide a formal API, this tool works by authenticating
 
 ## Installation
 
-Requires Python 3.11 or higher.
+Requires Python 3.10 or higher.
 
 ### Using uv (recommended)
 
@@ -58,10 +73,12 @@ username = "admin"
 password = "your_password_here"
 
 # Optional: Define known devices for colorized output
+# Use MAC addresses for devices with stable MACs
+# Use hostnames for devices with random MACs (like Android)
 [known_devices]
 "AA:BB:CC:DD:EE:FF" = "My Phone"
 "11:22:33:44:55:66" = "Smart TV"
-"DE:AD:BE:EF:00:01" = "Work Laptop"
+"android-abc123" = "John's Pixel"
 ```
 
 The tool searches for configuration in the following locations (in order):
@@ -71,6 +88,24 @@ The tool searches for configuration in the following locations (in order):
 
 ## Usage
 
+### Global Options
+
+All commands support these global options:
+
+```bash
+router --ip 192.168.1.1 --user admin --pass secret status
+router --json clients
+```
+
+| Option | Environment Variable | Description |
+|--------|---------------------|-------------|
+| `--ip ADDRESS` | `ROUTER_IP` | Router IP address |
+| `--user USERNAME` | `ROUTER_USER` | Username for authentication |
+| `--pass PASSWORD` | `ROUTER_PASS` | Password for authentication |
+| `--json` | - | Output in JSON format (for scripting) |
+
+**Configuration priority**: CLI flags > environment variables > config file > defaults
+
 ### Quick Overview
 
 ```bash
@@ -189,7 +224,7 @@ Sends a reboot command to the router.
 
 ## Known Devices
 
-The `[known_devices]` section in your config file maps MAC addresses to friendly names. This enables:
+The `[known_devices]` section in your config file maps MAC addresses or hostnames to friendly names. This enables:
 
 - **Color-coded output**: Known devices appear in green, unknown in red
 - **Friendly names**: See "My Phone" instead of a hostname or MAC address
@@ -197,11 +232,18 @@ The `[known_devices]` section in your config file maps MAC addresses to friendly
 
 ```toml
 [known_devices]
+# By MAC address (for devices with stable MACs)
 "AA:BB:CC:DD:EE:FF" = "My Phone"
 "11:22:33:44:55:66" = "Smart TV"
+
+# By hostname (for devices with random MACs, like some Android phones)
+"android-abc123def" = "John's Pixel"
+"Galaxy-S24" = "Sarah's Phone"
 ```
 
-MAC addresses are matched case-insensitively.
+**MAC addresses** are identified by their format (`XX:XX:XX:XX:XX:XX`) and matched case-insensitively.
+
+**Hostnames** are useful for Android and iOS devices that use MAC address randomization for privacy. These devices typically maintain a consistent hostname even when their MAC changes. Hostnames are also matched case-insensitively.
 
 ## Development
 
@@ -218,7 +260,7 @@ uv run pytest
 
 ## Compatibility
 
-- **Python**: 3.11+
+- **Python**: 3.10+
 - **Router**: D-Link DSL-2750U (firmware ME_1.00)
 
 This tool may work with other D-Link routers that share a similar web interface, but has only been tested with the DSL-2750U.

router_cli-0.3.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+router_cli/__init__.py,sha256=rXtUqxUti4S10Iz4Xttp_qsECHXqv5A7gNYHrh-RsEk,74
+router_cli/client.py,sha256=0T0ZQoC4KkFrhzDDVlCa26P8EV-IK9ooFPsO0LKq9Nk,11811
+router_cli/commands.py,sha256=tg0DVp__j7R5gLG1hydz1FrXTZ0Z9Z00ubSnuVdE-Ew,7009
+router_cli/config.py,sha256=c9RWWKtnKWELtMB_g3I8oFwk0nEqPYs5Tqq5uHaB34s,6240
+router_cli/display.py,sha256=Xt0cr55vVIHrV5gB2WG2LM8I4Qgyuw7i72J1gfXYc7k,5343
+router_cli/formatters.py,sha256=goY_SVXOdaV3c4gvHrq1pvW--RSI6U8Dxtu0P4377H8,12566
+router_cli/main.py,sha256=Qfj0GJPScP1jrJkI9xiP7JhwPyoxmjQtJe0tzblOiy0,3547
+router_cli/models.py,sha256=TDtZqOY_h7jZggZp6xqQREifngWzsJM4WTNBGXRyVLw,3279
+router_cli/parser.py,sha256=khRFClFYQ8tsUmDKIXti3QtTEm9wjWmdBmIInkxYf3U,15575
+router_cli/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+router_cli-0.3.0.dist-info/WHEEL,sha256=fAguSjoiATBe7TNBkJwOjyL1Tt4wwiaQGtNtjRPNMQA,80
+router_cli-0.3.0.dist-info/entry_points.txt,sha256=PfkydZeDJvlgvEXYOG1gYvbTM39Cm-OgsPpREH3UNAU,49
+router_cli-0.3.0.dist-info/METADATA,sha256=TvHRQ_2LkPlwwYIrKJzhh_170RwkS47XxYrE1GKgLug,7413
+router_cli-0.3.0.dist-info/RECORD,,

router_cli-0.1.0.dist-info/RECORD

@@ -1,9 +0,0 @@
-router_cli/__init__.py,sha256=R-j6ZUnvZT4qKwxPGaYBQEOCLsPATLn1qHLHSmdfo2c,74
-router_cli/client.py,sha256=DuOqZvsCkcgut2k0LqKcdYD_rN4E1TRtwfqm9bnJTEU,29631
-router_cli/config.py,sha256=SX1s1CJk_XiiCHlZ47I9vgda9IRqqUwBTQKjC3BYoVE,1803
-router_cli/main.py,sha256=UzIYNKIM9f4NQ2UW-wenI8yQRVKMVMiPyaXPjyTggaU,22469
-router_cli/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-router_cli-0.1.0.dist-info/WHEEL,sha256=fAguSjoiATBe7TNBkJwOjyL1Tt4wwiaQGtNtjRPNMQA,80
-router_cli-0.1.0.dist-info/entry_points.txt,sha256=PfkydZeDJvlgvEXYOG1gYvbTM39Cm-OgsPpREH3UNAU,49
-router_cli-0.1.0.dist-info/METADATA,sha256=HqMMKyryg1MFSZneA_OMyN3rR7mJ_7VBp7OCcjuKHJA,5509
-router_cli-0.1.0.dist-info/RECORD,,