Add examples to rustdoc

Signed-off-by: itowlson <[email protected]>

Author: itowlson

src/key_value.rs

@@ -3,14 +3,62 @@
 //! This module provides a generic interface for key-value storage, which may be implemented by the host various
 //! ways (e.g. via an in-memory table, a local file, or a remote database). Details such as consistency model and
 //! durability will depend on the implementation and may vary from one to store to the next.
+//!
+//! # Examples
+//!
+//! Open the default store and set the 'message' key:
+//!
+//! ```no_run
+//! # fn main() -> anyhow::Result<()> {
+//! let store = spin_sdk::key_value::Store::open_default()?;
+//! store.set("message", "Hello world".as_bytes())?;
+//! # Ok(())
+//! # }
+//! ```
 
 use super::wit::v2::key_value;
 
 #[cfg(feature = "json")]
 use serde::{de::DeserializeOwned, Serialize};
 
 #[doc(inline)]
-pub use key_value::{Error, Store};
+pub use key_value::Error;
+
+/// An open key-value store.
+///
+/// # Examples
+///
+/// Open the default store and set the 'message' key:
+///
+/// ```no_run
+/// # fn main() -> anyhow::Result<()> {
+/// let store = spin_sdk::key_value::Store::open_default()?;
+/// store.set("message", "Hello world".as_bytes())?;
+/// # Ok(())
+/// # }
+/// ```
+///
+/// Open a named store and list all the keys defined in it:
+///
+/// ```no_run
+/// # fn main() -> anyhow::Result<()> {
+/// let store = spin_sdk::key_value::Store::open("finance")?;
+/// let keys = store.get_keys()?;
+/// # Ok(())
+/// # }
+/// ```
+///
+/// Open the default store and delete the 'message' key:
+///
+/// ```no_run
+/// # fn main() -> anyhow::Result<()> {
+/// let store = spin_sdk::key_value::Store::open_default()?;
+/// store.delete("message")?;
+/// # Ok(())
+/// # }
+/// ```
+#[doc(inline)]
+pub use key_value::Store;
 
 impl Store {
     /// Open the default store.
@@ -24,6 +72,31 @@ impl Store {
 impl Store {
     #[cfg(feature = "json")]
     /// Serialize the given data to JSON, then set it as the value for the specified `key`.
+    ///
+    /// # Examples
+    ///
+    /// Open the default store and save a customer information document against the customer ID:
+    ///
+    /// ```no_run
+    /// # use serde::{Deserialize, Serialize};
+    /// #[derive(Deserialize, Serialize)]
+    /// struct Customer {
+    ///     name: String,
+    ///     address: Vec<String>,
+    /// }
+    ///
+    /// # fn main() -> anyhow::Result<()> {
+    /// let customer_id = "CR1234567";
+    /// let customer = Customer {
+    ///     name: "Alice".to_owned(),
+    ///     address: vec!["Wonderland Way".to_owned()],
+    /// };
+    ///
+    /// let store = spin_sdk::key_value::Store::open_default()?;
+    /// store.set_json(customer_id, &customer)?;
+    /// # Ok(())
+    /// # }
+    /// ```
     pub fn set_json<T: Serialize>(
         &self,
         key: impl AsRef<str>,
@@ -34,6 +107,27 @@ impl Store {
 
     #[cfg(feature = "json")]
     /// Deserialize an instance of type `T` from the value of `key`.
+    ///
+    /// # Examples
+    ///
+    /// Open the default store and retrieve a customer information document by customer ID:
+    ///
+    /// ```no_run
+    /// # use serde::{Deserialize, Serialize};
+    /// #[derive(Deserialize, Serialize)]
+    /// struct Customer {
+    ///     name: String,
+    ///     address: Vec<String>,
+    /// }
+    ///
+    /// # fn main() -> anyhow::Result<()> {
+    /// let customer_id = "CR1234567";
+    ///
+    /// let store = spin_sdk::key_value::Store::open_default()?;
+    /// let customer = store.get_json::<Customer>(customer_id)?;
+    /// # Ok(())
+    /// # }
+    /// ```
     pub fn get_json<T: DeserializeOwned>(
         &self,
         key: impl AsRef<str>,