psycopg/psycopg2
1
1
Fork 0
mirror of https://github.com/psycopg/psycopg2.git synced 2025-03-03 23:55:46 +03:00
Code Issues Packages Projects Releases Wiki Activity

Added FAQ entry about the change in binary packages in 2.8

Browse Source
This commit is contained in:
Daniele Varrazzo 2019-04-14 15:08:07 +01:00
parent 4821a6294e
commit 6b740df704
2 changed files with 26 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
doc/src/faq.rst
View File

@ -287,8 +287,17 @@ How do I interrupt a long-running query in an interactive shell?
.. _faq-compile: .. _faq-compile:
Problems compiling and deploying psycopg2 Problems compiling and installing psycopg2
----------------------------------------- ------------------------------------------
.. _faq-wheels:
.. cssclass:: faq
Psycopg 2.8 fails to install, Psycopg 2.7 was working fine.
With Psycopg 2.7 you were installing binary packages, but they have proven
unreliable so now you have to install them explicitly using the
``psycopg2-binary`` package. See :ref:`binary-packages` for all the
details.
.. _faq-python-h: .. _faq-python-h:
.. cssclass:: faq .. cssclass:: faq

25
doc/src/install.rst
View File

@ -126,6 +126,8 @@ which is OS-dependent (for instance setting a suitable
single: Install; wheel single: Install; wheel
single: Wheel single: Wheel
.. _binary-packages:
Binary install from PyPI Binary install from PyPI
------------------------ ------------------------
@ -136,10 +138,12 @@ runtime prerequisites.
.. note:: .. note::
The ``-binary`` package is meant for beginners to start playing with The ``psycopg2-binary`` package is meant for beginners to start playing
Python and PostgreSQL without the need to meet the build requirements. with Python and PostgreSQL without the need to meet the build
requirements.
If you are the maintainer of a publish package depending on `!psycopg2` If you are the maintainer of a publish package depending on `!psycopg2`
you shouldn't use ``psycopg2-binary`` as a module dependency. For **you shouldn't use 'psycopg2-binary' as a module dependency**. For
production use you are advised to use the source distribution. production use you are advised to use the source distribution.
@ -179,15 +183,16 @@ using something like ``pip install -U pip``), then you can run:
.. _disable-wheel: .. _disable-wheel:
Disabling wheel packages for Psycopg 2.7 Change in binary packages between Psycopg 2.7 and 2.8
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
In version 2.7.x, `pip install psycopg2` would have tried to install the wheel In version 2.7.x, :command:`pip install psycopg2` would have tried to install
binary package of Psycopg. Because of the problems the wheel package have automatically the binary package of Psycopg. Because of concurrency problems
displayed, `psycopg2-binary` has become a separate package, and from 2.8 it binary packages have displayed, ``psycopg2-binary`` has become a separate
has become the only way to install the binary package. package, and from 2.8 it has become the only way to install the binary
package.
If you are using psycopg 2.7 and you want to disable the use of wheel binary If you are using Psycopg 2.7 and you want to disable the use of wheel binary
packages, relying on the system libraries available on your client, you packages, relying on the system libraries available on your client, you
can use the :command:`pip` |--no-binary option|__, e.g.: can use the :command:`pip` |--no-binary option|__, e.g.: