Skip to content

Commit c763aa8

Browse files
committed
Update Readme
1 parent 522b82f commit c763aa8

File tree

4 files changed

+69
-33
lines changed

4 files changed

+69
-33
lines changed

Documentation/Assets/banner.afdesign

10.7 MB
Binary file not shown.

Documentation/Assets/banner.jpg

524 KB
Loading

Documentation/README_ARCHITECTURE.md

Lines changed: 40 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,24 @@
22

33
Embedded property graph database built for speed. Vector search and full-text search built in. Graph Query Language of Cypher.
44

5-
## Usage
5+
# Usage
66

7-
Requires a C++ compiler such as MSVC or MSY2
7+
## Setup
8+
9+
Requires a C++ compiler such as MSVC or MSYS2
10+
11+
### Windows
12+
13+
1. Setup a C++ Environment
14+
1. Possible Setup for VS Code : https://code.visualstudio.com/docs/cpp/config-mingw
15+
16+
Ensure that C++ can run :
17+
18+
```bash
19+
gcc --version
20+
g++ --version
21+
gdb --version
22+
```
823

924
### Building :
1025

@@ -17,6 +32,8 @@ Requires a C++ compiler such as MSVC or MSY2
1732

1833
## Debugging Linux (WSL)
1934

35+
Install Gdb && Valgrind
36+
2037
1. Build for Linux
2138
1. `scons target=linux debug_symbols=yes`
2239
1. Run Godot Demo Project with Debugger
@@ -27,7 +44,6 @@ Requires a C++ compiler such as MSVC or MSY2
2744

2845
## Debugging Windows
2946

30-
1. https://youtu.be/8WSIMTJWCBk?t=3624
3147
1. `scons target=template_debug debug_symbols=yes`
3248

3349
Launch.json
@@ -63,3 +79,24 @@ Tasks.json:
6379
]
6480
}
6581
```
82+
83+
# Godot GDExtension
84+
85+
[This repository uses the Godot quickstart template for GDExtension development with Godot 4.0+.](https://github.com/godotengine/godot-cpp-template)
86+
87+
## Contents
88+
89+
- godot-cpp as a submodule (`godot-cpp/`)
90+
- (`demo/`) Godot 4.4 Project that tests the Extension
91+
- preconfigured source files for C++ development of the GDExtension (`src/`)
92+
- setup to automatically generate `.xml` files in a `doc_classes/` directory to be parsed by Godot as [GDExtension built-in documentation](https://docs.godotengine.org/en/stable/tutorials/scripting/gdextension/gdextension_docs_system.html)
93+
94+
# Github
95+
96+
_Currently Commented Out for Base Development_
97+
98+
- GitHub Issues template (`.github/ISSUE_TEMPLATE.yml`)
99+
- GitHub CI/CD workflows to publish your library packages when creating a release (`.github/workflows/builds.yml`)
100+
101+
This repository comes with a GitHub action that builds the GDExtension for cross-platform use. It triggers automatically for each pushed change. You can find and edit it in [builds.yml](.github/workflows/builds.yml).
102+
After a workflow run is complete, you can find the file `godot-cpp-template.zip` on the `Actions` tab on GitHub.

README.md

Lines changed: 29 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,51 +1,50 @@
1+
![Banner](Documentation/Assets/banner.jpg)
2+
13
# Kuzu Godot
24

35
**Godot 4.4 is currently used Version**
46

5-
Bindings for Kuzu in Godot
7+
Bindings for [Kuzu](https://github.com/kuzudb/kuzu) in [Godot](https://github.com/godotengine/godot)
68

7-
Embedded property graph database built for speed. Vector search and full-text search built in. Using Graph Query Language of Cypher.
9+
Embedded property graph database built for speed. Using Graph Query Language of [Cypher](https://opencypher.org/resources/).
810

911
# Overview
1012

11-
# Setup
12-
13-
## Binaries
14-
15-
Requires the Kuzu Binaries in the `bin/<platform>/kuzu` folders.
13+
1. Create an Instance of Kuzu
14+
1. Set the Database Folder Path
15+
1. Initialize the Database
16+
1. Create a Connection to the DB with thread count
1617

17-
## Windows
18+
```gdscript
1819
19-
1. Setup a C++ Environment
20-
1. Possible Setup for VS Code : https://code.visualstudio.com/docs/cpp/config-mingw
20+
var myKuzuDB : KuzuGD = KuzuGD.new(); # Instantiate
21+
var db_path = ProjectSettings.globalize_path("res://data/database/kuzu_db");
22+
var success_db = myKuzuDB.kuzu_init(db_path); # Set Path
23+
var success_connect = myKuzuDB.kuzu_connect(1); # Activate Connection
2124
22-
Ensure that C++ can run :
23-
24-
```bash
25-
gcc --version
26-
g++ --version
27-
gdb --version
2825
```
2926

30-
# Godot
27+
1. Execute Queries
28+
1. Define Tables
29+
1. Write Data
30+
1. Read Data
3131

32-
## Godot GDExtension
32+
```gdscript
3333
34-
[This repository uses the Godot quickstart template for GDExtension development with Godot 4.0+.](https://github.com/godotengine/godot-cpp-template)
34+
# Define Tables
35+
myKuzuDB.execute_query("CREATE NODE TABLE IF NOT EXISTS person(name STRING, age INT64, PRIMARY KEY(name));");
3536
36-
### Contents
37+
# Write Data
38+
myKuzuDB.execute_query("CREATE (:person {name: 'Alice', age: 30});");
3739
38-
- godot-cpp as a submodule (`godot-cpp/`)
39-
- (`demo/`) Godot 4.4 Project that tests the Extension
40-
- preconfigured source files for C++ development of the GDExtension (`src/`)
41-
- setup to automatically generate `.xml` files in a `doc_classes/` directory to be parsed by Godot as [GDExtension built-in documentation](https://docs.godotengine.org/en/stable/tutorials/scripting/gdextension/gdextension_docs_system.html)
40+
# Read Data
41+
var queryResult : Array = myKuzuDB.execute_query("MATCH (p:person) RETURN p.*");
42+
print(queryResult);
4243
43-
## Github
44+
```
4445

45-
_Currently Commented Out for Base Development_
46+
# Setup
4647

47-
- GitHub Issues template (`.github/ISSUE_TEMPLATE.yml`)
48-
- GitHub CI/CD workflows to publish your library packages when creating a release (`.github/workflows/builds.yml`)
48+
## Building from Source
4949

50-
This repository comes with a GitHub action that builds the GDExtension for cross-platform use. It triggers automatically for each pushed change. You can find and edit it in [builds.yml](.github/workflows/builds.yml).
51-
After a workflow run is complete, you can find the file `godot-cpp-template.zip` on the `Actions` tab on GitHub.
50+
Requires the Kuzu Binaries in the `bin/<platform>/kuzu` folders, pythons Scons, Godot, g++ compiler.

0 commit comments

Comments
 (0)