Robot Framework 源码解析（1） - java入口点

一直很好奇Robot Framework 是如何通过关键字驱动进行测试的，好奇它是如何支持那么多库的，好奇它是如何完成截图的。所以就打算研究一下它的源码。

这是官方给出的Robot framework模块化结构:

它的用法暂且不说，网上有很多. 这是我的一个实例。“打开浏览器，baidu搜索一个字符串。”

Robot Framework有很多入口点，比如

1. java -jar robotframework.jar test.robot

2. robot path/to/tests.robot

3. robot --include tag1 --include tag2 --splitlog tests.robot

4. robot --name Example --log NONE t1.robot t2.robot > stdout.txt

因为对java相对比较熟悉一些，所以就从java的入口的点org.robotframework.RobotFramework开始看起。

java -jar robotframework.jar mytests.robot
java -jar robotframework.jar run mytests.robot
java -jar robotframework.jar rebot --log mylog.html out.xml
java -jar robotframework.jar tidy --format robot mytests.html

 package org.robotframework;

 /**
  *
  * Entry point for using Robot Framework from Java programs.
  *
  */
 public class RobotFramework {

     public static void main(String[] args) {
         int rc = run(args);
         System.exit(rc);
     }

     public static int run(String[] args) {
         try (RobotRunner runner = new RobotRunner()) {
             return runner.run(args);
         }
     }
 }

main方法，是程序的入口，命令行传入的参数传递给main方法。通过  int rc = run(args); 将命令后参数传递给run方法。

接下来看run方法是做什么的。

在这里创建了一个RobotRunner的实例，调用该实例的run方法，并且将命令行参数传递给了RobotRunner的run方法。

继续看RobotRunner都做了些什么。

构造函数

 public RobotRunner() {
       interpreter = new PythonInterpreter();
       runner = createRunner();
 }

run方法：

     public int run(String[] args) {
         return runner.run(args);
     }

RobotRunner 内部创建一个Jython解释器PythonInterpreter对象和 robot.JarRunner 来运行Robot测试。另外RobotRunner 是一个AutoCloseable接口的实现类，可以在try-cache块中自动的关闭资源，以清理解释器。

在RobotRunner 的run方法中可以看到，它是通过RobotPythonRunner的run方法来执行Robot测试的

接下来看 RobotPythonRunner是如何执行Robot测试的：

可是RobotPythonRunner是一个接口！只能去找它的实现类了。src/robot/jarrunner.py 是RobotPythonRunner的实现类。

 class JarRunner(RobotPythonRunner):
     """Used for Java-Jython interop when RF is executed from .jar file."""
     _commands = {'run': run_cli, 'rebot': rebot_cli, 'tidy': tidy_cli,
                  'libdoc': libdoc_cli, 'testdoc': testdoc_cli}

     def run(self, args):
         try:
             self._run(args)
         except SystemExit as err:
             return err.code

     def _run(self, args):
         if not args or args[0] in ('-h', '--help'):
             print(USAGE)
             raise SystemExit(INFO_PRINTED)
         command, args = self._parse_command_line(args)
         command(args)  # Always calls sys.exit()

     def _parse_command_line(self, args):
         if args[0] in self._commands:
             return self._commands[args[0]], args[1:]
         return run_cli, args

这个JarRunner其实也没有做什么, 除了解析main(String[] args)方法的参数（第16行），也就是命令行的参数，并且根据参数判断调用哪个方法（第17行）。

例如：java -jar robotframework.jar run mytests.robot这个命令，经过JarRunner解析会最终调用run_cli(mytests.robot)这个方法。

java -jar robotframework.jar rebot --log mylog.html out.xml这个命令，经过JarRunner解析会最终调用rebot_cli(--log,mylog.html,out.xml)这个方法。

java的命令行入口其实最终还是转到了其它入口点：

• robot.run entry point for executing tests.
• robot.rebot entry point for post-processing outputs (Rebot).
• robot.libdoc entry point for Libdoc tool.
• robot.testdoc entry point for Testdoc tool.
• robot.tidy entry point for Tidy tool

下一章，我接着来分析执行测试的入口点robot.run.

如果喜欢作者的文章，请关注"写代码的猿"订阅号以便第一时间获得最新内容。本文版权归作者所有，欢迎转载.