This library is a client implementation of the open-source XML database server and XQuery processor BaseX.
Compatible with versions 8.x and 9.x.
Add the library to the list of dependencies in your Cargo.toml like so:
toml
[dependencies]
basex = "0.2.0"
First, you need to have BaseX server up and running. If you want to try it out, you can do it right away using docker.
shell
docker run -p 1984:1984 basex/basexhttp:9.1.2
Every example can be run with this server configuration.
Before you can do anything with the database server, you need to establish connection and authorize. Typically, you do this by calling Client::connect. If you get Ok result, you get the instance of the Client. Having its instance guarantees to have an open session with the server.
Client::connect("localhost", 1984, "admin", "admin")?
You can now send commands.
To run a query, you need to open a database. Opening existing database is unsupported at this moment and will be available in version 0.3.
The only way to open database is to create it, which also opens it. You have to follow the create call with either without_input or with_input to optionally specify initial XML resource.
client.create("coolbase").with_input(&mut xml);
Aside from running commands, you can run queries using XQuery syntax which is the most important use-case.
Client::query. This puts the session into query mode. Query::bind. Query::execute.Query::close.The following example creates database "lambada" with initial XML resource and counts all first-level child nodes of the Root node.
```rust use basex::{Client, ClientError};
fn main() -> Result<(), ClientError> {
let mut client = Client::connect("localhost", 1984, "admin", "admin")?;
let mut xml = "
let info = client.create("lambada")?.with_input(&mut xml)?;
assert!(info.starts_with("Database 'lambada' created"));
let mut xquery = "count(/Root/*)".as_bytes();
let mut query = client.query(&mut xquery)?;
let result = query.execute()?;
assert_eq!(result, "3");
let _ = query.close()?;
Ok(())
} ```
The library is licensed under ISC.