errata #112

Author: ramalho

guia-de-estilo.adoc

@@ -5,15 +5,6 @@
 
 Padrões gráficos e de linguagem adotados nesta tradução.
 
-## Referências à linguagens de programação
-
-Evitamos o uso de artigos antes de nomes de linguagens como Python, Go, Ruby etc.
-Ex: "Python invoca métodos...", mas não
-"O Python invoca métodos...".
-
-Isso se aplica à conjunção "de", por exemplo
-"a versão de Python" e não "a versão do Python"
-
 
 ## Termos adotados
 
@@ -109,6 +100,7 @@ Termo em inglês adotado::
 |❗ _return_ (flow control)  |✅ retorna | "A função retorna após 10s."
 |❗ _return_ (value)         |✅ devolve | "A função devolve a lista de estudantes."
 |❗ _S-expression_     |✅ expressão-S     |
+|❗ _source code_      |✅ código-fonte    | 🔎 código fonte
 |❗ _stack_            |✅ pilha           |
 |❗ _statement_        |✅ instrução       |
 |✅ _status_ (s.m.)    |❗ situação        |

online/Prefacio.adoc

@@ -127,7 +127,7 @@ Algumas vezes vou explicar o que queremos realizar mostrando um _doctest_ antes
 Estabelecer precisamente o quê deve ser feito, antes de pensar sobre como fazer, ajuda a focalizar nosso esforço de codificação.
 Escrever os testes previamente é a base de desenvolvimento dirigido por testes (TDD, _test-driven development_), e também acho essa técnica útil para ensinar.
 
-Também((("pytest package")))((("unittest module"))) escrevi testes de unidade para alguns dos exemplos maiores usando _pytest_—que acho mais fácil de usar e mais poderoso que o módulo _unittest_ da bibliotexa padrão.
+Também((("pytest package")))((("unittest module"))) escrevi testes unitários para alguns dos exemplos maiores usando _pytest_—que acho mais fácil de usar e mais poderoso que o módulo _unittest_ da biblioteca padrão.
 Você vai descobrir que pode verificar a maior parte do código do livro digitando `python3 -m doctest example_script.py` ou `pytest` no console de seu sistema operacional.
 A configuração do _pytest.ini_, na raiz do https://fpy.li/code[repositório do código de exemplo], assegura que _doctests_ são coletados e executados pelo comando `pytest`.((("", startref="Papproach00")))
 
@@ -136,7 +136,7 @@ A configuração do _pytest.ini_, na raiz do https://fpy.li/code[repositório do
 
 Venho usando, ensinando e debatendo Python desde 1998, e gosto de estudar e comparar linguagens de programação, seus projetos e a teoria por trás delas. Ao final de alguns capítulos acrescentei uma seção "Ponto de vista", apresentando minha perspectiva sobre Python e outras linguagens. Você pode pular essas partes, se não tiver interesse em tais discussões. Seu conteúdo é inteiramente opcional.
 
-=== Conteúdo na na Web
+=== Conteúdo na Web
 
 Criei dois sites para este livro:
 

online/cap05.adoc

@@ -1342,7 +1342,7 @@ português—uma tradução quase literal seria "fedor no código".
 Uma tradução mais gentil pode ser "cheiro no código", adotado aqui.
 Mais gentil e menos enviesada: um "cheiro no código" nem sempre é indicação de um problema.]—padrões
 no código que podem indicar a necessidade de refatoração.
-O verbete entitulado "Data Class"
+O verbete intitulado "Data Class"
 (_Classe de Dados_) começa assim:
 
 [quote]

online/cap07.adoc

