README.rst 1.54 KB
Newer Older
1
SQLAlchemy Migrate
Josip Delic's avatar
Josip Delic committed
2 3 4 5 6
==================

Fork from http://code.google.com/p/sqlalchemy-migrate/ to get it working with
SQLAlchemy 0.8.

Jan Dittberner's avatar
Jan Dittberner committed
7 8
Inspired by Ruby on Rails' migrations, Migrate provides a way to deal with
database schema changes in `SQLAlchemy <http://sqlalchemy.org>`_ projects.
9

Jan Dittberner's avatar
Jan Dittberner committed
10 11 12
Migrate extends SQLAlchemy to have database changeset handling. It provides a
database change repository mechanism which can be used from the command line as
well as from inside python code.
13 14

Help
Josip Delic's avatar
Josip Delic committed
15
----
16

17 18
Sphinx documentation is available at the project page `readthedocs.org
<https://sqlalchemy-migrate.readthedocs.org/>`_.
19

20
Users and developers can be found at #openstack-dev on Freenode IRC
Jan Dittberner's avatar
Jan Dittberner committed
21 22
network and at the public users mailing list `migrate-users
<http://groups.google.com/group/migrate-users>`_.
23

Jan Dittberner's avatar
Jan Dittberner committed
24
New releases and major changes are announced at the public announce mailing
25 26
list `openstack-dev
<http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev>`_
Jan Dittberner's avatar
Jan Dittberner committed
27 28
and at the Python package index `sqlalchemy-migrate
<http://pypi.python.org/pypi/sqlalchemy-migrate>`_.
29

30 31
Homepage is located at `stackforge
<http://github.com/stackforge/sqlalchemy-migrate/>`_
32

33
You can also clone a current `development version
34
<http://github.com/stackforge/sqlalchemy-migrate>`_
35 36

Tests and Bugs
Josip Delic's avatar
Josip Delic committed
37
--------------
38 39

To run automated tests:
40

41 42 43
* install tox: ``pip install -U tox``
* run tox: ``tox``
* to test only a specific Python version: ``tox -e py27`` (Python 2.7)
44

Jan Dittberner's avatar
Jan Dittberner committed
45
Please report any issues with sqlalchemy-migrate to the issue tracker at
46 47
`Launchpad issues
<https://bugs.launchpad.net/sqlalchemy-migrate>`_