vol3: começando

ramalho · ramalho · commit 183fb2cbbdda · 2025-12-15T21:50:04.000-03:00
diff --git a/online/cap17.adoc b/online/cap17.adoc
diff --git a/online/cap19.adoc b/online/cap19.adoc
@@ -686,15 +686,17 @@ Até aqui experimentamos com uma única chamada para uma função de uso intensi
 
 [NOTE]
 ====
+
 Escrevi((("concurrency models", "process pools", id="CMprocess19")))((("process pools", "example problem")))
-essa seção para mostrar o uso de múltiplos processos em cenários de uso intensivo de CPU,
+esta seção para mostrar o uso de múltiplos processos em cenários de uso intensivo de CPU,
 e o padrão comum de usar filas para distribuir tarefas e coletar resultados.
 O <<ch_executors>> apresenta uma forma mais simples de distribuir tarefas para processos:
 um `ProcessPoolExecutor` do pacote `concurrent.futures`, que internamente usa filas.
+
 ====
 
-Nessa seção vamos escrever programas para checar se os números dentro de uma amostra de 20 inteiros são primos. Os números variam de 2 até 9.999.999.999.999.999—isto é, 10^16^ &ndash; 1, ou mais de 2^53^.
-A amostra inclui números primos pequenos e grandes, bem como números compostos com fatores primos grandes e pequenos.
+Nessa seção vamos escrever programas para checar se os números dentro de uma amostra de 20 inteiros são primos. Os números variam de 2 até 9.999.999.999.999.999—isto é, 10^16^ - 1, ou mais de 2^53^.
+A amostra inclui números primos pequenos e grandes, bem como números compostos com fatores primos pequenos e grandes.
 
 O((("sequential.py program"))) programa _sequential.py_ fornece a linha base de desempenho.
 Aqui está o resultado de uma execução de teste:
@@ -875,7 +877,7 @@ include::../code/19-concurrency/primes/procs.py[tags=PRIMES_PROC_MAIN]
 <1> Se nenhum argumento é dado na linha de comando, define o número de processos como o número de núcleos na CPU; caso contrário, cria quantos processos forem passados no primeiro  argumento.
 <2> `jobs` e `results` são as filas descritas no <<ex_primes_procs_top>>.
 <3> Inicia `proc` processos para consumir `jobs` e informar `results`.
-<4> Recupera e exibe os resultados; `report` está definido em pass:[<img src="callouts/6.png" alt="6"/>].
+<4> Recupera e exibe os resultados; `report` está definido em `⑥`.
 <5> Mostra quantos números foram checados e o tempo total decorrido.
 <6> Os argumentos são o número de `procs` e a fila para armazenar os resultados.
 <7> Percorre o loop até que todos os processos terminem.
@@ -1056,7 +1058,7 @@ ____
 
 Vemos muitas equipes se metendo em apuros por escolher ferramentas, frameworks ou arquiteturas complexas, porque eles "talvez precisem de escalabilidade".
 Empresas como o Twitter e a Netflix precisam aguentar cargas extremas, então precisam dessas arquiteturas, mas elas também tem equipes de desenvolvimento extremamente habilitadas, capazes de lidar com a complexidade.
