Diferenças para "PythonBugDay/ComoSePreparar"

Diferenças entre as versões de 3 e 9 (6 versões de distância)

Dicas Gerais

- Leia http://wiki.python.org/moin/PythonBugDay !

- Lá há vários links de outras coisas que precisam ser lidas, incluindo o excelente educating new contributors: http://www.cs.ubc.ca/~drifty/pycon/sprint_tutorial.pdf

- Crie uma conta no issue tracker: http://bugs.python.org

- Identifique bugs fáceis de antemão (procure pela keyword "easy")
- - Procure escolher pelo menos 3 tickets interessantes e adicioná-los aos seus bookmarks. Assim, quando chegar o "Dia D" você já vai saber por onde começar.

- Instale um cliente IRC (por exemplo, xchat para Linux, mirc para Windows ou Colloquy para Mac) e, no dia do Bug Day, conecte-se na rede irc.freenode.net, canais #python, #python-br e #python-dev

Baixando os fontes

Se você não tem o svn instalado, leia as instruções para o seu sistema operacional mais abaixo.

Para baixar a versão 2.6 do Python utilize o seguinte comando:

svn co http://svn.python.org/projects/python/trunk python_trunk

Isso irá criar o diretório python_trunk no diretório onde foi executado o comando.

Para baixar a versão 3.0 do Python utilize o seguinte comando:

svn co http://svn.python.org/projects/python/branches/py3k

Isso irá gerar o diretório py3k no diretório onde foi executado o comando.

Preparando o Linux e/ou o MacOS

Normalmente tanto o Linux quanto o Mac já vêm com as ferramentas necessárias para trabalhar com códigos (svn, gcc, vim, etc...). Caso algum não esteja instalado, eles estão no CD ou DVD do SO, ou disponíveis nos repositórios de softwares.

Verificando as ferramentas básicas

Para verificar se os programas estão instalados, execute os comandos em um terminal:

svn --version
gcc --version
make --version

Se aparecer alguma mensagem como a abaixo, significa que você não tem o programa instalado e será necessário instalá-lo:

gcc: command not found

Em uma distribuição Linux derivada da Debian (como o Ubuntu, por exemplo), você pode instalar estes programas com:

sudo apt-get install subversion gcc make

Para instalar estas ferramentas no Mac é preciso instalar o XCode, que já vem no DVD de instalação do Mac OS X. Se você não possuir um DVD de instalação à mão, é possível baixar o XCode no próprio site da Apple. Lembre-se que, apesar de gratuito, o download é enorme (1.1 GB para a versão 3.0) e requer cadastro.

Configurando e compilando

Bom agora já está fácil! Baixe o código dos repositórios (conforme explicado acima). Em seguida, basta entrar no diretório trunk ou py3k e executar:

./configure && make

Isso irá compilar o Python na respectiva versão.

Para rodar o seu novo interpretador basta execeutar:

./python

Ou, no Mac,

./python.exe

Para rodar os testes, execute

./python[.exe] Lib/test/regrtest.py

Windows

Diferente do Mac o Windows não traz quase nada de útil!

Instalando as ferramentas básicas.

Instalar Subversion, baixe o instalador em http://subversion.tigris.org/files/documents/15/41687/svn-1.4.6-setup.exe

Basta seguir o instalador.

Instalar o Visual C++ Express Edition 2008.

Basta seguir o instalador, não precisa instalar o SQL nem o MSDN, como sugerido no instalador. E aguarde sentado, pois isso consome 1.1 GB no disco que será devidamente baixado durante a intalação.

Para verificar se o svn está instalado e funcionando, execute:

svn --version

Se aparecer alguma mensagem como a abaixo, significa que você não tem o programa instalado e será necessário instalá-lo:

svn: command not found

Baixando os fontes

Crie uma pasta sem pontos e nem espaços em todo o nome, por exemplo c:\pysrc

Pelo prompt do DOS, vá para esse diretório cd c:\pysrc

Para baixar a versão 2.6 do Python utilize o seguinte comando:

svn co http://svn.python.org/projects/python/trunk

Isso irá criar o diretório trunk no diretório onde foi executado o comando.

Para baixar a versão 3k do Python utilize o seguinte comando:

svn co http://svn.python.org/projects/python/branches/py3k

Isso irá gerar o diretório py3k no local onde foi executado o comando.

Compilando

Agora para compilar, abra o Microsoft Visual C++ 2008 Express Edition e vá em File >> Open >>> Project/Solution.

Abra o arquivo: C:\pysrc\trunk\PCbuild\python.vcproj ou C:\pysrc\py3k\PCbuild\python.vcproj
Depois de abrir os projetos basta teclar [F7].

Isso irá compilar o Python na respectiva versão.

Para rodar o seu novo interpretador basta executar o arquivo:

C:\pysrc\trunk\PCbuild\python_d.exe

Trabalhando com patch

Aplicando um patch

Execute na pasta 'trunk' ou 'py3k'
patch -p0 < nome_do_patch.diff
em seguida compile novamente

