Deploying to master from @ psycopg/psycopg-website@3cef5a3 🚀

psycopg3/docs/_sources/news.rst.txt

@@ -30,15 +30,19 @@ Psycopg 3.2 (unreleased)
 .. __: https://numpy.org/doc/stable/reference/arrays.scalars.html#built-in-scalar-types
 
 
-Psycopg 3.1.15 (unreleased)
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Current release
+---------------
 
-- Fix async connection to hosts resolving to  multiple IP addresses
-  (:ticket:`#695`).
+Psycopg 3.1.15
+^^^^^^^^^^^^^^
 
+- Fix use of ``service`` in connection string (regression in 3.1.13,
+  :ticket:`#694`).
+- Fix async connection to hosts resolving to multiple IP addresses (regression
+  in 3.1.13, :ticket:`#695`).
+- Respect the :envvar:`PGCONNECT_TIMEOUT` environment variable to determine
+  the connection timeout.
 
-Current release
----------------
 
 Psycopg 3.1.14
 ^^^^^^^^^^^^^^

psycopg3/docs/api/dns.html

@@ -324,18 +324,6 @@
 <dt class="sig sig-object py" id="psycopg.Connection._get_connection_params">
 <em class="property"><span class="pre">classmethod</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">Connection.</span></span><span class="sig-name descname"><span class="pre">_get_connection_params</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">conninfo</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Any" title="(in Python v3.12)"><span class="pre">Any</span></a></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#dict" title="(in Python v3.12)"><span class="pre">dict</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Any" title="(in Python v3.12)"><span class="pre">Any</span></a><span class="p"><span class="pre">]</span></span></span></span><a class="headerlink" href="#psycopg.Connection._get_connection_params" title="Permalink to this definition">#</a></dt>
 <dd><p>Manipulate connection parameters before connecting.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Parameters<span class="colon">:</span></dt>
-<dd class="field-odd"><ul class="simple">
-<li><p><strong>conninfo</strong> – Connection string as received by <a class="reference internal" href="connections.html#psycopg.Connection.connect" title="psycopg.Connection.connect"><code class="xref py py-obj docutils literal notranslate"><span class="pre">connect()</span></code></a>.</p></li>
-<li><p><strong>kwargs</strong> – Overriding connection arguments as received by <code class="xref py py-obj docutils literal notranslate"><span class="pre">connect()</span></code>.</p></li>
-</ul>
-</dd>
-<dt class="field-even">Returns<span class="colon">:</span></dt>
-<dd class="field-even"><p>Connection arguments merged and eventually modified, in a
-format similar to <a class="reference internal" href="conninfo.html#psycopg.conninfo.conninfo_to_dict" title="psycopg.conninfo.conninfo_to_dict"><code class="xref py py-obj docutils literal notranslate"><span class="pre">conninfo_to_dict()</span></code></a>.</p>
-</dd>
-</dl>
 <div class="admonition warning">
 <p class="admonition-title">Warning</p>
 <p>This is an experimental method.</p>
@@ -356,18 +344,6 @@
 <dt class="sig sig-object py" id="psycopg.AsyncConnection._get_connection_params">
 <em class="property"><span class="pre">async</span><span class="w"> </span><span class="pre">classmethod</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">AsyncConnection.</span></span><span class="sig-name descname"><span class="pre">_get_connection_params</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">conninfo</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Any" title="(in Python v3.12)"><span class="pre">Any</span></a></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#dict" title="(in Python v3.12)"><span class="pre">dict</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Any" title="(in Python v3.12)"><span class="pre">Any</span></a><span class="p"><span class="pre">]</span></span></span></span><a class="headerlink" href="#psycopg.AsyncConnection._get_connection_params" title="Permalink to this definition">#</a></dt>
 <dd><p>Manipulate connection parameters before connecting.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Parameters<span class="colon">:</span></dt>
-<dd class="field-odd"><ul class="simple">
-<li><p><strong>conninfo</strong> – Connection string as received by <a class="reference internal" href="connections.html#psycopg.Connection.connect" title="psycopg.Connection.connect"><code class="xref py py-obj docutils literal notranslate"><span class="pre">connect()</span></code></a>.</p></li>
-<li><p><strong>kwargs</strong> – Overriding connection arguments as received by <code class="xref py py-obj docutils literal notranslate"><span class="pre">connect()</span></code>.</p></li>
-</ul>
-</dd>
-<dt class="field-even">Returns<span class="colon">:</span></dt>
-<dd class="field-even"><p>Connection arguments merged and eventually modified, in a
-format similar to <a class="reference internal" href="conninfo.html#psycopg.conninfo.conninfo_to_dict" title="psycopg.conninfo.conninfo_to_dict"><code class="xref py py-obj docutils literal notranslate"><span class="pre">conninfo_to_dict()</span></code></a>.</p>
-</dd>
-</dl>
 <div class="admonition warning">
 <p class="admonition-title">Warning</p>
 <p>This is an experimental method.</p>

