Allow version to be given on database start, closes #138

Author: josevalim

lib/adbc.ex

@@ -141,7 +141,12 @@ defmodule Adbc do
         url: "https://github.com/duckdb/duckdb/releases/download/v1.3.0/libduckdb-osx-universal.zip"
       )
 
-  You can also pass download options when configuring the `:adbc`:
+  And then start the driver passing the version option:
+
+      {Adbc.Database, driver: :duckdb, version: "1.3.0"}
+
+  Note you can also configure the `:adbc` application to download
+  a custom driver during compilation too:
 
       config :adbc, :drivers,
         [{:duckdb, version: ..., url: ...}]

lib/adbc_database.ex

@@ -41,6 +41,7 @@ defmodule Adbc.Database do
   """
   def start_link(opts \\ []) do
     {driver, opts} = Keyword.pop(opts, :driver, nil)
+    {driver_opts, opts} = Keyword.split(opts, [:version])
 
     unless driver do
       raise ArgumentError, ":driver option must be specified"
@@ -50,7 +51,7 @@ defmodule Adbc.Database do
     opts = Keyword.merge(driver_default_options(driver), opts)
 
     with {:ok, ref} <- Adbc.Nif.adbc_database_new(),
-         :ok <- init_driver(ref, driver),
+         :ok <- init_driver(ref, driver, driver_opts),
          :ok <- init_options(ref, opts),
          :ok <- Adbc.Nif.adbc_database_init(ref) do
       GenServer.start_link(__MODULE__, {driver, ref}, process_options)
@@ -153,8 +154,8 @@ defmodule Adbc.Database do
   @impl true
   def handle_info(_msg, state), do: {:noreply, state}
 
-  defp init_driver(ref, driver) do
-    case Adbc.Driver.so_path(driver) do
+  defp init_driver(ref, driver, driver_opts) do
+    case Adbc.Driver.so_path(driver, driver_opts) do
       {:ok, path} -> Adbc.Helper.option(ref, :adbc_database_set_option, [:string, "driver", path])
       {:error, reason} -> {:error, reason}
     end

lib/adbc_driver.ex

@@ -316,7 +316,7 @@ defmodule Adbc.Driver do
               {:ok, expected_filepath}
             else
               {:error,
-               "driver #{driver_name} is not available (see Adbc moduledocs to learn how to install a driver)"}
+               "driver #{driver_name} (version #{version}) is not available (see Adbc moduledocs to learn how to install a driver)"}
             end
 
           {:error, reason} ->