Revertendo um patch

Execute o comando abaixo na pasta que aplicou o patch
svn revert -R .

Criando um patch

Execute:
svn diff > nome_do_patch.diff

-  ⇤ ← Revisão  3e 2008-05-02 22:13:36 → 
  Tamanho: 3313
  Editor: LucianoPacheco
  Comentário: agora também para Windows :)
+   ← Revisão  9e 2008-09-26 14:07:11 → ⇥
  Tamanho: 5784
  Editor: localhost
  Comentário: converted to 1.6 markup
-Deleções são marcadas assim.
+Adições são marcadas assim.
 Linha 1:
-== Mac ==
+== Dicas Gerais ==
 Linha 3:
- Normalmente o Mac já vem com as ferramentas necessárias para trabalhar com códigos (svn, gcc, vim, etc...)
+- Leia http://wiki.python.org/moin/PythonBugDay !
 Linha 5:
- Caso não esteja instalado tem no CD ou DVD do SO tem e é só instalar.
+  - Lá há vários links de outras coisas que precisam ser lidas, incluindo o excelente ''educating new contributors'': http://www.cs.ubc.ca/~drifty/pycon/sprint_tutorial.pdf
 Linha 7:
-=== Verificando as ferramentas básicas. ===
+- Crie uma conta no issue tracker: http://bugs.python.org
 Linha 9:
