Evaluate該怎麼用?

Builtin的RobotFramework Library提供了Evaluate Keyword。它所提供的功能是「執行Python描述句」。但實際上到底有什麼用途呢?原本我僅僅拿來將string轉為int的功用,經過一些查詢與試驗,我將心得整理給大家。

Builtin的function可以參考Library Doc for Evaluate。我以有使用過的function做說明。

數字轉換

Python提供了int、long、float與complex等function讓你可以將字串轉為數字,也可以透過它們做四則運算。首先以字串轉數字為例,我將8設於${num_str}中,再透過Evaluate+int轉為數字。這裡必須注意的是: 「int()中放變數必須以單引號'括起」。否則,假如你設定的數字為08,在轉換int時會出現Syntax Error。

${num_str} | Set Variable | 8
${num} | Evaluate | int('${num_str}')
其中int與long的第二個參數為base,這是根據你的input所決定:
Comment | num = 9
${num} | Evaluate | int('11', 8) 
Comment | num = 11
${num} | Evaluate | int('11', 10)
Comment | num = 17
${num} | Evaluate | int('11', 16)
其它還有像bin、oct、hex,可以將整數轉為2、8、16進位。

運算

四則運算: 直接將運算子加上即可:

${num} | Evaluate | int('${hour}')*60 + int('${min}')
指數: 可以用pow。以下面兩個例子來說,第一個是2的3次方為8,第二個是2的3次方再mod 7為1。需注意的是: 「傳入值必須是數字不可為字串」。
${num} | Evaluate | pow(2,3)
${num} | Evaluate | pow(2,3,7)
取最大最小值: 使用max/min,可以選擇丟一個array的方式,也可以當多個參數傳入。
@{num_list} | Create List | 2 | 3 | 5 | 7
${num} | Evaluate | max(@{num_list})
${num} | Evaluate | min(@{num_list})
${num} | Evaluate | min(1,3,5,7)
其它還有abs、ord、unichar等functions,這部分就當大家的功課了。

在前一節中,是直接透過使用function去達到你的需求,因為在Python中,函式也是屬於First-Class。在這部分主要分享給你的,是基於物件所提供的函式。

Builtin-Type Function

以前剛開始寫Robot時,只是想做tolowercase與touppercase的字串轉換。但因為Robot本身的Library中並沒有提供這樣的Keyword,只好自己寫一個出來。要達到這個需求,除了使用Plugin寫法去引用Java或Python中的字串函式外,Evaluate也能達到一樣的效力。我直接使用Built-in DataType的function來達到lower與upper的轉換:

${str} | Set Variable | TEMP
${lower_str} | Evaluate | '${str}'.lower()
${upper_str} | Evaluate | '${str}'.upper()
其它還有關於數字、檔案之類的函式介紹,但我想會寫在Robot內的應該都是操作String居多吧..

Module Function

Python有一堆有的沒的Module,我們也可以在Robot中使用它們。使用相當簡單,只要做匯入模組後,就可以透過它所提供的類別與對應函式做操作。我以操作datetime與os做例子:

datetime

datetime就是提供操作date與time相關功能的類別。我們直接來看看如何使用:

${today} | Evaluate | datetime.date.today() | datetime
第三個參數是Python語句,第四個參數是我所匯入的模組。假如我只有執行datetime.date,動作僅是取得一個date物件,對Robot本身並沒有甚麼用途。以下面的例子來說,${date}也只是得到一個<class 'datetime.date'>的字串,無法拿它來做下一個Evaluate操作。
${date} | Evaluate | datetime.date | datetime

os

os提供os相依的功能。它所提供的類別與函式並非都能跨平台,必須仔細看清楚它的文件說明。使用方式也與datetime類似,我以取得系統變數SystemRoot為例子:

${today} | Evaluate | os.environ['SystemRoot'] | os

math

math提供math相依功能,想做函數運算可以查查它的文件說明。

${ceil} | Evaluate | math.ceil(int(${a}/float${b})) | math
${floor} | Evaluate | math.floor(int(${a}/float${b})) | math

其實只要能看得懂Python Document,Evaluate就可以隨心所欲的用啦。要謹記在心的是: 不是每一個function都能夠使用,因為Robot並不一定能夠接受Python參數與回傳格式,而且function會根據Python版本去支援。如果你是透過RobotFramework的jar,那它所用的Python版本就要看Jython。假如使用了不支援的function,以bin()來說,應該會看到NameError: name 'bin' is not defined的錯誤訊息,這時候就要自己來了!

友藏內心獨白: 沒有妳在我都自己來~我都自己來。