shard-crystal-db/src/db/database.cr

module DB
  # Acts as an entry point for database access.
  # Currently it creates a single connection to the database.
  # Eventually a connection pool will be handled.
  #
  # It should be created from DB module. See `DB.open`.
  class Database
    getter driver_class
    getter connection_string

    def initialize(@driver_class, @connection_string)
      @driver = @driver_class.new(@connection_string)
      @connection = @driver.build_connection
    end

    # Closes all connection to the database
    def close
      @connection.close
    end

    # Returns a `Connection` to the database
    def connection
      @connection
    end

    # Prepares a `Statement`. The Statement must be closed explicitly
    # after is not longer in use.
    #
    # Usually `#exec`, `#query` or `#scalar` should be used.
    def prepare(query)
      connection.prepare(query)
    end

    include QueryMethods
  end
end