4 releases (breaking)

0.12.0 Aug 28, 2024
0.11.0 Jun 5, 2024
0.10.0 Jun 5, 2024
0.9.0 Mar 26, 2024
0.2.0 Aug 7, 2023

#523 in Data structures

Download history 40/week @ 2024-07-22 33/week @ 2024-07-29 99/week @ 2024-08-05 86/week @ 2024-08-12 42/week @ 2024-08-19 235/week @ 2024-08-26 98/week @ 2024-09-02 142/week @ 2024-09-09 108/week @ 2024-09-16 73/week @ 2024-09-23 65/week @ 2024-09-30 67/week @ 2024-10-07 90/week @ 2024-10-14 48/week @ 2024-10-21 33/week @ 2024-10-28 44/week @ 2024-11-04

216 downloads per month
Used in 11 crates (2 directly)

MIT/Apache and GPL-3.0-or-later

160KB
4K SLoC

Collaborative Objects

Collaborative objects are graphs of CRDTs.

Basic Types

The basic types that are found in radicle-cob are:

  • CollaborativeObject -- the computed object itself.
  • ObjectId -- the content-address for a single collaborative object.
  • TypeName -- the name for a collection of collaborative objects.
  • History -- the traversable history of the changes made to a single collaborative object.

CRU Interface (No Delete)

The main entry for manipulating CollaborativeObjects is by using the CRU like functions:

Storage

The storing of collaborative objects is based on a git backend. The previously mentioned functions all accept a Store as parameter. The Store itself is an accumulation of different storage capabilities:

Resource

The create and update functions take a Resource. It represents the type of resource the collaborative objects are relating to, for example a software project.

History Traversal

The History of a CollaborativeObject -- accessed via CollaborativeObject::history -- has a method History::traverse which provides a way of inspecting each Entry and building up a final value.

This traversal is also the point at which the Entry::author and Entry::resource can be retrieved to apply any kind of filtering logic. For example, a specific author's change may be egregious, spouting terrible libel about Radicle. It is at this point that the actor's change can be filtered out from the final product of the traversal.

Dependencies

~21MB
~440K SLoC