1

"Commons definitions for sikuli based beremiz IDE GUI tests"

     2

     3

import os

     4

import sys

     5

import subprocess

     6

import traceback

     7

import signal

     8

from threading import Thread, Event, Lock

     9

from time import time as timesec

    10

    11

import sikuli

    12

    13

beremiz_path = os.environ["BEREMIZPATH"]

    14

python_bin = os.environ.get("BEREMIZPYTHONPATH", "/usr/bin/python")

    15

    16

opj = os.path.join

    17

    18

    19

class KBDShortcut:

    20

    """Send shortut to app by calling corresponding methods.

    21

    22

    example:

    23

        k = KBDShortcut()

    24

        k.Clean()

    25

    """

    26

    27

    fkeys = {"Stop":     sikuli.Key.F4,

    28

             "Run":      sikuli.Key.F5,

    29

             "Transfer": sikuli.Key.F6,

    30

             "Connect":  sikuli.Key.F7,

    31

             "Clean":    sikuli.Key.F9,

    32

             "Build":    sikuli.Key.F11,

    33

             "Save":     ("s",sikuli.Key.CTRL),

    34

             "New":      ("n",sikuli.Key.CTRL),

    35

             "Address":  ("l",sikuli.Key.CTRL)}  # to reach address bar in GTK's file selector

    36

    37

    def __init__(self, app):

    38

        self.app = app

    39

    40

    def __getattr__(self, name):

    41

        fkey = self.fkeys[name]

    42

        if type(fkey) != tuple:

    43

            fkey = (fkey,)

    44

    45

        def PressShortCut():

    46

            self.app.sikuliapp.focus()

    47

            sikuli.type(*fkey)

    48

            self.app.ReportText("Sending " + name + " shortcut")

    49

    50

        return PressShortCut

    51

    52

    53

class IDEIdleObserver:

    54

    "Detects when IDE is idle. This is particularly handy when staring an operation and witing for the en of it."

    55

    56

    def __init__(self):

    57

        """

    58

        Parameters: 

    59

            app (class BeremizApp)

    60

        """

    61

        self.r = sikuli.Region(self.sikuliapp.window())

    62

    63

        self.idechanged = False

    64

    65

        # 200 was selected because default 50 was still catching cursor blinking in console

    66

        # FIXME : remove blinking cursor in console

    67

        self.r.onChange(200,self._OnIDEWindowChange)

    68

        self.r.observeInBackground()

    69

    70

    def __del__(self):

    71

        self.r.stopObserver()

    72

    73

    def _OnIDEWindowChange(self, event):

    74

        self.idechanged = True

    75

    76

    def WaitIdleUI(self, period=1, timeout=15):

    77

        """

    78

        Wait for IDE to stop changing

    79

        Parameters: 

    80

            period (int): how many seconds with no change to consider idle

    81

            timeout (int): how long to wait for idle, in seconds

    82

        """

    83

        c = max(timeout/period,1)

    84

        while c > 0:

    85

            self.idechanged = False

    86

            sikuli.wait(period)

    87

            if not self.idechanged:

    88

                break

    89

            c = c - 1

    90

    91

        self.ReportScreenShot("UI is idle" if c != 0 else "UI is not idle")

    92

    93

        if c == 0:

    94

            raise Exception("Window did not idle before timeout")

    95

    96

    97

