Skip to content

Commit 960e9a8

Browse files
committed
removi pass:[] dos caps 1 a 8
1 parent 9e156dd commit 960e9a8

File tree

4 files changed

+33
-25
lines changed

4 files changed

+33
-25
lines changed

capitulos/cap03.adoc

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ resumem o que você precisa saber sobre isso para usar bem essas estruturas.
5959
====
6060
Após((("dictionaries and sets", "internals of"))) acrescentar mais de 200 páginas a essa segunda edição, transferi a seção opcional
6161
https://fpy.li/hashint["Internals of sets and dicts" (_As entranhas dos sets e dos dicts_)] (EN)
62-
para o pass:[<a href="http://fluentpython.com" class="orm:hideurl"><em>fluentpython.com</em></a>], o site que complementa o livro.
62+
para o http://fluentpython.com, o site que complementa o livro.
6363
O https://fpy.li/hashint[post de 18 páginas] (EN) foi atualizado e expandido, e inclui explicações e diagramas sobre:
6464
6565
* O algoritmo de tabela de hash e as estruturas de dados, começando por seu uso em `set`, que é mais simples de entender.
@@ -702,7 +702,7 @@ como explicado na próxima seção.
702702
====
703703

704704
[[inconsistent_missing]]
705-
==== O uso inconsistente de pass:[__missing__] na biblioteca padrão
705+
==== O uso inconsistente de `+__missing__+` na biblioteca padrão
706706

707707
Considere os seguintes cenários, e como eles afetam a busca de chaves ausentes:
708708

@@ -1370,7 +1370,7 @@ então Python pode mover e redimensionar a tabela conforme ela cresce.
13701370
Quando isso acontece, os elementos são reinseridos e sua ordem relativa pode mudar.
13711371

13721372
Veja o post https://fpy.li/hashint["Internals of sets and dicts"] (EN)
1373-
no pass:[<a href="http://fluentpython.com" class="orm:hideurl"><em>fluentpython.com</em></a>] para maiores detalhes.
1373+
no _http://fluentpython.com_ para maiores detalhes.
13741374

13751375
Agora vamos revisar a vasta seleção de operações oferecidas pelos conjuntos.
13761376

