python-netgear-switch-library 0.0.post357__tar.gz → 0.0.post359__tar.gz

{python_netgear_switch_library-0.0.post357 → python_netgear_switch_library-0.0.post359}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-netgear-switch-library
-Version: 0.0.post357
+Version: 0.0.post359
 Summary: Python library and CLI to query and control Netgear switches over SNMP, NSDP and HTTP.
 Author-email: Tim Ansell <me@mith.ro>
 License-Expression: Apache-2.0

{python_netgear_switch_library-0.0.post357 → python_netgear_switch_library-0.0.post359}/docs/superpowers/specs/2026-08-02-snmp-surface-findings.md

@@ -407,3 +407,79 @@ So the fix is two parts, and neither is a device limitation:
 Which of the four buttons is Add and which is Delete has NOT been established —
 that needs the page's own markup read carefully, and the write driven against a
 switch with a throwaway VLAN id before anything is claimed.
+
+
+### `/vlanConfiguration.html` field semantics (read off the capture)
+
+Correcting the previous note again: `v_2_1_1`..`v_2_1_4` are **row cell fields,
+not action buttons**. From the capture:
+
+| Field | Value in row 1 | Meaning |
+|---|---|---|
+| `1.0.14.v_2_1_1` | `1` | VLAN id |
+| `1.0.14.v_2_1_2` | `default` | VLAN name |
+| `1.0.14.v_2_1_3` | `Default` | VLAN type |
+| `1.0.14.v_2_1_4` | `Add` | per-row action, in a `display:none` cell |
+
+Two `FORM`s as expected: `/vlanConfiguration.html/a0` and `/a1`.
+
+So this is the standard XUI editable-table shape the library already handles for
+PoE (`parse_xui_list_page` + `forms.xui_row_apply_form`), with one difference
+that matters: PoE **edits an existing row**, whereas creating a VLAN means
+**submitting a NEW row** carrying the id, the name and the action cell.
+
+`xui_row_apply_form` builds its body from a row the parser found on the page, so
+it cannot express "a row that is not there yet". Creating a VLAN needs a sibling
+builder — an add-row form — rather than a new argument to the existing one.
+
+**Not yet established, and deliberately not guessed:** whether the action cell
+takes the literal `Add` for a new row, what a delete row carries in that cell,
+and whether the id/name cells for a new row are indexed `v_2_<n>_<col>` at the
+next free row number or at a fixed "new row" index. Every one of those is
+readable from the page's own JavaScript or from a browser-driven capture of a
+real Add. Until then this stays unimplemented: posting a guessed action to a
+switch's live VLAN table is the one write here that could disrupt production
+VLANs, and the project's rule is that a wrong guess must never be shipped as a
+capability.
+
+
+### RESOLVED: the action cell is SNMP RowStatus, read from the page's own JS
+
+`/scripts/_xe_vlanConfiguration.js` (captured as
+`tests/fixtures/http/gsm7252ps_vlan_configuration.js`) defines the `2_1_4`
+column's value list:
+
+    [ "Invalid","Active","Not In Service","Not Ready","Add","Reserve","Delete","Modify" ]
+
+Indexed from 0, that is **SNMP RowStatus**:
+
+| Index | Label | RowStatus |
+|---|---|---|
+| 1 | Active | `active(1)` |
+| 2 | Not In Service | `notInService(2)` |
+| 3 | Not Ready | `notReady(3)` |
+| **4** | **Add** | **`createAndGo(4)`** |
+| 5 | Reserve | `createAndWait(5)` |
+| **6** | **Delete** | **`destroy(6)`** |
+
+The web UI is a thin skin over the same Q-BRIDGE row semantics the SNMP backend
+already writes — and the library already names those constants:
+`oids.ROW_STATUS_CREATE_AND_GO = 4` and `oids.ROW_STATUS_DESTROY = 6`.
+
+The same file gives the two action buttons:
+
+    xeData.xbImage_6_1_1 = "/base/images/Add_on.gif"     -> button 6_1_1 = Add
+    xeData.xbImage_6_1_2 = "/base/images/Delete_on.gif"  -> button 6_1_2 = Delete
+
+So all three unknowns from the previous note are now answered **from the
+device's own code**, with no guessing and no write attempted:
+
+* the action cell takes `4` to create and `6` to delete;
+* a create submits a new row carrying id, name and action `4`;
+* the submit buttons are `6_1_1` (Add) and `6_1_2` (Delete).
+
+That is enough to implement `_xui_vlan_create`/`_xui_vlan_delete` against
+`/vlanConfiguration.html`, posting to its `/a0` or `/a1` action alongside the
+existing `submit_flag`. It still needs driving against a switch with a throwaway
+VLAN id and reading back before `reads_verified`-style confidence is claimed —
+but the mechanism is no longer inferred.

