This document is for an old version of Python that is no longer supported. You should upgrade and read the documentação do Python para versão estável atual.

# 3. Utilizando Python no Windows

Este documento pretende dar uma visão geral do comportamento específico do Windows que você deve conhecer quando fores utilizar o Python no sistema operacional Microsoft Windows.

## 3.1. Installing Python

Unlike most Unix systems and services, Windows does not require Python natively and thus does not pre-install a version of Python. However, the CPython team has compiled Windows installers (MSI packages) with every release for many years.

Com o desenvolvimento do Python em andamento, algumas plataformas que costumavam ser suportadas anteriormente não são mais suportadas (devido à falta de usuário ou desenvolvedores). Confira a PEP 11 para detalhes de todas as plataformas não suportadas.

- DOS and Windows 3.x are deprecated since Python 2.0 and code specific to these systems was removed in Python 2.1.

- Up to 2.5, Python was still compatible with Windows 95, 98 and ME (but already raised a deprecation warning on installation). For Python 2.6 (and all following releases), this support was dropped and new releases are just expected to work on the Windows NT family.

- Windows CE ainda é suportado.

- O instalador Cygwin também oferece instalação do interpretador do Python (cf. Cygwin package source, Maintainer releases)

See Python for Windows (and DOS) for detailed information about platforms with precompiled installers.

Ver também

Python on XP

  “7 Minutes to “Hello World!”” by Richard Dooling, 2006

Installing on Windows

  in “Dive into Python: Python from novice to pro” by Mark Pilgrim, 2004, ISBN 1-59059-356-1

For Windows users

  in “Installing Python” in “A Byte of Python” by Swaroop C H, 2003

## 3.2. Pacotes Alternativos

À parte da distribuição padrão CPython, existem pacotes modificados incluindo funcionalidades adicionais. A seguir está uma lista de versões populares e seus recursos chave:

ActivePython

  Instalador com compatibilidade multi-plataforma, documentação, PyWin32

Enthought Python Distribution

  Popular modules (such as PyWin32) with their respective documentation, tool suite for building extensible Python applications

Notice that these packages are likely to install older versions of Python.

## 3.3. Configurando o Python

In order to run Python flawlessly, you might have to change certain environment settings in Windows.

### 3.3.1. Excursus: Configurando variáveis de ambiente

Windows has a built-in dialog for changing environment variables (following guide applies to XP classical view): Right-click the icon for your machine (usually located on your Desktop and called “My Computer”) and choose Properties there. Then, open the Advanced tab and click the Environment Variables button.

In short, your path is:

> My Computer ‣ Properties ‣ Advanced ‣ Environment Variables

In this dialog, you can add or modify User and System variables. To change System variables, you need non-restricted access to your machine (i.e. Administrator rights).

Another way of adding variables to your environment is using the set command:

    set PYTHONPATH=%PYTHONPATH%;C:\My_python_lib

To make this setting permanent, you could add the corresponding command line to your `autoexec.bat`. msconfig is a graphical interface to this file.

Viewing environment variables can also be done more straight-forward: The command prompt will expand strings wrapped into percent signs automatically:

    echo %PATH%

Consult set /? for details on this behaviour.

Ver também

https://support.microsoft.com/kb/100843

  Variáveis de ambiente no Windows NT

https://support.microsoft.com/kb/310519

  Como Gerenciar Variáveis de Ambiente no Windows XP

https://www.chem.gla.ac.uk/~louis/software/faq/q1.html

  Configurando variáveis de ambiente, Louis J. Farrugia

### 3.3.2. Encontrando o executável do Python

Besides using the automatically created start menu entry for the Python interpreter, you might want to start Python in the DOS prompt. To make this work, you need to set your `%PATH%` environment variable to include the directory of your Python distribution, delimited by a semicolon from other entries. An example variable could look like this (assuming the first two entries are Windows’ default):

    C:\WINDOWS\system32;C:\WINDOWS;C:\Python25

Typing python on your command prompt will now fire up the Python interpreter. Thus, you can also execute your scripts with command line options, see Linha de comando documentation.

### 3.3.3. Encontrando módulos