@@ -1605,10 +1605,11 @@ Na((("dictionaries and sets", "further reading on"))) documentação da Bibliote
16051605
a seção
16061606
https://fpy.li/2w["collections—Tipos de dados de contêineres"]
16071607
inclui exemplos e receitas práticas para vários tipos de mapeamentos.
1608-
O código-fonte de Python para o módulo, pass:[<em>Lib/collections/__init__.py</em>],
1608+
O código-fonte do módulo, `+Lib/collections/__init__.py+`,
16091609
é uma excelente referência para qualquer um que deseje criar novos tipos de mapeamentos
16101610
ou entender a lógica dos tipos existentes.
1611-
O capítulo 1 do pass:[<a class="orm:hideurl" href="https://fpy.li/pycook3"><em>Python Cookbook</em>, 3rd ed.</a>] (O'Reilly),
1611+
O capítulo 1 do
1612+
https://fpy.li/pycook3[_Python Cookbook, 3rd ed._] (O'Reilly),
16121613
de David Beazley e Brian K. Jones traz 20 receitas práticas e
16131614
perpicazes usando estruturas de dados—a maioria mostrando formas inteligentes de usar `dict`.
16141615

capitulos/cap04.adoc

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -921,13 +921,13 @@ include::code/04-text-byte/stdout_check.py[]
921921
====
922922

923923
O <<ex_stdout_check>> mostra o resultado de uma chamada a `sys.stdout.isatty()`,
924-
o valor de pass:[<code>sys.&#x200b;stdout.encoding</code>], e esses três caracteres:
924+
o valor de `sys.stdout.encoding`, e esses três caracteres:
925925

926926
* `'…'` `HORIZONTAL ELLIPSIS`—existe no CP 1252 mas não no CP 437.
927927
* `'∞'` `INFINITY`—existe no CP 437 mas não no CP 1252.
928928
* `'㊷'` `CIRCLED NUMBER FORTY TWO`—não existe nem no CP 1252 nem no CP 437.
929929

930-
Quando executo o _stdout_check.py_ no PowerShell ou no _cmd.exe_, funciona como visto na <<fig_stdout_check>>.
930+
Quando executo _stdout_check.py_ no PowerShell ou no _cmd.exe_, funciona como visto na <<fig_stdout_check>>.
931931

932932
[[fig_stdout_check]]
933933
.Executando _stdout_check.py_ no PowerShell.
@@ -1646,7 +1646,7 @@ Executar o <<ex_numerics_demo>> gera a <<numerics_demo_fig>>,
16461646
se a fonte do seu terminal incluir todos aqueles símbolos.
16471647

16481648
[[numerics_demo_fig]]
1649-
.Terminal do macOS mostrando os caracteres numéricos e metadados correspondentes; `re_dig` significa que o caractere casa com a expressão regular pass:[<code>r&#39;\d&#39;</code>].
1649+
.Terminal do macOS mostrando os caracteres numéricos e metadados correspondentes; `re_dig` significa que o caractere casa com a expressão regular `r'\d'`.
16501650
image::images/flpy_0407.png[Captura de tela de caracteres numéricos]
16511651

16521652
A sexta coluna da <<numerics_demo_fig>> é o resultado da chamada a `unicodedata.numeric(char)` com o caractere.
@@ -1914,8 +1914,10 @@ a primeira uma suave introdução e a segunda uma nota de um grupo de trabalho e
19141914
no seco jargão dos padrões—o mesmo tom do
19151915
https://fpy.li/4-47["Unicode Standard Annex #15--Unicode Normalization Forms"
19161916
(_Anexo 15 do Padrão Unicode—Formas de Normalização do Unicode_)] (EN).
1917-
A seção https://fpy.li/4-48["Frequently Asked Questions, Normalization" (_Perguntas Frequentes, Normalização_)] (EN)
1918-
do pass:[<a href="https://fpy.li/4-49" class="orm:hideurl"><em>Unicode.org</em></a>]
1917+
A seção
1918+
https://fpy.li/4-48["Frequently Asked Questions, Normalization" (_Perguntas Frequentes, Normalização_)] (EN)
1919+
do
1920+
https://fpy.li/4-49[_Unicode.org_]
19191921
é mais fácil de ler, bem como o https://fpy.li/4-50["NFC FAQ"] (EN) de
19201922
Mark Davis--autor de vários algoritmos do Unicode e presidente do Unicode Consortium quando essa seção foi escrita.
19211923

capitulos/cap05.adoc

Lines changed: 14 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -239,7 +239,7 @@ contendo as dicas de tipo dos campos.
239239
Entretanto, ler `+__annotations__+` diretamente não é recomendado.
240240
Em vez disso, a melhor prática recomendada para obter tal informação é chamar
241241
https://fpy.li/3p[`inspect.get_annotations(MyClass)`] (a partir de Python 3.10—EN) ou
242-
pass:[<a href="https://fpy.li/3z"><code>typing.&#x200b;get_&#x200b;type_&#x200b;hints(MyClass)</code></a>]
242+
https://fpy.li/3z[`typing.get_type_hints(MyClass)`]
243243
(Python 3.5 a 3.9).
244244
Isso porque tais funções fornecem serviços adicionais,
245245
como a resolução de referências futuras nas dicas de tipo.
@@ -776,7 +776,7 @@ com um descritor e um valor default de `1.1`.
776776
<3> `c` é apenas um atributo de classe comum; nenhuma anotação se refere a ele.
777777

778778
Podemos então verificar o `+__annotations__+`, o `+__doc__+`,
779-
e os atributos `a`, `b`, `c` no pass:[<code>Demo&#x200b;DataClass</code>]:
779+
e os atributos `a`, `b`, `c` em `DemoDataClass`:
780780

781781
[source, pycon]
782782
----
@@ -1332,8 +1332,8 @@ id="codesmells05"))) de você implementar uma classe de dados escrevendo todo o
13321332
aproveitando as facilidades oferecidas por alguma das fábricas de classes descritas nesse capítulo,
13331333
fique alerta: isso pode sinalizar um problema em seu design.
13341334

1335-
No pass:[<a href="https://fpy.li/42" class="orm:hideurl"><em>Refactoring:
1336-
Improving the Design of Existing Code</em> (<em>Refatorando: Melhorando o Design de Código Existente</em>), 2nd ed.</a>]
1335+
No livro
1336+
https://fpy.li/42[_Refactoring: Improving the Design of Existing Code, 2nd ed._]
13371337
(Addison-Wesley), Martin Fowler e Kent Beck apresentam um catálogo de
13381338
"_cheiros no código_"footnote:[NT: _Code smell_ em geral não é traduzido na literatura em
13391339
português—uma tradução quase literal seria "fedor no código".
@@ -1716,7 +1716,8 @@ Entretanto, algumas seções informativas da
17161716
https://fpy.li/pep557[PEP 557] não foram copiadas, incluindo
17171717
https://fpy.li/5-18["Why not just use namedtuple?" (_Por que simplesmente não usar namedtuple?_)],
17181718
https://fpy.li/5-19["Why not just use typing.NamedTuple?" (_Por que simplesmente não usar typing.NamedTuple?_)],
1719-
e a seção https://fpy.li/5-20["Rationale" (_Justificativa_)], que termina com a seguinte _Q&A_:
1719+
e a seção
1720+
https://fpy.li/5-20["Rationale" (_Justificativa_)], que termina com a seguinte _Q&A_:
17201721

17211722
[quote, Eric V. Smith, PEP 557 "Justificativa"]
17221723
____
@@ -1727,14 +1728,15 @@ Quando for exigida validação de tipo além daquela oferecida
17271728
pelas PEPs 484 e 526, ou quando for exigida validação ou conversão de valores.
17281729
____
17291730

1730-
Em pass:[<a href="https://fpy.li/5-21" class="orm:hideurl"><em>RealPython.com</em></a>],
1731-
Geir Arne Hjelle escreveu um
1732-
https://fpy.li/5-22["Ultimate guide to data classes in Python 3.7" (_O guia definitivo das classes de dados no Python 3.7_)]
1733-
(EN) muito completo.
1731+
Em
1732+
https://fpy.li/5-21[_RealPython.com_],
1733+
Geir Arne Hjelle escreveu
1734+
https://fpy.li/5-22[_Ultimate guide to data classes in Python 3.7_)]
1735+
(EN) guia bem completo.
17341736

17351737
Na PyCon US 2018, Raymond Hettinger apresentou
1736-
https://fpy.li/5-23["Dataclasses: The code generator to end all code generators" (video)
1737-
(_Dataclasses: O gerador de código para acabar com todos os geradores de código_)] (EN).
1738+
https://fpy.li/5-23["Dataclasses: The code generator to end all code generators"]
1739+
(EN, video).
17381740

17391741
Para mais recursos e funcionalidade avançada, incluindo validação, o
17401742
https://fpy.li/5-24[projeto _attrs_] (EN),
@@ -1779,7 +1781,7 @@ https://fpy.li/5-29[data class code smell (_classe de dados como cheiro no códi
17791781
17801782
O((("data class builders", "Soapbox discussion")))((("Soapbox sidebars", "@dataclass")))
17811783
verbete para https://fpy.li/5-30["Guido"] no
1782-
pass:[<a href="https://fpy.li/5-31" class="orm:hideurl">"The Jargon File"</a>] (EN)
1784+
https://fpy.li/5-31["The Jargon File"] (EN)
17831785
é sobre Guido van Rossum.
17841786
Entre outras coisa, ele diz:
17851787

capitulos/cap07.adoc

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,7 @@ Ali criamos uma função, a chamamos, lemos seu atributo
7070
`+__doc__+` e verificamos que o próprio objeto função é uma instância da classe `function`.
7171

7272
[[func_object_demo]]
73-
.Cria e testa uma função, e então lê seu pass:[<code>&#x5f;&#x5f;doc&#x5f;&#x5f;</code>] e verifica seu tipo
73+
.Cria e testa uma função, e então lê seu `+__doc__+` e verifica seu tipo
7474
====
7575
[source, pycon]
7676
----
@@ -94,7 +94,7 @@ O atributo `+__doc__+` é usado para gerar o texto de ajuda de um objeto.
9494
No console de Python, a instrução `help(factorial)` mostrará uma tela como a <<factorial_help>>.
9595

9696
[[factorial_help]]
97-
.Tela de ajuda para `factorial`; o texto é criado a partir do atributo pass:[<code>&#x5f;&#x5f;doc&#x5f;&#x5f;</code>] da função.
97+
.Tela de ajuda para `factorial`; o texto é criado a partir do atributo `+__doc__+` da função.
9898
image::images/flpy_0701.png[Tela de ajuda da função factorial]
9999

100100
O <<func_object_demo2>> mostra a natureza de "primeira classe" de um objeto função.
@@ -821,7 +821,10 @@ O <<ch_design_patterns>> mostra como as funções de primeira classe podem simpl
821821

822822
Em _A Referência da Linguagem Python_, a seção https://docs.python.org/pt-br/3/reference/datamodel.html#the-standard-type-hierarchy["3.2. A hierarquia de tipos padrão"] mostra os noves tipos invocáveis, juntamente com todos os outros tipos embutidos.
823823

824-
O capítulo 7 do pass:[<em><a class="orm:hideurl" href="https://fpy.li/pycook3">Python Cookbook</a></em>] (EN), 3ª ed. (O'Reilly), de David Beazley e Brian K. Jones, é um excelente complemento a esse capítulo, bem como ao <<ch_closure_decorator>>, tratando basicamente dos mesmos conceitos, mas com uma abordagem diferente.
824+
O capítulo 7 do
825+
https://fpy.li/pycook3[_Python Cookbook_] (EN), 3ª ed. (O'Reilly), de David Beazley e Brian K. Jones,
826+
é um excelente complemento a esse capítulo, bem como ao <<ch_closure_decorator>>,
827+
tratando basicamente dos mesmos conceitos com uma abordagem diferente.
825828

826829
Veja a https://fpy.li/pep3102[PEP 3102--Keyword-Only Arguments (_Argumentos somente nomeados_)] (EN) se quiser saber a justificativa e casos de uso desse recurso.
827830

0 commit comments

Comments
 (0)