Differences between revisions 39 and 66 (spanning 27 versions)
⇤ ← Revision 39 as of 2016-07-03 12:58:39 →
Size: 7958
Editor: Jgoutin
Comment: setuptools 24
← Revision 66 as of 2017-06-13 08:45:23 → ⇥
Size: 9251
Editor: Jgoutin
Comment: MinGW-w64
Deletions are marked like this. Additions are marked like this.
Line 17: Line 17:
||14.0 ||3.5 || ||14.0 ||3.5, 3.6 ||
Line 21: Line 21:
= Distutils notes =
If the package's ''setup.py'' (still) uses ''distutils'' rather than the [[https://docs.python.org/2/library/distutils.html|recommended]] ''setuptools'', you may need extra steps:

 * ''distutils'' only supports the very minimum of compiler setups. The sections in this guide corresponding to them explicitly mention ''distutils''.
 * For other setups, you need to run the compilation from the "SDK prompt" of the corresponding toolchain and set the ''DISTUTILS_USE_SDK'' environment variable to a non-empty value.
Line 26: Line 31:
Line 29: Line 35:

== Microsoft Visual C++ 14.0 standalone: Build Tools for Visual Studio 2017 (x86, x64, ARM, ARM64) ==
This is a standalone version of ''Visual C++ 14.0'' compiler, you don't need to install ''Visual Studio 2017''.

 * Install ''[[https://www.visualstudio.com/downloads/#build-tools-for-visual-studio-2017|Microsoft Build Tools for Visual Studio 2017]]''.
 * The ''setuptools'' Python package version must be at least 34.4.0.

== Microsoft Visual C++ 14.0 with Visual Studio 2017 (x86, x64, ARM, ARM64) ==
''Visual Studio 2017'' contains ''Visual C++ 14.0'' compiler. The ''setuptools'' Python package version must be at least 34.4.0.
Line 34: Line 49:
 * For automatic use of this compiler with Python, ''setuptools'' version must be at least 24.0. For manual use, you have to run your commands from ''Visual C++ Build Tools Command Prompt'' (''C:\Program Files (x86)\Microsoft Visual C++ Build Tools\'') each time you want compile with Python.  * The ''setuptools'' Python package version must be at least 24.0.

/!\ Visual C++ Build Tools 2015 was upgraded by Microsoft to Build Tools for Visual Studio 2017. See the previous paragraph to install it.
Line 47: Line 64:
 * ''setuptools'' Python package version must be at least 24.0.  * The ''setuptools'' Python package version must be at least 24.0.
Line 56: Line 73:
 * ''setuptools'' Python package version must be at least 6.0.  * The ''setuptools'' Python package version must be at least 6.0.
Line 59: Line 76:

{i} This package always installs its start menu shortcuts for the installing user (i.e. an administrator) only. To get them for all users, run the installation like this: ''msiexec /i <full path to .msi> ALLUSERS=1''.
Line 67: Line 86:
 * ''setuptools'' Python package version must be at least 24.0.

For manual use, you have to run your commands from ''Windows SDK 7.0 Command Prompt'' (''C:\Program Files (x86)\Microsoft SDKs\Windows\v7.0\Bin\SetEnv.cmd'') each time you want to compile with Python. By default, SetEnv.cmd uses the ''x86'' architecture, use ''/x64'' or ''/ia64'' arguments to change it.		  * The ''setuptools'' Python package version must be at least 24.0.
Line 77: Line 94:
 * Install ''[[https://www.microsoft.com/download/details.aspx?id=11310|Windows SDK for Windows Server 2008 and .NET Framework 3.5]]''. Check ''Windows headers and libraries'', ''Visual C++ Compilers'' and ''Win32 Development Tools'' options only.
 * ''setuptools'' Python package version must be at least 24.0.

For manual use, you have to run your commands from ''Windows SDK 6.1 Command Prompt'' (''C:\Program Files (x86)\Microsoft SDKs\Windows\v6.1\Bin\SetEnv.cmd'') each time you want to compile with Python. By default, SetEnv.cmd uses the ''x86'' architecture, use ''/x64'' or ''/ia64'' arguments to change it.		  * Install ''[[https://www.microsoft.com/download/details.aspx?id=11310|Microsoft Windows SDK for Windows Server 2008 and .NET Framework 3.5]]''. Check ''Windows headers and libraries'', ''Visual C++ Compilers'' and ''Win32 Development Tools'' options only.
 * The ''setuptools'' Python package version must be at least 24.0.
Line 85: Line 100:
== MinGW (x86) ==
MinGW is an alternative C++ compiler that works with all Python versions.		 == GCC - MinGW-w64 (x86, x64) ==
Line 88: Line 102:
 * Install ''[[http://sourceforge.net/projects/mingw/files/|Minimalist GNU For Windows]]'' into ''C:\MinGW''.
 * Open ''MinGW Installation Manager'', check ''mingw32-base'' and ''mingw32-gcc-g++'', and ''Apply Changes'' in the ''Installation'' menu.
 * Add ''C:\MinGW\bin'' to the ''PATH'' environment variable (With ";" before if PATH is not empty).		 [[http://mingw-w64.org|MinGW-w64]] is an alternative C/C++ compiler that works with all Python versions up to 3.4.

 * Install ''[[http://win-builds.org/doku.php/download_and_installation_from_windows|Win-builds]]'' into ''C:\MinGW_w64''.
 * Open ''Win-builds'', switch to ''install'' at least ''binutils'', ''gcc'', ''gcc-g++'', ''getext'', ''mingw-w64'', ''win-iconv'', ''winpthreads'', ''zlib'', and click ''Process''.
 * Add ''C:\MinGW_w64\bin'' to the ''PATH'' environment variable.
Line 100: Line 116:
= Links =
 * [[https://support.microsoft.com/kb/2977003|Microsoft : The latest supported Visual C++ downloads]] : List of up-to-date ''Visual C++ Redistributable'' and ''Visual Studio'' packages.
== GCC - MinGW (x86) ==

[[http://www.mingw.org/|MinGW]] is an alternative C/C++ compiler that works with all Python versions up to 3.4.

 * Install ''[[http://sourceforge.net/projects/mingw/files/|Minimalist GNU For Windows]]'' into ''C:\MinGW''.
 * Open ''MinGW Installation Manager'', check ''mingw32-base'' and ''mingw32-gcc-g++'', and ''Apply Changes'' in the ''Installation'' menu.
 * Add ''C:\MinGW\bin'' to the ''PATH'' environment variable.
 * Create a ''distutils.cfg'' file with the following contents in the folder ''\Lib\distutils'' in Python install directory :

{{{#!highlight ini
[build]
compiler=mingw32

[build_ext]
compiler=mingw32
}}}

Contents

  1. Which Microsoft Visual C++ compiler to use with a specific Python version ?
  2. Distutils notes
  3. Compilers Installation and configuration
    1. Microsoft Visual C++ 14.0 standalone: Build Tools for Visual Studio 2017 (x86, x64, ARM, ARM64)
    2. Microsoft Visual C++ 14.0 with Visual Studio 2017 (x86, x64, ARM, ARM64)
    3. Microsoft Visual C++ 14.0 standalone: Visual C++ Build Tools 2015 (x86, x64, ARM)
    4. Microsoft Visual C++ 14.0 with Visual Studio 2015 (x86, x64, ARM)
    5. Microsoft Visual C++ 10.0 standalone: Windows SDK 7.1 (x86, x64, ia64)
    6. Microsoft Visual C++ 10.0 with Visual Studio 2010 (x86, x64, ia64)
    7. Microsoft Visual C++ 9.0 standalone: Visual C++ Compiler for Python 2.7 (x86, x64)
    8. Microsoft Visual C++ 9.0 standalone: Windows SDK 7.0 (x86, x64, ia64)
    9. Microsoft Visual C++ 9.0 standalone: Windows SDK 6.1 (x86, x64, ia64)
    10. Microsoft Visual C++ 9.0 with Visual Studio 2008 (x86, x64, ia64)
    11. GCC - MinGW-w64 (x86, x64)
    12. GCC - MinGW (x86)

Even though Python is an interpreted language, you may need to install Windows C++ compilers in some cases. Unlike Linux, compilers for Windows are not included by default in the OS.

For example, you will need to use them if you wish to:

Microsoft provides official C++ compilers called Visual C++, you can find them bundled with Visual Studio or, for some versions, in standalone distributions. Some alternative compilers exist like MinGW, but incompatibilities may occur with a CPython official distribution that is built with Microsoft Visual C++.

The compiler's architecture must be the same as Python's (for example: if you use Python 64bit, you have to use an x64 compiler).

Which Microsoft Visual C++ compiler to use with a specific Python version ?

Each Python version uses a specific compiler version (e.g. CPython 2.7 uses Visual C++ 9.0, CPython 3.3 uses Visual C++ 10.0, etc). So, you need to install the compiler version that corresponds to your Python version :

Visual C++

CPython

14.0

3.5, 3.6

10.0

3.3, 3.4

9.0

2.6, 2.7, 3.0, 3.1, 3.2

Distutils notes

If the package's setup.py (still) uses distutils rather than the recommended setuptools, you may need extra steps:

  • distutils only supports the very minimum of compiler setups. The sections in this guide corresponding to them explicitly mention distutils.

  • For other setups, you need to run the compilation from the "SDK prompt" of the corresponding toolchain and set the DISTUTILS_USE_SDK environment variable to a non-empty value.

Compilers Installation and configuration

Compatible architectures are specified for each compiler in brackets.

/!\ Before do anything, install or upgrade the Setuptools Python package. It contain compatibility improvements and add automatic use of compilers: 

pip install --upgrade setuptools

Microsoft Visual C++ 14.0 standalone: Build Tools for Visual Studio 2017 (x86, x64, ARM, ARM64)

This is a standalone version of Visual C++ 14.0 compiler, you don't need to install Visual Studio 2017.

Microsoft Visual C++ 14.0 with Visual Studio 2017 (x86, x64, ARM, ARM64)

Visual Studio 2017 contains Visual C++ 14.0 compiler. The setuptools Python package version must be at least 34.4.0.

Microsoft Visual C++ 14.0 standalone: Visual C++ Build Tools 2015 (x86, x64, ARM)

This is a standalone version of Visual C++ 14.0 compiler, you don't need to install Visual Studio 2015.

/!\ Visual C++ Build Tools 2015 was upgraded by Microsoft to Build Tools for Visual Studio 2017. See the previous paragraph to install it.

Microsoft Visual C++ 14.0 with Visual Studio 2015 (x86, x64, ARM)

Visual Studio 2015 contains Visual C++ 14.0 compiler. Distutils will automatically detect the compiler and use it.

Microsoft Visual C++ 10.0 standalone: Windows SDK 7.1 (x86, x64, ia64)

This is a standalone version of Visual C++ 10.0 compiler, you don't need to install Visual Studio 2010.

Microsoft Visual C++ 10.0 with Visual Studio 2010 (x86, x64, ia64)

Visual Studio 2010 contains Visual C++ 10.0 compiler. Distutils will automatically detect the compiler and use it. The Express edition of Visual Studio 2010 only bundles a compiler for x86.

Microsoft Visual C++ 9.0 standalone: Visual C++ Compiler for Python 2.7 (x86, x64)

This is a standalone version of Visual C++ 9.0 compiler, you don't need to install Visual Studio 2008.

{i} Even though this package's name refers to Python 2.7 specifically, you can use it with all Python versions that use Visual C++ 9.0.

{i} This package always installs its start menu shortcuts for the installing user (i.e. an administrator) only. To get them for all users, run the installation like this: msiexec /i <full path to .msi> ALLUSERS=1.

Microsoft Visual C++ 9.0 standalone: Windows SDK 7.0 (x86, x64, ia64)

This is a standalone version of Visual C++ 9.0 compiler, you don't need to install Visual Studio 2008.

/!\ The use of Microsoft Visual C++ Compiler for Python 2.7 is recommended (If you don't need to compile for ia64). See the previous paragraph to install it.

Microsoft Visual C++ 9.0 standalone: Windows SDK 6.1 (x86, x64, ia64)

This is a standalone version of Visual C++ 9.0 compiler, you don't need to install Visual Studio 2008.

/!\ Windows SDK 6.1 was upgraded by Microsoft to Windows SDK 7.0. See the previous paragraph to install it.

Microsoft Visual C++ 9.0 with Visual Studio 2008 (x86, x64, ia64)

Visual Studio 2008 contains Visual C++ 9.0 compiler. Distutils will automatically detect the compiler and use it. The Express edition of Visual Studio 2008 only bundles a compiler for x86.

GCC - MinGW-w64 (x86, x64)

MinGW-w64 is an alternative C/C++ compiler that works with all Python versions up to 3.4.

  • Install Win-builds into C:\MinGW_w64.

  • Open Win-builds, switch to install at least binutils, gcc, gcc-g++, getext, mingw-w64, win-iconv, winpthreads, zlib, and click Process.

  • Add C:\MinGW_w64\bin to the PATH environment variable.

  • Create a distutils.cfg file with the following contents in the folder \Lib\distutils in Python install directory : 

   1 [build]
   2 compiler=mingw32
   3 
   4 [build_ext]
   5 compiler=mingw32

GCC - MinGW (x86)

MinGW is an alternative C/C++ compiler that works with all Python versions up to 3.4.

  • Install Minimalist GNU For Windows into C:\MinGW.

  • Open MinGW Installation Manager, check mingw32-base and mingw32-gcc-g++, and Apply Changes in the Installation menu.

  • Add C:\MinGW\bin to the PATH environment variable.

  • Create a distutils.cfg file with the following contents in the folder \Lib\distutils in Python install directory : 

   1 [build]
   2 compiler=mingw32
   3 
   4 [build_ext]
   5 compiler=mingw32

WindowsCompilers (last edited 2023-06-09 12:03:05 by MarcAndreLemburg)

Unable to edit the page? See the FrontPage for instructions.