Leitura complementar -> Para saber mais

ramalho · ramalho · commit 0338ed9aaedb · 2025-09-18T18:09:38.000-03:00
diff --git a/online/cap02.adoc b/online/cap02.adoc
@@ -2483,7 +2483,7 @@ e mencionamos as outras implementações de filas na biblioteca padrão.
 
 
 [[array_fur_reading_sec]]
-=== Leitura complementar
+=== Para saber mais
 
 O((("sequences", "further reading on"))) capítulo 1, "Data Structures" (_Estruturas de Dados_)
 do https://fpy.li/pycook3[Python Cookbook</em>, 3rd ed.]
diff --git a/online/cap03.adoc b/online/cap03.adoc
@@ -1601,7 +1601,7 @@ Além disso, as classes `dict_keys` e `dict_items` suportam os operadores e mét
 
 [[further_reading_dict]]
 [role="pagebreak-before less_space"]
-=== Leitura complementar
+=== Para saber mais
 
 Na((("dictionaries and sets", "further reading on"))) documentação da Biblioteca Padrão de Python,
 a seção
diff --git a/online/cap04.adoc b/online/cap04.adoc
@@ -1831,7 +1831,7 @@ Demos uma olhada em outros metadados do Unicode, e vimos rapidamente as APIs de
 onde algumas funções podem ser chamadas com argumentos `str` ou `bytes`, produzindo resultados diferentes.
 
 
-=== Leitura complementar
+=== Para saber mais
 
 A palestra((("Unicode text versus bytes", "further reading on"))) de Ned Batchelder na PyCon US 2012,
 https://fpy.li/4-28["Pragmatic Unicode, or, How Do I Stop the Pain?"
diff --git a/online/cap05.adoc b/online/cap05.adoc
@@ -1706,7 +1706,7 @@ funciona com instâncias de qualquer classe como sujeitos—e
 não apenas das classes criadas com as fábricas apresentadas nesse capítulo.
 
 [[further_data_class]]
-=== Leitura complementar
+=== Para saber mais
 
 A documentação((("data class builders", "further reading on")))
 padrão de Python para as fábricas de classes de dados vistas aqui é muito boa, e inclui muitos pequenos exemplos.
diff --git a/online/cap07.adoc b/online/cap07.adoc
@@ -814,7 +814,7 @@ que facilitam a programação funcional, reduzindo a necessidade de lidar com a
 
 
 [[first_cls_fn_further_reading_sec]]
-=== Leitura complementar
+=== Para saber mais
 
 Nos((("functions, as first-class objects", "further reading on"))) próximos capítulos, continuaremos nossa jornada pela programação com objetos função.
 O <<ch_type_hints_def>> é dedicado às dicas de tipo nos parâmetros de função e nos valores devolvidos por elas.
diff --git a/online/cap09.adoc b/online/cap09.adoc
@@ -1235,7 +1235,7 @@ Como exemplos de decoradores parametrizados na biblioteca padrão, visitamos os
 
 
 [[decorator_further]]
-=== Leitura complementar
+=== Para saber mais
 
 O((("decorators and closures", "further reading on"))) item #26 do livro https://fpy.li/effectpy[_Effective Python_, 2nd ed.] (EN) (Addison-Wesley), de Brett Slatkin, trata das melhores práticas para decoradores de função, e recomenda sempre usar `functools.wraps`—que vimos no <<ex_clockdeco2>>.footnote:[Como queria manter o código o mais simples possível, não segui o excelente conselho de Slatkin em todos os exemplos.]
 
diff --git a/online/cap10.adoc b/online/cap10.adoc
@@ -353,7 +353,7 @@ Na mesma palestra citada no início deste capítulo, refletindo sobre o 20º ani
 Em muitos casos, funções ou objetos invocáveis oferecem um caminho mais natural para implementar _callbacks_ em Python que a imitação dos padrões Estratégia ou Comando como descritos por Gamma, Helm, Johnson, e Vlissides em _Padrões de Projetos_. A refatoração de Estratégia e a discussão de Comando nesse capítulo são exemplos de uma ideia mais geral: algumas vezes você pode encontrar uma padrão de projeto ou uma API que exigem que seus componentes implementem uma interface com um único método, e aquele método tem um nome que soa muito genérico, como "executar", "rodar" ou "fazer". Tais padrões ou APIs podem frequentemente ser implementados em Python com menos código repetitivo, usando funções como objetos de primeira classe.
 
 [[dp_further]]
-=== Leitura complementar
+=== Para saber mais
 
 A "Receita 8.21. Implementando o Padrão Visitante" (_Receipt 8.21. Implementing the Visitor Pattern_) no((("functions, design patterns with first-class", "further reading on"))) pass:[<a class="orm:hideurl" href="https://fpy.li/pycook3"><em>Python Cookbook</em>, 3ª ed.</a>] (EN), mostra uma implementação elegante do padrão Visitante, na qual uma classe `NodeVisitor` trata métodos como objetos de primeira classe.
 