{python_netgear_switch_library-0.0.post357 → python_netgear_switch_library-0.0.post359}/src/netgear_switch/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.0.post357'
-__version_tuple__ = version_tuple = (0, 0, 'post357')
+__version__ = version = '0.0.post359'
+__version_tuple__ = version_tuple = (0, 0, 'post359')
 
 __commit_id__ = commit_id = None

python_netgear_switch_library-0.0.post359/tests/fixtures/http/gsm7252ps_vlan_configuration.js

@@ -0,0 +1,236 @@
+
+
+// This file is auto-generated by XE - DON'T EDIT
+
+
+// Create the xe data object
+xeData.nPath = [ ["Switching","vlanConfiguration.html"],["VLAN","vlanConfiguration.html"],["Advanced","vlanConfiguration.html"],["VLAN Configuration","vlanConfiguration.html"] ];
+xeData.thisPageHelp = "help_vlanConfiguration.html" ;
+xeData.userJS = "NetGearGlobalJS"
+xeData.xa_1_1_1 = ["","","","","","","","","","mandate","","","","","","","","","Enable","","both","6_1_5","6_1_4","6_1_4","6_1_5","",[],"Disable","","both","6_1_4","6_1_5","6_1_5","6_1_4","",[]];
+xeData.xa_2_1_1 = ["","","","","","","","","","mandate","","onChange","","","","","",[],"","","both","","","2_1_5|2_1_6","","",[]];
+xeData.xa_g_2_1_1 = ["","","","","","","","","","mandate","","onChange","","","","","",[],"","","both","","","g_2_1_5|g_2_1_6","","",[]];
+xeData.xa_6_1_1 = ["","","","","","","","","","","","","","","1|2_1_6|g_2_1_6","","",[]];
+xeData.xa_6_1_2 = ["","","","","","","","","","","","","","","1|2_1_6|g_2_1_6","","2_1_4|g_2_1_4",["Delete|Delete"]];
+xeData.xa_6_1_6 = ["","","","","","","","","","","","","","","2_1_6|g_2_1_6","","",[]];
+xeData.xa_6_1_3 = ["","","","","","","","","","","","","","","2_1_6|g_2_1_6","","",[]];
+xeData.xa_6_1_5 = ["","","","","","","","","","","","","","","2","","",[]];
+xeData.xa_6_1_4 = ["","","","","","","","","","","","","","","1","","2_1_4|g_2_1_4",["Active|Active"]];
+xeData.xe_1_1_1 = "enable_t";
+xeData.doRef_1_1_1 = 0;
+xeData.xc_1_1_1 = "checkbox";
+xeData.xp_1_1_1 = "write-only";
+xeData.xd_1_1_1 = "enum";
+xeData.xdt_1_1_1 = "enable_t";
+xeData.xeleName_1_1_1 = "Reset Configuration";
+xeData["js_1_1_1_Enable"]=["confirm_vlan_reset",""]
+allWebEnums[xeData["xe_1_1_1"] + "_1_1_1"] = [ "Enable","Disable" ];
+xeData.doRef_4_1_1 = 0;
+xeData.xc_4_1_1 = "textbox";
+xeData.xp_4_1_1 = "read-write";
+xeData.xd_4_1_1 = "uint";
+xeData.xdt_4_1_1 = "uint";
+xeData.xeleName_4_1_1 = "Internal VLAN Allocation Base";
+xeData.xMaxLen_4_1_1 = "4";
+xeData.xattr_4_1_1 = ["discardNonInt=1"];
+xeData.xe_4_2_1 = "AllocationPolicy_t";
+xeData.doRef_4_2_1 = 0;
+xeData.xc_4_2_1 = "radio";
+xeData.xp_4_2_1 = "read-write";
+xeData.xd_4_2_1 = "enum";
+xeData.xdt_4_2_1 = "AllocationPolicy_t";
+xeData.xeleName_4_2_1 = "Internal VLAN Allocation Policy";
+allWebEnums[xeData["xe_4_2_1"] + "_4_2_1"] = [ "Ascending","Descending" ];
+xeData.doRef_5_1_1 = 0;
+xeData.xc_5_1_1 = "label";
+xeData.xp_5_1_1 = "read-write";
+xeData.xd_5_1_1 = "uint";
+xeData.xdt_5_1_1 = "uint";
+xeData.xeleName_5_1_1 = "Internal VLAN Allocation Base";
+xeData.xMaxLen_5_1_1 = "4";
+xeData.xe_5_2_1 = "AllocationPolicy_t";
+xeData.doRef_5_2_1 = 0;
+xeData.xc_5_2_1 = "label";
+xeData.xp_5_2_1 = "read-write";
+xeData.xd_5_2_1 = "enum";
+xeData.xdt_5_2_1 = "AllocationPolicy_t";
+xeData.xeleName_5_2_1 = "Internal VLAN Allocation Policy";
+allWebEnums[xeData["xe_5_2_1"] + "_5_2_1"] = [ "Ascending","Descending" ];
+xeData.xk_g_2_1_1 = 1;
+xeData.xe_g_2_1_1 = "e_v_g_2_1_1";
+xeData.doRef_g_2_1_1 = 0;
+xeData.xc_g_2_1_1 = "textbox";
+xeData.xp_g_2_1_1 = "read-write";
+xeData.xd_g_2_1_1 = "user";
+xeData.xdt_g_2_1_1 = "vlanRange_t";
+xeData.xeleName_g_2_1_1 = "VLAN ID";
+xeData["js_g_2_1_1_mandate"]=["vlan_validate_name_and_type","2_1_2|2_1_3|2_1_5|2_1_6"]
+xeData.xMaxLen_g_2_1_1 = "4";
+xeData.xattr_g_2_1_1 = ["noEdit=true","style=width:40px","discardNonInt=1"];
+xeData.xk_2_1_1 = 1;
+xeData.xe_2_1_1 = "e_v_2_1_1";
+xeData.doRef_2_1_1 = 0;
+xeData.xc_2_1_1 = "plain-label";
+xeData.xp_2_1_1 = "read-write";
+xeData.xd_2_1_1 = "user";
+xeData.xdt_2_1_1 = "vlanRange_t";
+xeData.xeleName_2_1_1 = "VLAN ID";
+xeData["js_2_1_1_mandate"]=["vlan_validate_name_and_type","2_1_2|2_1_3|2_1_5|2_1_6"]
+xeData.xMaxLen_2_1_1 = "4";
+xeData.xattr_2_1_1 = ["noEdit=true","style=width:40px","discardNonInt=1"];
+xeData.doRef_g_2_1_2 = 0;
+xeData.xc_g_2_1_2 = "textbox";
+xeData.xp_g_2_1_2 = "read-write";
+xeData.xd_g_2_1_2 = "user";
+xeData.xdt_g_2_1_2 = "string_t";
+xeData.xeleName_g_2_1_2 = "VLAN Name";
+xeData.xMaxLen_g_2_1_2 = "32";
+xeData.xattr_g_2_1_2 = ["style=width:80px","evalBlank=true"];
+xeData.doRef_2_1_2 = 0;
+xeData.xc_2_1_2 = "plain-label";
+xeData.xp_2_1_2 = "read-write";
+xeData.xd_2_1_2 = "user";
+xeData.xdt_2_1_2 = "string_t";
+xeData.xeleName_2_1_2 = "VLAN Name";
+xeData.xMaxLen_2_1_2 = "32";
+xeData.xattr_2_1_2 = ["style=width:80px","evalBlank=true"];
+xeData.xe_g_2_1_3 = "L7_VLAN_TYPE_t";
+xeData.doRef_g_2_1_3 = 0;
+xeData.xc_g_2_1_3 = "plain-label";
+xeData.xp_g_2_1_3 = "read-only";
+xeData.xd_g_2_1_3 = "enum";
+xeData.xdt_g_2_1_3 = "L7_VLAN_TYPE_t";
+xeData.xeleName_g_2_1_3 = "VLAN Type";
+allWebEnums[xeData["xe_g_2_1_3"] + "_g_2_1_3"] = [ "Default","Static","Dynamic (GVRP)","Dynamic (MVRP)","Dynamic (L2 Tunnel)","Dynamic (IP VLAN)","Dynamic (DOT1X)","Dynamic (OPENFLOW)","Auto-Video" ];
+xeData.xe_2_1_3 = "L7_VLAN_TYPE_t";
+xeData.doRef_2_1_3 = 0;
+xeData.xc_2_1_3 = "plain-label";
+xeData.xp_2_1_3 = "read-only";
+xeData.xd_2_1_3 = "enum";
+xeData.xdt_2_1_3 = "L7_VLAN_TYPE_t";
+xeData.xeleName_2_1_3 = "VLAN Type";
+allWebEnums[xeData["xe_2_1_3"] + "_2_1_3"] = [ "Default","Static","Dynamic (GVRP)","Dynamic (MVRP)","Dynamic (L2 Tunnel)","Dynamic (IP VLAN)","Dynamic (DOT1X)","Dynamic (OPENFLOW)","Auto-Video" ];
+xeData.xe_g_2_1_6 = "enable_t";
+xeData.doRef_g_2_1_6 = 0;
+xeData.xc_g_2_1_6 = "combo";
+xeData.xp_g_2_1_6 = "write-only";
+xeData.xd_g_2_1_6 = "string";
+xeData.xdt_g_2_1_6 = "string";
+xeData.xeleName_g_2_1_6 = "Make Static";
+allWebEnums[xeData["xe_g_2_1_6"] + "_g_2_1_6"] = [ "Enable","Disable" ];
+xeData.xe_2_1_6 = "enable_t";
+xeData.doRef_2_1_6 = 0;
+xeData.xc_2_1_6 = "plain-label";
+xeData.xp_2_1_6 = "write-only";
+xeData.xd_2_1_6 = "string";
+xeData.xdt_2_1_6 = "string";
+xeData.xeleName_2_1_6 = "Make Static";
+allWebEnums[xeData["xe_2_1_6"] + "_2_1_6"] = [ "Enable","Disable" ];
+xeData.xe_g_2_1_5 = "L7_VLAN_TYPE_t";
+xeData.doRef_g_2_1_5 = 0;
+xeData.xc_g_2_1_5 = "hidden";
+xeData.xp_g_2_1_5 = "read-write";
+xeData.xd_g_2_1_5 = "enum";
+xeData.xdt_g_2_1_5 = "L7_VLAN_TYPE_t";
+xeData.xeleName_g_2_1_5 = "VLAN Type";
+allWebEnums[xeData["xe_g_2_1_5"] + "_g_2_1_5"] = [ "Default","Static","Dynamic (GVRP)","Dynamic (MVRP)","Dynamic (L2 Tunnel)","Dynamic (IP VLAN)","Dynamic (DOT1X)","Dynamic (OPENFLOW)","Auto-Video" ];
+xeData.xe_2_1_5 = "L7_VLAN_TYPE_t";
+xeData.doRef_2_1_5 = 0;
+xeData.xc_2_1_5 = "hidden";
+xeData.xp_2_1_5 = "read-write";
+xeData.xd_2_1_5 = "enum";
+xeData.xdt_2_1_5 = "L7_VLAN_TYPE_t";
+xeData.xeleName_2_1_5 = "VLAN Type";
+allWebEnums[xeData["xe_2_1_5"] + "_2_1_5"] = [ "Default","Static","Dynamic (GVRP)","Dynamic (MVRP)","Dynamic (L2 Tunnel)","Dynamic (IP VLAN)","Dynamic (DOT1X)","Dynamic (OPENFLOW)","Auto-Video" ];
+xeData.xe_g_2_1_4 = "L7_ROW_STATUS_t";
+xeData.doRef_g_2_1_4 = 0;
+xeData.xc_g_2_1_4 = "hidden";
+xeData.xp_g_2_1_4 = "write-only";
+xeData.xd_g_2_1_4 = "row-status";
+xeData.xdt_g_2_1_4 = "L7_ROW_STATUS_t";
+xeData.xeleName_g_2_1_4 = "Vlan";
+allWebEnums[xeData["xe_g_2_1_4"] + "_g_2_1_4"] = [ "Invalid","Active","Not In Service","Not Ready","Add","Reserve","Delete","Modify" ];
+xeData.xe_2_1_4 = "L7_ROW_STATUS_t";
+xeData.doRef_2_1_4 = 0;
+xeData.xc_2_1_4 = "hidden";
+xeData.xp_2_1_4 = "write-only";
+xeData.xd_2_1_4 = "row-status";
+xeData.xdt_2_1_4 = "L7_ROW_STATUS_t";
+xeData.xeleName_2_1_4 = "Vlan";
+allWebEnums[xeData["xe_2_1_4"] + "_2_1_4"] = [ "Invalid","Active","Not In Service","Not Ready","Add","Reserve","Delete","Modify" ];
+xeData.xk_3_1_1 = 1;
+xeData.xe_3_1_1 = "e_v_3_1_1";
+xeData.doRef_3_1_1 = 0;
+xeData.xc_3_1_1 = "plain-label";
+xeData.xp_3_1_1 = "read-write";
+xeData.xd_3_1_1 = "user";
+xeData.xdt_3_1_1 = "vlanRange_t";
+xeData.xeleName_3_1_1 = "VLAN ID";
+xeData.doRef_3_1_2 = 0;
+xeData.xc_3_1_2 = "plain-label";
+xeData.xp_3_1_2 = "read-write";
+xeData.xd_3_1_2 = "user";
+xeData.xdt_3_1_2 = "string_t";
+xeData.xeleName_3_1_2 = "VLAN Name";
+xeData.xe_3_1_3 = "L7_VLAN_TYPE_t";
+xeData.doRef_3_1_3 = 0;
+xeData.xc_3_1_3 = "plain-label";
+xeData.xp_3_1_3 = "read-write";
+xeData.xd_3_1_3 = "enum";
+xeData.xdt_3_1_3 = "L7_VLAN_TYPE_t";
+xeData.xeleName_3_1_3 = "VLAN Type";
+allWebEnums[xeData["xe_3_1_3"] + "_3_1_3"] = [ "Default","Static","Dynamic (GVRP)","Dynamic (MVRP)","Dynamic (L2 Tunnel)","Dynamic (IP VLAN)","Dynamic (DOT1X)","Dynamic (OPENFLOW)","Auto-Video" ];
+xeData.xc_6_1_1 = "button";
+xeData.xt_6_1_1 = "8";
+xeData.xbt_6_1_1 = "buttonSubmit" ;
+xeData.xbImage_6_1_1 = "/base/images/Add_on.gif";
+xeData.xdImage_6_1_1 = "/base/images/Add_off.gif";
+xeData.xc_6_1_2 = "button";
+xeData.xt_6_1_2 = "8";
+xeData.xbt_6_1_2 = "buttonSubmit" ;
+xeData["js_6_1_2_button"]=["vlan_validate_name_and_type","2_1_2|2_1_3|2_1_5|2_1_6"]
+xeData.xbImage_6_1_2 = "/base/images/Delete_on.gif";
+xeData.xdImage_6_1_2 = "/base/images/Delete_off.gif";
+xeData.xc_6_1_6 = "button";
+xeData.xt_6_1_6 = "1";
+xeData.xbt_6_1_6 = "buttonClear" ;
+xeData.xbImage_6_1_6 = "/base/images/Refresh_on.gif";
+xeData.xdImage_6_1_6 = "/base/images/Refresh_off.gif";
+xeData.xc_6_1_3 = "button";
+xeData.xt_6_1_3 = "8";
+xeData.xbt_6_1_3 = "buttonRestore" ;
+xeData.xbImage_6_1_3 = "/base/images/Cancel_on.gif";
+xeData.xdImage_6_1_3 = "/base/images/Cancel_off.gif";
+xeData.xc_6_1_5 = "button";
+xeData.xt_6_1_5 = "8";
+xeData.xbt_6_1_5 = "buttonSubmit" ;
+xeData.xbImage_6_1_5 = "/base/images/Apply_on.gif";
+xeData.xdImage_6_1_5 = "/base/images/Apply_off.gif";
+xeData.xc_6_1_4 = "button";
+xeData.xt_6_1_4 = "8";
+xeData.xbt_6_1_4 = "buttonSubmit" ;
+xeData["js_6_1_4_button"]=["vlan_validate_name_and_type_apply","2_1_2|2_1_3|2_1_5|2_1_6"]
+xeData.xbImage_6_1_4 = "/base/images/Apply_on.gif";
+xeData.xdImage_6_1_4 = "/base/images/Apply_off.gif";
+xeData.elemWithExtnActions = [];
+xuiIncludeJSFile("/scripts/NetGearGlobalJS.js");
+
+function jScriptValidateUiAndElementLevel(xid,value)
+{
+var newVal = null;
+switch(xid)
+{
+case "g_2_1_2":
+newVal = jScriptValidateMapIdToVal(0,value);
+if(newVal != null) return newVal;
+newVal = jScriptValidateMapIdToVal(0,value);
+if(newVal != null) return newVal;
+newVal = jScriptValidateMapIdToVal(32,value);
+if(newVal != null) return newVal;
+break;
+default:
+break;
+}
+return null;
+}
+