https://github.com/schveiguy/sqlbuilder

DLang SQL Builder using prepared statements.
https://github.com/schveiguy/sqlbuilder

Last synced: 2 months ago
JSON representation

DLang SQL Builder using prepared statements.

• Host: GitHub
• URL: https://github.com/schveiguy/sqlbuilder
• Owner: schveiguy
• License: bsl-1.0
• Created: 2020-02-11T16:39:36.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2025-01-26T23:35:52.000Z (4 months ago)
• Last Synced: 2025-03-14T19:16:36.951Z (3 months ago)
• Language: D
• Size: 102 KB
• Stars: 9
• Watchers: 2
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# SQL Builder and database serializer

sqlbuilder is a small library that is used to make dynamically created sql easier to write. It also can serve as an abstraction layer for multiple database implementations. Currently, MySQL and sqlite are supported, with PostgreSQL support planned. Other systems may also fit within the design, but I have not focused on anything other than those three.

## Implemented Features

* Declarative syntax for tables and joins

* Joins are automatically handled by the building functions. Joins are only used when data from that join is needed.

* Statements that don't allow joins should be wrapped with dialect-specific mechanisms.

* Wrap any type that represents a row as a `DataSet` and it can be used to query that data.

* UDAs to specify relationships and specialized handling of columns. Relationships are provided in `DataSet` to allow joins automatically to be added.

* Add columns to select, orderings, conditional clauses at any time (out of order construction). Individual clauses must be built in order.

* Parameters are used in-line to allow more intuitive statements.

* Automatic handling of parameters to avoid SQL injection attacks.

* Supports easy inserts and updates of whole records.

* Can also update individual records without having a model to use.

* Create and drop database tables and relationships with compile-time generated SQL.

* Deserialize automatically data from the database into the appropriate structs or types, generating a range of those types automatically.

* Duck-typing of expressions, parameters, and table references that allows building one's own `DataSet`-like abstractions.

* `ExprString` type which allows building of strings without utilizing too much extra allocation, and allows specialized tokens within the string to be recognized by the various dialects.

## Planned features

* Compile-time generation of SQL for queries without parameters.

* Integration with PostgreSQL

* Support alternate allocation schemes (currently, everthing is done via GC arrays). Possibly some small-array optimization for `ExprString`.

* Investigate the possibility of avoiding allocating a full string for SQL queries.

* Add ways to insert related rows (for example, a record of an Author might provide an "addBook" function automatically which has as parameters the non-key related items).

* Support CTE and subqueries