On Nov 29, 2011, at 11:18 PM, Dirk Makowski wrote: > I see. Thanks for the explanation. I totally forgot to read the dialect > specific docs... ;) > > Maybe it would be nice to have the general docs point out that specialities > for a certain subject like encodings are also handled by some dialects. E.g. > for create_engine(): "Some dialects may have additional parameters concerning > the client encoding. Please see..."
the point is there just more generically and not prominently enough, near that particular section: **kwargs takes a wide variety of options which are routed towards their appropriate components. Arguments may be specific to the Engine, the underlying Dialect, as well as the Pool. Specific dialects also accept keyword arguments that are unique to that dialect. Here, we describe the parameters that are common to most create_engine() usage. For "encoding" it should be mentioned and it's also unfortunate that the Unicode doclink is broken there. The best description of the mechanism is then under the convert_unicode flag under the String type: http://www.sqlalchemy.org/docs/core/types.html?highlight=unicode#sqlalchemy.types.String.__init__ ...but even there there's broken formatting...ugh. But perhaps cleaning up that text and each of these points need to filter down to "convert_unicode", since that's really the main place "encoding" has any relevance. Here's the new section (do a shift-reload): http://www.sqlalchemy.org/docs/dialects/postgresql.html#unicode > > -- Dirk > > -- > You received this message because you are subscribed to the Google Groups > "sqlalchemy" group. > To view this discussion on the web visit > https://groups.google.com/d/msg/sqlalchemy/-/pD17Lb4TaFsJ. > To post to this group, send email to sqlalchemy@googlegroups.com. > To unsubscribe from this group, send email to > sqlalchemy+unsubscr...@googlegroups.com. > For more options, visit this group at > http://groups.google.com/group/sqlalchemy?hl=en. -- You received this message because you are subscribed to the Google Groups "sqlalchemy" group. To post to this group, send email to sqlalchemy@googlegroups.com. To unsubscribe from this group, send email to sqlalchemy+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/sqlalchemy?hl=en.
