Difference between revisions of "Repository Module"

From BaseX Documentation
Jump to navigation Jump to search
(5 intermediate revisions by the same user not shown)
Line 2: Line 2:
  
 
=Conventions=
 
=Conventions=
 
{{Mark|Updated with Version 9.0}}:
 
  
 
All functions and errors in this module are assigned to the <code><nowiki>http://basex.org/modules/repo</nowiki></code> namespace, which is statically bound to the {{Code|repo}} prefix.<br/>
 
All functions and errors in this module are assigned to the <code><nowiki>http://basex.org/modules/repo</nowiki></code> namespace, which is statically bound to the {{Code|repo}} prefix.<br/>
Line 20: Line 18:
 
|-
 
|-
 
| '''Errors'''
 
| '''Errors'''
|{{Error|not-found|#Errors}} a package does not exist.<br />{{Error|descriptor|#Errors}} the package descriptor is invalid.<br />{{Error|installed|#Errors}} the module contained in the package to be installed is already installed as part of another package.<br />{{Error|parse|#Errors}} the package cannot be parsed.<br />{{Error|version|#Errors}} the package version is not supported.
+
|{{Error|not-found|#Errors}} a package does not exist.<br />{{Error|descriptor|#Errors}} the package descriptor is invalid.<br />{{Error|installed|#Errors}} the module contained in the package to be installed is already installed as part of another package.<br />{{Error|parse|#Errors}} an error occurred while parsing the package.<br />{{Error|version|#Errors}} the package version is not supported.
 
|}
 
|}
  
Line 31: Line 29:
 
|-
 
|-
 
| '''Summary'''
 
| '''Summary'''
|Deletes a package. The parameter {{Code|$pkg}} indicates either the package name as specified in the package descriptor or the name, suffixed with a hyphen and the package version.<br />
+
|Deletes a package. The parameter {{Code|$pkg}} indicates the package name, optionally suffixed with a dash and the package version.<br />
 
|-
 
|-
 
| '''Errors'''
 
| '''Errors'''
|{{Error|not-found|#Errors}} a package does not exist.<br />{{Error|delete|#Errors}} the package cannot be deleted.<br />{{Error|BXRE0008|#Errors}} another package depends on the package to be deleted.<br />
+
|{{Error|not-found|#Errors}} a package does not exist.<br />{{Error|delete|#Errors}} the package cannot be deleted.
 
|}
 
|}
  
Line 49: Line 47:
  
 
=Errors=
 
=Errors=
 
{{Mark|Updated with Version 9.0}}:
 
  
 
{| class="wikitable" width="100%"
 
{| class="wikitable" width="100%"
Line 69: Line 65:
 
|-
 
|-
 
|{{Code|parse}}
 
|{{Code|parse}}
|The package cannot be parsed.
+
|An error occurred while parsing the package.
 
|-
 
|-
 
|{{Code|version}}
 
|{{Code|version}}
Line 79: Line 75:
 
;Version 9.0
 
;Version 9.0
  
* Updated: error codes updates; errors now use the module namespace
+
* Updated: error codes updated; errors now use the module namespace
  
 
;Version 7.2.1
 
;Version 7.2.1

Revision as of 12:11, 24 May 2018

This XQuery Module contains functions for installing, listing and deleting modules contained in the Repository.

Conventions

All functions and errors in this module are assigned to the http://basex.org/modules/repo namespace, which is statically bound to the repo prefix.

Functions

repo:install

Signatures repo:install($path as xs:string) as empty-sequence()
Summary Installs a package or replaces an existing package. The parameter $path indicates the path to the package.
Errors not-found: a package does not exist.
descriptor: the package descriptor is invalid.
installed: the module contained in the package to be installed is already installed as part of another package.
parse: an error occurred while parsing the package.
version: the package version is not supported.

repo:delete

Signatures repo:delete($pkg as xs:string) as empty-sequence()
Summary Deletes a package. The parameter $pkg indicates the package name, optionally suffixed with a dash and the package version.
Errors not-found: a package does not exist.
delete: the package cannot be deleted.

repo:list

Signatures repo:list() as element(package)*
Summary Lists the names and versions of all currently installed packages.

Errors

Code Description
delete The package cannot be deleted because of dependencies, or because files are missing.
descriptor The package descriptor is invalid.
installed The module contained in the package to be installed is already installed as part of another package.
not-found A package does not exist.
parse An error occurred while parsing the package.
version The package version is not supported.

Changelog

Version 9.0
  • Updated: error codes updated; errors now use the module namespace
Version 7.2.1
  • Updated: repo:install: existing packages will be replaced
  • Updated: repo:delete: remove specific version of a package
Version 7.2

The module was introduced with Version 7.1.