uniformizar termos

Author: ramalho

capitulos/cap01.adoc

@@ -510,7 +510,7 @@ Ele deve devolver uma string apropriada para ser exibida aos usuários finais da
 Algumas vezes a própria string devolvida por `+__repr__+` é adequada para exibir ao usuário,
 e você não precisa programar `+__str__+`,
 porque a implementação de `+__str__+` herdada da classe `object` já invoca `+__repr__+`.
-O <<coord_tuple_ex>> é um dos muitos exemplos neste livro com um `+__str__+` personalizado.
+O <<coord_tuple_ex>> é um dos muitos exemplos neste livro com um `+__str__+` customizado.
 
 [TIP]
 ====

capitulos/cap04.adoc

@@ -1500,7 +1500,7 @@ O <<ex_pyuca_sort>> mostra como ela é fácil de usar.
 Isso é simples e funciona no GNU/Linux, no macOS, e no Windows, pelo menos com a minha pequena amostra.
 
 A `pyuca` não leva o _locale_ em consideração.
-Se você precisar personalizar a ordenação,
+Se você precisar customizar a ordenação,
 pode fornecer um caminho para uma tabela própria de ordenação para o construtor `Collator()`.
 Sem qualquer configuração adicional, a biblioteca usa o https://fpy.li/4-18[_allkeys.txt_], incluído no projeto.
 Esse arquivo é apenas uma cópia da

capitulos/cap05.adoc

@@ -161,7 +161,7 @@ com as anotações de tipo escritas como descrito na
 https://fpy.li/pep526[PEP 526—Syntax for Variable Annotations (_Sintaxe para Anotações de Variáveis_)] (EN).
 É mais legível, e torna fácil  sobrescrever métodos ou acrescentar métodos novos.
 O <<coord_tuple_ex>> é a mesma classe `Coordinate`, com um par de atributos `float`
-e um `+__str__+` personalziado, para mostrar a coordenada no formato 55.8°N, 37.6°E.
+e um `+__str__+` customizado, para mostrar a coordenada no formato 55.8°N, 37.6°E.
 //  as shown in <<coord_tuple_ex>>.
 
 [[coord_tuple_ex]]
@@ -215,7 +215,7 @@ O decorador `@dataclass` não depende de herança ou de uma metaclasse,
 então não deve interferir no uso desses mecanismos pelo
 usuário.footnote:[Decoradores de classe são discutidos no <<ch_class_metaprog>>,
 na seção "Metaprogramação de classes", junto com as metaclasses.
-Ambos são formas de personalizar o comportamento de uma classe além do que seria possível com herança.]
+Ambos são formas de customizar o comportamento de uma classe além do que seria possível com herança.]
 A classe `Coordinate` no <<coord_dataclass_ex>> é uma subclasse de
 `object`.((("", startref="DCBover05")))
 
@@ -729,7 +729,7 @@ Na prática, isso significa que `a` e `b` vão funcionar como atributos de inst
 somente para leitura—o que faz sentido, se lembrarmos que instâncias de `DemoNTClass`
 são apenas tuplas chiques, e tuplas são imutáveis.
 
-A `DemoNTClass` também recebe uma docstring personalizada:
+A `DemoNTClass` também recebe uma docstring customizada:
 
 [source, pycon]
 ----
@@ -921,7 +921,7 @@ Se você achar que precisa usar essa opção, leia a
 https://fpy.li/3r[documentação de `dataclasses.dataclass`].
 
 
-Outras personalizações da classe de dados gerada podem ser feitas no nível dos campos.
+Outras customizações da classe de dados gerada podem ser feitas no nível dos campos.
 
 [[field_options_sec]]
 ==== Opções de campo

capitulos/cap07.adoc

@@ -482,7 +482,7 @@ def factorial(n):
 ====
 
 Outro grupo de "++lambda++s de um só truque" que `operator` substitui são funções para extrair itens de sequências ou para ler atributos de objetos:
