[SQL-CVS] r4302 - SQLObject/trunk/docs
SQLObject is a Python ORM.
Brought to you by:
ianbicking,
phd
From: <sub...@co...> - 2010-12-15 22:49:00
|
Author: phd Date: Wed Dec 15 15:48:51 2010 New Revision: 4302 Log: Grammar corrections by Daniel Fetchinson. Modified: SQLObject/trunk/docs/Authors.txt SQLObject/trunk/docs/SQLBuilder.txt Modified: SQLObject/trunk/docs/Authors.txt ============================================================================== --- SQLObject/trunk/docs/Authors.txt Wed Dec 15 14:06:08 2010 (r4301) +++ SQLObject/trunk/docs/Authors.txt Wed Dec 15 15:48:51 2010 (r4302) @@ -23,6 +23,7 @@ * Diez B. Roggisch <deets at web.de> * Christopher Singley <csingley at gmail.com> * David Keeney <dkeeney at rdbhost.com> +* Daniel Fetchinson <fet...@go...> * Oleg Broytman <ph...@ph...> .. image:: http://sflogo.sourceforge.net/sflogo.php?group_id=74338&type=10 Modified: SQLObject/trunk/docs/SQLBuilder.txt ============================================================================== --- SQLObject/trunk/docs/SQLBuilder.txt Wed Dec 15 14:06:08 2010 (r4301) +++ SQLObject/trunk/docs/SQLBuilder.txt Wed Dec 15 15:48:51 2010 (r4302) @@ -16,9 +16,9 @@ expressions build SQL expressions -- so long as you start with a Magic Object that knows how to fake it. -With SQLObject, you get a Magic Object by access the ``q`` attribute +With SQLObject, you get a Magic Object by accessing the ``q`` attribute of a table class -- this gives you an object that represents the -field. Maybe explanations aren't as good. Here's some examples:: +field. All of this is probably easier to grasp in an example:: >>> from sqlobject.sqlbuilder import * >>> person = table.person @@ -52,13 +52,13 @@ also work -- I find these easier to work with. ``AND`` and ``OR`` can take any number of arguments. -You can also use ``.startswith()`` and ``.endswith()`` on a SQL +You can also use ``.startswith()`` and ``.endswith()`` on an SQL expression -- these will translate to appropriate ``LIKE`` statements -(but all ``%`` quoting is handled for you, so you can ignore that -implementation detail). There is also a ``LIKE`` function, where you +and all ``%`` quoting is handled for you, so you can ignore that +implementation detail. There is also a ``LIKE`` function, where you can pass your string, with ``%`` for the wildcard, as usual. -If you want to access a SQL function, use the ``func`` variable, +If you want to access an SQL function, use the ``func`` variable, like:: >> person.created < func.NOW() @@ -71,7 +71,7 @@ SQLBuilder implements objects that execute SQL statements. SQLObject uses them internally in its `higher-level API`_, but users can use this -mid-level API to executes SQL queries that aren't supported by the +mid-level API to execute SQL queries that are not supported by the high-level API. To use these objects first construct an instance of a statement object, then ask the connection to convert the instance to an SQL query and finally ask the connection to execute the query and return |