1 files changed, 36 insertions, 31 deletions
diff --git a/examples/v3arch/asyncore/oneliner/manager/cmdgen/get-v3-with-mib-lookup.py b/examples/v3arch/asyncore/oneliner/manager/cmdgen/get-v3-with-mib-lookup.py
index c01a61d..6e0d1c5 100644
--- a/examples/v3arch/asyncore/oneliner/manager/cmdgen/get-v3-with-mib-lookup.py
+++ b/examples/v3arch/asyncore/oneliner/manager/cmdgen/get-v3-with-mib-lookup.py
@@ -1,33 +1,38 @@
-#
-# Command Generator
-#
-# Send SNMP GET request using the following options:
-#
-# * with SNMPv3, user 'usr-md5-none', MD5 authentication, no privacy
-# * over IPv4/UDP
-# * to an Agent at demo.snmplabs.com:161
-# * for IF-MIB::ifInOctets.1 MIB object
-#
+"""
+SNMPv3: auth MD5, no privacy
+++++++++++++++++++++++++++++
+
+Send SNMP GET request using the following options:
+
+* with SNMPv3, user 'usr-md5-none', MD5 authentication, no privacy
+* over IPv4/UDP
+* to an Agent at demo.snmplabs.com:161
+* for IF-MIB::ifInOctets.1 MIB object
+
+Functionally similar to:
+
+| $ snmpget -v3 -l authNoPriv -u usr-md5-none -A authkey1 demo.snmplabs.com \
+|        IF-MIB::ifInOctets.1
+
+"""#
 from pysnmp.entity.rfc3413.oneliner.cmdgen import *
 
-for errorIndication, \
-    errorStatus, errorIndex, \
-    varBinds in getCmd(SnmpEngine(),
-                       UsmUserData('usr-md5-none', 'authkey1'),
-                       UdpTransportTarget(('demo.snmplabs.com', 161)),
-                       ContextData(),
-                       ObjectType(ObjectIdentity('IF-MIB', 'ifInOctets', 1))):
-    # Check for errors and print out results
-    if errorIndication:
-        print(errorIndication)
-    else:
-        if errorStatus:
-            print('%s at %s' % (
-                    errorStatus.prettyPrint(),
-                    errorIndex and varBinds[int(errorIndex)-1][0] or '?'
-                )
-            )
-        else:
-            for varBind in varBinds:
-                print(' = '.join([ x.prettyPrint() for x in varBind ]))
-    break
+errorIndication, errorStatus, errorIndex, varBinds = next(
+    getCmd(SnmpEngine(),
+            UsmUserData('usr-md5-none', 'authkey1'),
+            UdpTransportTarget(('demo.snmplabs.com', 161)),
+            ContextData(),
+            ObjectType(ObjectIdentity('IF-MIB', 'ifInOctets', 1)))
+)
+
+if errorIndication:
+    print(errorIndication)
+elif errorStatus:
+    print('%s at %s' % (
+            errorStatus.prettyPrint(),
+            errorIndex and varBinds[int(errorIndex)-1][0] or '?'
+        )
+    )
+else:
+    for varBind in varBinds:
+        print(' = '.join([ x.prettyPrint() for x in varBind ]))