formatação

Author: ramalho

online/cap02.adoc

@@ -1388,11 +1388,11 @@ o Python chama `+seq.__getitem__(slice(start, stop, step))+`, como veremos na <<
 Mesmo se você não for implementar seus próprios tipos de sequência, saber dos objetos fatia é útil,
 porque eles permitem que você atribua nomes às fatias, da mesma forma que planilhas permitem dar nomes a faixas de células.
 
-Suponha que você precise analisar um arquivo de dados como a fatura mostrada na <<flat_file_invoce>>.
+Suponha que você precise analisar um arquivo de dados como a fatura mostrada na <<flat_file_invoice>>.
 Em vez de encher seu código de fatias explícitas fixas, você pode nomeá-las.
 Veja como isso torna legível o loop `for` no final do exemplo.
 
-[[flat_file_invoce]]
+[[flat_file_invoice]]
 .Itens de um arquivo tabular de fatura
 ====
 [source, python]
@@ -2492,7 +2492,7 @@ incluindo a "Recipe 1.11.
 Naming a Slice" (_Receita 1.11.
 Nomeando uma Fatia_),
 onde aprendi o truque de atribuir fatias a variáveis para melhorar a legibilidade,
-como ilustrado no nosso <<flat_file_invoce>>.
+como ilustrado no nosso <<flat_file_invoice>>.
 
 A segunda edição do _Python Cookbook_ foi escrita para Python 2.4,
 mas a maior parte de seu código funciona com Python 3,

vol1/cap01.adoc

@@ -1,5 +1,5 @@
 [[ch_data_model]]
-== O modelo de dados de Python
+== O modelo de dados
 :example-number: 0
 :figure-number: 0
 
@@ -47,9 +47,8 @@ nomes dos métodos especiais são sempre precedidos e seguidos de dois sublinhad
 Por exemplo, a sintaxe `obj[key]` está amparada no método especial `+__getitem__+`.
 Para resolver `my_collection[key]`, o interpretador chama `+my_collection.__getitem__(key)+`.
 
-[role="pagebreak-before"]
-Implementamos métodos especiais quando queremos que nossos objetos suportem e interajam com
-elementos fundamentais da linguagem, como:
+<<<
+Implementamos métodos especiais para que os objetos suportem:
 
 * Coleções
 
@@ -74,25 +73,21 @@ elementos fundamentais da linguagem, como:
 [NOTE]
 ====
 O((("magic methods")))((("dunder methods")))
-termo _método mágico_ é uma gíria usada para se referir aos métodos especiais,
-mas como falamos de um método específico, por exemplo `+__getitem__+`?
-Aprendi a dizer "dunder-getitem" com o autor e professor Steve Holden.
-"Dunder" é uma contração da frase em inglês "double underscore before and after"
-(_sublinhado duplo antes e depois_).
-Por isso os métodos especiais são também conhecidos como _métodos dunder_.
-O capítulo
-«Análise Léxica» [.small]#&#91;fpy.li/2d&#93;#
+termo _método mágico_ é gíria para "métodos especial.
+Para falar de um método específico, por exemplo `+__getitem__+`,
+pythonistas comoo autor Steve Holden dizem "dunder-getitem".
+"Dunder" é uma contração de _double underscore before and after_
+(sublinhado duplo antes e depois).
+O capítulo «Análise Léxica» [.small]#&#91;fpy.li/2d&#93;#
 de _A Referência da Linguagem Python_ adverte:
 "_Qualquer_ uso de nomes no formato `+__*__+` que não siga explicitamente o uso documentado,
 em qualquer contexto, está sujeito a quebra sem aviso prévio."
 ====
 
-<<<
-
 === Novidades neste capítulo
 
 Esse((("Python Data Model", "significant changes to"))) capítulo sofreu poucas alterações desde a primeira edição,
-pois é uma introdução ao Modelo de Dados de Python, que é muito estável.
+pois é o Modelo de Dados de Python é muito estável.
 As mudanças mais significativas foram:
 
 * Métodos especiais que suportam programação assíncrona e outras novas funcionalidades
