syntax=’asa’

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

This configuration parse reads the configuration as asa syntax.

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

This is the same as using:

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

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

syntax=’asa’, factory=True example

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

>>> from ciscoconfparse import CiscoConfParse
>>> parse = CiscoConfParse("tests/fixtures/configs/sample_01.asa", syntax="asa", factory=True)
>>> ipv4_intfs = parse.find_parent_objects("interface", " ip address")
>>>
>>> ipv4_intfs[2]
<ASAIntfLine # 78 'interface Vlan200' info: '<IPv4Obj 192.0.2.1/24>'>
>>>
>>> ipv4_intfs[2].ipv4
<IPv4Obj 192.0.2.1/24>
>>>

syntax=’asa’, factory=False example

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

>>> from ciscoconfparse import CiscoConfParse
>>> parse = CiscoConfParse("tests/fixtures/configs/sample_01.asa", syntax="asa", factory=False)
>>> ipv4_intfs = parse.find_parent_objects("interface", " ip address")
>>>
>>> ipv4_intfs[2]
<NXOSCfgLine # 78 'interface Vlan200'>
>>>
>>> ipv4_intfs[2].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'
>>>