cap24: revisão de estilo WIP

Author: ramalho

code/24-class-metaprog/checked/initsub/checkedlib.py

@@ -22,7 +22,8 @@
 
 # tag::MOVIE_TYPE_VALIDATION[]
 
-    >>> blockbuster = Movie(title='Avatar', year=2009, box_office='billions')
+    >>> megahit = Movie(title='Avatar', year=2009,
+    ...                     box_office='billions')
     Traceback (most recent call last):
       ...
     TypeError: 'billions' is not compatible with box_office:float
@@ -45,7 +46,7 @@
 
 Providing extra arguments to the constructor is not allowed::
 
-    >>> blockbuster = Movie(title='Avatar', year=2009, box_office=2000,
+    >>> megahit = Movie(title='Avatar', year=2009, box_office=2000,
     ...                     director='James Cameron')
     Traceback (most recent call last):
       ...
@@ -86,7 +87,8 @@ def __set__(self, instance: Any, value: Any) -> None:
                 value = self.constructor(value)  # <5>
             except (TypeError, ValueError) as e:  # <6>
                 type_name = self.constructor.__name__
-                msg = f'{value!r} is not compatible with {self.name}:{type_name}'
+                msg = (f'{value!r} is not compatible with ' +
+                       f'{self.name}:{type_name}')
                 raise TypeError(msg) from e
         instance.__dict__[self.name] = value  # <7>
 # end::CHECKED_FIELD[]
@@ -124,7 +126,8 @@ def __flag_unknown_attrs(self, *names: str) -> NoReturn:  # <5>
         plural = 's' if len(names) > 1 else ''
         extra = ', '.join(f'{name!r}' for name in names)
         cls_name = repr(self.__class__.__name__)
-        raise AttributeError(f'{cls_name} object has no attribute{plural} {extra}')
+        raise AttributeError(f'{cls_name} object has ' +
+                             f'no attribute{plural} {extra}')
 
     def _asdict(self) -> dict[str, Any]:  # <6>
         return {

code/24-class-metaprog/factories.py

@@ -29,12 +29,11 @@
 
 
 # tag::RECORD_FACTORY[]
-from typing import Union, Any
 from collections.abc import Iterable, Iterator
 
-FieldNames = Union[str, Iterable[str]]  # <1>
+FieldNames = str | Iterable[str]  # <1>
 
-def record_factory(cls_name: str, field_names: FieldNames) -> type[tuple]:  # <2>
+def record_factory(cls_name: str, field_names: FieldNames) -> type:  # <2>
 
     slots = parse_identifiers(field_names)  # <3>
 
@@ -44,7 +43,7 @@ def __init__(self, *args, **kwargs) -> None:  # <4>
         for name, value in attrs.items():
             setattr(self, name, value)
 
-    def __iter__(self) -> Iterator[Any]:  # <5>
+    def __iter__(self) -> Iterator:  # <5>
         for name in self.__slots__:
             yield getattr(self, name)
 

online/cap23.adoc

@@ -698,7 +698,7 @@ implementado como uma classe, com `+__call__+`, também precisa implementar
 `+__get__+` se quiser funcionar com métodos.
 
 A https://fpy.li/pep487[_PEP 487—Simpler customization of class creation_]
-(Customização mais simples da criação de classes)
+(Customização simplificada da criação de classes)
 introduziu o método especial `+__set_name__+` e inclui um exemplo de um
 https://fpy.li/23-7[«descritor de validação»].