-`itemgetter` e `attrgetter` são fábricas que criam funções personalizadas para fazer exatamente isso.
+`itemgetter` e `attrgetter` são fábricas que criam funções customizadas para fazer exatamente isso.
 
 O <<itemgetter_demo>> mostra um uso frequente de `itemgetter`: ordenar uma lista de tuplas pelo valor de um campo.
 No exemplo, as cidades são exibidas por ordem de código de país (campo 1).
@@ -699,7 +699,7 @@ functools.partial(<function tag at 0x10206d1e0>, 'img', class_='pic-frame')  <4>
 A função `functools.partialmethod` faz o mesmo que `partial`, mas foi projetada para trabalhar com métodos.
 
 O módulo `functools` também inclui funções de ordem superior para serem usadas como decoradores de função, tais como `cache` e `singledispatch`, entre outras.
-Essas funções são tratadas no <<ch_closure_decorator>>, que também explica como implementar decoradores personalizados.((("", startref="FAFfp07")))((("", startref="fprogpack07")))((("", startref="functools07")))
+Essas funções são tratadas no <<ch_closure_decorator>>, que também explica como implementar decoradores customizados.((("", startref="FAFfp07")))((("", startref="fprogpack07")))((("", startref="functools07")))
 
 
 === Resumo do capítulo

capitulos/cap09.adoc

@@ -915,7 +915,7 @@ As últimas duas funções no <<singledispatch_ex>> ilustram a sintaxe que funci
 
 
 [[singledispatch_ex]]
-.`@singledispatch` cria uma `@htmlize.register` personalizada, para empacotar várias funções em uma função genérica
+.`@singledispatch` cria uma `@htmlize.register` customizada, para empacotar várias funções em uma função genérica
 ====
 [source, py]
 ----
@@ -1011,7 +1011,7 @@ https://fpy.li/9-3[números inteiros e de ponto flutuante] (EN) em formatos volt
 Usar ABCs ou `typing.Protocol` com `@singledispatch` permite que seu código suporte classes existentes ou futuras que sejam subclasses reais ou virtuais daquelas ABCs, ou que implementem aqueles protocolos. O uso de ABCs e o conceito de uma subclasse virtual são assuntos do <<ch_ifaces_prot_abc>>.
 ====
 
-Uma qualidade notável do mecanismo de `singledispatch` é que você pode registrar funções especializadas em qualquer lugar do sistema, em qualquer módulo. Se mais tarde você adicionar um módulo com um novo tipo definido pelo usuário, é fácil acrescentar uma nova função específica para  tratar aquele tipo. E é possível também escrever funções personalizadas para classes que você não escreveu e não pode modificar.
+Uma qualidade notável do mecanismo de `singledispatch` é que você pode registrar funções especializadas em qualquer lugar do sistema, em qualquer módulo. Se mais tarde você adicionar um módulo com um novo tipo definido pelo usuário, é fácil acrescentar uma nova função específica para  tratar aquele tipo. E é possível também escrever funções customizadas para classes que você não escreveu e não pode modificar.
 
 O `singledispatch` foi uma adição muito bem pensada à biblioteca padrão, e oferece muitos outros recursos que não me cabe descrever aqui. Uma boa referência é a https://fpy.li/pep443[PEP 443--Single-dispatch generic functions] (EN) mas ela não menciona o uso de dicas de tipo, acrescentado posteriormente. A documentação do módulo `functools` foi aperfeiçoada e oferece um tratamento mais atualizado, com vários exemplos na seção referente ao https://docs.python.org/pt-br/3/library/functools.html#functools.singledispatch[`singledispatch`] (EN).
 

capitulos/cap11.adoc

@@ -301,12 +301,12 @@ O <<ex_format_t1>> implementa `+__format__+` para produzir as formatações vist
 <1> Usa a função embutida `format` para aplicar o `fmt_spec` a cada componente do vetor, criando um iterável de strings formatadas.
 <2> Insere as strings formatadas na fórmula `'(x, y)'`.
 
