O que há de novo no Python 3.0¶
- Autor:
Guido van Rossum
Este artigo explica os novos recursos do Python 3.0, em comparação com o 2.6. O Python 3.0, também conhecido como “Python 3000” ou “Py3K”, é o primeiro lançamento do Python intencionalmente incompatível com versões anteriores. O Python 3.0 foi lançado em 3 de dezembro de 2008. Há mais mudanças do que em um lançamento típico, e mais que são importantes para todos os usuários do Python. No entanto, depois de digerir as mudanças, você verá que o Python realmente não mudou tanto assim – em geral, estamos principalmente corrigindo aborrecimentos bem conhecidos, e removendo muita sujeira antiga.
Este artigo não tenta fornecer uma especificação completa de todos os novos recursos, mas tenta dar uma visão geral conveniente. Para detalhes completos, você deve consultar a documentação do Python 3.0 e/ou as muitas PEPs referenciadas no texto. Se você quiser entender a implementação completa e a lógica de design para um recurso específico, as PEPs geralmente têm mais detalhes do que a documentação regular; mas observe que as PEPs geralmente não são mantidas atualizadas depois que um recurso foi totalmente implementado.
Devido a restrições de tempo, este documento não está tão completo quanto deveria ser. Como sempre para um novo lançamento, o arquivo Misc/NEWS
na distribuição fonte contém uma riqueza de informações detalhadas sobre cada pequena coisa que foi alterada.
Obstáculos comuns¶
Esta seção lista as poucas mudanças que provavelmente irão lhe atrapalhar se você estiver acostumado com o Python 2.5.
print é uma função¶
A instrução print
foi substituída por uma função print()
, com argumentos nomeados para substituir a maior parte da sintaxe especial da antiga instrução print
(PEP 3105). Exemplos:
Antigo: print "The answer is", 2*2
Novo: print("The answer is", 2*2)
Antigo: print x, # Vírgula no final suprime nova linha
Novo: print(x, end=" ") # Anexa um espaço em vez de uma nova linha
Antigo: print # Exibe uma nova linha
Novo: print() # Você precisa chamar a função!
Antigo: print >>sys.stderr, "fatal error"
Novo: print("fatal error", file=sys.stderr)
Antigo: print (x, y) # Exibe repr((x, y))
Novo: print((x, y)) # Não é o mesmo que print(x, y)!
Você também pode personalizar o separador entre itens, por exemplo:
print("Há <", 2**32, "> possibilidades!", sep="")
que produz:
Há <4294967296> possibilidades!
Nota:
A função
print()
não tem suporte ao recurso “softspace” da antiga instruçãoprint
. Por exemplo, no Python 2.x,print "A\n", "B"
escreveria"A\nB\n"
; mas no Python 3.0,print("A\n", "B")
escreve"A\n B\n"
.Inicialmente, você vai se pegar digitando o antigo
print x
bastante no modo interativo. É hora de treinar seus dedos para digitarprint(x)
em vez disso!Ao usar a ferramenta de conversão de fonte para fonte
2to3
, todas as instruçõesprint
são automaticamente convertidas em chamadas de funçãoprint()
, então isso geralmente não é um problema para projetos maiores.
Visualizações e iteradores em vez de listas¶
Algumas APIs conhecidas não retornam mais listas:
Os métodos
dict.keys()
,dict.items()
edict.values()
dedict
retornam visualizações, ou “views”, em vez de listas. Por exemplo, isso não funciona mais:k = d.keys(); k.sort()
. Usek = sorted(d)
em vez disso (isso funciona no Python 2.5 também e é igualmente eficiente).Also, the
dict.iterkeys()
,dict.iteritems()
anddict.itervalues()
methods are no longer supported.map()
efilter()
retornam iteradores. Se você realmente precisa de uma lista e as sequências de entrada são todas de comprimento igual, uma solução rápida é envolvermap()
emlist()
, por exemplo,list(map(...))
, mas uma solução melhor é frequentemente usar uma compreensão de lista (especialmente quando o código original usalambda
), ou reescrever o código para que ele não precise de uma lista. Particularmente complicado émap()
invocado para os efeitos colaterais da função; a transformação correta é usar um laçofor
regular (já que criar uma lista seria apenas desperdício).Se as sequências de entrada não tiverem o mesmo comprimento,
map()
irá parar no término da mais curta das sequências. Para compatibilidade total commap()
do Python 2.x, também envolva as sequências emitertools.zip_longest()
, por exemplo,map(func, *sequences)
se tornalist(map(func, itertools.zip_longest(*sequences)))
.range()
now behaves likexrange()
used to behave, except it works with values of arbitrary size. The latter no longer exists.zip()
agora retorna um iterador.
Comparações de ordenação¶
O Python 3.0 simplificou as regras para ordenar comparações:
Os operadores de comparação de ordenação (
<
,<=
,>=
,>
) levantam uma exceção TypeError quando os operandos não têm uma ordenação natural significativa. Assim, expressões como1 < ''
,0 > None
oulen <= len
não são mais válidas e, por exemplo,None < None
levantaTypeError
em vez de retornarFalse
. Um corolário é que classificar uma lista heterogênea não faz mais sentido – todos os elementos devem ser comparáveis entre si. Observe que isso não se aplica aos operadores==
e!=
: objetos de diferentes tipos incomparáveis sempre são comparados de forma diferente entre si.sorted()
andlist.sort()
no longer accept the cmp argument providing a comparison function. Use the key argument instead. N.B. the key and reverse arguments are now “keyword-only”.The
cmp()
function should be treated as gone, and the__cmp__()
special method is no longer supported. Use__lt__()
for sorting,__eq__()
with__hash__()
, and other rich comparisons as needed. (If you really need thecmp()
functionality, you could use the expression(a > b) - (a < b)
as the equivalent forcmp(a, b)
.)
Inteiros¶
PEP 237: Essentially,
long
renamed toint
. That is, there is only one built-in integral type, namedint
; but it behaves mostly like the oldlong
type.PEP 238: Uma expressão como
1/2
retorna um float. Use1//2
para obter o comportamento de truncamento. (A última sintaxe existe há anos, pelo menos desde o Python 2.2.)The
sys.maxint
constant was removed, since there is no longer a limit to the value of integers. However,sys.maxsize
can be used as an integer larger than any practical list or string index. It conforms to the implementation’s “natural” integer size and is typically the same assys.maxint
in previous releases on the same platform (assuming the same build options).O
repr()
de um inteiro longo não inclui mais oL
final, então o código que remove esse caractere incondicionalmente cortará o último dígito. (Usestr()
em vez disso.)Literais octais não estão mais no formato
0720
; em vez disso, use0o720
.
Texto vs. Dados em vez de Unicode vs. 8 bits¶
Tudo o que você achava que sabia sobre dados binários e Unicode mudou.
O Python 3.0 usa os conceitos de texto e dados (binários) em vez de strings Unicode e strings de 8 bits. Todo texto é Unicode; no entanto, o Unicode codificado é representado como dados binários. O tipo usado para armazenar texto é
str
, o tipo usado para armazenar dados ébytes
. A maior diferença com a situação 2.x é que qualquer tentativa de misturar texto e dados no Python 3.0 levantaTypeError
, enquanto que se você misturasse strings Unicode e de 8 bits no Python 2.x, funcionaria se a string de 8 bits contivesse apenas bytes de 7 bits (ASCII), mas você obteriaUnicodeDecodeError
se contivesse valores não ASCII. Esse comportamento específico de valor causou inúmeras caras tristes ao longo dos anos.As a consequence of this change in philosophy, pretty much all code that uses Unicode, encodings or binary data most likely has to change. The change is for the better, as in the 2.x world there were numerous bugs having to do with mixing encoded and unencoded text. To be prepared in Python 2.x, start using
unicode
for all unencoded text, andstr
for binary or encoded data only. Then the2to3
tool will do most of the work for you.Você não pode mais usar literais
u"..."
para texto Unicode. No entanto, você deve usar literaisb"..."
para dados binários.Como os tipos
str
ebytes
não podem ser misturados, você deve sempre converter explicitamente entre eles. Usestr.encode()
para ir destr
parabytes
, ebytes.decode()
para ir debytes
parastr
. Você também pode usarbytes(s, encoding=...)
estr(b, encoding=...)
, respectivamente.Like
str
, thebytes
type is immutable. There is a separate mutable type to hold buffered binary data,bytearray
. Nearly all APIs that acceptbytes
also acceptbytearray
. The mutable API is based oncollections.MutableSequence
.Todas as contrabarras em literais de strings brutas são interpretadas literalmente. Isso significa que os escapes
'\U'
e'\u'
em strings brutas não são tratados de forma especial. Por exemplo,r'\u20ac'
é uma string de 6 caracteres no Python 3.0, enquanto no 2.6,ur'\u20ac'
era o único caractere “euro”. (É claro que essa mudança afeta apenas literais de strings brutas; o caractere euro é'\u20ac'
no Python 3.0.)The built-in
basestring
abstract type was removed. Usestr
instead. Thestr
andbytes
types don’t have functionality enough in common to warrant a shared base class. The2to3
tool (see below) replaces every occurrence ofbasestring
withstr
.Arquivos abertos como arquivos texto (ainda o modo padrão para
open()
) sempre usam uma codificação para mapear entre strings (na memória) e bytes (no disco). Arquivos binários (abertos com umb
no argumento mode) sempre usam bytes na memória. Isso significa que se um arquivo for aberto usando um modo ou codificação incorretos, a E/S provavelmente falhará ruidosamente, em vez de produzir dados incorretos silenciosamente. Isso também significa que até mesmo usuários Unix terão que especificar o modo correto (texto ou binário) ao abrir um arquivo. Há uma codificação padrão dependente da plataforma, que em plataformas Unixy pode ser definida com a variável de ambienteLANG
(e às vezes também com algumas outras variáveis de ambiente relacionadas à localidade específicas da plataforma). Em muitos casos, mas não em todos, o padrão do sistema é UTF-8; você nunca deve contar com esse padrão. Qualquer aplicação que leia ou escreva mais do que texto ASCII puro provavelmente deve ter uma maneira de substituir a codificação. Não há mais necessidade de usar os fluxos com reconhecimento de codificação no módulocodecs
.Os valores iniciais de
sys.stdin
,sys.stdout
esys.stderr
agora são arquivos texto somente unicode (ou seja, são instâncias deio.TextIOBase
). Para ler e gravar dados de bytes com esses fluxos, você precisa usar o atributoio.TextIOBase.buffer
deles.Nomes de arquivo são passados e retornados de APIs como strings (Unicode). Isso pode apresentar problemas específicos de plataforma porque em algumas plataformas nomes de arquivo são strings de bytes arbitrárias. (Por outro lado, no Windows nomes de arquivo são armazenados nativamente como Unicode.) Como solução alternativa, a maioria das APIs (por exemplo,
open()
e muitas funções no móduloos
) que aceitam nomes de arquivo aceitam objetosbytes
assim como strings, e algumas APIs têm uma maneira de pedir um valor de retornobytes
. Assim,os.listdir()
retorna uma lista de instânciasbytes
se o argumento for uma instânciabytes
, eos.getcwdb()
retorna o diretório de trabalho atual como uma instânciabytes
. Observe que quandoos.listdir()
retorna uma lista de strings, os nomes de arquivos que não podem ser decodificados corretamente são omitidos em vez de levantarUnicodeError
.Algumas APIs de sistema como
os.environ
esys.argv
também podem apresentar problemas quando os bytes disponibilizados pelo sistema não são interpretáveis usando a codificação padrão. Definir a variávelLANG
e executar o programa novamente é provavelmente a melhor abordagem.PEP 3138: A
repr()
de uma string não escapa mais caracteres não-ASCII. No entanto, ele ainda escapa caracteres de controle e pontos de código com status não imprimível no padrão Unicode.PEP 3120: A codificação de fontes padrão agora é UTF-8.
PEP 3131: Letras não ASCII agora são permitidas em identificadores. (No entanto, a biblioteca padrão permanece somente ASCII, com exceção dos nomes dos colaboradores nos comentários.)
Os módulos
StringIO
ecStringIO
se foram. Em vez disso, importe o móduloio
e useio.StringIO
ouio.BytesIO
para texto e dados, respectivamente.Veja também o guia Unicode, que foi atualizado para o Python 3.0.
Visão geral das alterações da sintaxe¶
Esta seção fornece uma breve visão geral de cada mudança sintática no Python 3.0.
Nova sintaxe¶
PEP 3107: Function argument and return value annotations. This provides a standardized way of annotating a function’s parameters and return value. There are no semantics attached to such annotations except that they can be introspected at runtime using the
__annotations__
attribute. The intent is to encourage experimentation through metaclasses, decorators or frameworks.PEP 3102: Argumentos somente-nomeados. Parâmetros nomeados que ocorrem após
*args
na lista de parâmetros devem ser especificados usando a sintaxe dos nomes na chamada. Você também pode usar um*
simples na lista de parâmetros para indicar que não aceita uma lista de argumentos de comprimento variável, mas tem argumentos somente-nomeados.Argumentos nomeados são permitidos após a lista de classes base em uma definição de classe. Isso é usado pela nova convenção para especificar uma metaclasse (veja a próxima seção), mas pode ser usado para outros propósitos também, desde que a metaclasse dê suporte.
PEP 3104: instrução
nonlocal
. Usandononlocal x
, agora você pode atribuir diretamente a uma variável em um escopo externo (mas não global).nonlocal
é uma nova palavra reservada.PEP 3132: Desempacotamento iterável estendido. Agora você pode escrever coisas como
a, b, *rest = some_sequence
. E até mesmo*rest, a = stuff
. O objetorest
é sempre uma lista (possivelmente vazia); o lado direito pode ser qualquer iterável. Exemplo:(a, *rest, b) = range(5)
Isso define a como
0
, b como4
e rest como[1, 2, 3]
.Compreensões de dicionário:
{k: v for k, v in stuff}
significa a mesma coisa quedict(stuff)
, mas é mais flexível. (Isto é PEP 274 justificada. :-)Definir literais, por exemplo,
{1, 2}
. Note que{}
é um dicionário vazio; useset()
para um conjunto vazio. Compreensões de conjuntos também são suportadas; por exemplo,{x for x in stuff}
significa a mesma coisa queset(stuff)
, mas é mais flexível.Novos literais octais, por exemplo,
0o720
(já em 2.6). Os antigos literais octais (0720
) se foram.Novos literais binários, por exemplo,
0b1010
(já em 2.6), e há uma nova função embutida correspondente,bin()
.Literais de bytes são introduzidos com um
b
ouB
no início, e há uma nova função embutida correspondente,bytes()
.
Sintaxe alterada¶
PEP 3109 e PEP 3134: nova sintaxe da instrução
raise
:raise [expr [from expr]]
. Veja abaixo.as
ewith
agora são palavras reservadas. (Desde a versão 2.6, na verdade.)True
,False
eNone
são palavras reservadas. (A versão 2.6 já aplicava parcialmente as restrições emNone
.)Alteração de
except
exc, var paraexcept
excas
var. Veja a PEP 3110.PEP 3115: Nova sintaxe de metaclasse. Em vez de:
class C: __metaclass__ = M ...
agora você deve usar:
class C(metaclass=M): ...
The module-global
__metaclass__
variable is no longer supported. (It was a crutch to make it easier to default to new-style classes without deriving every class fromobject
.)As compreensões de lista não têm mais suporte a mais a forma sintática
[... for var in item1, item2, ...]
. Use[... for var in (item1, item2, ...)]
em vez disso. Observe também que as compreensões de lista têm semântica diferente: elas estão mais próximas do açúcar sintático para uma expressão geradora dentro de um construtorlist()
e, em particular, as variáveis de controle de laço não são mais vazadas para o escopo circundante.As reticências (
...
) podem ser usadas como uma expressão atômica em qualquer lugar. (Anteriormente, eram permitidas apenas em fatias.) Além disso, agora devem ser escritas como...
. (Anteriormente, também poderiam ser escritas como. . .
, por um mero acidente da gramática.)
Sintaxe removida¶
PEP 3113: Desempacotamento de parâmetro de tupla removido. Você não pode mais escrever
def foo(a, (b, c)): ...
. Em vez disso, usedef foo(a, b_c): b, c = b_c
.Removidos backticks (use
repr()
).Removido
<>
(use!=
).Removida palavra reservada:
exec()
não é mais uma palavra reservada; ela permanece como uma função. (Felizmente a sintaxe da função também era aceita nas versões 2.x.) Observe também queexec()
não aceita mais um argumento de fluxo; em vez deexec(f)
você pode usarexec(f.read())
.Literais de inteiro não mais têm suporte a um
l
ouL
final.Literais de string não mais têm suporte a um
u
ouU
no início.A sintaxe
from
móduloimport
*
é permitida somente no nível do módulo, não mais dentro de funções.A única sintaxe aceitável para importações relativas é
from .[module] import name
. Todos as formas deimport
que não começam com.
são interpretadas como importações absolutas. (PEP 328)As classes clássicas se foram.
Mudanças já presentes no Python 2.6¶
Como muitos usuários provavelmente fazem o salto direto do Python 2.5 para o Python 3.0, esta seção lembra o leitor dos novos recursos que foram originalmente projetados para o Python 3.0, mas que foram portados de volta para o Python 2.6. As seções correspondentes em O que há de novo no Python 2.6 devem ser consultadas para descrições mais longas.
PEP 343: The ‘with’ statement. A instrução
with
agora é um recurso padrão e não precisa mais ser importada de__future__
. Confira também Writing Context Managers e The contextlib module.PEP 366: Explicit Relative Imports From a Main Module. Isso aumenta a utilidade da opção
-m
quando o módulo referenciado reside em um pacote.PEP 3101: Advanced String Formatting. Nota: a descrição da versão 2.6 menciona o método
format()
para strings de 8 bits e Unicode. No 3.0, apenas o tipostr
(strings de texto com suporte a Unicode) tem suporte a esse método; o tipobytes
não. O plano é eventualmente tornar esta a única API para formatação de strings e começar a descontinuar o operador%
no Python 3.1.PEP 3105: print As a Function. Este é agora um recurso padrão e não precisa mais ser importado de
__future__
. Mais detalhes foram fornecidos acima.PEP 3110: Exception-Handling Changes. A sintaxe
except
excas
var agora é padrão eexcept
exc, var não é mais suportado. (Claro, a parteas
var ainda é opcional.)PEP 3112: Byte Literals. A notação de literal de string
b"..."
(e suas variantes comob'...'
,b"""..."""
ebr"..."
) agora produz um literal do tipobytes
.PEP 3116: New I/O Library. The
io
module is now the standard way of doing file I/O. The built-inopen()
function is now an alias forio.open()
and has additional keyword arguments encoding, errors, newline and closefd. Also note that an invalid mode argument now raisesValueError
, notIOError
. The binary file object underlying a text file object can be accessed asf.buffer
(but beware that the text object maintains a buffer of itself in order to speed up the encoding and decoding operations).PEP 3118: Revised Buffer Protocol. The old builtin
buffer()
is now really gone; the new builtinmemoryview()
provides (mostly) similar functionality.PEP 3119: Abstract Base Classes. The
abc
module and the ABCs defined in thecollections
module plays a somewhat more prominent role in the language now, and built-in collection types likedict
andlist
conform to thecollections.MutableMapping
andcollections.MutableSequence
ABCs, respectively.PEP 3127: Integer Literal Support and Syntax. Conforme mencionado acima, a nova notação de literal octal é a única suportada, e literais binários foram adicionados.
PEP 3141: A Type Hierarchy for Numbers. O módulo
numbers
é outro novo uso de ABCs, definindo a “torre numérica” do Python. Observe também o novo módulofractions
que implementanumbers.Rational
.
Mudanças na biblioteca¶
Devido a restrições de tempo, este documento não cobre exaustivamente as mudanças muito extensas na biblioteca padrão. PEP 3108 é a referência para as principais mudanças na biblioteca. Aqui está uma revisão resumida:
Muitos módulos antigos foram removidos. Alguns, como
gopherlib
(não mais usado) emd5
(substituído porhashlib
), já tinham sido descontinuados pela PEP 4. Outros foram removidos como resultado da remoção do suporte para várias plataformas, como Irix, BeOS e Mac OS 9 (veja PEP 11). Alguns módulos também foram selecionados para remoção no Python 3.0 devido à falta de uso ou porque existe uma substituição melhor. Veja PEP 3108 para uma lista exaustiva.O pacote
bsddb3
foi removido porque sua presença na biblioteca padrão principal provou ao longo do tempo ser um fardo particular para os desenvolvedores principais devido à instabilidade dos testes e ao cronograma de lançamento do Berkeley DB. No entanto, o pacote está vivo e bem, mantido externamente em https://www.jcea.es/programacion/pybsddb.htm.Alguns módulos foram renomeados porque seu nome antigo desobedecia a PEP 8, ou por vários outros motivos. Aqui está a lista:
Old Name
Novo nome
_winreg
winreg
ConfigParser
configparser
copy_reg
copyreg
Queue
queue
SocketServer
socketserver
markupbase
_markupbase
repr
reprlib
test.test_support
test.support
Um padrão comum no Python 2.x é ter uma versão de um módulo implementada em Python puro, com uma versão acelerada opcional implementada como uma extensão C; por exemplo,
pickle
ecPickle
. Isso coloca o fardo de importar a versão acelerada e recorrer à versão Python pura em cada usuário desses módulos. No Python 3.0, as versões aceleradas são consideradas detalhes de implementação das versões Python puras. Os usuários devem sempre importar a versão padrão, que tenta importar a versão acelerada e recorrer à versão Python pura. O parpickle
/cPickle
recebeu esse tratamento. O móduloprofile
está na lista para 3.1. O móduloStringIO
foi transformado em uma classe no móduloio
.Alguns módulos relacionados foram agrupados em pacotes e, geralmente, os nomes dos submódulos foram simplificados. Os novos pacotes resultantes são:
dbm
(anydbm
,dbhash
,dbm
,dumbdbm
,gdbm
,whichdb
).html
(HTMLParser
,htmlentitydefs
).http
(httplib
,BaseHTTPServer
,CGIHTTPServer
,SimpleHTTPServer
,Cookie
,cookielib
).tkinter
(allTkinter
-related modules exceptturtle
). The target audience ofturtle
doesn’t really care abouttkinter
. Also note that as of Python 2.6, the functionality ofturtle
has been greatly enhanced.urllib
(urllib
,urllib2
,urlparse
,robotparse
).xmlrpc
(xmlrpclib
,DocXMLRPCServer
,SimpleXMLRPCServer
).
Algumas outras mudanças nos módulos da biblioteca padrão, não cobertas pela PEP 3108:
sets
eliminado. Use a classe embutidaset()
.Cleanup of the
sys
module: removedsys.exitfunc()
,sys.exc_clear()
,sys.exc_type
,sys.exc_value
,sys.exc_traceback
. (Note thatsys.last_type
etc. remain.)Cleanup of the
array.array
type: theread()
andwrite()
methods are gone; usefromfile()
andtofile()
instead. Also, the'c'
typecode for array is gone – use either'b'
for bytes or'u'
for Unicode characters.Cleanup of the
operator
module: removedsequenceIncludes()
andisCallable()
.Limpeza do módulo
thread
:acquire_lock()
erelease_lock()
foram removidos; useacquire()
erelease()
em vez disso.Cleanup of the
random
module: removed thejumpahead()
API.O módulo
new
foi removido.The functions
os.tmpnam()
,os.tempnam()
andos.tmpfile()
have been removed in favor of thetempfile
module.O módulo
tokenize
foi alterado para funcionar com bytes. O ponto de entrada principal agora étokenize.tokenize()
, em vez de generate_tokens.string.letters
and its friends (string.lowercase
andstring.uppercase
) are gone. Usestring.ascii_letters
etc. instead. (The reason for the removal is thatstring.letters
and friends had locale-specific behavior, which is a bad idea for such attractively named global “constants”.)Renamed module
__builtin__
tobuiltins
(removing the underscores, adding an ‘s’). The__builtins__
variable found in most global namespaces is unchanged. To modify a builtin, you should usebuiltins
, not__builtins__
!
PEP 3101: Uma nova abordagem para formatação de strings¶
Um novo sistema para operações de formatação de strings embutidas substitui o operador de formatação de strings
%
. (No entanto, o operador%
ainda é suportado; ele será descontinuado no Python 3.1 e removido da linguagem em algum momento posterior.) Leia a PEP 3101 para obter informações completas.
Mudanças para exceções¶
As APIs para levantar e capturar exceções foram limpas e novos recursos poderosos foram adicionados:
PEP 352: Todas as exceções devem ser derivadas (direta ou indiretamente) de
BaseException
. Esta é a raiz da hierarquia de exceções. Isso não é novo como recomendação, mas o requisito para herdar deBaseException
é novo. (O Python 2.6 ainda permitia que classes clássicas fossem levantadas e não colocava nenhuma restrição sobre o que você pode capturar.) Como consequência, exceções de string estão finalmente verdadeira e completamente mortas.Quase todas as exceções devem derivar de
Exception
;BaseException
deve ser usado apenas como uma classe base para exceções que devem ser manipuladas apenas no nível superior, comoSystemExit
ouKeyboardInterrupt
. O idioma recomendado para manipular todas as exceções, exceto para esta última categoria, é usarexcept
Exception
.StandardError
was removed.Exceptions no longer behave as sequences. Use the
args
attribute instead.PEP 3109: levantando exceções. Agora você deve usar
raise Exception(args)
em vez deraise Exception, args
. Além disso, você não pode mais especificar explicitamente um traceback (situação da pilha de execução); em vez disso, se você precisar fazer isso, você pode atribuir diretamente ao atributo__traceback__
(veja abaixo).PEP 3110: Capturando exceções. Agora você deve usar
except SomeException as variable
em vez deexcept SomeException, variable
. Além disso, a variável variable é explicitamente excluída quando o blocoexcept
é deixado.PEP 3134: Encadeamento de exceções. Existem dois casos: encadeamento implícito e encadeamento explícito. O encadeamento implícito acontece quando uma exceção é levantada em um bloco manipulador
except
oufinally
. Isso geralmente acontece devido a um bug no bloco do manipulador; chamamos isso de exceção secundária. Nesse caso, a exceção original (que estava sendo manipulada) é salva como o atributo__context__
da exceção secundária. O encadeamento explícito é invocado com esta sintaxe:raise SecondaryException() from primary_exception
(onde primary_exception é qualquer expressão que produz um objeto de exceção, provavelmente uma exceção que foi capturada anteriormente). Neste caso, a exceção primária é armazenada no atributo
__cause__
da exceção secundária. O traceback impresso quando uma exceção não tratada ocorre percorre a cadeia de atributos__cause__
e__context__
e imprime um traceback separado para cada componente da cadeia, com a exceção primária no topo. (Usuários Java podem reconhecer este comportamento.)PEP 3134: Objetos exceção agora armazenam seu traceback como o atributo
__traceback__
. Isso significa que um objeto de exceção agora contém todas as informações pertencentes a uma exceção, e há menos motivos para usarsys.exc_info()
(embora o último não seja removido).Algumas mensagens de exceção estão melhores quando o Windows falha ao carregar um módulo de extensão. Por exemplo,
error code 193
agora é%1 is not a valid Win32 application
. As strings agora lidam com localidades que não sejam em inglês.
Outras mudanças diversas¶
Operadores e métodos especiais¶
!=
agora retorna o oposto de==
, a menos que==
retorneNotImplemented
.O conceito de “métodos não vinculados” foi removido da linguagem. Ao referenciar um método como um atributo de classe, agora você obtém um objeto função simples.
__getslice__()
,__setslice__()
and__delslice__()
were killed. The syntaxa[i:j]
now translates toa.__getitem__(slice(i, j))
(or__setitem__()
or__delitem__()
, when used as an assignment or deletion target, respectively).PEP 3114: o método padrão
next()
foi renomeado para__next__()
.The
__oct__()
and__hex__()
special methods are removed –oct()
andhex()
use__index__()
now to convert the argument to an integer.Removed support for
__members__
and__methods__
.Os atributos de função chamados
func_X
foram renomeados para usar o formato__X__
, liberando esses nomes no espaço de nomes de atributos de função para atributos definidos pelo usuário. A saber,func_closure
,func_code
,func_defaults
,func_dict
,func_doc
,func_globals
,func_name
foram renomeados para__closure__
,__code__
,__defaults__
,__dict__
,__doc__
,__globals__
,__name__
, respectivamente.__nonzero__()
agora é__bool__()
.
Funções embutidas¶
PEP 3135: Nova função
super()
. Agora você pode invocarsuper()
sem argumentos e (presumindo que isso esteja em um método de instância regular definido dentro de uma instruçãoclass
) a classe e instância corretas serão automaticamente escolhidas. Com argumentos, o comportamento desuper()
não é alterado.PEP 3111:
raw_input()
was renamed toinput()
. That is, the newinput()
function reads a line fromsys.stdin
and returns it with the trailing newline stripped. It raisesEOFError
if the input is terminated prematurely. To get the old behavior ofinput()
, useeval(input())
.Uma nova função embutido
next()
foi adicionada para chamar o método__next__()
em um objeto.A estratégia de arredondamento da função
round()
e o tipo de retorno foram alterados. Casos exatos de meio caminho agora são arredondados para o resultado par mais próximo em vez de para longe de zero. (Por exemplo,round(2.5)
agora retorna2
em vez de3
.)round(x[, n])
agora delega parax.__round__([n])
em vez de sempre retornar um float. Geralmente retorna um inteiro quando chamado com um único argumento e um valor do mesmo tipo quex
quando chamado com dois argumentos.Moved
intern()
tosys.intern()
.Removed:
apply()
. Instead ofapply(f, args)
usef(*args)
.Removed
callable()
. Instead ofcallable(f)
you can useisinstance(f, collections.Callable)
. Theoperator.isCallable()
function is also gone.Removed
coerce()
. This function no longer serves a purpose now that classic classes are gone.Removed
execfile()
. Instead ofexecfile(fn)
useexec(open(fn).read())
.Removed the
file
type. Useopen()
. There are now several different kinds of streams that open can return in theio
module.Removed
reduce()
. Usefunctools.reduce()
if you really need it; however, 99 percent of the time an explicitfor
loop is more readable.Removed
reload()
. Useimp.reload()
.Removed.
dict.has_key()
– use thein
operator instead.
Mudanças a construções e API C¶
Devido a restrições de tempo, aqui está uma lista muito incompleta de alterações na API C.
O suporte para várias plataformas foi descartado, incluindo, mas não se limitando a Mac OS 9, BeOS, RISCOS, Irix e Tru64.
PEP 3118: Nova API de Buffer.
PEP 3121: Inicialização e finalização do módulo de extensão.
PEP 3123: Tornando
PyObject_HEAD
conforme o padrão C.Não há mais suporte à API C para execução restrita.
As APIs C
PyNumber_Coerce()
,PyNumber_CoerceEx()
,PyMember_Get()
ePyMember_Set()
foram removidas.Nova API C
PyImport_ImportModuleNoBlock()
, funciona comoPyImport_ImportModule()
, mas não bloqueia na trava de importação (retornando um erro).Renomeado o slot e o método de nível C de conversão booleana:
nb_nonzero
agora énb_bool
.Removidas
METH_OLDARGS
eWITH_CYCLE_GC
da API C.
Desempenho¶
O resultado líquido das generalizações do 3.0 é que o Python 3.0 executa o benchmark pystone cerca de 10% mais lento que o Python 2.5. Provavelmente a maior causa é a remoção do uso de maiúsculas e minúsculas especiais para números inteiros pequenos. Há espaço para melhorias, mas isso acontecerá após o lançamento do 3.0!
Portando para o Python 3.0¶
Para portar o código-fonte existente do Python 2.5 ou 2.6 para o Python 3.0, a melhor estratégia é a seguinte:
(Pré-requisito:) Comece com uma excelente cobertura de teste.
Portar para o Python 2.6. Isso não deve dar mais trabalho do que o port médio do Python 2.x para o Python 2.(x+1). Certifique-se de que todos os seus testes passem.
(Ainda usando 2.6:) Ative a opção de linha de comando
-3
. Isso habilita avisos sobre recursos que serão removidos (ou alterados) no 3.0. Execute seu conjunto de testes novamente e corrija o código sobre o qual você recebe avisos até que não haja mais avisos e todos os seus testes ainda passem.Execute o tradutor de fonte para fonte
2to3
sobre sua árvore de código-fonte. (Veja 2to3 — Tradução Automatizada de Código Python 2 para 3 para mais informações sobre esta ferramenta.) Execute o resultado da tradução no Python 3.0. Corrija manualmente quaisquer problemas restantes, corrigindo os problemas até que todos os testes passem novamente.
Não é recomendado tentar escrever código-fonte que seja executado inalterado no Python 2.6 e 3.0; você teria que usar um estilo de codificação muito distorcido, por exemplo, evitando instruções print
, metaclasses e muito mais. Se você estiver mantendo uma biblioteca que precisa ter suporte ao Python 2.6 e Python 3.0, a melhor abordagem é modificar a etapa 3 acima editando a versão 2.6 do código-fonte e executando o tradutor 2to3
novamente, em vez de editar a versão 3.0 do código-fonte.
Para portar extensões C para Python 3.0, consulte Portando módulos de extensão para o Python 3.