1

#!/usr/bin/env python

     2

# -*- coding: utf-8 -*-

     3

     4

# This file is part of Beremiz, a Integrated Development Environment for

     5

# programming IEC 61131-3 automates supporting plcopen standard and CanFestival.

     6

#

     7

# Copyright (C) 2007: Edouard TISSERANT and Laurent BESSARD

     8

# Copyright (C) 2016: Andrey Skvortsov <andrej.skvortzov@gmail.com>

     9

#

    10

# See COPYING file for copyrights details.

    11

#

    12

# This program is free software; you can redistribute it and/or

    13

# modify it under the terms of the GNU General Public License

    14

# as published by the Free Software Foundation; either version 2

    15

# of the License, or (at your option) any later version.

    16

#

    17

# This program is distributed in the hope that it will be useful,

    18

# but WITHOUT ANY WARRANTY; without even the implied warranty of

    19

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

    20

# GNU General Public License for more details.

    21

#

    22

# You should have received a copy of the GNU General Public License

    23

# along with this program; if not, write to the Free Software

    24

# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.

    25

    26

    27

from __future__ import absolute_import

    28

from __future__ import print_function

    29

import os

    30

import sys

    31

import tempfile

    32

import shutil

    33

import random

    34

import time

    35

from time import time as gettime

    36

from threading import Lock, Timer, currentThread

    37

    38

from six.moves import cPickle, xrange

    39

import wx.lib.buttons

    40

import wx.lib.statbmp

    41

import wx.stc

    42

    43

    44

import version

    45

from editors.EditorPanel import EditorPanel

    46

from editors.Viewer import Viewer

    47

from editors.TextViewer import TextViewer

    48

from editors.ResourceEditor import ConfigurationEditor, ResourceEditor

    49

from editors.DataTypeEditor import DataTypeEditor

    50

from util import paths as paths

    51

from util.MiniTextControler import MiniTextControler

    52

from util.ProcessLogger import ProcessLogger

    53

from util.BitmapLibrary import GetBitmap

    54

from controls.LogViewer import LogViewer

    55

from controls.CustomStyledTextCtrl import CustomStyledTextCtrl

    56

from controls import EnhancedStatusBar as esb

    57

from dialogs.AboutDialog import ShowAboutDialog

    58

    59

from plcopen.types_enums import \

    60

    ComputeConfigurationName, \

    61

    LOCATION_CONFNODE, \

    62

    LOCATION_MODULE, \

    63

    LOCATION_GROUP, \

    64

    LOCATION_VAR_INPUT, \

    65

    LOCATION_VAR_OUTPUT, \

    66

    LOCATION_VAR_MEMORY, \

    67

    ITEM_PROJECT, \

    68

    ITEM_RESOURCE, \

    69

    ITEM_CONFNODE

    70

    71

from ProjectController import ProjectController, GetAddMenuItems, MATIEC_ERROR_MODEL

    72

    73

from IDEFrame import \

    74

    TITLE,\

    75

    EDITORTOOLBAR,\

    76

    FILEMENU,\

    77

    EDITMENU,\

    78

    DISPLAYMENU,\

    79

    PROJECTTREE,\

    80

    POUINSTANCEVARIABLESPANEL,\

    81

    LIBRARYTREE,\

    82

    PAGETITLES,\

    83

    IDEFrame, \

    84

    AppendMenu,\

    85

    EncodeFileSystemPath, \

    86

    DecodeFileSystemPath

    87

    88

    89

beremiz_dir = paths.AbsDir(__file__)

    90

    91

    92

def Bpath(*args):

    93

    return os.path.join(beremiz_dir, *args)

    94

    95

    96

MAX_RECENT_PROJECTS = 9

    97

    98

    99

if wx.Platform == '__WXMSW__':

   100

    faces = {

   101

        'mono': 'Courier New',

   102

        'size': 8,

   103

    }

   104

else:

   105

    faces = {

   106

        'mono': 'FreeMono',

   107

        'size': 10,

   108

    }

   109

   110

   111

MainThread = currentThread().ident

   112

REFRESH_PERIOD = 0.1

   113

   114

   115

