mirror of
https://github.com/sqlalchemy/sqlalchemy.git
synced 2026-06-03 22:35:46 -04:00
Mike Bayer
4e9a2307a7
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]
SQLAlchemy
++++++++++
The Python SQL Toolkit and Object Relational Mapper
Requirements
------------
SQLAlchemy requires Python 2.4 or higher. One or more DB-API implementations
are also required for database access. See docs/intro.html for more
information on supported DB-API implementations.
Python 3 Compatibility
----------------------
Please see README.py3k for Python 3 installation and testing instructions.
Installation Tools
------------------
Installation is supported with standard Python distutils, as well
as with setuptools or Distribute. Distribute is recommended.
Distribute can be installed using the provided "distribute_setup.py"
script. The original setuptools may be installed using the
"ez_setup.py" script if preferred, or simply do nothing and distutils
will be used.
Installing
----------
To install::
python setup.py install
To use without installation, include the ``lib`` directory in your Python
path.
Installing the C extension
--------------------------
Edit "setup.py" and set ``BUILD_CEXTENSIONS`` to ``True``, then install it as
above. If you want only to build the extension and not install it, you can do
so with::
python setup.py build
Running Tests
-------------
Please see README.unittests for full instructions on running unit tests.
Package Contents
----------------
doc/
HTML documentation, including tutorials and API reference. Point
a browser to the "index.html" to start.
examples/
Fully commented and executable implementations for a variety of tasks.
lib/
SQLAlchemy.
test/
Unit tests for SQLAlchemy.
Help
----
Mailing lists, wiki, and more are available on-line at
http://www.sqlalchemy.org.
License
-------
SQLAlchemy is distributed under the `MIT license
<http://www.opensource.org/licenses/mit-license.php>`_.