dpq2-serialization ~main

Dpq2 Row to D struct serializer


To use this package, run the following command in your project's root directory:

Manual usage
Put the following dependency into your project's dependences section:

Tiny library for dpq2 serialization

Install

dub add dpq2-serialization

Postgresql types and D types:

Postgres Type          D Type
boolean                bool
smallint               short
integer                int
bigint                 long
real                   float
double_precision       double
text                   string
numeric                string
bytea                  immutable(ubyte)[]
uuid                   UUID
date                   Date
time_without_time_zone TimeOfDay       // import std.datetime : TimeOfDay;
time_with_time_zone    TimeOfDayWithTZ // import dpq2.conv.time: TimeOfDayWithTZ;
timestamp              TimeStamp       // import dpq2.conv.time: TimeStamp;
timestamptz            TimeStampUTC    // import dpq2.conv.time: TimeStampUTC;
interval               Interval        // import dpq2.conv.time: Interval;
json                   Json            // import vibe.data.json: Json;
bson                   Bson            // import vibe.data.json: Bson;

Usage

Define the struct or class as required. For example, User

struct User
{
    ulong id;
    string name;
    string email;
    @pgColumn("email_verified") bool emailVerified;
}

After running the query, convert the result Row to respective type.

ulong userId = 1;
string query = "SELECT * FROM users WHERE id = $1";
QueryParams qps;
qps.sqlCommand = query;
qps.argsVariadic(userId);
auto rs = conn.execParams(qps);
auto user = rs[0].deserializeTo!User;

With Web frameworks

With Handy-Httpd

#!/usr/bin/env dub
/+ dub.sdl:
dependency "dpq2" version="~>1.1.7"
dependency "handy-httpd" version="~>8.4.0"
dependency "dpq2-serialization" version="~>0.1.0"
+/
import std.process;
import std.algorithm;
import std.range;

import handy_httpd;
import handy_httpd.handlers;
import vibe.data.json;
import dpq2;
import dpq2_serialization;

Connection conn;

// Create Db connection per worker thread
static this()
{
    conn = new Connection(environment["DATABASE_URL"]);
}

class User
{
    ulong id;
    string name;
    string email;
    @pgColumn("email_verified") bool emailVerified;
}

void listUsersHandler(ref HttpRequestContext ctx)
{
    string query = "SELECT * FROM users";
    QueryParams qps;
    qps.sqlCommand = query;
    auto rs = conn.execParams(qps);
    User[] users;
    foreach(idx; 0..rs.length)
        users ~= rs[idx].deserializeTo!User;

    ctx.response.writeBodyString(serializeToJsonString(users));
}

void main()
{
    auto pathHandler = new PathHandler()
        .addMapping(Method.GET, "/api/v1/users", &listUsersHandler);
    new HttpServer(pathHandler).start();
}

With Vibe.d

#!/usr/bin/env dub
/+ dub.sdl:
dependency "vibe-http" version="~>1.1.0"
dependency "dpq2" version="~>1.1.7"
dependency "dpq2-serialization" version="~>0.1.0"
+/
import std.range;
import std.process;

import vibe.http.server;
import vibe.http.router;
import vibe.core.core : runApplication;
import vibe.data.json;
import dpq2;
import dpq2_serialization;

Connection conn;

// Create connection per thread (Main thread)
// Vibe.d is single threaded.
static this()
{
    conn = new Connection(environment["DATABASE_URL"]);
}

class User
{
    ulong id;
    string name;
    string email;
    @pgColumn("email_verified") bool emailVerified;
}

void listUsersHandler(HTTPServerRequest req, HTTPServerResponse res)
{
    string query = "SELECT * FROM users";
    QueryParams qps;
    qps.sqlCommand = query;

    auto rs = conn.execParams(qps);
    User[] users;
    foreach(idx; 0..rs.length)
        users ~= rs[idx].deserializeTo!User;

    res.writeJsonBody(users);
}

void main()
{
    auto router = new URLRouter;
    router.get("/api/v1/users", &listUsersHandler);

    auto settings = new HTTPServerSettings;
	settings.port = 8080;
	listenHTTP(settings, router);
    runApplication;
}

With Serverino

#!/usr/bin/env dub
/+ dub.sdl:
dependency "serverino" version="~>0.7.9"
dependency "dpq2" version="~>1.1.7"
dependency "dpq2-serialization" version="~>0.1.0"
+/
import std.range;
import std.process;

import serverino;
import vibe.data.json;
import dpq2;
import dpq2_serialization;

class User
{
    ulong id;
    string name;
    string email;
    @pgColumn("email_verified") bool emailVerified;
}

Connection conn;

// Create Db connection per worker process
@onWorkerStart void start()
{
    conn = new Connection(environment["DATABASE_URL"]);
}

@endpoint @route!"/api/v1/users"
void listUsersHandler(Request req, Output res)
{
    string query = "SELECT * FROM users";
    QueryParams qps;
    qps.sqlCommand = query;
    auto rs = conn.execParams(qps);
    User[] users;
    foreach(idx; 0..rs.length)
        users ~= rs[idx].deserializeTo!User;
 
    res.write(serializeToJsonString(users));
}

mixin ServerinoMain;
Authors:
  • Aravinda VK <mail@aravindavk.in>
Dependencies:
dpq2
Versions:
0.2.1 2024-Jul-24
0.2.0 2024-Jul-17
0.1.1 2024-Jul-05
0.1.0 2024-Jul-05
~main 2024-Jul-24
Show all 5 versions
Download Stats:
  • 0 downloads today

  • 0 downloads this week

  • 0 downloads this month

  • 4 downloads total

Score:
0.3
Short URL:
dpq2-serialization.dub.pm