Better tracking of prepared statements & other enhancements (#223)

* DBHandle/StmtHandle aliases for Ptr{Cvoid}

* specify types for db and name params

* export SQLiteException

* check[dup]names(): throw SQLiteException

rather than error().
Also show the name of the duplicate column.

* bind!() relax type constraints

* execute/bind(): add params type annotations

using types defined in DBInterface in 2.3.0, so the required version
is updated

* bind! param checks: assert => SQLiteException

assert should be used only as internal logic checks

* bind!(): fix whitespace

* load!(): reduce code duplication

* load!(): escape column names upon insert

* load!(): cleanup getting existing table info

We don't need the special TableInfo structure, in particular if
the table does not exist. The current version
uses execute(f, db, sql) call to avoid leaving behind prepared
statements.

Fixes the table existence check (Query always returns NamesTuple).

* load!()/createtable!(): remove escaped name param

this is confusing and error-prone

* tables/indices/columns(): use execute(f, db, sql)

so that the statement is closed immediately upon completion

* support Bool Julia type (as SQLite INT)

* bind!/execute(): support kwargs for param passing

update the docstring and add (very) basic tests

* DBInterface.execute(): test kwargs for params

* track prepared statements in DB object

- fixes #211
- closes all prepared statements upon close!(db)
- adds SQLite3.finalize_statements!(db) call
- execute(db, sql): close the internal prepared statement immediately,
  don't wait for GC

* improve show(DB) test

* basic immediate execute test

* basic commit/rollback tests

* generalize sqlitetype()

so Union{T, Missing} is handled automatically.
This also fixes "BLOB NOT NULL" case.

* sqliteexception(): just the handle is enough

we don't need to create DB just to raise an exception

* sqliteprepare(): param type annotations

* add CI GitHub action

ci.yml taken from JSON3.jl

Author: alyst

.github/workflows/ci.yml

@@ -0,0 +1,67 @@
+name: CI
+on:
+  pull_request:
+    branches:
+      - master
+  push:
+    branches:
+      - master
+    tags: '*'
+jobs:
+  test:
+    name: Julia ${{ matrix.version }} - ${{ matrix.os }} - ${{ matrix.arch }} - ${{ github.event_name }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        version:
+          - '1.0'
+          - '1' # automatically expands to the latest stable 1.x release of Julia
+          - 'nightly'
+        os:
+          - ubuntu-latest
+        arch:
+          - x64
+        include:
+          - os: windows-latest
+            version: '1'
+            arch: x86
+    steps:
+      - uses: actions/checkout@v2
+      - uses: julia-actions/setup-julia@v1
+        with:
+          version: ${{ matrix.version }}
+          arch: ${{ matrix.arch }}
+      - uses: actions/cache@v1
+        env:
+          cache-name: cache-artifacts
+        with:
+          path: ~/.julia/artifacts
+          key: ${{ runner.os }}-test-${{ env.cache-name }}-${{ hashFiles('**/Project.toml') }}
+          restore-keys: |
+            ${{ runner.os }}-test-${{ env.cache-name }}-
+            ${{ runner.os }}-test-
+            ${{ runner.os }}-
+      - uses: julia-actions/julia-buildpkg@v1
+      - uses: julia-actions/julia-runtest@v1
+      - uses: julia-actions/julia-processcoverage@v1
+      - uses: codecov/codecov-action@v1
+        with:
+          file: lcov.info
+  docs:
+    name: Documentation
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: julia-actions/setup-julia@v1
+        with:
+          version: '1'
+      - run: |
+          julia --project=docs -e '
+            using Pkg
+            Pkg.develop(PackageSpec(path=pwd()))
+            Pkg.instantiate()'
+      - run: julia --project=docs docs/make.jl
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          DOCUMENTER_KEY: ${{ secrets.DOCUMENTER_KEY }}

Project.toml

@@ -17,7 +17,7 @@ WeakRefStrings = "ea10d353-3f73-51f8-a26c-33c1cb351aa5"
 
 [compat]
 BinaryProvider = "0.5"
-DBInterface = "2"
+DBInterface = "2.3"
 SQLite_jll = "3"
 Tables = "1"
 WeakRefStrings = "0.4,0.5,0.6"