Adicionando Field do pydantic na aula 07 e nos códigos posteriores

Author: dunossauro

aulas/07.md

@@ -535,15 +535,29 @@ Dessa forma, temos um modelo padrão de filtro e qualquer endpoint que precisar
 Uma das grandes vantagens de usar o pydantic para as querystrings é poder restringir de algumas formas os dados que podem ser passados pelo cliente. Por exemplo, embora `#!python offset: int = 0` pareça bastante confiável, temos um problema claro com o tipo `#!python int`. E se for passado um valor negativo?
 
 ```python title="fast_zero/schemas.py"
-from pydantic import ..., Field  # TODO
+from pydantic import BaseModel, ConfigDict, EmailStr, Field
 
+# ...
 
 class FilterPage(BaseModel):
-    offset: int = Field(default=0, ge=0)
-    limit: int = Field(default=100, ge=1)
+    offset: int = Field(0, ge=0)
+    limit: int = Field(100, ge=1)
 ```
 
-> Explicar as implicações do Field
+Os [`Field`s](https://docs.pydantic.dev/latest/concepts/fields/) do pydantic podem aplicar diversas validações adicionais, além dos tipos. Neste caso, `ge` significa *greater than* [maior que]. O que significa, no caso de `offset`, que o valor deve ser do tipo `#!python int` e maior ou igual a `#!python 0`.
+
+??? tip "Annotated e Pydantic"
+    Embora tenhamos usado a notação completa das anotações de tipo, como:
+	```python
+	class FilterPage(BaseModel):
+        offset: int = Field(0, ge=0)
+	```
+
+	O tipo `Annotated` também poderia ser usado aqui:
+	```python
+	class FilterPage(BaseModel):
+        offset: Annotated[int, Field(0, ge=0)]
+	```
 
 ### Implementação de querystrings via Pydantic
 

codigo_das_aulas/07/fast_zero/schemas.py

@@ -1,4 +1,4 @@
-from pydantic import BaseModel, ConfigDict, EmailStr
+from pydantic import BaseModel, ConfigDict, EmailStr, Field
 
 
 class Message(BaseModel):
@@ -28,5 +28,5 @@ class Token(BaseModel):
 
 
 class FilterPage(BaseModel):
-    offset: int = 0
-    limit: int = 100
+    offset: int = Field(0, ge=0)
+    limit: int = Field(100, ge=1)

codigo_das_aulas/08/fast_zero/schemas.py

@@ -1,4 +1,4 @@
-from pydantic import BaseModel, ConfigDict, EmailStr
+from pydantic import BaseModel, ConfigDict, EmailStr, Field
 
 
 class Message(BaseModel):
@@ -28,5 +28,5 @@ class Token(BaseModel):
 
 
 class FilterPage(BaseModel):
-    offset: int = 0
-    limit: int = 100
+    offset: int = Field(0, ge=0)
+    limit: int = Field(100, ge=1)

codigo_das_aulas/09/fast_zero/schemas.py

@@ -1,4 +1,4 @@
-from pydantic import BaseModel, ConfigDict, EmailStr
+from pydantic import BaseModel, ConfigDict, EmailStr, Field
 
 
 class Message(BaseModel):
@@ -28,5 +28,5 @@ class Token(BaseModel):
 
 
 class FilterPage(BaseModel):
-    offset: int = 0
-    limit: int = 100
+    offset: int = Field(0, ge=0)
+    limit: int = Field(100, ge=1)

codigo_das_aulas/10/fast_zero/schemas.py

@@ -1,4 +1,4 @@
-from pydantic import BaseModel, ConfigDict, EmailStr
+from pydantic import BaseModel, ConfigDict, EmailStr, Field
 
 from fast_zero.models import TodoState
 
@@ -30,8 +30,8 @@ class Token(BaseModel):
 
 
 class FilterPage(BaseModel):
-    offset: int = 0
-    limit: int = 100
+    offset: int = Field(0, ge=0)
+    limit: int = Field(100, ge=1)
 
 
 class TodoSchema(BaseModel):

codigo_das_aulas/11/fast_zero/schemas.py

@@ -1,4 +1,4 @@
-from pydantic import BaseModel, ConfigDict, EmailStr
+from pydantic import BaseModel, ConfigDict, EmailStr, Field
 
 from fast_zero.models import TodoState
 
@@ -30,8 +30,8 @@ class Token(BaseModel):
 
 
 class FilterPage(BaseModel):
-    offset: int = 0
-    limit: int = 100
+    offset: int = Field(0, ge=0)
+    limit: int = Field(100, ge=1)
 
 
 class TodoSchema(BaseModel):

codigo_das_aulas/12/fast_zero/schemas.py

@@ -1,4 +1,4 @@
-from pydantic import BaseModel, ConfigDict, EmailStr
+from pydantic import BaseModel, ConfigDict, EmailStr, Field
 
 from fast_zero.models import TodoState
 
@@ -30,8 +30,8 @@ class Token(BaseModel):
 
 
 class FilterPage(BaseModel):
-    offset: int = 0
-    limit: int = 100
+    offset: int = Field(0, ge=0)
+    limit: int = Field(100, ge=1)
 
 
 class TodoSchema(BaseModel):

codigo_das_aulas/13/fast_zero/schemas.py

@@ -1,4 +1,4 @@
-from pydantic import BaseModel, ConfigDict, EmailStr
+from pydantic import BaseModel, ConfigDict, EmailStr, Field
 
 from fast_zero.models import TodoState
 
@@ -30,8 +30,8 @@ class Token(BaseModel):
 
 
 class FilterPage(BaseModel):
-    offset: int = 0
-    limit: int = 100
+    offset: int = Field(0, ge=0)
+    limit: int = Field(100, ge=1)
 
 
 class TodoSchema(BaseModel):