Author: cito
Date: Tue Jan 12 11:57:21 2016
New Revision: 727
Log:
Improve docstring
Modified:
branches/4.x/pg.py
trunk/pg.py
Modified: branches/4.x/pg.py
==============================================================================
--- branches/4.x/pg.py Tue Jan 12 11:33:00 2016 (r726)
+++ branches/4.x/pg.py Tue Jan 12 11:57:21 2016 (r727)
@@ -613,9 +613,9 @@
def get_relations(self, kinds=None):
"""Get list of relations in connected database of specified kinds.
- If kinds is None or empty, all kinds of relations are returned.
- Otherwise kinds can be a string or sequence of type letters
- specifying which kind of relations you want to list.
+ If kinds is None or empty, all kinds of relations are returned.
+ Otherwise kinds can be a string or sequence of type letters
+ specifying which kind of relations you want to list.
"""
where = kinds and " AND r.relkind IN (%s)" % ','.join(
@@ -783,9 +783,12 @@
def insert(self, cl, d=None, **kw):
"""Insert a row into a database table.
- This method inserts a row into a table. If a dictionary is
- supplied it starts with that. Otherwise it uses a blank dictionary.
- Either way the dictionary is updated from the keywords.
+ This method inserts a row into a table. The name of the table must
+ be passed as the first parameter. The other parameters are used for
+ providing the data of the row that shall be inserted into the table.
+ If a dictionary is supplied as the second parameter, it starts with
+ that. Otherwise it uses a blank dictionary. Either way the dictionary
+ is updated from the keywords.
The dictionary is then, if possible, reloaded with the values actually
inserted in order to pick up values modified by rules, triggers, etc.
Modified: trunk/pg.py
==============================================================================
--- trunk/pg.py Tue Jan 12 11:33:00 2016 (r726)
+++ trunk/pg.py Tue Jan 12 11:57:21 2016 (r727)
@@ -617,9 +617,9 @@
def get_relations(self, kinds=None):
"""Get list of relations in connected database of specified kinds.
- If kinds is None or empty, all kinds of relations are returned.
- Otherwise kinds can be a string or sequence of type letters
- specifying which kind of relations you want to list.
+ If kinds is None or empty, all kinds of relations are returned.
+ Otherwise kinds can be a string or sequence of type letters
+ specifying which kind of relations you want to list.
"""
where = " AND r.relkind IN (%s)" % ','.join(
@@ -793,9 +793,12 @@
def insert(self, cl, d=None, **kw):
"""Insert a row into a database table.
- This method inserts a row into a table. If a dictionary is
- supplied it starts with that. Otherwise it uses a blank dictionary.
- Either way the dictionary is updated from the keywords.
+ This method inserts a row into a table. The name of the table must
+ be passed as the first parameter. The other parameters are used for
+ providing the data of the row that shall be inserted into the table.
+ If a dictionary is supplied as the second parameter, it starts with
+ that. Otherwise it uses a blank dictionary. Either way the dictionary
+ is updated from the keywords.
The dictionary is then, if possible, reloaded with the values actually
inserted in order to pick up values modified by rules, triggers, etc.
_______________________________________________
PyGreSQL mailing list
[email protected]
https://mail.vex.net/mailman/listinfo.cgi/pygresql
