example

#!/usr/bin/env python

"""
Script to create an item into a specific Object
 
This script could be used to create a new IP address into a NetObject,
 or add a service to a ServiceObject. 
 
The script uses the multiversion API.
"""

__version__ = "1.1 2008-11-14 Procera Networks"

###############################################################################
#
#                          NO WARRANTY
#
#  BECAUSE THE PROGRAM IS PROVIDED FREE OF CHARGE, THERE IS NO WARRANTY
#  FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
#  OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
#  PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
#  OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
#  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
#  TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
#  PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
#  REPAIR OR CORRECTION.
#
#  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
#  WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
#  REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
#  INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
#  OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
#  TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
#  YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
#  PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
#  POSSIBILITY OF SUCH DAMAGES.
#
###############################################################################

import sys
import packetlogic2

try:
    pladdr, pluser, plpass, objpath, item = sys.argv[1:]
except:
    print "Usage: %s PLADDRESS USER PASSWORD OBJECTPATH ITEM" % sys.argv[0]
    print "Examples:"
    print " %s PLADDRESS USER PASSWORD /NetObjects/Customers/C10 172.31.0.251" % sys.argv[0]
    print " %s PLADDRESS USER PASSWORD /ServiceObjects/allowed ftp-data" % sys.argv[0]
    sys.exit(1)
    
# try create a connection to the PacketLogic system, or exit program
try:
    pl = packetlogic2.connect(pladdr, pluser, plpass)
except:
    t, v, tb = sys.exc_info()
    print "Error: Couldn't connect: %s" % v
    sys.exit(1)

# connect to the rulset via the above initiated connection
r = pl.Ruleset()

# select the Object
obj = r.object_get(objpath)
# or exit if it doesn't exist
if obj is None:
    print "Error: Could not get ObjectPath: %s" % objpath
    sys.exit(1)

# if our item doesn't exist, add to the object
if not item in obj.items:
    obj.add(item)

# commit the changes to the PacketLogic system  
r.commit()