Handling Forms in Ravyn

Ravyn provides a streamlined approach to handle form submissions, leveraging Python's data classes and Pydantic models for data validation. The Form class in Ravyn simplifies the process of receiving form data in your endpoints.

Accessing the Form Class

To handle form data, import the Form class from Ravyn:

from ravyn import Form

Alternatively, you can import it from the params module:

from ravyn.params import Form

Defining Form Data Structures

Ravyn allows you to define the structure of your form data using various Python constructs:

1. Using a Dictionary

Handle form data as a standard Python dictionary:

from typing import Dict
from ravyn import Ravyn, Form, Gateway, post


@post("/create")
async def create_user(data: Dict[str, str] = Form()) -> Dict[str, str]:
    """
    Creates a user in the system and returns the received data.
    """
    return data


app = Ravyn(routes=[Gateway(handler=create_user)])

2. Using a Dataclass

Utilize Python's dataclass for form data:

from dataclasses import dataclass
from ravyn import Ravyn, Form, Gateway, post


@dataclass
class User:
    name: str
    email: str


@post("/create")
async def create_user(data: User = Form()) -> User:
    """
    Creates a user in the system and returns the received data.
    """
    return data


app = Ravyn(routes=[Gateway(handler=create_user)])

3. Using a Pydantic Dataclass

Combine Pydantic's data validation with form handling:

from pydantic.dataclasses import dataclass
from ravyn import Ravyn, Form, Gateway, post


@dataclass
class User:
    name: str
    email: str


@post("/create")
async def create_user(data: User = Form()) -> User:
    """
    Creates a user in the system and returns the received data.
    """
    return data


app = Ravyn(routes=[Gateway(handler=create_user)])

4. Using a Pydantic Model

Leverage Pydantic models for advanced data validation:

from pydantic import BaseModel
from ravyn import Ravyn, Form, Gateway, post


class User(BaseModel):
    name: str
    email: str


@post("/create")
async def create_user(data: User = Form()) -> User:
    """
    Creates a user in the system and returns the received data.
    """
    return data


app = Ravyn(routes=[Gateway(handler=create_user)])

Handling Form Data in Requests

When sending form data in a request, ensure the payload matches the expected structure. For example, sending a JSON payload:

{
    "name": "example",
    "email": "example@ravyn.dev"
}

Ravyn will automatically parse this JSON into the appropriate data structure based on your handler's definition.

Using Form as a Non-Data Field

Ravyn's Form can also be used for fields that are neither data nor payload:

from ravyn import Ravyn, Form, Gateway, post


@post("/submit")
async def submit_form(data: Form = Form()) -> None:
    """
    Handles a form submission without specific data processing.
    """
    pass


app = Ravyn(routes=[Gateway(handler=submit_form)])

Notes

• The Form class inherits from Pydantic's Field, allowing you to specify additional parameters for data validation.

Important

Since Form is derived from Pydantic's Field, you can utilize various validation parameters, such as min_length, max_length, regex, and more, to enforce constraints on form fields.

---

By utilizing Ravyn's Form class, you can efficiently handle form submissions in a manner consistent with modern Python web frameworks, ensuring clean and maintainable code.