O que há de novo no Python 3.8¶
- Editor:
Raymond Hettinger
Este artigo explica os novos recursos no Python 3.8, em comparação com 3.7. Python 3.8 foi lançado em 14 de outubro de 2019. Veja changelog para uma lista completa de mudanças.
Resumo – Destaques da versão¶
Novas funcionalidades¶
Expressões de atribuição¶
Existe uma nova sintaxe :=
que atribui valores a variáveis como parte de uma expressão maior. É carinhosamente conhecido como “o operador morsa” (“the walrus operator”, em inglês) devido à sua semelhança com os olhos e presas de uma morsa
Neste exemplo, a expressão de atribuição ajuda a evitar a chamada de len()
duas vezes:
if (n := len(a)) > 10:
print(f"List is too long ({n} elements, expected <= 10)")
Um benefício semelhante surge durante a correspondência de expressões regulares, onde os objetos de correspondência são necessários duas vezes, uma vez para testar se ocorreu uma correspondência e outra para extrair um subgrupo:
discount = 0.0
if (mo := re.search(r'(\d+)% discount', advertisement)):
discount = float(mo.group(1)) / 100.0
O operador também é útil com loops while que calculam um valor para testar a finalização do loop e, em seguida, precisam desse mesmo valor novamente no corpo do loop:
# Loop over fixed length blocks
while (block := f.read(256)) != '':
process(block)
Outro caso de uso motivador surge em compreensões de lista em que um valor calculado em uma condição de filtragem também é necessário no corpo da expressão:
[clean_name.title() for name in names
if (clean_name := normalize('NFC', name)) in allowed_names]
Tente limitar o uso do operador morsa para limpar os casos que reduzem a complexidade e melhoram a legibilidade.
Consulte PEP 572 para uma descrição completa.
(Contribuição de Emily Morehouse em bpo-35224.)
Parâmetros somente-posicionais¶
Existe uma nova sintaxe de parâmetro de função /
para indicar que alguns parâmetros de função devem ser especificados posicionalmente e não podem ser usados como argumentos nomeados. Esta é a mesma notação mostrada por help()
para funções C anotadas com a ferramenta Argument Clinic de Larry Hastings.
No exemplo a seguir, os parâmetros a e b são apenas posicionais, enquanto c ou d podem ser posicionais ou nomeados e e ou f são obrigatoriamente nomeados:
def f(a, b, /, c, d, *, e, f):
print(a, b, c, d, e, f)
A seguir, uma chamada válida:
f(10, 20, 30, d=40, e=50, f=60)
Porém, essas chamadas são inválidas:
f(10, b=20, c=30, d=40, e=50, f=60) # b cannot be a keyword argument
f(10, 20, 30, 40, 50, f=60) # e must be a keyword argument
Um caso de uso para essa notação é que ele permite que funções puras do Python emulem completamente os comportamentos das funções codificadas em C existentes. Por exemplo, a função embutida divmod()
não aceita argumentos nomeados:
def divmod(a, b, /):
"Emulate the built in divmod() function"
return (a // b, a % b)
Outro caso de uso é impedir argumentos nomeados quando o nome do parâmetro não for útil. Por exemplo, a função embutida len()
possui a assinatura len(obj, /)
. Isso exclui chamadas estranhas, como:
len(obj='hello') # The "obj" keyword argument impairs readability
Um benefício adicional de marcar um parâmetro como somente posicional é que ele permite que o nome do parâmetro seja alterado no futuro sem risco de quebrar o código do cliente. Por exemplo, no módulo statistics
, o nome do parâmetro dist pode ser alterado no futuro. Isso foi possível com a seguinte especificação de função:
def quantiles(dist, /, *, n=4, method='exclusive')
...
Como os parâmetros à esquerda de /
não são expostos como possíveis palavras-chave, os nomes dos parâmetros permanecem disponíveis para uso em **kwargs
:
>>> def f(a, b, /, **kwargs):
... print(a, b, kwargs)
...
>>> f(10, 20, a=1, b=2, c=3) # a and b are used in two ways
10 20 {'a': 1, 'b': 2, 'c': 3}
Isso simplifica bastante a implementação de funções e métodos que precisam aceitar argumentos nomeados arbitrários. Por exemplo, aqui está um trecho do código no módulo collections
:
class Counter(dict):
def __init__(self, iterable=None, /, **kwds):
# Note "iterable" is a possible keyword argument
Consulte a PEP 570 para uma descrição completa.
(Contribuição de Pablo Galindo em bpo-36540.)
Cache do sistema de arquivos paralelo para arquivos de bytecode compilados¶
A nova configuração PYTHONPYCACHEPREFIX
(também disponível como -X
pycache_prefix
) configura o cache implícito de bytecode para usar uma árvore paralela separada do sistema de arquivos, em vez dos subdiretórios padrão __pycache__
dentro cada diretório fonte.
O local do cache é relatado em sys.pycache_prefix
(None
indica o local padrão nos subdiretórios __pycache__
).
(Contribuição de Carl Meyer em bpo-33499.)
A compilação de depuração usa a mesma ABI da compilação de lançamento¶
Agora, o Python usa a mesma ABI, seja ele compilado no modo de lançamento ou depuração. No Unix, quando o Python é compilado no modo de depuração, agora é possível carregar extensões C compiladas no modo de lançamento e extensões C compiladas usando a ABI estável.
Compilações de lançamento e compilações de depuração agora são compatíveis com ABI: definir a macro Py_DEBUG
não implica mais a macro Py_TRACE_REFS
, que introduz a única incompatibilidade ABI. A macro Py_TRACE_REFS
, que adiciona a função sys.getobjects()
e a variável de ambiente PYTHONDUMPREFS
, pode ser configurada usando a nova opção de compilação ./configure --with-trace-refs
. (Contribuição de Victor Stinner em bpo-36465.)
No Unix, as extensões C não estão mais vinculadas ao libpython, exceto no Android e Cygwin. Agora é possível que um Python vinculado estaticamente carregue uma extensão C criada usando uma biblioteca compartilhada Python. (Contribuição de Victor Stinner em bpo-21536.)
No Unix, quando o Python é compilado no modo de depuração, a importação agora também procura extensões C compiladas no modo de lançamento e extensões C compiladas com a ABI estável. (Contribuição de Victor Stinner em bpo-36722.)
Para incorporar o Python em uma aplicação, uma nova opção --embed
deve ser passada para python3-config --libs --embed
para obter o -lpython3.8
(vincula a aplicação ao libpython). Para dar suporte a 3.8 e versões mais antigas, tente python3-config --libs --embed
primeiro e use como fallback para python3-config --libs
(sem --embed
) se o comando anterior falhar.
Adicione um módulo pkg-config python-3.8-embed
para incorporar o Python em uma aplicação: pkg-config python-3.8-embed --libs
inclui -lpython3.8
. Para suportar tanto o 3.8 quanto o anterior, tente pkg-config python-X.Y-embed --libs
primeiro e use como fallback pkg-config python-X.Y --libs
(sem --embed
) se o comando anterior falhar (substitua X.Y
pela versão do Python).
Por outro lado, pkg-config python3.8 --libs
não contém mais -lpython3.8
. As extensões C não devem estar vinculadas ao libpython (exceto no Android e Cygwin, cujos casos são tratados pelo script); essa alteração é retroativamente incompatível de propósito. (Contribuição de Victor Stinner em bpo-36721.)
O suporte a f-strings =
para expressões de auto-documentação e depuração¶
Adicionado um especificador =
para f-strings. Uma f-string como f'{expr=}'
será expandida para o texto da expressão, um sinal de igual e, em seguida, a representação da expressão avaliada. Por exemplo:
>>> user = 'eric_idle'
>>> member_since = date(1975, 7, 31)
>>> f'{user=} {member_since=}'
"user='eric_idle' member_since=datetime.date(1975, 7, 31)"
O habitual f-string especificadores de formato permite mais controle sobre como o resultado da expressão é exibido:
>>> delta = date.today() - member_since
>>> f'{user=!s} {delta.days=:,d}'
'user=eric_idle delta.days=16,075'
O especificador =
exibirá toda a expressão para que os cálculos possam ser mostrados:
>>> print(f'{theta=} {cos(radians(theta))=:.3f}')
theta=30 cos(radians(theta))=0.866
(Contribuição de Eric V. Smith e Larry Hastings em bpo-36817.)
PEP 578: Ganchos de auditoria em tempo de execução Python¶
O PEP adiciona um Gancho de Auditoria e um Gancho Aberto Verificado. Ambos estão disponíveis no Python e no código nativo, permitindo que aplicações e estruturas escritas em código Python puro aproveitem as notificações extras, além de permitir que incorporadores ou administradores de sistema implementem versões do Python onde a auditoria está sempre ativada.
Veja PEP 578 para mais detalhes.
PEP 587: Configuração de Inicialização do Python¶
O PEP 587 adiciona uma nova API C para configurar a Inicialização do Python, fornecendo um controle mais preciso de toda a configuração e melhores relatórios de erros.
Novas estruturas:
Novas Funções:
Esse PEP também adiciona os campos _PyRuntimeState.preconfig
(tipo PyPreConfig
) e PyInterpreterState.config
(tipo PyConfig
) campos a essas estruturas internas. PyInterpreterState.config
se torna a nova configuração de referência, substituindo variáveis de configuração global e outras variáveis privadas.
Veja Configuração de Inicialização do Python para a documentação.
Consulte a PEP 587 para uma descrição completa.
(Contribuição de Victor Stinner em bpo-36763.)
PEP 590: Vectorcall: um protocolo de chamada rápida para CPython¶
O protocolo vectorcall é adicionado à API Python/C. Ele visa formalizar as otimizações existentes que já foram feitas para várias classes. Qualquer tipo estático que implemente um chamável pode usar esse protocolo.
Atualmente, isso é provisório. O objetivo é torná-lo totalmente público no Python 3.9.
Consulte a PEP 590 para uma descrição completa.
(Contribuição de Jeroen Demeyer, Mark Shannon e Petr Viktorin em bpo-36974.)
Protocolo de Pickle 5 com buffers de dados fora da banda¶
Quando pickle
é usado para transferir grande quantidade de dados entre processos Python, a fim de tirar proveito do processamento com vários núcleos ou com várias máquinas, é importante otimizar a transferência reduzindo cópias de memória e, possivelmente, aplicando técnicas personalizadas, como como compactação dependente de dados.
O protocolo pickle
5 introduz suporte para buffers fora de banda, onde dados compatíveis com a PEP 3118 podem ser transmitidos separadamente do fluxo de pickle principal, a critério da camada de comunicação.
Consulte a PEP 574 para uma descrição completa.
(Contribuição de Antoine Pitrou em bpo-36785.)
Outras mudanças na linguagem¶
A instrução
continue
era ilegal na cláusulafinally
devido a um problema com a implementação. No Python 3.8, essa restrição foi levantada. (Contribuição de Serhiy Storchaka em bpo-32489.)Os tipos
bool
,int
efractions.Fraction
agora têm o métodoas_integer_ratio()
como o encontrado emfloat
edecimal.Decimal
. Esta pequena extensão da API torna possível escrevernumerator, denominator = x.as_integer_ratio()
e fazer com que funcione em vários tipos numéricos. (Contribuição de Lisa Roach em bpo-33073 e Raymond Hettinger em bpo-37819.)Os construtores de
int
,float
ecomplex
agora usarão o método especial__index__()
, se disponível, e o método correspondente__int__()
,__float__()
ou__complex__()
não está disponível. (Contribuição de Serhiy Storchaka em bpo-20092.)Adicionado suporte a escapes
\N{name}
emexpressões regulares
:>>> notice = 'Copyright © 2019' >>> copyright_year_pattern = re.compile(r'\N{copyright sign}\s*(\d{4})') >>> int(copyright_year_pattern.search(notice).group(1)) 2019
(Contribuição de Jonathan Eunice e Serhiy Storchaka em bpo-30688.)
Dict e dictviews agora são iteráveis em ordem de inserção reversa usando
reversed()
. (Contribuição de Rémi Lapeyre em bpo-33462.)A sintaxe permitida para nomes de palavras-chave em chamadas de função foi ainda mais restrita. Em particular,
f((keyword)=arg)
não é mais permitido. Ele nunca teve a intenção de permitir mais do que um nome simples no lado esquerdo de um termo de atribuição de argumento nomeado. (Contribuição de Benjamin Peterson em bpo-34641.)O desempacotamento de iterável generalizado das instruções
yield
ereturn
não requer mais parênteses. Isso traz a sintaxe yield e return uma melhor concordância com a sintaxe de atribuição normal:>>> def parse(family): ... lastname, *members = family.split() ... return lastname.upper(), *members ... >>> parse('simpsons homer marge bart lisa maggie') ('SIMPSONS', 'homer', 'marge', 'bart', 'lisa', 'maggie')
(Contribuição de David Cuthbert e Jordan Chapman em bpo-32117.)
Quando uma vírgula está faltando em código como
[(10, 20) (30, 40)]
, o compilador exibe umSyntaxWarning
com uma sugestão útil. Isso melhora apenas tendo umTypeError
indicando que a primeira tupla não era chamável. (Contribuição de Serhiy Storchaka em bpo-15248.)As operações aritméticas entre as subclasses de
datetime.date
oudatetime.datetime
edatetime.timedelta
agora retornam uma instância da subclasse, em vez da classe base. Isso também afeta o tipo de retorno de operações cuja implementação (direta ou indiretamente) utiliza aritmética dedatetime.timedelta
, comoastimezone()
. (Contribuição de Paul Ganssle em bpo-32417.)Quando o interpretador Python é interrompido por Ctrl-C (SIGINT) e a exceção resultante
KeyboardInterrupt
não é capturada, o processo Python agora sai por meio de um sinal SIGINT ou com o código de saída correto, para que o processo de chamada possa detectar que foi encerrado devido a um Ctrl-C. Os shells no POSIX e Windows usam isso para finalizar corretamente os scripts em sessões interativas. (Contribuição do Google via Gregory P. Smith em bpo-1054041.)Alguns estilos avançados de programação requerem a atualização do objeto
types.CodeType
para uma função existente. Como os objetos código são imutáveis, um novo objeto código precisa ser criado, modelado no objeto código existente. Com 19 parâmetros, isso foi um pouco tedioso. Agora, o novo métodoreplace()
torna possível criar um clone com alguns parâmetros alterados.Aqui está um exemplo que altera a função
Statistics.mean()
para impedir que o parâmetro data seja usado como argumento nomeado:>>> from statistics import mean >>> mean(data=[10, 20, 90]) 40 >>> mean.__code__ = mean.__code__.replace(co_posonlyargcount=1) >>> mean(data=[10, 20, 90]) Traceback (most recent call last): ... TypeError: mean() got some positional-only arguments passed as keyword arguments: 'data'
(Contribuição de Victor Stinner em bpo-37032.)
Para números inteiros, a forma de três argumentos da função
pow()
agora permite que o expoente seja negativo no caso em que a base é relativamente primária ao módulo. Em seguida, calcula um inverso modular para a base quando o expoente é-1
e uma potência adequada desse inverso para outros expoentes negativos. Por exemplo, para calcular o inverso multiplicativo modular de 38 módulo 137, escreva:>>> pow(38, -1, 137) 119 >>> 119 * 38 % 137 1
Inversos modulares surgem na solução de equações diofantinas lineares. Por exemplo, para encontrar soluções inteiras para
4258𝑥 + 147𝑦 = 369
, primeiro reescreva como4258𝑥 ≡ 369 (mod 147)
e depois resolva:>>> x = 369 * pow(4258, -1, 147) % 147 >>> y = (4258 * x - 369) // -147 >>> 4258 * x + 147 * y 369
(Contribuição de Mark Dickinson em bpo-36027.)
As compreensões de dict foram sincronizadas com literais de dict, para que a chave seja computada primeiro e o valor em segundo:
>>> # Dict comprehension >>> cast = {input('role? '): input('actor? ') for i in range(2)} role? King Arthur actor? Chapman role? Black Knight actor? Cleese >>> # Dict literal >>> cast = {input('role? '): input('actor? ')} role? Sir Robin actor? Eric Idle
A ordem de execução garantida é útil nas expressões de atribuição, porque as variáveis atribuídas na expressão de chave estarão disponíveis na expressão de valor:
>>> names = ['Martin von Löwis', 'Łukasz Langa', 'Walter Dörwald'] >>> {(n := normalize('NFC', name)).casefold() : n for name in names} {'martin von löwis': 'Martin von Löwis', 'łukasz langa': 'Łukasz Langa', 'walter dörwald': 'Walter Dörwald'}
(Contribuição de Jörn Heissler em bpo-35224.)
O método
object.__reduce__()
agora pode retornar uma tupla de dois a seis elementos. Anteriormente, cinco era o limite. O novo sexto elemento opcional é um chamável com uma assinatura(obj, state)
. Isso permite o controle direto sobre o comportamento de atualização de estado de um objeto específico. Caso contrário, None, esse chamável terá prioridade sobre o método__setstate__()
do objeto. (Contribuição de Pierre Glaser e Olivier Grisel em bpo-35900.)
Novos módulos¶
O novo módulo
importlib.metadata
fornece suporte (provisório) para a leitura de metadados de pacotes de terceiros. Por exemplo, ele pode extrair o número da versão de um pacote instalado, a lista de pontos de entrada e muito mais:>>> # Note following example requires that the popular "requests" >>> # package has been installed. >>> >>> from importlib.metadata import version, requires, files >>> version('requests') '2.22.0' >>> list(requires('requests')) ['chardet (<3.1.0,>=3.0.2)'] >>> list(files('requests'))[:5] [PackagePath('requests-2.22.0.dist-info/INSTALLER'), PackagePath('requests-2.22.0.dist-info/LICENSE'), PackagePath('requests-2.22.0.dist-info/METADATA'), PackagePath('requests-2.22.0.dist-info/RECORD'), PackagePath('requests-2.22.0.dist-info/WHEEL')]
(Contribuição de Barry Warsaw e Jason R. Coombs em bpo-34632.)
Módulos melhorados¶
ast¶
Os nós de AST agora têm os atributos end_lineno
e end_col_offset
, que fornecem a localização precisa do final do nó. (Isso se aplica apenas aos nós que possuem os atributos lineno
e col_offset
.)
Nova função ast.get_source_segment()
retorna o código-fonte para um nó AST específico.
(Contribuição de Ivan Levkivskyi em bpo-33416.)
A função ast.parse()
possui alguns novos sinalizadores:
type_comments=True
faz com que retorne o texto dos comentários de tipos de PEP 484 e PEP 526 associados a determinados nós AST;mode='func_type'
pode ser usado para analisar “comentários do tipo de assinatura” do PEP 484 (retornados para nós AST de definição de função);feature_version=(3, N)
permite especificar uma versão anterior do Python 3. Por exemplo,feature_version=(3, 4)
trataráasync
eawait
como palavras não reservadas.
(Contribuição de Guido van Rossum em bpo-35766.)
asyncio¶
asyncio.run()
passou da API provisória para a estável. Esta função pode ser usada para executar uma corrotina e retornar o resultado enquanto gerencia automaticamente o loop de eventos. Por exemplo:
import asyncio
async def main():
await asyncio.sleep(0)
return 42
asyncio.run(main())
Isso é aproximadamente equivalente a:
import asyncio
async def main():
await asyncio.sleep(0)
return 42
loop = asyncio.new_event_loop()
asyncio.set_event_loop(loop)
try:
loop.run_until_complete(main())
finally:
asyncio.set_event_loop(None)
loop.close()
A implementação real é significativamente mais complexa. Assim, asyncio.run()
deve ser a maneira preferida de executar programas assíncronos.
(Contribuição de Yury Selivanov em bpo-32314.)
A execução de python -m asyncio
lança um REPL nativo assíncrono. Isso permite a experimentação rápida de código que possui um nível superior await
. Não é mais necessário chamar diretamente asyncio.run()
, o que geraria um novo loop de evento a cada chamada:
$ python -m asyncio
asyncio REPL 3.8.0
Use "await" directly instead of "asyncio.run()".
Type "help", "copyright", "credits" or "license" for more information.
>>> import asyncio
>>> await asyncio.sleep(10, result='hello')
hello
(Contribuição de Yury Selivanov em bpo-37028.)
A exceção asyncio.CancelledError
agora herda de BaseException
em vez de Exception
e não mais herda de concurrent.futures.CancelledError
. (Contribuição de Yury Selivanov em bpo-32528.)
No Windows, o loop de eventos padrão é agora ProactorEventLoop
. (Contribuição de Victor Stinner em bpo-34687.)
ProactorEventLoop
agora também tem suporte a UDP. (Contribuição de Adam Meily e Andrew Svetlov em bpo-29883.)
ProactorEventLoop
pode agora ser interrompido por KeyboardInterrupt
(“CTRL+C”). (Contribuição de Vladimir Matveev em bpo-23057.)
Adicionado asyncio.Task.get_coro()
para obter a corrotina de dentro de um asyncio.Task
. (Contribuição de Alex Grönholm em bpo-36999.)
As tarefas de asyncio agora podem ser nomeadas, passando o argumento nomeado name
para asyncio.create_task()
ou o método de loop de evento create_task()
ou chamando o método set_name()
no objeto de tarefa. O nome da tarefa é visível na saída de repr()
de asyncio.Task
e também pode ser recuperado usando o método get_name()
. (Contribuição de Alex Grönholm em bpo-34270.)
Adicionado suporte a Happy Eyeballs para asyncio.loop.create_connection()
. Para especificar o comportamento, dois novos parâmetros foram adicionados: happy_eyeballs_delay e interleave. O algoritmo Happy Eyeballs melhora a capacidade de resposta em aplicativos compatíveis com IPv4 e IPv6, tentando conectar-se simultaneamente usando os dois. (Contribuição de twisteroid ambassador em bpo-33530.)
builtins¶
A função embutida compile()
foi aprimorada para aceitar o sinalizador ast.PyCF_ALLOW_TOP_LEVEL_AWAIT
. Com esse novo sinalizador passado, compile()
permitirá construções de nível superior await
, async for
e async with
que geralmente são consideradas sintaxe inválida. O objeto de código assíncrono marcado com o sinalizador CO_COROUTINE
pode ser retornado. (Contribuição de Matthias Bussonnier em bpo-34616)
collections¶
O método _asdict()
para collections.namedtuple()
agora retorna a dict
em vez de um collections.OrderedDict
. Isso funciona porque os dict regulares garantem pedidos desde o Python 3.7. Se os recursos extras de OrderedDict
forem necessários, a solução sugerida é converter o resultado no tipo desejado: OrderedDict(nt._asdict())
. (Contribuição de Raymond Hettinger em bpo-35864.)
cProfile¶
A classe cProfile.Profile
agora pode ser usada como um gerenciador de contexto. Perfile um bloco de código executando:
import cProfile
with cProfile.Profile() as profiler:
# code to be profiled
...
(Contribuição de Scott Sanderson em bpo-29235.)
csv¶
O csv.DictReader
agora retorna instâncias de dict
em vez de um collections.OrderedDict
. Agora, a ferramenta é mais rápida e utiliza menos memória enquanto preserva a ordem dos campos. (Contribuição de Michael Selik em bpo-34003.)
curses¶
Adicionada uma nova variável contendo informações de versão estruturada para a biblioteca ncurses subjacente: ncurses_version
. (Contribuição de Serhiy Storchaka em bpo-31680.)
ctypes¶
No Windows, CDLL
e subclasses agora aceitam um parâmetro winmode para especificar sinalizadores para a chamada subjacente LoadLibraryEx
. Os sinalizadores padrão são definidos para carregar apenas dependências da DLL em locais confiáveis, incluindo o caminho em que a DLL está armazenada (se um caminho completo ou parcial for usado para carregar a DLL inicial) e os caminhos adicionados por add_dll_directory()
. (Contribuição de Steve Dower em bpo-36085.)
datetime¶
Adicionados novos construtores alternativos datetime.date.fromisocalendar()
e datetime.datetime.fromisocalendar()
, que constroem objetos de date
e datetime
respectivamente do ano ISO, número da semana e dia da semana; estes são o inverso do método isocalendar
de cada classe. (Contribuição de Paul Ganssle em bpo-36004.)
functools¶
functools.lru_cache()
agora pode ser usado como um decorador direto, e não como uma função retornando um decorador. Portanto, agora ambos são suportados:
@lru_cache
def f(x):
...
@lru_cache(maxsize=256)
def f(x):
...
(Contribuição de Raymond Hettinger em bpo-36772.)
Adicionado um novo decorador functools.cached_property()
, para propriedades computadas armazenadas em cache durante toda a vida útil da instância.
import functools
import statistics
class Dataset:
def __init__(self, sequence_of_numbers):
self.data = sequence_of_numbers
@functools.cached_property
def variance(self):
return statistics.variance(self.data)
(Contribuição de Carl Meyer em bpo-21145)
Adicionado um novo decorador functools.singledispatchmethod()
que converte métodos em funções genéricas usando despacho único:
from functools import singledispatchmethod
from contextlib import suppress
class TaskManager:
def __init__(self, tasks):
self.tasks = list(tasks)
@singledispatchmethod
def discard(self, value):
with suppress(ValueError):
self.tasks.remove(value)
@discard.register(list)
def _(self, tasks):
targets = set(tasks)
self.tasks = [x for x in self.tasks if x not in targets]
(Contribuição de Ethan Smith em bpo-32380)
gc¶
get_objects()
agora pode receber um parâmetro opcional generation indicando uma geração da qual obter objetos. (Contribuição de Pablo Galindo em bpo-36016.)
gettext¶
Adicionado pgettext()
e suas variantes. (Contribuição de Franz Glasner, Éric Araujo e Cheryl Sabella em bpo-2504.)
gzip¶
Adicionado o parâmetro mtime em gzip.compress()
para saída reproduzível. (Contribuição de Guo Ci Teo em bpo-34898.)
A exceção BadGzipFile
agora é levantada em vez de OSError
para certos tipos de arquivos gzip inválidos ou corrompidos. (Contribuição de Filip Gruszczyński, Michele Orrù e Zackery Spytz em bpo-6584.)
IDLE e idlelib¶
A saída em N linhas (50 por padrão) é compactada até um limite inferior. N pode ser alterado na seção PyShell da página General da caixa de diálogo Settings. Menos linhas, mas possivelmente extra longas, podem ser espremidas clicando com o botão direito do mouse na saída. A saída compactada pode ser expandida no local clicando duas vezes no botão ou na área de transferência ou em uma janela separada clicando com o botão direito do mouse. (Contribuição de Tal Einat em bpo-1529353.)
Adiciona “Run Customized” ao menu Executar para executar um módulo com configurações personalizadas. Quaisquer argumentos de linha de comando inseridos são adicionados ao sys.argv. Eles também reaparecem na caixa para a próxima execução personalizada. Pode-se também suprimir a reinicialização normal do módulo principal do console. (Contribuição de Cheryl Sabella, Terry Jan Reedy e outros em bpo-5680 e bpo-37627.)
Adicionados números de linha opcionais para janelas do editor IDLE. O Windows é aberto sem números de linha, a menos que definido de outra forma na guia General da caixa de diálogo de configuração. Os números de linha de uma janela existente são mostrados e ocultos no menu Opções. (Contribuição de Tal Einat e Saimadhav Heblikar em bpo-17535.)
A codificação nativa do sistema operacional agora é usada para converter entre strings Python e objetos Tcl. Isso permite que o IDLE trabalhe com emoji e outros caracteres não BMP. Esses caracteres podem ser exibidos ou copiados e colados na ou da área de transferência. A conversão de strings de Tcl para Python e de volta agora nunca falha. (Muitas pessoas trabalharam nisso por oito anos, mas o problema foi finalmente resolvido por Serhiy Storchaka em bpo-13153.)
Novo em 3.8.1:
Adiciona a opção para ativar e desativar o piscar do cursor. (Contribuição de Zackery Spytz na bpo-4603.)
A tecla Escape agora fecha as janelas de conclusão IDLE. (Contribuição de Johnny Najera em bpo-38944.)
As alterações acima foram suportadas para versões de manutenção 3.7.
Adiciona argumentos nomeados à lista de completamento de nome de módulo. (Contribuição de Terry J. Reedy em bpo-37765.)
inspect¶
A função inspect.getdoc()
agora pode encontrar docstrings para __slots__
se esse atributo for dict
onde os valores são docstrings. Isso fornece opções de documentação semelhantes às que já temos para property()
, classmethod()
e staticmethod()
:
class AudioClip:
__slots__ = {'bit_rate': 'expressed in kilohertz to one decimal place',
'duration': 'in seconds, rounded up to an integer'}
def __init__(self, bit_rate, duration):
self.bit_rate = round(bit_rate / 1000.0, 1)
self.duration = ceil(duration)
(Contribuição de Raymond Hettinger em bpo-36326.)
io¶
No modo de desenvolvimento (-X
env
) e na compilação de depuração, o finalizador io.IOBase
agora registra a exceção se o método close()
falhar. A exceção é ignorada silenciosamente por padrão na compilação de lançamento. (Contribuição de Victor Stinner em bpo-18748.)
itertools¶
A função itertools.accumulate()
adicionou uma opção de argumento nomeado initial para especificar um valor inicial:
>>> from itertools import accumulate
>>> list(accumulate([10, 5, 30, 15], initial=1000))
[1000, 1010, 1015, 1045, 1060]
(Contribuído por Lisa Roach em bpo-34659.)
json.tool¶
Adiciona a opção --json-lines
para analisar cada linha de entrada como um objeto JSON separado. (Contribuição de Weipeng Hong em bpo-31553.)
logging¶
Added a force keyword argument to logging.basicConfig()
When set to true, any existing handlers attached
to the root logger are removed and closed before carrying out the
configuration specified by the other arguments.
Isso resolve um problema de longa data. Depois que um logger ou basicConfig() foi chamado, as chamadas subsequentes para basicConfig() foram ignoradas silenciosamente. Isso dificultava a atualização, a experimentação ou o ensino das várias opções de configuração de log usando o prompt interativo ou um bloco de notas de Jupyter.
(Sugestão de Raymond Hettinger, implementação de Dong-hee Na e revisão de Vinay Sajip em bpo-33897.)
math¶
Adicionada nova função math.dist()
para calcular a distância euclidiana entre dois pontos. (Contribuição de Raymond Hettinger em bpo-33089.)
Expandida a função math.hypot()
para manipular várias dimensões. Anteriormente, suportava apenas o caso 2-D. (Contribuição de Raymond Hettinger em bpo-33089.)
Adicionada nova função, math.prod()
, como função análoga a sum()
que retorna o produto de um valor ‘start’ (padrão: 1) vezes uma iterável de números:
>>> prior = 0.8
>>> likelihoods = [0.625, 0.84, 0.30]
>>> math.prod(likelihoods, start=prior)
0.126
(Contribuição de Pablo Galindo em bpo-35606.)
Adicionadas duas novas funções combinatórias math.perm()
e math.comb()
:
>>> math.perm(10, 3) # Permutations of 10 things taken 3 at a time
720
>>> math.comb(10, 3) # Combinations of 10 things taken 3 at a time
120
(Contribuição de Yash Aggarwal, Keller Fuchs, Serhiy Storchaka e Raymond Hettinger em bpo-37128, bpo-37178 e bpo-35431.)
Adicionada uma nova função math.isqrt()
para calcular raízes quadradas inteiras precisas sem conversão para ponto flutuante. A nova função suporta números inteiros arbitrariamente grandes. É mais rápido que floor(sqrt(n))
, mas mais lento que math.sqrt()
:
>>> r = 650320427
>>> s = r ** 2
>>> isqrt(s - 1) # correct
650320426
>>> floor(sqrt(s - 1)) # incorrect
650320427
(Contribuição de Mark Dickinson em bpo-36887.)
A função math.factorial()
não aceita mais argumentos que não são parecidos com int. (Contribuição de Pablo Galindo em bpo-33083.)
mmap¶
A classe mmap.mmap
agora possui o método madvise()
para acessar a chamada do sistema madvise()
. (Contribuição de Zackery Spytz em bpo-32941.)
multiprocessing¶
Adicionado novo módulo multiprocessing.shared_memory
. (Contribuição de Davin Potts em bpo-35813.)
No macOS, o método inicial spawn agora é usado por padrão. (Contribuição de Victor Stinner em bpo-33725.)
os¶
Adicionada nova função add_dll_directory()
no Windows para fornecer caminhos de pesquisa adicionais para dependências nativas ao importar módulos de extensão ou carregar DLLs usando ctypes
. (Contribuição de Steve Dower em bpo-36085.)
Uma nova função os.memfd_create()
foi adicionada para envolver a chamada de sistema memfd_create()
. (Contribuição de Zackery Spytz e Christian Heimes em bpo-26836.)
No Windows, grande parte da lógica manual para manipular pontos de nova análise (incluindo links simbólicos e junções de diretório) foi delegada ao sistema operacional. Especificamente, os.stat()
agora percorrerá qualquer coisa suportada pelo sistema operacional, enquanto os.lstat()
abrirá apenas pontos de nova análise que se identificam como “substitutos de nome” enquanto outros são abertos como os.stat()
. Em todos os casos, stat_result.st_mode
terá apenas S_IFLNK
definido para links simbólicos e não para outros tipos de pontos de nova análise. Para identificar outros tipos de pontos de nova análise, verifique o novo atributo stat_result.st_reparse_tag
.
No Windows, os.readlink()
agora pode ler junções de diretório. Observe que islink()
retornará False
para junções de diretório e, portanto, o código que verifica primeiro islink
continuará tratando junções como diretórios, enquanto o código que lida com erros de os.readlink()
agora pode tratar junções como links.
(Contribuição de Steve Dower em bpo-37834.)
os.path¶
Funções de os.path
que retornam um resultado booleano como exists()
, lexists()
, isdir()
, isfile()
, islink()
e ismount()
agora retornam False
em vez de levantar ValueError
ou suas subclasses UnicodeEncodeError
e UnicodeDecodeError
para caminhos que contêm caracteres ou bytes não representáveis no nível do SO. (Contribuição de Serhiy Storchaka em bpo-33721.)
expanduser()
no Windows agora prefere a variável de ambiente USERPROFILE
e não usa HOME
, que normalmente não é definido para contas de usuário comuns. (Contribuição de Anthony Sottile em bpo-36264.)
isdir()
no Windows não retorna mais True
para um link para um diretório inexistente.
realpath()
no Windows agora resolve pontos de nova análise, incluindo links simbólicos e junções de diretório.
(Contribuição de Steve Dower em bpo-37834.)
pathlib¶
pathlib.Path
methods that return a boolean result like
exists()
, is_dir()
,
is_file()
, is_mount()
,
is_symlink()
, is_block_device()
,
is_char_device()
, is_fifo()
,
is_socket()
now return False
instead of raising
ValueError
or its subclass UnicodeEncodeError
for paths that
contain characters unrepresentable at the OS level.
(Contributed by Serhiy Storchaka in bpo-33721.)
Added pathlib.Path.link_to()
which creates a hard link pointing
to a path.
(Contributed by Joannah Nanjekye in bpo-26978)
Note that link_to
was deprecated in 3.10 and removed in 3.12 in
favor of a hardlink_to
method added in 3.10 which matches the
semantics of the existing symlink_to
method.
pickle¶
Extensões de pickle
, que atuem como subclasse da classe otimizada para C Pickler
, agora podem substituir a lógica de “pickling” de funções e classes definindo o método especial reducer_override()
. (Contribuição de Pierre Glaser e Olivier Grisel em bpo-35900.)
plistlib¶
Adicionado novo plistlib.UID
e habilitado suporte para leitura e escrita de plists binárias codificadas em NSKeyedArchiver. (Contribuição de Jon Janzen em bpo-26707.)
pprint¶
O módulo pprint
adicionou um parâmetro sort_dicts a várias funções. Por padrão, essas funções continuam a classificar dicionários antes da renderização ou impressão. No entanto, se sort_dicts estiver definido como false, os dicionários manterão a ordem em que as chaves foram inseridas. Isso pode ser útil para comparação com entradas JSON durante a depuração.
Além disso, existe uma nova função de conveniência, pprint.pp()
, que é como pprint.pprint()
, mas com sort_dicts padronizando como False
:
>>> from pprint import pprint, pp
>>> d = dict(source='input.txt', operation='filter', destination='output.txt')
>>> pp(d, width=40) # Original order
{'source': 'input.txt',
'operation': 'filter',
'destination': 'output.txt'}
>>> pprint(d, width=40) # Keys sorted alphabetically
{'destination': 'output.txt',
'operation': 'filter',
'source': 'input.txt'}
(Contribuição de Rémi Lapeyre em bpo-30670.)
py_compile¶
py_compile.compile()
agora possui suporte a um modo silencioso. (Contribuição de Joannah Nanjekye em bpo-22640.)
shlex¶
A nova função shlex.join()
atua como o inverso da shlex.split()
. (Contribuição de Bo Bayles em bpo-32102.)
shutil¶
shutil.copytree()
agora aceita um novo argumento nomeado dirs_exist_ok
. (Contribuição de Josh Bronson em bpo-20849.)
shutil.make_archive()
agora tem como pádrão o formato pax moderno (POSIX.1-2001) de novos arquivos para melhorar a portabilidade e a conformidade com os padrões, herdados da alteração correspondente no módulo tarfile
. (Contribuição de C.A.M. Gerlach em bpo-30661.)
shutil.rmtree()
no Windows agora remove junções de diretórios sem remover recursivamente o conteúdo primeiro. (Contribuição de Steve Dower em bpo-37834.)
socket¶
Added create_server()
and has_dualstack_ipv6()
convenience functions to automate the necessary tasks usually involved when
creating a server socket, including accepting both IPv4 and IPv6 connections
on the same socket. (Contributed by Giampaolo Rodolà in bpo-17561.)
The socket.if_nameindex()
, socket.if_nametoindex()
, and
socket.if_indextoname()
functions have been implemented on Windows.
(Contributed by Zackery Spytz in bpo-37007.)
ssl¶
Adicionado post_handshake_auth
para ativar e verify_client_post_handshake()
para iniciar a autenticação pós-handshake do TLS 1.3. (Contribuição de Christian Heimes em bpo-34670.)
statistics¶
Added statistics.fmean()
as a faster, floating-point variant of
statistics.mean()
. (Contributed by Raymond Hettinger and
Steven D’Aprano in bpo-35904.)
Added statistics.geometric_mean()
(Contributed by Raymond Hettinger in bpo-27181.)
Adicionada Statistics.multimode()
que retorna uma lista dos valores mais comuns. (Contribuição de Raymond Hettinger em bpo-35892.)
Adicionada statistics.quantiles()
que divide dados ou uma distribuição em intervalos equivalentes (por exemplo, quartis, decis ou percentis). (Contribuição de Raymond Hettinger em bpo-36546.)
Adicionada statistics.NormalDist
, uma ferramenta para criar e manipular distribuições normais de uma variável aleatória. (Contribuição de Raymond Hettinger em bpo-36018.)
>>> temperature_feb = NormalDist.from_samples([4, 12, -3, 2, 7, 14])
>>> temperature_feb.mean
6.0
>>> temperature_feb.stdev
6.356099432828281
>>> temperature_feb.cdf(3) # Chance of being under 3 degrees
0.3184678262814532
>>> # Relative chance of being 7 degrees versus 10 degrees
>>> temperature_feb.pdf(7) / temperature_feb.pdf(10)
1.2039930378537762
>>> el_niño = NormalDist(4, 2.5)
>>> temperature_feb += el_niño # Add in a climate effect
>>> temperature_feb
NormalDist(mu=10.0, sigma=6.830080526611674)
>>> temperature_feb * (9/5) + 32 # Convert to Fahrenheit
NormalDist(mu=50.0, sigma=12.294144947901014)
>>> temperature_feb.samples(3) # Generate random samples
[7.672102882379219, 12.000027119750287, 4.647488369766392]
sys¶
Adiciona uma nova função sys.unraisablehook()
, que pode ser substituída para controlar como as “exceções não passíveis de levantamento” são tratadas. É chamada quando uma exceção ocorre, mas não há como o Python manipulá-la. Por exemplo, quando um destruidor gera uma exceção ou durante a coleta de lixo (gc.collect()
). (Contribuição de Victor Stinner em bpo-36829.)
tarfile¶
O módulo tarfile
agora tem como padrão o formato pax moderno (POSIX.1-2001) para novos arquivos, em vez do anterior específico do GNU. Isso melhora a portabilidade de plataforma cruzada com uma codificação consistente (UTF-8) em um formato padronizado e extensível e oferece vários outros benefícios. (Contribuição de C.A.M. Gerlach em bpo-36268.)
threading¶
Adiciona uma nova função threading.excepthook()
que manipula a exceção não capturada threading.Thread.run()
. Pode ser substituída para controlar como exceções não capturadas threading.Thread.run()
são manipuladas. (Contribuição de Victor Stinner em bpo-1230540.)
Adiciona uma nova função threading.get_native_id()
e um atributo native_id
à classe threading.Thread
. Eles retornam o Thread ID integral nativo do thread atual atribuído pelo kernel. Este recurso está disponível apenas em determinadas plataformas, consulte get_native_id
para mais informações. (Contribuição de Jake Tesler em bpo-36084.)
tokenize¶
O módulo tokenize
agora emite implicitamente um token NEWLINE
quando fornecido com entrada que não possui uma nova linha à direita. Esse comportamento agora corresponde ao que o tokenizador do C faz internamente. (Contribuição de Ammar Askar em bpo-33899.)
tkinter¶
Adicionados os métodos selection_from()
, selection_present()
, selection_range()
e selection_to()
à classe tkinter.Spinbox
. (Contribuição de Juliette Monsel em bpo-34829.)
Adicionado o método moveto()
na classe tkinter.Canvas
. (Contribuição de Juliette Monsel em bpo-23831.)
A classe tkinter.PhotoImage
agore tem os métodos transparency_get()
e transparency_set()
. (Contribuição de Zackery Spytz em bpo-25451.)
time¶
Adiciona o novo relógio CLOCK_UPTIME_RAW
ao macOS 10.12. (Contribuição de Joannah Nanjekye em bpo-35702.)
typing¶
O módulo typing
incorpora vários novos recursos:
Um tipo de dicionário com tipos por chave. Veja PEP 589 e
typing.TypedDict
. TypedDict usa apenas chaves de strings. Por padrão, é necessário que todas as chaves estejam presentes. Especifique “total=False” para permitir que as chaves sejam opcionais:class Location(TypedDict, total=False): lat_long: tuple grid_square: str xy_coordinate: tuple
Tipos literais. Veja PEP 586 e
typing.Literal
. Tipos literais indicam que um parâmetro ou valor de retorno está restrito a um ou mais valores literais específicos:def get_status(port: int) -> Literal['connected', 'disconnected']: ...
Variáveis, funções, métodos e classes “finais”. Veja PEP 591,
typing.Final
etyping.final()
. O qualificador final instrui um verificador de tipo estático a restringir criação de subclasse, substituição ou reatribuição:pi: Final[float] = 3.1415926536
Definições de protocolo. Veja PEP 544,
typing.Protocol
etyping.runtime_checkable()
. ABCs simples comotyping.SupportsInt
agora são subclasses deProtocol
.Nova classe de protocolo
typing.SupportsIndex
.Novas funções
typing.get_origin()
etyping.get_args()
.
unicodedata¶
O módulo unicodedata
agora foi atualizado para usar o Unicode 12.1.0.
A nova função is_normalized()
pode ser usada para verificar se uma string está em uma forma normal específica, geralmente muito mais rápida do que normalizar a string. (Contribuição de Max Belanger, David Euresti e Greg Price em bpo-32285 e bpo-37966).
unittest¶
Adicionada AsyncMock
para dar suporte a uma versão assíncrona de Mock
. Também foram adicionadas novas funções apropriadas para teste. (Contribuição de Lisa Roach em bpo-26467).
Added addModuleCleanup()
and
addClassCleanup()
to unittest to support
cleanups for setUpModule()
and
setUpClass()
.
(Contributed by Lisa Roach in bpo-24412.)
Várias funções de declaração de mock agora também exibem uma lista de chamadas reais em caso de falha. (Contribuição de Petter Strandmark em bpo-35047.)
O módulo unittest
ganhou suporte a corrotinas a serem usadas como casos de teste com unittest.IsolatedAsyncioTestCase
. (Contribuição de Andrew Svetlov em bpo-32972.)
Exemplo:
import unittest
class TestRequest(unittest.IsolatedAsyncioTestCase):
async def asyncSetUp(self):
self.connection = await AsyncConnection()
async def test_get(self):
response = await self.connection.get("https://example.com")
self.assertEqual(response.status_code, 200)
async def asyncTearDown(self):
await self.connection.close()
if __name__ == "__main__":
unittest.main()
venv¶
venv
agora inclui um script Activate.ps1
em todas as plataformas para ativar ambientes virtuais no PowerShell Core 6.1. (Contribuição de Brett Cannon em bpo-32718.)
weakref¶
Os objetos proxy retornados por weakref.proxy()
agora possuem suporte aos operadores de multiplicação de matrizes @
e @=
além dos outros operadores numéricos. (Contribuição de Mark Dickinson em bpo-36669.)
xml¶
Como atenuação a DTD e recuperação de entidade externa, os módulos xml.dom.minidom
e xml.sax
não processam mais entidades externas por padrão. (Contribuição de Christian Heimes em bpo-17239.)
Os métodos .find*()
no módulo xml.etree.ElementTree
possuem suporte a pesquisas curinga como {*}tag
, que ignora o espaço para nome e {namespace}*
, que retorna todas as tags no espaço para nome especificado. (Contribuição de Stefan Behnel em bpo-28238.)
The xml.etree.ElementTree
module provides a new function
–xml.etree.ElementTree.canonicalize()
that implements C14N 2.0.
(Contributed by Stefan Behnel in bpo-13611.)
O objeto de destino de xml.etree.ElementTree.XMLParser
pode receber eventos de declaração de espaço de nomes através dos novos métodos de retorno de chamada start_ns()
e end_ns ()
. Além disso, o destino xml.etree.ElementTree.TreeBuilder
pode ser configurado para processar eventos sobre comentários e instruções de processamento para incluí-los na árvore gerada. (Contribuição de Stefan Behnel em bpo-36676 e bpo-36673.)
xmlrpc¶
xmlrpc.client.ServerProxy
agora possui suporte a um argumento nomeado headers opcional para que uma sequência de cabeçalhos HTTP seja enviada a cada solicitação. Entre outras coisas, isso possibilita a atualização da autenticação básica padrão para uma autenticação de sessão mais rápida. (Contribuição de Cédric Krier em bpo-35153.)
Otimizações¶
O módulo
subprocess
agora pode usar a funçãoos.posix_spawn()
em alguns casos para obter melhor desempenho. Atualmente, ele é usado apenas no macOS e Linux (usando glibc 2.24 ou mais recente) se todas essas condições forem atendidas:close_fds ser false;
os parâmetros preexec_fn, pass_fds, cwd and start_new_session não estarem definidos;
o caminho executable conter um diretório.
(Contribuição de Joannah Nanjekye e Victor Stinner em bpo-35537.)
shutil.copyfile()
,shutil.copy()
,shutil.copy2()
,shutil.copytree()
eshutil.copytree()
usam chamadas de sistema “fast-copy” específicas da plataforma no Linux e no macOS para copiar o arquivo com mais eficiência. “fast-copy” significa que a operação de cópia ocorre dentro do kernel, evitando o uso de buffers de espaço do usuário no Python como em “outfd.write(infd.read())
”. No Windows,shutil.copyfile()
usa um buffer padrão com tamanho maior (1 MiB em vez de 16 KiB) e é usada uma variante deshutil.copyfileobj()
baseada emmemoryview()
. A velocidade de cópia de um arquivo 512 MiB na mesma partição é de aproximadamente +26% no Linux, +50% no macOS e +40% no Windows. Além disso, muito menos ciclos de CPU são consumidos. Veja a seção Operações de cópia eficientes dependentes da plataforma. (Contribuição de Giampaolo Rodolà em bpo-33671.)shutil.copytree()
usa a funçãoos.scandir()
e todas as funções de cópia que dependem dela usam valores em cache deos.stat()
. A velocidade para copiar um diretório com 8000 arquivos é de cerca de +9% no Linux, +20% no Windows e +30% em um compartilhamento SMB do Windows. Além disso, o número de chamadas de sistemaos.stat()
é reduzido em 38%, tornandoshutil.copytree()
especialmente mais rápida em sistemas de arquivos em rede. (Contribuição de Giampaolo Rodolà em bpo-33695.)O protocolo padrão no módulo
pickle
agora é o Protocolo 4, introduzido pela primeira vez no Python 3.4. Ele oferece melhor desempenho e tamanho menor em comparação com o Protocolo 3 disponível desde o Python 3.0.Removido um membro
Py_ssize_t
dePyGC_Head
. O tamanho de todos os objetos rastreados pelo coletor de lixo (por exemplo, tupla, lista, ditado) é reduzido em 4 ou 8 bytes. (Contribuição de Inada Naoki em bpo-33597.)uuid.UUID
agora usa__slots__
para reduzir seu uso de espaço de memória. (Contribuição de Wouter Bolsterlee e Tal Einat em bpo-30977)Melhor desempenho de
operator.itemgetter()
em 33%. Manipulação de argumento otimizada e incluído um caminho rápido para o caso comum de um único índice inteiro não negativo em uma tupla (que é o caso de uso típico na biblioteca padrão). (Contribuição de Raymond Hettinger em bpo-35664.)Pesquisas de campo aceleradas em
collections.namedtuple()
. Agora elas são duas vezes mais rápidas, tornando-as a forma mais rápida de pesquisa de variáveis de instância no Python. (Contribuição de Raymond Hettinger, Pablo Galindo e Joe Jevnik, Serhiy Storchaka em bpo-32492.)O construtor
list
não atribui globalmente o buffer interno do item se a entrada iterável tiver um comprimento conhecido (a entrada implementa__len__
). Isso torna a lista criada 12% menor em média. (Contribuição de Raymond Hettinger e Pablo Galindo em bpo-33234.)Duplicada a velocidade de gravação de variável de classe. Quando um atributo não-dunder era atualizado, havia uma chamada desnecessária para atualizar os slots. (Contribuição de Stefan Behnel, Pablo Galindo Salgado, Raymond Hettinger, Neil Schemenauer e Serhiy Storchaka em bpo-36012.)
Reduzida a sobrecarga dos argumentos de conversão passados para muitas funções e métodos internos. Isso acelerou chamando algumas funções e métodos internos simples de 20–50%. (Contribuição de Serhiy Storchaka em bpo-23867, bpo-35582 e bpo-36127.)
A instrução
LOAD_GLOBAL
agora usa o novo mecanismo “por cache de código de operação”. É cerca de 40% mais rápido agora. (Contribuição de Yury Selivanov e Inada Naoki em :issue: 26219.)
Mudanças a construções e API C¶
O
sys.abiflags
padrão se tornou uma string vazia: o sinalizadorm
para pymalloc se tornou inútil (compilações com e sem pymalloc são compatíveis com ABI) e, portanto, foi removido. (Contribuição de Victor Stinner em bpo-36707.)Exemplos de alterações:
Somente o programa
python3.8
é instalado, o programapython3.8m
se foi.Somente o script
python3.8-config
é instalado, o programapython3.8m-config
se foi.O sinalizador
m
foi removido do sufixo dos nomes de arquivos da biblioteca dinâmica: módulos de extensão na biblioteca padrão, bem como daqueles produzidos e instalados por pacotes de terceiros, como os baixados do PyPI. No Linux, por exemplo, o sufixo de.cpython-37m-x86_64-linux-gnu.so
do Python 3.7 se tornou.cpython-38-x86_64-linux-gnu.so
no Python 3.8.
Os arquivos de cabeçalho foram reorganizados para separar melhor os diferentes tipos de APIs:
Include/*.h
deve ser a API C pública estável e portátil.Include/cpython/*.h
deve ser a API C instável específica do CPython; API pública, com alguma API privada prefixada por_Py
ou_PY
.Include/internal/*.h
é a API C interna privada muito específica do CPython. Essa API é fornecida sem garantia de compatibilidade com versões anteriores e não deve ser usada fora do CPython. Ele é exposto apenas a necessidades muito específicas, como depuradores e perfis, que precisam acessar os componentes internos do CPython sem chamar funções. Esta API agora está instalada pormake install
.
(Contribuição de Victor Stinner em bpo-35134 e bpo-35081, trabalho iniciado por Eric Snow em Python 3.7.)
Algumas macros foram convertidas em funções in-line estáticas: os tipos de parâmetros e o tipo de retorno são bem definidos, eles não têm problemas específicos para as macros, as variáveis têm escopos locais. Exemplos:
PyObject_INIT()
,PyObject_INIT_VAR()
Funções privadas:
_PyObject_GC_TRACK()
,_PyObject_GC_UNTRACK()
,_Py_Dealloc()
(Contribuição de Victor Stinner em bpo-35059.)
As funções
PyByteArray_Init()
ePyByteArray_Fini()
foram removidas. Elas não faziam nada desde o Python 2.7.4 e o Python 3.2.0, foram excluídas da API limitada (ABI estável) e não foram documentados. (Contribuição de Victor Stinner em bpo-35713.)O resultado de
PyExceptionClass_Name()
agora é do tipoconst char *
em vez dechar *
. (Contribuição de Serhiy Storchaka em bpo-33818.)A dualidade de
Modules/Setup.dist
eModules/Setup
foi removida. Anteriormente, ao atualizar a árvore de fontes do CPython, era necessário copiar manualmenteModules/Setup.dist
(dentro da árvore de fontes) paraModules/Setup
(dentro da árvore de compilação), a fim de refletir todas as alterações upstream. Isso foi um pequeno benefício para os empacotadores, à custa de um aborrecimento frequente para os desenvolvedores após o desenvolvimento do CPython, pois esquecer de copiar o arquivo pode causar falhas na compilação.Agora, o sistema de compilação sempre lê
Modules/Setup
dentro da árvore de fontes. As pessoas que desejam personalizar esse arquivo são incentivadas a manter suas alterações em um fork do git do CPython ou como arquivos de patch, como faria em qualquer outra alteração na árvore de fontes.(Contribuição de Antoine Pitrou em bpo-32430.)
Funções que convertem um número Python em número inteiro C, como
PyLong_AsLong()
, e funções de análise de argumentos, comoPyArg_ParseTuple()
, com unidades de formato de conversão de números inteiros, como'i'
, agora usarão o método especial__index__()
em vez de__int__()
, se disponível. O aviso de descontinuação será emitido para objetos com o método__int__()
, mas sem o método__index__()
(comoDecimal
eFraction
).PyNumber_Check()
agora retornará1
para objetos implementando__index__()
.PyNumber_Long()
,PyNumber_Float()
ePyFloat_AsDouble()
agora também usam o método__index__()
, se disponível. (Contribuição de Serhiy Storchaka em bpo-36048 e bpo-20092.)Objetos de tipo alocado a heap agora aumentarão sua contagem de referências em
PyObject_Init()
(e sua macro paralelaPyObject_INIT
) em vez de emPyType_GenericAlloc()
. Os tipos que modificam a alocação ou desalocação de instância podem precisar ser ajustados. (Contribuição de Eddie Elizondo em bpo-35810.)A nova função
PyCode_NewWithPosOnlyArgs()
permite criar objetos de código comoPyCode_New()
, mas com um parâmetro extra posonlyargcount para indicar o número de argumentos somente posicionais. (Contribuição de Pablo Galindo em bpo-37221.)Py_SetPath()
agora definesys.executable
para o caminho completo do programa (Py_GetProgramFullPath()
) em vez do nome do programa (Py_GetProgramName()
). (Contribuição de Victor Stinner em bpo-38234.)
Descontinuados¶
O comando distutils
bdist_wininst
agora está descontinuado; usebdist_wheel
(pacotes wheel). (Contribuição de Victor Stinner em bpo-37481.)Os métodos descontinuados
getchildren()
egetiterator()
no móduloElementTree
agora emitem umDeprecationWarning
em vez dePendingDeprecationWarning
. Eles serão removidos no Python 3.9. (Contribuição de Serhiy Storchaka em bpo-29209.)Passar um objeto que não é uma instância de
concurrent.futures.ThreadPoolExecutor
paraloop.set_default_executor()
foi descontinuado e será proibido no Python 3.9. (Contribuição de Elvis Pranskevichus em bpo-34075.)Os métodos
__getitem__()
dexml.dom.pulldom.DOMEventStream
,wsgiref.util.FileWrapper
efileinput.FileInput
foram descontinuados.As implementações desses métodos têm ignorado seu parâmetro index e retornado o próximo item. (Contribuição de Berker Peksag em bpo-9372.)
A classe
typing.NamedTuple
descontinuou o atributo_field_types
em favor do atributo__annotations__
que possui as mesmas informações. (Contribuição de Raymond Hettinger em bpo-36320.)As classes
Num
,Str
,Bytes
,NameConstant
eEllipsis
do móduloast
são consideradas descontinuadas e serão removidos em versões futuras do Python. AConstant
deve ser usado. (Contribuição de Serhiy Storchaka em bpo-32892.)Os métodos
visit_Num()
,visit_Str()
,visit_Bytes()
,visit_NameConstant()
evisit_Ellipsis()
da classeast.NodeVisitor
estão agora descontinuados e não serão chamados nas versões futuras do Python. Adicione o métodovisit_Constant()
para manipular todos os nós constantes. (Contribuição de Serhiy Storchaka em bpo-36917.)O decorador de
asyncio.coroutine()
foi descontinuado e será removido na versão 3.10. Em vez de@asyncio.coroutine
, useasync def
. (Contribuição de Andrew Svetlov em bpo-36921.)Em
asyncio
, a passagem explícita de um argumento loop foi descontinuado e será removido na versão 3.10 para os seguintes:asyncio.sleep()
,asyncio.gather()
,asyncio.shield()
,asyncio.wait_for()
,asyncio.wait()
,asyncio.as_completed()
,asyncio.Task
,asyncio.Lock
,asyncio.Event
,asyncio.Condition
,asyncio.Semaphore
,asyncio.BoundedSemaphore
,asyncio.Queue
,asyncio.create_subprocess_exec()
easyncio.create_subprocess_shell()
.A passagem explícita dos objetos da corrotina para
asyncio.wait()
foi descontinuada e será removida na versão 3.11. (Contribuição de Yury Selivanov em bpo-34790.)As seguintes funções e os seguintes métodos estão descontinuados no módulo
gettext
:lgettext()
,ldgettext()
,lngettext()
eldngettext()
. Eles retornam bytes codificados e é possível que você obtenha exceções relacionadas ao Unicode inesperadas se houver problemas de codificação com as strings traduzidas. É muito melhor usar alternativas que retornam strings Unicode no Python 3. Essas funções estiveram quebradas por um longo tempo.A função
bind_textdomain_codeset()
, os métodosoutput_charset()
eset_output_charset()
e o parâmetro codeset das funçõestranslation()
einstall()
também estão descontinuados, pois são usados apenas para as funçõesl*gettext()
. (Contribuição de Serhiy Storchaka em bpo-33710.)The
isAlive()
method ofthreading.Thread
has been deprecated. (Contributed by Donghee Na in bpo-35283.)Muitas funções internas e de extensão que recebem argumentos inteiros agora emitem um aviso de descontinuidade para objetos de
Decimal
, deFraction
e quaisquer outros objetos que possam ser convertidos apenas em números inteiros com perda (por exemplo, que possuem o método__int__()
, mas não têm o método__index__()
). Em uma versão futura, haverá erros. (Contribuição de Serhiy Storchaka em bpo-36048.)Descontinuada a passagem dos seguintes argumentos como argumentos nomeados:
func em
functools.partialmethod()
,weakref.finalize()
,profile.Profile.runcall()
,cProfile.Profile.runcall()
,bdb.Bdb.runcall()
,trace.Trace.runfunc()
ecurses.wrapper()
.function em
unittest.TestCase.addCleanup()
.fn no método
submit()
deconcurrent.futures.ThreadPoolExecutor
econcurrent.futures.ProcessPoolExecutor
.callback em
contextlib.ExitStack.callback()
,contextlib.AsyncExitStack.callback()
econtextlib.AsyncExitStack.push_async_callback()
.c e typeid no método
create()
demultiprocessing.managers.Server
emultiprocessing.managers.SharedMemoryServer
.obj em
weakref.finalize()
.
Em versões futuras do Python, elas serão somente-posicionais. (Contribuição de Serhiy Storchaka em bpo-36492.)
Remoção de APIs e recursos¶
Os seguintes recursos e APIs foram removidos do Python 3.8:
Starting with Python 3.3, importing ABCs from
collections
was deprecated, and importing should be done fromcollections.abc
. Being able to import from collections was marked for removal in 3.8, but has been delayed to 3.9. (See gh-81134.)O módulo
macpath
, descontinuado no Python 3.7, foi removido. (Contribuição de Victor Stinner em bpo-35471.)A função
platform.popen()
foi removida, após ter sido descontinuada desde o Python 3.3: useos.popen()
. (Contribuição de Victor Stinner em bpo-35345.)A função
time.clock()
foi removida, após ter sido descontinuada desde o Python 3.3: usetime.perf_counter()
outime.process_time()
, dependendo de seus requisitos, para ter o comportamento já definido. (Contribuição de Matthias Bussonnier em bpo-36895.)O script
pyvenv
foi removido em favor dopython3.8 -m venv
para ajudar a eliminar a confusão sobre a qual interpretador Python o scriptpyvenv
está associado. (Contribuição de Brett Cannon em bpo-25427.)parse_qs
,parse_qsl
eescape
foram removidos do módulocgi
. Eles foram descontinuados no Python 3.2 ou mais antigo. Eles devem ser importados dos módulosurllib.parse
ehtml
.A função
filemode
foi removida do módulotarfile
. Não é documentada e foi descontinuada desde o Python 3.3.O construtor
XMLParser
não aceita mais o argumento html. Isso nunca teve efeito e foi descontinuado no Python 3.4. Todos os outros parâmetros agora são somente-nomeados. (Contribuição de Serhiy Storchaka em bpo-29209.)Removido o método
doctype()
deXMLParser
. (Contribuição de Serhiy Storchaka em bpo-29209.)O codec “unicode_internal” foi removido. (Contribuição de Inada Naoki em bpo-36297.)
Os objetos
Cache
eStatement
do módulosqlite3
não expostos para o usuário. (Contribuição de Aviv Palivoda em bpo-30262.)O argumento nomeado
bufsize
defileinput.input()
efileinput.FileInput()
, que era ignorado e estava descontinuado desde o Python 3.6, foi removido. bpo-36952 (Contribuição de Matthias Bussonnier.)As funções descontinuadas
sys.set_coroutine_wrapper()
esys.get_coroutine_wrapper()
no Python 3.7 foram removidas; bpo-36933 (Contribuição de Matthias Bussonnier.)
Portando para o Python 3.8¶
Esta seção lista as alterações descritas anteriormente e outras correções que podem exigir alterações no seu código.
Alterações no comportamento do Python¶
Expressões yield (ambas as cláusulas
yield
eyield from
) agora não são permitidas nas compreensões e expressões geradoras (além da expressão iterável na cláusula mais à esquerdafor
). (Contribuição de Serhiy Storchaka em bpo-10544.)Agora, o compilador produz um
SyntaxWarning
quando verificações de identidade (is
eis not
) são usadas com certos tipos de literais (por exemplo, strings, números). Geralmente, eles podem funcionar acidentalmente no CPython, mas não são garantidos pelas especificações da linguagem. O aviso aconselha os usuários a usar testes de igualdade (==
e!=
). (Contribuição de Serhiy Storchaka em bpo-34850.)O interpretador do CPython pode engolir exceções em algumas circunstâncias. No Python 3.8, isso acontece em menos casos. Em particular, as exceções levantadas ao obter o atributo do dicionário de tipos não são mais ignoradas. (Contribuição de Serhiy Storchaka em bpo-35459.)
Removidas as implementações
__str__
dos tipos embutidosbool
,int
,float
,complex
e poucas classes da biblioteca padrão. Agora eles herdam__str__()
deobject
. Como resultado, definir o método__repr__()
na subclasse dessas classes afetará sua representação de string. (Contribuição de Serhiy Storchaka em bpo-36793.)No AIX,
sys.platform
não contém mais a versão principal. É sempre'aix'
, em vez de'aix3'
..'aix7'
. Como as versões mais antigas do Python incluem o número da versão, é recomendável usar sempresys.platform.startswith('aix')
. (Contribuição de M. Felt em bpo-36588.)PyEval_AcquireLock()
ePyEval_AcquireThread()
agora encerram a thread atual se chamado enquanto o interpretador está finalizando, tornando-os consistentes comPyEval_RestoreThread()
,Py_END_ALLOW_THREADS()
ePyGILState_Ensure()
. Se esse comportamento não for desejado, proteja a chamada verificando_Py_IsFinalizing()
ousys.is_finalizing()
. (Contribuição de Joannah Nanjekye em bpo-36475.)
Alterações na API Python¶
A função
os.getcwdb()
agora usa a codificação UTF-8 no Windows, em vez da página de códigos ANSI: veja PEP 529 para a justificativa. A função não é mais descontinuada no Windows. (Contribuição de Victor Stinner em bpo-37412.)subprocess.Popen
agora pode usaros.posix_spawn()
em alguns casos, para obter melhor desempenho. No Windows Subsystem para Linux e emulação de usuário QEMU, o construtorPopen
usandoos.posix_spawn()
não levanta mais uma exceção em erros como “missing program”. Em vez disso, o processo filho falha com um diferente de zeroreturncode
. (Contribuição de Joannah Nanjekye e Victor Stinner em bpo-35537.)O argumento preexec_fn de *
subprocess.Popen
não é mais compatível com subinterpretadores. O uso do parâmetro em um subinterpretador agora levantaRuntimeError
. (Contribuição de Eric Snow em bpo-34651, modificado por Christian Heimes em bpo-37951.)O método
imap.IMAP4.logout()
não mais ignora silenciosamente exceções arbitrárias. (Contribuição de Victor Stinner em bpo-36348.)A função
platform.popen()
foi removida, após ter sido descontinuada desde o Python 3.3: useos.popen()
. (Contribuição de Victor Stinner em bpo-35345.)A função
Statistics.mode()
não levanta mais uma exceção quando dados multimodais são fornecidos. Em vez disso, ela retorna o primeiro modo encontrado nos dados de entrada. (Contribuição de Raymond Hettinger em bpo-35892.)O método
selection()
da classetkinter.ttk.Treeview
não recebe mais argumentos. Seu uso com argumentos para alterar a seleção foi descontinuado no Python 3.6. Use métodos especializados comoselection_set()
para alterar a seleção. (Contribuição de Serhiy Storchaka em bpo-31508.)Os métodos
writexml()
,toxml()
etoprettyxml()
dexml.dom.minidom
, e o métodowrite()
dexml.etree
, agora preservam a ordem dos atributos especificados pelo usuário. (Contribuição de Diego Rojas e Raymond Hettinger em bpo-34160.)Um banco de dados
dbm.dumb
aberto com sinalizadores'r'
agora é somente leitura.dbm.dumb.open()
com os sinalizadores'r'
e'w'
não cria mais um banco de dados se ele não existir. (Contribuição de Serhiy Storchaka em bpo-32749.)O método
doctype()
definido em uma subclasse deXMLParser
não será mais chamado e emitirá umRuntimeWarning
em vez de umDeprecationWarning
. Defina o métododoctype()
em um alvo para manipular uma declaração doctype XML. (Contribuição de Serhiy Storchaka em bpo-29209.)Uma
RuntimeError
agora é levantada quando a metaclasse personalizada não fornece a entrada__classcell__
no espaço de nomes passado paratype.__new__
. UmaDeprecationWarning
era emitida no Python 3.6-3.7. (Contribuição de Serhiy Storchaka em bpo-23722.)A classe
cProfile.Profile
agora pode ser usada como um gerenciador de contexto. (Contribuição de Scott Sanderson em bpo-29235.)shutil.copyfile()
,shutil.copy()
,shutil.copy2()
,shutil.copytree()
eshutil.copytree()
usam chamadas de sistema de “cópia rápido” específica da plataforma (veja a seção Operações de cópia eficientes dependentes da plataforma).O tamanho padrão do buffer de
shutil.copyfile()
no Windows foi alterado de 16 KiB para 1 MiB.A estrutura de
PyGC_Head
mudou completamente. Todo o código que tocava no membro struct deve ser reescrito. (Veja bpo-33597.)A estrutura de
PyInterpreterState
foi movida para os arquivos de cabeçalho “internal” (especificamente Include/internal/pycore_pystate.h). UmPyInterpreterState
opaco ainda está disponível como parte da API pública (e ABI estável). Os documentos indicam que nenhum dos campos da estrutura é público, por isso esperamos que ninguém os tenha usado. No entanto, se você confia em um ou mais desses campos em particular e não tiver alternativa, abra um relatório de erro no BPO. Vamos trabalhar para ajudá-lo a ajustar (possivelmente incluindo a adição de funções de acessador à API pública). (Veja bpo-35886.)O método
mmap.flush()
agora retornaNone
com êxito e levanta uma exceção no erro em todas as plataformas. Anteriormente, seu comportamento dependia da plataforma: um valor diferente de zero era retornado com êxito; zero era retornado com erro no Windows. Um valor zero era retornado com sucesso; uma exceção era levanta no caso de erro no Unix. (Contribuição de Berker Peksag em bpo-2122.)Os módulos
xml.dom.minidom
exml.sax
não mais processam entidades externas por padrão. (Contribuição de Christian Heimes em bpo-17239.)A exclusão de uma chave de um banco de dados somente leitura
dbm
(dbm.dumb
,dbm.gnu
oudbm.ndbm
) levantaerror
(dbm.dumb.error
,dbm.gnu.error
oudbm.ndbm.error
) em vez deKeyError
. (Contribuição de Xiang Zhang em bpo-33106.)AST foi simplificado para literais. Todas as constantes serão representadas como instâncias de
ast.Constant
. Instanciar classes antigasNum
,Str
,Bytes
,NameConstant
eEllipsis
retornará uma instância deConstant
. (Contribuição de Serhiy Storchaka em bpo-32892.)expanduser()
no Windows agora prefere a variável de ambienteUSERPROFILE
e não usaHOME
, que normalmente não é definido para contas de usuário comuns. (Contribuição de Anthony Sottile em bpo-36264.)A exceção
asyncio.CancelledError
agora herda deBaseException
em vez deException
e não mais herda deconcurrent.futures.CancelledError
. (Contribuição de Yury Selivanov em bpo-32528.)A função
asyncio.wait_for()
agora aguarda corretamente o cancelamento ao usar uma instância deasyncio.Task
. Anteriormente, ao atingir tempo limite, ele era cancelado e devolvido imediatamente. (Contribuição de Elvis Pranskevichus em bpo-32751.)A função
asyncio.BaseTransport.get_extra_info()
agora retorna um objeto soquete seguro de usar quando ‘socket’ é passado para o parâmetro name. (Contribuição de Yury Selivanov em bpo-37027.)asyncio.BufferedProtocol
foi promovida a API estável.
As dependências de DLL para módulos de extensão e DLLs carregadas com
ctypes
no Windows agora são resolvidas com mais segurança. Somente os caminhos do sistema, o diretório que contém o arquivo DLL ou PYD e os diretórios adicionados comadd_dll_directory()
são pesquisados por dependências de tempo de carregamento. Especificamente,PATH
e o diretório de trabalho atual não são mais usados, e as modificações nelas não terão mais efeito na resolução normal da DLL. Se seu aplicativo conta com esses mecanismos, você deve verificaradd_dll_directory()
e, se existir, use-o para adicionar seu diretório DLLs ao carregar sua biblioteca. Observe que os usuários do Windows 7 precisarão garantir que o Windows Update KB2533623 esteja instalado (isso também é verificado pelo instalador). (Contribuição de Steve Dower em bpo-36085.)Os arquivos de cabeçalho e as funções relacionadas ao pgen foram removidos após sua substituição por uma implementação pura do Python. (Contribuição de Pablo Galindo em bpo-36623.)
types.CodeType
possui um novo parâmetro na segunda posição do construtor (posonlyargcount *) para suportar argumentos apenas de posição definidos em :pep:`570`. O primeiro argumento (*argcount) agora representa o número total de argumentos posicionais (incluindo argumentos somente posicionais). O novo métodoreplace()
detypes.CodeType
pode ser usado para tornar o código à prova de futuro.O parâmetro
digestmod
parahmac.new()
não usa mais o resumo MD5 por padrão.
Alterações na API C¶
A estrutura
PyCompilerFlags
recebeu um novo campo cf_feature_version. Ele deve ser inicializado paraPY_MINOR_VERSION
. O campo é ignorado por padrão e é usado se e somente se o sinalizadorPyCF_ONLY_AST
estiver definido em cf_flags. (Contribuição de Guido van Rossum em bpo-35766.)A função
PyEval_ReInitThreads()
foi removida da API C. Não deve ser chamada explicitamente: usePyOS_AfterFork_Child()
. (Contribuição de Victor Stinner em bpo-36728.)No Unix, as extensões C não estão mais vinculadas ao libpython, exceto no Android e Cygwin. Quando o Python é incorporado,
libpython
não deve ser carregado comRTLD_LOCAL
, masRTLD_GLOBAL
. Anteriormente, usandoRTLD_LOCAL
, já não era possível carregar extensões C que não estavam vinculadas alibpython
, como extensões C da biblioteca padrão criada pela seção*shared*
deModules/Setup
. (Contribuição de Victor Stinner em bpo-21536.)O uso de variantes
#
de formatos na análise ou construção de valor (por exemplo,PyArg_ParseTuple()
,Py_BuildValue()
,PyObject_CallFunction()
, etc.) semPY_SSIZE_T_CLEAN
definido agora levantaDeprecationWarning
. Será removido em 3.10 ou 4.0. Leia Análise de argumentos e construção de valores para detalhes. (Contribuição de Inada Naoki em bpo-36381.)Instâncias de tipos alocados por heap (como aqueles criados com
PyType_FromSpec()
) mantêm uma referência ao seu objeto de tipo. O aumento da contagem de referências desses objetos de tipo foi movido dePyType_GenericAlloc()
para as funções de nível mais baixo,PyObject_Init()
ePyObject_INIT()
. Isso faz com que os tipos criados através dePyType_FromSpec()
se comportem como outras classes no código gerenciado.Tipos alocados estaticamente não são afetados.
Para a grande maioria dos casos, não deve haver efeito colateral. No entanto, tipos que aumentam manualmente a contagem de referência após alocar uma instância (talvez para solucionar o bug) agora podem se tornar imortais. Para evitar isso, essas classes precisam chamar Py_DECREF no objeto de tipo durante a desalocação da instância.
Para portar corretamente esses tipos para o 3.8, aplique as seguintes alterações:
Remove
Py_INCREF
no objeto de tipo depois de alocar uma instância – se houver. Isso pode acontecer após a chamada dePyObject_New
,PyObject_NewVar
,PyObject_GC_New()
,PyObject_GC_NewVar()
ou qualquer outro alocador personalizado que usePyObject_Init()
ouPyObject_INIT()
.Exemplo:
static foo_struct * foo_new(PyObject *type) { foo_struct *foo = PyObject_GC_New(foo_struct, (PyTypeObject *) type); if (foo == NULL) return NULL; #if PY_VERSION_HEX < 0x03080000 // Workaround for Python issue 35810; no longer necessary in Python 3.8 PY_INCREF(type) #endif return foo; }
Certifica-se de que todas as funções
tp_dealloc
personalizadas de tipos alocados em heap diminuam a contagem de referências do tipo.Exemplo:
static void foo_dealloc(foo_struct *instance) { PyObject *type = Py_TYPE(instance); PyObject_GC_Del(instance); #if PY_VERSION_HEX >= 0x03080000 // This was not needed before Python 3.8 (Python issue 35810) Py_DECREF(type); #endif }
(Contribuição de Eddie Elizondo em bpo-35810.)
A macro
Py_DEPRECATED()
foi implementada para MSVC. A macro agora deve ser colocada antes do nome do símbolo.Exemplo:
Py_DEPRECATED(3.8) PyAPI_FUNC(int) Py_OldFunction(void);
(Contribuição de Zackery Spytz em bpo-33407.)
O interpretador não pretende mais dar suporte à compatibilidade binária de tipos de extensão nas liberações de recursos. O
PyTypeObject
exportado por um módulo de extensão de terceiros deve ter todos os slots esperados na versão atual do Python, incluindotp_finalize
(Py_TPFLAGS_HAVE_FINALIZE
não é mais verificado antes de lertp_finalize
).(Contribuição de Antoine Pitrou em bpo-32388.)
As funções
PyNode_AddChild()
ePyParser_AddToken()
agora aceitam dois argumentos adicionaisint
end_lineno e end_col_offset.O arquivo
libpython38.a
para permitir que as ferramentas do MinGW se vinculem diretamente apython38.dll
não está mais incluído na distribuição regular do Windows. Se você precisar deste arquivo, ele poderá ser gerado com as ferramentasgendef
edlltool
, que fazem parte do pacote binutils do MinGW:gendef - python38.dll > tmp.def dlltool --dllname python38.dll --def tmp.def --output-lib libpython38.a
A localização de um arquivo
pythonXY.dll
dependerá das opções de instalação e da versão e idioma do Windows. Consulte Utilizando Python no Windows para mais informações. A biblioteca resultante deve ser colocada no mesmo diretório quepythonXY.lib
, que geralmente é o diretóriolibs
na sua instalação do Python.(Contribuição de Steve Dower em bpo-37351.)
Alterações de bytecode do CPython¶
O loop do interpretador foi simplificado movendo a lógica de desenrolar a pilha de blocos no compilador. O compilador agora emite instruções explícitas para ajustar a pilha de valores e chamar o código de limpeza para
break
,continue
ereturn
.Removidos os códigos de operação
BREAK_LOOP
,CONTINUE_LOOP
,SETUP_LOOP
eSETUP_EXCEPT
. Adicionados novos códigos de operaçãoROT_FOUR
,BEGIN_FINALLY
,CALL_FINALLY
ePOP_FINALLY
. Alterado o comportamento deEND_FINALLY
eWITH_CLEANUP_START
.(Contribuição de Mark Shannon, Antoine Pitrou e Serhiy Storchaka em bpo-17611.)
Adicionado novo código de operação
END_ASYNC_FOR
para lidar com exceções geradas ao aguardar um próximo item em um loopasync for
. (Contribuição de Serhiy Storchaka em bpo-33041.)O
MAP_ADD
agora espera o valor como o primeiro elemento na pilha e a chave como o segundo elemento. Essa alteração foi feita para que a chave seja sempre avaliada antes do valor na compreensão do dicionário, conforme proposto em PEP 572. (Contribuição de Jörn Heissler em bpo-35224.)
Ferramentas e daemons¶
Adicionado um script de benchmark para cronometrar várias maneiras de acessar variáveis: Tools/scripts/var_access_benchmark.py
. (Contribuição de Raymond Hettinger em bpo-35884.)
Aqui está um resumo das melhorias de desempenho desde Python 3.3:
Python version 3.3 3.4 3.5 3.6 3.7 3.8
-------------- --- --- --- --- --- ---
Variable and attribute read access:
read_local 4.0 7.1 7.1 5.4 5.1 3.9
read_nonlocal 5.3 7.1 8.1 5.8 5.4 4.4
read_global 13.3 15.5 19.0 14.3 13.6 7.6
read_builtin 20.0 21.1 21.6 18.5 19.0 7.5
read_classvar_from_class 20.5 25.6 26.5 20.7 19.5 18.4
read_classvar_from_instance 18.5 22.8 23.5 18.8 17.1 16.4
read_instancevar 26.8 32.4 33.1 28.0 26.3 25.4
read_instancevar_slots 23.7 27.8 31.3 20.8 20.8 20.2
read_namedtuple 68.5 73.8 57.5 45.0 46.8 18.4
read_boundmethod 29.8 37.6 37.9 29.6 26.9 27.7
Variable and attribute write access:
write_local 4.6 8.7 9.3 5.5 5.3 4.3
write_nonlocal 7.3 10.5 11.1 5.6 5.5 4.7
write_global 15.9 19.7 21.2 18.0 18.0 15.8
write_classvar 81.9 92.9 96.0 104.6 102.1 39.2
write_instancevar 36.4 44.6 45.8 40.0 38.9 35.5
write_instancevar_slots 28.7 35.6 36.1 27.3 26.6 25.7
Data structure read access:
read_list 19.2 24.2 24.5 20.8 20.8 19.0
read_deque 19.9 24.7 25.5 20.2 20.6 19.8
read_dict 19.7 24.3 25.7 22.3 23.0 21.0
read_strdict 17.9 22.6 24.3 19.5 21.2 18.9
Data structure write access:
write_list 21.2 27.1 28.5 22.5 21.6 20.0
write_deque 23.8 28.7 30.1 22.7 21.8 23.5
write_dict 25.9 31.4 33.3 29.3 29.2 24.7
write_strdict 22.9 28.4 29.9 27.5 25.2 23.1
Stack (or queue) operations:
list_append_pop 144.2 93.4 112.7 75.4 74.2 50.8
deque_append_pop 30.4 43.5 57.0 49.4 49.2 42.5
deque_append_popleft 30.8 43.7 57.3 49.7 49.7 42.8
Timing loop:
loop_overhead 0.3 0.5 0.6 0.4 0.3 0.3
Os benchmarks foram medidos em um processador Intel® Core™ i7-4960HQ nos sistemas macOS 64-bit encontrados em python.org. O script de benchmark exibe tempos em nanossegundos.
Alterações notáveis no Python 3.8.1¶
Devido a significativas preocupações de segurança, o parâmetro reuse_address de asyncio.loop.create_datagram_endpoint()
não é mais suportado. Isso ocorre devido ao comportamento da opção de soquete SO_REUSEADDR
no UDP. Para mais detalhes, consulte a documentação de loop.create_datagram_endpoint()
. (Contribuição de Kyle Stanley, Antoine Pitrou e Yury Selivanov em bpo-37228.)
Alterações notáveis no Python 3.8.2¶
Corrigida uma regressão com o retorno de chamada ignore
de shutil.copytree()
. Os tipos de argumento agora são str e List[str] novamente. (Contribuição de Manuel Barkhau e Giampaolo Rodola em gh-83571.)
Alterações notáveis no Python 3.8.3¶
Os valores constantes dos futuros sinalizadores no módulo __future__
fpram atualizados para evitar colisão com os sinalizadores do compilador. Anteriormente, PyCF_ALLOW_TOP_LEVEL_AWAIT
estava colidindo com CO_FUTURE_DIVISION
. (Contribuição de Batuhan Taskaya em gh-83743)
Alterações notáveis no Python 3.8.8¶
Versões anteriores do Python permitiam o uso de ;
e &
como separadores de parâmetros de consulta nas funções urllib.parse.parse_qs()
e urllib.parse.parse_qsl()
. Devido a questões de segurança, e em conformidade com as recomendações mais recentes do W3C, isso foi alterado para permitir apenas uma única chave separadora, com &
como padrão. Esta mudança também afeta as funções cgi.parse()
e cgi.parse_multipart()
já que elas usam as funções afetadas internamente. Para obter mais detalhes, consulte sua respectiva documentação. (Contribuição de Adam Goldschmidt, Senthil Kumaran e Ken Jin em bpo-42967.)
Alterações notáveis no Python 3.8.9¶
Uma correção de segurança altera o comportamento ftplib.FTP
para não confiar no endereço IPv4 enviado do servidor remoto ao configurar um canal de dados passivo. Em vez disso, reutilizamos o endereço IP do servidor ftp. Para códigos incomuns que requerem o comportamento antigo, defina um atributo trust_server_pasv_ipv4_address
em sua instância de FTP para True
. (Veja gh-87451)
Alterações notáveis no Python 3.8.10¶
Suporte a macOS 11.0 (Big Sur) e Apple Silicon Mac¶
A partir do 3.8.10, Python oferece suporte total à construção e execução no macOS 11 (Big Sur) e no Apple Silicon Macs (baseado na arquitetura ARM64
). Uma nova variante de compilação universal, universal2
, está agora disponível com suporte nativo para ARM64
e Intel 64
em um conjunto de executáveis. Observe que suporte para “ligação fraca”, criar binários direcionados para versões mais recentes do macOS que também serão executados corretamente em versões mais antigas através da verificação em tempo de execução por recursos ausentes, não está mais incluída de forma retroativa do Python 3.9; para oferece suporte a uma gama de versões do macOS, continue a visar e a desenvolver para a versão mais antiga do intervalo.
(Contribuição original de Ronald Oussoren e Lawrence D’Anna em gh-85272, com correções de FX Coudert e Eli Rykoff, e portado para a versão 3.8 por Maxime Bélanger e Ned Deily)
Alterações notáveis no Python 3.8.10¶
urllib.parse¶
A presença de caracteres de nova linha ou tab em partes de um URL permite algumas formas de ataques. Seguindo a especificação WHATWG que atualiza RFC 3986, nova linha ASCII \n
, \r
e os caracteres de tabulação \t
são retirados da URL pelo analisador sintático em urllib.parse
impedindo tais ataques. Os caracteres de remoção são controlados por uma nova variável de nível de módulo urllib.parse._UNSAFE_URL_BYTES_TO_REMOVE
. (Veja bpo-43882)
Alterações notáveis no Python 3.8.12¶
Alterações na API Python¶
A partir do Python 3.8.12, o módulo ipaddress
não aceita mais zeros à esquerda em strings de endereço IPv4. Os zeros à esquerda são ambíguos e interpretados como notação octal por algumas bibliotecas. Por exemplo, a função legada socket.inet_aton()
trata os zeros à esquerda como notação octal. A implementação glibc de inet_pton()
moderna não aceita nenhum zeros à esquerda.
(Originalmente contribuição de Christian Heimes em bpo-36384 e backport para 3.8 por Achraf Merzouki.)
Recursos de segurança notáveis no 3.8.14¶
Converter entre int
e str
em bases diferentes de 2 (binário), 4, 8 (octal), 16 (hexadecimal) ou 32 como base 10 (decimal) agora levanta uma exceção ValueError
se o número de dígitos em forma de string estiver acima de um limite para evitar possíveis ataques de negação de serviço devido à complexidade algorítmica. Esta é uma mitigação para CVE 2020-10735. Este limite pode ser configurado ou desabilitado por variável de ambiente, sinalizador de linha de comando ou APIs de sys
. Veja a documentação de limitação de comprimento de conversão de string inteira. O limite padrão é de 4300 dígitos em forma de string.
Alterações notáveis no 3.8.17¶
tarfile¶
Os métodos de extração em
tarfile
eshutil.unpack_archive()
, têm um novo argumento filter que permite limitar recursos do tar que podem ser surpreendentes ou perigosos, como criar arquivos fora do diretório de destino. Veja Filtros de extração para detalhes. No Python 3.12, usar sem o argumento filter mostrará umDeprecationWarning
. No Python 3.14, o padrão mudará para'data'
. (Contribuição de Petr Viktorin em PEP 706.)