This Open project has been stopped updating. It's transftered to Open Project CRTT.

Refer this link: https://github.com/trelay/CRTT

CRTT is shortened for Common RESTful Test Tool; it can be used in following occasions:

• Test the reliability of RESTful server
• Find unknown issue
• Stress test for RESTful server
• Key String matching

• This tool is intended to support all kinds of RESTful server, from Redfish to...

0.1.0

from Red_lib.get_nodes import GET_NODE
get_node=GET_NODE(host, client_app_ver, port)
get_node.scan_node()

• --help: Print help message and exit
• --config-dir: Path to a config directory to pull *.conf files from
• --config-file: Path to a config file to use. Multiple config files can be specified, with values in later files taking precedence.
• --CLI-comp_file: The url response data comparing file
• --CLI-cycles: How many times we scan the nodes
• --CLI-time_to_stop: CLI_TIME_TO_STOP: If both this option and --CLI-cycles are set, the one which comes first will be effect.
• --CLI-retry: How many times retries after failure

This application provides a config file to let user customize, modify. One can change the setting in file Redfish.conf, here is the help for this document:

[REST]
client_name=redfish     #The name of the RESTful client application.
bind_port = 8888        #The port of the RESTful service.
ver_support = 1         #The ver list of the RESTful client application.
client_app_ver=1        #The ver of this RESTful client app
host=10.204.29.244      #The IP of this RESTful server 

[MAIN]
value_file=Red_lib/product/url_dict.conf    #This file is used to check the
    #response(response is in JSON format) from RESTful server .
cycle=20                #How many cycles to scan all the nodes

[LOG]
app_name='redfish_test'     #The log channel name
logfilename='redfish.html'  #The file name to save html log file
log_format='%(asctime)s %(name)-12s %(levelname)-8s %(message)s'
root_level=10               #The root log level
ch_level=10                 #The log level for console stream logging
fh_level=20                 #The log level for html file stream logging

html_color=color_2          #How we display the msg in the html file, it has options, choose one from below dict.
color_1=err_color: red, warn_color: yellow, info_color: white, dbg_color: white
color_2=err_color: red, warn_color: orange, info_color: white, dbg_color:blue

Keyword_Italic=True         #The setting of keyword in html log
Keyword_FontSize=3          #The setting of keyword in html log
Keyword_tag_start="<hl>"    #The setting of keyword in html log
Keyword_tag_end="</hl>"     #The setting of keyword in html log
title=Red fish log          #The tile for html log
console_log=True            #Display log to console?
HtmlmaxBytes=52428800       # You can specify particular values of maxBytes and backupCount to allow the 
                            #file to rollover at predetermined size if rotating is set to True, otherwise
                            #rotate file without backCount limited.
Html_backupCount=5
Html_Rotating=True

[REQUEST]
http_time_warn=0.5          #Setting of response time from RESTful server 
http_time_error=1.2         #Setting of response time from RESTful server 
timeout=3                   #The max time(second) to get response from RESTful server 
retries=4                   #How many times to retry if error occurs
delay=1.5                   #Time delay during a next retry if error occurs
backoff=2                   #backoff of delay
failonerror=False           #Stop test if fail still occurs if retries.

get_nodes.py: This file contains classes and functions: GEN_URL, GET_NODE, URL_REQUEST and Reponses check:

• GEN_URL: This class is to build complete URL. A complete URL to interact with RESTful server is like this: http://10.204.29.221:8888/redfish/v1/Managers/1 , here is example to use:

  url=GEN_URL('10.204.29.221')
  gen_url=GEN_URL('10.204.29.221')
  url=gen_url.get_url('/redfish/v1/Managers/1')

• GET_NODE: Scan and find all the child nodes from root(is node_path=None) or any node that is defined in function "scan_node", and put them into a list, during this scanning and searching, one can compare the value returned from RESTful server . url_list contains all the urls after scanning.

• URL_REQUEST: Send Request to RESTful server, generally, the request should be one of GET, PUT, POST, DELETE. This class can handle all http errors. Example:

  url_request=URL_REQUEST('http://10.204.29.221:8888/redfish/v1/Managers/1',username,password)
  url_request.get_req(value)   #Value: a python dict

• Reponse_check: It has two functions: 1. Check the response from RESTful server which defined in file url_dict.conf 2. Check if request time exceeds the limit.

retry.py: This file is a independent module, it's a decorator and used to retry a function in an particular error occurs.

• retry calling the decorated function using an exponential backoff. Example:

  @retry(ExceptionToCheck=ValueError,  tries=3, delay=1, backoff=1,stoponerror=False, logger=None)
  def foo():
     try:
        raise ValueError
     except ValueError as ve:
        raise

More details coming soon.

Free Software, Hell Yeah!