]> git.ipfire.org Git - thirdparty/sqlalchemy/sqlalchemy.git/commitdiff
Normalize postgresql docs links to point to current
authorFederico Caselli <cfederico87@gmail.com>
Fri, 17 Jun 2022 19:53:32 +0000 (21:53 +0200)
committerFederico Caselli <cfederico87@gmail.com>
Fri, 17 Jun 2022 19:53:32 +0000 (21:53 +0200)
Change-Id: Ib7d3ea7ff3356ff8a2f935892d904a69dbc25c3e

doc/build/changelog/migration_07.rst
doc/build/orm/versioning.rst
lib/sqlalchemy/dialects/postgresql/base.py
lib/sqlalchemy/dialects/postgresql/ext.py
lib/sqlalchemy/dialects/postgresql/psycopg2.py
lib/sqlalchemy/dialects/postgresql/ranges.py
lib/sqlalchemy/orm/query.py
lib/sqlalchemy/sql/schema.py
lib/sqlalchemy/sql/sqltypes.py
test/dialect/postgresql/test_reflection.py

index 12a3c23e6d0b8fb94ef466322fa4e23e28003bfe..a222f5380bd64cb0665eb23107ae0a2c12c8ddee 100644 (file)
@@ -373,8 +373,7 @@ The best introduction to window functions is on PostgreSQL's
 site, where window functions have been supported since
 version 8.4:
 
-https://www.postgresql.org/docs/9.0/static/tutorial-
-window.html
+https://www.postgresql.org/docs/current/static/tutorial-window.html
 
 SQLAlchemy provides a simple construct typically invoked via
 an existing function clause, using the ``over()`` method,
index ffc22fae6870ef34ff94d43ac1269b8a2149e135..f29e4f2384df6e4cf1ed4e944cce8f1b3c829f83 100644 (file)
@@ -45,7 +45,7 @@ transaction).
 
     .. seealso::
 
-        `Repeatable Read Isolation Level <https://www.postgresql.org/docs/9.1/static/transaction-iso.html#XACT-REPEATABLE-READ>`_ - PostgreSQL's implementation of repeatable read, including a description of the error condition.
+        `Repeatable Read Isolation Level <https://www.postgresql.org/docs/current/static/transaction-iso.html#XACT-REPEATABLE-READ>`_ - PostgreSQL's implementation of repeatable read, including a description of the error condition.
 
 Simple Version Counting
 -----------------------
@@ -141,7 +141,7 @@ some means of generating new identifiers when a row is subject to an INSERT
 as well as with an UPDATE.   For the UPDATE case, typically an update trigger
 is needed, unless the database in question supports some other native
 version identifier.  The PostgreSQL database in particular supports a system
-column called `xmin <https://www.postgresql.org/docs/9.1/static/ddl-system-columns.html>`_
+column called `xmin <https://www.postgresql.org/docs/current/static/ddl-system-columns.html>`_
 which provides UPDATE versioning.  We can make use
 of the PostgreSQL ``xmin`` column to version our ``User``
 class as follows::
index 83e46151f0f88020c3c800a30af8bd0e2f071a4e..0de8a9c4456b2454ea32844ca267f4b0eb3d1cc7 100644 (file)
@@ -408,7 +408,7 @@ which is in the ``public`` (i.e. default) schema will always have the
     from a backend-agnostic perspective
 
     `The Schema Search Path
-    <https://www.postgresql.org/docs/9.0/static/ddl-schemas.html#DDL-SCHEMAS-PATH>`_
+    <https://www.postgresql.org/docs/current/static/ddl-schemas.html#DDL-SCHEMAS-PATH>`_
     - on the PostgreSQL website.
 
 INSERT/UPDATE...RETURNING
@@ -808,7 +808,7 @@ take full advantage of any indexes you may have created for full text search.
 
 .. seealso::
 
-    `Full Text Search <https://www.postgresql.org/docs/latest/textsearch-controls.html>`_ - in the PostgreSQL documentation
+    `Full Text Search <https://www.postgresql.org/docs/current/textsearch-controls.html>`_ - in the PostgreSQL documentation
 
 
 FROM ONLY ...
