Function Syntax

You are advised to use Python 3.6.

FunctionGraph supports Python 2.7 and Python 3.6.

Syntax for creating a handler function in Python:

def handler (event, context)

• handler: name of the function that FunctionGraph invokes to execute your code. The name must be consistent with that you define when creating a function.
• event: event parameter defined for the function. The parameter is in JSON format.
• Context: runtime information provided for executing the function. For details, see SDK APIs.

SDK APIs

Table 1 describes the context methods provided by FunctionGraph.

Results returned by using the getToken(), getAccessKey(), and getSecretKey() methods contain sensitive information. Exercise caution when using these methods.

Developing a Python Function

Perform the following steps to develop a Python function:

Python 2.7 is used an example.

1. Create a function project.
   1. Write code for printing text helloworld.

      Open the text editor, compile a HelloWorld function, and save the code file as helloworld.py. The code is as follows:

      1 2	def printhello(): print 'hello world!'

   2. Define a FunctionGraph function.

      Open the text editor, define a function, and save the function file as index.py under the same directory as the helloworld.py file. The function code is as follows:

      1 2 3 4 5 6 7

      import json import helloworld def handler (event, context): output =json.dumps(event) helloworld.printhello() return output

   

   FunctionGraph can return only the following types of values:

   • None: The HTTP response body is empty.
   • String: The content in this string is the body of an HTTP response.
   • Other: For a value rather than None or String, FunctionGraph encodes the value in JSON, and uses the encoded object as the body of an HTTP response. The Content-Type header of the HTTP response is set to application/json.

2. Package the project files.

   After creating the function project, you get the following directory. Select all files under the directory and package them into the fss_examples_python2.7.zip file, as shown in Figure 1.

   Figure 1 Packaging the project files
   
   

   • In this example, the function project files are saved under the ~/Code/ directory. Select and package all files under the directory to ensure that the index.py file, the handler of your FunctionGraph function, is under the root directory when the ZIP file is decompressed.
   • When you write code in Python, do not name your package with the same suffix as a standard Python library, such as json, lib, and os. Otherwise, an error will be reported indicating a module loading failure.

3. Create a FunctionGraph function and upload the code package.
   Log in to the FunctionGraph console, create a Python function, and upload the fss_examples_python2.7.zip file, as shown in Figure 2.

   Figure 2 Uploading the code package
   
   

   1. The index of the handler must be consistent with the file name of your function, because the file name will help to locate the function file.
   2. The handler is a function name, which must be consistent with that defined in the index.py file.
   3. After you upload the fss_examples_python2.7.zip file to OBS, when the function is triggered, FunctionGraph decompresses the file to locate the function file through index and locate the function defined in the index.py file through handler, and then executes the function.

4. Test the function.
   1. Create a test event.

      On the function details page that is displayed, choose Select test event > Configure test event. Configure the test event information, as shown in Figure 3, and then click Save.

      Figure 3 Configuring a test event
      
   2. On the function details page, select the configured test event, and click Test.

5. View the function execution result.

   The function execution result consists of three parts: function output (returned by callback), summary, and logs (output by using the console.log or getLogger() method), as shown in Figure 4.

   Figure 4 Test result
   

Execution Result

The execution result consists of the function output, summary, and log output.

{
    "errorMessage": "",
    "errorType": "",
    "stackTrace": []
}

Example of the function output when a function fails to be executed:

{
    "errorMessage": "Syntax error in module 'index'(invalid syntax (index.py, line 5))",
    "errorType": "SyntaxError",
    "stackTrace": [
        "File \"./index.py\", line 5",
        "  for i in range (1,1000000):"
    ]
}

Example of the log output when a function fails to be executed:

2020/07/27 14:28:14 GMT+08:00  Start invoke request '7b37809b-a086-49c9-9bfd-fdf55ec7f8d3', version: latest
2020/07/27 14:28:14 GMT+08:00  7b37809b-a086-49c9-9bfd-fdf55ec7f8d3 Syntax error in module 'index'(invalid syntax (index.py, line 5))
Traceback (most recent call last):
  File "/opt/function/code/index.py", line 5
    for i in range (1,1000000):
                              ^
SyntaxError: invalid syntax
2020/07/27 14:28:14 GMT+08:00  Finish invoke request '7b37809b-a086-49c9-9bfd-fdf55ec7f8d3'(invoke Failed), duration: 9.593ms, billing duration: 100ms, memory used: 65.000MB