cbaines/guile-knots
1
Fork 0
Code Issues 1 Pull requests Activity Actions

Automatic website update

Browse source
This commit is contained in:
Automatic website updater 2026-03-23 13:55:43 +00:00
parent c48e0c9dc7
commit 6189d2e4fb
1 changed files with 91 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

98
index.html
View file

@ -923,10 +923,19 @@ POOL. Syntactic sugar around <code class="code">call-with-resource-from-pool</c
<dl class="first-deffn">
<dt class="deffn" id="index-call_002dwith_002dresource_002dfrom_002dpool"><span class="category-def">Procedure: </span><span><strong class="def-name">call-with-resource-from-pool</strong> <var class="def-var-arguments">_ _ KEY: #:timeout #:timeout-handler #:max-waiters #:channel #:destroy-resource-on-exception?</var><a class="copiable-link" href="#index-call_002dwith_002dresource_002dfrom_002dpool"> &para;</a></span></dt>
<dt class="deffn" id="index-call_002dwith_002dresource_002dfrom_002dpool"><span class="category-def">Procedure: </span><span><strong class="def-name">call-with-resource-from-pool</strong> <var class="def-var-arguments">_ _ KEY: #:timeout #:timeout-handler #:max-waiters #:channel #:destroy-resource-on-exception? #:delay-logger #:duration-logger</var><a class="copiable-link" href="#index-call_002dwith_002dresource_002dfrom_002dpool"> &para;</a></span></dt>
<dd><p>Call PROC with a resource from POOL, blocking until a resource becomes
available. Return the resource once PROC has returned.
</p>
<p><code class="code">#:delay-logger</code> is called as <code class="code">(delay-logger seconds)</code> with
the time spent waiting for a resource to become available. Defaults to
the pool&rsquo;s <code class="code">#:delay-logger</code> if not specified.
</p>
<p><code class="code">#:duration-logger</code> is called as <code class="code">(duration-logger seconds)</code>
after PROC completes, whether it returned normally or raised an
exception. Defaults to the pool&rsquo;s <code class="code">#:duration-logger</code> if not
specified.
</p>
</dd></dl>
@ -971,6 +980,20 @@ this limit is exceeded, <code class="code">&amp;resource-pool-too-many-waiters</
when a resource is requested. Defaults to <code class="code">#f</code> (no limit).
</p>
</dd>
<dt><code class="code">#:delay-logger</code></dt>
<dd><p>Called as <code class="code">(delay-logger seconds)</code> with the time spent waiting for
a resource to become available. Defaults to <code class="code">#f</code> (no logging).
</p>
</dd>
<dt><code class="code">#:duration-logger</code></dt>
<dd><p>Called as <code class="code">(duration-logger seconds)</code> after the proc passed to
<code class="code">call-with-resource-from-pool</code> completes, whether it returned
normally or raised an exception. Can be overridden per-call via the
<code class="code">#:duration-logger</code> keyword argument to
<code class="code">call-with-resource-from-pool</code>. Defaults to <code class="code">#f</code> (no
logging).
</p>
</dd>
<dt><code class="code">#:scheduler</code></dt>
<dd><p>The Fibers scheduler to use for the pool&rsquo;s internal fiber. Defaults to
the current scheduler.
@ -1041,6 +1064,20 @@ this limit is exceeded, <code class="code">&amp;resource-pool-too-many-waiters</
when a resource is requested. Defaults to <code class="code">#f</code> (no limit).
</p>
</dd>
<dt><code class="code">#:delay-logger</code></dt>
<dd><p>Called as <code class="code">(delay-logger seconds)</code> with the time spent waiting for
a resource to become available. Defaults to <code class="code">#f</code> (no logging).
</p>
</dd>
<dt><code class="code">#:duration-logger</code></dt>
<dd><p>Called as <code class="code">(duration-logger seconds)</code> after the proc passed to
<code class="code">call-with-resource-from-pool</code> completes, whether it returned
normally or raised an exception. Can be overridden per-call via the
<code class="code">#:duration-logger</code> keyword argument to
<code class="code">call-with-resource-from-pool</code>. Defaults to <code class="code">#f</code> (no
logging).
</p>
</dd>
<dt><code class="code">#:scheduler</code></dt>
<dd><p>The Fibers scheduler to use for the pool&rsquo;s internal fiber. Defaults to
the current scheduler.
@ -1062,6 +1099,15 @@ the current scheduler.
<dl class="first-deffn">
<dt class="deffn" id="index-resource_002dpool_002ddelay_002dlogger"><span class="category-def">Procedure: </span><span><strong class="def-name">resource-pool-delay-logger</strong> <var class="def-var-arguments">a</var><a class="copiable-link" href="#index-resource_002dpool_002ddelay_002dlogger"> &para;</a></span></dt>
<dd><p>Undocumented procedure.
</p>
</dd></dl>
<dl class="first-deffn">
<dt class="deffn" id="index-resource_002dpool_002ddestroy_002dresource_002dexception_003f"><span class="category-def">Procedure: </span><span><strong class="def-name">resource-pool-destroy-resource-exception?</strong> <var class="def-var-arguments">obj</var><a class="copiable-link" href="#index-resource_002dpool_002ddestroy_002dresource_002dexception_003f"> &para;</a></span></dt>
<dd><p>Return <code class="code">#t</code> if OBJ is a <code class="code">&amp;resource-pool-destroy-resource</code>
@ -1090,6 +1136,15 @@ exception.
<dl class="first-deffn">
<dt class="deffn" id="index-resource_002dpool_002dduration_002dlogger"><span class="category-def">Procedure: </span><span><strong class="def-name">resource-pool-duration-logger</strong> <var class="def-var-arguments">a</var><a class="copiable-link" href="#index-resource_002dpool_002dduration_002dlogger"> &para;</a></span></dt>
<dd><p>Undocumented procedure.
</p>
</dd></dl>
<dl class="first-deffn">
<dt class="deffn" id="index-resource_002dpool_002dstats"><span class="category-def">Procedure: </span><span><strong class="def-name">resource-pool-stats</strong> <var class="def-var-arguments">_ KEY: #:timeout</var><a class="copiable-link" href="#index-resource_002dpool_002dstats"> &para;</a></span></dt>
<dd><p>Return an alist of statistics for POOL with the following keys:
@ -1341,7 +1396,7 @@ Next: <a href="#knots_005ftimeout" accesskey="n" rel="next">(knots timeout)</a>,
<dl class="first-deffn">
<dt class="deffn" id="index-call_002dwith_002dthread"><span class="category-def">Procedure: </span><span><strong class="def-name">call-with-thread</strong> <var class="def-var-arguments">_ _ KEY: #:duration-logger #:checkout-timeout #:channel #:destroy-thread-on-exception? #:max-waiters</var><a class="copiable-link" href="#index-call_002dwith_002dthread"> &para;</a></span></dt>
<dt class="deffn" id="index-call_002dwith_002dthread"><span class="category-def">Procedure: </span><span><strong class="def-name">call-with-thread</strong> <var class="def-var-arguments">_ _ KEY: #:delay-logger #:duration-logger #:checkout-timeout #:channel #:destroy-thread-on-exception? #:max-waiters</var><a class="copiable-link" href="#index-call_002dwith_002dthread"> &para;</a></span></dt>
<dd><p>Run PROC in THREAD-POOL and return its values, blocking until complete.
If called from within a thread that already belongs to THREAD-POOL, PROC
is called directly in that thread.
@ -1366,9 +1421,16 @@ Equivalent to per-call <code class="code">#:expire-on-exception?</code>. Defaul
<code class="code">#f</code>.
</p>
</dd>
<dt><code class="code">#:delay-logger</code></dt>
<dd><p>Called as <code class="code">(delay-logger seconds)</code> with the time spent waiting for
a thread to become available. Defaults to the pool&rsquo;s
<code class="code">#:delay-logger</code> if not specified.
</p>
</dd>
<dt><code class="code">#:duration-logger</code></dt>
<dd><p>Called as <code class="code">(duration-logger seconds)</code> after PROC completes (whether
or not it raised an exception).
or not it raised an exception). Defaults to the pool&rsquo;s
<code class="code">#:duration-logger</code> if not specified.
</p>
</dd>
<dt><code class="code">#:channel</code></dt>
@ -1440,13 +1502,13 @@ forever).
</p>
</dd>
<dt><code class="code">#:delay-logger</code></dt>
<dd><p>Called as <code class="code">(delay-logger seconds proc)</code> with the time spent waiting
for a thread to become available.
<dd><p>Called as <code class="code">(delay-logger seconds)</code> with the time spent waiting for
a thread to become available.
</p>
</dd>
<dt><code class="code">#:duration-logger</code></dt>
<dd><p>Called as <code class="code">(duration-logger seconds proc)</code> after each procedure
completes.
<dd><p>Called as <code class="code">(duration-logger seconds)</code> after each procedure
completes, whether it returned normally or raised an exception.
</p>
</dd>
</dl>
@ -1533,6 +1595,24 @@ bytes.
<dl class="first-deffn">
<dt class="deffn" id="index-thread_002dpool_002ddelay_002dlogger"><span class="category-def">Procedure: </span><span><strong class="def-name">thread-pool-delay-logger</strong> <var class="def-var-arguments">a</var><a class="copiable-link" href="#index-thread_002dpool_002ddelay_002dlogger"> &para;</a></span></dt>
<dd><p>Return the delay logger for POOL, dispatching on pool type.
</p>
</dd></dl>
<dl class="first-deffn">
<dt class="deffn" id="index-thread_002dpool_002dduration_002dlogger"><span class="category-def">Procedure: </span><span><strong class="def-name">thread-pool-duration-logger</strong> <var class="def-var-arguments">a</var><a class="copiable-link" href="#index-thread_002dpool_002dduration_002dlogger"> &para;</a></span></dt>
<dd><p>Return the duration logger for POOL, dispatching on pool type.
</p>
</dd></dl>
<dl class="first-deffn">
<dt class="deffn" id="index-thread_002dpool_002dtimeout_002derror_002dpool"><span class="category-def">Procedure: </span><span><strong class="def-name">thread-pool-timeout-error-pool</strong> <var class="def-var-arguments">obj</var><a class="copiable-link" href="#index-thread_002dpool_002dtimeout_002derror_002dpool"> &para;</a></span></dt>
<dd><p>Return the pool from a <code class="code">&amp;thread-pool-timeout-error</code> exception.
@ -2170,9 +2250,11 @@ Next: <a href="#Variable-Index" accesskey="n" rel="next">Variable Index</a>, Pre
<tr><td></td><td class="printindex-index-entry"><a href="#index-request_002dbody_002dport_002fknots"><code>request-body-port/knots</code></a></td><td class="printindex-index-section"><a href="#knots_005fweb_002dserver">knots_web-server</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-resource_002dpool_002dchannel"><code>resource-pool-channel</code></a></td><td class="printindex-index-section"><a href="#knots_005fresource_002dpool">knots_resource-pool</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-resource_002dpool_002dconfiguration"><code>resource-pool-configuration</code></a></td><td class="printindex-index-section"><a href="#knots_005fresource_002dpool">knots_resource-pool</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-resource_002dpool_002ddelay_002dlogger"><code>resource-pool-delay-logger</code></a></td><td class="printindex-index-section"><a href="#knots_005fresource_002dpool">knots_resource-pool</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-resource_002dpool_002ddestroy_002dresource_002dexception_003f"><code>resource-pool-destroy-resource-exception?</code></a></td><td class="printindex-index-section"><a href="#knots_005fresource_002dpool">knots_resource-pool</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-resource_002dpool_002ddestroyed_002derror_002dpool"><code>resource-pool-destroyed-error-pool</code></a></td><td class="printindex-index-section"><a href="#knots_005fresource_002dpool">knots_resource-pool</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-resource_002dpool_002ddestroyed_002derror_003f"><code>resource-pool-destroyed-error?</code></a></td><td class="printindex-index-section"><a href="#knots_005fresource_002dpool">knots_resource-pool</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-resource_002dpool_002dduration_002dlogger"><code>resource-pool-duration-logger</code></a></td><td class="printindex-index-section"><a href="#knots_005fresource_002dpool">knots_resource-pool</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-resource_002dpool_002dname"><code>resource-pool-name</code></a></td><td class="printindex-index-section"><a href="#knots_005fresource_002dpool">knots_resource-pool</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-resource_002dpool_002dstats"><code>resource-pool-stats</code></a></td><td class="printindex-index-section"><a href="#knots_005fresource_002dpool">knots_resource-pool</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-resource_002dpool_002dtimeout_002derror_002dpool"><code>resource-pool-timeout-error-pool</code></a></td><td class="printindex-index-section"><a href="#knots_005fresource_002dpool">knots_resource-pool</a></td></tr>
@ -2194,6 +2276,8 @@ Next: <a href="#Variable-Index" accesskey="n" rel="next">Variable Index</a>, Pre
<tr><td></td><td class="printindex-index-entry"><a href="#index-thread_002dname"><code>thread-name</code></a></td><td class="printindex-index-section"><a href="#knots_005fthread_002dpool">knots_thread-pool</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-thread_002dpool_002darguments_002dparameter"><code>thread-pool-arguments-parameter</code></a></td><td class="printindex-index-section"><a href="#knots_005fthread_002dpool">knots_thread-pool</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-thread_002dpool_002ddefault_002dcheckout_002dtimeout"><code>thread-pool-default-checkout-timeout</code></a></td><td class="printindex-index-section"><a href="#knots_005fthread_002dpool">knots_thread-pool</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-thread_002dpool_002ddelay_002dlogger"><code>thread-pool-delay-logger</code></a></td><td class="printindex-index-section"><a href="#knots_005fthread_002dpool">knots_thread-pool</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-thread_002dpool_002dduration_002dlogger"><code>thread-pool-duration-logger</code></a></td><td class="printindex-index-section"><a href="#knots_005fthread_002dpool">knots_thread-pool</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-thread_002dpool_002dresource_002dpool"><code>thread-pool-resource-pool</code></a></td><td class="printindex-index-section"><a href="#knots_005fthread_002dpool">knots_thread-pool</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-thread_002dpool_002dtimeout_002derror_002dpool"><code>thread-pool-timeout-error-pool</code></a></td><td class="printindex-index-section"><a href="#knots_005fthread_002dpool">knots_thread-pool</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-thread_002dpool_002dtimeout_002derror_003f"><code>thread-pool-timeout-error?</code></a></td><td class="printindex-index-section"><a href="#knots_005fthread_002dpool">knots_thread-pool</a></td></tr>