class LogPseudoFile(object):

   116

    """ Base class for file like objects to facilitate StdOut for the Shell."""

   117

    def __init__(self, output, risecall):

   118

        self.red_white = 1

   119

        self.red_yellow = 2

   120

        self.black_white = wx.stc.STC_STYLE_DEFAULT

   121

        self.output = output

   122

        self.risecall = risecall

   123

        # to prevent rapid fire on rising log panel

   124

        self.rising_timer = 0

   125

        self.StackLock = Lock()

   126

        self.YieldLock = Lock()

   127

        self.RefreshLock = Lock()

   128

        self.TimerAccessLock = Lock()

   129

        self.stack = []

   130

        self.LastRefreshTime = gettime()

   131

        self.LastRefreshTimer = None

   132

   133

    def write(self, s, style=None):

   134

        self.StackLock.acquire()

   135

        self.stack.append((s, style))

   136

        self.StackLock.release()

   137

        current_time = gettime()

   138

        with self.TimerAccessLock:

   139

            if self.LastRefreshTimer is not None:

   140

                self.LastRefreshTimer.cancel()

   141

                self.LastRefreshTimer = None

   142

        elapsed = current_time - self.LastRefreshTime

   143

        if elapsed > REFRESH_PERIOD:

   144

            self._should_write()

   145

        else:

   146

            with self.TimerAccessLock:

   147

                if self.LastRefreshTimer is None:

   148

                    self.LastRefreshTimer = Timer(REFRESH_PERIOD - elapsed, self._timer_expired)

   149

                    self.LastRefreshTimer.start()

   150

   151

    def _timer_expired(self):

   152

        self._should_write()

   153

        with self.TimerAccessLock:

   154

            self.LastRefreshTimer = None

   155

   156

    def _should_write(self):

   157

        if MainThread == currentThread().ident:

   158

            app = wx.GetApp()

   159

            if app is not None:

   160

                self._write()

   161

                if self.YieldLock.acquire(0):

   162

                    app.Yield()

   163

                    self.YieldLock.release()

   164

        else:

   165

            with self.RefreshLock:

   166

                if not self.refreshPending:

   167

                    self.refreshPending = True

   168

                    wx.CallAfter(self._write)

   169

   170

    def _write(self):

   171

        if self.output:

   172

            with self.RefreshLock:

   173

                self.output.Freeze()

   174

                self.output.AnnotationClearAll()

   175

                self.StackLock.acquire()

   176

                for s, style in self.stack:

   177

                    if style is None:

   178

                        style = self.black_white

   179

                    if style != self.black_white:

   180

                        self.output.StartStyling(self.output.GetLength(), 0xff)

   181

   182

                    # Temporary deactivate read only mode on StyledTextCtrl for

   183

                    # adding text. It seems that text modifications, even

   184

                    # programmatically, are disabled in StyledTextCtrl when read

   185

                    # only is active

   186

                    start_pos = self.output.GetLength()

   187

                    self.output.SetReadOnly(False)

   188

                    self.output.AppendText(s)

   189

                    self.output.SetReadOnly(True)

   190

                    text_len = self.output.GetLength() - start_pos

   191

   192

                    if style != self.black_white:

   193

                        self.output.SetStyling(text_len, style)

   194

                self.stack = []

   195

                self.StackLock.release()

   196

                self.output.Thaw()

   197

                self.LastRefreshTime = gettime()

   198

                newtime = time.time()

   199

                if newtime - self.rising_timer > 1:

   200

                    self.risecall(self.output)

   201

                self.rising_timer = newtime

   202

                self.refreshPending = False

   203

   204

   205

    def write_warning(self, s):

   206

        self.write(s, self.red_white)

   207

   208

    def write_error(self, s):

   209

        self.write(s, self.red_yellow)

   210

   211

    def flush(self):

   212

        # Temporary deactivate read only mode on StyledTextCtrl for clearing

   213

        # text. It seems that text modifications, even programmatically, are

   214

        # disabled in StyledTextCtrl when read only is active

   215

        self.output.SetReadOnly(False)

   216

        self.output.SetText("")

   217

        self.output.SetReadOnly(True)

   218

   219

    def isatty(self):

   220

        return False

   221

   222

   223

ID_FILEMENURECENTPROJECTS = wx.NewId()

   224

   225

   226

