`WHERE IN (...)` support

From the docs:

Multiple objects passed to .where are joined with or.

sq.from`person`.where({ name: 'Rob' }, { name: 'Bob' }).query

{ text: 'select * from person where (name = $1 or name = $2)',
  args: ['Rob', 'Bob'] }

Any reason we couldn’t join the objects with IN (?, ?) notation?

[eejdoowad]

Yep, I’m definitely going with 2. The current plan is to provide an expression builder.

I’m currently debating whether to provide a fluent interface or an expression tree interface.

// option 1: fluent interface
// pros: reads like SQL
// cons: confusing operator precedence, more difficult implementation
const condition =
  e('book.genre').in(['Fiction', 'History', 'Fantasy'])
  .and(e('book.publish_year').lt(1980))

// option 2: expression tree
// pros: explicit operator ordering, simpler implementation, easier typing
// cons: not like SQL
const condition = e.and(
  e.in('book.genre', ['Fiction', 'History', 'Fantasy']),
  e.lt('book.publish_year', 1980)
)

// both would be used like follows:
sq.from('book').where(condition).return('title', 'id').query
{ text: 'select title, id from book where (book.genre in ($1, $2, $3) and book.publish_year < $4',
  args: ['Fiction', 'History', 'Fantasy', 1980] }

I’m probably going with 2.

[eejdoowad]

A little bit behind schedule, and with MANY breaking API changes, but I ended up implementing a much more ambitious proposal: a functional, strongly typed expression builder.

See https://sqorn.org/docs/expressions.html.

// All the queries below produce:
// 'select * from book where id in ($1, $2, $3)'

// pass multiple arguments to .sql to build a values list
sq.sql`select * from book where id in`.sql(1, 2, 3)

// object form detects array and builds in
sq.from`book`.where({ id: [1, 2, 3] })

// e.in operation accepts two arguments
sq.from`book`.where(e.in(e`id`, [1, 2, 3]))

// operations can be curried
sq.from`book`.where(e.in`id`([1, 2, 3]))

// operations can be chained
sq.from`book`.where(e`id`.in([1, 2, 3]))

Switch to package ‘@sqorn/pg’ v0.0.45. See the updated tutorial setup: https://sqorn.org/docs/setup.html