Skip to content

Commit 2829469

Browse files
committed
Improve doc
1 parent adecfa6 commit 2829469

File tree

2 files changed

+14
-4
lines changed

2 files changed

+14
-4
lines changed

README.md

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -109,7 +109,7 @@ from cisco_gnmi import ClientBuilder
109109

110110
client = ClientBuilder(
111111
'127.0.0.1:9339'
112-
).set_os('IOS XR').set_secure_from_file(
112+
).set_os('IOS XE').set_secure_from_file(
113113
root_certificates='rootCA.pem',
114114
private_key='client.key',
115115
certificate_chain='client.crt',
@@ -125,10 +125,20 @@ client = ClientBuilder(
125125

126126
Methods are documented in [`src/cisco_gnmi/client.py`](src/cisco_gnmi/client.py).
127127

128+
### NXClient
129+
`NXClient` inherits from `Client` and provides several wrapper methods which aid with NX-OS gNMI implementation usage. These are `subscribe_xpaths`, and the removal of `get` and `set` as they are not yet supported operations. These methods have some helpers and constraints around what is supported by the implementation.
130+
131+
Methods and usage examples are documented in [`src/cisco_gnmi/nx.py`](src/cisco_gnmi/nx.py).
132+
133+
### XEClient
134+
`XEClient` inherits from `Client` and provides several wrapper methods which aid with IOS XE gNMI implementation usage. These are `delete_xpaths`, `get_xpaths`, `set_json`, and `subscribe_xpaths`. These methods have some helpers and constraints around what is supported by the implementation.
135+
136+
Methods and usage examples are documented in [`src/cisco_gnmi/xe.py`](src/cisco_gnmi/xe.py).
137+
128138
### XRClient
129-
`XRClient` inherets from `Client` and provides several wrapper methods which aid with IOS XR-specific behaviors of the gNMI implementation. These are `delete_xpaths`, `get_xpaths`, `set_json`, and `subscribe_xpaths`. These methods make several assumptions about what kind of information will be supplied to them in order to simplify usage of the gNMI RPCs, detailed in the documentation.
139+
`XRClient` inherits from `Client` and provides several wrapper methods which aid with IOS XR gNMI implementation usage. These are `delete_xpaths`, `get_xpaths`, `set_json`, and `subscribe_xpaths`. These methods have some helpers and constraints around what is supported by the implementation.
130140

131-
Methods are documented in [`src/cisco_gnmi/xr.py`](src/cisco_gnmi/xr.py).
141+
Methods and usage examples are documented in [`src/cisco_gnmi/xr.py`](src/cisco_gnmi/xr.py).
132142

133143
## gNMI
134144
gRPC Network Management Interface (gNMI) is a service defining an interface for a network management system (NMS) to interact with a network element. It may be thought of as akin to NETCONF or other control protocols which define operations and behaviors. The scope of gNMI is relatively simple - it seeks to "[[define](https://github.com/openconfig/reference/blob/master/rpc/gnmi/gnmi-specification.md)] a gRPC-based protocol for the modification and retrieval of configuration from a target device, as well as the control and generation of telemetry streams from a target device to a data collection system. The intention is that a single gRPC service definition can cover both configuration and telemetry - allowing a single implementation on the target, as well as a single NMS element to interact with the device via telemetry and configuration RPCs".

src/cisco_gnmi/xe.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -310,7 +310,7 @@ def subscribe_xpaths(
310310
return self.subscribe([subscription_list])
311311

312312
def parse_xpath_to_gnmi_path(self, xpath, origin=None):
313-
"""Naievely tries to intelligently (non-sequitur!) origin
313+
"""Naively tries to intelligently (non-sequitur!) origin
314314
Otherwise assume rfc7951
315315
legacy is not considered
316316
"""

0 commit comments

Comments
 (0)