Difference between revisions of "Repository Module"
Jump to navigation
Jump to search
m (Text replace - "\[\[Category:XQuery\]\]" to "") |
|||
(16 intermediate revisions by the same user not shown) | |||
Line 3: | Line 3: | ||
=Conventions= | =Conventions= | ||
− | All functions 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/> |
− | |||
=Functions= | =Functions= | ||
==repo:install== | ==repo:install== | ||
+ | |||
{| width='100%' | {| width='100%' | ||
− | |- | + | |- valign="top" |
− | | width='120' | ''' | + | | width='120' | '''Signature''' |
− | | | + | |<pre>repo:install( |
− | |- | + | $href as xs:string |
+ | ) as empty-sequence()</pre> | ||
+ | |- valign="top" | ||
| '''Summary''' | | '''Summary''' | ||
− | | | + | |Retrieves and installs a package from the given {{Code|$href}} location. Existing packages are replaced. |
− | |- | + | |- valign="top" |
| '''Errors''' | | '''Errors''' | ||
− | |{{Error| | + | |{{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. |
|} | |} | ||
==repo:delete== | ==repo:delete== | ||
+ | |||
{| width='100%' | {| width='100%' | ||
− | |- | + | |- valign="top" |
− | | width='120' | ''' | + | | width='120' | '''Signature''' |
− | | | + | |<pre>repo:delete( |
− | |- | + | $package as xs:string |
+ | ) as empty-sequence()</pre> | ||
+ | |- valign="top" | ||
| '''Summary''' | | '''Summary''' | ||
− | |Deletes a | + | |Deletes a {{Code|$package}}. The argument contains the package name, optionally suffixed with a dash and the package version.<br/> |
− | |- | + | |- valign="top" |
| '''Errors''' | | '''Errors''' | ||
− | |{{Error| | + | |{{Error|not-found|#Errors}} a package does not exist.<br/>{{Error|delete|#Errors}} the package cannot be deleted. |
|} | |} | ||
Line 37: | Line 42: | ||
{| width='100%' | {| width='100%' | ||
− | |- | + | |- valign="top" |
− | | width='120' | ''' | + | | width='120' | '''Signature''' |
− | | | + | |<pre>repo:list() as element(package)*</pre> |
− | |- | + | |- valign="top" |
| '''Summary''' | | '''Summary''' | ||
− | |Lists the names and versions of all currently installed packages.<br /> | + | |Lists the names and versions of all currently installed packages.<br/> |
|} | |} | ||
Line 50: | Line 55: | ||
! width="110"|Code | ! width="110"|Code | ||
|Description | |Description | ||
− | |- | + | |- valign="top" |
− | |{{Code| | + | |{{Code|delete}} |
− | |The | + | |The package cannot be deleted because of dependencies, or because files are missing. |
− | + | |- valign="top" | |
− | + | |{{Code|descriptor}} | |
− | |||
− | |||
− | |||
− | |||
− | |- | ||
− | |{{Code| | ||
|The package descriptor is invalid. | |The package descriptor is invalid. | ||
− | |- | + | |- valign="top" |
− | |{{Code| | + | |{{Code|installed}} |
|The module contained in the package to be installed is already installed as part of another package. | |The module contained in the package to be installed is already installed as part of another package. | ||
− | |- | + | |- valign="top" |
− | |{{Code| | + | |{{Code|not-found}} |
− | + | |A package does not exist. | |
− | + | |- valign="top" | |
− | + | |{{Code|parse}} | |
− | | | + | |An error occurred while parsing the package. |
− | |- | + | |- valign="top" |
− | |{{Code| | + | |{{Code|version}} |
− | | | ||
− | |- | ||
− | |{{Code| | ||
|The package version is not supported. | |The package version is not supported. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|} | |} | ||
=Changelog= | =Changelog= | ||
+ | |||
+ | ;Version 9.0 | ||
+ | |||
+ | * Updated: error codes updated; errors now use the module namespace | ||
;Version 7.2.1 | ;Version 7.2.1 | ||
− | * Updated: | + | * Updated: {{Function||repo:install}}: existing packages will be replaced |
− | * Updated: | + | * Updated: {{Function||repo:delete}}: remove specific version of a package |
;Version 7.2 | ;Version 7.2 | ||
− | * Updated: | + | * Updated: {{Function||repo:list}} now returns nodes |
The module was introduced with Version 7.1. | The module was introduced with Version 7.1. |
Latest revision as of 16:08, 9 March 2023
This XQuery Module contains functions for installing, listing and deleting modules contained in the Repository.
Contents
Conventions[edit]
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[edit]
repo:install[edit]
Signature | repo:install( $href as xs:string ) as empty-sequence() |
Summary | Retrieves and installs a package from the given $href location. Existing packages are replaced.
|
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[edit]
Signature | repo:delete( $package as xs:string ) as empty-sequence() |
Summary | Deletes a $package . The argument contains 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[edit]
Signature | repo:list() as element(package)* |
Summary | Lists the names and versions of all currently installed packages. |
Errors[edit]
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[edit]
- 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
- Updated:
repo:list
now returns nodes
The module was introduced with Version 7.1.