diff --git a/sqlalchemy_utils/__init__.py b/sqlalchemy_utils/__init__.py index 60b65ab..432cea5 100644 --- a/sqlalchemy_utils/__init__.py +++ b/sqlalchemy_utils/__init__.py @@ -119,9 +119,12 @@ def defer_except(query, columns): """ Deferred loads all columns in given query, except the ones given. + This function is very useful when working with models with myriad of + columns and you want to deferred load many columns. + >>> from sqlalchemy_utils import defer_except - >>> query = session.query(User) - >>> query = defer_except(User, [User.id, User.name]) + >>> query = session.query(Article) + >>> query = defer_except(Article, [Article.id, Article.name]) :param columns: columns not to deferred load """