https://github.com/aldy505/sql-dsl

SQL as template literal (for a lot of stuff)
https://github.com/aldy505/sql-dsl

database dsl mysql postgresql sql

Last synced: 3 months ago
JSON representation

SQL as template literal (for a lot of stuff)

• Host: GitHub
• URL: https://github.com/aldy505/sql-dsl
• Owner: aldy505
• License: mit
• Created: 2021-07-11T11:03:47.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2024-02-11T13:02:52.000Z (11 months ago)
• Last Synced: 2024-10-10T18:59:56.528Z (3 months ago)
• Topics: database, dsl, mysql, postgresql, sql
• Language: TypeScript
• Homepage:
• Size: 157 KB
• Stars: 8
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# SQL DSL for your Node App

[![npm](https://img.shields.io/npm/v/sql-dsl?style=flat-square) ![npm bundle size](https://img.shields.io/bundlephobia/min/sql-dsl?style=flat-square) ![npm](https://img.shields.io/npm/dm/sql-dsl?style=flat-square)](https://www.npmjs.com/package/sql-dsl) [![Codecov](https://img.shields.io/codecov/c/github/aldy505/sql-dsl?style=flat-square)](https://codecov.io/gh/aldy505/sql-dsl) [![GitHub branch checks state](https://img.shields.io/github/checks-status/aldy505/sql-dsl/master?style=flat-square)](https://github.com/aldy505/sql-dsl/actions) [![CodeFactor](https://www.codefactor.io/repository/github/aldy505/sql-dsl/badge)](https://www.codefactor.io/repository/github/aldy505/sql-dsl) [![GitHub](https://img.shields.io/github/license/aldy505/sql-dsl?style=flat-square)](https://github.com/aldy505/sql-dsl/blob/master/LICENSE)

Based on an idea from [@ronnygunawan](https://github.com/ronnygunawan). This was supposed to be a challenge for someone else, but I thought, why not? Lol.

As always:

* Supports CJS and ESM

* Built-in typings

* No external dependencies

```bash

npm install sql-dsl

```

## What this does?

This outputs simple SQL query & argument object from your template literal string.

```js

import { sql } from 'sql-dsl'

const query = sql`INSERT INTO users (name, email, age) VALUES (${`Thomas Worgdjik`}, ${`[email protected]`}, ${30})`

// {

//   sql: 'INSERT INTO users (name, email, age) VALUES ($1, $2, $3)',

//   values: ['Thomas Worgdjik', '[email protected]', 30]

// }

// Oh, you work with MySQL instead of Postgres? Sure!

const postgres = query.formatQuestion()

// {

//   sql: 'INSERT INTO users (name, email, age) VALUES (?, ?, ?)',

//   values: ['Thomas Worgdjik', '[email protected]', 30]

// }

// More elegant way to do that is this:

const query = sql`INSERT INTO users (name, email, age) VALUES (${`Thomas Worgdjik`}, ${`[email protected]`}, ${30})`.formatQuestion()

// Your database work with colon notation? Something like :1 :2 etc? No problem.

const colon = query.formatColon()

// {

//   sql: 'INSERT INTO users (name, email, age) VALUES (:1, :2, :3)',

//   values: ['Thomas Worgdjik', '[email protected]', 30]

// }

// Your database work with @p notation? Yeah, we can do that.

const atp = query.formatAtP()

// {

//   sql: 'INSERT INTO users (name, email, age) VALUES (@p1, @p2, @p3)',

//   values: ['Thomas Worgdjik', '[email protected]', 30]

// }

```

See more examples with the database drivers on [examples](./examples).

## Hey, I want a feature!

Want more features? Open something up on [issues](https://github.com/aldy505/sql-dsl). To be honest, I don't know what else to add.