ajustes menores

Author: ramalho

code/03-dict-set/py3.10/creator.py

@@ -27,14 +27,14 @@
 # tag::DICT_MATCH[]
 def get_creators(record: dict) -> list:
     match record:
-        case {'type': 'book', 'api': 2, 'authors': [*names]}:  # <1>
+        case {'type': 'book', 'api': 2, 'authors': [*names]}:       # <1>
             return names
-        case {'type': 'book', 'api': 1, 'author': name}:  # <2>
+        case {'type': 'book', 'api': 1, 'author': name}:            # <2>
             return [name]
-        case {'type': 'book'}:  # <3>
+        case {'type': 'book'}:                                      # <3>
             raise ValueError(f"Invalid 'book' record: {record!r}")
-        case {'type': 'movie', 'director': name}:  # <4>
+        case {'type': 'movie', 'director': name}:                   # <4>
             return [name]
-        case _:  # <5>
+        case _:                                                     # <5>
             raise ValueError(f'Invalid record: {record!r}')
 # end::DICT_MATCH[]

vol1/Prefacio.adoc

@@ -164,36 +164,37 @@ A configuração do _pytest.ini_, na raiz do «repositório do código de exempl
 
 === Ponto de vista: minha perspectiva pessoal
 
-Venho usando, ensinando e debatendo Python desde 1998, e gosto de estudar e comparar linguagens de programação, seus projetos e a teoria por trás delas. Ao final de alguns capítulos acrescentei uma seção "Ponto de vista", apresentando minha perspectiva sobre Python e outras linguagens. Você pode pular essas partes, se não tiver interesse em tais discussões. Seu conteúdo é inteiramente opcional.
+Venho usando, ensinando e debatendo Python desde 1998, e gosto de estudar e comparar linguagens de programação,
+o design e a teoria por trás delas.
+Ao final de alguns capítulos acrescentei uma seção "Ponto de vista",
+apresentando minha perspectiva sobre Python e outras linguagens.
+Você pode pular essas partes, se não tiver interesse em tais discussões.
+Seu conteúdo é inteiramente opcional.
 
 === Conteúdo na Web
 
 Criei dois sites para este livro:
 
 https://pythonfluente.com::
-O texto integral em português traduzido por Paulo Candido de Oliveira Filho. É que você está lendo agora.
+O texto integral em português traduzido por Paulo Candido de Oliveira Filho,
+publicado em um único HTML com todas as dependências embutidas (estilos, imagens, etc.).
+O HTML tem apenas diferenças cosméticas em relação a este livro impresso.
 
 https://fluentpython.com::
 Contém textos em inglês para ambas edições do livro, além de um glossário.
-É um material que eu cortei para não ultrapassar o limite de 1.000 páginas.
+É um material que cortei para não ultrapassar o limite de 1.000 páginas.
 
 O repositório de exemplos de código está no «GitHub» [.small]#[fpy.li/code]#.
 
 === Convenções usadas no livro
 
 As seguintes convenções tipográficas são usadas neste livro:
 
-_Itálico_:: Indica novos termos, URLs, endereços de email, nomes e extensões de arquivos footnote:[NT: Nesta edição em português
-também usamos _itálico_ em alguns termos mantidos em inglês ou traduções de termos cuja versão em português não é familiar].
-
-`Espaçamento constante`:: Usado para listagens de programas, bem como dentro de parágrafos para indicar elementos programáticos tais como nomes de variáveis ou funções, bancos de dados, tipos de dados, variáveis do ambiente, instruções e palavras-chave.
-+
-Observe que quando uma quebra de linha cai dentro de um termo de pass:[<span class="keep-together"><code>espaçamento constante</code></span>], o hífen não é utilizado--pois ele poderia ser erroneamente entendido como parte do termo.
-
-**`Espaçamento constante em negrito`**:: Mostra comandos ou outro texto que devem ser digitados literalmente pelo usuário.
-
-`_Espaçamento constante em itálico_`:: Mostra texto que deve ser substituído por valores fornecidos pelo usuário ou por valores determinados pelo contexto.
+_Itálico_:: Indica novos termos, URLs, endereços de email, nomes e extensões de arquivos. Nesta edição em português
+também usamos _itálico_ em alguns termos mantidos em inglês, principalmente na primeira ocorrência.
 
+`Espaçamento constante`:: Usado em listagens de programas,
+bem como dentro de parágrafos para indicar elementos programáticos como identificadores e palavras-chave.
 
 [role="pagebreak-before less_space"]
 [TIP]
