Metadata-Version: 1.2
Name: devpi-postgresql
Version: 1.1.0
Summary: devpi-postgresql: a PostgreSQL storage backend for devpi-server
Home-page: http://doc.devpi.net
Maintainer: Florian Schulze, Holger Krekel
Maintainer-email: florian.schulze@gmx.net
License: MIT
Description: ===============================================================
        devpi-postgresql: a PostgreSQL storage backend for devpi-server
        ===============================================================
        
        This plugin adds a PostgreSQL storage backend for `devpi-server`_.
        
        .. _devpi-server: https://pypi.org/project/devpi-server/
        
        
        Installation
        ============
        
        ``devpi-postgresql`` needs to be installed alongside ``devpi-server``.
        
        You can install it with::
        
            pip install devpi-postgresql
        
        
        Requirements
        ============
        
        At least PostgreSQL 9.5 is required for ``ON CONFLICT`` support.
        
        
        Usage
        =====
        
        When using the PostgreSQL storage, ``devpi-server`` expects an empty database.
        You have to create one like this: ``createdb devpi``
        Depending on your PostgreSQL setup you have to create a user and grant it permissions on the new database like this::
        
            CREATE ROLE devpi WITH LOGIN;
            GRANT CREATE, CONNECT ON DATABASE devpi TO devpi;
        
        Upon first initialization of ``devpi-server`` use ``--storage pg8000`` to select the PostgreSQL backend.
        
        By default it'll use the ``devpi`` database on ``localhost`` port ``5432``.
        To change that, use ``storage pg8000:host=example.com,port=5433,database=devpi_prod``.
        The possible settings are: ``database``, ``host``, ``port``, ``unix_sock``, ``user``, ``password``, ``ssl_cert_reqs``, ``ssl_ca_certs``, ``ssl_certfile`` and ``ssl_keyfile``. Each settings starting with "ssl" corresponds to the similarly-named key (remove the initial ``ssl_``) in the ``ssl`` parameter passed to pg8000.connect(). ``ssl_cert_reqs`` should be either "cert_optional" or "cert_required" and the other three settings are file names.
        
        All user/index files and metadata of ``devpi-server`` are stored in the database.
        A few things and settings are still stored as files in the directory specified by ``--serverdir``.
        
        Plugins like ``devpi-web`` don't or can't use the storage backend.
        They still handle their own storage.
        
        
        Support
        =======
        
        If you find a bug, use the `issue tracker at Github`_.
        
        For general questions use the #devpi IRC channel on `freenode.net`_ or the `devpi-dev@python.org mailing list`_.
        
        For support contracts and paid help contact `merlinux.eu`_.
        
        .. _issue tracker at Github: https://github.com/devpi/devpi/issues/
        .. _freenode.net: https://freenode.net/
        .. _devpi-dev@python.org mailing list: https://mail.python.org/mailman3/lists/devpi-dev.python.org/
        .. _merlinux.eu: https://merlinux.eu
        
        
        =========
        Changelog
        =========
        
        
        
        .. towncrier release notes start
        
        1.1.0 (2020-01-31)
        ==================
        
        Features
        --------
        
        - fix #738: add ``ssl_cert_reqs``, ``ssl_ca_certs``, ``ssl_certfile`` and ``ssl_keyfile`` settings to the --storage=pg8000 option. Each setting corresponds to the similarly-named key (remove the initial ``ssl_``) in the ``ssl`` parameter passed to pg8000.connect(). ``ssl_cert_reqs`` should be either "cert_optional" or "cert_required" and the other three settings are file names.
        
        
        1.0.0 (2019-04-26)
        ==================
        
        Deprecations and Removals
        -------------------------
        
        - Requires at least PostgreSQL 9.5 for ``ON CONFLICT`` support.
        
        - Dropped support for Python 2.x and PyPy2.
        
        
        0.3.0 (2018-09-08)
        ==================
        
        Bug Fixes
        ---------
        
        - Fixes required for bug fixes devpi-server 4.7.0.
        
        
        0.2.0 (2018-01-17)
        ==================
        
        Bug Fixes
        ---------
        
        - Use advisory locks to serialize writes.
        
        
        0.1.1 (2017-12-12)
        ==================
        
        - Add ``unix_sock``, ``user`` and ``password`` to possible connection options.
          Thanks to Szabolcs Rumi for the patch.
        
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Python: >=3.4
