cap12: wip

Author: ramalho

ferramentas/anchors.ini

@@ -182,7 +182,7 @@ pode escrever `fn(*args, **kwargs)` em vez de `apply(fn, args, kwargs)` como faz
 As funções de ordem superior `map`, `filter` e `reduce` ainda existem,
 mas temos alternativas melhores para a maioria de seus casos de uso, como mostra a próxima seção.
 
-[[map_filter_reduce]]
+[[map_filter_reduce_sec]]
 ==== Substitutos modernos para map, filter, e reduce
 
 Linguagens funcionais((("list comprehensions (listcomps)", "versus map and filter functions")))((("generator expressions (genexps)")))
@@ -523,13 +523,13 @@ Após esse mergulho nos recursos flexíveis de declaração de argumentos no Pyt
 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]]
+[[operator_module_sec]]
 ==== O módulo operator
 
 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_sec>>—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]]
@@ -712,7 +712,7 @@ O segundo teste do <<methodcaller_demo>> mostra que `methodcaller` pode também
 ==== Fixando argumentos com functools.partial
 
 O((("functools module", "freezing arguments with", id="functools07")))((("arguments", "freezing with functools.partial"))) módulo `functools` oferece várias funções de ordem superior.
-Já vimos `reduce` na <<map_filter_reduce>>.
+Já vimos `reduce` na <<map_filter_reduce_sec>>.
 Uma outra é `partial`: dado um invocável, ela produz um novo invocável com alguns dos argumentos do invocável original vinculados a valores pré-determinados.
 Isso é útil para adaptar uma função que recebe um ou mais argumentos a uma API que requer uma função de callback com menos argumentos.
 O <<ex_partial_mul>> é uma demonstração trivial.

ferramentas/anchors.ini.zip

