Changes

Jump to navigation Jump to search
205 bytes removed ,  14:19, 20 July 2022
no edit summary
This [[Module Library|XQuery Module]] contains functions for installing, listing and deleting modules contained in the [[Packaging|packaged XQuery modulesRepository]] in a repository.  =Conventions= All functions and errors in this module are preceded by the <code>repo:</code> prefix which is linked assigned to the namespace <code><nowiki>http://basex.org/modules/repo</nowiki></code>namespace, which is statically bound to the {{Code|repo}} prefix.<br/>
=Functions=
 
==repo:install==
 {|width='100%'|-| valign='"top' "| width='90120' | '''Signatures'''|<code><b>{{Func|repo:install</b>(|$path uri as xs:string) as |empty-sequence()</code>}}<br />|-| valign='"top' "| '''Summary'''|Installs Retrieves and installs a packagefrom the given {{Code|$uri}}. The parameter <code>$path</code> indicates the path to the packageExisting packages are replaced.<br />|-| valign='"top' "| '''Errors'''|<b>[[XQuery Errors{{Error|not-found|#Packaging Errors|PACK0001]]</b> is raised if the }} a package does not exist.<br /><b>[[XQuery Errors#Packaging Errors{{Error|PACK0002]]</b> is raised if the package is already installed.<br /><b>[[XQuery Errors#Packaging Errorsdescriptor|PACK0003]]</b> is raised if the package to be installed requires a package which is still not installed.<br /><b>[[XQuery Errors#Packaging Errors|PACK0004]]</b> is raised if }} the package descriptor is invalid.<br /><b>[[XQuery Errors{{Error|installed|#Packaging Errors|PACK0005]]</b> is raised if }} the module contained in the package to be installed is already installed as part of another package.<br /><b>[[XQuery Errors{{Error|parse|#Packaging Errors|PACK0006]]</b> is raised if }} an error occurred while parsing the package cannot be parsed.<br /><b>[[XQuery Errors{{Error|version|#Packaging Errors|PACK0009]]</b> is raised if }} the package version is not supported.<br /><b>[[XQuery Errors#Packaging Errors|PACK0010]]</b> is raised if the package contains an invalid JAR descriptor.<br /><b>[[XQuery Errors#Packaging Errors|PACK0011]]</b> is raised if the package contains a JAR descriptor but it cannot be read.<br />
|}
==repo:delete==
 {|width='100%'|-| valign='"top' "| width='90120' | '''Signatures'''|<code><b>{{Func|repo:delete</b>(|$pkg package as xs:string) as |empty-sequence()</code>}}<br />|-| valign='"top' "| '''Summary'''|Deletes a package. The parameter <code>$pkg</code> indicates either the package name as specified in the package descriptor or (since {{VersionCode|7.2.1$package}}) . The argument contains the package name, optionally suffixed with a hyphen dash and the package version.<br />|-| valign='"top' "| '''Errors'''|<b>[[XQuery Errors{{Error|not-found|#Packaging Errors|PACK0007]]</b> is raised if the }} a package cannot be deleteddoes not exist.<br /><b>[[XQuery Errors{{Error|delete|#Packaging Errors|PACK0008]]</b> is raised if another package depends on }} the package to cannot be deleted.<br />
|}
==repo:list==
{| width='100%'|- valign="top"| width='120' | '''Signatures'''|{{MarkFunc|Updated in Version 7.2repo:list||element(package)*}}<br />|- valign="top"| '''Summary'''|Lists the names and versions of all currently installed packages.<br />|}
=Errors= {|class="wikitable" width="100%"! width="110"|Code|Description|-valign="top"| {{Code|delete}}|The package cannot be deleted because of dependencies, or because files are missing.|- valign='"top' width"|{{Code|descriptor}}|The package descriptor is invalid.|- valign='90' "top"| '''Signatures'''{{Code|installed}}|<code><b>repo:list</b>() The module contained in the package to be installed is already installed as element(part of another package)*</code><br />.|- valign="top"|{{Code|not-found}}| A package does not exist.|- valign='"top' "|{{Code| '''Summary'''parse}}|Lists An error occurred while parsing the names and versions of all currently installed packagespackage.|- valign="top"|{{Code|version}}|The package version is not supported.<br />
|}
=Changelog=
===;Version 79.2.1===0 * Updated: error codes updated; errors now use the module namespace
* Updated: [[#repo:install|repo:install]]: existing packages will be replaced* Updated: [[#repo:delete|repo:delete]]: remove specific version of a package;Version 7.2.1
===Version 7.2===* Updated: {{Function||repo:install}}: existing packages will be replaced* Updated: {{Function||repo:delete}}: remove specific version of a package
* Updated: [[#repo:list|repo:list]] now returns nodes;Version 7.2
The module was introduced with * Updated: {{VersionFunction|7.1|repo:list}}.now returns nodes
[[Category:XQuery]]The module was introduced with Version 7.1.
Bureaucrats, editor, reviewer, Administrators
13,550

edits

Navigation menu