https://github.com/jackfoxy/obelisk

Time travelling relational database engine and urQL (SQL derived) scripting for the Urbit computer
https://github.com/jackfoxy/obelisk

hoon personal-server sql sql-server urbit

Last synced: about 18 hours ago
JSON representation

Time travelling relational database engine and urQL (SQL derived) scripting for the Urbit computer

• Host: GitHub
• URL: https://github.com/jackfoxy/obelisk
• Owner: jackfoxy
• License: other
• Created: 2023-06-07T05:48:58.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2024-11-15T20:41:00.000Z (4 days ago)
• Last Synced: 2024-11-15T21:28:11.805Z (4 days ago)
• Topics: hoon, personal-server, sql, sql-server, urbit
• Language: hoon
• Homepage:
• Size: 1.38 MB
• Stars: 12
• Watchers: 2
• Forks: 2
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md
  • Roadmap: docs/roadmap.md

Awesome Lists containing this project

README

        
# Obelisk

### RDBMS for the Urbit computer

* Time traveling databases, every database state is indexed by time.

* Queries are (implicitly) idempotent, thanks to indexed database states.

* Query results are proper sets of the result rows.

* No NULLS, anywhere, ever.

* Scripts are atomic (pass/fail)

Obelisk employs a dialect of SQL called urQL that provides for these properties.

See References/Preliminaries and the Users Guide in the docs folder for more information.

### Sample database

This repository includes a sample database, "animal-shelter", derived from https://github.com/ami-levin/Animal_Shelter.  

### Bug reporting

Reporting bugs is encouraged and appreciated. Please open an issue with a minimal urQL script reproducing the bug using the sample database, or if it's not possible to reproduce in the sample database provide the full DDL and other commands to reproduce.

Reporting documentation bugs is also appreciated.

### Contributions

This projects welcomes contributors.

### Using the %hawk UI

To interact with Obelisk from %hawk:

- Ensure you have %hawk installed

  `|install ~dister-migrev-dolseg %hawk`

- Create a file in your hawk namespace

- Paste the contents of templates/hawk.txt (in this repo)

  into the hawk file