SurrealDB Functions 
This is a proc-macro crate that given a path to a .surql file or a folder of .surql files, will parse DEFINE FUNCTION fn::s inside them and output rust fns that wrap around them. It will also generate a bootstrap function that stores the defined functions to db, and finally if a function is nested (fn::a::nested::function) it will be put in a nested module.
Usage
Example usage can be found in examples/main.rs, but in short, its main usage is as follows:
include_fn!{
driver as is;
datastore as ds_$;
"$CARGO_MANIFEST_DIR/tests/main.surql"
}
When calling the macro you need to provide what naming the bindings should use: driver/datastore as is/prefix_$/$_suffix
iswill not apply any changes to the method names.prefix_$/$_suffixwill replace$with function name, effectively prefixing/suffixing it (ex.prefix_greet/greet_suffix)
At least one of driver/datastore must be defined.
driverwill generate regularSurreal<C>bindings.datastorewill generate bindings for the more low-level locally-available-onlysurrealdb::kvs::Datastore
If both are defined, the parser will validate they don't conflict. (ex. you can't have both be as is)
Finally the last argument type is a file/directory path, if a directory is provided, it will be recursively resolved.
At least one valid path argument is expected, but more can be supplied. All resolved are stored in a hashset internally so path duplication should be a non-issue.
The docs.rs content is coming later, for now either read the source or ask me in surrealdb discord (same handle as on github). I am open to new feature/pull requests.
Crate notes
This is a utility proc-macro for surrealdb, as such it expects presence of surrealdb in user's dependencies. However, this crate by itself, does not depend on surrealdb.
Parser notes
Currently this macro only has the minimal surrealql parser for resolving the custom function definitions, sans their body.
19 Jan 6, 2023
148 Dec 30, 2022
6 Jul 27, 2022
5 Jul 9, 2023
483 Jan 7, 2023
7 Aug 25, 2022
6 Dec 14, 2022
4 Oct 5, 2023
3 Nov 12, 2024
4 May 2, 2022
2 Dec 4, 2022
3 Jul 15, 2023
0 Feb 17, 2022
2 Dec 14, 2022
20 Feb 12, 2023
17 Mar 22, 2023
5 Jul 30, 2021
6 Nov 26, 2022
43 Dec 24, 2022