'revision_id' field is added to Document when used as response_model in FastAPI about beanie HOT 9 CLOSED

Hey!
Thank you for the issue. This is a bug - fixed in the 1.7.1. Please, update

from beanie.

I tried 1.7.1 and revision_id has been removed from the output.
However, It is still in the schema, marked as hidden, and thus also appears in the example response


Is there anything we can do about that? Because now andybody who creates an api will have to explain to the user of the api what the purpose of revision_id.

from beanie.

Should be hidden there too now. Pls check 1.7.2

from beanie.

Yes, 1.7.2 totally resolves the visibility issue in output and schema. Thanks for your efforts.

More on a sidenote:
I noticed the field can still be 'used', so it is as the code calls it "hidden". So, when beanie is used in an API (say using FastAPI) the user of the api can still use the revision_id (although, if it is later no longer supported, not complain when it is removed as it is an undocumented api feature).
When the developer of the API wants to use the revision_id in the api, it has to be "un-hiden" (at this point, I would not know how, maybe by defining the field in my model?)

It might be completely against the philosophy of beanie (sorry I have not read the code yet), but it might be worth having these kind of features controlled from a config class of some sort like you see in other frameworks.
So the developer could write something like the code below to enable the revision_id:

class Note(Document):
    
    title: str
    text: Optional[str]

    class Config:
        use_revision_id = True

The idea being, by default "revision_id" is not used (not hidden, but really not used), but can be enabled using the config class.

This also gives you an opportunity to add new features in the future, which (by default) do not break an existing api generated by beanie (by adding of removing fields) and still allow the developer to adopt new features when needed / wanted.

from beanie.

Hey.
This make sense, but implementation could be tricky, as it is a pydantic field under the hood. I'll try to not use this field if the config is turned of soon.

Also, this feature is finally released. The doc about this could be found here: https://roman-right.github.io/beanie/tutorial/revision/

from beanie.

So this issue is a bit tricky. Its being caused by FastAPIs naive method of creating its document. I had to roll my own to get a functioning output. It was pretty easy to do I can see how portable to it is and if it is something I can port. The only issue becomes we would need to pin the pydantic version because its not code that is part of the API spec that needs to get replaced. Pydantic has a pretty slow release schedule so it is not that bad to do TBH.

from beanie.

This issue is stale because it has been open 30 days with no activity.

from beanie.

This issue was closed because it has been stalled for 14 days with no activity.

from beanie.

Not sure if it's the same issue but the inherited BaseModel.json() model still includes the revision_id.

from beanie.