tacos 0.1.0

Build system infrastructure on top of picante
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

# tacos

[![Crates.io](https://img.shields.io/crates/v/tacos.svg)](https://crates.io/crates/tacos)
[![docs.rs](https://docs.rs/tacos/badge.svg)](https://docs.rs/tacos)
[![License](https://img.shields.io/crates/l/tacos.svg)](./LICENSE)
[![codecov](https://codecov.io/gh/bearcove/tacos/graph/badge.svg)](https://codecov.io/gh/bearcove/tacos)
![Experimental](https://img.shields.io/badge/status-experimental-yellow.svg)


**tacos** is build system infrastructure on top of [picante](https://github.com/bearcove/picante).

It provides the glue between the file system and picante's incremental query system:

- **File watching**: Efficient, debounced file system notifications via `notify`
- **Content-addressed storage**: Hash-based blob storage for large artifacts
- **Content hashing**: Fast hashing via `rapidhash` for cache busting and change detection

## Architecture

```text
+-----------------------------------+
|  your build system                |  <- domain-specific queries
+-----------------------------------+
|  tacos                            |  <- file watching, CAS, hashing
+-----------------------------------+
|  picante                          |  <- pure incremental queries
+-----------------------------------+
```

## Example

```rust,ignore
use tacos::{FileWatcher, ContentStore, content_hash};

// Content-addressed storage for build artifacts
let store = ContentStore::open(".cache/content-store")?;

// Hash content for cache keys
let hash = content_hash(b"file contents");
```

## See Also

- [picante](https://github.com/bearcove/picante) - Async incremental query runtime
- [dodeca](https://github.com/bearcove/dodeca) - Static site generator built on picante + tacos

## License

Licensed under either of Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or <http://www.apache.org/licenses/LICENSE-2.0>) or MIT license ([LICENSE-MIT](LICENSE-MIT) or <http://opensource.org/licenses/MIT>) at your option.