-Agora vamos acrescentar um código de formatação personalizado à nossa mini-linguagem: se o especificador de formato terminar com `'p'`, vamos exibir o vetor em coordenadas polares: `<r, θ>`,
+Agora vamos acrescentar um código de formatação customizado à nossa mini-linguagem: se o especificador de formato terminar com `'p'`, vamos exibir o vetor em coordenadas polares: `<r, θ>`,
 onde `r` é a magnitute e θ (theta) é o ângulo em radianos. O restante do especificador de formato (o que quer que venha antes do `'p'`) será usado como antes.
 
 [TIP]
 ====
-Ao escolher a letra para um código personalizado de formato, evitei  sobrescrever códigos usados por outros tipos. Na https://docs.python.org/pt-br/3/library/string.html#formatspec[Mini-Linguagem de Especificação de Formato] vemos que inteiros usam os códigos `'bcdoxXn'`, `floats` usam `'eEfFgGn%'` e strings usam `'s'`. Então escolhi `'p'` para coordenadas polares. Como cada classe interpreta esses códigos de forma independente, reutilizar uma letra em um formato personalizado para um novo tipo não é um erro, mas pode ser confuso para os usuários.
+Ao escolher a letra para um código customizado de formato, evitei  sobrescrever códigos usados por outros tipos. Na https://docs.python.org/pt-br/3/library/string.html#formatspec[Mini-Linguagem de Especificação de Formato] vemos que inteiros usam os códigos `'bcdoxXn'`, `floats` usam `'eEfFgGn%'` e strings usam `'s'`. Então escolhi `'p'` para coordenadas polares. Como cada classe interpreta esses códigos de forma independente, reutilizar uma letra em um formato customizado para um novo tipo não é um erro, mas pode ser confuso para os usuários.
 ====
 
 Para gerar coordenadas polares, já temos o método `+__abs__+` para a magnitude. Vamos então escrever um método `angle` simples, usando a função `math.atan2()`, para obter o ângulo. Eis o código:
@@ -742,7 +742,7 @@ O último tópico do capítulo trata da sobreposição de um atributo de classe
 
 Um((("Pythonic objects", "overriding class attributes", id="POoverride11")))((("attributes", "overriding class attributes", id="Aover11"))) recurso característico de Python é a forma como atributos de classe podem ser usados como valores default para atributos de instância. `Vector2d` contém o atributo de classe `typecode`. Ele é usado duas vezes no método `+__bytes__+`, mas é lido intencionalmente como `self.typecode`. As instâncias de `Vector2d` são criadas sem um atributo `typecode` próprio, então `self.typecode` vai, por default, se referir ao atributo de classe `Vector2d.typecode`.
 
-Mas se incluirmos um atributo de instância que não existe, estamos criando um novo atributo de instância—por exemplo, um atributo de instância `typecode`—e o atributo de classe com o mesmo nome permanece intocado. Entretanto, daí em diante, sempre que algum código referente àquela instância contiver `self.typecode`, o `typecode` da instância será usado, na prática escondendo o atributo de classe de mesmo nome. Isso abre a possibilidade de personalizar uma instância individual com um `typecode` diferente.
+Mas se incluirmos um atributo de instância que não existe, estamos criando um novo atributo de instância—por exemplo, um atributo de instância `typecode`—e o atributo de classe com o mesmo nome permanece intocado. Entretanto, daí em diante, sempre que algum código referente àquela instância contiver `self.typecode`, o `typecode` da instância será usado, na prática escondendo o atributo de classe de mesmo nome. Isso abre a possibilidade de customizar uma instância individual com um `typecode` diferente.
 
 O `Vector2d.typecode` default é `'d'`: isso significa que cada componente do vetor será representado como um número de ponto flutuante de dupla precisão e 8 bytes de tamanho quando for exportado para `bytes`. Se definirmos o `typecode` de uma instância `Vector2d` como `'f'` antes da exportação, cada componente será exportado como um número de ponto flutuante de precisão simples e 4 bytes de tamanho.. O <<typecode_instance_demo>> demonstra isso.
 