class stdoutIdleObserver:

    98

    "Detects when IDE's stdout is idle. Can be more reliable than pixel based version (false changes ?)"

    99

   100

    def __init__(self):

   101

        """

   102

        Parameters: 

   103

            app (class BeremizApp)

   104

        """

   105

        self.stdoutchanged = False

   106

   107

        self.event = Event()

   108

   109

        self.pattern = None

   110

        self.success_event = Event()

   111

   112

        if self.proc is not None:

   113

            self.thread = Thread(target = self._waitStdoutProc).start()

   114

   115

    def __del__(self):

   116

        pass  # self.thread.join() ?

   117

   118

    def _waitStdoutProc(self):

   119

        while True:

   120

            a = self.proc.stdout.readline()

   121

            if len(a) == 0 or a is None: 

   122

                break

   123

            self.ReportOutput(a)

   124

            self.event.set()

   125

            if self.pattern is not None and a.find(self.pattern) >= 0:

   126

                sys.stdout.write("found pattern in '" + a +"'")

   127

                self.success_event.set()

   128

   129

    def waitForChangeAndIdleStdout(self, period=2, timeout=15):

   130

        """

   131

        Wait for IDE'stdout to start changing

   132

        Parameters: 

   133

            timeout (int): how long to wait for change, in seconds

   134

        """

   135

        start_time = timesec()

   136

   137

        wait_result = self.event.wait(timeout)

   138

   139

        self.ReportScreenShot("stdout changed" if wait_result else "stdout didn't change")

   140

   141

        if wait_result:

   142

            self.event.clear()

   143

        else:

   144

            raise Exception("Stdout didn't become active before timeout")

   145

   146

        self.waitIdleStdout(period, timeout - (timesec() - start_time))

   147

   148

    def waitIdleStdout(self, period=2, timeout=15):

   149

        """

   150

        Wait for IDE'stdout to stop changing

   151

        Parameters: 

   152

            period (int): how many seconds with no change to consider idle

   153

            timeout (int): how long to wait for idle, in seconds

   154

        """

   155

        end_time = timesec() + timeout

   156

        self.event.clear()

   157

        while timesec() < end_time:

   158

            if self.event.wait(period):

   159

                # no timeout -> got event -> not idle -> loop again

   160

                self.event.clear()

   161

            else:

   162

                # timeout -> no event -> idle -> exit

   163

                self.ReportScreenShot("stdout is idle")

   164

                return True

   165

   166

        self.ReportScreenShot("stdout did not idle")

   167

   168

        raise Exception("Stdout did not idle before timeout")

   169

   170

    def waitPatternInStdout(self, pattern, timeout, count=1):

   171

        found = 0

   172

        self.pattern = pattern

   173

        end_time = timesec() + timeout

   174

        while True:

   175

            remain = end_time - timesec()

   176

            if remain <= 0 :

   177

                res = False

   178

                break

   179

   180

            res = self.success_event.wait(remain)

   181

            if res:

   182

                self.success_event.clear()

   183

                found = found + 1

   184

                if found >= count:

   185

                    break

   186

        self.pattern = None

   187

        self.ReportScreenShot("found pattern" if res else "pattern not found")

   188

        return res

   189

   190

class BeremizApp(IDEIdleObserver, stdoutIdleObserver):

   191

    def __init__(self, projectpath=None, exemple=None, testproject=None):

   192

        """

   193

        Starts Beremiz IDE, waits for main window to appear, maximize it.

   194

   195

            Parameters: 

   196

                projectpath (str): path to project to open

   197

                exemple (str): path relative to exemples directory

   198

   199

            Returns:

   200

                Sikuli App class instance

   201

        """

   203

   204

        self.screenshotnum = 0

   205

        self.starttime = timesec()

   206

        self.screen = sikuli.Screen()

   207

   208

        self.report = open("report.html", "w")

   209

        self.report.write("""<!doctype html>

   210

<html>

   211

  <head>

   212

    <meta charset="utf-8">

   213

    <meta name="color-scheme" content="light dark">

   214

    <title>Test report</title>

   215

  </head>

   216

  <body>

   217

""")

   218

   219

        command = [python_bin, opj(beremiz_path,"Beremiz.py"), "--log=/dev/stdout"]

   220

   221

        if exemple is not None:

   222

            command.append(opj(beremiz_path,"exemples",exemple))

   223

        elif projectpath is not None:

   224

            command.append(projectpath)

   225

        elif testproject is not None:

   226

            command.append(opj(beremiz_path,"tests","projects",testproject))

   227

   228

   229

        # App class is broken in Sikuli 2.0.5: can't start process with arguments.

   230

        # 

   231

        # Workaround : - use subprocess module to spawn IDE process,

   232

        #              - use wmctrl to find IDE window details and maximize it

   233

        #              - pass exact window title to App class constructor

   234

   235

        self.ReportText("Launching " + repr(command))

   236

   237

        self.proc = subprocess.Popen(command, stdout=subprocess.PIPE, bufsize=0)

   238

   239

        # Window are macthed against process' PID

   240

        ppid = self.proc.pid

   241

   242

        # Timeout 5s

   243

        c = 50

   244

        while c > 0:

   245

            # equiv to "wmctrl -l -p | grep $pid"

   246

            try:

   247

                wlist = filter(lambda l:(len(l)>2 and l[2]==str(ppid)), map(lambda s:s.split(None,4), subprocess.check_output(["wmctrl", "-l", "-p"]).splitlines()))

   248

            except subprocess.CalledProcessError:

   249

                wlist = []

   250

   251

            # window with no title only has 4 fields do describe it

   252

            # beremiz splashcreen has no title

   253

            # wait until main window is visible

   254

            if len(wlist) == 1 and len(wlist[0]) == 5:

   255

                windowID,_zero,wpid,_XID,wtitle = wlist[0] 

   256

                break

   257

   258

            sikuli.wait(0.1)

   259

            c = c - 1

   260

   261

        if c == 0:

   262

            raise Exception("Couldn't find Beremiz window")

   263

   264

        # Maximize window x and y

   265

        subprocess.check_call(["wmctrl", "-i", "-r", windowID, "-b", "add,maximized_vert,maximized_horz"])

   266

   267

        # switchApp creates an App object by finding window by title, is not supposed to spawn a process

   268

        self.sikuliapp = sikuli.switchApp(wtitle)

   269

        self.k = KBDShortcut(self)

   270

   271

        IDEIdleObserver.__init__(self)

   272

        stdoutIdleObserver.__init__(self)

   273

   274

        # stubs for common sikuli calls to allow adding hooks later

   275

        for name in ["click","doubleClick","type","rightClick","wait"]:

   276

            def makeMyMeth(n):

   277

                def myMeth(*args, **kwargs):

   278

                    self.ReportScreenShot("Begin: " + n + "(" + repr(args) + "," + repr(kwargs) + ")")

   279

                    try:

   280

                        getattr(sikuli, n)(*args, **kwargs)

   281

                    finally:

   282

                        self.ReportScreenShot("end: " + n + "(" + repr(args) + "," + repr(kwargs) + ")")

   283

                return myMeth

   284

            setattr(self, name, makeMyMeth(name))

   285

   286

    def dragNdrop(self, src, dst):

   287

        sikuli.drag(src)

   288

        sikuli.mouseMove(5,0)

   289

        sikuli.dropAt(dst)

   290

   291

    def close(self):

   292

        self.sikuliapp.close()

   293

        self.sikuliapp = None

   294

        self.report.write("""

   295

  </body>

   296

</html>""")

   297

        self.report.close()

   298

   299

    def __del__(self):

   300

        if self.sikuliapp is not None:

   301

            self.sikuliapp.close()

   302

        IDEIdleObserver.__del__(self)

   303

        stdoutIdleObserver.__del__(self)

   304

   305

    def ReportScreenShot(self, msg):

   306

        elapsed = "%.3fs: "%(timesec() - self.starttime)

   307

        fname = "capture"+str(self.screenshotnum)+".png"

   308

        cap = self.screen.capture(self.r)

   309

        cap.save(".", fname)

   310

        self.screenshotnum = self.screenshotnum + 1

   311

        self.report.write( "<p>" + elapsed + msg + "<br/><img src=\""+ fname + "\">" + "</p>")

   312

   313

    def ReportText(self, text):

   314

        elapsed = "%.3fs: "%(timesec() - self.starttime)

   315

        self.report.write("<p>" + elapsed + text + "</p>")

   316

   317

    def ReportOutput(self, text):

   318

        elapsed = "%.3fs: "%(timesec() - self.starttime)

   319

        sys.stdout.write(elapsed + text)

   320

        self.report.write("<pre>" + elapsed + text + "</pre>")

   321

   322

   323