diff --git a/online/cap11.adoc b/online/cap11.adoc
@@ -869,7 +869,7 @@ Para criar objetos pythônicos, observe como se comportam objetos reais de Pytho
 ____
 
 [[pythonic_further_reading]]
-=== Leitura complementar
+=== Para saber mais
 
 Este((("Pythonic objects", "further reading on"))) capítulo tratou de vários dos métodos especiais do modelo de dados, então naturalmente as referências primárias são as mesmas do <<ch_data_model>>, onde tivemos uma ideia geral do mesmo tópico. Por conveniência, vou repetir aquelas quatro recomendações anteriores aqui, e acrescentar algumas outras:
 
diff --git a/online/cap12.adoc b/online/cap12.adoc
@@ -754,7 +754,7 @@ Como fizemos no <<ch_pythonic_obj>>, muitas vezes aqui olhamos como os objetos p
 No <<ch_op_overload>> vamos implemenar vários operadores infixos em `Vector`. A matemática será mais simples que aquela no método `angle()` daqui, mas explorar como os operadores infixos funcionam no Python é uma grande lição sobre design orientado a objetos. Mas antes de chegar à sobrecarga de operadores, vamos parar um pouco de trabalhar com uma única classe e olhar para a organização de múltiplas classes com interfaces e herança, os assuntos dos capítulos pass:[<a data-type="xref" href="#ch_ifaces_prot_abc" data-xrefstyle="select: labelnumber">#ch_ifaces_prot_abc</a>] e pass:[<a data-type="xref" href="ch_inheritance" data-xrefstyle="select: labelnumber">ch_inheritance</a>].
 
 
-=== Leitura complementar
+=== Para saber mais
 
 A((("Vector class, multidimensional", "further reading on")))((("sequences, special methods for", "further reading on"))) maioria dos métodos especiais tratados no exemplo de `Vector` também apareceram no exemplo do `Vector2d`, no <<ch_pythonic_obj>>, então as referências na <<pythonic_further_reading>> ali são todas relevantes aqui também.
 
diff --git a/online/cap14.adoc b/online/cap14.adoc
@@ -861,7 +861,7 @@ Então talvez o melhor conselho sobre herança seja: evite-a se puder.
 Mas, frequentemente, não temos essa opção: os frameworks que usamos nos impõe suas escolhas de design.
 
 [[inheritance_further_reading]]
-=== Leitura complementar
+=== Para saber mais
 
 [quote, Hynek Schlawack, "Subclassing in Python Redux"]
 ____
diff --git a/online/cap15.adoc b/online/cap15.adoc
@@ -1384,7 +1384,7 @@ O sistema de tipos de Python é um campo imenso e em rápida evolução. Este ca
 
 
 [[more_type_hints_further_sec]]
-=== Leitura complementar
+=== Para saber mais
 
 O((("gradual type system", "further reading on"))) sistema de tipagem estática de Python
 já era complexo quando foi originalmente projetado, e tem se tornado mais complexo a cada ano.
diff --git a/online/cap16.adoc b/online/cap16.adoc
@@ -930,7 +930,7 @@ Para tipos de sequências, `+` normalmente exige que ambos os operandos sejam do
 enquanto `+=` muitas vezes aceita qualquer iterável como o operando à direita do operador.
 
 [[further_reading_op_sec]]
-=== Leitura complementar
+=== Para saber mais
 
 Guido van Rossum((("operator overloading", "further reading on"))) escreveu uma boa apologia da sobrecarga de operadores em https://fpy.li/16-10["Why operators are useful" (_Porque operadores são úteis_)] (EN).
 Trey Hunner postou https://fpy.li/16-11["Tuple ordering and deep comparisons in Python" (_Ordenação de tuplas e comparações profundas em Python_)] (EN), argumentando que os operadores de comparação cheia de Python são mais flexíveis e poderosos do que os programadores vindos de outras linguagens costumam pensar.
diff --git a/online/cap17.adoc b/online/cap17.adoc
@@ -2220,7 +2220,7 @@ Apesar de difíceis de usar na prática, corrotinas clássicas são os alicerces
 Dicas de tipo para os tipos `Iterable`, `Iterator`, e `Generator` também foram abordadas—com esse último oferecendo um raro exemplo concreto de um parâmetro de tipo contra-variante.
 
 
-=== Leitura complementar
+=== Para saber mais
 
 Uma((("iterators", "further reading on")))((("generators", "further reading on")))((("coroutines", "further reading on"))) explicação técnica detalhada sobre geradoras aparece na _A Referência da Linguagem Python_, em https://docs.python.org/pt-br/3/reference/expressions.html#yieldexpr["6.2.9. Expressões yield"].
 A PEP onde as funções geradoras foram definidas é a https://fpy.li/pep255[PEP 255--Simple Generators (_Geradoras Simples_)].
diff --git a/online/cap23.adoc b/online/cap23.adoc
@@ -590,7 +590,7 @@ Para concluir o capítulo, a <<descriptor_usage_sec>> trouxe dicas práticas, e
 Como observado na <<whats_new_descriptor_sec>>, vários exemplos deste capítulo se tornaram mais simples graças ao método especial `+__set_name__+` do protocolo descritor, adicionado no Python 3.6. Isso é evolução da linguagem!
 ====
 
-=== Leitura complementar
+=== Para saber mais
 
 Além((("attribute descriptors", "further reading on"))) da referência obrigatória ao capítulo https://docs.python.org/pt-br/3/reference/datamodel.html["Modelo de dados"], o https://docs.python.org/pt-br/3/howto/descriptor.html["HowTo - Guia de descritores"], de  Raymond Hettinger, é um recurso valioso--e parte da https://docs.python.org/pt-br/3/howto/[coleção de HOWTOS] na documentação oficial de Python.
 
diff --git a/online/cap24.adoc b/online/cap24.adoc
@@ -1367,7 +1367,7 @@ Obrigado, Guido van Rossum e todos que a fazem ser assim.
 
 
 [[ch21-furtherreading]]
-=== Leitura complementar
+=== Para saber mais
 
 Caleb Hattingh—um dos revisores técnicos((("class metaprogramming", "further reading on"))) desse livro—escreveu o pacote https://fpy.li/24-20[_autoslot_], fornecendo uma metaclasse para a criação automática do atributo `+__slots__+` em uma classe definida pelo usuário, através da inspeção do bytecode de `+__init__+` e da identificação de todas as atribuições a atributos de `self`.
 Além de útil, esse pacote é um excelente exemplo para estudo: são apenas 74 linhas de código em _autoslot.py_, incluindo 20 linhas de comentários que explicam as partes mais difíceis.
diff --git a/vol1/cap02.adoc b/vol1/cap02.adoc
@@ -2499,7 +2499,7 @@ e mencionamos as outras implementações de filas na biblioteca padrão.
 
 
 [[array_fur_reading_sec]]
-=== Leitura complementar
+=== Para saber mais
 
 O((("sequences", "further reading on"))) capítulo 1, "Data Structures" (_Estruturas de Dados_)
 do «_Python Cookbook, 3rd ed._» [.small]#&#91;fpy.li/pycook3&#93;#
diff --git a/vol1/cap03.adoc b/vol1/cap03.adoc
@@ -1608,7 +1608,7 @@ Além disso, as classes `dict_keys` e `dict_items` suportam os operadores e mét
 
 [[further_reading_dict]]
 [role="pagebreak-before less_space"]
-=== Leitura complementar
+=== Para saber mais
 
 Na((("dictionaries and sets", "further reading on"))) documentação da Biblioteca Padrão de Python,
 a seção
diff --git a/vol1/cap04.adoc b/vol1/cap04.adoc
@@ -1863,7 +1863,7 @@ Demos uma olhada em outros metadados do Unicode, e vimos rapidamente as APIs de
 onde algumas funções podem ser chamadas com argumentos `str` ou `bytes`, produzindo resultados diferentes.
 
 
-=== Leitura complementar
+=== Para saber mais
 
 A palestra((("Unicode text versus bytes", "further reading on"))) de Ned Batchelder na PyCon US 2012,
 «_Pragmatic Unicode_» [.small]#&#91;fpy.li/4-28&#93;# foi marcante.
diff --git a/vol1/cap05.adoc b/vol1/cap05.adoc
@@ -1669,7 +1669,7 @@ funciona com instâncias de qualquer classe como sujeitos—e
 não apenas das classes criadas com as fábricas apresentadas nesse capítulo.
 
 [[further_data_class]]
-=== Leitura complementar
+=== Para saber mais
 
 A documentação((("data class builders", "further reading on")))
 padrão de Python para as fábricas de classes de dados vistas aqui é muito boa, e inclui muitos pequenos exemplos.
diff --git a/vol1/cap07.adoc b/vol1/cap07.adoc
@@ -814,7 +814,7 @@ que facilitam a programação funcional, reduzindo a necessidade de lidar com a
 
 
 [[first_cls_fn_further_reading_sec]]
-=== Leitura complementar
+=== Para saber mais
 
 Nos((("functions, as first-class objects", "further reading on"))) próximos capítulos, continuaremos nossa jornada pela programação com objetos função.
 O <<ch_type_hints_def>> é dedicado às dicas de tipo nos parâmetros de função e nos valores devolvidos por elas.
