diff options
author | Mike Bayer <mike_mp@zzzcomputing.com> | 2011-11-28 13:58:57 -0500 |
---|---|---|
committer | Mike Bayer <mike_mp@zzzcomputing.com> | 2011-11-28 13:58:57 -0500 |
commit | 5d475742ee412e2c6fb261d935cf0e947c21a063 (patch) | |
tree | 6eb8329101f74842f6b50a020cb3df54e3cb421b /CHANGES | |
parent | 977f3a5bfb9c89f14e197548cccd6200ba2d8ce4 (diff) | |
download | alembic-5d475742ee412e2c6fb261d935cf0e947c21a063.tar.gz |
updates
Diffstat (limited to 'CHANGES')
-rw-r--r-- | CHANGES | 51 |
1 files changed, 31 insertions, 20 deletions
@@ -6,7 +6,10 @@ environment, but should still be considered ALPHA LEVEL SOFTWARE as of this release, particularly in that many features are expected - to be missing / unimplemented. + to be missing / unimplemented. Major API + changes are not anticipated but for the moment + nothing should be assumed. + The author asks that you *please* report all issues, missing features, workarounds etc. to the bugtracker, at @@ -15,8 +18,8 @@ - Python 3 is supported but has not yet been tested. The installer will run the 2to3 tool as needed, but there are probably some - small workarounds that will be needed to get - Py3K fully running. + workarounds that will be needed to get Py3K + fully running. - The "Pylons" and "MultiDB" environment templates have not been directly tested - these should be @@ -31,16 +34,15 @@ of default- or constraint-holding columns with SQL Server. -- MySQL has been tested which also required - blowing up a bunch of the API due to MySQL's - very silly migration syntax. +- MySQL support has also been implemented to a + basic degree, including MySQL's awkward style + of modifying columns being accommodated. - Other database environments not included among those three have *not* been tested, *at all*. This includes Firebird, Oracle, Sybase. Adding - support for these backends is *very easy*, and - many directives may work already if they conform - to standard forms. Please report all missing/ + support for these backends should be + straightforward. Please report all missing/ incorrect behaviors to the bugtracker! Patches are welcome here but are optional - please just indicate the exact format expected by the target @@ -78,8 +80,8 @@ Postgresql and SQL Server. - Modify column type, default status, nullable, is - functional and tested but not yet widely tested - in production usage. + functional and tested across PG, MSSQL, MySQL, + but not yet widely tested in production usage. - Many migrations are still outright missing, i.e. create/add sequences, etc. As a workaround, @@ -87,15 +89,24 @@ though posting of tickets for new features/missing behaviors is strongly encouraged. -- Autogenerate feature is implemented in a rudimentary - fashion. It's covered by unit and integration tests - and has had some basic testing. The feature - has *not* been used in a production setting so is likely - missing lot of desirable behaviors. The - autogenerate feature only generates "candidate" commands - which must be hand-tailored in any case, so this only - impacts the usefulness of the command, not overall - stability. Please report missing/broken features +- Autogenerate feature is implemented and has been + tested, though only a little bit in a production setting. + In particular, detection of type and server + default changes are optional and are off by default; + they can also be customized by a callable. + Both features work but can have surprises particularly + the disparity between BIT/TINYINT and boolean, + which hasn't yet been worked around, as well as + format changes performed by the database on defaults + when it reports back. When enabled, the PG dialect + will execute the two defaults to be compared to + see if they are equivalent. Other backends may + need to do the same thing. + + The autogenerate feature only generates + "candidate" commands which must be hand-tailored + in any case, so is still a useful feature and + is safe to use. Please report missing/broken features of autogenerate! This will be a great feature and will also improve SQLAlchemy's reflection services. |