class AuxiliaryProcess(stdoutIdleObserver):

   324

    def __init__(self, beremiz_app, command):

   325

        self.app = beremiz_app

   326

        self.app.ReportText("Launching process " + repr(command))

   327

        self.proc = subprocess.Popen(command, stdout=subprocess.PIPE, bufsize=0)

   328

        self.app.ReportText("Launched process " + repr(command) + " PID: " + str(self.proc.pid))

   329

        stdoutIdleObserver.__init__(self)

   330

   331

    def close(self):

   332

        if self.proc is not None:

   333

            proc = self.proc

   334

            self.proc = None

   335

            # self.proc.stdout.close()

   336

            self.app.ReportText("Kill process PID: " + str(proc.pid))

   337

            try:

   338

                os.kill(proc.pid, signal.SIGTERM)

   339

            except OSError:

   340

                pass

   341

            proc.wait()

   342

            # self.thread.join()

   343

   344

    def ReportOutput(self, text):

   345

        self.app.ReportOutput("Aux: "+text)

   346

   347

    def ReportScreenShot(self, msg):

   348

        self.app.ReportOutput("Aux: "+msg)

   349

   350

    def __del__(self):

   351

        self.close()

   352

   353

def run_test(func, *args, **kwargs):

   354

    app = BeremizApp(*args, **kwargs)

   355

    try:

   356

        success = func(app)

   357

    except:

   358

        # sadly, sys.excepthook is broken in sikuli/jython 

   359

        # purpose of this run_test function is to work around it.

   360

        # and catch exception cleanly anyhow

   361

        e_type, e_value, e_traceback = sys.exc_info()

   362

        err_msg = "\n".join(traceback.format_exception(e_type, e_value, e_traceback))

   363

        app.ReportOutput(err_msg)

   364

        success = False

   365

   366

    app.close()

   367

   368

    if success:

   369

        sikuli.exit(0)

   370

    else:

   371

        sikuli.exit(1)

   372

   373

   374