182 releases

new 0.4.0-dev.13 Jul 17, 2024
0.4.0-dev.10 Jun 26, 2024
0.3.0-beta-dev.41 Mar 27, 2024
0.3.0-beta-dev.28 Dec 22, 2023
0.0.2 Jul 29, 2021

#315 in Magic Beans

Download history 154/week @ 2024-03-25 547/week @ 2024-04-01 676/week @ 2024-04-08 569/week @ 2024-04-15 608/week @ 2024-04-22 901/week @ 2024-04-29 456/week @ 2024-05-06 439/week @ 2024-05-13 557/week @ 2024-05-20 588/week @ 2024-05-27 928/week @ 2024-06-03 770/week @ 2024-06-10 485/week @ 2024-06-17 555/week @ 2024-06-24 452/week @ 2024-07-01 591/week @ 2024-07-08

2,122 downloads per month
Used in 11 crates (3 directly)

Apache-2.0 and AGPL-3.0 WITH mif-exception

2.5MB
55K SLoC

holochain_state

Project Forum Chat

Twitter Follow

Crate API Docs

The Holochain state crate provides helpers and abstractions for working with the holochain_sqlite crate.

Reads

The main abstraction for creating data read queries is the Query trait. This can be implemented to make constructing complex queries easier.

The source_chain module provides the SourceChain type, which is the abstraction for working with chains of actions.

The host_fn_workspace module provides abstractions for reading data during workflows.

Writes

The mutations module is the complete set of functions for writing data to sqlite in holochain.

In-memory

The scratch module provides the Scratch type for reading and writing data in memory that is not visible anywhere else.

The SourceChain type uses the Scratch for in-memory operations which can be flushed to the database.

The Query trait allows combining arbitrary database SQL queries with the scratch space so reads can union across the database and in-memory data.

License

License: CAL 1.0

Copyright (C) 2019 - 2024, Holochain Foundation

This program is free software: you can redistribute it and/or modify it under the terms of the license provided in the LICENSE file (CAL-1.0). This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

Dependencies

~76–115MB
~2M SLoC