psycopg3/docs/genindex.html

@@ -801,6 +801,8 @@ <h2>E</h2>
 
         <ul>
           <li><a href="basic/install.html#index-0">PATH</a>
+</li>
+          <li><a href="news.html#index-1">PGCONNECT_TIMEOUT</a>
 </li>
           <li><a href="api/pq.html#index-1">PSYCOPG_IMPL</a>, <a href="api/pq.html#index-2">[1]</a>, <a href="basic/install.html#index-1">[2]</a>
 </li>
@@ -1375,6 +1377,8 @@ <h2>P</h2>
 </li>
         </ul></li>
         <li><a href="api/pq.html#psycopg.pq.PGconn.pgconn_ptr">pgconn_ptr (psycopg.pq.PGconn attribute)</a>
+</li>
+        <li><a href="news.html#index-1">PGCONNECT_TIMEOUT</a>
 </li>
         <li><a href="api/pq.html#psycopg.pq.PGresult">PGresult (class in psycopg.pq)</a>
 </li>
@@ -1559,9 +1563,9 @@ <h2>P</h2>
         <ul>
           <li><a href="advanced/typing.html#index-0">PEP 0484</a>
 </li>
-          <li><a href="news.html#index-1">PEP 475</a>
+          <li><a href="news.html#index-2">PEP 475</a>
 </li>
-          <li><a href="advanced/typing.html#index-1">PEP 675</a>, <a href="api/cursors.html#index-0">[1]</a>, <a href="api/sql.html#index-1">[2]</a>, <a href="news.html#index-2">[3]</a>
+          <li><a href="advanced/typing.html#index-1">PEP 675</a>, <a href="api/cursors.html#index-0">[1]</a>, <a href="api/sql.html#index-1">[2]</a>, <a href="news.html#index-3">[3]</a>
 </li>
         </ul></li>
         <li><a href="basic/pgtypes.html#psycopg.types.composite.CompositeInfo.python_type">python_type (psycopg.types.composite.CompositeInfo attribute)</a>

psycopg3/docs/news.html

@@ -270,16 +270,20 @@ <h3>Psycopg 3.2 (unreleased)<a class="headerlink" href="#psycopg-3-2-unreleased"
 <a class="reference internal" href="api/cursors.html#psycopg.Cursor.execute" title="psycopg.Cursor.execute"><code class="xref py py-obj docutils literal notranslate"><span class="pre">execute()</span></code></a>, consistently with non-pipeline mode.</p></li>
 </ul>
 </section>
