Refresh documentation

DESCRIPTION

@@ -1,7 +1,7 @@
 Package: storr.tiledb
 Title: A TileDB Storage Driver for Storr
-Version: 0.0.37
-Date: 2026-05-03
+Version: 0.0.38
+Date: 2026-05-18
 Authors@R: 
     person("Constantinos", "Giachalis", , "xx@github.com", role = c("aut", "cre"))
 Maintainer: Constantinos Giachalis <xx@github.com>

NEWS.md

@@ -1,3 +1,3 @@
-# storr.tiledb 0.0.37
+# storr.tiledb 0.0.38
 
 * Initial GitHub release.

R/driver_tiledb.R

@@ -49,8 +49,10 @@
 #'
 #' **Key-Namespace Metadata**
 #'
-#'  - **`get_keymeta()`**, **`set_keymeta()`**, and **`mset_keymeta()`** - Manage metadata such as
-#'   expiry times and notes for key-namespace pairs
+#'  - **`get_keymeta()`** and **`set_keymeta()`** - Manage metadata such as
+#'   expiry times and notes for single key-namespace pairs
+#'  - **`mget_keymeta()`** and **`mset_keymeta()`** - Manage metadata such as
+#'   expiry times and notes for multiple key-namespace pairs
 #'
 #' **Expiration Management**
 #'

vignettes/api.Rmd

@@ -1,6 +1,6 @@
 ---
 title: API Usage
-date: "2026-04-20"
+date: "2026-05-18"
 vignette: >
   %\VignetteIndexEntry{API Usage}
   %\VignetteEngine{litedown::vignette}
@@ -31,7 +31,7 @@ sto2 <- storr::storr(dr)
 The first approach generates a `TileDBStorr` object that represents the storr interface optimised for TileDB storage and provides additional functionality.
 The latter is the standard `storr` object.
 
-## API Usage
+## API Examples
 
 ### 1. get, set, del
 
@@ -114,15 +114,39 @@ sto$set("bb", 1, expires_at = Sys.time() + 1)
 
 Or update/retrieve with `$set_keymeta()` and `$get_keymeta()` methods:
 
-```r
+
+``` r
 # Retrieve key metadata
 sto$get_keymeta("aa", use_cache = FALSE)
+# $expires_at
+# [1] "2026-05-18 10:36:50 EEST"
+# 
+# $notes
+# [1] "{\"name\":\"John\",\"id\":12345}"
 sto$mget_keymeta(c("aa", "bb"), use_cache = TRUE)
+# [[1]]
+# [[1]]$expires_at
+# [1] "2026-05-18 10:36:50 EEST"
+# 
+# [[1]]$notes
+# [1] "{\"name\":\"John\",\"id\":12345}"
+# 
+# 
+# [[2]]
+# [[2]]$expires_at
+# [1] "2026-05-18 10:31:51 EEST"
+# 
+# [[2]]$notes
+# [1] NA
 
 # Update key metadata
 sto$set_keymeta("bb", notes = "Updated Note")
 sto$get_keymeta("bb")
-
+# $expires_at
+# [1] "2026-05-18 10:31:51 EEST"
+# 
+# $notes
+# [1] "Updated Note"
 ```
 
 **Expiration management**
@@ -132,16 +156,16 @@ sto$get_keymeta("bb")
 sto$keys_with_expiration()
 #    namespace    key          expires_at
 #       <char> <char>              <POSc>
-# 1:   objects     aa 2026-04-20 10:55:26
-# 2:   objects     bb 2026-04-20 10:50:27
+# 1:   objects     aa 2026-05-18 10:36:50
+# 2:   objects     bb 2026-05-18 10:31:51
 
 Sys.sleep(1)
 
 # Retrieve expired keys
 sto$expired_keys()
 #    namespace    key          expires_at
 #       <char> <char>              <POSc>
-# 1:   objects     bb 2026-04-20 10:50:27
+# 1:   objects     bb 2026-05-18 10:31:51
 
 # Remove expired keys
 sto$clear_expired_keys()

vignettes/src/_api.Rmd

@@ -35,7 +35,7 @@ sto2 <- storr::storr(dr)
 The first approach generates a `TileDBStorr` object that represents the storr interface optimised for TileDB storage and provides additional functionality.
 The latter is the standard `storr` object.
 
-## API Usage
+## API Examples
 
 ### 1. get, set, del
 ```{r}
@@ -96,7 +96,7 @@ sto$set("bb", 1, expires_at = Sys.time() + 1)
 
 Or update/retrieve with `$set_keymeta()` and `$get_keymeta()` methods:
 
-```r
+```{r}
 # Retrieve key metadata
 sto$get_keymeta("aa", use_cache = FALSE)
 sto$mget_keymeta(c("aa", "bb"), use_cache = TRUE)