@@ -101,6 +96,7 @@ foram acrescentados às tabelas na <<overview_special_methods>>.
 * A <<collection_uml>>, mostrando o uso de métodos especiais na  <<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 no Python 3.6,
 que é mais legível e muitas vezes mais conveniente que as notações de formatação de strings mais antigas:
@@ -118,11 +114,6 @@ ou quando tem de vir de um arquivo de configuração ou de um banco de dados.
 Essas são necessidades reais, mas não acontecem com frequência.
 ====
 
-////
-PROD: As is often the case, the TIP above may or may not run over the next paragraphs,
-depending on some random factor I don't know how to control.
-////
-
 [[pythonic_card_deck]]
 === Um baralho pythônico
 
@@ -144,6 +135,7 @@ include::../code/01-data-model/frenchdeck.py[]
 ----
 ====
 
+<<<
 A((("collections.namedtuple"))) primeira coisa a notar é o uso de `collections.namedtuple`
 para construir uma classe simples representando cartas individuais.
 Usamos `namedtuple` para criar classes de objetos que são apenas um agrupamento de atributos,
@@ -238,6 +230,7 @@ Card(rank='4', suit='spades')
 ...
 ----
 
+<<<
 Também podemos iterar sobre o baralho na ordem inversa:
 
 [source, python]
@@ -371,11 +364,8 @@ Essas funções chamam o método especial correspondente,
 mas também fornecem outros serviços e—para tipos embutidos—são mais rápidas que chamadas a métodos.
 
 Na próxima seção veremos alguns dos usos mais importantes dos métodos especiais:
-
-* Emular tipos numéricos
-* Representar objetos na forma de strings
-* Determinar o valor booleano de um objeto
-* Implementar coleções
+emular tipos numéricos, representar objetos na forma de strings,
+determinar o valor booleano de um objeto, e implementar coleções.
 
 
 [[data_model_emulating_sec]]
@@ -399,8 +389,8 @@ Faremos isso no «Capítulo 17» [.small]#&#91;vol.3, fpy.li/4s&#93;#.
 ======
 
 [[vectors_fig]]
-.Soma de vetores bidimensionais; `Vector(2, 4) + Vector(2, 1)` devolve `Vector(4, 5)`.
-image::../images/flpy_0101.png[vetores 2D,align="center",pdfwidth=9cm]
+.Soma de vetores: `Vector(2, 4) + Vector(2, 1)` devolve `Vector(4, 5)`.
+image::../images/flpy_0101.png[vetores 2D,align="center",pdfwidth=7cm]
 
 Vamos começar a projetar a API para essa classe escrevendo uma sessão de console simulada,
 que depois podemos usar como um doctest.
@@ -453,6 +443,7 @@ include::../code/01-data-model/vector2d_pt.py[]
 ----
 ====
 
+<<<
 Implementamos cinco métodos especiais, além do costumeiro `+__init__+`.
 Veja que nenhum deles é chamado diretamente dentro da classe ou durante seu uso normal,
 ilustrado pelos doctests.
@@ -602,8 +593,7 @@ Cada uma das ABCs no topo da hierarquia tem um único método especial.
 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`,
-«desempacotamento» [.small]#&#91;fpy.li/2h&#93;#,
+* `Iterable`, para((("Iterable interface")))((("interfaces", "Iterable interface"))) suportar a instrução `for`,
 e outras formas de iteração
 * `Sized` para((("Sized interface")))((("interfaces", "Sized interface"))) suportar a função embutida `len`
 * `Container` para((("Container interface")))((("interfaces", "Container interface"))) suportar o operador `in`
@@ -652,7 +642,7 @@ A maioria desses métodos será tratado ao longo do livro, incluindo as adiçõe
 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).
 
-
+<<<
 [[special_names_tbl]]
 .Nomes de métodos especiais (excluindo operadores)
 [options="header", cols="2,3"]