liboxen 0.46.8

Oxen is a fast, unstructured data version control, to help version large machine learning datasets written in Rust.
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
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

//! # oxen config
//!
//! Configuration commands for Oxen
//!

use crate::error::OxenError;
use crate::model::{LocalRepository, Remote};
use crate::opts::StorageOpts;

/// # Set the remote for a repository
/// Tells the CLI where to push the changes to
pub fn set_remote(repo: &mut LocalRepository, name: &str, url: &str) -> Result<Remote, OxenError> {
    if url::Url::parse(url).is_err() {
        return Err(OxenError::invalid_set_remote_url(url));
    }

    if repo.is_remote_mode() {
        return Err(OxenError::basic_str(
            "Error: Cannot change remote of remote-mode repos",
        ));
    }

    let remote = repo.set_remote(name, url);
    repo.save()?;
    Ok(remote)
}

/// # Remove the remote for a repository
/// If you added a remote you no longer want, can remove it by supplying the name
pub fn delete_remote(repo: &mut LocalRepository, name: &str) -> Result<(), OxenError> {
    if repo.is_remote_mode() {
        return Err(OxenError::basic_str(
            "Error: Cannot delete from remote of remote-mode repos",
        ));
    }

    repo.delete_remote(name);
    repo.save()?;
    Ok(())
}

/// # Set the workspace for a remote-mode repository
/// Tells the CLI which workspace to upload the changes to
pub fn set_workspace(repo: &mut LocalRepository, name: &str) -> Result<String, OxenError> {
    repo.set_workspace(name)?;
    repo.save()?;

    Ok(name.to_string())
}

/// # Remove a workspace for a repository
/// If you added a workspace you no longer want, can remove it by supplying the name
pub fn delete_workspace(repo: &mut LocalRepository, name: &str) -> Result<(), OxenError> {
    repo.delete_workspace(name)?;
    repo.save()?;
    Ok(())
}

/// # Set the version store location for a repository
/// Tells the CLI where to save version files
pub async fn set_version_store(
    repo: &mut LocalRepository,
    opts: &StorageOpts,
) -> Result<(), OxenError> {
    repo.set_version_store(opts).await?;
    repo.save()?;

    Ok(())
}