aprender-graph 0.29.0

GPU-first embedded graph database for code analysis (call graphs, dependencies, AST traversals)
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
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

[package]
name = "aprender-graph"
version.workspace = true
edition = "2021"
authors = ["Pragmatic AI Labs <info@paiml.com>"]
license = "MIT"
description = "GPU-first embedded graph database for code analysis (call graphs, dependencies, AST traversals)"
repository = "https://github.com/paiml/trueno-graph"
keywords = ["graph", "gpu", "database", "csr", "pagerank"]
categories = ["database", "algorithms", "data-structures"]
rust-version = "1.75"
readme = "README.md"

[lib]
name = "trueno_graph"

[dependencies]
# Data formats (columnar) - MVP uses Arrow/Parquet directly
# Minimal features: drops arrow-csv, arrow-json (~fewer transitive deps)
arrow = { version = "54", default-features = false, optional = true }  # RecordBatch zero-copy
parquet = { version = "54", optional = true }                       # Persistent storage

# Async runtime (required for I/O)
tokio = { version = "1", features = ["rt", "fs", "sync", "macros"] }

# Error handling
anyhow = "1"
thiserror = "2"

# Phase 2+ dependencies
aprender = { path = "../aprender-core", version = "0.29.0", package = "aprender-core" }                                        # Sparse matrix ops, PageRank
trueno = "0.17"                                          # SIMD primitives
trueno-db = "0.3.17"                                     # Columnar storage

# Phase 3: GPU acceleration (optional - requires wgpu-capable hardware)
wgpu = { version = "22", optional = true, features = ["wgsl"] }
bytemuck = { version = "1", optional = true, features = ["derive"] }
futures-intrusive = { version = "0.5", optional = true }

# Future optional dependencies
# lru = { version = "0.12", optional = true }
# serde = { version = "1", features = ["derive"], optional = true }

[dev-dependencies]
# Testing
tokio = { version = "1", features = ["rt-multi-thread", "macros"] }
tokio-test = "0.4"
proptest = "1.9"                                        # Property-based testing
serial_test = "3"                                       # Sequential test execution
tempfile = "3"                                          # Temporary directories for tests

# Benchmarks
criterion = { version = "0.6", features = ["html_reports"] }

[features]
default = ["storage"]

# Parquet/Arrow storage for graph persistence
storage = ["dep:arrow", "dep:parquet"]

# GPU acceleration (Phase 3)
gpu = ["wgpu", "bytemuck", "futures-intrusive"]

# Features for future phases (currently disabled for MVP)
# simd = ["trueno"]
# api = ["serde"]

# Workspace lints (PMAT best practices from trueno-db/trueno)
[[bench]]
name = "graph_algorithms"
harness = false

# GPU Benchmarks (Phase 3)
[[bench]]
name = "gpu_algorithms"
harness = false
required-features = ["gpu"]

# GPU Examples (require gpu feature)
[[example]]
name = "paging_demo"
required-features = ["gpu"]

# Phase 4 Benchmarks (Community detection, Pattern matching)
[[bench]]
name = "phase4_algorithms"
harness = false

[profile.release]
opt-level = 3
lto = "thin"                                            # Link-time optimization (faster PageRank)
codegen-units = 1                                       # Better optimization (slower compile)
strip = true                                            # Remove debug symbols
panic = "abort"                                         # Smaller binary

[profile.bench]
inherits = "release"
debug = true                                            # Keep symbols for flamegraph profiling

[package.metadata.docs.rs]
all-features = true
rustdoc-args = ["--generate-link-to-definition"]

[package.metadata.release]
shared-version = true

[[package.metadata.release.pre-release-replacements]]
file = "CHANGELOG.md"
search = "## \\[Unreleased\\]"
replace = "## [{{version}}] - {{date}}"

[profile.dev]
panic = "abort"