preprint 2

Author: ramalho

print/deploy.sh

@@ -0,0 +1,9 @@
+
+#!/bin/bash
+set -e  # exit when any command fails
+# asciidoctor Livro.adoc -o index.html
+
+scp $1 [email protected]:/home/dh_kqh7yy/pythonfluente.com/
+# rsync -avz --delete ../vol1/pyfl-vol1-pre1.pdf [email protected]:~/pythonfluente.com/2/
+
+# open https://pythonfluente.com/2/

vol1/Prefacio.adoc

@@ -9,7 +9,6 @@
 :part-caption: Parte
 :sectnums!:
 
-[dedication]
 __Para Marta, com todo o meu amor.__
 
 [[preface]]
@@ -123,17 +122,19 @@ do <<ch_dataclass>>,
 que discutem padrões para sequências, padrões para mapeamentos e padrões para instâncias de classes.
 O último capítulo deste volume é sobre o ciclo de vida dos objetos: criação, referências, mutabilidade e coleta de lixo (_garbage collection_).
 
-{pa_func_obj} (capítulos 7-10):: Lá falamos sobre funções como objetos de primeira classe na linguagem: o significado disso, como isso afeta alguns padrões de projetos populares e como aproveitar as clausuras para implementar decoradores de função. Também são vistos aqui o conceito geral de invocáveis no Python, atributos de função, introspecção, anotação de parâmetros e a nova declaração `nonlocal` no Python 3. O _{ch_type_hints_def}_ 
-introduz esse tópico importante e relativamente novo em Python.
+{pa_func_obj_a} (capítulos 7-8):: Aqui explicamos o que significa ter funções como objetos de primeira classe na linguagem
+Também são vistos aqui o conceito geral de invocáveis no Python e anotação de parâmetros com _type hints_ no {ch_type_hints_def}. 
 
 ===== {vo_func_cls}
 
+{pa_func_obj_b} (capítulos 9-10):: Lá desvendamos o conceito de _closure_, a instrução `nonlocal`, e as aplicações destes conceitos na construção de decoradores. Outro tema é o uso de funções de primeira classe para simplificar muito a implementação de alguns padrões de projeto conhecidos.
+
 {pa_cls_proto} (capítulos 11-16):: Agora o foco se volta para a criação "manual" de classes—em contraste com o uso de fábricas de classe vistas no <<ch_dataclass>>.
 Como qualquer linguagem orientada a objetos, Python tem seu conjunto particular de recursos que podem ou não estar presentes na linguagem na qual você ou eu aprendemos programação baseada em classes. Os capítulos explicam como criar suas próprias coleções, classes base abstratas (ABCs) e protocolos, bem como as formas de lidar com herança múltipla e como implementar a sobrecarga de operadores, quando fizer sentido. O _{ch_more_types}_ continua a conversa sobre dicas de tipo.
 
 ===== {vo_ctrl_meta}
 
-{pa_ctrl_flow} (capítulos 17-21):: Nesta parte estudadis as instruções da linguagem e as bibliotecas que vão além do controle de fluxo tradicional
+{pa_ctrl_flow} (capítulos 17-21):: Nesta parte estudamos as instruções da linguagem e as bibliotecas que vão além do controle de fluxo tradicional
 (condicionais, laços e sub-rotinas). Começamos com os geradores, visitamos a seguir os gerenciadores de contexto e as corrotinas, incluindo a desafiadora mas poderosa sintaxe do `yield from`. O _{ch_with_match}_ inclui um exemplo significativo, usando _pattern matching_ em um interpretador de linguagem simples mas funcional. O _{ch_concurrency_models}_ é novo, apresentando uma visão geral das alternativas para processamento concorrente e paralelo no Python, suas limitações, e como a arquitetura de software permite ao Python operar na escala da Web. Reescrevi o capítulo sobre _programação assíncrona_, para enfatizar os recursos centrais da linguagem—por exemplo, `await`, `async def`, `async for` e `async with`, e mostrar como eles são usados com _asyncio_ e outros frameworks.
 
 {pa_metaprog} (capítulos 22-24):: Essa parte começa com uma revisão de técnicas para criação de classes com atributos criados dinamicamente para lidar com dados semi-estruturados, tal como conjuntos de dados JSON. A seguir tratamos do mecanismo familiar das propriedades, antes de mergulhar no funcionamento do acesso a atributos de objetos no Python em um nível mais baixo, usando descritores. A relação entre funções, métodos e descritores é explicada. Ao longo daquele volume, a implementação passo a passo de uma biblioteca de validação de campos revela questões sutis, levando às ferramentas avançadas do capítulo final: decoradores de classes e metaclasses.

