Commit Graph

682 Commits

Author SHA1 Message Date
Mike Bayer 875487b8b7 formatting 2010-03-11 18:46:21 -05:00
Mike Bayer 9520c878b6 - emphasized query.join() in ORM tutorial as per [ticket:1708]
- cleaned up tutorial w.r.t. eagerload, added a section for contains_eager as this function
is equally important
- added better linkages in sqlalchemy.orm reference documentation, updated antiquated
docs for contains_eager(), got aliased()/AliasedClass documented as well as Sphinx will
allow us
2010-03-10 18:29:32 -05:00
Mike Bayer 969c04860f almost there, some tests failing still. 2010-03-09 13:41:43 -05:00
Mike Bayer 0bd16c1f5c un-break the copyright link that chrisw broke 2010-03-01 16:37:43 +00:00
Michael Trier 65dcc6e68a And more wonderfully crafted documentation changes to link function/method names to their appropriate definitions in the API docs. Thank you Diana Clarke. Refs #1703. 2010-03-01 02:57:47 +00:00
Michael Trier c366b7ec4f More cleanup to link function/method names in the docs to the API docs. Refs #1703. 2010-02-28 22:15:33 +00:00
Michael Trier c6b2319bcc Corrected failing doctests in the docs directory due to Changeset r6860. Fixes #1722. 2010-02-28 21:55:16 +00:00
Michael Trier 3328792ebc Corrected docs on create_engine to link to DBEngine Logging docs. Fixes #1721. 2010-02-28 17:05:20 +00:00
Michael Trier 217eab1667 More work to link in the function names to the API docs. Refs #1703. 2010-02-28 01:18:17 +00:00
Mike Bayer f60a5fbd5d - merge -r6823:6841 of branches/chrisw_mixin
- declarative now accepts mixin classes directly, as a means
to provide common functional and column-based elements on
all subclasses, as well as a means to propagate a fixed
set of __table_args__ or __mapper_args__ to subclasses.
For custom combinations of __table_args__/__mapper_args__ from
an inherited mixin to local, descriptors can now be used.
New details are all up in the Declarative documentation.
Thanks to Chris Withers for putting up with my strife
on this. [ticket:1707]
2010-02-25 23:15:39 +00:00
Mike Bayer f0d1a04271 - typos
- type classes have a lot of detail in their constructors
2010-02-23 20:15:34 +00:00
Michael Trier 81410467f4 Major cleanup work in the docs to link class names into the API docs. Fixes #1702. 2010-02-23 06:15:24 +00:00
Michael Trier 7fe2f06765 Corrected dbengine.rst file to properly render nested lists. Thank you Diana Clarke. Fixes #1700. 2010-02-22 19:42:52 +00:00
Mike Bayer 8f79b41217 fix a typo, [ticket:1662] 2010-02-22 17:24:49 +00:00
Mike Bayer 711395eff4 linking some API elements. this is a long job that I don't know how to speed up 2010-02-14 19:45:03 +00:00
Mike Bayer 71315cd136 repair all doctests 2010-02-14 19:29:18 +00:00
Mike Bayer 4e9a2307a7 - query.one() no longer applies LIMIT to the query, this to
ensure that it fully counts all object identities present
in the result, even in the case where joins may conceal
multiple identities for two or more rows.  As a bonus,
one() can now also be called with a query that issued
from_statement() to start with since it no longer modifies
the query.  [ticket:1688]
2010-02-14 19:23:35 +00:00
Mike Bayer e0b40f8844 adding more mapper sections nobody will ever see ! 2010-02-12 20:42:19 +00:00
Mike Bayer d0d5f79240 - Made sqlalchemy.sql.expressions.Executable part of public
API, used for any expression construct that can be sent to
    execute().  FunctionElement now inherits Executable so that
    it gains execution_options(), which are also propagated
    to the select() that's generated within execute().
    Executable in turn subclasses _Generative which marks
    any ClauseElement that supports the @_generative
    decorator - these may also become "public" for the benefit
    of the compiler extension at some point.
