blob: 3270f5ce32a7cd1d56b67f8f18a90667a5276ac1 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
|
============
Front Matter
============
Information about the Alembic project.
Project Homepage
================
Alembic is hosted on `Bitbucket <http://bitbucket.org>`_ - the lead project
page is at https://bitbucket.org/zzzeek/alembic. Source code is tracked here
using `Git <http://git-scm.com/>`_.
.. versionchanged:: 0.6
The source repository was moved from Mercurial to Git.
Releases and project status are available on Pypi at
http://pypi.python.org/pypi/alembic.
The most recent published version of this documentation should be at
http://alembic.readthedocs.org/.
Project Status
==============
Alembic is currently in beta status and is expected to be fairly
stable. Users should take care to report bugs and missing features
(see :ref:`bugs`) on an as-needed
basis. It should be expected that the development version may be required
for proper implementation of recently repaired issues in between releases;
the latest master is always available at https://bitbucket.org/zzzeek/alembic/get/master.tar.gz.
.. _installation:
Installation
============
Install released versions of Alembic from the Python package index with `pip <http://pypi.python.org/pypi/pip>`_ or a similar tool::
pip install alembic
Installation via source distribution is via the ``setup.py`` script::
python setup.py install
The install will add the ``alembic`` command to the environment. All operations with Alembic
then proceed through the usage of this command.
Dependencies
------------
Alembic's install process will ensure that `SQLAlchemy <http://www.sqlalchemy.org>`_
is installed, in addition to other dependencies. Alembic will work with
SQLAlchemy as of version **0.7.3**. The latest version of SQLAlchemy within
the **0.7**, **0.8**, or more recent series is strongly recommended.
Alembic supports Python versions 2.6 and above.
.. versionchanged:: 0.5.0
Support for SQLAlchemy 0.6 has been dropped.
.. versionchanged:: 0.6.0
Now supporting Python 2.6 and above.
Community
=========
Alembic is developed by `Mike Bayer <http://techspot.zzzeek.org>`_, and is
loosely associated with the `SQLAlchemy <http://www.sqlalchemy.org/>`_ and `Pylons <http://www.pylonsproject.org>`_
projects.
User issues, discussion of potential bugs and features should be posted
to the Alembic Google Group at `sqlalchemy-alembic <https://groups.google.com/group/sqlalchemy-alembic>`_.
.. _bugs:
Bugs
====
Bugs and feature enhancements to Alembic should be reported on the `Bitbucket
issue tracker <https://bitbucket.org/zzzeek/alembic/issues?status=new&status=open>`_.
|