- Para verificar se or programas estão instalados:
+ - Identifique bugs fáceis de antemão (procure pela [[http://bugs.python.org/issue?%40search_text=&title=&%40columns=title&id=&%40columns=id&creation=&creator=&activity=&%40columns=activity&%40sort=activity&actor=&nosy=&type=&components=&versions=&dependencies=&assignee=&keywords=6&priority=&%40group=priority&status=1&%40columns=status&resolution=&%40pagesize=50&%40startwith=0&%40queryname=&%40old-queryname=&%40action=search|keyword "easy"]])
  - Procure escolher pelo menos 3 tickets interessantes e adicioná-los aos seus bookmarks. Assim, quando chegar o "Dia D" você já vai saber por onde começar.

- Instale um cliente IRC (por exemplo, xchat para Linux, mirc para Windows ou Colloquy para Mac) e, no dia do Bug Day, conecte-se na rede irc.freenode.net, canais #python, #python-br e #python-dev

== Baixando os fontes ==

Se você não tem o svn instalado, leia as instruções para o seu sistema operacional mais abaixo.

Para baixar a versão '''2.6''' do Python utilize o seguinte comando:
{{{
svn co http://svn.python.org/projects/python/trunk python_trunk
}}}
 Isso irá criar o diretório '''python_trunk''' no diretório onde foi executado o comando.

Para baixar a versão '''3.0''' do Python utilize o seguinte comando:
{{{
svn co http://svn.python.org/projects/python/branches/py3k
}}}
 Isso irá gerar o diretório '''py3k''' no diretório onde foi executado o comando.


== Preparando o Linux e/ou o MacOS ==

Normalmente tanto o Linux quanto o Mac já vêm com as ferramentas necessárias para trabalhar com códigos (svn, gcc, vim, etc...). Caso algum não esteja instalado, eles estão no CD ou DVD do SO, ou disponíveis nos repositórios de softwares.

=== Verificando as ferramentas básicas ===

Para verificar se os programas estão instalados, execute os comandos em um terminal:
-Linha 16:
+Linha 44:
- Se aparecer alguma mensagem como a abaixo, quer dizer que você não tem o programa instalado e será necessário instalá-lo:
+Se aparecer alguma mensagem como a abaixo, significa que você não tem o programa instalado e será necessário instalá-lo:
-Linha 20:
+Linha 48:
- Não irei cobrir a instalação desses programas.
+Em uma distribuição Linux derivada da Debian (como o Ubuntu, por exemplo), você pode instalar estes programas com:
{{{
sudo apt-get install subversion gcc make
}}}

Para instalar estas ferramentas no Mac é preciso instalar o XCode, que já vem no DVD de instalação do Mac OS X. Se você não possuir um DVD de instalação à mão, é possível baixar o XCode no próprio [[http://developer.apple.com/tools/download/|site da Apple]]. Lembre-se que, apesar de gratuito, o download é enorme (1.1 GB para a versão 3.0) e requer cadastro.
-Linha 23:
+Linha 57:
-=== Baixando os fontes ===
 Para baixar a versão '''2.6''' do Python utilize o seguinte comando:
+=== Configurando e compilando ===

Bom agora já está fácil! Baixe o código dos repositórios (conforme explicado acima). Em seguida, basta entrar no diretório '''trunk''' ou '''py3k''' e executar:
-Linha 26:
+Linha 61:
-svn co http://svn.python.org/projects/python/trunk
}}}
 Isso irá criar o diretório '''trunk''' no diretório onde foi executado o comando.

 Para baixar a versão '''3k''' do Python utilize o seguinte comando:
{{{
svn co http://svn.python.org/python/branches/py3k
}}}
 Isso irá gerar o diretório '''py3k''' no diretório onde foi executado o comando.

=== Configurando e Compilando ===

 Bom agora já tá fácil! Basta entrar no diretório '''trunk''' ou '''py3k''' e executar:
{{{
./configure
make
+./configure && make
-Linha 46:
+Linha 66:
- Para rodar o seu novo interpretador bastas:
+Para rodar o seu novo interpretador basta execeutar:
{{{
./python
}}}

 Ou, no Mac,
-Linha 51:
+Linha 76:
+Para rodar os testes, execute
{{{
./python[.exe] Lib/test/regrtest.py
}}}
-Linha 52:
+Linha 81:
-== Win ==
+== Windows ==
-Linha 54:
+Linha 83:
- Diferente do Mac o Windows não trás quase nada de útil! :)
+Diferente do Mac o Windows não traz quase nada de útil! :-)
-Linha 56:
+Linha 85:
-Linha 59:
+Linha 87:
-Instalar [http://subversion.tigris.org/ Subversion], baixe o instalador http://subversion.tigris.org/files/documents/15/41687/svn-1.4.6-setup.exe
+Instalar [[http://subversion.tigris.org/|Subversion]], baixe o instalador em http://subversion.tigris.org/files/documents/15/41687/svn-1.4.6-setup.exe
-Linha 63:
+Linha 91:
-Instalar o [http://www.microsoft.com/express/download/ Visual C++ Express Edition 2008].
+Instalar o [[http://www.microsoft.com/express/download/|Visual C++ Express Edition 2008]].
-Linha 65:
+Linha 93:
-Basta seguir o instalador, não precisa instalar o SQL nem o MSDN, como sugerido no instalador. E aguarde sentado, pois isso consome 1.1Gb no disco que será devidamente baixado durante a intalação.
+Basta seguir o instalador, não precisa instalar o SQL nem o MSDN, como sugerido no instalador. E aguarde sentado, pois isso consome 1.1 GB no disco que será devidamente baixado durante a intalação.
-Linha 68:
+Linha 96:
-Para verificar se o svn está instalado e funcionando.
+Para verificar se o svn está instalado e funcionando, execute:
-Linha 73:
+Linha 101:
- Se aparecer alguma mensagem como a abaixo, quer dizer que você não tem o programa instalado e será necessário instalá-lo:
+ Se aparecer alguma mensagem como a abaixo, significa que você não tem o programa instalado e será necessário instalá-lo:
-Linha 80:
+Linha 108:
- Crie uma pasta sem pontos e nem espaços em todo o nome, por exmpelo '''c:\pysrc'''
+Crie uma pasta sem pontos e nem espaços em todo o nome, por exemplo '''c:\pysrc'''
-Linha 82:
+Linha 110:
- Pelo prompt do DOS, vá para essa pasta '''cd c:\pysrc'''
+Pelo prompt do DOS, vá para esse diretório '''cd c:\pysrc'''
-Linha 84:
+Linha 112:
- Para baixar a versão '''2.6''' do Python utilize o seguinte comando:
+Para baixar a versão '''2.6''' do Python utilize o seguinte comando:
-Linha 90:
+Linha 118:
- Para baixar a versão '''3k''' do Python utilize o seguinte comando:
+Para baixar a versão '''3k''' do Python utilize o seguinte comando:
-Linha 92:
+Linha 120:
-svn co http://svn.python.org/python/branches/py3k
+svn co http://svn.python.org/projects/python/branches/py3k
-Linha 94:
+Linha 122:
- Isso irá gerar o diretório '''py3k''' no diretório onde foi executado o comando.
+ Isso irá gerar o diretório '''py3k''' no local onde foi executado o comando.
-Linha 98:
+Linha 126:
-Agora para compilar abra o Microsoft Visual C++ 2008 Express Edition e vá em '''''File >> Open >>> Project/Solution'''.
+Agora para compilar, abra o Microsoft Visual C++ 2008 Express Edition e vá em '''''File >> Open >>> Project/Solution'''.
-Linha 111:
+Linha 139:
+== Trabalhando com patch ==

=== Aplicando um patch ===

Execute na pasta 'trunk' ou 'py3k'
{{{
patch -p0 < nome_do_patch.diff
}}}

em seguida compile novamente

=== Revertendo um patch ===

Execute o comando abaixo na pasta que aplicou o patch
{{{
svn revert -R .
}}}

=== Criando um patch ===

Execute:
{{{
svn diff > nome_do_patch.diff
}}}

Veja também:

Diferenças para "PythonBugDay/ComoSePreparar"

Dicas Gerais

Baixando os fontes

Preparando o Linux e/ou o MacOS

Verificando as ferramentas básicas

Configurando e compilando

Windows

Instalando as ferramentas básicas.

Baixando os fontes

Compilando

Trabalhando com patch

Aplicando um patch

Revertendo um patch

Criando um patch