@@ -352,8 +353,6 @@ Correções e sugestões de melhorias são bem vindas!
 Para contribuir, veja os
 «__issues__» [.small]#&#91;fpy.li/4m&#93;#
 no repositório https://github.com/pythonfluente/pythonfluente2e.
-
-Contamos com sua colaboração. 🙏
 ====
 
 === Histórico das traduções
@@ -399,17 +398,17 @@ a Editora Novatec não teve interesse em traduzir e publicar a segunda edição.
 
 Felizmente encontrei meu querido amigo Paulo Candido de Oliveira Filho (PC).
 Fomos colegas do ensino fundamental ao médio,
-e depois trabalhamos juntos como programadores em diferentes momentos e empresas.
+e depois trabalhamos juntos como programadores em diferentes empresas.
 Hoje ele presta serviços editoriais,
-inclusive faz traduções com a excelente qualidade desta aqui.
+inclusive traduções com a excelente qualidade desta aqui.
 
 Contratei PC para traduzir. Estou fazendo a revisão técnica,
 gerando os arquivos HTML com «Asciidoctor» [.small]#&#91;fpy.li/4p&#93;#
 e publicando em https://PythonFluente.com.
 Estamos trabalhando diretamente a partir do _Fluent Python, Second Edition_
-da O'Reilly, sem aproveitar a tradução da primeira edição, cujo copyright
-pertence à Novatec.
+da O'Reilly, sem olhar para a tradução da primeira edição, cujo copyright
+ainda pertence à Novatec.
 
-O copyright desta tradução pertence a mim.
+O copyright desta tradução agora é meu.
 
-_Luciano Ramalho, São Paulo, 13 de março de 2023_
+_Luciano Ramalho, São Paulo, 20 de setembro de 2025_

vol1/cap08.adoc

@@ -706,7 +706,7 @@ Nessa seção exploramos as relações de tipos e operações no duck typing e n
 começando com a função simples `double()`, que deixamos sem dicas de tipo.
 Agora vamos dar uma olhada nos tipos mais importantes ao anotar funções.
 
-Vamos ver um bom modo de adicionar dicas de tipo a `double()` quando examinarmos <<protocols_in_fn_sec>>.
+Veremos um bom modo de adicionar dicas de tipo a `double()` quando examinarmos <<protocols_in_fn_sec>>.
 Mas antes disso, há tipos mais importantes para conhecer.((("", startref="FTHsupport08")))((("", startref="THsup08")))
 
 
@@ -1149,7 +1149,7 @@ Podemos resumir esse processo em quatro etapas:
 . Remover aqueles tipos genéricos redundantes na primeira versão de Python lançada cinco anos após Python 3.9. No ritmo atual, esse deverá ser Python 3.14, também conhecido como Python Pi.
 ****
 
-Agora vamos ver como anotar tuplas genéricas.
+Agora veremos como anotar tuplas genéricas.
 
 [[tuple_type_sec]]
 ==== Tipos tuple
@@ -1625,7 +1625,7 @@ Da segunda vez que aparece, só aceitará o mesmo tipo vinculado da primeira vez
 Assim, qualquer iterável é _consistente-com_ `Iterable[T]`,
 incluindo iterável de tipos _unhashable_ que `collections.Counter` não consegue tratar.
 Precisamos restringir os tipos possíveis de se atribuir a `T`.
-Vamos ver maneiras diferentes de fazer isso nas duas seções seguintes.
+Veremos diferentes modos de fazer isso nas duas seções seguintes.
 
 <<<
 [[typevar_constraints_sec]]
@@ -1740,7 +1740,7 @@ AnyStr = TypeVar('AnyStr', bytes, str)
 O tipo `AnyStr` é usado em funções da biblioteca padrão que aceitam tanto `bytes` quanto `str`,
 e retornam valores do tipo recebido.
 
-Agora vamos ver `typing.Protocol`, um novo recurso de Python 3.8,
+Agora veremos `typing.Protocol`, um novo recurso de Python 3.8,
 que permite um uso mais pythônico de dicas de
 tipo.((("", startref="GTSparam08")))((("", startref="GCtypvar08")))((("", startref="typevar08")))
 
@@ -2495,7 +2495,8 @@ mas isso também é algo que torna muitos pacotes de Python divertidos de usar.
 
 Se dicas de tipo se tornarem obrigatórias sem exceções,
 por uma decisão superior em grande empresas,
-aposto que logo veremos pessoas usando geração de código para reduzir a verbosidade em programas Python,
+aposto que logo veremos pessoas usando geração de código
+para reduzir a verbosidade em programas Python,
 uma prática comum com linguagens menos dinâmicas.
 
 Para alguns projetos e contextos, dicas de tipo simplesmente não fazem sentido.