Option: --runscript (Skript ausführen)

Die angegebene Skriptdatei wird von CODESYS ausgeführt.

Tab. 514: Befehlszeilenoptionen für --runscript
`‎--runscript="<script file>.py"‎`	CODESYS führt die Skriptdatei `‎<script file>.py‎` beim Starten aus. Sie müssen den vollständigen Pfad der Skriptdatei angeben.
`‎--scriptargs:'<arg1> <arg2> ... <argn>'‎`	Verwenden Sie diese Option zusammen mit der Option `‎--runscript‎`. Sie lösen die Übergabe der <arg1> ... <argn> Argumente an das Skript aus. Die Argumente werden an die Python-Variable `‎sys.argv‎` übergeben.
`‎--noUI‎`	Verwenden Sie diese Option zusammen mit der Option `‎--runscript‎`. Die Benutzeroberfläche CODESYS wird nicht geöffnet. CODESYS gibt alle vom Skript erzeugten Fehler, Warnungen, Compilerberichte und Befehlszeilenmeldungen aus. Die Skriptmeldungen (1: Severity Text) können von anderen Meldungen getrennt werden (2: Schweregrad FatalError, Error, Warning, Information) mit dem Operator `‎>‎`.
`‎--enablescripttracing‎`	Verwenden Sie diese Option zusammen mit der Option `‎--runscript‎`. Als Ergebnis wird jeder Befehl der Skriptdatei in der Ausgabe angezeigt.
`‎--textPrompts‎`	Verwenden Sie diese Option zusammen mit der Option `‎--noUI‎`. Infolgedessen werden die Methoden des Nachrichtendienstes und die Standarddialoge in der Befehlszeile für Benutzereingaben ausgegeben. Wenn Sie `‎--textPrompts‎` nicht angeben, werden alle Aufforderungen des Nachrichtendienstes automatisch mit Standardwerten bestätigt.
`‎scriptdebugger {="<debugger>"}‎`	Verwenden Sie diese Option zusammen mit der Option `‎--runscript‎`. Es versetzt IronPython in den Debug-Modus, so dass externe Debugger zum Debuggen von Python-Skripten verwendet werden können. Die folgenden Werte sind für <debugger> definiert (Groß- und Kleinschreibung wird nicht berücksichtigt): `‎auto‎`: Erkennt automatisch, ob ein Debugger in jedem Skript des aktuellen Prozesses enthalten ist. Gegenwärtig können nur .NET-basierte Debugger automatisch erkannt werden. Ein erkannter Debugger überschreibt das `‎--enablescripttracing‎` Flag. `‎.NET‎`: Aktiviert das Debugging für .NET-basierte Debugger, wie "Python Tools for Visual Studio" (PTVS) und SharpDevelop. Mit dieser Option kann ein Debugger auch in laufende Skripte einbezogen werden, im Gegensatz zu "auto". Hinweis: Dies ist derzeit der Standardwert, wenn `‎--scriptdebugger‎` ohne Angabe eines Wertes verwendet wird. `‎disabled‎`: Deaktiviert das Debugging und die automatische Erkennung. `‎script‎`: Schaltet die IronPython-Skript-Engine in den Debug-Modus, um das Debugging für Set-Trace-Debugger zu aktivieren. Das Skript selbst muss sich mit dem Debugger verbinden und die Verbindung wieder trennen. `‎tracing‎`: Aktiviert den einfachen integrierten Modus "Skriptverfolgung" und deaktiviert die automatische Erkennung (wie die Option `‎--scripttracing‎`). `‎$absolute_path.py$‎`: Absoluter Pfad zu einem Python-Skript, das die Verbindung zu einem Python-basierten Debugger initiiert. Die IronPython-Skript-Engine wird in den Debug-Modus geschaltet, um das Debugging für Set-Trace-Debugger zu ermöglichen. Dieses Skript wird einmalig während der Initialisierung ausgeführt und sollte die folgenden nicht parametrisierten Funktionen definieren: `‎scriptdebuggersetup‎` wird unmittelbar vor der Ausführung des Benutzerskripts ausgeführt, um die Verbindung zum Debugger herzustellen. `‎scriptdebuggershutdown‎` wird unmittelbar nach der Ausführung des Benutzerskripts oder nach dem Herunterladen der Skript-Engine aufgerufen und sollte die Verbindung zum Debugger schließen.

Beispiele für die Verwendung von Übergabeparametern in Skriptdateien mit 'sys.argv'

start /b /wait Automation Builder.exe 
--runscript="D:\Script\ArgvAnd__main__Test.py" 
--scriptargs:'username password 3.14 "path=\"C:\temp\\"'

Skript-Datei: ‎ArgvAnd__main__Test.py‎

from __future__ import print_function
import sys
print("sys.argv: ", len(sys.argv), " elements:")

for arg in sys.argv:
    print(" - ", arg)
print()
print("__name__: ", __name__)

Ausgabeergebnis: ‎stdout‎:

sys.argv: 6 elements:
- D:\TestScripts\ArgvAnd__main__Test.py
- username
- password
- 3.14
- path= "C:temp"
__name__: __main__

Weitere Informationen über die globale Variable ‎__name__‎ finden Sie in der Python-Dokumentation.

Beispiele für die Nachrichtenausgabe

start /b /wait Automation Builder.exe --runscript="D:\Script\AmpelTest.py" --noUI 1>ScriptMessages.txt

CODESYS übergibt alle vom Skript erzeugten Meldungen an die Datei ‎ScriptMessages.txt‎. Andere Meldungen werden in der Befehlszeile ausgegeben.

start /b /wait Automation Builder.exe --runscript="D:\Script\AmpelTest.py" --noUI 2>NUL

CODESYS unterdrückt alle Meldungen, mit Ausnahme von Skriptmeldungen. Die Skriptmeldungen werden in der Befehlszeile ausgegeben.

Beispiel für die Verwendung der Option -scriptdebugger

Das folgende ‎initdebug.py‎ Skript wurde erfolgreich mit ‎pydevd‎-basierten Debuggern, wie PyDev / LiClipse und PyCharm, getestet. Um dieses Skript zu verwenden, starten Sie CODESYS mit der folgenden Befehlszeile:

--profile="Fanta Development Build" --scriptdebugger="D:\test\charmdebug\initdebug.py"

Datei: ‎initdebug.py‎:

from _future_ import print_function
from _future_ import unicode_literals
import sys
sys.path.append(r"D:\test\Env2\Lib\site-packages\pycharm-debug.egg")
import pydevd
def scriptdebuggersetup():
pydevd.settrace('localhost', port=51234, stdoutToServer=True, stderrToServer=True)
def scriptdebuggershutdown():
pydevd.stoptrace()

Für weitere Informationen siehe: und ‎⮫ http://docs.python.org/tutorial/modules.html