class Beremiz(IDEFrame):

   227

   228

    def _init_utils(self):

   229

        self.ConfNodeMenu = wx.Menu(title='')

   230

        self.RecentProjectsMenu = wx.Menu(title='')

   231

   232

        IDEFrame._init_utils(self)

   233

   234

    def _init_coll_FileMenu_Items(self, parent):

   235

        AppendMenu(parent, help='', id=wx.ID_NEW,

   236

                   kind=wx.ITEM_NORMAL, text=_(u'New') + '\tCTRL+N')

   237

        AppendMenu(parent, help='', id=wx.ID_OPEN,

   238

                   kind=wx.ITEM_NORMAL, text=_(u'Open') + '\tCTRL+O')

   239

        parent.AppendMenu(ID_FILEMENURECENTPROJECTS, _("&Recent Projects"), self.RecentProjectsMenu)

   240

        parent.AppendSeparator()

   241

        AppendMenu(parent, help='', id=wx.ID_SAVE,

   242

                   kind=wx.ITEM_NORMAL, text=_(u'Save') + '\tCTRL+S')

   243

        AppendMenu(parent, help='', id=wx.ID_SAVEAS,

   244

                   kind=wx.ITEM_NORMAL, text=_(u'Save as') + '\tCTRL+SHIFT+S')

   245

        AppendMenu(parent, help='', id=wx.ID_CLOSE,

   246

                   kind=wx.ITEM_NORMAL, text=_(u'Close Tab') + '\tCTRL+W')

   247

        AppendMenu(parent, help='', id=wx.ID_CLOSE_ALL,

   248

                   kind=wx.ITEM_NORMAL, text=_(u'Close Project') + '\tCTRL+SHIFT+W')

   249

        parent.AppendSeparator()

   250

        AppendMenu(parent, help='', id=wx.ID_PAGE_SETUP,

   251

                   kind=wx.ITEM_NORMAL, text=_(u'Page Setup') + '\tCTRL+ALT+P')

   252

        AppendMenu(parent, help='', id=wx.ID_PREVIEW,

   253

                   kind=wx.ITEM_NORMAL, text=_(u'Preview') + '\tCTRL+SHIFT+P')

   254

        AppendMenu(parent, help='', id=wx.ID_PRINT,

   255

                   kind=wx.ITEM_NORMAL, text=_(u'Print') + '\tCTRL+P')

   256

        parent.AppendSeparator()

   257

        AppendMenu(parent, help='', id=wx.ID_EXIT,

   258

                   kind=wx.ITEM_NORMAL, text=_(u'Quit') + '\tCTRL+Q')

   259

   260

        self.Bind(wx.EVT_MENU, self.OnNewProjectMenu, id=wx.ID_NEW)

   261

        self.Bind(wx.EVT_MENU, self.OnOpenProjectMenu, id=wx.ID_OPEN)

   262

        self.Bind(wx.EVT_MENU, self.OnSaveProjectMenu, id=wx.ID_SAVE)

   263

        self.Bind(wx.EVT_MENU, self.OnSaveProjectAsMenu, id=wx.ID_SAVEAS)

   264

        self.Bind(wx.EVT_MENU, self.OnCloseTabMenu, id=wx.ID_CLOSE)

   265

        self.Bind(wx.EVT_MENU, self.OnCloseProjectMenu, id=wx.ID_CLOSE_ALL)

   266

        self.Bind(wx.EVT_MENU, self.OnPageSetupMenu, id=wx.ID_PAGE_SETUP)

   267

        self.Bind(wx.EVT_MENU, self.OnPreviewMenu, id=wx.ID_PREVIEW)

   268

        self.Bind(wx.EVT_MENU, self.OnPrintMenu, id=wx.ID_PRINT)

   269

        self.Bind(wx.EVT_MENU, self.OnQuitMenu, id=wx.ID_EXIT)

   270

   271

        self.AddToMenuToolBar([(wx.ID_NEW, "new", _(u'New'), None),

   272

                               (wx.ID_OPEN, "open", _(u'Open'), None),

   273

                               (wx.ID_SAVE, "save", _(u'Save'), None),

   274

                               (wx.ID_SAVEAS, "saveas", _(u'Save As...'), None),

   275

                               (wx.ID_PRINT, "print", _(u'Print'), None)])

   276

   277

    def _RecursiveAddMenuItems(self, menu, items):

   278

        for name, text, helpstr, children in items:

   279

            if len(children) > 0:

   280

                new_menu = wx.Menu(title='')

   281

                menu.AppendMenu(wx.ID_ANY, text, new_menu)

   282

                self._RecursiveAddMenuItems(new_menu, children)

   283

            else:

   284

                item = menu.Append(wx.ID_ANY, text, helpstr)

   285

                self.Bind(wx.EVT_MENU, self.GetAddConfNodeFunction(name), item)

   286

   287

    def _init_coll_AddMenu_Items(self, parent):

   288

        IDEFrame._init_coll_AddMenu_Items(self, parent, False)

   289

        self._RecursiveAddMenuItems(parent, GetAddMenuItems())

   290

   291

    def _init_coll_HelpMenu_Items(self, parent):

   292

        def handler(event):

   293

            return wx.MessageBox(

   294

                version.GetCommunityHelpMsg(),

   295

                _(u'Community support'),

   296

                wx.OK | wx.ICON_INFORMATION)

   297

   298

        item = parent.Append(wx.ID_ANY, _(u'Community support'), '')

   299

        self.Bind(wx.EVT_MENU, handler, item)

   300

   301

        parent.Append(help='', id=wx.ID_ABOUT,

   302

                      kind=wx.ITEM_NORMAL, text=_(u'About'))

   303

        self.Bind(wx.EVT_MENU, self.OnAboutMenu, id=wx.ID_ABOUT)

   304

   305

    def _init_coll_ConnectionStatusBar_Fields(self, parent):

   306

        parent.SetFieldsCount(3)

   307

   308

        parent.SetStatusText(number=0, text='')

   309

        parent.SetStatusText(number=1, text='')

   310

        parent.SetStatusText(number=2, text='')

   311

   312

        parent.SetStatusWidths([-1, 300, 200])

   313

   314

    def _init_ctrls(self, prnt):

   315

        IDEFrame._init_ctrls(self, prnt)

   316

   317

        self.EditMenuSize = self.EditMenu.GetMenuItemCount()

   318

   319

        inspectorID = wx.NewId()

   320

        self.Bind(wx.EVT_MENU, self.OnOpenWidgetInspector, id=inspectorID)

   321

        accels = [wx.AcceleratorEntry(wx.ACCEL_CTRL | wx.ACCEL_ALT, ord('I'), inspectorID)]

   322

   323

        for method, shortcut in [("Stop",     wx.WXK_F4),

   324

                                 ("Run",      wx.WXK_F5),

   325

                                 ("Transfer", wx.WXK_F6),

   326

                                 ("Connect",  wx.WXK_F7),

   327

                                 ("Build",    wx.WXK_F11)]:

   328

            def OnMethodGen(obj, meth):

   329

                def OnMethod(evt):

   330

                    if obj.CTR is not None:

   331

                        obj.CTR.CallMethod('_'+meth)

   332

                    wx.CallAfter(self.RefreshStatusToolBar)

   333

                return OnMethod

   334

            newid = wx.NewId()

   335

            self.Bind(wx.EVT_MENU, OnMethodGen(self, method), id=newid)

   336

            accels += [wx.AcceleratorEntry(wx.ACCEL_NORMAL, shortcut, newid)]

   337

   338

        self.SetAcceleratorTable(wx.AcceleratorTable(accels))

   339

   340

        self.LogConsole = CustomStyledTextCtrl(

   341

            name='LogConsole', parent=self.BottomNoteBook, pos=wx.Point(0, 0),

   342

            size=wx.Size(0, 0))

   343

        self.LogConsole.Bind(wx.EVT_SET_FOCUS, self.OnLogConsoleFocusChanged)

   344

        self.LogConsole.Bind(wx.EVT_KILL_FOCUS, self.OnLogConsoleFocusChanged)

   345

        self.LogConsole.Bind(wx.stc.EVT_STC_UPDATEUI, self.OnLogConsoleUpdateUI)

   346

        self.LogConsole.SetReadOnly(True)

   347

        self.LogConsole.SetWrapMode(wx.stc.STC_WRAP_CHAR)

   348

   349

        # Define Log Console styles

   350

        self.LogConsole.StyleSetSpec(wx.stc.STC_STYLE_DEFAULT, "face:%(mono)s,size:%(size)d" % faces)

   351

        self.LogConsole.StyleClearAll()

   352

        self.LogConsole.StyleSetSpec(1, "face:%(mono)s,fore:#FF0000,size:%(size)d" % faces)

   353

        self.LogConsole.StyleSetSpec(2, "face:%(mono)s,fore:#FF0000,back:#FFFF00,size:%(size)d" % faces)

   354

   355

        # Define Log Console markers

   356

        self.LogConsole.SetMarginSensitive(1, True)

   357

        self.LogConsole.SetMarginType(1, wx.stc.STC_MARGIN_SYMBOL)

   358

        self.LogConsole.MarkerDefine(0, wx.stc.STC_MARK_CIRCLE, "BLACK", "RED")

   359

   360

        self.LogConsole.SetModEventMask(wx.stc.STC_MOD_INSERTTEXT)

   361

   362

        self.LogConsole.Bind(wx.stc.EVT_STC_MARGINCLICK, self.OnLogConsoleMarginClick)

   363

        self.LogConsole.Bind(wx.stc.EVT_STC_MODIFIED, self.OnLogConsoleModified)

   364

   365

        self.MainTabs["LogConsole"] = (self.LogConsole, _("Console"))

   366

        self.BottomNoteBook.AddPage(*self.MainTabs["LogConsole"])

   367

        # self.BottomNoteBook.Split(self.BottomNoteBook.GetPageIndex(self.LogConsole), wx.RIGHT)

   368

   369

        self.LogViewer = LogViewer(self.BottomNoteBook, self)

   370

        self.MainTabs["LogViewer"] = (self.LogViewer, _("PLC Log"))

   371

        self.BottomNoteBook.AddPage(*self.MainTabs["LogViewer"])

   372

        # self.BottomNoteBook.Split(self.BottomNoteBook.GetPageIndex(self.LogViewer), wx.RIGHT)

   373

   374

        StatusToolBar = wx.ToolBar(self, -1, wx.DefaultPosition, wx.DefaultSize,

   375

                                   wx.TB_FLAT | wx.TB_NODIVIDER | wx.NO_BORDER)

   376

        StatusToolBar.SetToolBitmapSize(wx.Size(25, 25))

   377

        StatusToolBar.Realize()

   378

        self.Panes["StatusToolBar"] = StatusToolBar

   379

        self.AUIManager.AddPane(StatusToolBar, wx.aui.AuiPaneInfo().

   380

                                Name("StatusToolBar").Caption(_("Status ToolBar")).

   381

                                ToolbarPane().Top().Position(1).

   382

                                LeftDockable(False).RightDockable(False))

   383

   384

        self.AUIManager.Update()

   385

   386

        self.ConnectionStatusBar = esb.EnhancedStatusBar(self, style=wx.ST_SIZEGRIP)

   387

        self._init_coll_ConnectionStatusBar_Fields(self.ConnectionStatusBar)

   388

        self.ProgressStatusBar = wx.Gauge(self.ConnectionStatusBar, -1, range=100)

   389

        self.ConnectionStatusBar.AddWidget(self.ProgressStatusBar, esb.ESB_EXACT_FIT, esb.ESB_EXACT_FIT, 2)

   390

        self.ProgressStatusBar.Hide()

   391

        self.SetStatusBar(self.ConnectionStatusBar)

   392

   393

    def __init_execute_path(self):

   394

        if os.name == 'nt':

   395

            # on windows, desktop shortcut launches Beremiz.py

   396

            # with working dir set to mingw/bin.

   397

            # then we prefix CWD to PATH in order to ensure that

   398

            # commands invoked by build process by default are

   399

            # found here.

   400

            os.environ["PATH"] = os.getcwd()+';'+os.environ["PATH"]

   401

   402

    def __init__(self, parent, projectOpen=None, buildpath=None, ctr=None, debug=True):

   403

        # Add beremiz's icon in top left corner of the frame

   404

        self.icon = wx.Icon(Bpath("images", "brz.ico"), wx.BITMAP_TYPE_ICO)

   405

        self.__init_execute_path()

   406

   407

        IDEFrame.__init__(self, parent, debug)

   408

        self.Log = LogPseudoFile(self.LogConsole, self.SelectTab)

   409

   410

        self.local_runtime = None

   411

        self.runtime_port = None

   412

        self.local_runtime_tmpdir = None

   413

   414

        self.LastPanelSelected = None

   415

   416

        # Define Tree item icon list

   417

        self.LocationImageList = wx.ImageList(16, 16)

   418

        self.LocationImageDict = {}

   419

   420

        # Icons for location items

   421

        for imgname, itemtype in [

   422

                ("CONFIGURATION", LOCATION_CONFNODE),

   423

                ("RESOURCE",      LOCATION_MODULE),

   424

                ("PROGRAM",       LOCATION_GROUP),

   425

                ("VAR_INPUT",     LOCATION_VAR_INPUT),

   426

                ("VAR_OUTPUT",    LOCATION_VAR_OUTPUT),

   427

                ("VAR_LOCAL",     LOCATION_VAR_MEMORY)]:

   428

            self.LocationImageDict[itemtype] = self.LocationImageList.Add(GetBitmap(imgname))

   429

   430

        # Icons for other items

   431

        for imgname, itemtype in [

   432

                ("Extension", ITEM_CONFNODE)]:

   433

            self.TreeImageDict[itemtype] = self.TreeImageList.Add(GetBitmap(imgname))

   434

   435

        if projectOpen is not None:

   436

            projectOpen = DecodeFileSystemPath(projectOpen, False)

   437

   438

        if projectOpen is not None and os.path.isdir(projectOpen):

   439

            self.CTR = ProjectController(self, self.Log)

   440

            self.Controler = self.CTR

   441

            result, _err = self.CTR.LoadProject(projectOpen, buildpath)

   442

            if not result:

   443

                self.LibraryPanel.SetController(self.Controler)

   444

                self.ProjectTree.Enable(True)

   445

                self.PouInstanceVariablesPanel.SetController(self.Controler)

   446

                self.RefreshConfigRecentProjects(os.path.abspath(projectOpen))

   447

                self.RefreshAfterLoad()

   448

            else:

   449

                self.ResetView()

   450

                self.ShowErrorMessage(result)

   451

        else:

   452

            self.CTR = ctr

   453

            self.Controler = ctr

   454

            if ctr is not None:

   455

                ctr.SetAppFrame(self, self.Log)

   456

                self.LibraryPanel.SetController(self.Controler)

   457

                self.ProjectTree.Enable(True)

   458

                self.PouInstanceVariablesPanel.SetController(self.Controler)

   459

                self.RefreshAfterLoad()

   460

        if self.EnableDebug:

   461

            self.DebugVariablePanel.SetDataProducer(self.CTR)

   462

   463

        self.Bind(wx.EVT_CLOSE, self.OnCloseFrame)

   464

   465

        self._Refresh(TITLE, EDITORTOOLBAR, FILEMENU, EDITMENU, DISPLAYMENU)

   466

        self.RefreshAll()

   467

        self.LogConsole.SetFocus()

   468

   469

    def RefreshTitle(self):

   470

        name = _("Beremiz")

   471

        if self.CTR is not None:

   472

            projectname = self.CTR.GetProjectName()

   473

            if self.CTR.ProjectTestModified():

   474

                projectname = "~%s~" % projectname

   475

            self.SetTitle("%s - %s" % (name, projectname))

   476

        else:

   477

            self.SetTitle(name)

   478

   479

    def StartLocalRuntime(self, taskbaricon=True):

   480

        if (self.local_runtime is None) or (self.local_runtime.exitcode is not None):

   481

            # create temporary directory for runtime working directory

   482

            self.local_runtime_tmpdir = tempfile.mkdtemp()

   483

            # choose an arbitrary random port for runtime

   484

            self.runtime_port = int(random.random() * 1000) + 61131

   485

            # launch local runtime

   486

            self.local_runtime = ProcessLogger(

   487

                self.Log,

   488

                "\"%s\" \"%s\" -p %s -i localhost %s %s" % (

   489

                    sys.executable,

   490

                    Bpath("Beremiz_service.py"),

   491

                    self.runtime_port,

   492

                    {False: "-x 0", True: "-x 1"}[taskbaricon],

   493

                    self.local_runtime_tmpdir),

   494

                no_gui=False,

   495

                timeout=500, keyword=self.local_runtime_tmpdir,

   496

                cwd=self.local_runtime_tmpdir)

   497

            self.local_runtime.spin()

   498

        return self.runtime_port

   499

   500

    def KillLocalRuntime(self):

   501

        if self.local_runtime is not None:

   502

            # shutdown local runtime

   503

            self.local_runtime.kill(gently=False)

   504

            # clear temp dir

   505

            shutil.rmtree(self.local_runtime_tmpdir)

   506

   507

            self.local_runtime = None