errata

Author: ramalho

online/Prefacio.adoc

@@ -81,12 +81,12 @@ Criar sequências definidas pelo usuário só é discutido na <<classes_protocol
 Criar suas próprias ABCs é discutido ainda mais tarde, na <<classes_protocols_part>>, pois acredito na importância de estar confortável usando uma ABC antes de escrever uma.
 
 Essa abordagem tem algumas vantagens.
-Primeiro, saber o que está disponivel para uso imediato pode evitar que você reinvente a roda. Usamos as classes de coleções existentes com mais frequência que implementamos nossas próprias coleções, e podemos prestar mais atenção ao uso avançado de ferramentas prontas adiando a discussão sobre a criação de novas ferramentas.
-Também é mais provável herdamos de ABCs existentes que criar uma nova ABC do zero.
+Primeiro, saber o que está disponivel para uso imediato pode evitar que você reinvente a roda. Usamos as classes de coleções existentes com mais frequência que implementamos nossas próprias coleções, e podemos prestar mais atenção ao uso avançado de ferramentas prontas, adiando a discussão sobre a criação de novas ferramentas.
+Também é mais provável herdar de ABCs existentes que criar uma nova ABC do zero.
 E, finalmente, acredito ser mais fácil entender as abstrações após vê-las em ação.
 
 A desvantagem dessa estratégia são as referências a pontos futuros espalhadas pelo livro.
-Acredito que isso é mais fácil de tolerar agora que você sabe porque escolhi esse caminho.
+Espero que isso seja mais fácil de tolerar agora que você sabe porque escolhi esse caminho.
 
 
 ==== Cinco livros em um
@@ -216,11 +216,8 @@ Sebastopol, CA 95472
 707-829-0104 (fax)
 ----
 
-Há uma página online para este livro, com erratas, exemplos e informação adicional, que pode ser acessada aqui: https://fpy.li/p-4.
-
-++++
-<!--Don't forget to update the link above.-->
-++++
+Há uma página online para o original em inglês deste livro, com erratas e informação adicional,
+que pode ser acessada aqui: https://fpy.li/p-4.
 
 Envie email para _bookquestions@oreilly.com_, com comentários ou dúvidas técnicas sobre o livro.
 

online/cap02.adoc

@@ -2256,7 +2256,7 @@ memmap([ 3016362.69195522,   535281.10514262,  4566560.44373946])
 <1> Carrega 10 milhões de números de ponto flutuante de um arquivo de texto.
 <2> Usa a notação de fatiamento de sequência para inspecionar os três últimos números.
 <3> Multiplica cada elemento no array `floats` por `.5` e inspeciona novamente os três últimos elementos.
-<4> Importa o cronômetro de medida de tempo em alta resolução (disponível desde Python 3.3).
+<4> Importa o cronômetro de medida de tempo em alta resolução (disponível desde o Python 3.3).
 
 <5> Divide cada elemento por `3`;
 o tempo decorrido para dividir os 10 milhões de números de ponto flutuante é menos de 40 milissegundos.

online/cap03.adoc

@@ -44,10 +44,10 @@ A((("dictionaries and sets", "significant changes to"))) maior parte das mudanç
 segunda edição se concentra em novos recursos relacionados a tipos de mapeamento:
 
 * A <<modern_dict_syntax_sec>> fala da sintaxe aperfeiçoada de desempacotamento
-e de diferentes maneiras de mesclar mapeamentos—incluindo os operadores `|` e `|=`, suportados pelos `dicts` desde Python 3.9.
+e de diferentes maneiras de mesclar mapeamentos—incluindo os operadores `|` e `|=`, suportados pelos `dicts` desde o Python 3.9.
 * A <<pattern_matching_mappings_sec>> ilustra o manuseio de mapeamentos com `match/case`, recurso que surgiu no Python 3.10.
 * A <<ordereddict_sec>> agora se concentra nas pequenas mas ainda relevantes diferenças entre
