Skip to main content

Hyperlinks for pydantic models

Project description

Read a blog post from the library author discussing why this library exists.

In a typical web application relationships between resources are modeled by primary and foreign keys in a database (integers, UUIDs, etc.). The most natural way to represent relationships in REST APIs is by URLs to the related resources (explained in this blog).

hrefs makes it easy to add hyperlinks between pydantic models in a declarative way. Just declare a Href field and the library will automatically convert between keys and URLs:

from hrefs import Href, BaseReferrableModel
from pydantic import BaseModel

class Book(BaseReferrableModel):
    id: int

    class Config:
        details_view = "get_book"

class Library(BaseModel):
    books: list[Href[Book]]

@app.get("/books/{id}")
def get_book(id: int) -> Book:
    return Book(id=id)

@app.get("/library")
def get_library() -> Library:
    """
    Will serialize into:
    {"books":["https://example.com/books/1","https://example.com/books/2","https://example.com/books/3"]}
    """
    return Library(books=[1,2,3])

@app.post("/library")
def post_library(library: Library):
    """
    Assuming the request contains
    {"books":["https://example.com/books/1","https://example.com/books/2","https://example.com/books/3"]}
    Will deserialize into: [1,2,3]
    """
    write_to_database([href.key for href in library.books])

hrefs was written especially with FastAPI in mind, but integrates into any application or framework using pydantic to parse and serialize models.

Check out the documentation to get started!

Installation

Install the library using pip or your favorite package management tool:

$ pip install hrefs

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hrefs-0.10.tar.gz (39.3 kB view hashes)

Uploaded Source

Built Distribution

hrefs-0.10-py3-none-any.whl (15.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page