mirror of
https://github.com/jackfoxy/urQL.git
synced 2025-01-07 08:48:03 +03:00
30 lines
1.1 KiB
Markdown
30 lines
1.1 KiB
Markdown
# urQL
|
|
Scripting language grammar and parser for an Urbit RDBMS.
|
|
|
|
Pull Requests are appreciated, but you should start a discussion before you proceed. If green-lit then open an issue.
|
|
|
|
## Usage
|
|
Build the library.
|
|
|
|
`=parse -build-file /=urql=/lib/parse/hoon`
|
|
|
|
Submit a command for parsing in the dojo.
|
|
|
|
`(parse:parse(current-database 'db1') "FROM foo SELECT TOP 10 DISTINCT *")`
|
|
|
|
Successful commands will return a typed list of commands parsed into their respective data structures.
|
|
|
|
## Utilities
|
|
Error messages and failed tests return untyped hoon data, which looks like a blizard of big numbers. To make it suitable for human viewing there is a utility to change the atom big numbers to cords for all the urQL key words, type-tags, and many of the variable names.
|
|
|
|
1. Install the latest dotnet. Works on Linux and Mac.
|
|
2. Save the noun the dojo gave you to a file.
|
|
3. The utility will add '2' to the file name and save it (e.g. input.txt becomes input.txt2)
|
|
|
|
```
|
|
> dotnet fsi display-hoon.fsx input.txt
|
|
|
|
> cat input.txt2
|
|
[[%selected-aggregate COUNT %qualified-column [%qualified-object 0 'UNKNOWN' 'COLUMN-OR-CTE' %foo] %foo 0] %as CountFoo]
|
|
```
|