xdjango-postgres-extra 2.0.9rc5__tar.gz

xdjango_postgres_extra-2.0.9rc5/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 Sector Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

xdjango_postgres_extra-2.0.9rc5/PKG-INFO

@@ -0,0 +1,202 @@
+Metadata-Version: 2.4
+Name: xdjango-postgres-extra
+Version: 2.0.9rc5
+Summary: Bringing all of PostgreSQL's awesomeness to Django.
+Home-page: https://github.com/SectorLabs/django-postgres-extra
+Author: Sector Labs
+Author-email: open-source@sectorlabs.ro
+License: MIT License
+Keywords: django,postgres,extra,hstore,upsert,partioning,materialized,view
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django<=6.0.4,>=2.0
+Requires-Dist: python-dateutil<=3.0.0,>=2.8.0
+Requires-Dist: dataclasses; python_version <= "3.6"
+Provides-Extra: dev
+Requires-Dist: poethepoet==0.34.0; python_version >= "3.9" and extra == "dev"
+Requires-Dist: poethepoet==0.30.0; (python_version >= "3.8" and python_version < "3.9") and extra == "dev"
+Requires-Dist: poethepoet==0.19.0; (python_version >= "3.7" and python_version < "3.8") and extra == "dev"
+Requires-Dist: poethepoet==0.13.1; (python_version >= "3.6" and python_version < "3.7") and extra == "dev"
+Provides-Extra: test
+Requires-Dist: psycopg2==2.9.10; python_version >= "3.8" and extra == "test"
+Requires-Dist: psycopg2==2.9.9; (python_version >= "3.7" and python_version < "3.8") and extra == "test"
+Requires-Dist: psycopg2==2.9.8; (python_version >= "3.6" and python_version < "3.7") and extra == "test"
+Requires-Dist: types-psycopg2==2.9.21.20250516; python_version >= "3.9" and extra == "test"
+Requires-Dist: types-psycopg2==2.9.8; (python_version >= "3.6" and python_version < "3.9") and extra == "test"
+Requires-Dist: pytest==8.4.0; python_version > "3.8" and extra == "test"
+Requires-Dist: pytest==7.0.1; python_version <= "3.8" and extra == "test"
+Requires-Dist: pytest-benchmark==5.1.0; python_version > "3.8" and extra == "test"
+Requires-Dist: pytest-benchmark==3.4.1; python_version <= "3.8" and extra == "test"
+Requires-Dist: pytest-django==4.11.1; python_version > "3.7" and extra == "test"
+Requires-Dist: pytest-django==4.5.2; python_version <= "3.7" and extra == "test"
+Requires-Dist: pytest-cov==6.1.1; python_version > "3.8" and extra == "test"
+Requires-Dist: pytest-cov==4.0.0; python_version <= "3.8" and extra == "test"
+Requires-Dist: coverage==7.8.2; python_version > "3.8" and extra == "test"
+Requires-Dist: coverage==7.6.1; (python_version >= "3.8" and python_version <= "3.8") and extra == "test"
+Requires-Dist: coverage==6.2; python_version <= "3.7" and extra == "test"
+Requires-Dist: tox==4.26.0; python_version > "3.8" and extra == "test"
+Requires-Dist: tox==3.28.0; python_version <= "3.8" and extra == "test"
+Requires-Dist: freezegun==1.5.2; python_version > "3.7" and extra == "test"
+Requires-Dist: freezegun==1.2.2; python_version <= "3.7" and extra == "test"
+Requires-Dist: syrupy==4.9.1; python_version >= "3.9" and extra == "test"
+Requires-Dist: syrupy==2.3.1; python_version <= "3.8" and extra == "test"
+Provides-Extra: test-report
+Requires-Dist: coveralls==4.0.1; extra == "test-report"
+Provides-Extra: analysis
+Requires-Dist: black==22.3.0; extra == "analysis"
+Requires-Dist: flake8==7.2.0; extra == "analysis"
+Requires-Dist: autoflake==2.3.1; extra == "analysis"
+Requires-Dist: autopep8==2.3.2; extra == "analysis"
+Requires-Dist: isort==6.0.1; extra == "analysis"
+Requires-Dist: docformatter==1.7.7; extra == "analysis"
+Requires-Dist: mypy==1.16.0; extra == "analysis"
+Requires-Dist: django-stubs==4.2.7; extra == "analysis"
+Requires-Dist: typing-extensions==4.14.0; extra == "analysis"
+Requires-Dist: types-dj-database-url==1.3.0.4; extra == "analysis"
+Requires-Dist: types-python-dateutil==2.9.0.20250516; extra == "analysis"
+Provides-Extra: docs
+Requires-Dist: Sphinx==8.2.3; extra == "docs"
+Requires-Dist: sphinx-rtd-theme==3.0.2; extra == "docs"
+Requires-Dist: docutils==0.21.2; extra == "docs"
+Requires-Dist: Jinja2==3.1.6; extra == "docs"
+Provides-Extra: publish
+Requires-Dist: build==0.7.0; extra == "publish"
+Requires-Dist: twine==3.7.1; extra == "publish"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+  
+|  |  |  |
+|--------------------|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| :white_check_mark: | **Tests** | [![CircleCI](https://circleci.com/gh/SectorLabs/django-postgres-extra/tree/master.svg?style=svg)](https://circleci.com/gh/SectorLabs/django-postgres-extra/tree/master) |
+| :memo: | **License** | [![License](https://img.shields.io/:license-mit-blue.svg)](http://doge.mit-license.org) |
+| :package: | **PyPi** | [![PyPi](https://badge.fury.io/py/django-postgres-extra.svg)](https://pypi.python.org/pypi/django-postgres-extra) |
+| :four_leaf_clover: | **Code coverage** | [![Coverage Status](https://coveralls.io/repos/github/SectorLabs/django-postgres-extra/badge.svg?branch=coveralls)](https://coveralls.io/github/SectorLabs/django-postgres-extra?branch=master) |
+| <img src="https://cdn.iconscout.com/icon/free/png-256/django-1-282754.png" width="22px" height="22px" align="center" /> | **Django Versions** | 2.0, 2.1, 2.2, 3.0, 3.1, 3.2, 4.0, 4.1, 4.2, 5.0, 5.1, 5.2 |
+| <img src="https://cdn3.iconfinder.com/data/icons/logos-and-brands-adobe/512/267_Python-512.png" width="22px" height="22px" align="center" /> | **Python Versions** | 3.6, 3.7, 3.8, 3.9, 3.10, 3.11, 3.12, 3.13 |
+| <img src="https://pbs.twimg.com/profile_images/1152122059/psycopg-100_400x400.png" width="22px" height="22px" align="center" /> | **Psycopg Versions** | 2, 3 |
+| :book: | **Documentation** | [Read The Docs](https://django-postgres-extra.readthedocs.io/en/master/) |
+| :warning: | **Upgrade** | [Upgrade from v1.x](https://django-postgres-extra.readthedocs.io/en/master/major_releases.html#new-features)
+| :checkered_flag: | **Installation** | [Installation Guide](https://django-postgres-extra.readthedocs.io/en/master/installation.html) |
+| :fire: | **Features** | [Features & Documentation](https://django-postgres-extra.readthedocs.io/en/master/index.html#features) |
+| :droplet: | **Future enhancements** | [Potential features](https://github.com/SectorLabs/django-postgres-extra/issues?q=is%3Aopen+is%3Aissue+label%3Aenhancement) |
+
+`django-postgres-extra` aims to make all of PostgreSQL's awesome features available through the Django ORM. We do this by taking care of all the hassle. As opposed to the many small packages that are available to try to bring a single feature to Django with minimal effort. ``django-postgres-extra`` goes the extra mile, with well tested implementations, seamless migrations and much more.
+ 
+With seamless we mean that any features we add will work truly seamlessly. You should not have to manually modify your migrations to work with fields and objects provided by this package.
+
+---
+
+:warning: **This README is for v2. See the `v1` branch for v1.x.**
+
+---
+
+## Major features
+
+[See the full list](http://django-postgres-extra.readthedocs.io/#features)
+
+* **Conflict handling (atomic upsert)**
+
+    Adds support for PostgreSQL's `ON CONFLICT` syntax for inserts. Supports `DO UPDATE` and `DO NOTHING`. Single statement, atomic and concurrency safe upserts. Supports conditional updates as well.
+
+* **Table partitioning**
+
+    Adds support for PostgreSQL 11.x declarative table partitioning. Integrated into Django migrations. Supports all types of partitioning. Includes a command to automatically create time-based partitions.
+
+* **Views & materialized views**
+
+    Adds support for creating views & materialized views as any other model. Integrated into Django migrations.
+
+* **Locking models & tables**
+
+    Support for explicit table-level locks.
+
+* **Creating/dropping schemas**
+
+    Support for managing PostgreSQL schemas.
+
+* **Truncating tables**
+
+   Support for ``TRUNCATE TABLE`` statements (including cascading).
+
+For Django 3.1 and older:
+
+* **Conditional unique index**
+* **Case insensitive index**
+
+For Django 2.2 and older:
+
+* **Unique index**
+* **HStore unique and required constraints on specific HStore keys**
+
+## Working with the code
+### Prerequisites
+
+* PostgreSQL 14 or newer.
+* Django 5.x or newer.
+* Python 3.11 or newer.
+
+These are just for local development. CI for code analysis etc runs against these. Tests will pass on all Python, Django and PostgreSQL versions documented. Linting, formatting and type-checking the code might not work on other Python and/or Django versions.
+
+### Getting started
+
+1. Clone the repository:
+
+        λ git clone https://github.com/SectorLabs/django-postgres-extra.git
+
+2. Create a virtual environment:
+
+       λ cd django-postgres-extra
+       λ virtualenv env
+       λ source env/bin/activate
+
+3. Create a postgres user for use in tests (skip if your default user is a postgres superuser):
+
+       λ createuser --superuser psqlextra --pwprompt
+       λ export DATABASE_URL=postgres://psqlextra:<password>@localhost/psqlextra
+
+   Hint: if you're using virtualenvwrapper, you might find it beneficial to put
+   the ``export`` line in ``$VIRTUAL_ENV/bin/postactivate`` so that it's always
+   available when using this virtualenv.
+
+4. Install the development/test dependencies:
+
+       λ pip install -r requirements-test.txt
+
+5. Run the tests:
+
+       λ poe test
+
+6. Run the benchmarks:
+
+       λ poe benchmark
+
+7. Auto-format code, sort imports and auto-fix linting errors:
+
+       λ poe fix

xdjango_postgres_extra-2.0.9rc5/README.md

@@ -0,0 +1,112 @@
+<h1 align="center">
+  <img width="400" src="https://i.imgur.com/79S6OVM.png" alt="django-postgres-extra">
+</h1>
+  
+|  |  |  |
+|--------------------|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| :white_check_mark: | **Tests** | [![CircleCI](https://circleci.com/gh/SectorLabs/django-postgres-extra/tree/master.svg?style=svg)](https://circleci.com/gh/SectorLabs/django-postgres-extra/tree/master) |
+| :memo: | **License** | [![License](https://img.shields.io/:license-mit-blue.svg)](http://doge.mit-license.org) |
+| :package: | **PyPi** | [![PyPi](https://badge.fury.io/py/django-postgres-extra.svg)](https://pypi.python.org/pypi/django-postgres-extra) |
+| :four_leaf_clover: | **Code coverage** | [![Coverage Status](https://coveralls.io/repos/github/SectorLabs/django-postgres-extra/badge.svg?branch=coveralls)](https://coveralls.io/github/SectorLabs/django-postgres-extra?branch=master) |
+| <img src="https://cdn.iconscout.com/icon/free/png-256/django-1-282754.png" width="22px" height="22px" align="center" /> | **Django Versions** | 2.0, 2.1, 2.2, 3.0, 3.1, 3.2, 4.0, 4.1, 4.2, 5.0, 5.1, 5.2 |
+| <img src="https://cdn3.iconfinder.com/data/icons/logos-and-brands-adobe/512/267_Python-512.png" width="22px" height="22px" align="center" /> | **Python Versions** | 3.6, 3.7, 3.8, 3.9, 3.10, 3.11, 3.12, 3.13 |
+| <img src="https://pbs.twimg.com/profile_images/1152122059/psycopg-100_400x400.png" width="22px" height="22px" align="center" /> | **Psycopg Versions** | 2, 3 |
+| :book: | **Documentation** | [Read The Docs](https://django-postgres-extra.readthedocs.io/en/master/) |
+| :warning: | **Upgrade** | [Upgrade from v1.x](https://django-postgres-extra.readthedocs.io/en/master/major_releases.html#new-features)
+| :checkered_flag: | **Installation** | [Installation Guide](https://django-postgres-extra.readthedocs.io/en/master/installation.html) |
+| :fire: | **Features** | [Features & Documentation](https://django-postgres-extra.readthedocs.io/en/master/index.html#features) |
+| :droplet: | **Future enhancements** | [Potential features](https://github.com/SectorLabs/django-postgres-extra/issues?q=is%3Aopen+is%3Aissue+label%3Aenhancement) |
+
+`django-postgres-extra` aims to make all of PostgreSQL's awesome features available through the Django ORM. We do this by taking care of all the hassle. As opposed to the many small packages that are available to try to bring a single feature to Django with minimal effort. ``django-postgres-extra`` goes the extra mile, with well tested implementations, seamless migrations and much more.
+ 
+With seamless we mean that any features we add will work truly seamlessly. You should not have to manually modify your migrations to work with fields and objects provided by this package.
+
+---
+
+:warning: **This README is for v2. See the `v1` branch for v1.x.**
+
+---
+
+## Major features
+
+[See the full list](http://django-postgres-extra.readthedocs.io/#features)
+
+* **Conflict handling (atomic upsert)**
+
+    Adds support for PostgreSQL's `ON CONFLICT` syntax for inserts. Supports `DO UPDATE` and `DO NOTHING`. Single statement, atomic and concurrency safe upserts. Supports conditional updates as well.
+
+* **Table partitioning**
+
+    Adds support for PostgreSQL 11.x declarative table partitioning. Integrated into Django migrations. Supports all types of partitioning. Includes a command to automatically create time-based partitions.
+
+* **Views & materialized views**
+
+    Adds support for creating views & materialized views as any other model. Integrated into Django migrations.
+
+* **Locking models & tables**
+
+    Support for explicit table-level locks.
+
+* **Creating/dropping schemas**
+
+    Support for managing PostgreSQL schemas.
+
+* **Truncating tables**
+
+   Support for ``TRUNCATE TABLE`` statements (including cascading).
+
+For Django 3.1 and older:
+
+* **Conditional unique index**
+* **Case insensitive index**
+
+For Django 2.2 and older:
+
+* **Unique index**
+* **HStore unique and required constraints on specific HStore keys**
+
+## Working with the code
+### Prerequisites
+
+* PostgreSQL 14 or newer.
+* Django 5.x or newer.
+* Python 3.11 or newer.
+
+These are just for local development. CI for code analysis etc runs against these. Tests will pass on all Python, Django and PostgreSQL versions documented. Linting, formatting and type-checking the code might not work on other Python and/or Django versions.
+
+### Getting started
+
+1. Clone the repository:
+
+        λ git clone https://github.com/SectorLabs/django-postgres-extra.git
+
+2. Create a virtual environment:
+
+       λ cd django-postgres-extra
+       λ virtualenv env
+       λ source env/bin/activate
+
+3. Create a postgres user for use in tests (skip if your default user is a postgres superuser):
+
+       λ createuser --superuser psqlextra --pwprompt
+       λ export DATABASE_URL=postgres://psqlextra:<password>@localhost/psqlextra
+
+   Hint: if you're using virtualenvwrapper, you might find it beneficial to put
+   the ``export`` line in ``$VIRTUAL_ENV/bin/postactivate`` so that it's always
+   available when using this virtualenv.
+
+4. Install the development/test dependencies:
+
+       λ pip install -r requirements-test.txt
+
+5. Run the tests:
+
+       λ poe test
+
+6. Run the benchmarks:
+
+       λ poe benchmark
+
+7. Auto-format code, sort imports and auto-fix linting errors:
+
+       λ poe fix

xdjango_postgres_extra-2.0.9rc5/psqlextra/__init__.py

@@ -0,0 +1,15 @@
+import django
+
+from ._version import __version__
+
+if django.VERSION < (3, 2):  # pragma: no cover
+    default_app_config = "psqlextra.apps.PostgresExtraAppConfig"
+
+    __all__ = [
+        "default_app_config",
+        "__version__",
+    ]
+else:
+    __all__ = [
+        "__version__",
+    ]

xdjango_postgres_extra-2.0.9rc5/psqlextra/_version.py

@@ -0,0 +1 @@
+__version__ = "2.0.9rc5"

xdjango_postgres_extra-2.0.9rc5/psqlextra/apps.py

@@ -0,0 +1,9 @@
+from django.apps import AppConfig
+
+
+class PostgresExtraAppConfig(AppConfig):
+    name = "psqlextra"
+    verbose_name = "PostgreSQL Extra"
+
+    def ready(self) -> None:
+        from .lookups import InValuesLookup  # noqa

xdjango_postgres_extra-2.0.9rc5/psqlextra/backend/base.py

@@ -0,0 +1,123 @@
+import logging
+
+from typing import TYPE_CHECKING
+
+from django import VERSION
+from django.conf import settings
+from django.contrib.postgres.signals import (
+    get_hstore_oids,
+    register_type_handlers,
+)
+from django.db import ProgrammingError
+
+from . import base_impl
+from .introspection import PostgresIntrospection
+from .operations import PostgresOperations
+from .schema import PostgresSchemaEditor
+
+from django.db.backends.postgresql.base import (  # isort:skip
+    DatabaseWrapper as PostgresDatabaseWrapper,
+)
+
+
+logger = logging.getLogger(__name__)
+
+
+if TYPE_CHECKING:
+
+    class Wrapper(PostgresDatabaseWrapper):
+        pass
+
+else:
+    Wrapper = base_impl.backend()
+
+
+class DatabaseWrapper(Wrapper):
+    """Wraps the standard PostgreSQL database back-end.
+
+    Overrides the schema editor with our custom schema editor and makes
+    sure the `hstore` extension is enabled.
+    """
+
+    SchemaEditorClass = PostgresSchemaEditor  # type: ignore[assignment]
+    introspection_class = PostgresIntrospection
+    ops_class = PostgresOperations
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+
+        if VERSION >= (5, 0):
+            return
+
+        # Some base back-ends such as the PostGIS back-end don't properly
+        # set `ops_class` and `introspection_class` and initialize these
+        # classes themselves.
+        #
+        # This can lead to broken functionality. We fix this automatically.
+
+        if not isinstance(self.introspection, self.introspection_class):
+            self.introspection = self.introspection_class(self)
+
+        if not isinstance(self.ops, self.ops_class):
+            self.ops = self.ops_class(self)
+
+        for expected_compiler_class in self.ops.compiler_classes:
+            compiler_class = self.ops.compiler(expected_compiler_class.__name__)
+
+            if not issubclass(compiler_class, expected_compiler_class):
+                logger.warning(
+                    "Compiler '%s.%s' is not properly deriving from '%s.%s'."
+                    % (
+                        compiler_class.__module__,
+                        compiler_class.__name__,
+                        expected_compiler_class.__module__,
+                        expected_compiler_class.__name__,
+                    )
+                )
+
+    def prepare_database(self):
+        """Ran to prepare the configured database.
+
+        This is where we enable the `hstore` extension if it wasn't
+        enabled yet.
+        """
+
+        super().prepare_database()
+
+        setup_ext = getattr(
+            settings, "POSTGRES_EXTRA_AUTO_EXTENSION_SET_UP", True
+        )
+        if not setup_ext:
+            return False
+
+        with self.cursor() as cursor:
+            try:
+                cursor.execute("CREATE EXTENSION IF NOT EXISTS hstore")
+            except ProgrammingError:  # permission denied
+                logger.warning(
+                    'Failed to create "hstore" extension. '
+                    "Tables with hstore columns may fail to migrate. "
+                    "If hstore is needed, make sure you are connected "
+                    "to the database as a superuser "
+                    "or add the extension manually.",
+                    exc_info=True,
+                )
+                return
+
+        # Clear old (non-existent), stale oids.
+        get_hstore_oids.cache_clear()
+
+        # Verify that we (and Django) can find the OIDs
+        # for hstore.
+        oids, _ = get_hstore_oids(self.alias)
+        if not oids:
+            logger.warning(
+                '"hstore" extension was created, but we cannot find the oids'
+                "in the database. Something went wrong.",
+            )
+            return
+
+        # We must trigger Django into registering the type handlers now
+        # so that any subsequent code can properly use the newly
+        # registered types.
+        register_type_handlers(self)

xdjango_postgres_extra-2.0.9rc5/psqlextra/backend/base_impl.py

@@ -0,0 +1,112 @@
+import importlib
+
+from django.conf import settings
+from django.core.exceptions import ImproperlyConfigured
+from django.db import DEFAULT_DB_ALIAS, connections
+from django.db.backends.postgresql.base import DatabaseWrapper
+from django.db.backends.postgresql.introspection import (  # type: ignore[import]
+    DatabaseIntrospection,
+)
+from django.db.backends.postgresql.operations import DatabaseOperations
+from django.db.backends.postgresql.schema import (  # type: ignore[import]
+    DatabaseSchemaEditor,
+)
+
+from django.db.backends.postgresql.base import (  # isort:skip
+    DatabaseWrapper as Psycopg2DatabaseWrapper,
+)
+
+
+def base_backend_instance():
+    """Gets an instance of the base class for the custom database back-end.
+
+    This should be the Django PostgreSQL back-end. However,
+    some people are already using a custom back-end from
+    another package. We are nice people and expose an option
+    that allows them to configure the back-end we base upon.
+
+    As long as the specified base eventually also has
+    the PostgreSQL back-end as a base, then everything should
+    work as intended.
+
+    We create an instance to inspect what classes to subclass
+    because not all back-ends set properties such as `ops_class`
+    properly. The PostGIS back-end is a good example.
+    """
+    base_class_name = getattr(
+        settings,
+        "POSTGRES_EXTRA_DB_BACKEND_BASE",
+        "django.db.backends.postgresql",
+    )
+
+    base_class_module = importlib.import_module(base_class_name + ".base")
+    base_class = getattr(base_class_module, "DatabaseWrapper", None)
+
+    if not base_class:
+        raise ImproperlyConfigured(
+            (
+                "'%s' is not a valid database back-end."
+                " The module does not define a DatabaseWrapper class."
+                " Check the value of POSTGRES_EXTRA_DB_BACKEND_BASE."
+            )
+            % base_class_name
+        )
+
+    if isinstance(base_class, Psycopg2DatabaseWrapper):
+        raise ImproperlyConfigured(
+            (
+                "'%s' is not a valid database back-end."
+                " It does inherit from the PostgreSQL back-end."
+                " Check the value of POSTGRES_EXTRA_DB_BACKEND_BASE."
+            )
+            % base_class_name
+        )
+
+    base_instance = base_class(connections.databases[DEFAULT_DB_ALIAS])
+    if base_instance.connection:
+        raise ImproperlyConfigured(
+            (
+                "'%s' establishes a connection during initialization."
+                " This is not expected and can lead to more connections"
+                " being established than neccesarry."
+            )
+            % base_class_name
+        )
+
+    return base_instance
+
+
+def backend() -> DatabaseWrapper:
+    """Gets the base class for the database back-end."""
+
+    return base_backend_instance().__class__
+
+
+def schema_editor() -> DatabaseSchemaEditor:
+    """Gets the base class for the schema editor.
+
+    We have to use the configured base back-end's schema editor for
+    this.
+    """
+
+    return base_backend_instance().SchemaEditorClass
+
+
+def introspection() -> DatabaseIntrospection:
+    """Gets the base class for the introspection class.
+
+    We have to use the configured base back-end's introspection class
+    for this.
+    """
+
+    return base_backend_instance().introspection.__class__
+
+
+def operations() -> DatabaseOperations:
+    """Gets the base class for the operations class.
+
+    We have to use the configured base back-end's operations class for
+    this.
+    """
+
+    return base_backend_instance().ops.__class__