cap23: revisão de estilo pronta

Author: ramalho

code/23-descriptor/descriptorkinds.py

@@ -138,9 +138,7 @@
 
 """
 
-# tag::DESCR_KINDS[]
-
-### auxiliary functions for display only ###
+# tag::DESCR_KINDS_AUX[]
 
 def cls_name(obj_or_cls):
     cls = type(obj_or_cls)
@@ -161,8 +159,9 @@ def print_args(name, *args):
     pseudo_args = ', '.join(display(x) for x in args)
     print(f'-> {cls_name(args[0])}.__{name}__({pseudo_args})')
 
+# end::DESCR_KINDS_AUX[]
 
-### essential classes for this example ###
+# tag::DESCR_KINDS[]
 
 class Overriding:  # <1>
     """a.k.a. data descriptor or enforced descriptor"""

code/23-descriptor/method_is_descriptor.py

@@ -10,12 +10,12 @@
     Text('drawkcab')
     >>> type(Text.reverse), type(word.reverse)  # <4>
     (<class 'function'>, <class 'method'>)
-    >>> list(map(Text.reverse, ['repaid', (10, 20, 30), Text('stressed')]))  # <5>
-    ['diaper', (30, 20, 10), Text('desserts')]
+    >>> [Text.reverse(x) for x in ['abc', (1, 2), Text('stressed')]]  # <5>
+    ['cba', (2, 1), Text('desserts')]
     >>> Text.reverse.__get__(word)  # <6>
     <bound method Text.reverse of Text('forward')>
     >>> Text.reverse.__get__(None, Text)  # <7>
-    <function Text.reverse at 0x101244e18>
+    <function Text.reverse at 0x...>
     >>> word.reverse  # <8>
     <bound method Text.reverse of Text('forward')>
     >>> word.reverse.__self__  # <9>
@@ -33,7 +33,7 @@
 class Text(collections.UserString):
 
     def __repr__(self):
-        return 'Text({!r})'.format(self.data)
+        return f'Text({self.data!r})'
 
     def reverse(self):
         return self[::-1]

links/FPY.LI.htaccess

@@ -1478,3 +1478,6 @@ RedirectTemp /c4	https://docs.python.org/pt-br/3/library/functions.html#type
 # cap21: appended 2026-02-06
 RedirectTemp /c5	https://fastapi.tiangolo.com/pt/project-generation/
 RedirectTemp /c6	https://pypi.org/project/curio-compat/
+
+# cap22: appended 2026-02-11
+RedirectTemp /c7	https://docs.python.org/pt-br/3.10/reference/datamodel.html#implementing-descriptors

online/cap22.adoc

@@ -1585,7 +1585,7 @@ um_objeto.contagem += 1
 um_objeto.set_contagem(um_objeto.get_contagem() + 1)
 ----
 
-Algumas vezes, ao projetar uma API, me pergunto se todo método que não recebe qualquer argumento (além de `self`), devolve um valor (diferente de `None`) e é uma função pura (isto é, não tem efeitos colaterais) não deveria ser substituído por uma propriedade somente de leitura. Neste capítulo, o método `LineItem.subtotal` (no <<lineitem_class_v2prop_class>>) seria um bom candidato a se tornar uma propriedade somente para leitura. Claro, isso exclui métodos projetados para modificar o objeto, tal como `my_list.clear()`. Seria uma péssima ideia transformar isso em uma propriedade, de tal forma que o mero acesso a `my_list.clear` apagaria o conteúdo da lista!
+Algumas vezes, ao projetar uma API, me pergunto se todo método que não recebe argumentos (além de `self`) é uma função pura (isto é, devolve um valor mas não tem efeitos colaterais) não deveria ser substituído por uma propriedade somente de leitura. Neste capítulo, o método `LineItem.subtotal` (no <<lineitem_class_v2prop_class>>) seria um bom candidato a se tornar uma propriedade somente para leitura. Claro, isso exclui métodos projetados para modificar o objeto, tal como `my_list.clear()`. Seria uma péssima ideia transformar isso em uma propriedade, de tal forma que o mero acesso a `my_list.clear` apagaria o conteúdo da lista!
 
 Na biblioteca GPIO https://fpy.li/22-29[_Pingo_] (mencionada na <<missing_method>>), da qual sou co-autor, grande parte da API do usuário está baseada em propriedades. Por exemplo, para ler o valor atual de uma porta analógica, o usuário escreve `pin.value`, e definir o modo de uma porta digital é escrito `pin.mode = OUT`. Por trás da cortina, ler o valor de uma porta analógica ou definir o modo de uma porta digital pode implicar em bastante código, dependendo do driver específico da placa. Decidimos usar propriedades no Pingo porque queríamos que a API fosse confortável de usar até mesmo em ambientes interativos como um Jupyter Notebook, e achamos que `pin.mode = OUT` é mais fácil para os olhos e para os dedos que `pin.set_mode(OUT)`.