noosphere-cli 0.17.0

Reference client and pedagogical tool to demonstrate the principles of the Noosphere protocol
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

use crate::native::{content::Content, workspace::Workspace};
use anyhow::{anyhow, Result};
use noosphere_core::context::{SphereSync, SyncExtent, SyncRecovery};

/// Attempt to synchronize the local workspace with a configured gateway,
/// optionally automatically retrying a fixed number of times in case a rebase
/// is required, and then re-rendering the workspace as needed up to a given
/// depth.
pub async fn sync(auto_retry: u32, render_depth: Option<u32>, workspace: &Workspace) -> Result<()> {
    workspace.ensure_sphere_initialized()?;

    match Content::read_changes(workspace).await? {
        Some((_, content_changes, _)) if !content_changes.is_empty() => {
            return Err(anyhow!(
                "You have unsaved local changes; save or revert them before syncing!"
            ));
        }
        _ => (),
    };

    {
        let mut context = workspace.sphere_context().await?;
        context
            .sync_with_options(SyncExtent::FetchAndPush, SyncRecovery::Retry(auto_retry))
            .await?;
    }

    info!("Sync complete, rendering updated workspace...");

    workspace.render(render_depth, false).await?;

    info!("Done!");

    Ok(())
}