diff options
author | Oleg Pudeyev <code@olegp.name> | 2021-07-19 22:14:06 -0400 |
---|---|---|
committer | Oleg Pudeyev <code@olegp.name> | 2021-07-19 22:14:06 -0400 |
commit | ef696c225ce835e76e79f12ae8b53bfd375f7bb0 (patch) | |
tree | 83851f6a6bae695242cdc805c44f1373b6c137ac | |
parent | ca843341d9892c943c0819e58ecdbdd80befe981 (diff) | |
download | pycurl-ef696c225ce835e76e79f12ae8b53bfd375f7bb0.tar.gz |
remove documentation referencing official windows builds, closes #657
-rw-r--r-- | INSTALL.rst | 73 | ||||
-rw-r--r-- | doc/index.rst | 6 | ||||
-rw-r--r-- | setup.py | 3 |
3 files changed, 35 insertions, 47 deletions
diff --git a/INSTALL.rst b/INSTALL.rst index 8f085c9..ffc8030 100644 --- a/INSTALL.rst +++ b/INSTALL.rst @@ -118,47 +118,8 @@ To force pip to recompile pycurl, run:: Windows ------- -Official Packages -^^^^^^^^^^^^^^^^^ - -As of version 7.43.0, PycURL provides binary wheels for Windows. If you are -using an official distribution of Python (i.e., one downloaded from -https://www.python.org/), and you are using pip, you should be able to -install PycURL by running: - - pip install pycurl - -Both 32-bit and 64-bit builds of PycURL are available for Windows. - - -Using PycURL With Custom Python Builds -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -As of version 7.21.5, PycURL is linked statically against all of its -dependencies except MSVCRT. This means that as long as your custom Python -build uses the same version of MSVC as the corresponding official Python build -as well as the same MSVCRT linking setting (/MD et. al.) you should be -able to use an official PycURL package. - -If your Python build uses different MSVCRT settings or a different MSVC -version from the official Python builds, you will need to compile PycURL -from source. - -If the C runtime library (MSVCRT.DLL) versions used by PycURL and Python -do not match, you will receive a message -like the following one when trying to import ``pycurl`` module:: - - ImportError: DLL load failed: The specified procedure could not be found. - -To identify which MSVCRT version your Python uses use the -`application profiling feature`_ of -`Dependency Walker`_ and look for `msvcrt.dll variants`_ being loaded. -You may find `the entire thread starting here`_ helpful. - -.. _application profiling feature: https://curl.haxx.se/mail/curlpython-2014-05/0007.html -.. _Dependency Walker: http://www.dependencywalker.com/ -.. _msvcrt.dll variants: https://curl.haxx.se/mail/curlpython-2014-05/0010.html -.. _the entire thread starting here: https://curl.haxx.se/mail/curlpython-2014-05/0000.html +There are currently no official binary Windows packages. You can build PycURL +from source or use third-party binary packages. Building From Source @@ -263,6 +224,36 @@ if this is not the case edit it as needed. ``winbuild.py`` itself can be run with any Python it supports. +Using PycURL With Custom Python Builds +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +As of version 7.21.5, the official binary packages of PycURL are linked +statically against all of its dependencies except MSVCRT. This means that +as long as your custom Python build uses the same version of MSVC as the +corresponding official Python build as well as the same MSVCRT linking setting +(/MD et. al.), an official PycURL package should work. + +If your Python build uses different MSVCRT settings or a different MSVC +version from the official Python builds, you will need to compile PycURL +from source. + +If the C runtime library (MSVCRT.DLL) versions used by PycURL and Python +do not match, you will receive a message +like the following one when trying to import ``pycurl`` module:: + + ImportError: DLL load failed: The specified procedure could not be found. + +To identify which MSVCRT version your Python uses use the +`application profiling feature`_ of +`Dependency Walker`_ and look for `msvcrt.dll variants`_ being loaded. +You may find `the entire thread starting here`_ helpful. + +.. _application profiling feature: https://curl.haxx.se/mail/curlpython-2014-05/0007.html +.. _Dependency Walker: http://www.dependencywalker.com/ +.. _msvcrt.dll variants: https://curl.haxx.se/mail/curlpython-2014-05/0010.html +.. _the entire thread starting here: https://curl.haxx.se/mail/curlpython-2014-05/0000.html + + Git Checkout ------------ diff --git a/doc/index.rst b/doc/index.rst index 1d26d74..d407692 100644 --- a/doc/index.rst +++ b/doc/index.rst @@ -57,7 +57,7 @@ About libcurl Requirements ------------ -- Python 2.7 or 3.4 through 3.6. +- Python 3. - libcurl 7.19.0 or better. @@ -74,9 +74,7 @@ Installation via easy_install and pip is also supported:: If this does not work, please see :ref:`install`. -On Windows, use pip to install a binary wheel for Python 2.7, 3.5 or 3.6:: - - pip install pycurl +On Windows, build from source or use a third-party binary package. Support @@ -861,8 +861,7 @@ Requirements Installation ------------ -Download source and binary distributions from `PyPI`_. -Binary wheels are now available for 32 and 64 bit Windows versions. +Download the source distribution from `PyPI`_. Please see `the installation documentation`_ for installation instructions. |