README.rst

@@ -57,7 +57,7 @@ Models may be defined as:
 
 .. code-block:: Nim
    # models.nim
-   import std/[options, times]
+   import std/options, std/times
    import uuids
 
    type
@@ -82,8 +82,6 @@ Using Fiber ORM we can generate a data access layer with:
 
 .. code-block:: Nim
    # db.nim
-   import std/[options]
-   import db_connectors/db_postgres
    import fiber_orm
    import ./models.nim
 
@@ -104,7 +102,6 @@ This will generate the following procedures:
 
 .. code-block:: Nim
    proc getTodoItem*(db: TodoDB, id: UUID): TodoItem;
-   proc getTodoItemIfItExists*(db: TodoDB, id: UUID): Option[TodoItem];
    proc getAllTodoItems*(db: TodoDB): seq[TodoItem];
    proc createTodoItem*(db: TodoDB, rec: TodoItem): TodoItem;
    proc updateTodoItem*(db: TodoDB, rec: TodoItem): bool;
@@ -115,7 +112,6 @@ This will generate the following procedures:
      values: varargs[string, dbFormat]): seq[TodoItem];
 
    proc getTimeEntry*(db: TodoDB, id: UUID): TimeEntry;
-   proc getTimeEntryIfItExists*(db: TodoDB, id: UUID): Option[TimeEntry];
    proc getAllTimeEntries*(db: TodoDB): seq[TimeEntry];
    proc createTimeEntry*(db: TodoDB, rec: TimeEntry): TimeEntry;
    proc updateTimeEntry*(db: TodoDB, rec: TimeEntry): bool;

fiber_orm.nimble

@@ -1,6 +1,6 @@
 # Package
 
-version       = "3.1.1"
+version       = "2.2.0"
 author        = "Jonathan Bernard"
 description   = "Lightweight Postgres ORM for Nim."
 license       = "GPL-3.0"
@@ -11,4 +11,4 @@ srcDir        = "src"
 # Dependencies
 
 requires @["nim >= 1.4.0", "uuids"]
-requires "namespaced_logging >= 1.0.0"
+requires "namespaced_logging >= 0.3.0"

src/fiber_orm.nim

@@ -1,6 +1,6 @@
 # Fiber ORM
 #
-# Copyright 2019-2024 Jonathan Bernard <jonathan@jdbernard.com>
+# Copyright 2019 Jonathan Bernard <jonathan@jdbernard.com>
 
 ## Lightweight ORM supporting the `Postgres`_ and `SQLite`_ databases in Nim.
 ## It supports a simple, opinionated model mapper to generate SQL queries based
@@ -264,28 +264,26 @@
 ## In the example above the `pool.DbConnPool`_ object is used as database
 ## object type (aliased as `TodoDB`). This is the intended usage pattern, but
 ## anything can be passed as the database object type so long as there is a
-## defined `withConnection` template that provides a `conn: DbConn` object
+## defined `withConn` template that provides an injected `conn: DbConn` object
 ## to the provided statement body.
 ##
 ## For example, a valid database object implementation that opens a new
 ## connection for every request might look like this:
 ##
 ## .. code-block:: Nim
-##    import db_connector/db_postgres
+##    import std/db_postgres
 ##
 ##    type TodoDB* = object
 ##      connString: string
 ##
-##    template withConnection*(db: TodoDB, stmt: untyped): untyped =
+##    template withConn*(db: TodoDB, stmt: untyped): untyped =
-##      block:
+##      let conn {.inject.} = open("", "", "", db.connString)
-##        let conn = open("", "", "", db.connString)
 ##      try: stmt
 ##      finally: close(conn)
 ##
 ## .. _pool.DbConnPool: fiber_orm/pool.html#DbConnPool
 ##
-import std/[json, macros, options, sequtils, strutils]
+import std/[db_common, logging, macros, options, sequtils, strutils]
-import db_connector/db_common
 import namespaced_logging, uuids
 
 from std/unicode import capitalize
@@ -294,9 +292,22 @@ import ./fiber_orm/db_common as fiber_db_common
 import ./fiber_orm/pool
 import ./fiber_orm/util
 
-export pool, util
+export
+  pool,
+  util.columnNamesForModel,
+  util.dbFormat,
+  util.dbNameToIdent,
+  util.identNameToDb,
+  util.modelName,
+  util.rowToModel,
+  util.tableName
 
 type
+  PaginationParams* = object
+    pageSize*: int
+    offset*: int
+    orderBy*: Option[string]
+
   PagedRecords*[T] = object
     pagination*: Option[PaginationParams]
     records*: seq[T]
@@ -308,20 +319,11 @@ type
   NotFoundError* = object of CatchableError ##\
     ## Error type raised when no record matches a given ID
 
-var logService {.threadvar.}: Option[LogService]
+var logNs {.threadvar.}: LoggingNamespace
-var logger {.threadvar.}: Option[Logger]
 
-proc logQuery*(methodName: string, sqlStmt: string, args: openArray[(string, string)] = []) =
+template log(): untyped =
-  # namespaced_logging would do this check for us, but we don't want to even
+  if logNs.isNil: logNs = getLoggerForNamespace(namespace = "fiber_orm", level = lvlNotice)
-  # build the log object if we're not actually logging
+  logNs
-  if logService.isNone: return
-  if logger.isNone: logger = logService.getLogger("fiber_orm/query")
-  var log = %*{ "method": methodName, "sql": sqlStmt }
-  for (k, v) in args: log[k] = %v
-  logger.debug(log)
-
-proc enableDbLogging*(svc: LogService) =
-  logService = some(svc)
 
 proc newMutateClauses(): MutateClauses =
   return MutateClauses(
@@ -347,7 +349,7 @@ proc createRecord*[D: DbConnType, T](db: D, rec: T): T =
     " VALUES (" & mc.placeholders.join(",") & ") " &
     " RETURNING " & columnNamesForModel(rec).join(",")
 
-  logQuery("createRecord", sqlStmt)
+  log().debug "createRecord: [" & sqlStmt & "]"
   let newRow = db.getRow(sql(sqlStmt), mc.values)
 
   result = rowToModel(T, newRow)
@@ -363,7 +365,7 @@ proc updateRecord*[D: DbConnType, T](db: D, rec: T): bool =
     " SET " & setClause &
     " WHERE id = ? "
 
-  logQuery("updateRecord", sqlStmt, [("id", $rec.id)])
+  log().debug "updateRecord: [" & sqlStmt & "] id: " & $rec.id
   let numRowsUpdated = db.execAffectedRows(sql(sqlStmt), mc.values.concat(@[$rec.id]))
 
   return numRowsUpdated > 0;
@@ -376,7 +378,7 @@ proc createOrUpdateRecord*[D: DbConnType, T](db: D, rec: T): T =
   ## Note that this does not perform partial updates, all fields are updated.
 
   let findRecordStmt = "SELECT id FROM " & tableName(rec) & " WHERE id = ?"
-  logQuery("createOrUpdateRecord", findRecordStmt, [("id", $rec.id)])
+  log().debug "createOrUpdateRecord: [" & findRecordStmt & "] id: " & $rec.id
   let rows = db.getAllRows(sql(findRecordStmt), [$rec.id])
 
   if rows.len == 0: result = createRecord(db, rec)
@@ -389,7 +391,7 @@ proc createOrUpdateRecord*[D: DbConnType, T](db: D, rec: T): T =
 template deleteRecord*[D: DbConnType](db: D, modelType: type, id: typed): untyped =
   ## Delete a record by id.
   let sqlStmt = "DELETE FROM " & tableName(modelType) & " WHERE id = ?"
-  logQuery("deleteRecord", sqlStmt, [("id", $id)])
+  log().debug "deleteRecord: [" & sqlStmt & "] id: " & $id
   db.tryExec(sql(sqlStmt), $id)
 
 proc deleteRecord*[D: DbConnType, T](db: D, rec: T): bool =
@@ -397,7 +399,7 @@ proc deleteRecord*[D: DbConnType, T](db: D, rec: T): bool =
   ##
   ## .. _id: #model-class-id-field
   let sqlStmt = "DELETE FROM " & tableName(rec) & " WHERE id = ?"
-  logQuery("deleteRecord", sqlStmt, [("id", $rec.id)])
+  log().debug "deleteRecord: [" & sqlStmt & "] id: " & $rec.id
   return db.tryExec(sql(sqlStmt), $rec.id)
 
 template getRecord*[D: DbConnType](db: D, modelType: type, id: typed): untyped =
@@ -407,7 +409,7 @@ template getRecord*[D: DbConnType](db: D, modelType: type, id: typed): untyped =
     " FROM " & tableName(modelType) &
     " WHERE id = ?"
 
-  logQuery("getRecord", sqlStmt, [("id", $id)])
+  log().debug "getRecord: [" & sqlStmt & "] id: " & $id
   let row = db.getRow(sql(sqlStmt), @[$id])
 
   if allIt(row, it.len == 0):
@@ -433,9 +435,17 @@ template findRecordsWhere*[D: DbConnType](
     "SELECT COUNT(*) FROM " & tableName(modelType) &
     " WHERE " & whereClause
 
-  if page.isSome: fetchStmt &= getPagingClause(page.get)
+  if page.isSome:
+    let p = page.get
+    if p.orderBy.isSome:
+      fetchStmt &= " ORDER BY " & identNameToDb(p.orderBy.get)
+    else:
+      fetchStmt &= " ORDER BY id"
 
-  logQuery("findRecordsWhere", fetchStmt, [("values", values.join(", "))])
+    fetchStmt &= " LIMIT " & $p.pageSize &
+                 " OFFSET " & $p.offset
+
+  log().debug "findRecordsWhere: [" & fetchStmt & "] values: (" & values.join(", ") & ")"
   let records = db.getAllRows(sql(fetchStmt), values).mapIt(rowToModel(modelType, it))
 
   PagedRecords[modelType](
@@ -456,9 +466,17 @@ template getAllRecords*[D: DbConnType](
 
   var countStmt = "SELECT COUNT(*) FROM " & tableName(modelType)
 
-  if page.isSome: fetchStmt &= getPagingClause(page.get)
+  if page.isSome:
+    let p = page.get
+    if p.orderBy.isSome:
+      fetchStmt &= " ORDER BY " & identNameToDb(p.orderBy.get)
+    else:
+      fetchStmt &= " ORDER BY id"
 
-  logQuery("getAllRecords", fetchStmt)
+    fetchStmt &= " LIMIT " & $p.pageSize &
+                 " OFFSET " & $p.offset
+
+  log().debug "getAllRecords: [" & fetchStmt & "]"
   let records = db.getAllRows(sql(fetchStmt)).mapIt(rowToModel(modelType, it))
 
   PagedRecords[modelType](
@@ -487,9 +505,17 @@ template findRecordsBy*[D: DbConnType](
     "SELECT COUNT(*) FROM " & tableName(modelType) &
     " WHERE " & whereClause
 
-  if page.isSome: fetchStmt &= getPagingClause(page.get)
+  if page.isSome:
+    let p = page.get
+    if p.orderBy.isSome:
+      fetchStmt &= " ORDER BY " & identNameToDb(p.orderBy.get)
+    else:
+      fetchStmt &= " ORDER BY id"
 
-  logQuery("findRecordsBy", fetchStmt, [("values", values.join(", "))])
+    fetchStmt &= " LIMIT " & $p.pageSize &
+                 " OFFSET " & $p.offset
+
+  log().debug "findRecordsBy: [" & fetchStmt & "] values (" & values.join(", ") & ")"
   let records = db.getAllRows(sql(fetchStmt), values).mapIt(rowToModel(modelType, it))
 
   PagedRecords[modelType](
@@ -517,7 +543,7 @@ macro generateProcsForModels*(dbType: type, modelTypes: openarray[type]): untype
   ##    proc findTodoItemsWhere*(
   ##      db: TodoDB, whereClause: string, values: varargs[string]): TodoItem;
   ##
-  ## `dbType` is expected to be some type that has a defined `withConnection`
+  ## `dbType` is expected to be some type that has a defined `withConn`
   ## procedure (see `Database Object`_ for details).
   ##
   ## .. _Database Object: #database-object
@@ -530,7 +556,6 @@ macro generateProcsForModels*(dbType: type, modelTypes: openarray[type]): untype
 
     let modelName = $(t.getType[1])
     let getName = ident("get" & modelName)
-    let getIfExistsName = ident("get" & modelName & "IfItExists")
     let getAllName = ident("getAll" & pluralize(modelName))
     let findWhereName = ident("find" & pluralize(modelName) & "Where")
     let createName = ident("create" & modelName)
@@ -540,38 +565,33 @@ macro generateProcsForModels*(dbType: type, modelTypes: openarray[type]): untype
     let idType = typeOfColumn(t, "id")
     result.add quote do:
       proc `getName`*(db: `dbType`, id: `idType`): `t` =
-        db.withConnection conn: result = getRecord(conn, `t`, id)
+        db.withConn: result = getRecord(conn, `t`, id)
-
-      proc `getIfExistsName`*(db: `dbType`, id: `idType`): Option[`t`] =
-        db.withConnection conn:
-          try: result = some(getRecord(conn, `t`, id))
-          except NotFoundError: result = none[`t`]()
 
       proc `getAllName`*(db: `dbType`, pagination = none[PaginationParams]()): PagedRecords[`t`] =
-        db.withConnection conn: result = getAllRecords(conn, `t`, pagination)
+        db.withConn: result = getAllRecords(conn, `t`, pagination)
 
       proc `findWhereName`*(
           db: `dbType`,
           whereClause: string,
           values: varargs[string, dbFormat],
           pagination = none[PaginationParams]()): PagedRecords[`t`] =
-        db.withConnection conn:
+        db.withConn:
           result = findRecordsWhere(conn, `t`, whereClause, values, pagination)
 
       proc `createName`*(db: `dbType`, rec: `t`): `t` =
-        db.withConnection conn: result = createRecord(conn, rec)
+        db.withConn: result = createRecord(conn, rec)
 
       proc `updateName`*(db: `dbType`, rec: `t`): bool =
-        db.withConnection conn: result = updateRecord(conn, rec)
+        db.withConn: result = updateRecord(conn, rec)
 
       proc `createOrUpdateName`*(db: `dbType`, rec: `t`): `t` =
         db.inTransaction: result = createOrUpdateRecord(conn, rec)
 
       proc `deleteName`*(db: `dbType`, rec: `t`): bool =
-        db.withConnection conn: result = deleteRecord(conn, rec)
+        db.withConn: result = deleteRecord(conn, rec)
 
       proc `deleteName`*(db: `dbType`, id: `idType`): bool =
-        db.withConnection conn: result = deleteRecord(conn, `t`, id)
+        db.withConn: result = deleteRecord(conn, `t`, id)
 
 macro generateLookup*(dbType: type, modelType: type, fields: seq[string]): untyped =
   ## Create a lookup procedure for a given set of field names. For example,
@@ -591,7 +611,7 @@ macro generateLookup*(dbType: type, modelType: type, fields: seq[string]): untyp
   # Create proc skeleton
   result = quote do:
     proc `procName`*(db: `dbType`): PagedRecords[`modelType`] =
-      db.withConnection conn: result = findRecordsBy(conn, `modelType`)
+      db.withConn: result = findRecordsBy(conn, `modelType`)
 
   var callParams = quote do: @[]
 
@@ -615,11 +635,11 @@ macro generateLookup*(dbType: type, modelType: type, fields: seq[string]): untyp
 
   # Add the call params to the inner procedure call
   # result[6][0][1][0][1] is
-  #   ProcDef -> [6]: StmtList (body) -> [0]: Command ->
+  #   ProcDef -> [6]: StmtList (body) -> [0]: Call ->
-  #     [2]: StmtList (withConnection body) -> [0]: Asgn (result =) ->
+  #     [1]: StmtList (withConn body) -> [0]: Asgn (result =) ->
   #     [1]: Call (inner findRecords invocation)
-  result[6][0][2][0][1].add(callParams)
+  result[6][0][1][0][1].add(callParams)
-  result[6][0][2][0][1].add(quote do: pagination)
+  result[6][0][1][0][1].add(quote do: pagination)
 
 macro generateProcsForFieldLookups*(dbType: type, modelsAndFields: openarray[tuple[t: type, fields: seq[string]]]): untyped =
   result = newStmtList()
@@ -633,7 +653,7 @@ macro generateProcsForFieldLookups*(dbType: type, modelsAndFields: openarray[tup
     # Create proc skeleton
     let procDefAST = quote do:
       proc `procName`*(db: `dbType`): PagedRecords[`modelType`] =
-        db.withConnection conn: result = findRecordsBy(conn, `modelType`)
+        db.withConn: result = findRecordsBy(conn, `modelType`)
 
     var callParams = quote do: @[]
 
@@ -685,8 +705,8 @@ proc initPool*[D: DbConnType](
     hardCap: hardCap,
     healthCheckQuery: healthCheckQuery))
 
-template inTransaction*(db, body: untyped) =
+template inTransaction*[D: DbConnType](db: DbConnPool[D], body: untyped) =
-  db.withConnection conn:
+  pool.withConn(db):
     conn.exec(sql"BEGIN TRANSACTION")
     try:
       body

src/fiber_orm/db_common.nim

@@ -1,3 +1,3 @@
-import db_connector/[db_postgres, db_sqlite]
+import std/[db_postgres, db_sqlite]
 
 type DbConnType* = db_postgres.DbConn or db_sqlite.DbConn

src/fiber_orm/pool.nim

@@ -4,12 +4,12 @@
 
 ## Simple database connection pooling implementation compatible with Fiber ORM.
 
-import std/[sequtils, strutils, sugar]
+import std/[db_common, logging, sequtils, strutils, sugar]
-import db_connector/db_common
 
-from db_connector/db_sqlite import getRow, close
+from std/db_sqlite import getRow, close
-from db_connector/db_postgres import getRow, close
+from std/db_postgres import getRow, close
 
+import namespaced_logging
 import ./db_common as fiber_db_common
 
 type
@@ -43,14 +43,21 @@ type
     cfg: DbConnPoolConfig[D]
     lastId: int
 
+var logNs {.threadvar.}: LoggingNamespace
+
+template log(): untyped =
+  if logNs.isNil: logNs = getLoggerForNamespace(namespace = "fiber_orm/pool", level = lvlNotice)
+  logNs
+
 proc initDbConnPool*[D: DbConnType](cfg: DbConnPoolConfig[D]): DbConnPool[D] =
+  log().debug("Initializing new pool (size: " & $cfg.poolSize)
   result = DbConnPool[D](
     conns: @[],
     cfg: cfg)
 
 proc newConn[D: DbConnType](pool: DbConnPool[D]): PooledDbConn[D] =
+  log().debug("Creating a new connection to add to the pool.")
   pool.lastId += 1
-  {.gcsafe.}:
   let conn = pool.cfg.connect()
   result = PooledDbConn[D](
     conn: conn,
@@ -59,6 +66,7 @@ proc newConn[D: DbConnType](pool: DbConnPool[D]): PooledDbConn[D] =
   pool.conns.add(result)
 
 proc maintain[D: DbConnType](pool: DbConnPool[D]): void =
+  log().debug("Maintaining pool. $# connections." % [$pool.conns.len])
   pool.conns.keepIf(proc (pc: PooledDbConn[D]): bool =
     if not pc.free: return true
 
@@ -70,6 +78,9 @@ proc maintain[D: DbConnType](pool: DbConnPool[D]): void =
       except: discard ""
       return false
   )
+  log().debug(
+    "Pruned dead connections. $# connections remaining." %
+    [$pool.conns.len])
 
   let freeConns = pool.conns.filterIt(it.free)
   if pool.conns.len > pool.cfg.poolSize and freeConns.len > 0:
@@ -81,6 +92,9 @@ proc maintain[D: DbConnType](pool: DbConnPool[D]): void =
       for culled in toCull:
         try: culled.conn.close()
         except: discard ""
+      log().debug(
+        "Trimming pool size. Culled $# free connections. $# connections remaining." %
+        [$toCull.len, $pool.conns.len])
 
 proc take*[D: DbConnType](pool: DbConnPool[D]): tuple[id: int, conn: D] =
   ## Request a connection from the pool. Returns a DbConn if the pool has free
@@ -93,22 +107,29 @@ proc take*[D: DbConnType](pool: DbConnPool[D]): tuple[id: int, conn: D] =
   pool.maintain
   let freeConns = pool.conns.filterIt(it.free)
 
+  log().debug(
+    "Providing a new connection ($# currently free)." % [$freeConns.len])
+
   let reserved =
     if freeConns.len > 0: freeConns[0]
     else: pool.newConn()
 
   reserved.free = false
+  log().debug("Reserve connection $#" % [$reserved.id])
   return (id: reserved.id, conn: reserved.conn)
 
 proc release*[D: DbConnType](pool: DbConnPool[D], connId: int): void =
   ## Release a connection back to the pool.
+  log().debug("Reclaiming released connaction $#" % [$connId])
   let foundConn = pool.conns.filterIt(it.id == connId)
   if foundConn.len > 0: foundConn[0].free = true
 
-template withConnection*[D: DbConnType](pool: DbConnPool[D], conn, stmt: untyped): untyped =
+template withConn*[D: DbConnType](pool: DbConnPool[D], stmt: untyped): untyped =
   ## Convenience template to provide a connection from the pool for use in a
   ## statement block, automatically releasing that connnection when done.
-  block:
+  ##
-    let (connId, conn) = take(pool)
+  ## The provided connection is injected as the variable `conn` in the
+  ## statement body.
+  let (connId, conn {.inject.}) = take(pool)
   try: stmt
   finally: release(pool, connId)

src/fiber_orm/util.nim

@@ -9,11 +9,6 @@ import uuids
 import std/nre except toSeq
 
 type
-  PaginationParams* = object
-    pageSize*: int
-    offset*: int
-    orderBy*: Option[seq[string]]
-
   MutateClauses* = object
     ## Data structure to hold information about the clauses that should be
     ## added to a query. How these clauses are used will depend on the query.
@@ -27,11 +22,9 @@ const ISO_8601_FORMATS = @[
   "yyyy-MM-dd'T'HH:mm:ssz",
   "yyyy-MM-dd'T'HH:mm:sszzz",
   "yyyy-MM-dd'T'HH:mm:ss'.'fffzzz",
-  "yyyy-MM-dd'T'HH:mm:ss'.'ffffzzz",
   "yyyy-MM-dd HH:mm:ssz",
   "yyyy-MM-dd HH:mm:sszzz",
-  "yyyy-MM-dd HH:mm:ss'.'fffzzz",
+  "yyyy-MM-dd HH:mm:ss'.'fffzzz"
-  "yyyy-MM-dd HH:mm:ss'.'ffffzzz"
 ]
 
 proc parseIso8601(val: string): DateTime =
@@ -133,20 +126,18 @@ proc parsePGDatetime*(val: string): DateTime =
 
   var correctedVal = val;
 
-  # The Nim `times#format` function only recognizes 3-digit millisecond values
+  # PostgreSQL will truncate any trailing 0's in the millisecond value leading
-  # but PostgreSQL will sometimes send 1-2 digits, truncating any trailing 0's,
+  # to values like `2020-01-01 16:42.3+00`. This cannot currently be parsed by
-  # or sometimes provide more than three digits of preceision in the millisecond value leading
+  # the standard times format as it expects exactly three digits for
-  # to values like `2020-01-01 16:42.3+00` or `2025-01-06 00:56:00.9007+00`.
+  # millisecond values. So we have to detect this and pad out the millisecond
-  # This cannot currently be parsed by the standard times format as it expects
+  # value to 3 digits.
-  # exactly three digits for millisecond values. So we have to detect this and
+  let PG_PARTIAL_FORMAT_REGEX = re"(\d{4}-\d{2}-\d{2}( |'T')\d{2}:\d{2}:\d{2}\.)(\d{1,2})(\S+)?"
-  # coerce the millisecond value to exactly 3 digits.
-  let PG_PARTIAL_FORMAT_REGEX = re"(\d{4}-\d{2}-\d{2}( |'T')\d{2}:\d{2}:\d{2}\.)(\d+)(\S+)?"
   let match = val.match(PG_PARTIAL_FORMAT_REGEX)
 
   if match.isSome:
     let c = match.get.captures
-    if c.toSeq.len == 2: correctedVal = c[0] & alignLeft(c[2], 3, '0')[0..2]
+    if c.toSeq.len == 2: correctedVal = c[0] & alignLeft(c[2], 3, '0')
-    else: correctedVal = c[0] & alignLeft(c[2], 3, '0')[0..2] & c[3]
+    else: correctedVal = c[0] & alignLeft(c[2], 3, '0') & c[3]
 
   var errStr = ""
 
@@ -155,7 +146,7 @@ proc parsePGDatetime*(val: string): DateTime =
     try: return correctedVal.parse(df)
     except: errStr &= "\n\t" & getCurrentExceptionMsg()
 
-  raise newException(ValueError, "Cannot parse PG date '" & correctedVal & "'. Tried:" & errStr)
+  raise newException(ValueError, "Cannot parse PG date. Tried:" & errStr)
 
 proc parseDbArray*(val: string): seq[string] =
   ## Parse a Postgres array column into a Nim seq[string]
@@ -456,19 +447,6 @@ macro populateMutateClauses*(t: typed, newRecord: bool, mc: var MutateClauses):
           `mc`.placeholders.add("?")
           `mc`.values.add(dbFormat(`t`.`fieldIdent`))
 
-
-proc getPagingClause*(page: PaginationParams): string =
-  ## Given a `PaginationParams` object, return the SQL clause necessary to
-  ## limit the number of records returned by a query.
-  result = ""
-  if page.orderBy.isSome:
-    let orderByClause = page.orderBy.get.map(identNameToDb).join(",")
-    result &= " ORDER BY " & orderByClause
-  else:
-    result &= " ORDER BY id"
-
-  result &= " LIMIT " & $page.pageSize & " OFFSET " & $page.offset
-
 ## .. _model class: ../fiber_orm.html#objectminusrelational-modeling-model-class
 ## .. _rules for name mapping: ../fiber_orm.html
 ## .. _table name: ../fiber_orm.html