mahlon/nim-ladybug
1
0
Fork 0
Code Issues Pull requests Activity
Nim bindings to the LadybugDB embedded graph database. https://ladybugdb.com/
10 commits 1 branch 9 tags 316 KiB
Find a file
mahlon db85c36d70 Multiple changes. 
- Minor README updates.
- Create LICENSE and History files.
- Use 'func' instead of 'proc' where applicable.
- Add some destructor debug.
- Rename primary exceptions to 'X-error'.
- Bind to proper object types in prepared statement parameters.
- Retain the found 'type' in the KuzuValue object.

FossilOrigin-Name: db59c0b901b1715170e0d269fc2bf00477ac48af4d10a747eb5a749adbf6268e
2025-03-29 23:17:10 +00:00
experiments Checkpoint. 2025-03-27 08:09:17 +00:00
src Multiple changes. 2025-03-29 23:17:10 +00:00
tests Multiple changes. 2025-03-29 23:17:10 +00:00
tmp Initial commit, adding work to date. 2025-03-15 20:26:58 +00:00
.editorconfig Multiple changes. 2025-03-29 23:17:10 +00:00
History.md Multiple changes. 2025-03-29 23:17:10 +00:00
kuzu.nimble Work on prepared statements. 2025-03-23 21:21:05 +00:00
LICENCE Multiple changes. 2025-03-29 23:17:10 +00:00
README.md Multiple changes. 2025-03-29 23:17:10 +00:00

README.md

Nim Kuzu

home
https://code.martini.nu/fossil/nim-kuzu
github_mirror
https://github.com/mahlonsmith/nim-kuzu

Description

This is a Nim binding for the Kuzu graph database library.

Kuzu is an embedded graph database built for query speed and scalability. It is optimized for handling complex join-heavy analytical workloads on very large graphs, with the following core feature set:

  • Property Graph data model and Cypher query language
  • Embedded (in-process) integration with applications
  • Columnar disk-based storage
  • Columnar, compressed sparse row-based (CSR) adjacency list/join indices
  • Vectorized and factorized query processor
  • Novel and very fast join algorithms
  • Multi-core query parallelism
  • Serializable ACID transactions

For more information about Kuzu itself, see its documentation.

Prerequisites

  • A functioning Nim >= 2 installation
  • KuzuDB to be locally installed!

Installation

$ nimble install kuzu

Usage

[!TODO]- Human readable usage docs!

... The nim generated source isn't great when pulling in the C wrapper auto-gen stuff.

If you're here and reading this before I have proper docs written, see the tests/ for some working examples.

Contributing

You can check out the current development source with Fossil via its home repo, or with Git/Jujutsu at its project mirror

After checking out the source, uncomment the development dependencies from the kuzu.nimble file, and run:

$ nimble setup

This will install dependencies, and do any other necessary setup for development.

Authors

A note of thanks to @mantielero on Github, who has a Kuzu binding for an early KuzuDB (0.4.x) that I found after starting this project.