cap01: quebras semânticas

ramalho · ramalho · commit bdbd71cf5667 · 2025-06-18T21:22:35.000-03:00
diff --git a/capitulos/cap01.adoc b/capitulos/cap01.adoc
@@ -3,7 +3,11 @@
 
 [quote, Jim Hugunin, criador do Jython&#x002C; co-criador do AspectJ&#x002C; e arquiteto do .Net DLR—Dynamic Language Runtime]
 ____
-O senso estético de Guido para o design de linguagens é incrível. Conheci muitos projetistas capazes de criar linguagens teoricamente lindas, que ninguém jamais usaria. Mas Guido é uma daquelas raras pessoas capaz de criar uma linguagem só um pouco menos teoricamente linda que, por isso mesmo, é uma delícia para programar.
+O senso estético de Guido para o design de linguagens é incrível.
+Conheci muitos projetistas capazes de criar linguagens teoricamente lindas,
+que ninguém jamais usaria.
+Mas Guido é uma daquelas raras pessoas capaz de criar uma linguagem só um pouco menos teoricamente linda que,
+por isso mesmo, é uma delícia para programar.
 footnote:[Traduzido de
 https://fpy.li/1-1[Story of Jython] (EN),
 prefácio de
@@ -85,12 +89,14 @@ Esse((("Python Data Model", "significant changes to"))) capítulo sofreu poucas
 pois é uma introdução ao Modelo de Dados de Python, que é muito estável.
 As mudanças mais significativas foram:
 
-* Métodos especiais que suportam programação assíncrona e outras novas funcionalidades foram acrescentados às tabelas em <<overview_special_methods>>.
+* Métodos especiais que suportam programação assíncrona e outras novas funcionalidades
+foram acrescentados às tabelas em <<overview_special_methods>>.
 
-* A <<collection_uml>>, mostrando o uso de métodos especiais em <<collection_api>>, incluindo a classe base abstrata `collections.abc.Collection`, introduzida n Python 3.6.
+* A <<collection_uml>>, mostrando o uso de métodos especiais em <<collection_api>>,
+incluindo a classe base abstrata `collections.abc.Collection`, introduzida no Python 3.6.
 
 Além disso, aqui((("f-string syntax", "benefits of"))) e por toda essa segunda edição,
-adotei a sintaxe _f-string_, introduzida n Python 3.6,
+adotei a sintaxe _f-string_, introduzida no Python 3.6,
 que é mais legível e muitas vezes mais conveniente que as notações de formatação de strings mais antigas:
 o((("str.format() method")))((("&#x0025; (modulo) operator")))((("modulo (&#x0025;) operator")))
 método `str.format()` e o operador `%`.
@@ -500,7 +506,7 @@ Programadores com experiência anterior em linguagens que contém o método `toS
 tendem a implementar `+__str__+` e não `+__repr__+`.
 Se você for implementar apenas um desses métodos especiais, escolha `+__repr__+`.
 
-https://fpy.li/1-5["What is the difference between `+__str__+` and `+__repr__+` in Python?" (_Qual a diferença entre `+__str__+` e `+__repr__+` em Python?_)] (EN)
+https://fpy.li/1-5["What is the difference between `+__str__+` and `+__repr__+` ino Python?" (_Qual a diferença entre `+__str__+` e `+__repr__+` em Python?_)] (EN)
 é uma questão no Stack Overflow  com excelentes contribuições dos pythonistas
 Alex Martelli e Martijn Pieters.((("", startref="repr01")))
 ====
@@ -574,7 +580,7 @@ mostrando como elas são criadas a partir de métodos especiais.
 image::../images/flpy_0102.png[Diagram de classes UML com todas as superclasses e algumas subclasses de `abc.Collection`]
 
 Cada uma das ABCs no topo da hierarquia tem um único método especial.
-A ABC `Collection` (introduzida n Python 3.6) unifica as três interfaces essenciais,
+A ABC `Collection` (introduzida no Python 3.6) unifica as três interfaces essenciais,
 que toda coleção deveria implementar:
 
 * `Iterable`, para((("Iterable interface")))((("interfaces", "Iterable interface"))) suportar `for`,
@@ -624,7 +630,8 @@ Para ter uma visão geral do que está disponível, veja tabelas a seguir.
 A <<special_names_tbl>> mostra nomes de métodos especiais, excluindo aqueles usados para implementar
 operadores infixos ou funções matemáticas fundamentais como `abs`.
 A maioria desses métodos será tratado ao longo do livro, incluindo as adições mais recentes:
-métodos especiais assíncronos como `+__anext__+` (acrescentado n Python 3.5), e o método de personalização de classes, `+__init_subclass__+` (d Python 3.6).
+métodos especiais assíncronos como `+__anext__+` (acrescentado no Python 3.5),
+e o método de configuração de classes, `+__init_subclass__+` (do Python 3.6).
 
 ////
 PROD: Please make sure funcion names such as divmod() and __truediv__ are not
@@ -657,7 +664,7 @@ I tried to use keep-together in <special_operators_tbl> but it was rendering a 0
 Operadores infixos e numéricos são suportados pelos métodos especiais listados na
 <<special_operators_tbl>>.
 Aqui os nomes mais recentes são `+__matmul__+`, `+__rmatmul__+`, e `+__imatmul__+`,
-adicionados n Python 3.5 para suportar o uso de `@` como operador de multiplicação de matrizes,
+adicionados no Python 3.5 para suportar o uso de `@` como operador de multiplicação de matrizes,
 como veremos no <<ch_op_overload>>.((("special methods", "special method names and symbols for operators")))
 
 [[special_operators_tbl]]
@@ -677,7 +684,8 @@ como veremos no <<ch_op_overload>>.((("special methods", "special method names a
 
 [NOTE]
 ====
- Python invoca um método especial de operador reverso no segundo argumento quando o método especial correspondente não pode ser usado no primeiro operando.
+Python invoca um método especial de operador reverso no segundo argumento
+quando o método especial correspondente não pode ser usado no primeiro operando.
 Atribuições aumentadas são atalho combinando um operador infixo com uma atribuição de variável, por exemplo `a += b`.
 
 O <<ch_op_overload>> explica em detalhes os operadores reversos e a atribuição aumentada.((("", startref="PDMspmtov01")))
@@ -694,35 +702,49 @@ Nenhum método é chamado para os objetos embutidos do CPython: o tamanho é sim
 Obter o número de itens em uma coleção é uma operação comum, e precisa funcionar de forma eficiente para tipos tão básicos e diferentes como
 `str`, `list`, `memoryview`, e assim por diante.
 
-Em outras palavras, `len` não é chamado como um método porque recebe um tratamento especial como parte do Modelo de Dados de Python, da mesma forma que `abs`.
-Mas graças ao método especial pass:[<code>__len__</code>], também é possível fazer `len` funcionar com nossos objetos personalizados.
+Em outras palavras, `len` não é chamado como um método porque recebe um tratamento especial como parte do Modelo de Dados de Python,
+da mesma forma que `abs`.
+Mas graças ao método especial pass:[<code>__len__</code>], também é possível fazer `len` funcionar com objetos nossas classes.
 Isso é um compromisso justo entre a necessidade de objetos embutidos eficientes e a consistência da linguagem.
 Também de "O Zen de Python": "Casos especiais não são especiais o bastante para quebrar as regras."
 
 
 [NOTE]
 ====
-Pensar em `abs` e `len` como operadores unários nos deixa mais inclinados a perdoar seus aspectos funcionais, contrários à sintaxe de chamada de método que esperaríamos em uma linguagem orientada a objetos.
-De fato, a linguagem ABC—uma ancestral direta de Python, que antecipou muitas das funcionalidades desta última—tinha o operador `#`, que era o equivalente de `len` (se escrevia `#s`).
-Quando usado como operador infixo, `x#s` contava as ocorrências de `x` em `s`, que em Python obtemos com `s.count(x)`, para qualquer sequência `s`.
+Pensar em `abs` e `len` como operadores unários nos deixa mais inclinados a perdoar seus aspectos funcionais,
+contrários à sintaxe de chamada de método que esperaríamos em uma linguagem orientada a objetos.
+De fato, Python herdou muito de sua sintaxe e estruturas de dados da linguagem ABC,
+onde existe o operador `#`,
+que equivale ao `len`: em ABC, `len(s)` escreve-se `#s`.
+Quando usado como operador infixo,
+`x#s` conta as ocorrências de `x` em `s`,
+que em Python obtemos com `s.count(x)`,
+para qualquer sequência `s`.
 ====
 
 [role="pagebreak-before less_space"]
 === Resumo do capítulo
 
-Ao((("Python Data Model", "overview of"))) implementar métodos especiais, seus objetos podem se comportar como tipos embutidos, permitindo o estilo de programação expressivo que a comunidade considera pythônico.
+Ao((("Python Data Model", "overview of"))) implementar métodos especiais,
+seus objetos podem se comportar como tipos embutidos,
+permitindo o estilo de programação expressivo que a comunidade considera pythônico.
 
-Uma exigência básica para um objeto em Python é fornecer strings representando a si mesmo que possam ser usadas, uma para depuração e registro (_log_), outra para apresentar aos usuários finais. É para isso que os métodos especiais `+__repr__+` e `+__str__+` existem no modelo de dados.
+Uma exigência básica para um objeto em Python é fornecer strings representando a si mesmo que possam ser usadas,
+uma para depuração e registro (_log_), outra para apresentar aos usuários finais.
+É para isso que os métodos especiais `+__repr__+` e `+__str__+` existem no modelo de dados.
 
 Emular sequências, como mostrado com o exemplo do `FrenchDeck`, é um dos usos mais comuns dos métodos especiais.
 Por exemplo, bibliotecas de banco de dados frequentemente devolvem resultados de consultas na forma de coleções similares a sequências.
 Tirar o máximo proveito dos tipos de sequências existentes é o assunto do <<ch_sequences>>.
 Como implementar suas próprias sequências será visto na <<ch_seq_methods>>,
 onde criaremos uma extensão multidimensional da classe `Vector`.
 
-Graças à sobrecarga de operadores, Python oferece uma rica seleção de tipos numéricos, desde os tipos embutidos até `decimal.Decimal` e `fractions.Fraction`,
+Graças à sobrecarga de operadores, Python oferece uma rica seleção de tipos numéricos,
+desde os tipos embutidos até `decimal.Decimal` e `fractions.Fraction`,
 todos eles suportando operadores aritméticos infixos.
-As bibliotecas de ciência de dados _NumPy_ suportam operadores infixos com matrizes e tensores. A implementação de operadores—incluindo operadores reversos e atribuição aumentada—será vista no <<ch_op_overload>>, usando melhorias do exemplo `Vector`.
+As bibliotecas de ciência de dados _NumPy_ suportam operadores infixos com matrizes e tensores.
+A implementação de operadores—incluindo operadores reversos e atribuição aumentada—será vista no <<ch_op_overload>>,
+usando melhorias do exemplo `Vector`.
 
 Também veremos o uso e a implementação da maioria dos outros métodos especiais do Modelo de Dados de Python ao longo deste livro.
 
@@ -761,9 +783,11 @@ explica o conceito de um protocolo de metaobjetos, do qual o Modelo de Dados de
 Modelo de dados ou modelo de objetos?
 
 
-Aquilo((("Soapbox sidebars", "data model versus object model")))((("Python Data Model", "Soapbox discussion"))) que a documentação de Python chama de "Modelo de Dados de Python", a maioria dos autores diria que é o "Modelo de objetos de Python"
+Aquilo((("Soapbox sidebars", "data model versus object model")))((("Python Data Model", "Soapbox discussion")))
+que a documentação de Python chama de "Modelo de Dados de Python", a maioria dos autores diria que é o "Modelo de objetos de Python"
 
-O _Python in a Nutshell_, 3rd ed. de Martelli, Ravenscroft, e Holden, e o _Python Essential Reference_, 4th ed., de David Beazley são os melhores livros sobre o Modelo de Dados de Python, mas se referem a ele como o "modelo de objetos."
+O _Python in a Nutshell_, 3rd ed. de Martelli, Ravenscroft, e Holden, e o _Python Essential Reference_, 4th ed.,
+de David Beazley são os melhores livros sobre o Modelo de Dados de Python, mas se referem a ele como o "modelo de objetos."
 Na Wikipedia, a primeira definição de
 https://fpy.li/1-10["modelo de objetos"]
 (EN) é: "as propriedades  dos objetos em geral em uma linguagem de programação de computadores específica."
@@ -776,7 +800,9 @@ mais relevante para nossas discussões.
 Métodos de "trouxas"
 
 https://fpy.li/1-11[_The Original Hacker's Dictionary_ (_Dicionário Hacker Original_)]
-(EN) define ((("Soapbox sidebars", "magic methods")))((("magic methods"))) _mágica_ como "algo ainda não explicado ou muito complicado para explicar" ou "uma funcionalidade, em geral não divulgada, que permite fazer algo que de outra forma seria impossível."
+(EN) define ((("Soapbox sidebars", "magic methods")))((("magic methods"))) _mágica_ como
+"algo ainda não explicado ou muito complicado para explicar" ou "uma funcionalidade,
+em geral não divulgada, que permite fazer algo que de outra forma seria impossível."
 
 Ruby tem o equivalente aos métodos especiais, chamados de _métodos mágicos_ naquela comunidade.
 Alguns na comunidade Python também adotam esse termo.
