Merge remote-tracking branch 'origin/main'

Author: ramalho

online/cap11.adoc

@@ -905,7 +905,7 @@ Uma percepção precoce da necessidade de strings de representação diferentes
 
 
 [role="soapbox-title"]
-Propriedades ajudam a reduzir custos iniciais
+**Propriedades ajudam a reduzir custos iniciais**
 
 Nas((("attributes", "properties and up-front costs")))((("Pythonic objects", "Soapbox discussion", id="POsoap11")))((("Soapbox sidebars", "properties and up-front costs"))) primeiras versões de `Vector2d`, os atributos `x` e `y` eram públicos, como são, por default, todos os atributos de instância e classe no Python. Naturalmente, os usuários de vetores precisam acessar seus componentes. Apesar de nossos vetores serem iteráveis e poderem ser desempacotados em um par de variáveis, também é desejável poder escrever `my_vector.x` e `my_vector.y` para obter cada componente.
 
@@ -941,7 +941,7 @@ Em Python, podemos simplesmente usar atributos públicos, sabendo que podemos tr
 
 
 [role="soapbox-title"]
-Proteção versus segurança em atributos privados
+**Proteção versus segurança em atributos privados**
 
 [quote, Larry Wall, criador do Perl]
 ____

print/xrefs/formatos.adoc

@@ -4,7 +4,7 @@
 
 ==== Alvo: capítulo
 
-Ex cap01:
+Ex. do cap01:
 
 [source, asciidoctor]
 ----
@@ -17,7 +17,7 @@ Capítulo 2
 
 ==== Alvo: seção
 
-Ex cap02:
+Ex. do cap02:
 
 [source, asciidoctor]
 ----
@@ -32,13 +32,18 @@ Seção 2.6
 
 ==== Alvo: capítulo
 
-Ex cap.1, l.745:
+Ex. do cap01, l.745:
 
 [source, asciidoctor]
 ----
 <<ch_seq_methods>>
 ----
 
+[source, html]
+----
+<h2 id="ch_seq_methods"><a class="link" href="#ch_seq_methods">12. Métodos especiais para sequências</a></h2>
+----
+
 Saída:
 
 Capítulo 12 [vol.2, fpy.li/xyz]
@@ -47,13 +52,19 @@ Onde fpy.li/xyz direciona para:
 
 https://pythonfluente.com/2/#ch_seq_methods
 
+
 ==== Alvo: seção
 
-Ex. cap05, l.42
+Ex. do cap05, l.42
 
 [source, asciidoctor]
 ----
-Veremos mais sobre isso na <<typeddict_sec>> (<<ch_more_types>>).
+Veremos mais sobre isso na <<typeddict_sec>>.
+----
+
+[source, html]
+----
+<h3 id="typeddict_sec"><a class="link" href="#typeddict_sec">15.3. TypedDict</a></h3>
 ----
 
 Saída:
@@ -62,4 +73,46 @@ Veremos mais sobre isso na Seção 15.3 [vol.2, fpy.li/xyz].
 
 Onde fpy.li/xyz direciona para:
 
-https://pythonfluente.com/2/#typeddict_sec
+https://pythonfluente.com/2/#typeddict_sec
+
+
+=== Alvo: exemplo
+
+Ex. do cap03, l.825
+
+[source, asciidoctor]
+----
+O <<environment_class_ex>> mostra uma subclasse
+----
+
+[source, html]
+----
+<div id="environment_class_ex" class="exampleblock">
+<div class="title">Exemplo 349. <em>lis.py</em>: a classe <code>Environment</code></div>
+<div class="content">
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-py" data-lang="py">class Environment(ChainMap[Symbol, Any]):
+    "A ChainMap that allows changing an item in-place."
+
+    def change(self, key: Symbol, value: Any) -&gt; None:
+        "Find where key is defined and change the value there."
+        for map in self.maps:
+            if key in map:
+                map[key] = value  # type: ignore[index]
+                return
+        raise KeyError(key)</code></pre>
+</div>
+</div>
+</div>
+</div>
+----
+
+Saída:
+
+O Exemplo 349 [cap.18, vol.2, fpy.li/xyz].
+
+Onde fpy.li/xyz direciona para:
+
+https://pythonfluente.com/2/#environment_class_ex
+

vol1/cap05.adoc

@@ -39,7 +39,7 @@ Entretanto, `TypedDict` não cria classes concretas que possam ser instanciadas.
 Ela é apenas a sintaxe para escrever dicas de tipo para parâmetros de função e
 variáveis que aceitarão valores de mapeamentos como registros,
 enquanto suas chaves serão os nomes dos campos.
-Veremos mais sobre isso na <<typeddict_sec>> (<<ch_more_types>>).
+Veremos mais sobre isso na <<typeddict_sec>>.
 ====
 
 
@@ -930,7 +930,7 @@ Valores default mutáveis são a fonte mais comum de bugs entre desenvolvedores
 Em definições de função, um valor default mutável é facilmente corrompido,
 quando uma invocação da função modifica o default,
 mudando o comportamento nas invocações posteriores—um tópico que
-vamos explorar na <<mutable_default_parameter_sec>> (<<ch_refs_mut_mem>>).
+vamos explorar na <<mutable_default_parameter_sec>>.
 Atributos de classe são frequentemente usados como valores default de atributos para instâncias,
 inclusive em classes de dados.
 E o `@dataclass` usa os valores default nas dicas de tipo para gerar parâmetros com defaults no

vol1/cap08.adoc

@@ -1720,7 +1720,7 @@ um substantivo mais comum e explícito que também significa _limite_.
 ====
 
 O construtor de `typing.TypeVar` tem outros parâmetros opcionais (`covariant` e `contravariant`)
-que envolvem conceitos avançados que vamos deixar para o <<ch_more_types>>, <<variance_sec>>.
+que envolvem conceitos avançados que vamos deixar para a <<variance_sec>>.
 
 Agora vamos concluir essa introdução a `TypeVar` com `AnyStr`.