blob: 7cd73759a855de25231d036cd6ad23d367294806 [file] [log] [blame]
#!/usr/bin/env python
import requests, sys, getopt, json
COMMANDS = [ 'show','reset', 'add','delete','deploy',"V_BUFS","NUM_BUFS", "INPUT_MODE", "TX_MODE", "QUEUE_TYPE" ]
trafficTypes = ['TSA_CP','TSA_UP', 'TAA_CP', 'TAA_UP']
INPUT_MODES=["mmap","pfring","pfring_zc","dpdk"]
TX_MODES=["frp_udp","frp_tcp","viv"]
QUEUE_TYPES=["CLFFIFO","dpdk"]
RESOURCE_NAMES = [ 'V_BUFS', 'NUM_BUFS', 'INPUT_MODE', 'TX_MODE', 'QUEUE_TYPE']
settings = {
'ipAddress':'127.0.0.1',
'port':'8080',
'api_version':'v1.0',
'resource': 'vivs/1',
'operation':'GET',
'verbose': False,
'data': None
}
class restClient:
def doIt( self, settings ):
try:
hdrs = { 'Accept':'application/json','content-type':'application/json' }
url = "http://%s:%s/%s" % ( settings['ipAddress'], settings['port'], settings['api_version'] )
if settings['resource']:
url = "%s/%s" % (url, settings['resource'])
if settings['operation'] == 'GET':
r = requests.get( url, headers = hdrs )
elif settings['operation'] == 'POST':
data = json.loads(settings['data'])
r = requests.post( url, data=json.dumps(data), headers = hdrs )
if r.status_code == requests.codes.ok:
if r.headers['content-type'] == 'application/json':
print json.dumps( r.json(), indent=4 )
else:
print "Received unexpected content type: %s" % r.headers['content-type']
if settings['verbose']:
print r.text
if settings['verbose']:
print "\nOperation:\n %s" % settings['operation']
print "\nURL:\n %s" % r.url
print "\nHeaders sent:\n %s" % r.request.headers
print "\nResponse status code:\n %s" % r.status_code
except requests.ConnectionError as e:
print e
raise # re-raise exception
except ValueError as e:
print "Invalid JSON: %s" % e
raise # re-raise exception
def stringFromList( p ):
"""
e.g. ['a', 'b', 'c' ] becomes "[a|b|c]"
"""
return str( p ).replace("'","").replace(", ","|")
def usage():
print "Usage:"
print " $ %s [-i ip][-p port][-a version][-v] command" % sys.argv[0]
print ""
print "optional arguments:"
print " -i <ip> IP address of server. (Default: 127.0.0.1)"
print " -p <port> Port on server. (Default: 8080)"
print " -a <version> API version to use. (Default: v1.0)"
print " -v Be verbose"
print ""
print "command"
print "-------"
print " show [<path>]"
print " add input <device> <type> [<type> [...]]"
print " add output <ip_address> <port> <type>"
print " delete input <device> [<type> [<type> [...]]]"
print " delete output <ip_address>[:<port>] [<type> [<type> [...]]]"
print " reset"
print " deploy"
print ""
print " V_BUFS <value>"
print " NUM_BUFS <value>"
print " INPUT_MODE <input-mode>"
print " TX_MODE <tx-mode>"
print " QUEUE_TYPE <queue-type>"
print ""
print ""
print " Where:"
print " <type> = %s" % stringFromList( trafficTypes )
print " <input_mode> = %s" % stringFromList(INPUT_MODES )
print " <tx-mode> = %s" % stringFromList( QUEUE_TYPES )
print ""
def getTrafficTypes( args ):
traffic_types=[]
while len(args) > 0:
t = args.pop(0)
if t not in trafficTypes:
raise ValueError("Invalid traffic type '%s'" % t )
traffic_types.append( t )
return traffic_types
def parseAddInputCommand( args ):
if len( args ) < 2:
raise ValueError("Usage: %s add input <device> <traffic_type> [<traffic_type> [...]]" % sys.argv[0] )
device = args.pop(0)
tt = getTrafficTypes( args )
data = { "inputs":[{"device":device,"traffic_types":tt}]}
settings['resource']='vivs/1/add'
settings['operation']='POST'
settings['data'] = json.dumps( data )
def parseAddOutputCommand( args ):
if len( args ) != 3:
raise ValueError("Usage: %s add output <ip_address> <port> <traffic_type>" % sys.argv[0] )
ip_address = args.pop(0)
port = args.pop(0)
traffic_type = args.pop(0)
if traffic_type not in trafficTypes:
raise ValueError("Invalid traffic type '%s'" % traffic_type )
data = {"outputs":[{"ip_address":ip_address,"type":traffic_type,"port":port}]}
settings['resource']='vivs/1/add'
settings['operation']='POST'
settings['data'] = json.dumps( data )
def parseDeleteInputCommand( args ):
if len( args ) < 1:
raise ValueError( "Usage: %s delete input <device> [<traffic_type> [<traffic_type> [...]]]" % sys.argv[0] )
device = args.pop(0)
tt = getTrafficTypes( args )
data = {"inputs":[{"device":device,"traffic_types":tt}]}
settings['resource']='vivs/1/delete'
settings['operation']='POST'
settings['data'] = json.dumps( data )
def parseDeleteOutputCommand( args ):
if len(args) == 0:
raise ValueError( "Usage: %s delete output <ip_address>[:<port>] [<traffic_type> [<traffic_type> [...]]]" % sys.argv[0] )
ipp = args.pop(0).split(':')
ip_address = ipp[0]
try:
port = ipp[1]
except IndexError:
# No port was specified
# All ports with spec'd traffic types will be removed for
# the IP given.
port = None
tt = getTrafficTypes( args )
data = {"outputs":[{"ip_address":ip_address,"port":port, "traffic_types":tt}]}
settings['resource']='vivs/1/delete'
settings['operation']='POST'
settings['data'] = json.dumps( data )
def parseArgs( argv ):
try:
opts,args = getopt.getopt( argv,
"i:p:a:vh", ["ip=","port=","api_version="])
except getopt.GetoptError as e:
print e
raise # re-raise exception
for opt,arg in opts:
if opt == '-h':
usage()
sys.exit()
elif opt == '-v':
settings['verbose'] = True
elif opt in ("-i","--ip"):
settings['ipAddress'] = arg
elif opt in ("-p","--port"):
settings['port'] = arg
elif opt in ("-a","--api_version"):
settings['api_version'] = arg
# process residual non option args
if len(args) == 0:
raise ValueError( "Expected one of: %s" % str( COMMANDS ) )
cmd = args.pop(0)
if cmd not in COMMANDS:
print 'Unknown command', cmd
sys.exit(1)
if cmd in ['show']:
if len(args) != 0:
settings['resource'] = args.pop(0)
elif cmd in ['reset']:
settings['resource']='vivs/1/reset'
settings['operation'] = 'POST'
settings['data'] = json.dumps( {} )
elif cmd in ['add']:
if len(args) == 0:
raise ValueError("Expected 'input' or 'output'")
direction = args.pop(0)
if direction not in ['input','output']:
raise ValueError( "expected 'input' or 'output', found '%s'" % direction )
if direction == 'input':
parseAddInputCommand( args )
else:
parseAddOutputCommand( args )
elif cmd in ['delete']:
if len(args) == 0:
raise ValueError("Expected 'input' or 'output'" )
direction = args.pop(0)
if direction not in ['input','output']:
raise ValueError("expected 'input' or 'output', found '%s'" % direction )
if direction == 'input':
parseDeleteInputCommand( args )
else:
parseDeleteOutputCommand( args )
elif cmd in ['deploy']:
settings['resource']='vivs/1/deploy'
settings['operation'] = 'POST'
settings['data'] = '{}'
else:
if cmd in RESOURCE_NAMES:
if len( args ) == 0 :
raise ValueError( 'No value supplied' )
val = args.pop(0)
# The server will complain if it does not like the value.
settings['resource']='vivs/1/%s' % cmd
settings['operation'] = 'POST'
settings['data'] = json.dumps( { cmd : val } )
return settings
def RestClient(argv):
settings = parseArgs( argv )
client = restClient()
client.doIt( settings )
if __name__ == '__main__':
try:
RestClient(sys.argv[1:])
except ValueError as e:
print e
sys.exit(2)
except getopt.GetoptError as e:
print e
sys.exit(3)
except requests.ConnectionError as e:
print e
sys.exit(4)