@@ -15,10 +15,10 @@ No Python, funções((("objects", "first-class")))((("first-class objects")))(((
 Estudiosos de linguagens de programação definem um "objeto de primeira classe"
 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;
-* Passada como argumento para uma função;
-* Devolvida como o resultado de uma função.
+* 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
+* 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.
 Tratar funções como objetos de primeira classe é um recurso essencial das linguagens funcionais, como Clojure, Elixir e Haskell.
@@ -49,14 +49,14 @@ Transferi a discussão sobre acesso a anotações de funções durante a execuç
 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.
-Assim, o melhor lugar para falar delas é na a discussão sobre as dicas de tipo.
+Assim, o melhor lugar para falar delas é na discussão sobre as dicas de tipo.
 
 [NOTE]
 ====
 A((("function parameters, introspection of")))((("parameters", "introspection of function parameters")))
 primeira edição desse livro continha seções sobre a introspecção de objetos função,
 que desciam a detalhes de baixo nível e desviavam do assunto principal do capítulo.
-Reuni aquelas seções em um post entitulado
+Reuni aquelas seções em um post intitulado
 https://fpy.li/7-2["Introspection of Function Parameters" (_Introspecção de Parâmetros de Funções_)], no _fluentpython.com_.
 ====
 
@@ -186,9 +186,9 @@ mas temos alternativas melhores para a maioria de seus casos de uso, como mostra
 ==== Substitutos modernos para map, filter, e reduce
 
 Linguagens funcionais((("list comprehensions (listcomps)", "versus map and filter functions")))((("generator expressions (genexps)")))
-normalmente oferecem as funções de ordem superior `map`, `filter`, and `reduce` (algumas vezes com nomes diferentes).
-As funções `map` e `filter` ainda estão embutidas no Python mas elas não são mais tão importantes
-desde a introdução das compreensões de lista e das expressões geradoras,
+normalmente oferecem as funções de ordem superior `map`, `filter`, e `reduce` (algumas vezes com nomes diferentes).
+As funções `map` e `filter` ainda estão embutidas no Python, mas elas não são mais tão importantes
+desde a introdução das compreensões de lista e das expressões geradoras.
 Uma listcomp ou uma genexp fazem o mesmo que `map` e `filter` combinadas, e são mais legíveis.
 Considere o <<reduce_x_sum>>.
 
@@ -220,7 +220,7 @@ sua substituta direta agora é uma expressão geradora
 (no Python 2, essas funções devolviam listas, então sua alternativa mais próxima era a compreensão de lista).
 
 A função `reduce` foi rebaixada de função embutida, no Python 2, para o módulo `functools` no Python 3.
-Seu caso de uso mais comum, a somatória, é melhor servido pela função embutida `sum`,
+Seu caso de uso mais comum, a somatória, é melhor atendido pela função embutida `sum`,
 disponível desde o Python 2.3 (lançado em 2003).
 A função `sum` é mais legível e mais eficiente:
 
@@ -520,7 +520,7 @@ Após esse mergulho nos recursos flexíveis de declaração de argumentos no Pyt
 
 === Pacotes para programação funcional
 
-Apesar((("functions, as first-class objects", "packages for functional programming", id="FAFfp07")))((("functional programming", "packages for", id="fprogpack07"))) de Guido deixar claro que não projetou Python para ser uma linguagem de programação funcional, o estilo de programação funcional pode ser amplamente utilizado, graças a funções de primeira classe, _pattern matching_ e o suporte de pacotes como `operator` e `functools`, dos quais falaremos nas próximas duas seções..
+Apesar((("functions, as first-class objects", "packages for functional programming", id="FAFfp07")))((("functional programming", "packages for", id="fprogpack07"))) de Guido deixar claro que não projetou Python para ser uma linguagem de programação funcional, o estilo de programação funcional pode ser amplamente utilizado, graças a funções de primeira classe, _pattern matching_ e o suporte de pacotes como `operator` e `functools`, dos quais falaremos nas próximas duas seções.
 
 
 [[operator_module_section]]
@@ -529,7 +529,7 @@ Apesar((("functions, as first-class objects", "packages for functional programmi
 Na((("operator module", id="opmod07"))) programação funcional, é muitas vezes conveniente usar um operador aritmético como uma função.
 Por exemplo, suponha que você queira multiplicar uma sequência de números para calcular fatoriais, mas sem usar recursão.
 Para calcular a soma, podemos usar `sum`, mas não há uma função equivalente para multiplicação.
-Você poderia usar ++reduce++—como vimos na <<map_filter_reduce>>—mas isso exige um função para multiplicar dois itens da sequência.
+Você poderia usar ``reduce``—como vimos na <<map_filter_reduce>>—mas isso exige um função para multiplicar dois itens da sequência.
 O <<fact_reduce_lambda_ex>> mostra como resolver esse problema usando `lambda`.
 
 [[fact_reduce_lambda_ex]]
@@ -594,7 +594,7 @@ Isso é mais fácil de escrever e ler que `lambda fields: fields[1]`, que faz a
 ----
 ====
 
-Se você passar múltiplos argumentos de indice para `itemgetter`, a função criada por ela vai devolver tuplas com os valores extraídos, algo que pode ser útil para ordenar((("keys", "sorting multiple"))) usando chaves múltiplas:
+Se você passar vários índices como argumentos para `itemgetter`, a função criada por ela vai devolver tuplas com os valores extraídos, algo que pode ser útil para ordenar((("keys", "sorting multiple"))) usando chaves múltiplas:
 
 [source, python]
 ----
@@ -868,7 +868,7 @@ Nesse artigo, Python é mencionado nominalmente na seguinte passagem:
 [quote]
 ____
 E como descrever linguagens como Python, Ruby, ou Perl?
-Seus criadores não tem paciência com as sutilezas dessas nomenclaturas de Lineu;
+Seus criadores não têm paciência com as sutilezas dessas nomenclaturas de Lineu;
 eles pegam emprestados todos os recursos que desejam, criando misturas que desafiam totalmente uma caracterização.
 ____
 
@@ -915,7 +915,7 @@ das restrições sintáticas específicas de Python,
 funções anônimas tem uma séria desvantagem em qualquer linguagem: elas não tem nome.
 
 Estou brincando, mas não muito.
-Os _stack traces_ são mais fáceis de ler quando as funções tem nome.
+Os _stack traces_ são mais fáceis de ler quando as funções têm nome.
 Funções anônimas são um atalho conveniente, nos divertimos programando com elas, mas algumas vezes elas são levadas longe demais—especialmente se a linguagem e o ambiente encorajam o aninhamento profundo de funções anônimas, como faz o Javascript combinado com o Node.js.
 Ter muitas funções anônimas aninhadas torna a depuração e o tratamento de erros mais difíceis.
 A programação assíncrona no Python é mais estruturada, talvez pela sintaxe limitada do `lambda` impedir seu abuso e forçar uma abordagem mais explícita.

online/cap08.adoc

@@ -198,7 +198,7 @@ E quando você estiver lendo essas linhas, talvez os resultados também sejam di
 
 Se a assinatura de uma função não tem anotações, Mypy a ignora por default—a menos que seja configurado de outra forma.
 
-O <<msgs_test_no_hints>> também inclui testes de unidade do `pytest`.
+O <<msgs_test_no_hints>> também inclui testes unitários do `pytest`.
 Este é o código de _messages_test.py_:
 
 [[msgs_test_no_hints]]
@@ -2214,7 +2214,7 @@ https://fpy.li/8-37["Strong Typing vs. Strong Testing"] (EN) de Bruce Eckel, tam
 Bruce é um fã de Python, e autor de livros sobre C&#x2b;&#x2b;, Java, Scala, e
 Kotlin.
 Naquele texto, ele conta como foi um defensor da tipagem estática até aprender Python, e conclui:
-"Se um programa em Python tem testes de unidade adequados, ele poderá ser tão robusto quanto um programa em C&#x2b;&#x2b;, Java, ou C# com testes de unidade adequados (mas será mais rápido escrever os testes em Python).
+"Se um programa em Python tem testes unitários adequados, ele poderá ser tão robusto quanto um programa em C&#x2b;&#x2b;, Java, ou C# com testes unitários adequados (mas será mais rápido escrever os testes em Python).
 ====
 
 // [role="pagebreak-before less_space"]
@@ -2287,7 +2287,7 @@ https://fpy.li/8-41["The state of type hints in Python"] (EN):
 
 [quote]
 ____
-Dicas de Tipo deveriam ser usadas sempre que valha à pena escrever testes de unidade .
+Dicas de Tipo deveriam ser usadas sempre que valha à pena escrever testes unitários .
 ____
 
 Sou um grande fã de testes, mas também escrevo muito código exploratório.

print/1/experimento-1/cap05.adoc

@@ -1335,7 +1335,7 @@ Improving the Design of Existing Code</em> (<em>Refatorando: Melhorando o Design
 português—uma tradução quase literal seria "fedor no código".
 Uma tradução mais gentil pode ser "cheiro no código", adotado aqui.
 Mais gentil e menos enviesada: um "cheiro no código" nem sempre é indicação de um problema.]—padrões
-no código que podem indicar a necessidade de refatoração. O verbete entitulado "Data Class"
+no código que podem indicar a necessidade de refatoração. O verbete intitulado "Data Class"
 (_Classe de Dados_) começa assim:
 
 [quote]

vol1/Prefacio.adoc

@@ -157,7 +157,7 @@ Algumas vezes vou explicar o que queremos realizar mostrando um _doctest_ antes
 Estabelecer precisamente o quê deve ser feito, antes de pensar sobre como fazer, ajuda a focalizar nosso esforço de codificação.
 Escrever os testes previamente é a base de desenvolvimento dirigido por testes (TDD, _test-driven development_), e também acho essa técnica útil para ensinar.
 
-Também((("pytest package")))((("unittest module"))) escrevi testes de unidade para alguns dos exemplos maiores usando _pytest_—que acho mais fácil de usar e mais poderoso que o módulo _unittest_ da bibliotexa padrão.
+Também((("pytest package")))((("unittest module"))) escrevi testes unitários para alguns dos exemplos maiores usando _pytest_—que acho mais fácil de usar e mais poderoso que o módulo _unittest_ da biblioteca padrão.
 Você vai descobrir que pode verificar a maior parte do código do livro digitando `python3 -m doctest example_script.py` ou `pytest` no console de seu sistema operacional.
 A configuração do _pytest.ini_, na raiz do «repositório do código de exemplo» [.small]#[fpy.li/code]#, assegura que _doctests_ são coletados e executados pelo comando `pytest`.((("", startref="Papproach00")))
 
@@ -166,7 +166,7 @@ A configuração do _pytest.ini_, na raiz do «repositório do código de exempl
 
 Venho usando, ensinando e debatendo Python desde 1998, e gosto de estudar e comparar linguagens de programação, seus projetos e a teoria por trás delas. Ao final de alguns capítulos acrescentei uma seção "Ponto de vista", apresentando minha perspectiva sobre Python e outras linguagens. Você pode pular essas partes, se não tiver interesse em tais discussões. Seu conteúdo é inteiramente opcional.
 
-=== Conteúdo na na Web
+=== Conteúdo na Web
 
 Criei dois sites para este livro:
 

vol1/cap05.adoc

@@ -1338,7 +1338,7 @@ português—uma tradução quase literal seria "fedor no código".
 Uma tradução mais gentil pode ser "cheiro no código", adotado aqui.
 Mais gentil e menos enviesada: um "cheiro no código" nem sempre é indicação de um problema.]—padrões
 no código que podem indicar a necessidade de refatoração.
-O verbete entitulado "Data Class"
+O verbete intitulado "Data Class"
 (_Classe de Dados_) começa assim:
 
 [quote]