@@ -787,7 +787,7 @@ Para modificar um atributo de classe, é preciso redefini-lo diretamente na clas
 ----
 >>> Vector2d.typecode = 'f'
 ----
-Porém, no Python, há uma maneira idiomática de obter um efeito mais permanente, e de ser mais explícito sobre a modificação. Como atributos de classe são públicos, eles são herdados por subclasses. Então é uma prática comum fazer a subclasse personalizar um atributo da classe. As views baseadas em classes do Django usam amplamente essa técnica. O <<typecode_subclass_demo>> mostra como se faz.
+Porém, no Python, há uma maneira idiomática de obter um efeito mais permanente, e de ser mais explícito sobre a modificação. Como atributos de classe são públicos, eles são herdados por subclasses. Então é uma prática comum fazer a subclasse customizar um atributo da classe. As views baseadas em classes do Django usam amplamente essa técnica. O <<typecode_subclass_demo>> mostra como se faz.
 
 [[typecode_subclass_demo]]
 .O `ShortVector2d` é uma subclasse de `Vector2d`, que apenas sobrepõe o `typecode` default
@@ -823,7 +823,7 @@ Esse exemplo também explica porque não escrevi explicitamente o `class_name` e
 
 Se eu tivesse escrito o `class_name` explicitamente, subclasses de `Vector2d` como `ShortVector2d` teriam que sobrescrever `+__repr__+` só para mudar o `class_name`. Lendo o nome do `type` da instância, tornei `+__repr__+` mais seguro de ser herdado.
 
-Aqui termina nossa conversa sobre a criação de uma classe simples, que se vale do modelo de dados para se adaptar bem ao restante de Python: oferecendo diferentes representações do objeto, fornecendo um código de formatação personalizado, expondo atributos somente para leitura e suportando `hash()` para se integrar a conjuntos e mapeamentos.((("", startref="Aover11")))((("", startref="POoverride11")))
+Aqui termina nossa conversa sobre a criação de uma classe simples, que se vale do modelo de dados para se adaptar bem ao restante de Python: oferecendo diferentes representações do objeto, fornecendo um código de formatação customizado, expondo atributos somente para leitura e suportando `hash()` para se integrar a conjuntos e mapeamentos.((("", startref="Aover11")))((("", startref="POoverride11")))
 
 
 === Resumo do capítulo
@@ -872,7 +872,7 @@ ____
 
 Este((("Pythonic objects", "further reading on"))) capítulo tratou de vários dos métodos especiais do modelo de dados, então naturalmente as referências primárias são as mesmas do <<ch_data_model>>, onde tivemos uma ideia geral do mesmo tópico. Por conveniência, vou repetir aquelas quatro recomendações anteriores aqui, e acrescentar algumas outras:
 
-O https://docs.python.org/pt-br/3/reference/datamodel.html[capítulo "Modelo de Dados"] em _A Referência da Linguagem Python_:: A maioria dos métodos usados nesse capítulo estão documentados em https://docs.python.org/pt-br/3/reference/datamodel.html#basic-customization["3.3.1. Personalização básica"].
+O https://docs.python.org/pt-br/3/reference/datamodel.html[capítulo "Modelo de Dados"] em _A Referência da Linguagem Python_:: A maioria dos métodos usados nesse capítulo estão documentados em https://docs.python.org/pt-br/3/reference/datamodel.html#basic-customization["3.3.1. Customização básica"].
 
 pass:[<a class="orm:hideurl" href="https://fpy.li/pynut3"><em>Python in a Nutshell</em>, 3ª ed.,</a>] de Alex Martelli, Anna Ravenscroft, e Steve Holden:: Trata com profundidade dos métodos especiais .