2010-02-12 19:54:49 +00:00
Lele Gaifax 8a395b0dfd Link to the maintained version of the kinterbasdb driver, fixes #1677 2010-02-09 09:12:58 +00:00
Mike Bayer acafbca090 fix up formatting, add OurSQL 2010-02-08 15:54:11 +00:00
Mike Bayer dfbb1fc148 a big, unmissable, green box describing the caveats of String() and Sequence. 2010-02-05 01:01:40 +00:00
Mike Bayer 0421668763 yikes entirely wrong option name here 2010-01-31 15:49:51 +00:00
Mike Bayer 489d5010fd - the "save-update" cascade will now cascade the pending *removed*
values from a scalar or collection attribute into the new session
during an add() operation.  This so that the flush() operation
will also delete or modify rows of those disconnected items.
2010-01-30 18:28:37 +00:00
Mike Bayer 73bfc87669 - Added a tuple_() construct, allows sets of expressions
to be compared to another set, typically with IN against
composite primary keys or similar.  Also accepts an
IN with multiple columns.   The "scalar select can
have only one column" error message is removed - will
rely upon the database to report problems with
col mismatch.
2010-01-25 21:04:50 +00:00
Mike Bayer 934d3bc164 fricking typo 2010-01-25 00:47:02 +00:00
Mike Bayer 67e7f45c59 - union(), intersect(), except() and other "compound" types
of statements have more consistent behavior w.r.t.
parenthesizing.   Each compound element embedded within
another will now be grouped with parenthesis - previously,
the first compound element in the list would not be grouped,
as SQLite doesn't like a statement to start with
parenthesis.   However, Postgresql in particular has
precedence rules regarding INTERSECT, and it is
more consistent for parenthesis to be applied equally
to all sub-elements.   So now, the workaround for SQLite
is also what the workaround for PG was previously -
when nesting compound elements, the first one usually needs
".alias().select()" called on it to wrap it inside
of a subquery.  [ticket:1665]
2010-01-25 00:35:28 +00:00
Mike Bayer fc92d14bbe - types.Binary is renamed to types.LargeBinary, it only
produces BLOB, BYTEA, or a similar "long binary" type.
New base BINARY and VARBINARY
types have been added to access these MySQL/MS-SQL specific
types in an agnostic way [ticket:1664].
2010-01-23 19:44:06 +00:00
Mike Bayer 40f8aadd58 - mega example cleanup
- added READMEs to all examples in each __init__.py and added to sphinx documentation
- added versioning example
- removed vertical/vertical.py, the dictlikes are more straightforward
2010-01-19 00:53:12 +00:00
Mike Bayer 2b1937a31e - reorganized and re-documented Oracle schema tests to assume
test user has DBA privs, and all objects can be created /dropped.
- added ORDER BY to oracle column listing
- Oracle all_tables always limits to current user if schema not given.
- views reflect - added documentation + a unit test for this.
- Table(autoload) with no bind produces an error message specific to
the fact that autoload_with should be the first option to try.
2010-01-17 20:32:45 +00:00
Mike Bayer 943259264f doc updates partially from [ticket:1651] 2010-01-17 18:00:01 +00:00
Mike Bayer 00df05061e add a doc for query.delete() 2010-01-16 21:31:07 +00:00
Mike Bayer 517ed6b7ce happy new year 2010-01-07 23:56:00 +00:00
Mike Bayer 0156f1a9a7 - rename "myconnpy" to "mysqlconnector"
- remove all bug workarounds in mysqlconnector dialect
- add mysqlconnector as one of two "official" DBAPIs for MySQL
2010-01-04 16:26:01 +00:00
Mike Bayer a2c727788e add documentation for Numeric/Float types, [ticket:1624] 2010-01-03 19:11:37 +00:00
Mike Bayer 87ff3c679c add a brief doc for custom DDL 2010-01-03 18:22:50 +00:00
Mike Bayer 52d99aaa97 - clarify ForeignKey docs, copy operation
- link all classes/functions in expressions
2010-01-02 18:20:08 +00:00
Mike Bayer 33f2e2bfbb - Column() supports a keyword argument "sqlite_autoincrement", which
applies the SQLite keyword "AUTOINCREMENT" to columns within DDL -
will prevent generation of a separate PRIMARY KEY constraint.
[ticket:1016]
- added docs
- fixed underlines in mysql.rst
2009-12-18 21:08:35 +00:00
Mike Bayer 404be6e761 - added _with_options() to Connection. not publicizing this yet.
- updated oursql driver with latest fixes using options. [ticket:1613]
- all the MySQL drivers get a shoutout in the docs
- marked tests that OurSQL has problems with (only three), passes 100% now
2009-12-18 20:41:34 +00:00
Mike Bayer 6bc016a762 documentation patch for [ticket:1354] 2009-12-09 00:00:48 +00:00
Mike Bayer 54e6dedc5f don't advocate for text() inside of select(), plain strings are interpreted more intelligently, [ticket:1374] 2009-12-08 23:17:14 +00:00
Mike Bayer 089dd19ca8 add a warning for unported dialects. considered a full blown NotImplementedError but will see if this gets the message across 2009-12-06 23:45:19 +00:00
Mike Bayer 7fe0916aec - merged r6526 from 0.5 branch + some additional formatting fixes, [ticket:1597] 2009-12-06 01:41:13 +00:00
Mike Bayer 66b7d008ee add an interesting from_statement() format 2009-11-21 20:51:16 +00:00
Mike Bayer 4f74e231ba merge r6497 of 0.5 branch 2009-11-11 03:46:45 +00:00
Mike Bayer 55a3e5e30d - subclassed Function off of new FunctionElement generic base
- removed "key" accessor of Function, Grouping - this doesn't seem to be used for anything
- various formatting
- documented the four "Element" classes in the compiler extension as per [ticket:1590]
2009-11-10 00:43:53 +00:00
Mike Bayer ba00071e74 - added a real unit test for sqlsoup
- removed doctest stuff
- redid session docs for sqlsoup
- sqlsoup stays within the transaction of a Session now, is explcitly autocommit=False by default and includes commit()/rollback() methods
- sqlsoup db.<sometable>.update() and delete() now call
query(cls).update() and delete(), respectively.
- sqlsoup now has execute() and connection(), which call upon
the Session methods of those names, ensuring that the bind is
in terms of the SqlSoup object's bind.
2009-11-09 19:41:45 +00:00
Mike Bayer aa557982fa - Added new ENUM type to the Postgresql dialect, which exists as a schema-level
construct and extends the generic Enum type.  Automatically
associates itself with tables and their parent metadata
to issue the appropriate CREATE TYPE/DROP TYPE
commands as needed, supports unicode labels, supports
reflection.  [ticket:1511]

- MySQL ENUM now subclasses the new generic Enum type, and also handles
unicode values implicitly, if the given labelnames are unicode
objects.

- Added a new Enum generic type, currently supported on
Postgresql and MySQL.  Enum is a schema-aware object
to support databases which require specific DDL in
order to use enum or equivalent; in the case of PG
it handles the details of `CREATE TYPE`, and on
other databases without native enum support can
support generation of CHECK constraints.
[ticket:1109] [ticket:1511]

- types documentation updates

- some cleanup on schema/expression docs
2009-10-25 00:40:34 +00:00
Mike Bayer b16f1ca427 fix SQL output 2009-10-12 16:32:29 +00:00
Mike Bayer d6239f2262 - added "ddl" argument to the "on" callable of DDLElement [ticket:1538]
- fixed the imports in the "postgres" cleanup dialect
- renamed "schema_item" attribute/argument of DDLElement
  to "target".
2009-10-12 00:11:00 +00:00