@@ -871,7 +871,7 @@ Operator Classes
 
 PostgreSQL allows the specification of an *operator class* for each column of
 an index (see
-https://www.postgresql.org/docs/8.3/interactive/indexes-opclass.html).
+https://www.postgresql.org/docs/current/interactive/indexes-opclass.html).
 The :class:`.Index` construct allows these to be specified via the
 ``postgresql_ops`` keyword argument::
 
@@ -913,7 +913,7 @@ Index Types
 
 PostgreSQL provides several index types: B-Tree, Hash, GiST, and GIN, as well
 as the ability for users to create their own (see
-https://www.postgresql.org/docs/8.3/static/indexes-types.html). These can be
+https://www.postgresql.org/docs/current/static/indexes-types.html). These can be
 specified on :class:`.Index` using the ``postgresql_using`` keyword argument::
 
     Index('my_index', my_table.c.data, postgresql_using='gin')
index ef8c8f5290d776d3371a39961c1a044035cac4bb..0192cf58157852d8c7bc56f2b38297c61d169123 100644 (file)
@@ -95,7 +95,7 @@ class ExcludeConstraint(ColumnCollectionConstraint):
     Defines an EXCLUDE constraint as described in the `PostgreSQL
     documentation`__.
 
-    __ https://www.postgresql.org/docs/9.0/static/sql-createtable.html#SQL-CREATETABLE-EXCLUDE
+    __ https://www.postgresql.org/docs/current/static/sql-createtable.html#SQL-CREATETABLE-EXCLUDE
 
     """  # noqa
 
index 7488e431d17e9d13d365fdb177d54be55c4a827c..2fe1ee15b16df33c51d249d951c34b1ec664523b 100644 (file)
@@ -107,7 +107,7 @@ using ``host`` as an additional keyword argument::
 .. seealso::
 
     `PQconnectdbParams \
-    <https://www.postgresql.org/docs/9.1/static/libpq-connect.html#LIBPQ-PQCONNECTDBPARAMS>`_
+    <https://www.postgresql.org/docs/current/static/libpq-connect.html#LIBPQ-PQCONNECTDBPARAMS>`_
 
 .. _psycopg2_multi_host:
 
@@ -132,7 +132,7 @@ or all connections are unsuccessful in which case an error is raised.
 .. seealso::
 
     `PQConnString \
-    <https://www.postgresql.org/docs/10/libpq-connect.html#LIBPQ-CONNSTRING>`_
+    <https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-CONNSTRING>`_
 
 Empty DSN Connections / Environment Variable Connections
 ---------------------------------------------------------
index b4d44fa9151c34bf0944026122de3493ad44e953..81431ad5974fc999c54683c2280bd9d2b676142e 100644 (file)
@@ -20,7 +20,7 @@ class RangeOperators:
     provided in the ``postgres`` dialect and can likely be used for
     any range types you create yourself.
 
-    __ https://www.postgresql.org/docs/devel/static/functions-range.html
+    __ https://www.postgresql.org/docs/current/static/functions-range.html
 
     No extra support is provided for the Range Functions listed in the Range
     Functions table of the PostgreSQL documentation. For these, the normal
index 596e9109986005ee3608f9305b57583bb7b82126..ead67be7fb3fc2b1e466a69a2b43ff398526ac14 100644 (file)
@@ -650,7 +650,7 @@ class Query(
 
         Here is the `PostgreSQL WITH
         RECURSIVE example
-        <https://www.postgresql.org/docs/8.4/static/queries-with.html>`_.
+        <https://www.postgresql.org/docs/current/static/queries-with.html>`_.
         Note that, in this example, the ``included_parts`` cte and the
         ``incl_alias`` alias of it are Core selectables, which
         means the columns are accessed via the ``.c.`` attribute.  The
index c37b6000391a15de24fba3fe48736a96d52ca003..5ab615781036cbff4e26392b56b013214f525d49 100644 (file)
@@ -4174,8 +4174,8 @@ class ForeignKeyConstraint(ColumnCollectionConstraint):
                 )
             else:
                 # e.g. FOREIGN KEY (a) REFERENCES r (b, c)
-                # paraphrasing https://www.postgresql.org/docs/9.2/static/\
-                # ddl-constraints.html
+                # paraphrasing
+                # https://www.postgresql.org/docs/current/static/ddl-constraints.html
                 raise exc.ArgumentError(
                     "ForeignKeyConstraint number "
                     "of constrained columns must match the number of "
index b4b444f23f08aecf205a557abc2834c1b7b7e344..115bfeae0df90ca8b893177be46b35fc614ce84d 100644 (file)
@@ -782,8 +782,8 @@ class DateTime(
     @util.memoized_property
     def _expression_adaptations(self):
 
-        # Based on https://www.postgresql.org/docs/current/\
-        # static/functions-datetime.html.
+        # Based on
+        # https://www.postgresql.org/docs/current/static/functions-datetime.html.
 
         return {
             operators.add: {Interval: self.__class__},
@@ -809,8 +809,8 @@ class Date(_RenderISO8601NoT, HasExpressionLookup, TypeEngine[dt.date]):
 
     @util.memoized_property
     def _expression_adaptations(self):
-        # Based on https://www.postgresql.org/docs/current/\
-        # static/functions-datetime.html.
+        # Based on
+        # https://www.postgresql.org/docs/current/static/functions-datetime.html.
 
         return {
             operators.add: {
@@ -857,8 +857,8 @@ class Time(_RenderISO8601NoT, HasExpressionLookup, TypeEngine[dt.time]):
 
     @util.memoized_property
     def _expression_adaptations(self):
-        # Based on https://www.postgresql.org/docs/current/\
-        # static/functions-datetime.html.
+        # Based on
+        # https://www.postgresql.org/docs/current/static/functions-datetime.html.
 
         return {
             operators.add: {Date: DateTime, Interval: self.__class__},
@@ -1921,8 +1921,8 @@ class Boolean(SchemaType, Emulated, TypeEngine[bool]):
 class _AbstractInterval(HasExpressionLookup, TypeEngine[dt.timedelta]):
     @util.memoized_property
     def _expression_adaptations(self):
-        # Based on https://www.postgresql.org/docs/current/\
-        # static/functions-datetime.html.
+        # Based on
+        # https://www.postgresql.org/docs/current/static/functions-datetime.html.
 
         return {
             operators.add: {
index cbb1809e4db77f3cab011b2cddcafa2f7e7fcae2..3e0569d32bab553a9ae03c04ce3961653a1bd14f 100644 (file)
@@ -1091,7 +1091,7 @@ class ReflectionTest(
 
         # "ASC NULLS LAST" is implicit default for indexes,
         # and "NULLS FIRST" is implicit default for "DESC".
-        # (https://www.postgresql.org/docs/11/indexes-ordering.html)
+        # (https://www.postgresql.org/docs/current/indexes-ordering.html)
 
         def compile_exprs(exprs):
             return list(map(str, exprs))