-`dict` e `OrderedDict`—levando em conta que, desde Python 3.6, `dict` passou a manter a ordem de inserção das chaves.
+`dict` e `OrderedDict`—levando em conta que, desde o Python 3.6, `dict` passou a manter a ordem de inserção das chaves.
 * Novas seções sobre os objetos view devolvidos por `dict.keys`, `dict.items`, e `dict.values`:
 a <<dictionary_views_sec>> e a <<set_ops_dict_views_sec>>.
 
@@ -65,7 +65,7 @@ para o http://fluentpython.com, o site que complementa o livro.
 O https://fpy.li/hashint[post de 18 páginas] (EN) foi atualizado e expandido, e inclui explicações e diagramas sobre:
 
 * O algoritmo de tabela de hash e as estruturas de dados, começando por seu uso em `set`, que é mais simples de entender.
-* A otimização de memória que preserva a ordem de inserção de chaves em instâncias de `dict` (desde Python 3.6) .
+* A otimização de memória que preserva a ordem de inserção de chaves em instâncias de `dict` (desde o Python 3.6) .
 * O layout do compartilhamento de chaves em dicionários que mantêm atributos de
 instância—o `+__dict__+` de objetos definidos pelo usuário (otimização implementada no Python 3.3).
 ====
@@ -129,7 +129,7 @@ Caso contrário, a propagação da sintaxe de compreensão mostra que agora é m
 
 A https://fpy.li/pep448[PEP 448—Additional Unpacking Generalizations (_Generalizações de Desempacotamento Adicionais_)]
 melhorou o suporte ao desempacotamento de mapeamentos((("unpacking", "mapping unpackings")))((("mappings", "unpacking")))
-de duas formas, desde Python 3.5.
+de duas formas, desde o Python 3.5.
 
 Primeiro, podemos((("&#x002A;&#x002A; (double star) operator")))((("double star (&#x002A;&#x002A;) operator")))
 aplicar `**` a mais de um argumento em uma chamada de função.