vol1/xrefs-v1.adoc vol1/titulos-vol1.adocvol1/xrefs-v1.adoc renamed to vol1/titulos-vol1.adoc

@@ -1,7 +1,7 @@
 // Substituições para referências cruzadas a partir do volume I
 
 // Vol.1
-:vo_data_str: Volume 1—Estruturas de dados
+:vo_data_str: Volume 1: dados + funções
 // Parte I
 :pa_data: Parte I—Estruturas de dados
 :ch_data_model: Cap. 1—O modelo de dados de Python
@@ -11,11 +11,12 @@
 :ch_dataclass: Cap. 5—Fábricas de classes de dados
 :ch_refs_mut_mem: Cap. 6—Referências, mutabilidade, e memória
 // Parte II
-:pa_func_obj: Parte II—Funções como objetos
+:pa_func_obj_a: Parte IIa—Funções como objetos
 :ch_func_objects: Cap. 7—Funções como objetos de primeira classe
 :ch_type_hints_def: Cap. 8—Dicas de tipo em funções
 // Vol.2
-:vo_func_cls: Volume 2—Decoradores, classes e protocolos
+:pa_func_obj_b: Parte IIb—Funções como objetos
+:vo_func_cls: Volume 2: classes + protocolos
 :ch_closure_decorator: Cap. 9—Decoradores e Clausuras (vol. 2)
 :ch_design_patterns: Cap. 10—Padrões de projetos com funções de primeira classe (vol. 2)
 // Parte III
@@ -27,7 +28,7 @@
 :ch_more_types: Cap. 15—Mais dicas de tipo (vol. 2)
 :ch_op_overload: Cap. 16—Sobrecarga de operadores (vol. 2)
 // Vol.3
-:vo_ctrl_meta: Volume 3—Concorrência e metaprogramação
+:vo_ctrl_meta: Volume 3: controle + metaprogramação
 // Parte IV
 :pa_ctrl_flow: Parte IV—Controle de fluxo
 :ch_generators: Cap. 17—Iteradores, geradores e corrotinas clássicas (vol. 3)

vol1/vol1.adoc

@@ -1,4 +1,4 @@
-= Python Fluente: dados e funções
+= Python Fluente:  2ª edição, volume 1: dados e funções
 :doctype: book
 :media: prepress
 :hide-uri-scheme:
@@ -12,13 +12,35 @@
 :sectnumlevels: 4
 :sectlinks:
 :data-uri:
-:toc: left
+:toc: macro
 :toclevels: 2
 :!chapter-signifier:
-:front-cover-image: image:xilo_calango_tc_flat.png[fit=cover]
-
 include::../print/attrib-print-pt-br.adoc[]
-include::xrefs-v1.adoc[]
+include::titulos-vol1.adoc[]
+
+[colophon%notitle%nonfacing]
+= Colophon
+
+Python Fluente, 2ª edição, volume 1: dados e funções
+
+(C) 2025 Luciano Ramalho
+
+Tradução autorizada de _Fluent Python Second Edition_ (O'Reilly, 2022)
+
+Tradução: Paulo Candido Oliveira Filho
+
+Revisão: Luciano Ramalho, com colaborações da comunidade Python
+
+Capa: ???
+
+Miolo: feito com Asciidoctor por Luciano Ramalho.
+
+
+
+2ª pré-impressão
+
+toc::[]
+
 include::Prefacio.adoc[]
 
 [[data_structures_part]]