-<section id="psycopg-3-1-15-unreleased">
-<h3>Psycopg 3.1.15 (unreleased)<a class="headerlink" href="#psycopg-3-1-15-unreleased" title="Permalink to this heading">#</a></h3>
-<ul class="simple">
-<li><p>Fix async connection to hosts resolving to  multiple IP addresses
-(ticket <a class="reference external" href="https://github.com/psycopg/psycopg/issues/695">#695</a>).</p></li>
-</ul>
-</section>
 </section>
 <section id="current-release">
 <h2>Current release<a class="headerlink" href="#current-release" title="Permalink to this heading">#</a></h2>
+<section id="psycopg-3-1-15">
+<h3>Psycopg 3.1.15<a class="headerlink" href="#psycopg-3-1-15" title="Permalink to this heading">#</a></h3>
+<ul class="simple">
+<li><p>Fix use of <code class="docutils literal notranslate"><span class="pre">service</span></code> in connection string (regression in 3.1.13,
+ticket <a class="reference external" href="https://github.com/psycopg/psycopg/issues/694">#694</a>).</p></li>
+<li><p>Fix async connection to hosts resolving to multiple IP addresses (regression
+in 3.1.13, ticket <a class="reference external" href="https://github.com/psycopg/psycopg/issues/695">#695</a>).</p></li>
+<li><p>Respect the <span class="target" id="index-1"></span><code class="xref std std-envvar docutils literal notranslate"><span class="pre">PGCONNECT_TIMEOUT</span></code> environment variable to determine
+the connection timeout.</p></li>
+</ul>
+</section>
 <section id="psycopg-3-1-14">
 <h3>Psycopg 3.1.14<a class="headerlink" href="#psycopg-3-1-14" title="Permalink to this heading">#</a></h3>
 <ul class="simple">
@@ -294,7 +298,7 @@ <h3>Psycopg 3.1.13<a class="headerlink" href="#psycopg-3-1-13" title="Permalink
 <a class="reference external" href="https://docs.python.org/3/library/datetime.html#datetime.time" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">time</span></code></a> object with with a <code class="xref py py-obj docutils literal notranslate"><span class="pre">tzinfo</span></code> specified as
 <a class="reference external" href="https://docs.python.org/3/library/zoneinfo.html#zoneinfo.ZoneInfo" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">ZoneInfo</span></code></a> (ambiguous offset, see ticket <a class="reference external" href="https://github.com/psycopg/psycopg/issues/652">#652</a>).</p></li>
 <li><p>Handle gracefully EINTR on signals instead of raising <a class="reference external" href="https://docs.python.org/3/library/exceptions.html#InterruptedError" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">InterruptedError</span></code></a>,
-consistently with <span class="target" id="index-1"></span><a class="pep reference external" href="https://peps.python.org/pep-0475/"><strong>PEP 475</strong></a> guideline (ticket <a class="reference external" href="https://github.com/psycopg/psycopg/issues/667">#667</a>).</p></li>
+consistently with <span class="target" id="index-2"></span><a class="pep reference external" href="https://peps.python.org/pep-0475/"><strong>PEP 475</strong></a> guideline (ticket <a class="reference external" href="https://github.com/psycopg/psycopg/issues/667">#667</a>).</p></li>
 <li><p>Fix support for connection strings with multiple hosts/ports and for the
 <code class="docutils literal notranslate"><span class="pre">load_balance_hosts</span></code> connection parameter (ticket <a class="reference external" href="https://github.com/psycopg/psycopg/issues/674">#674</a>).</p></li>
 <li><p>Fix memory leak receiving notifications in Python implementation
@@ -463,7 +467,7 @@ <h2>Psycopg 3.1<a class="headerlink" href="#psycopg-3-1" title="Permalink to thi
 <li><p>Add <code class="docutils literal notranslate"><span class="pre">prepare_threshold</span></code> parameter to <a class="reference internal" href="api/connections.html#psycopg.Connection" title="psycopg.Connection"><code class="xref py py-obj docutils literal notranslate"><span class="pre">Connection</span></code></a> init (ticket <a class="reference external" href="https://github.com/psycopg/psycopg/issues/200">#200</a>).</p></li>
 <li><p>Add <code class="docutils literal notranslate"><span class="pre">cursor_factory</span></code> parameter to <a class="reference internal" href="api/connections.html#psycopg.Connection" title="psycopg.Connection"><code class="xref py py-obj docutils literal notranslate"><span class="pre">Connection</span></code></a> init.</p></li>
 <li><p>Add <a class="reference internal" href="api/errors.html#psycopg.Error.pgconn" title="psycopg.Error.pgconn"><code class="xref py py-obj docutils literal notranslate"><span class="pre">Error.pgconn</span></code></a> and <a class="reference internal" href="api/errors.html#psycopg.Error.pgresult" title="psycopg.Error.pgresult"><code class="xref py py-obj docutils literal notranslate"><span class="pre">Error.pgresult</span></code></a> attributes (ticket <a class="reference external" href="https://github.com/psycopg/psycopg/issues/242">#242</a>).</p></li>
-<li><p>Restrict queries to be <a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.LiteralString" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">LiteralString</span></code></a> as per <span class="target" id="index-2"></span><a class="pep reference external" href="https://peps.python.org/pep-0675/"><strong>PEP 675</strong></a>
+<li><p>Restrict queries to be <a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.LiteralString" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">LiteralString</span></code></a> as per <span class="target" id="index-3"></span><a class="pep reference external" href="https://peps.python.org/pep-0675/"><strong>PEP 675</strong></a>
 (ticket <a class="reference external" href="https://github.com/psycopg/psycopg/issues/323">#323</a>).</p></li>
 <li><p>Add explicit type cast to values converted by <a class="reference internal" href="api/sql.html#psycopg.sql.Literal" title="psycopg.sql.Literal"><code class="xref py py-obj docutils literal notranslate"><span class="pre">sql.Literal</span></code></a> (ticket <a class="reference external" href="https://github.com/psycopg/psycopg/issues/205">#205</a>).</p></li>
 <li><p>Drop support for Python 3.6.</p></li>
@@ -707,10 +711,10 @@ <h3>Psycopg 3.0b1<a class="headerlink" href="#psycopg-3-0b1" title="Permalink to
 <li><a class="reference internal" href="#"><code class="docutils literal notranslate"><span class="pre">psycopg</span></code> release notes</a><ul>
 <li><a class="reference internal" href="#future-releases">Future releases</a><ul>
 <li><a class="reference internal" href="#psycopg-3-2-unreleased">Psycopg 3.2 (unreleased)</a></li>
-<li><a class="reference internal" href="#psycopg-3-1-15-unreleased">Psycopg 3.1.15 (unreleased)</a></li>
 </ul>
 </li>
 <li><a class="reference internal" href="#current-release">Current release</a><ul>
+<li><a class="reference internal" href="#psycopg-3-1-15">Psycopg 3.1.15</a></li>
 <li><a class="reference internal" href="#psycopg-3-1-14">Psycopg 3.1.14</a></li>
 <li><a class="reference internal" href="#psycopg-3-1-13">Psycopg 3.1.13</a></li>
 <li><a class="reference internal" href="#psycopg-3-1-12">Psycopg 3.1.12</a></li>