Expand description
§Linkspace
linkspace is an experiment to architect the internet around hashing, as oppose to destination addresses.
The linkspace API is designed as library adaptable to existing project - not as a framework to adapt to.
For scripting you can use the lk cli.
Create a point with lk_linkpoint (or lk_datapoint / lk_keypoint) and read/write with lk_serialize and lk_deserialize.
For persistence and cross thread/process/group io open a LkSystem (lks_open_*). The LkSystem is a thread local and !Send. The first opened is set as the default for the thread. Opening in different threads / processes with the same argument shares the same storage. (open_inmem is not shared between processes)
Save linkpoints with lks_save_*
Reading linkpoints from a system requires a query (lkq_new, lkq_space). lks_scan reads the system for any matching queries. lks_tap takes a callback that is run for current and future linkpoints matching the query.
The system does not automatically update its view of saved linkpoints. For the tap callbacks to be called, and for scan to pick up saved packets, run lks_process_* functions.
Linkspace does not have any native string encoding. Everything is bytes, including path, domain, and tags variables. To make working with this easier it has ABE - Ascii Byte expressions. see the module doc for more.
The system, the domain, and the group are almost always static. To decrease the verbosity these are taken from the thread_local variables when not explicitly set ( which in turn read from LKDB, LKE_DOMAIN, LKE_GROUP environment variables).
Re-exports§
pub use point::lk_datapoint;pub use point::lk_keypoint;pub use point::lk_linkpoint;pub use query::LkQuery;pub use query::lkq_add;pub use query::lkq_insert_mut;pub use query::lkq_new;pub use query::lkq_space;pub use system::lks_open;pub use system::lks_open_inmem;pub use system::lks_process_while;pub use system::LkSystem;pub use system::cb::on_point;pub use system::cb::on_point_then;pub use system::cb::try_on_point;pub use system::lks_process;pub use system::lks_save;pub use system::lks_scan;pub use system::lks_tap;pub use abe::lka_eval;
Modules§
- abe
- ascii byte expression utilities
- commons
- common ‘opinionated’ functions and protocols in linkspace
- consts
- experimental
- identity
- cryptographic key functions for use in lk_keypoint
- misc
- misc functions & tools - less stable
- point
- creating points
- prelude
- Re-export common types
- query
- LkQuery functions
- system
- a system to watch for new points from other processes or threads
- work_
env - build a custom scope for ABE for use in [varscope]