O Python geralmente armazena sua biblioteca (e assim sua pasta de site-packages) no diretório de instalação. Então, se você instalou o Python em `C:\Python\`, a biblioteca padrão irá residir em `C:\Python\Lib\` e módulos de terceiros serão armazenados em `C:\Python\Lib\site-packages\`.

This is how `sys.path` is populated on Windows:

- Uma entrada em branco é adicionada ao início, que corresponde ao diretório atual.

- Se a variável de ambiente `PYTHONPATH` existe, como descrito em Environment variables, suas entradas são adicionadas em seguida. Note que no Windows, caminhos nessa variável devem ser separados por ponto e vírgula, para distinguir eles dos dois pontos usados nos identificadores de drivers (`C:\` etc.).

- “Caminhos da aplicação” adicionais podem ser adicionados ao registro como subchaves de `\SOFTWARE\Python\PythonCore{version}\PythonPath` sob ambas `HKEY_CURRENT_USER` e `HKEY_LOCAL_MACHINE`. Subchaves que possuem string de caminhos delimitados por ponto e vírgula como seu valor padrão farão com que cada caminho seja adicionado ao `sys.path`. (Note que todos os instaladores conhecidos usam apenas HKLM, portanto HKCU está tipicamente vazio.)

- If the environment variable `PYTHONHOME` is set, it is assumed as “Python Home”. Otherwise, the path of the main Python executable is used to locate a “landmark file” (`Lib\os.py`) to deduce the “Python Home”. If a Python home is found, the relevant sub-directories added to `sys.path` (`Lib`, `plat-win`, etc) are based on that folder. Otherwise, the core Python path is constructed from the PythonPath stored in the registry.

- Se o Python Home não puder ser localizado, nenhum `PYTHONPATH` está especificado no ambiente, e nenhuma entrada de registro pôde ser encontrada, um caminho padrão com entradas relativas é usado (por exemplo, `.\Lib;.\plat-win`, etc).

O resultado final de tudo isso é:

- Quando executando `python.exe`, ou qualquer outro .exe no diretório principal do Python (ou uma versão instalada, ou diretamente do diretório PCbuild), o caminho núcleo é deduzido, e os caminhos núcleo no registro são ignorados. Outros “caminhos da aplicação” no registro são sempre lidos.

- Quando Python é hospedado em outro .exe (diretório diferente, embutido via COM, etc), o “Python Home” não será deduzido, então o caminho núcleo do registro é usado. Outros “caminhos da aplicação” no registro sempre são lidos.

- If Python can’t find its home and there is no registry (eg, frozen .exe, some very strange installation setup) you get a path with some default, but relative, paths.

### 3.3.4. Executing scripts

Python scripts (files with the extension `.py`) will be executed by python.exe by default. This executable opens a terminal, which stays open even if the program uses a GUI. If you do not want this to happen, use the extension `.pyw` which will cause the script to be executed by pythonw.exe by default (both executables are located in the top-level of your Python installation directory). This suppresses the terminal window on startup.

You can also make all `.py` scripts execute with pythonw.exe, setting this through the usual facilities, for example (might require administrative rights):

1. Launch a command prompt.

2. Associate the correct file group with `.py` scripts:

       assoc .py=Python.File

3. Redirect all Python files to the new executable:

       ftype Python.File=C:\Path\to\pythonw.exe "%1" %*

## 3.4. Módulos adicionais

Mesmo que o Python tenha como objetivo ser portável através de todas as plataformas, existem recursos que são únicos para o Windows. Alguns módulos, em ambas as bibliotecas padrão e externa, e trechos de código existem para usar esses recursos.

Os módulos padrão específicos para Windows estão documentados em Serviços Específicos do MS Windows.

### 3.4.1. PyWin32

O módulo PyWin32 de Mark Hammond é uma coleção de módulos para suporte avançado específico para Windows. Isso inclui utilitários para:

- Component Object Model (COM)

- Chamadas à API Win32

- Registro

- Log de Eventos

- Microsoft Foundation Classes (MFC) interface de usuário

PythonWin é uma aplicação MFC de exemplo enviada com o PyWin32. É uma IDE embutível com um depurador embutido.

Ver também

Win32 How Do I…?

  por Tim Golden

Python and COM

  by David and Paul Boddie

### 3.4.2. Py2exe

Py2exe is a `distutils` extension (see Estendendo Distutils) which wraps Python scripts into executable Windows programs (`*.exe` files). When you have done this, you can distribute your application without requiring your users to install Python.

### 3.4.3. WConio

Dado que a camada de manipulação de terminal avançada do Python, `curses`, é restrita a sistemas tipo Unix, existe uma biblioteca exclusiva para o Windows: Windows Console I/O para Python.

WConio é um encapsulador para o `CONIO.H` do Turbo-C usado para criar texto sob interfaces de usuário.

## 3.5. Compilando Python no Windows

If you want to compile CPython yourself, first thing you should do is get the source. You can download either the latest release’s source or just grab a fresh checkout.

For Microsoft Visual C++, which is the compiler with which official Python releases are built, the source tree contains solutions/project files. View the `readme.txt` in their respective directories:

Directory | MSVC version | Visual Studio version
--- | --- | ---
`PC/VC6/` | 6.0 | 97
`PC/VS7.1/` | 7.1 | 2003
`PC/VS8.0/` | 8.0 | 2005
`PCbuild/` | 9.0 | 2008

Note that not all of these build directories are fully supported. Read the release notes to see which compiler version the official releases for your version are built with.

Check `PC/readme.txt` for general information on the build process.

Para módulos de extensão, consulte Construindo Extensões C e C++ no Windows.

Ver também

Python + Windows + distutils + SWIG + gcc MinGW

  ou “Creating Python extensions in C/C++ with SWIG and compiling them with MinGW gcc under Windows” ou “Installing Python extension with distutils and without Microsoft Visual C++” por Sébastien Sauvage, 2003

MingW – Python extensions

  by Trent Apted et al, 2007

## 3.6. Other resources

Ver também

Python Programming On Win32

  “Help for Windows Programmers” by Mark Hammond and Andy Robinson, O’Reilly Media, 2000, ISBN 1-56592-621-8

A Python for Windows Tutorial

  by Amanda Birmingham, 2004