Package Class Reference
from PyKDE4.plasma import *
Namespace: Plasma
Detailed Description
Methods | |
__init__ (self, QString packageRoot, QString package, Plasma.PackageStructure.Ptr structure) | |
__init__ (self, QString packagePath, Plasma.PackageStructure.Ptr structure) | |
__init__ (self, Plasma.Package a0) | |
QStringList | entryList (self, QString fileType) |
QString | filePath (self, QString fileType, QString filename) |
QString | filePath (self, QString fileType) |
bool | isValid (self) |
Plasma.PackageMetadata | metadata (self) |
QString | path (self) |
setPath (self, QString path) | |
Plasma.PackageStructure.Ptr | structure (self) |
Static Methods | |
bool | createPackage (Plasma.PackageMetadata metadata, QString source, QString destination, QString icon=QString()) |
bool | installPackage (QString package, QString packageRoot, QString servicePrefix) |
QStringList | listInstalled (QString packageRoot) |
QStringList | listInstalledPaths (QString packageRoot) |
bool | registerPackage (Plasma.PackageMetadata data, QString iconPath) |
bool | uninstallPackage (QString package, QString packageRoot, QString servicePrefix) |
Method Documentation
Default constructor
@arg packageRoot path to the package installation root @arg package the name of the package @arg structure the package structure describing this package
__init__ | ( | self, | ||
QString | packagePath, | |||
Plasma.PackageStructure.Ptr | structure | |||
) |
Construct a Package object.
@arg packagePath full path to the package directory @arg structure the package structure describing this package
__init__ | ( | self, | ||
Plasma.Package | a0 | |||
) |
bool createPackage | ( | Plasma.PackageMetadata | metadata, | |
QString | source, | |||
QString | destination, | |||
QString | icon=QString() | |||
) |
Creates a package based on the metadata from the files contained in the source directory
@arg metadata description of the package to create @arg source path to local directory containing the individual files to be added to the package @arg destination path to the package that should be created @arg icon path to the package icon
QStringList entryList | ( | self, | ||
QString | fileType | |||
) |
Get the list of files of a given type.
@arg fileType the type of file to look for, as defined in the package structure.
- Returns:
- list of files by name, suitable for passing to filePath
Get the path to a given file.
@arg fileType the type of file to look for, as defined in the package structure @arg filename the name of the file
- Returns:
- path to the file on disk. QString() if not found.
Get the path to a given file.
@arg fileType the type of file to look for, as defined in the package structure. The type must refer to a file in the package structure and not a directory.
- Returns:
- path to the file on disk. QString() if not found
Installs a package.
- Parameters:
-
package path to the Plasmagik package packageRoot path to the directory where the package should be installed to servicePrefix the prefix for the desktop file, so as not to interfere with unrelated services (eg: "plasma-applet-")
- Returns:
- true on successful installation, false otherwise
bool isValid | ( | self ) |
- Returns:
- true if all the required components as defined in the PackageStructure exist
QStringList listInstalled | ( | QString | packageRoot | |
) |
Returns a list of all installed packages by name
- Parameters:
-
packageRoot path to the directory where Plasmagik packages have been installed to
- Returns:
- a list of installed Plasmagik packages
QStringList listInstalledPaths | ( | QString | packageRoot | |
) |
Returns a list of all paths of installed packages in the given root
- Parameters:
-
packageRoot path to the directory where Plasmagik packages have been installed to
- Returns:
- a list of installed Plasmagik packages by path
Plasma.PackageMetadata metadata | ( | self ) |
- Returns:
- the package metadata object.
QString path | ( | self ) |
- Returns:
- the path to the root of this particular package
bool registerPackage | ( | Plasma.PackageMetadata | data, | |
QString | iconPath | |||
) |
Registers a package described by the given desktop file
@arg the full path to the desktop file (must be KPluginInfo compatible)
- Returns:
- true on success, false on failure
setPath | ( | self, | ||
QString | path | |||
) |
Sets the path to the root of this package @arg path and absolute path
- Since:
- 4.3
Plasma.PackageStructure.Ptr structure | ( | self ) |
- Returns:
- the PackageStructure use in this Package
Uninstalls a package.
- Parameters:
-
package path to the Plasmagik package packageRoot path to the directory where the package should be installed to servicePrefix the prefix for the desktop file, so as not to interfere with unrelated services (eg: "plasma-applet-")
- Returns:
- true on successful uninstallation, false otherwise