@@ -758,7 +758,7 @@ os tipos de mapeamentos incluídos na biblioteca padrão diferentes de `defaultd
 ==== collections.OrderedDict
 
 Agora((("collections.abc module", "defaultdict and OrderedDict")))((("OrderedDict"))) que o `dict` embutido
-também mantém as chaves ordenadas (desde Python 3.6),
+também mantém as chaves ordenadas (desde o Python 3.6),
 o motivo mais comum para usar `OrderedDict` é escrever código compatível com versões anteriores de Python.
 Dito isso, a documentação lista algumas diferenças entre `dict` e `OrderedDict` que
 ainda persistem e que cito aqui:
@@ -1399,7 +1399,7 @@ Por exemplo, para produzir a união de quatro coleções, `a`, `b`, `c`, e `d`,
 `a.union(b, c, d)`, onde `a` precisa ser um `set`,
 mas `b`, `c`, e `d` podem ser iteráveis de qualquer tipo que produza itens hashable.
 Para criar um novo conjunto com a união de quatro iteráveis,
-desde Python 3.5 você pode escrever `{*a, *b, *c, *d}` ao invés de atualizar um conjunto existente, graças à
+desde o Python 3.5 você pode escrever `{*a, *b, *c, *d}` ao invés de atualizar um conjunto existente, graças à
 https://fpy.li/pep448[PEP 448—Additional Unpacking Generalizations (_Generalizações de Desempacotamento Adicionais_)].
 
 ====

online/cap04.adoc

@@ -46,7 +46,7 @@ então o acréscimo mais notável é a <<finding_chars_sec>>,
 descrevendo um utilitário de linha de comando para busca no banco de dados Unicode—uma forma de encontrar
 gatinhos sorridentes ou hieroglifos do Egito antigo.
 
-Vale a pena mencionar que o suporte a Unicode no Windows ficou melhor e mais simples desde Python 3.6,
+Vale a pena mencionar que o suporte a Unicode no Windows ficou melhor e mais simples desde o Python 3.6,
 como veremos na <<encoding_defaults>>.
 
 Vamos começar então com os conceitos não-tão-novos mas fundamentais de caracteres, pontos de código e bytes.
@@ -210,7 +210,7 @@ como `endswith`, `replace`, `strip`, `translate`, `upper` e dezenas de outros,
 com sequências binárias—mas com argumentos `bytes` em vez de `str`.
 Além disso, as funções de expressões regulares no módulo `re` também funcionam com sequências binárias,
 se a regex for compilada a partir de uma sequência binária ao invés de uma `str`.
-Desde Python 3.5, o operador `%` voltou a funcionar com sequências binárias.footnote:[Ele não funcionava de Python 3.0 ao 3.4,
+Desde o Python 3.5, o operador `%` voltou a funcionar com sequências binárias.footnote:[Ele não funcionava de Python 3.0 ao 3.4,
 causando muitas dores de cabeça nos desenvolvedores que lidam com dados binários.
 A decisão está documentada na
 https://fpy.li/pep461[PEP 461--Adding % formatting to bytes and bytearray (_Acrescentando formatação com % a bytes e bytearray_)]. (EN)]
@@ -1768,7 +1768,7 @@ Para ajudar no processamento manual de sequências `str` ou `bytes` que são nom
 o módulo `os` fornece funções especiais de codificação e decodificação,
 `os.fsencode(name_or_path)` e `os.fsdecode(name_or_path)`.
 Ambas as funções aceitam argumentos dos tipos `str`, `bytes` ou,
-desde Python 3.6, um objeto que implemente a interface `os.PathLike`.
+desde o Python 3.6, um objeto que implemente a interface `os.PathLike`.
 
 O Unicode é um buraco de coelho bem fundo.
 É hora de encerrar nossa exploração de `str` e `bytes`.((("", startref="UTVdual04")))((("", startref="Sdual04")))
@@ -2024,7 +2024,7 @@ Na memória, Python 3 armazena cada `str` como uma sequência de pontos de códi
 usando um número fixo de bytes por ponto de código,
 para permitir o acesso direto eficiente a qualquer caractere ou fatia.
 
-Desde Python 3.3, ao criar um novo objeto `str`
+Desde o Python 3.3, ao criar um novo objeto `str`
 o interpretador verifica os caracteres no objeto,
 e escolhe o layout de memória mais econômico que seja adequado para aquela `str` em particular:
 se existirem apenas caracteres na faixa `latin1`, aquela `str` vai usar apenas um byte por ponto de código.

online/cap05.adoc

@@ -151,7 +151,7 @@ Além de ser mais legível, essa forma permite fornecer o mapeamento de campos e
 tipos como `**fields_and_types`.
 ====
 
-Desde Python 3.6, `typing.NamedTuple` pode também ser usada em uma instrução `class`,
+Desde o Python 3.6, `typing.NamedTuple` pode também ser usada em uma instrução `class`,
 com as anotações de tipo escritas como descrito na
 https://fpy.li/pep526[PEP 526—Syntax for Variable Annotations (_Sintaxe para Anotações de Variáveis_)] (EN).
 É mais legível, e torna fácil  sobrescrever métodos ou acrescentar métodos novos.
@@ -398,14 +398,14 @@ o método de classe `_make(iterable)`, e o método de instância `_asdict()`.
 [WARNING]
 =====
 Até Python 3.7, o método `_asdict` devolvia um `OrderedDict`.
-Desde Python 3.8, ele devolve um `dict` simples—o que não é problema,
+Desde o Python 3.8, ele devolve um `dict` simples—o que não é problema,
 agora que podemos confiar na ordem de inserção das chaves.
 Se você precisar de um `OrderedDict`, a
 https://fpy.li/3q[documentação do `_asdict`] (EN)
 recomenda criar um com o resultado: `OrderedDict(x._asdict())`.
 =====
 
-Desde Python 3.7, a `namedtuple` aceita o argumento nomeado `defaults`,
+Desde o Python 3.7, a `namedtuple` aceita o argumento nomeado `defaults`,
 fornecendo um iterável de N valores default para cada um dos N campos mais à direita na definição da classe.
 O <<ex_coord_tuple_default>> mostra como definir uma tupla nomeada
 `Coordinate` com um valor default para o campo `reference`.
@@ -1009,7 +1009,7 @@ include::../code/05-data-classes/dataclass/club_generic.py[]
 ====
 <1> `list[str]` significa "uma lista de str."
 
-A nova sintaxe `list[str]` é um tipo genérico parametrizado: desde Python 3.9,
+A nova sintaxe `list[str]` é um tipo genérico parametrizado: desde o Python 3.9,
 o tipo embutido `list` aceita aquela notação com colchetes para especificar o tipo dos itens da lista.
 
 [WARNING]
@@ -1158,7 +1158,7 @@ Found 1 error in 1 file (checked 1 source file)
 
 Infelizmente, a dica fornecida pelo Mypy (versão 0.910 quando essa seção foi revisada)
 não é muito útil no contexto do uso de `@dataclass`.
-Primeiro, ele sugere usar `Set`, mas desde Python 3.9 podemos usar
+Primeiro, ele sugere usar `Set`, mas desde o Python 3.9 podemos usar
 `set`—sem a necessidade de importar `Set` de `typing`.
 E mais importante, se acrescentarmos uma dica de tipo como `set[…]`
 a `all_handles`, `@dataclass` vai encontrar essa anotação e

online/cap07.adoc

@@ -17,7 +17,7 @@ como uma entidade que pode ser:
 
 * Criada durante a execução de um programa
 * Atribuída a uma variável ou a um elemento em uma estrutura de dados
-* Cassada como argumento para uma função
+* Passada como argumento para uma função
 * Devolvida como o resultado de uma função
 
 Inteiros, strings e dicionários são outros exemplos de objetos de primeira classe no Python—nada de incomum aqui.
@@ -48,7 +48,7 @@ A <<positional_only_params>> é nova, e fala de um recurso que surgiu no Python
 Transferi a discussão sobre acesso a anotações de funções durante a execução para a <<runtime_annot_sec>>.
 Quando escrevi a primeira edição, a https://fpy.li/pep484[PEP 484—Type Hints (_Dicas de Tipo_)] (EN)
 ainda estava sendo considerada, e as anotações eram usadas de várias formas diferentes.
-Desde Python 3.5, anotações precisam estar em conformidade com a PEP 484.
+Desde o Python 3.5, anotações precisam estar em conformidade com a PEP 484.
 Assim, o melhor lugar para falar delas é na discussão sobre as dicas de tipo.
 
 [NOTE]
@@ -482,7 +482,7 @@ Observe que argumentos somente nomeados não precisam ter um valor default: eles
 [[positional_only_params]]
 ==== Parâmetros somente posicionais
 
-Desde Python 3.8, assinaturas de funções definidas pelo usuário podem especificar parâmetros somente posicionais.
+Desde o Python 3.8, assinaturas de funções definidas pelo usuário podem especificar parâmetros somente posicionais.
 Esse recurso sempre existiu para funções embutidas, tal como `divmod(a, b)`,
 que só pode ser chamada com parâmetros posicionais, e não na forma `divmod(a=10, b=4)`.
 
@@ -785,7 +785,7 @@ functools.partial(<function tag at 0x10206d1e0>, 'img', class_='pic-frame')  <4>
 <2> Cria a função `picture` a partir de `tag`, fixando o primeiro argumento posicional em `'img'` e o argumento nomeado `class_` em `'pic-frame'`.
 <3> `picture` funciona como esperado.
 <4> `partial()` devolve um objeto `functools.partial`.footnote:[O https://fpy.li/7-9[código-fonte] de _functools.py_ revela que `functools.partial` é implementada em C e é usada por default.
-Se ela não estiver disponível, uma implementação em Python puro de `partial` está disponível desde Python 3.4.]
+Se ela não estiver disponível, uma implementação em Python puro de `partial` está disponível desde o Python 3.4.]
 <5> Um objeto `functools.partial` tem atributos que fornecem acesso à função original e aos argumentos fixados.
 
 A função `functools.partialmethod` faz o mesmo que `partial`, mas serve para trabalhar com métodos.

online/cap08.adoc

@@ -948,7 +948,7 @@ que significa que o tipo de `plural` pode ser `str` ou `None`.
 
 [TIP]
 ====
-Desde Python 3.10 é possível escrever `str | bytes` em vez de `Union[str, bytes]`.
+Desde o Python 3.10 é possível escrever `str | bytes` em vez de `Union[str, bytes]`.
 É menos digitação, e não precisamos importar `Optional` ou `Union` de `typing`.
 Compare a sintaxe antiga com a nova para a dica de tipo do parâmetro `plural` em `show_count`:
 

online/cap09.adoc

@@ -42,7 +42,7 @@ Após criar essa base, poderemos então enfrentar os outros tópicos relativos a
 
 O((("decorators and closures", "significant changes to"))) decorador de _caching_ `functools.cache`—introduzido no Python 3.9—é mais simples que o tradicional `functools.lru_cache`, então falo primeiro daquele. Este último é tratado na <<lru_cache_sec>>, incluindo a forma simplificada introduzida no Python 3.8.
 
-A <<generic_functions>> foi expandida e agora inclui dicas de tipo, a forma recomendada de usar `functools.singledispatch` desde Python 3.7.
+A <<generic_functions>> foi expandida e agora inclui dicas de tipo, a forma recomendada de usar `functools.singledispatch` desde o Python 3.7.
 
 A <<parameterized_dec_sec>> agora inclui um exemplo baseado em classes, o <<clockdeco_param_cls_ex>>.
 
@@ -806,7 +806,7 @@ A maior vantagem de `@lru_cache` é a possibilidade de limitar seu uso de memór
 LRU((("Least Recently Used (LRU)"))) é a sigla de _Least Recently Used_ (literalmente "Usado Menos Recentemente").
 Significa que registros que há algum tempo não são lidos, são descartados para dar lugar a novos itens.
 
-Desde Python 3.8, `lru_cache` pode ser aplicado de duas formas.
+Desde o Python 3.8, `lru_cache` pode ser aplicado de duas formas.
 Abaixo vemos o modo mais simples em uso:
 
 [source, python]
@@ -816,7 +816,7 @@ def costly_function(a, b):
     ...
 ----
 
-A outra forma—disponível desde Python 3.2—é invocá-lo como uma função,
+A outra forma—disponível desde o Python 3.2—é invocá-lo como uma função,
 com `()`:
 
 [source, python]
@@ -911,7 +911,7 @@ O <<singledispatch_ex>> mostra como funciona.
 
 [WARNING]
 ====
-`functools.singledispatch` existe desde Python 3.4, mas só passou a suportar dicas de tipo no Python 3.7.
+`functools.singledispatch` existe desde o Python 3.4, mas só passou a suportar dicas de tipo no Python 3.7.
 As últimas duas funções no <<singledispatch_ex>> ilustram a sintaxe que funciona em todas as versões de Python desde a 3.4.
 ====
 

online/cap11.adoc

@@ -43,7 +43,7 @@ A <<format_display_sec>> foi atualizada para mencionar as f-strings, introduzida
 então quaisquer métodos `+__format__+` implementados antes vão funcionar também com as f-strings.
 
 O resto do capítulo quase não mudou—os métodos especiais são praticamente os mesmos
-desde Python 3.0, e as ideias centrais apareceram no Python 2.2.
+desde o Python 3.0, e as ideias centrais apareceram no Python 2.2.
 
 Vamos começar pelos métodos de representação de objetos.