class
ScriptProjects.
ScriptProjects
Bases: object
The ScriptDriverProjects uses this interface to provide project handling functionality for the python scripts.
create
path
primary=True
Creates a new project.
Version added
Parameters
path (str) -- The location where the project content is to be stored.
primary (bool) -- if set to True the project will be the new primary project. See ScriptProject.primary for more information.
Return type
Returns
The created ScriptProject instance.
open
path
password=None
primary=True
encryption_password=None
session_user=None
session_password=None
update_flags='VersionUpdateFlags.NoUpdates'
allow_readonly=False
Opens the specified project.
Warning
If a password is given, SystemInstances.ObjectManager must implement IObjectManager9, or a InvalidOperationException will be thrown (even if the project is not actually password protected).
If the password is omitted, None or empty string, opening a password protected archive will prompt the user for a password.
For the update_flags parameter, the VersionUpdateFlags.SilentMode is usually combined with one or more of the Update... flags defined in the VersionUpdateFlags enum. If you only pass some Update... flags without the VersionUpdateFlags.SilentMode flag, they will be used as initial values when the update dialog pops up. To silently update everything, you can pass the combination VersionUpdateFlags.SilentMode|VersionUpdateFlags.UpdateAll.
Parameters
path (str) -- The path of the project file to open.
password (str) -- The password for the project encryption.
primary (bool) -- if set to True, open as primary project. See ScriptProject.primary for more information.
encryption_password (str) -- Version added: 3.5.5.0 The project encryption password.
session_user (str) -- Version added: 3.5.5.0 The project session user (project usermanagement).
session_password (bool) -- Version added: 3.5.5.0 The project session password (project usermanagement).
update_flags (VersionUpdateFlags) -- Version added: 3.5.8.0 The flags telling whether some aspects (libraries, compiler version) ought to be updated when the project is loaded. The default is to silently update nothing.
session_password -- Version added: 3.5.8.0 If set to True, allow the project to be opened as read-only.
Return type
Returns
The opened project.
open_archive
archivefile
projectpath
overwrite=False
password=None
encryption_password=None
session_user=None
session_password=None
update_flags='VersionUpdateFlags.NoUpdates'
Opens a project archive.
The parameter projectpath will be evaluated using the following algorithm:
If it's the path of an existing file, and overwrite is true, it will be overwritten.
If it's the path to an existing file, and overwrite is false, an IOException will be thrown.
If this points to an existing directory, the project will be extracted with its original name into that directory.
If the path does not exist, but ends with a "/" or "", the directory (and all non-existing parent directories) will be created, then the project will be extracted with its original name into that directory.
If the path does not exist, but the parent directory exists, the given path (directory and file name) will be used.
Otherwise, if the path ends with ".project" or ".library", the project will be extracted using the given path, creating all necessary parent directories.
In all other cases, a DirectoryNotFoundException will be thrown.
This method will return None when the archive extraction was cancelled due to an error or overwriting of files. If a password is given, SystemInstances.ObjectManager must implement IObjectManager9, or a MissingMethodException will be thrown (even if the project is not actually password protected). If the password is omitted, None or empty string, opening a password protected archive will prompt the user for a password.
For the update_flags parameter, the VersionUpdateFlags.SilentMode is usually combined with one or more of the Update... flags defined in the VersionUpdateFlags enum. If you only pass some Update... flags without the VersionUpdateFlags.SilentMode flag, they will be used as initial values when the update dialog pops up. To silently update everything, you can pass the combination VersionUpdateFlags.SilentMode|VersionUpdateFlags.UpdateAll.
Parameters
archivefile (str) -- The path of the project archive.
projectpath (str) -- The path for the extracted project.
overwrite (bool) -- if set to true, overwrite existing objects and project files
password (str) -- The password.
encryption_password (str) -- Version added: 3.5.5.0 The project encryption password.
session_user (str) -- Version added: 3.5.5.0 The project session user (project usermanagement).
session_password (str) -- Version added: 3.5.5.0 The project session password (project usermanagement).
update_flags (VersionUpdateFlags) -- Version added: 3.5.8.0 The flags telling whether some aspects (libraries, compiler version) ought to be updated when the project is loaded. The default is to silently update nothing.
Return type
Returns
The opened project.
get_by_path
path
Gets a Project by the absolute path where the project is physically stored.
Parameters
path (str) -- The path to the project.
Return type
Returns
The project instance
primary
Gets the primary project, or None if no primary project currently exists.
The primary project is the one the user usually works with. See ScriptProject.primary for more information.
Version added
Return type
all
Gets a (possibly empty) List of all currently opened projects.
Return type
list
convert
path
output_path=None
converter=None
primary=True
Converts the specified project.
Currently, password and device conversion prompts cannot be caught by the script.
|
Guid |
Description |
|
{E3BC006A-5E3E-4f8f-AEE7-27FD1E0F2A3F} |
CoDeSys for Automation Alliance project files (bevore V3.0, *.pro) |
|
{941937BF-9A12-4174-814E-63D1523C94CC} |
CoDeSys for Automation Alliance library files (before V3.0, *.lib) |
Version added
3.5.0.0
Parameters
path (str) -- The path of the project to convert.
output_path (str) -- The output path. This parameter is optional, if it is omitted, the output path will be auto-generated from the project path by changing the file extension.
converter (str) -- The GUID of the CoDeSys converter factory as string object. This parameter is optional, if omitted, the script engine will try to guess using the extension of the file name.
primary (bool) -- If set to True, open as primary project. See ScriptProject.primary for more information.
Return type
Returns
The converted project.
class
ScriptProjects.
ScriptProjectArchiveCategories
Bases: list
The list of available archive categories.
Enumerating this object will give all categories available in the current installation. Some often used categories are defined here, but may be unavailable (throw exceptions) in customized environments. An instance of this object is injected into the scriptengine module with the name "ArchiveCategories".
default
The default selection of archive categories.
See also: ScriptProjectArchiveCategory.selected_by_default
Return type
return_type
none
No categories (empty set).
This is a special sentinel value, different from passing an arbitrary empty list.
all
A collection of all categories (returns self).
compileinfo
Gets the category for the compileinfo.
This is needed for logins and online changes into an existing application without download.
libraries
Gets the category for the libraries referenced by the project.
devices
Gets the category for the device descriptions of the devices used in the project.
options
Gets the category for the project, user, and machine specific preferences.
ftd
Gets the category for the FDT Bulk Data.
images
Gets the category for the imagepool images of the project.
bootproject
Gets the category for the files containing offline boot applications, that were generated for the current project.
libraryprofile
Gets the category for the library profile that is currently in use with this project.
visualstyles
Gets the category for the visualization styles which are currently referenced by this project.
visualprofile
Gets the category for the active visualization profile.
visuextensions
Gets the category for the active visualization extensions.
class
ScriptProjects.
ScriptProjectArchiveCategory
Bases: object
Represents a category of items which can be included into a project archive.
guid
Gets the Guid for this category.
Return type
Guid
name
Gets a display name for this project category, e.g. "Referenced libraries".
This string should be localized.
Return type
str
descrption
Gets a description for this project category.
This string should be localized.
Return type
str
selected_by_default
Gets a boolean value indicating whether this category should be selected for project archive inclusion per default.
This is a hint for the presentation layer.
Return type
bool