-A maioria das situações não exige essas façanhas de engenharia; as equipes devem manter sua _inveja da escalabilidade na web_ sob controle, e preferir soluções simples que ainda assim fazem o que precisa ser feito.footnote:[Fonte: Thoughtworks Technology Advisory Board, https://fpy.li/19-40[_Technology Radar_&mdash;November 2015] (EN).]
+A maioria das situações não exige essas façanhas de engenharia; as equipes devem manter sua _inveja da escalabilidade na web_ sob controle, e preferir soluções simples que ainda assim fazem o que precisa ser feito.footnote:[Fonte: Thoughtworks Technology Advisory Board, https://fpy.li/19-40[_Technology Radar—November 2015_].]
 ____
 
 Na _escala da web_, a chave é uma arquitetura que permita escalabilidade horizontal.
@@ -1249,7 +1251,7 @@ _Python Essential Reference_, 4th ed. (Addison-Wesley), de David Beazley, e _Pyt
 A vasta documentação oficial de `multiprocessing` inclui conselhos úteis em sua seção
 https://docs.python.org/pt-br/3/library/multiprocessing.html#programming-guidelines["Programming guidelines" (_Diretrizes de programação_)] (EN).
 
-Jesse Noller e Richard Oudkerk contribuíram para o pacote `multiprocessing`, introduzido na https://fpy.li/pep371[PEP 371--Addition of the multiprocessing package to the standard library] (EN). A documentação oficial do pacote é um https://docs.python.org/pt-br/3/library/multiprocessing.html[arquivo de 93 KB _.rst_]&mdash;são cerca de 63 páginas—tornando-o um dos capítulos mais longos da biblioteca padrão de Python.
+Jesse Noller e Richard Oudkerk contribuíram para o pacote `multiprocessing`, introduzido na https://fpy.li/pep371[PEP 371--Addition of the multiprocessing package to the standard library] (EN). A documentação oficial do pacote é um https://docs.python.org/pt-br/3/library/multiprocessing.html[arquivo _.rst_] de 93 KB (cerca de 63 páginas), um dos capítulos mais longos da biblioteca padrão de Python.
 
 Em pass:[<a href="https://fpy.li/19-56" class="orm:hideurl"><em>High Performance Python</em>, 2nd ed.,</a>] (O'Reilly), os autores Micha Gorelick e Ian Ozsvald incluem um capítulo sobre `multiprocessing` com um exemplo sobre checagem de números primos usando uma estratégia diferente do nosso exemplo _procs.py_. Para cada número, eles dividem a faixa de fatores possíveis-de 2 a `sqrt(n)`—em subfaixas, e fazem cada unidade de execução iterar sobre uma das subfaixas.
 Sua abordagem de dividir para conquistar é típica de aplicações de computação científica, onde os conjuntos de dados são enormes, e as estações de trabalho (ou clusters) tem mais núcleos de CPU que usuários.
diff --git a/online/cap24.adoc b/online/cap24.adoc
@@ -225,15 +225,14 @@ Poderíamos ter dado qualquer outro nome ao atributo de classe `+__slots__+`, ma
 
 [WARNING]
 ====
-Instâncias de classes criadas por `record_factory` não são serializáveis--isto é, elas não podem ser exportadas com a função `dump` do módulo `pickle`. Resolver este problema está além do escopo desse exemplo, que tem por objetivo mostrar a classe `type` funcionando em um caso de uso simples. Para uma solução completa, estude o código-fonte de pass:[<a href="https://fpy.li/24-4"><span class=
-"keep-together"><code>collections.namedtuple</code></span></a>]; procure pela palavra "pickling".
+Instâncias de classes criadas por `record_factory` não são serializáveis--isto é, elas não podem ser exportadas com a função `dump` do módulo `pickle`. Resolver este problema está além do escopo deste exemplo, que tem por objetivo mostrar a classe `type` funcionando em um caso de uso simples. Para uma solução completa, estude o código-fonte de `collections.namedtuple`; procure pela palavra "pickling".
 ====
 
-Vamos ver agora como emular fábricas de classes mais modernas, como `typing.NamedTuple`, que recebe uma classe definida pelo usuário, escrita com o comando `class`, e a melhora automaticamente, acrescentando funcionalidade.((("", startref="CMfacfun24")))
+Vamos ver agora como emular fábricas de classes mais modernas, como `typing.NamedTuple`, que recebe uma classe definida pelo usuário, escrita com a instrução `class`, e a melhora automaticamente, acrescentando funcionalidade.((("", startref="CMfacfun24")))
 
 
 [[enhancing_with_init_subclass_sec]]
-=== Apresentando pass:[__init_subclass__]
+=== Apresentando `+__init_subclass__+`
 
 Tanto((("class metaprogramming", "&#x005F;&#x005F;init_subclass&#x005F;&#x005F;", id="CMinitsub24", secondary-sortas="init")))((("&#x005F;&#x005F;init&#x005F;subclass&#x005F;&#x005F;", id="initsub24"))) `+__init_subclass__+` quanto `+__set_name__+` foram propostos na
 https://fpy.li/pep487[PEP 487—Simpler customization of class creation (_PEP 487—Uma customização mais simples da criação de classes_)].
diff --git a/print/README.md b/print/README.md
@@ -1,5 +1,19 @@
 # Procedimentos para preparar volumes para impressão
 
+## Rever ISBN na página de copyright e na contra-capa
+
+Python Fluente, 2ª edição...
+
+|volume| variante  | ISBN              |
+|------|-----------|-------------------|
+|    1 | standard  | 978-65-988962-1-8 |
+|      | dunder    | 978-65-988962-0-1 |
+|    2 | standard  | 978-65-989778-3-2 |
+|      | dunder    | 978-65-989778-2-5 |
+|    3 | standard  | 978-65-989778-1-8 |
+|      | dunder    | 978-65-989778-6-3 |
+
+
 ## Formatação dos links
 
 Renderize este markdown para ver a *aparência* dos links.
diff --git a/vol3/Copyright-cor.adoc b/vol3/Copyright-cor.adoc
@@ -0,0 +1,48 @@
+[colophon%discrete%notitle%nonfacing,toclevels=0]
+= Copyright
+:isbn-cor: XXXX
+:isbn-pb: XXXX
+
+Tradução autorizada em português de
+_Fluent Python, 2nd Edition_ + 
+ISBN 978-1-492-05635-5
+© 2022 Luciano Ramalho. +
+Esta tradução é publicada e vendida com a permissão da O'Reilly Media, Inc.,
+detentora dos direitos para publicação e venda desta obra.
+
+© 2025 Luciano Ramalho. +
+_Python Fluente, 2ª edição_ está publicado sob a licença
+CC BY-NC-ND 4.0 +
+_Atribuição-NãoComercial-SemDerivações 4.0 Internacional_ [.small]#&#91;fpy.li/ccby&#93;#. +
+O autor mantém uma versão online em https://PythonFluente.com.
+
+Autor: Luciano Ramalho +
+Título: Python Fluente, 2ª edição, volume 3: controle e metaprogramação +
+Primeira edição: 2015 +
+Edição atual: setembro/2025 +
+{revisao}ª revisão: `pyfl-vol2-rev{revisao}-cor.pdf`
+
+Tradução da 2ª edição: Paulo Candido de Oliveira Filho +
+Ilustração de capa: Thiago Castor (xilogravura "Calango") +
+Design da capa: Luciano Ramalho, Zander Catta Preta @ Z•Edições +
+Design do miolo: Luciano Ramalho, com Asciidoctor +
+Ficha catalográfica: Edison Luís dos Santos
+
+Publisher: Heinar Maracy @ Z•Edições
+
+----
+R135p   Ramalho, Luciano.
+
+        Python Fluente, 2a edição, volume 3: controle e metaprogramação /
+        Luciano Ramalho - São Paulo, SP - Z.Edições, 2025.
+        400 f.; il.; cor; 17 cm × 24 cm
+
+        ISBN: XXX-XX-XXXXXX-X-X
+        1.Informática. 2.Linguagem de Programação. 3.Python.
+        4.Metaprogramação.
+
+        I.Título II.Dados e funções III.RAMALHO, Luciano.
+
+                                                            CDU: 004.438
+                                                            CDD: 005.133
+----
diff --git a/vol3/README.md b/vol3/README.md
@@ -0,0 +1,19 @@
+# Python Fluente, 2ª ed, volume 3
+
+## Progresso
+
+Faço as primeiras tarefas nos arquivos `/online/cap??.adoc`.
+
+Depois copio cada arquivo para `/vol3/cap??.adoc`
+e faço as demais tarefas nestas cópias especiais para impressão.
+
+| 17| 18| 19| 20| 21| 22| 23| 24| local | tarefa |
+|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|-------|-------|
+|   |   |   |   |   |   |   |   |`/online`|encurtar links externos|
+|   |   |   |   |   |   |   |   |`/online`|revisar estilo|
+|   |   |   |   |   |   |   |   |`/online`|revisar ortografia e gramática|
+|   |   |   |   |   |   |   |   |`/vol3`| refazer referências entre volumes|
+|   |   |   |   |   |   |   |   |`/vol3`| encurtar links entre volumes |
+|   |   |   |   |   |   |   |   |`/vol3`| exibir capítulo alvo em xrefs para exemplos de outros capítulos |
+|   |   |   |   |   |   |   |   |`/vol3`| rever paginação   |
+
diff --git a/vol3/vol3-cor.adoc b/vol3/vol3-cor.adoc
@@ -0,0 +1,41 @@
+= Python Fluente, 2ª edição: volume 3&#58; Controle e Metaprogramação
+:doctype: book
+:media: prepress
+:hide-uri-scheme:
+:pdf-page-size: [17cm, 24cm]
+:source-highlighter: rouge
+:rouge-style: github
+:author: Luciano Ramalho
+:lang: pt_BR
+:language: asciidoctor
+:xrefstyle: short
+:sectnums:
+:sectnumlevels: 4
+:sectlinks:
+:data-uri:
+:toclevels: 2
+:toc: macro
+:!chapter-signifier:
+include::../print/attrib-print-pt-br.adoc[]
+:chapter-number: 16
+:revisao: 10
+
+include::Copyright-cor.adoc[]
+
+[dedication%notitle%discrete,toclevels=0]
+= Dedicatória
+__Para Marta, com todo o meu amor.__
+
+toc::[]
+
+= Parte IV: Classes e protocolos
+:sectnums:
+
+include::../online/cap17.adoc[]
+include::../online/cap18.adoc[]
+include::../online/cap19.adoc[]
+include::../online/cap20.adoc[]
+include::../online/cap21.adoc[]
+include::../online/cap22.adoc[]
+include::../online/cap23.adoc[]
+include::../online/cap24.adoc[]
