mirror of
https://gitea.invidious.io/iv-org/shard-crystal-db.git
synced 2024-08-15 00:53:32 +00:00
955 lines
35 KiB
HTML
955 lines
35 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8" />
|
|
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
<meta name="generator" content="Crystal Docs 1.5.1">
|
|
<meta name="crystal_docs.project_version" content="0.13.1">
|
|
<meta name="crystal_docs.project_name" content="db">
|
|
|
|
|
|
|
|
<link href="../css/style.css" rel="stylesheet" type="text/css" />
|
|
<script type="text/javascript" src="../js/doc.js"></script>
|
|
|
|
<meta name="repository-name" content="db">
|
|
<title>DB::DriverSpecs(DBAnyType) - db 0.13.1</title>
|
|
<script type="text/javascript">
|
|
CrystalDocs.base_path = "../";
|
|
</script>
|
|
</head>
|
|
<body>
|
|
|
|
<svg class="hidden">
|
|
<symbol id="octicon-link" viewBox="0 0 16 16">
|
|
<path fill="currentColor" fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path>
|
|
</symbol>
|
|
</svg>
|
|
<input type="checkbox" id="sidebar-btn">
|
|
<label for="sidebar-btn" id="sidebar-btn-label">
|
|
<svg class="open" xmlns="http://www.w3.org/2000/svg" height="2em" width="2em" viewBox="0 0 512 512"><title>Open Sidebar</title><path fill="currentColor" d="M80 96v64h352V96H80zm0 112v64h352v-64H80zm0 112v64h352v-64H80z"></path></svg>
|
|
<svg class="close" xmlns="http://www.w3.org/2000/svg" width="2em" height="2em" viewBox="0 0 512 512"><title>Close Sidebar</title><path fill="currentColor" d="m118.6 73.4-45.2 45.2L210.7 256 73.4 393.4l45.2 45.2L256 301.3l137.4 137.3 45.2-45.2L301.3 256l137.3-137.4-45.2-45.2L256 210.7Z"></path></svg>
|
|
</label>
|
|
<div class="sidebar">
|
|
<div class="sidebar-header">
|
|
<div class="search-box">
|
|
<input type="search" class="search-input" placeholder="Search..." spellcheck="false" aria-label="Search">
|
|
</div>
|
|
|
|
<div class="project-summary">
|
|
<h1 class="project-name">
|
|
<a href="../index.html">
|
|
db
|
|
</a>
|
|
</h1>
|
|
|
|
<span class="project-version">
|
|
0.13.1
|
|
</span>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="search-results hidden">
|
|
<ul class="search-list"></ul>
|
|
</div>
|
|
|
|
<div class="types-list">
|
|
<ul>
|
|
|
|
<li class="parent open current" data-id="db/DB" data-name="db">
|
|
<a href="../DB.html">DB</a>
|
|
|
|
<ul>
|
|
|
|
<li class=" " data-id="db/DB/Any" data-name="db::any">
|
|
<a href="../DB/Any.html">Any</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/BeginTransaction" data-name="db::begintransaction">
|
|
<a href="../DB/BeginTransaction.html">BeginTransaction</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/ColumnTypeMismatchError" data-name="db::columntypemismatcherror">
|
|
<a href="../DB/ColumnTypeMismatchError.html">ColumnTypeMismatchError</a>
|
|
|
|
</li>
|
|
|
|
<li class="parent " data-id="db/DB/Connection" data-name="db::connection">
|
|
<a href="../DB/Connection.html">Connection</a>
|
|
|
|
<ul>
|
|
|
|
<li class=" " data-id="db/DB/Connection/Options" data-name="db::connection::options">
|
|
<a href="../DB/Connection/Options.html">Options</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/ConnectionBuilder" data-name="db::connectionbuilder">
|
|
<a href="../DB/ConnectionBuilder.html">ConnectionBuilder</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/ConnectionContext" data-name="db::connectioncontext">
|
|
<a href="../DB/ConnectionContext.html">ConnectionContext</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/ConnectionLost" data-name="db::connectionlost">
|
|
<a href="../DB/ConnectionLost.html">ConnectionLost</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/ConnectionRefused" data-name="db::connectionrefused">
|
|
<a href="../DB/ConnectionRefused.html">ConnectionRefused</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/Database" data-name="db::database">
|
|
<a href="../DB/Database.html">Database</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/Disposable" data-name="db::disposable">
|
|
<a href="../DB/Disposable.html">Disposable</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/Driver" data-name="db::driver">
|
|
<a href="../DB/Driver.html">Driver</a>
|
|
|
|
</li>
|
|
|
|
<li class="parent open current" data-id="db/DB/DriverSpecs" data-name="db::driverspecs(dbanytype)">
|
|
<a href="../DB/DriverSpecs.html">DriverSpecs</a>
|
|
|
|
<ul>
|
|
|
|
<li class=" " data-id="db/DB/DriverSpecs/ColumnDef" data-name="db::driverspecs::columndef">
|
|
<a href="../DB/DriverSpecs/ColumnDef.html">ColumnDef</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/Error" data-name="db::error">
|
|
<a href="../DB/Error.html">Error</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/ExecResult" data-name="db::execresult">
|
|
<a href="../DB/ExecResult.html">ExecResult</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/Field" data-name="db::field">
|
|
<a href="../DB/Field.html">Field</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/Mappable" data-name="db::mappable">
|
|
<a href="../DB/Mappable.html">Mappable</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/MappingException" data-name="db::mappingexception">
|
|
<a href="../DB/MappingException.html">MappingException</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/MetadataValueConverter" data-name="db::metadatavalueconverter">
|
|
<a href="../DB/MetadataValueConverter.html">MetadataValueConverter</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/NoResultsError" data-name="db::noresultserror">
|
|
<a href="../DB/NoResultsError.html">NoResultsError</a>
|
|
|
|
</li>
|
|
|
|
<li class="parent " data-id="db/DB/Pool" data-name="db::pool(t)">
|
|
<a href="../DB/Pool.html">Pool</a>
|
|
|
|
<ul>
|
|
|
|
<li class=" " data-id="db/DB/Pool/Options" data-name="db::pool::options">
|
|
<a href="../DB/Pool/Options.html">Options</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/Pool/Stats" data-name="db::pool::stats">
|
|
<a href="../DB/Pool/Stats.html">Stats</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/PoolPreparedStatement" data-name="db::poolpreparedstatement">
|
|
<a href="../DB/PoolPreparedStatement.html">PoolPreparedStatement</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/PoolResourceLost" data-name="db::poolresourcelost(t)">
|
|
<a href="../DB/PoolResourceLost.html">PoolResourceLost</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/PoolResourceRefused" data-name="db::poolresourcerefused">
|
|
<a href="../DB/PoolResourceRefused.html">PoolResourceRefused</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/PoolRetryAttemptsExceeded" data-name="db::poolretryattemptsexceeded">
|
|
<a href="../DB/PoolRetryAttemptsExceeded.html">PoolRetryAttemptsExceeded</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/PoolStatement" data-name="db::poolstatement">
|
|
<a href="../DB/PoolStatement.html">PoolStatement</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/PoolTimeout" data-name="db::pooltimeout">
|
|
<a href="../DB/PoolTimeout.html">PoolTimeout</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/PoolUnpreparedStatement" data-name="db::poolunpreparedstatement">
|
|
<a href="../DB/PoolUnpreparedStatement.html">PoolUnpreparedStatement</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/QueryMethods" data-name="db::querymethods(stmt)">
|
|
<a href="../DB/QueryMethods.html">QueryMethods</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/ResultSet" data-name="db::resultset">
|
|
<a href="../DB/ResultSet.html">ResultSet</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/Rollback" data-name="db::rollback">
|
|
<a href="../DB/Rollback.html">Rollback</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/SavePointTransaction" data-name="db::savepointtransaction">
|
|
<a href="../DB/SavePointTransaction.html">SavePointTransaction</a>
|
|
|
|
</li>
|
|
|
|
<li class="parent " data-id="db/DB/Serializable" data-name="db::serializable">
|
|
<a href="../DB/Serializable.html">Serializable</a>
|
|
|
|
<ul>
|
|
|
|
<li class=" " data-id="db/DB/Serializable/NonStrict" data-name="db::serializable::nonstrict">
|
|
<a href="../DB/Serializable/NonStrict.html">NonStrict</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
|
|
</li>
|
|
|
|
<li class="parent " data-id="db/DB/SessionMethods" data-name="db::sessionmethods(session, stmt)">
|
|
<a href="../DB/SessionMethods.html">SessionMethods</a>
|
|
|
|
<ul>
|
|
|
|
<li class=" " data-id="db/DB/SessionMethods/PreparedQuery" data-name="db::sessionmethods::preparedquery(session, stmt)">
|
|
<a href="../DB/SessionMethods/PreparedQuery.html">PreparedQuery</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/SessionMethods/UnpreparedQuery" data-name="db::sessionmethods::unpreparedquery(session, stmt)">
|
|
<a href="../DB/SessionMethods/UnpreparedQuery.html">UnpreparedQuery</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/Statement" data-name="db::statement">
|
|
<a href="../DB/Statement.html">Statement</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/StatementMethods" data-name="db::statementmethods">
|
|
<a href="../DB/StatementMethods.html">StatementMethods</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/StringKeyCache" data-name="db::stringkeycache(t)">
|
|
<a href="../DB/StringKeyCache.html">StringKeyCache</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/TopLevelTransaction" data-name="db::topleveltransaction">
|
|
<a href="../DB/TopLevelTransaction.html">TopLevelTransaction</a>
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/DB/Transaction" data-name="db::transaction">
|
|
<a href="../DB/Transaction.html">Transaction</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
|
|
</li>
|
|
|
|
<li class=" " data-id="db/Enum" data-name="enum">
|
|
<a href="../Enum.html">Enum</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
|
|
<div class="main-content">
|
|
<h1 class="type-name">
|
|
|
|
<span class="kind">class</span> DB::<wbr>DriverSpecs(DBAnyType)
|
|
|
|
</h1>
|
|
|
|
|
|
<ul class="superclass-hierarchy"><li class="superclass"><a href="../DB/DriverSpecs.html">DB::DriverSpecs(DBAnyType)</a></li><li class="superclass">Reference</li><li class="superclass">Object</li></ul>
|
|
|
|
|
|
|
|
|
|
<h2>
|
|
<a id="overview" class="anchor" href="#overview">
|
|
<svg class="octicon-link" aria-hidden="true">
|
|
<use href="#octicon-link"/>
|
|
</svg>
|
|
</a>
|
|
Overview
|
|
</h2>
|
|
|
|
<p>Helper class to ensure behaviour of custom drivers</p>
|
|
<pre><code class="language-crystal"><span class="k">require</span> <span class="s">"db/spec"</span>
|
|
|
|
<span class="t">DB</span><span class="t">::</span><span class="t">DriverSpecs</span>(<span class="t">DB</span><span class="t">::</span><span class="t">Any</span>).run <span class="k">do</span>
|
|
<span class="c"># How to connect to database</span>
|
|
connection_string <span class="s">"scheme://database_url"</span>
|
|
|
|
<span class="c"># Clean up database if needed using before/after callbacks</span>
|
|
before <span class="k">do</span>
|
|
<span class="c"># ...</span>
|
|
<span class="k">end</span>
|
|
|
|
after <span class="k">do</span>
|
|
<span class="c"># ...</span>
|
|
<span class="k">end</span>
|
|
|
|
<span class="c"># Sample values that will be stored, retrieved across many specs</span>
|
|
sample_value <span class="s">"hello"</span>, <span class="s">"varchar(25)"</span>, <span class="s">"'hello'"</span>
|
|
|
|
it <span class="s">"custom spec with a db initialized"</span> <span class="k">do</span> <span class="o">|</span>db<span class="o">|</span>
|
|
<span class="c"># assert something using *db*</span>
|
|
<span class="k">end</span>
|
|
|
|
<span class="c"># Configure the appropiate syntax for different commands needed to run the specs</span>
|
|
binding_syntax <span class="k">do</span> <span class="o">|</span>index<span class="o">|</span>
|
|
<span class="s">"?"</span>
|
|
<span class="k">end</span>
|
|
|
|
create_table_1column_syntax <span class="k">do</span> <span class="o">|</span>table_name, col1<span class="o">|</span>
|
|
<span class="s">"create table </span><span class="i">#{</span>table_name<span class="i">}</span><span class="s"> (</span><span class="i">#{</span>col1.name<span class="i">}</span><span class="s"> </span><span class="i">#{</span>col1.sql_type<span class="i">}</span><span class="s"> </span><span class="i">#{</span>col1.null ? <span class="s">"NULL"</span> : <span class="s">"NOT NULL"</span><span class="i">}</span><span class="s">)"</span>
|
|
<span class="k">end</span>
|
|
<span class="k">end</span></code></pre>
|
|
<p>The following methods needs to be called to configure the appropiate syntax
|
|
for different commands and allow all the specs to run: <code><a href="../DB/DriverSpecs.html#binding_syntax%28%26binding_syntax%3AProc%28Int32%2CString%29%29-instance-method">#binding_syntax</a></code>, <code><a href="../DB/DriverSpecs.html#create_table_1column_syntax%28%26create_table_1column_syntax%3AProc%28String%2CColumnDef%2CString%29%29-instance-method">#create_table_1column_syntax</a></code>,
|
|
<code><a href="../DB/DriverSpecs.html#create_table_2columns_syntax%28%26create_table_2columns_syntax%3AProc%28String%2CColumnDef%2CColumnDef%2CString%29%29-instance-method">#create_table_2columns_syntax</a></code>, <code><a href="../DB/DriverSpecs.html#select_1column_syntax%28%26select_1column_syntax%3AProc%28String%2CColumnDef%2CString%29%29-instance-method">#select_1column_syntax</a></code>, <code><a href="../DB/DriverSpecs.html#select_2columns_syntax%28%26select_2columns_syntax%3AProc%28String%2CColumnDef%2CColumnDef%2CString%29%29-instance-method">#select_2columns_syntax</a></code>, <code><a href="../DB/DriverSpecs.html#select_count_syntax%28%26select_count_syntax%3AProc%28String%2CString%29%29-instance-method">#select_count_syntax</a></code>,
|
|
<code><a href="../DB/DriverSpecs.html#select_scalar_syntax%28%26select_scalar_syntax%3AProc%28String%2CString%7CNil%2CString%29%29-instance-method">#select_scalar_syntax</a></code>, <code><a href="../DB/DriverSpecs.html#insert_1column_syntax%28%26insert_1column_syntax%3AProc%28String%2CColumnDef%2CString%2CString%29%29-instance-method">#insert_1column_syntax</a></code>, <code><a href="../DB/DriverSpecs.html#insert_2columns_syntax%28%26insert_2columns_syntax%3AProc%28String%2CColumnDef%2CString%2CColumnDef%2CString%2CString%29%29-instance-method">#insert_2columns_syntax</a></code>, <code><a href="../DB/DriverSpecs.html#drop_table_if_exists_syntax%28%26drop_table_if_exists_syntax%3AProc%28String%2CString%29%29-instance-method">#drop_table_if_exists_syntax</a></code>.</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<h2>
|
|
<a id="defined-in" class="anchor" href="#defined-in">
|
|
<svg class="octicon-link" aria-hidden="true">
|
|
<use href="#octicon-link"/>
|
|
</svg>
|
|
</a>
|
|
Defined in:
|
|
</h2>
|
|
|
|
|
|
<a href="https://github.com/crystal-lang/crystal-db/blob/v0.13.1/src/spec.cr#L51" target="_blank">
|
|
spec.cr
|
|
</a>
|
|
|
|
<br/>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<h2>
|
|
<a id="class-method-summary" class="anchor" href="#class-method-summary">
|
|
<svg class="octicon-link" aria-hidden="true">
|
|
<use href="#octicon-link"/>
|
|
</svg>
|
|
</a>
|
|
Class Method Summary
|
|
</h2>
|
|
<ul class="list-summary">
|
|
|
|
<li class="entry-summary">
|
|
<a href="#run%28description%3D%22asadb%22%2C%26%29-class-method" class="signature"><strong>.run</strong>(description = <span class="s">"as a db"</span>, &)</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
<h2>
|
|
<a id="instance-method-summary" class="anchor" href="#instance-method-summary">
|
|
<svg class="octicon-link" aria-hidden="true">
|
|
<use href="#octicon-link"/>
|
|
</svg>
|
|
</a>
|
|
Instance Method Summary
|
|
</h2>
|
|
<ul class="list-summary">
|
|
|
|
<li class="entry-summary">
|
|
<a href="#after%28%26after%3A-%3ENil%29-instance-method" class="signature"><strong>#after</strong>(&after : -> Nil)</a>
|
|
|
|
</li>
|
|
|
|
<li class="entry-summary">
|
|
<a href="#before%28%26before%3A-%3ENil%29-instance-method" class="signature"><strong>#before</strong>(&before : -> Nil)</a>
|
|
|
|
</li>
|
|
|
|
<li class="entry-summary">
|
|
<a href="#binding_syntax%28%26binding_syntax%3AProc%28Int32%2CString%29%29-instance-method" class="signature"><strong>#binding_syntax</strong>(&binding_syntax : Proc(Int32, String))</a>
|
|
|
|
</li>
|
|
|
|
<li class="entry-summary">
|
|
<a href="#connection_string%28connection_string%3AString%29-instance-method" class="signature"><strong>#connection_string</strong>(connection_string : String)</a>
|
|
|
|
</li>
|
|
|
|
<li class="entry-summary">
|
|
<a href="#create_table_1column_syntax%28%26create_table_1column_syntax%3AProc%28String%2CColumnDef%2CString%29%29-instance-method" class="signature"><strong>#create_table_1column_syntax</strong>(&create_table_1column_syntax : Proc(String, ColumnDef, String))</a>
|
|
|
|
</li>
|
|
|
|
<li class="entry-summary">
|
|
<a href="#create_table_2columns_syntax%28%26create_table_2columns_syntax%3AProc%28String%2CColumnDef%2CColumnDef%2CString%29%29-instance-method" class="signature"><strong>#create_table_2columns_syntax</strong>(&create_table_2columns_syntax : Proc(String, ColumnDef, ColumnDef, String))</a>
|
|
|
|
</li>
|
|
|
|
<li class="entry-summary">
|
|
<a href="#drop_table_if_exists_syntax%28%26drop_table_if_exists_syntax%3AProc%28String%2CString%29%29-instance-method" class="signature"><strong>#drop_table_if_exists_syntax</strong>(&drop_table_if_exists_syntax : Proc(String, String))</a>
|
|
|
|
</li>
|
|
|
|
<li class="entry-summary">
|
|
<a href="#encode_null%28encode_null%3AString%29-instance-method" class="signature"><strong>#encode_null</strong>(encode_null : String)</a>
|
|
|
|
</li>
|
|
|
|
<li class="entry-summary">
|
|
<a href="#insert_1column_syntax%28%26insert_1column_syntax%3AProc%28String%2CColumnDef%2CString%2CString%29%29-instance-method" class="signature"><strong>#insert_1column_syntax</strong>(&insert_1column_syntax : Proc(String, ColumnDef, String, String))</a>
|
|
|
|
</li>
|
|
|
|
<li class="entry-summary">
|
|
<a href="#insert_2columns_syntax%28%26insert_2columns_syntax%3AProc%28String%2CColumnDef%2CString%2CColumnDef%2CString%2CString%29%29-instance-method" class="signature"><strong>#insert_2columns_syntax</strong>(&insert_2columns_syntax : Proc(String, ColumnDef, String, ColumnDef, String, String))</a>
|
|
|
|
</li>
|
|
|
|
<li class="entry-summary">
|
|
<a href="#it%28description%3D%22assert%22%2Cprepared%3D%3Adefault%2Cfile%3D__FILE__%2Cline%3D__LINE__%2Cend_line%3D__END_LINE__%2C%26block%3ADB%3A%3ADatabase-%3E%29-instance-method" class="signature"><strong>#it</strong>(description = <span class="s">"assert"</span>, prepared = <span class="n">:default</span>, file = __FILE__, line = __LINE__, end_line = __END_LINE__, &block : DB::Database -> )</a>
|
|
|
|
</li>
|
|
|
|
<li class="entry-summary">
|
|
<a href="#its-instance-method" class="signature"><strong>#its</strong></a>
|
|
|
|
</li>
|
|
|
|
<li class="entry-summary">
|
|
<a href="#sample_value%28value%2Csql_type%2Cvalue_encoded%2C%2A%2Ctype_safe_value%3Dtrue%29-instance-method" class="signature"><strong>#sample_value</strong>(value, sql_type, value_encoded, *, type_safe_value = <span class="n">true</span>)</a>
|
|
|
|
<div class="summary"><p>Use <em>value</em> as sample value that should be stored in columns of type <em>sql_type</em>.</p></div>
|
|
|
|
</li>
|
|
|
|
<li class="entry-summary">
|
|
<a href="#select_1column_syntax%28%26select_1column_syntax%3AProc%28String%2CColumnDef%2CString%29%29-instance-method" class="signature"><strong>#select_1column_syntax</strong>(&select_1column_syntax : Proc(String, ColumnDef, String))</a>
|
|
|
|
</li>
|
|
|
|
<li class="entry-summary">
|
|
<a href="#select_2columns_syntax%28%26select_2columns_syntax%3AProc%28String%2CColumnDef%2CColumnDef%2CString%29%29-instance-method" class="signature"><strong>#select_2columns_syntax</strong>(&select_2columns_syntax : Proc(String, ColumnDef, ColumnDef, String))</a>
|
|
|
|
</li>
|
|
|
|
<li class="entry-summary">
|
|
<a href="#select_count_syntax%28%26select_count_syntax%3AProc%28String%2CString%29%29-instance-method" class="signature"><strong>#select_count_syntax</strong>(&select_count_syntax : Proc(String, String))</a>
|
|
|
|
</li>
|
|
|
|
<li class="entry-summary">
|
|
<a href="#select_scalar_syntax%28%26select_scalar_syntax%3AProc%28String%2CString%7CNil%2CString%29%29-instance-method" class="signature"><strong>#select_scalar_syntax</strong>(&select_scalar_syntax : Proc(String, String | Nil, String))</a>
|
|
|
|
</li>
|
|
|
|
<li class="entry-summary">
|
|
<a href="#support_prepared%28support_prepared%3ABool%29-instance-method" class="signature"><strong>#support_prepared</strong>(support_prepared : Bool)</a>
|
|
|
|
<div class="summary"><p>Allow specs that uses prepared statements (default <code>true</code>)</p></div>
|
|
|
|
</li>
|
|
|
|
<li class="entry-summary">
|
|
<a href="#support_unprepared%28support_unprepared%3ABool%29-instance-method" class="signature"><strong>#support_unprepared</strong>(support_unprepared : Bool)</a>
|
|
|
|
<div class="summary"><p>Allow specs that uses unprepared statements (default <code>true</code>)</p></div>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
|
|
<div class="methods-inherited">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<h2>
|
|
<a id="class-method-detail" class="anchor" href="#class-method-detail">
|
|
<svg class="octicon-link" aria-hidden="true">
|
|
<use href="#octicon-link"/>
|
|
</svg>
|
|
</a>
|
|
Class Method Detail
|
|
</h2>
|
|
|
|
<div class="entry-detail" id="run(description="asadb",&)-class-method">
|
|
<div class="signature">
|
|
|
|
def self.<strong>run</strong>(description = <span class="s">"as a db"</span>, &)
|
|
|
|
<a class="method-permalink" href="#run%28description%3D%22asadb%22%2C%26%29-class-method">#</a>
|
|
</div>
|
|
|
|
<br/>
|
|
<div>
|
|
|
|
[<a href="https://github.com/crystal-lang/crystal-db/blob/v0.13.1/src/spec.cr#L537" target="_blank">View source</a>]
|
|
|
|
</div>
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<h2>
|
|
<a id="instance-method-detail" class="anchor" href="#instance-method-detail">
|
|
<svg class="octicon-link" aria-hidden="true">
|
|
<use href="#octicon-link"/>
|
|
</svg>
|
|
</a>
|
|
Instance Method Detail
|
|
</h2>
|
|
|
|
<div class="entry-detail" id="after(&after:->Nil)-instance-method">
|
|
<div class="signature">
|
|
|
|
def <strong>after</strong>(&after : -> Nil)
|
|
|
|
<a class="method-permalink" href="#after%28%26after%3A-%3ENil%29-instance-method">#</a>
|
|
</div>
|
|
|
|
<br/>
|
|
<div>
|
|
|
|
[<a href="https://github.com/crystal-lang/crystal-db/blob/v0.13.1/src/spec.cr#L63" target="_blank">View source</a>]
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<div class="entry-detail" id="before(&before:->Nil)-instance-method">
|
|
<div class="signature">
|
|
|
|
def <strong>before</strong>(&before : -> Nil)
|
|
|
|
<a class="method-permalink" href="#before%28%26before%3A-%3ENil%29-instance-method">#</a>
|
|
</div>
|
|
|
|
<br/>
|
|
<div>
|
|
|
|
[<a href="https://github.com/crystal-lang/crystal-db/blob/v0.13.1/src/spec.cr#L60" target="_blank">View source</a>]
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<div class="entry-detail" id="binding_syntax(&binding_syntax:Proc(Int32,String))-instance-method">
|
|
<div class="signature">
|
|
|
|
def <strong>binding_syntax</strong>(&binding_syntax : Proc(Int32, String))
|
|
|
|
<a class="method-permalink" href="#binding_syntax%28%26binding_syntax%3AProc%28Int32%2CString%29%29-instance-method">#</a>
|
|
</div>
|
|
|
|
<br/>
|
|
<div>
|
|
|
|
[<a href="https://github.com/crystal-lang/crystal-db/blob/v0.13.1/src/spec.cr#L110" target="_blank">View source</a>]
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<div class="entry-detail" id="connection_string(connection_string:String)-instance-method">
|
|
<div class="signature">
|
|
|
|
def <strong>connection_string</strong>(connection_string : String)
|
|
|
|
<a class="method-permalink" href="#connection_string%28connection_string%3AString%29-instance-method">#</a>
|
|
</div>
|
|
|
|
<br/>
|
|
<div>
|
|
|
|
[<a href="https://github.com/crystal-lang/crystal-db/blob/v0.13.1/src/spec.cr#L109" target="_blank">View source</a>]
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<div class="entry-detail" id="create_table_1column_syntax(&create_table_1column_syntax:Proc(String,ColumnDef,String))-instance-method">
|
|
<div class="signature">
|
|
|
|
def <strong>create_table_1column_syntax</strong>(&create_table_1column_syntax : Proc(String, <a href="../DB/DriverSpecs/ColumnDef.html">ColumnDef</a>, String))
|
|
|
|
<a class="method-permalink" href="#create_table_1column_syntax%28%26create_table_1column_syntax%3AProc%28String%2CColumnDef%2CString%29%29-instance-method">#</a>
|
|
</div>
|
|
|
|
<br/>
|
|
<div>
|
|
|
|
[<a href="https://github.com/crystal-lang/crystal-db/blob/v0.13.1/src/spec.cr#L112" target="_blank">View source</a>]
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<div class="entry-detail" id="create_table_2columns_syntax(&create_table_2columns_syntax:Proc(String,ColumnDef,ColumnDef,String))-instance-method">
|
|
<div class="signature">
|
|
|
|
def <strong>create_table_2columns_syntax</strong>(&create_table_2columns_syntax : Proc(String, <a href="../DB/DriverSpecs/ColumnDef.html">ColumnDef</a>, <a href="../DB/DriverSpecs/ColumnDef.html">ColumnDef</a>, String))
|
|
|
|
<a class="method-permalink" href="#create_table_2columns_syntax%28%26create_table_2columns_syntax%3AProc%28String%2CColumnDef%2CColumnDef%2CString%29%29-instance-method">#</a>
|
|
</div>
|
|
|
|
<br/>
|
|
<div>
|
|
|
|
[<a href="https://github.com/crystal-lang/crystal-db/blob/v0.13.1/src/spec.cr#L113" target="_blank">View source</a>]
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<div class="entry-detail" id="drop_table_if_exists_syntax(&drop_table_if_exists_syntax:Proc(String,String))-instance-method">
|
|
<div class="signature">
|
|
|
|
def <strong>drop_table_if_exists_syntax</strong>(&drop_table_if_exists_syntax : Proc(String, String))
|
|
|
|
<a class="method-permalink" href="#drop_table_if_exists_syntax%28%26drop_table_if_exists_syntax%3AProc%28String%2CString%29%29-instance-method">#</a>
|
|
</div>
|
|
|
|
<br/>
|
|
<div>
|
|
|
|
[<a href="https://github.com/crystal-lang/crystal-db/blob/v0.13.1/src/spec.cr#L119" target="_blank">View source</a>]
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<div class="entry-detail" id="encode_null(encode_null:String)-instance-method">
|
|
<div class="signature">
|
|
|
|
def <strong>encode_null</strong>(encode_null : String)
|
|
|
|
<a class="method-permalink" href="#encode_null%28encode_null%3AString%29-instance-method">#</a>
|
|
</div>
|
|
|
|
<br/>
|
|
<div>
|
|
|
|
[<a href="https://github.com/crystal-lang/crystal-db/blob/v0.13.1/src/spec.cr#L66" target="_blank">View source</a>]
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<div class="entry-detail" id="insert_1column_syntax(&insert_1column_syntax:Proc(String,ColumnDef,String,String))-instance-method">
|
|
<div class="signature">
|
|
|
|
def <strong>insert_1column_syntax</strong>(&insert_1column_syntax : Proc(String, <a href="../DB/DriverSpecs/ColumnDef.html">ColumnDef</a>, String, String))
|
|
|
|
<a class="method-permalink" href="#insert_1column_syntax%28%26insert_1column_syntax%3AProc%28String%2CColumnDef%2CString%2CString%29%29-instance-method">#</a>
|
|
</div>
|
|
|
|
<br/>
|
|
<div>
|
|
|
|
[<a href="https://github.com/crystal-lang/crystal-db/blob/v0.13.1/src/spec.cr#L114" target="_blank">View source</a>]
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<div class="entry-detail" id="insert_2columns_syntax(&insert_2columns_syntax:Proc(String,ColumnDef,String,ColumnDef,String,String))-instance-method">
|
|
<div class="signature">
|
|
|
|
def <strong>insert_2columns_syntax</strong>(&insert_2columns_syntax : Proc(String, <a href="../DB/DriverSpecs/ColumnDef.html">ColumnDef</a>, String, <a href="../DB/DriverSpecs/ColumnDef.html">ColumnDef</a>, String, String))
|
|
|
|
<a class="method-permalink" href="#insert_2columns_syntax%28%26insert_2columns_syntax%3AProc%28String%2CColumnDef%2CString%2CColumnDef%2CString%2CString%29%29-instance-method">#</a>
|
|
</div>
|
|
|
|
<br/>
|
|
<div>
|
|
|
|
[<a href="https://github.com/crystal-lang/crystal-db/blob/v0.13.1/src/spec.cr#L115" target="_blank">View source</a>]
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<div class="entry-detail" id="it(description="assert",prepared=:default,file=__FILE__,line=__LINE__,end_line=__END_LINE__,&block:DB::Database->)-instance-method">
|
|
<div class="signature">
|
|
|
|
def <strong>it</strong>(description = <span class="s">"assert"</span>, prepared = <span class="n">:default</span>, file = __FILE__, line = __LINE__, end_line = __END_LINE__, &block : <a href="../DB/Database.html">DB::Database</a> -> )
|
|
|
|
<a class="method-permalink" href="#it%28description%3D%22assert%22%2Cprepared%3D%3Adefault%2Cfile%3D__FILE__%2Cline%3D__LINE__%2Cend_line%3D__END_LINE__%2C%26block%3ADB%3A%3ADatabase-%3E%29-instance-method">#</a>
|
|
</div>
|
|
|
|
<br/>
|
|
<div>
|
|
|
|
[<a href="https://github.com/crystal-lang/crystal-db/blob/v0.13.1/src/spec.cr#L125" target="_blank">View source</a>]
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<div class="entry-detail" id="its-instance-method">
|
|
<div class="signature">
|
|
|
|
def <strong>its</strong>
|
|
|
|
<a class="method-permalink" href="#its-instance-method">#</a>
|
|
</div>
|
|
|
|
<br/>
|
|
<div>
|
|
|
|
[<a href="https://github.com/crystal-lang/crystal-db/blob/v0.13.1/src/spec.cr#L123" target="_blank">View source</a>]
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<div class="entry-detail" id="sample_value(value,sql_type,value_encoded,*,type_safe_value=true)-instance-method">
|
|
<div class="signature">
|
|
|
|
def <strong>sample_value</strong>(value, sql_type, value_encoded, *, type_safe_value = <span class="n">true</span>)
|
|
|
|
<a class="method-permalink" href="#sample_value%28value%2Csql_type%2Cvalue_encoded%2C%2A%2Ctype_safe_value%3Dtrue%29-instance-method">#</a>
|
|
</div>
|
|
|
|
<div class="doc">
|
|
|
|
<p>Use <em>value</em> as sample value that should be stored in columns of type <em>sql_type</em>.
|
|
<em>value_encoded</em> is driver specific expression that should generate that value in the database.
|
|
<em>type_safe_value</em> indicates whether <em>value_encoded</em> is expected to generate the <em>value</em> even without
|
|
been stored in a table (default <code>true</code>).</p>
|
|
</div>
|
|
|
|
<br/>
|
|
<div>
|
|
|
|
[<a href="https://github.com/crystal-lang/crystal-db/blob/v0.13.1/src/spec.cr#L138" target="_blank">View source</a>]
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<div class="entry-detail" id="select_1column_syntax(&select_1column_syntax:Proc(String,ColumnDef,String))-instance-method">
|
|
<div class="signature">
|
|
|
|
def <strong>select_1column_syntax</strong>(&select_1column_syntax : Proc(String, <a href="../DB/DriverSpecs/ColumnDef.html">ColumnDef</a>, String))
|
|
|
|
<a class="method-permalink" href="#select_1column_syntax%28%26select_1column_syntax%3AProc%28String%2CColumnDef%2CString%29%29-instance-method">#</a>
|
|
</div>
|
|
|
|
<br/>
|
|
<div>
|
|
|
|
[<a href="https://github.com/crystal-lang/crystal-db/blob/v0.13.1/src/spec.cr#L116" target="_blank">View source</a>]
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<div class="entry-detail" id="select_2columns_syntax(&select_2columns_syntax:Proc(String,ColumnDef,ColumnDef,String))-instance-method">
|
|
<div class="signature">
|
|
|
|
def <strong>select_2columns_syntax</strong>(&select_2columns_syntax : Proc(String, <a href="../DB/DriverSpecs/ColumnDef.html">ColumnDef</a>, <a href="../DB/DriverSpecs/ColumnDef.html">ColumnDef</a>, String))
|
|
|
|
<a class="method-permalink" href="#select_2columns_syntax%28%26select_2columns_syntax%3AProc%28String%2CColumnDef%2CColumnDef%2CString%29%29-instance-method">#</a>
|
|
</div>
|
|
|
|
<br/>
|
|
<div>
|
|
|
|
[<a href="https://github.com/crystal-lang/crystal-db/blob/v0.13.1/src/spec.cr#L117" target="_blank">View source</a>]
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<div class="entry-detail" id="select_count_syntax(&select_count_syntax:Proc(String,String))-instance-method">
|
|
<div class="signature">
|
|
|
|
def <strong>select_count_syntax</strong>(&select_count_syntax : Proc(String, String))
|
|
|
|
<a class="method-permalink" href="#select_count_syntax%28%26select_count_syntax%3AProc%28String%2CString%29%29-instance-method">#</a>
|
|
</div>
|
|
|
|
<br/>
|
|
<div>
|
|
|
|
[<a href="https://github.com/crystal-lang/crystal-db/blob/v0.13.1/src/spec.cr#L118" target="_blank">View source</a>]
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<div class="entry-detail" id="select_scalar_syntax(&select_scalar_syntax:Proc(String,String|Nil,String))-instance-method">
|
|
<div class="signature">
|
|
|
|
def <strong>select_scalar_syntax</strong>(&select_scalar_syntax : Proc(String, String | Nil, String))
|
|
|
|
<a class="method-permalink" href="#select_scalar_syntax%28%26select_scalar_syntax%3AProc%28String%2CString%7CNil%2CString%29%29-instance-method">#</a>
|
|
</div>
|
|
|
|
<br/>
|
|
<div>
|
|
|
|
[<a href="https://github.com/crystal-lang/crystal-db/blob/v0.13.1/src/spec.cr#L111" target="_blank">View source</a>]
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<div class="entry-detail" id="support_prepared(support_prepared:Bool)-instance-method">
|
|
<div class="signature">
|
|
|
|
def <strong>support_prepared</strong>(support_prepared : Bool)
|
|
|
|
<a class="method-permalink" href="#support_prepared%28support_prepared%3ABool%29-instance-method">#</a>
|
|
</div>
|
|
|
|
<div class="doc">
|
|
|
|
<p>Allow specs that uses prepared statements (default <code>true</code>)</p>
|
|
</div>
|
|
|
|
<br/>
|
|
<div>
|
|
|
|
[<a href="https://github.com/crystal-lang/crystal-db/blob/v0.13.1/src/spec.cr#L70" target="_blank">View source</a>]
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<div class="entry-detail" id="support_unprepared(support_unprepared:Bool)-instance-method">
|
|
<div class="signature">
|
|
|
|
def <strong>support_unprepared</strong>(support_unprepared : Bool)
|
|
|
|
<a class="method-permalink" href="#support_unprepared%28support_unprepared%3ABool%29-instance-method">#</a>
|
|
</div>
|
|
|
|
<div class="doc">
|
|
|
|
<p>Allow specs that uses unprepared statements (default <code>true</code>)</p>
|
|
</div>
|
|
|
|
<br/>
|
|
<div>
|
|
|
|
[<a href="https://github.com/crystal-lang/crystal-db/blob/v0.13.1/src/spec.cr#L79" target="_blank">View source</a>]
|
|
|
|
</div>
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
</div>
|
|
|
|
</body>
|
|
</html>
|