Re: A list of open points in the documentation

On Wed, Feb 10, 2010 at 09:03:54AM +0100, Federico Di Gregorio wrote:

> > the psycopg documentation is almost finished. It can be previewed on
> > http://piro.develer.com/psycopg2-doc/

Thank you, Piro !

> > 3. DBAPI says that scroll() should raise IndexError. Psycopg raises
> > ProgrammingError instead. I'd say this is a bug, but maybe it's too
> > late to be fixed. Shall we keep it this way? Shall I point out the
> > discrepancy between dbapi and psycopg in the docs or keep it quiet?
> 
> This is surely a bug but I fear to break a lot of stuff out there fixing
> it. We should probably add a "strict dbapi" flag that if enabled makes
> psycopg to do the right thing.

+1

Probably add a log message, too, saying it should be fixed.

After a few releases the logic can be reversed: make the
"proper" behaviour the default and add a flag .relax-dbapi.
Eventually remove it.

> > 4. in order to use the tuple adapter to the IN syntax,
> > psycopg2.extensions has to be imported. Is this a bug (it has already
> > bitten me once) to be fixed or a "feature" to document?
> 
> It is a feature. Almost all extensions to the DBAPI (except ones in the
> C code) are enabled by importing psycopg2.extensions.

However, the IN syntax adapter is currently under discussion
for standard inclusion.

Karsten
-- 
GPG key ID E4071346 @ wwwkeys.pgp.net
E167 67FD A291 2BEA 73BD  4537 78B9 A9F9 E407 1346