syntax=’iosxr’

syntax='iosxr' should be used for Cisco IOS XR configurations. By default syntax='ios' is used and it’s a good default for many vendor configurations (without braces); however, syntax='iosxr' handles situations as described below.

This configuration parse reads the configuration as iosxr syntax.

>>> from ciscoconfparse import CiscoConfParse
>>> parse = CiscoConfParse('/tftpboot/sfob09f02rtr01.conf', syntax='iosxr')
>>>

This is the same as using:

>>> from ciscoconfparse import CiscoConfParse
>>> parse = CiscoConfParse('/tftpboot/sfob09f02rtr01.conf', syntax='iosxr', factory=False)
>>>

When using syntax='iosxr' also consider the factory setting; for more information, see the factory page.

syntax=’iosxr’, factory=True example

Documentation for IOSXRIntfLine properties: IOSXRIntfLine().
This is an example of getting an IPv4Obj() for an IOSXRIntfLine() that was parsed with factory=True.

>>> from ciscoconfparse import CiscoConfParse
>>> parse = CiscoConfParse("tests/fixtures/configs/sample_01.iosxr", syntax="iosxr", factory=True)
>>> ipv4_intfs = parse.find_parent_objects("interface", "  ipv4 address")
>>>
>>> ipv4_intfs[0]
<IOSXRIntfLine # 120 'interface Loopback0' info: '100.2.3.20/32'>
>>>
>>> ipv4_intfs[0].ipv4
<IPv4Obj 10.10.248.50/24>
>>>

syntax=’iosxr’, factory=False example

This is the same operation with factory=False; we expect an AttributeError because factory=False returns IOSXRCfgLine() instances instead of IOSXRIntfLine() instances (which have the ipv4 attribute).

>>> from ciscoconfparse import CiscoConfParse
>>> parse = CiscoConfParse("tests/fixtures/configs/sample_01.iosxr", syntax="iosxr", factory=False)
>>> ipv4_intfs = parse.find_parent_objects("interface", "  ipv4 address")
>>>
>>> ipv4_intfs[0]
<IOSXRCfgLine # 120 'interface Loopback0'>
>>>
>>> ipv4_intfs[0].ipv4
2023-11-18 07:00:21.216 | ERROR    | ciscoconfparse.ccp_abc:__getattr__:142 - The ipv4 attribute does not exist
2023-11-18 07:00:21.217 | ERROR    | __main__:<module>:1 - An error has been caught in function '<module>', process 'MainProcess' (111007), thread 'MainThread' (139675861627520):
Traceback (most recent call last):

  File "/home/mpenning/fixme/ciscoconfparse/ciscoconfparse/ccp_abc.py", line 138, in __getattr__
    retval = getattr(object, attr)
                             └ 'ipv4'

AttributeError: type object 'object' has no attribute 'ipv4'
>>>