Implement GetHolonById - Githubissues

Summary

This enhancement adds the _get_holon_by_id_ dance to the Uniform API. This dance retrieves an existing holon from its HolonId.

Current State:

The holons zome already offers a native get_holon function that retrieves an individual holon (but not any related holons). HolonId is not currently a recognized ValueType, so we cannot use the RequestBody's Parameters variant to supply the holon_id for the request.

Proposal

Dances Zome

[ ] Introduce a new HolonId variant for RequestBody:

pub enum RequestBody {
    None,
    Holon(Holon),
    HolonId(HolonId), // <= NEW
    ParameterValues(PropertyMap),
    Index(StagedIndex),
}

[ ] Introduce a new Holon variant for ResponseBody:

pub enum ResponseBody {
    None,
    Holon(Holon), // <===== NEW
    Holons(Vec<Holon>), // will be replaced by SmartCollection once supported
    // SmartCollection(SmartCollection),
    Index(StagedIndex),
}

[ ] Add a "get_holon_by_id" dance to the Dancer's dispatch table

Holons Adapter

[ ] Implement the DanceFunction for the "get_holon_by_id" dance:

/// *DanceRequest:*
/// - dance_name: "get_holon_by_id"
/// - dance_type: Standalone
/// - request_body:
///     - HolonId(HolonId)
///
/// *ResponseBody:*
///     - Holon(Holon)
///

[ ] Implement the build_get_holon_by_id_dance_request function for the above dance

Testing

[ ] Add "test_get_holon_by_id" test step executor
[ ] Add GetHolonById as a variant in the DanceTestStep enum definition and add its fmt::Display implementation
[ ] Add get_holon_by_id_dance_step" function to the implementation forDancesTestCase`
[ ] Add match that executes AddRelatedHolons step to dance_tests.rs
[ ] Add this step to the simple_create_test_fixture test case implementation (test both single target, and multi-target usages).

Definition of Done:

[ ] After adding add_delete_holons_test_steps to the simple_undescribed_create_holon_test, test case passes

evomimic / map-holons

Implement GetHolonById #77