From af6774a511904f25c7d156aeea12504deab82078 Mon Sep 17 00:00:00 2001 From: Alex Auvolat Date: Thu, 8 Apr 2021 15:13:02 +0200 Subject: [PATCH] change a few comments --- src/model/block_ref_table.rs | 2 +- src/model/bucket_table.rs | 4 ++-- src/model/key_table.rs | 2 +- src/model/object_table.rs | 4 ++-- src/model/version_table.rs | 2 +- 5 files changed, 7 insertions(+), 7 deletions(-) diff --git a/src/model/block_ref_table.rs b/src/model/block_ref_table.rs index 1f0c7bb0..95451e9c 100644 --- a/src/model/block_ref_table.rs +++ b/src/model/block_ref_table.rs @@ -10,7 +10,7 @@ use crate::block::*; #[derive(PartialEq, Clone, Debug, Serialize, Deserialize)] pub struct BlockRef { - /// Hash of the block, used as partition key + /// Hash (blake2 sum) of the block, used as partition key pub block: Hash, /// Id of the Version for the object containing this block, used as sorting key diff --git a/src/model/bucket_table.rs b/src/model/bucket_table.rs index 6a4b021d..69901b8d 100644 --- a/src/model/bucket_table.rs +++ b/src/model/bucket_table.rs @@ -57,7 +57,7 @@ impl CRDT for BucketParams { } impl BucketParams { - /// Initializes a new instance of the Bucket struct + /// Create an empty BucketParams with no authorized keys and no website accesss pub fn new() -> Self { BucketParams { authorized_keys: crdt::LWWMap::new(), @@ -67,7 +67,7 @@ impl BucketParams { } impl Bucket { - /// Create a new bucket + /// Initializes a new instance of the Bucket struct pub fn new(name: String) -> Self { Bucket { name, diff --git a/src/model/key_table.rs b/src/model/key_table.rs index 578f8683..ba1f6b81 100644 --- a/src/model/key_table.rs +++ b/src/model/key_table.rs @@ -24,7 +24,7 @@ pub struct Key { } impl Key { - /// Create a new key + /// Initialize a new Key, generating a random identifier and associated secret key pub fn new(name: String) -> Self { let key_id = format!("GK{}", hex::encode(&rand::random::<[u8; 12]>()[..])); let secret_key = hex::encode(&rand::random::<[u8; 32]>()[..]); diff --git a/src/model/object_table.rs b/src/model/object_table.rs index ff42d065..b0611822 100644 --- a/src/model/object_table.rs +++ b/src/model/object_table.rs @@ -25,7 +25,7 @@ pub struct Object { } impl Object { - /// Create an object from parts + /// Initialize an Object struct from parts pub fn new(bucket: String, key: String, versions: Vec) -> Self { let mut ret = Self { bucket, @@ -102,7 +102,7 @@ impl CRDT for ObjectVersionState { } } -/// Data about an object version +/// Data stored in object version #[derive(PartialEq, Eq, PartialOrd, Ord, Clone, Debug, Serialize, Deserialize)] pub enum ObjectVersionData { /// The object was deleted, this Version is a tombstone to mark it as such diff --git a/src/model/version_table.rs b/src/model/version_table.rs index bb836868..dd088224 100644 --- a/src/model/version_table.rs +++ b/src/model/version_table.rs @@ -72,7 +72,7 @@ impl PartialOrd for VersionBlockKey { /// Informations about a single block #[derive(PartialEq, Eq, Ord, PartialOrd, Clone, Copy, Debug, Serialize, Deserialize)] pub struct VersionBlock { - /// Hash of the block + /// Blake2 sum of the block pub hash: Hash, /// Size of the block pub size: u64,