From 66cbb88bdc5399b28e135565ce90985b1d7b25e6 Mon Sep 17 00:00:00 2001 From: Logan Kilpatrick <23kilpatrick23@gmail.com> Date: Fri, 28 Jan 2022 07:44:43 -0800 Subject: [PATCH 1/2] Update index.md --- docs/src/index.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/src/index.md b/docs/src/index.md index 901c2e3d..67ec5a8f 100644 --- a/docs/src/index.md +++ b/docs/src/index.md @@ -5,7 +5,23 @@ [![Build Status](https://travis-ci.com/invenia/LibPQ.jl.svg?branch=master)](https://travis-ci.com/invenia/LibPQ.jl) [![CodeCov](https://codecov.io/gh/invenia/LibPQ.jl/branch/master/graph/badge.svg)](https://codecov.io/gh/invenia/LibPQ.jl) +## Overview + +LibPQ.jl is a Julia wrapper for the PostgreSQL libpq C library. It provides the ability to: +- Automatically install libpq via BinaryProvider for MacOS, GNU Linux, and Windows +- Connect via DSN +- Create and execute queries with or without parameters +- Create and execute prepared statements with or without parameters + +and much more! + +You can install `LibPQ.jl` via the Julia REPL by typing: +```julia +] add LibPQ +``` + ## Examples +The below examples assume you already have a database created. If you don't have one setup yet, you will need to do so for the following snippets to work. ### Selection From c5204c64736e0317ca24c3b07093ce6886ac6121 Mon Sep 17 00:00:00 2001 From: Logan Kilpatrick <23kilpatrick23@gmail.com> Date: Mon, 31 Jan 2022 07:01:11 -0800 Subject: [PATCH 2/2] Update index.md --- docs/src/index.md | 19 ++++++++++++++----- 1 file changed, 14 insertions(+), 5 deletions(-) diff --git a/docs/src/index.md b/docs/src/index.md index 67ec5a8f..1f3b3e51 100644 --- a/docs/src/index.md +++ b/docs/src/index.md @@ -8,12 +8,21 @@ ## Overview LibPQ.jl is a Julia wrapper for the PostgreSQL libpq C library. It provides the ability to: -- Automatically install libpq via BinaryProvider for MacOS, GNU Linux, and Windows -- Connect via DSN -- Create and execute queries with or without parameters -- Create and execute prepared statements with or without parameters -and much more! +* Build + * Installs `libpq` via `BinaryBuilder.jl` for MacOS, GNU Linux, and Windows +* Connections + * Connect via DSN + * Connect via PostgreSQL connection string + * UTF-8 client encoding +* Queries + * Create and execute queries with or without parameters + * Execute queries asynchronously + * Stream results using [Tables](https://github.com/JuliaData/Tables.jl) + * Configurably convert a variety of PostgreSQL types to corresponding Julia types (see the **Type Conversions** section of the docs) +* Prepared Statements + * Create and execute prepared statements with or without parameters + * Stream table of parameters to execute the same statement multiple times with different data You can install `LibPQ.jl` via the Julia REPL by typing: ```julia