Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Allow using custom Record class #599

Merged
merged 1 commit into from Aug 15, 2020
Merged

Allow using custom Record class #599

merged 1 commit into from Aug 15, 2020

Conversation

elprans
Copy link
Member

@elprans elprans commented Jul 19, 2020

Add the new record_class parameter to the create_pool() and
connect() functions, as well as to the cursor(), prepare(),
fetch() and fetchrow() connection methods.

This not only allows adding custom functionality to the returned
objects, but also assists with typing (see #577 for discussion).

Fixes: #40.

@elprans elprans requested a review from 1st1 July 19, 2020 17:31
@elprans elprans force-pushed the record-class branch 2 times, most recently from 7d8361b to 0715bf8 Compare July 19, 2020 19:02
*args,
prefetch=None,
timeout=None,
record_class=None
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Instead of adding record_class everywhere I'd allow passing it to the constructor. Or add a set_record_class_factory method.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is there any evidence that users want multiple different record types on one connection?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The entire impetus of this push was from #577, where the record_class is used as a TypeDict-like typehint for the result, which gets typechecked also.

I'd allow passing it to the constructor.

It is also allowed to be passed in the constructor if you want a connection-wide subclass.

asyncpg/protocol/record/recordobj.c Show resolved Hide resolved
@victoraugustolls
Copy link

@elprans is this PR ok to be merged? I'm really looking forward for this and the typings PR 😄

Add the new `record_class` parameter to the `create_pool()` and
`connect()` functions, as well as to the `cursor()`, `prepare()`,
`fetch()` and `fetchrow()` connection methods.

This not only allows adding custom functionality to the returned
objects, but also assists with typing (see #577 for discussion).

Fixes: #40.
@ponomar
Copy link

ponomar commented Jun 10, 2021

@elprans Can you provide an example how to implement custom record_class with dot-notation?
Because it's unclear from the docs. I think it would be very useful for many people. Thanks!

@CaerDarrow
Copy link

@elprans Can you provide an example how to implement custom record_class with dot-notation?
Because it's unclear from the docs. I think it would be very useful for many people. Thanks!

Not sure if this is correct but should work

    class MyRecord(Record):
        def __getattr__(self, item):
            return self.get(item)

@jparise
Copy link
Contributor

jparise commented Oct 4, 2022

#960 adds an example of this to the FAQ item.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add ability to set the Record factory on the connection
6 participants