associação pythonbrasil[11] django zope/plone planet Início Logado como (Entrar)

Diferenças para "PythonBugDay/ComoSePreparar"

Diferenças entre as versões de 5 e 9 (4 versões de distância)
Revisão 5e 2008-05-03 01:46:46
Tamanho: 3363
Comentário:
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: Linha 1:
== Mac == == Dicas Gerais ==
Linha 3: 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: Linha 5:
 Caso não esteja instalado, eles estão no CD ou DVD do SO.   - 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 [[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.
Linha 9: Linha 37:
 Para verificar se os programas estão instalados, execute os comandos: 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, significa 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.
Linha 22: Linha 49:
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
}}}
Linha 23: Linha 54:
=== Baixando os fontes ===
 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 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 30: Linha 56:
 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 diretório onde foi executado o comando.
Linha 38: Linha 59:
 Bom agora já está fácil! Basta entrar no diretório '''trunk''' ou '''py3k''' e executar: 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 45: Linha 66:
 Para rodar o seu novo interpretador basta execeutar: Para rodar o seu novo interpretador basta execeutar:
{{{
./python
}}}

 Ou, no Mac,
Linha 50: Linha 76:
Para rodar os testes, execute
{{{
./python[.exe] Lib/test/regrtest.py
}}}
Linha 51: Linha 81:
== Win == == Windows ==
Linha 53: Linha 83:
 Diferente do Mac o Windows não traz quase nada de útil! :-) Diferente do Mac o Windows não traz quase nada de útil! :-)
Linha 55: Linha 85:
 
Linha 58: Linha 87:
Instalar [http://subversion.tigris.org/ Subversion], baixe o instalador em 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 62: 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 79: Linha 108:
 Crie uma pasta sem pontos e nem espaços em todo o nome, por exemplo '''c:\pysrc''' Crie uma pasta sem pontos e nem espaços em todo o nome, por exemplo '''c:\pysrc'''
Linha 81: Linha 110:
 Pelo prompt do DOS, vá para esse diretório '''cd c:\pysrc''' Pelo prompt do DOS, vá para esse diretório '''cd c:\pysrc'''
Linha 83: 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 89: 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 110: 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
}}}

Dicas Gerais

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

- 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