@@ -440,7 +440,7 @@ Vamos((("Vector class, multidimensional", "__hash__
 Juntamente com o `+__eq__+` existente, isso tornará as instâncias de `Vector` _hashable_.
 
 O `+__hash__+` do `Vector2d` (no <<ex_vector2d_v3_hash>>) computava o _hash_ de uma `tuple` construída com os dois componentes, `self.x` and `self.y`.
-Agora podemos estar lidando com milhares de componentes, então criar uma `tuple` pode ser caro demais. Em vez disso, vou aplicar sucessivamente o operador `^` (xor) aos _hashes_ de todos os componentes, assim: `v[0] ^ v[1] ^ v[2]`. É para isso que serve a função `functools.reduce`. Anteriormente afirmei que `reduce` não é mais tão popular quanto antes,footnote:[`sum`, `any`, e `all` cobrem a maioria dos casos de uso comuns de `reduce`. Veja a discussão na <<map_filter_reduce>>.] mas computar o _hash_ de todos os componentes do vetor é um bom caso de uso para ela. A <<reduce_fig>> ilustra a ideia geral da((("reducing functions"))) função `reduce`.
+Agora podemos estar lidando com milhares de componentes, então criar uma `tuple` pode ser caro demais. Em vez disso, vou aplicar sucessivamente o operador `^` (xor) aos _hashes_ de todos os componentes, assim: `v[0] ^ v[1] ^ v[2]`. É para isso que serve a função `functools.reduce`. Anteriormente afirmei que `reduce` não é mais tão popular quanto antes,footnote:[`sum`, `any`, e `all` cobrem a maioria dos casos de uso comuns de `reduce`. Veja a discussão na <<map_filter_reduce_sec>>.] mas computar o _hash_ de todos os componentes do vetor é um bom caso de uso para ela. A <<reduce_fig>> ilustra a ideia geral da((("reducing functions"))) função `reduce`.
 
 ////
 PROD: unexpected indent in first line after page break
@@ -490,7 +490,7 @@ Voltando a nosso problema de _hash_, o <<ex_reduce_xor>> demonstra a ideia da co
 
 Das alternativas apresentadas no <<ex_reduce_xor>>, a última é minha favorita, e o loop `for` vem a seguir. Qual sua preferida?
 
-Como visto na <<operator_module_section>>, `operator` oferece a funcionalidade de todos os operadores infixos de Python em formato de função, diminuindo a necessidade do uso de `lambda`.
+Como visto na <<operator_module_sec>>, `operator` oferece a funcionalidade de todos os operadores infixos de Python em formato de função, diminuindo a necessidade do uso de `lambda`.
 
 Para escrever `+Vector.__hash__+` no meu estilo preferido precisamos importar os módulos `functools` e `operator`. <<ex_vector_v4>> apresenta as modificações relevantes.
 
@@ -683,7 +683,7 @@ para evitar manipulação direta de variáveis índice.
 Quem não estiver familiarizado com `enumerate` deve estudar a seção dedicada a ela na
 https://docs.python.org/pt-br/3/library/functions.html#enumerate[documentação das "Funções embutidas"].
 As funções embutidas `zip` e `enumerate`, bem como várias outras funções geradores na biblioteca padrão,
-são tratadas na <<stdlib_generators>>.
+são tratadas na <<stdlib_generators_sec>>.
 ****
 
 Vamos encerrar esse capítulo trazendo de volta o método `+__format__+` do `Vector2d` para o `Vector`.

online/cap07.adoc

@@ -943,15 +943,15 @@ ao implementar geradoras, olhe o que já está disponível na biblioteca padrão
 Por isso a próxima seção trata de várias funções geradoras prontas para usar.((("", startref="Garith17")))
 
 
-[[stdlib_generators]]
+[[stdlib_generators_sec]]
 === Funções geradoras na biblioteca padrão
 
-// [NOTE]
-// ====
-// Perhaps you know all the functions mentioned in this section, but some of them are underused, so a quick overview may be good to recall what's already available.
-// ====
-
-A((("generators", "generator functions in Python standard library", id="Ggenfunc17"))) biblioteca padrão oferece muitas geradoras, desde objetos de arquivo de texto fornecendo iteração linha por linha até a incrível função pass:[<a href="https://fpy.li/17-12"><code>os.walk</code></a>], que produz nomes de arquivos enquanto cruza uma árvore de diretórios, tornando buscas recursivas no sistema de arquivos tão simples quanto um loop `for`.
+A((("generators", "generator functions in Python standard library",
+id="Ggenfunc17"))) biblioteca padrão oferece muitas geradoras, desde objetos de
+arquivo de texto fornecendo iteração linha por linha até a incrível função
+https://fpy.li/17-12[os.walk], que produz nomes de arquivos percorrendo uma
+árvore de diretórios, reduzindo uma busca recursiva no sistema de arquivos
+a um simples laço `for`.
 
 A função geradora `os.walk` é impressionante, mas nesta seção quero me concentrar em funções genéricas que recebem iteráveis arbitrários como argumento e devolvem geradores que produzem itens selecionados, calculados ou reordenados. Nas tabelas a seguir, resumi duas dúzias delas, algumas embutidas, outras dos módulos `itertools` e `functools`. Por conveniência, elas estão agrupadas por sua funcionalidade de alto nível, independente de onde são definidas.
 

online/cap12.adoc

@@ -1,4 +1,7 @@
 #!/bin/bash
 set -e  # exit when any command fails
+name="${1%.*}-miolo.pdf"
+echo $name
 bundle exec asciidoctor-pdf -v --theme pyfl-fontmix-theme.yml -a pdf-fontsdir=./fonts/ $1
-open "${1%.*}.pdf"
+pdfunite "${1%.*}.pdf" colofao.pdf $name
+open $name

online/cap17.adoc

@@ -182,7 +182,7 @@ pode escrever `fn(*args, **kwargs)` em vez de `apply(fn, args, kwargs)` como faz
 As funções de ordem superior `map`, `filter` e `reduce` ainda existem,
 mas temos alternativas melhores para a maioria de seus casos de uso.
 
-[[map_filter_reduce]]
+[[map_filter_reduce_sec]]
 ==== Substitutos modernos para map, filter, e reduce
 
 Linguagens funcionais((("list comprehensions (listcomps)", "versus map and filter functions")))((("generator expressions (genexps)")))
@@ -524,13 +524,13 @@ Após esse mergulho nos recursos flexíveis de declaração de argumentos no Pyt
 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]]
+[[operator_module_sec]]
 ==== O módulo operator
 
 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_sec>>—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]]
@@ -713,7 +713,7 @@ O segundo teste do <<methodcaller_demo>> mostra que `methodcaller` pode também
 ==== Fixando argumentos com functools.partial
 
 O((("functools module", "freezing arguments with", id="functools07")))((("arguments", "freezing with functools.partial"))) módulo `functools` oferece várias funções de ordem superior.
-Já vimos `reduce` na <<map_filter_reduce>>.
+Já vimos `reduce` na <<map_filter_reduce_sec>>.
 Uma outra é `partial`: dado um invocável, ela produz um novo invocável com alguns dos argumentos do invocável original vinculados a valores pré-determinados.
 Isso é útil para adaptar uma função que recebe um ou mais argumentos a uma API que requer uma função de _callback_ com menos argumentos.
 O <<ex_partial_mul>> é uma demonstração trivial.

print/pdf_export.sh

@@ -18,7 +18,7 @@
 :!chapter-signifier:
 include::../print/attrib-print-pt-br.adoc[]
 include::titulos-vol1.adoc[]
-:revisao: 12
+:revisao: 13
 
 include::Copyright-cor.adoc[]