mirror of
https://github.com/PyMySQL/mysqlclient.git
synced 2025-08-15 02:54:29 +08:00
Remove INSTALL.rst
It is not maintenanced.
This commit is contained in:
Inada Naoki
146
INSTALL.rst
146
INSTALL.rst
@ -1,146 +0,0 @@
|
|||||||
====================
|
|
||||||
MySQLdb Installation
|
|
||||||
====================
|
|
||||||
|
|
||||||
.. contents::
|
|
||||||
..
|
|
||||||
|
|
||||||
Prerequisites
|
|
||||||
-------------
|
|
||||||
|
|
||||||
+ Python 3.5 or higher
|
|
||||||
|
|
||||||
+ setuptools
|
|
||||||
|
|
||||||
* https://pypi.org/project/setuptools/
|
|
||||||
|
|
||||||
+ MySQL 5.5 or higher
|
|
||||||
|
|
||||||
* https://www.mysql.com/downloads/
|
|
||||||
|
|
||||||
* MySQL 5.1 may work, but not supported.
|
|
||||||
|
|
||||||
+ C compiler
|
|
||||||
|
|
||||||
* Most free software-based systems already have this, usually gcc.
|
|
||||||
|
|
||||||
* Most commercial UNIX platforms also come with a C compiler, or
|
|
||||||
you can also use gcc.
|
|
||||||
|
|
||||||
* If you have some Windows flavor, you should use Windows SDK or
|
|
||||||
Visual C++.
|
|
||||||
|
|
||||||
|
|
||||||
Building and installing
|
|
||||||
-----------------------
|
|
||||||
|
|
||||||
The setup.py script uses mysql_config to find all compiler and linker
|
|
||||||
options, and should work as is on any POSIX-like platform, so long as
|
|
||||||
mysql_config is in your path.
|
|
||||||
|
|
||||||
Depending on which version of MySQL you have, you may have the option
|
|
||||||
of using three different client libraries. To select the client library,
|
|
||||||
edit the [options] section of site.cfg:
|
|
||||||
|
|
||||||
static
|
|
||||||
if True, try to link against a static library; otherwise link
|
|
||||||
against dynamic libraries (default).
|
|
||||||
This option doesn't work for MySQL>5.6 since libmysqlclient
|
|
||||||
requires libstdc++. If you want to use, add `-lstdc++` to
|
|
||||||
mysql_config manually.
|
|
||||||
|
|
||||||
If `<mysql prefix>/lib` is not added to `/etc/ld.so.conf`, `import _mysql`
|
|
||||||
doesn't work. To fix this, (1) set `LD_LIBRARY_PATH`, or (2) add
|
|
||||||
`-Wl,-rpath,<mysql prefix>/lib` to ldflags in your mysql_config.
|
|
||||||
|
|
||||||
Finally, putting it together::
|
|
||||||
|
|
||||||
$ tar xz mysqlclient-1.3.6.tar.gz
|
|
||||||
$ cd mysqlclient-1.3.6
|
|
||||||
$ # edit site.cfg if necessary
|
|
||||||
$ python setup.py build
|
|
||||||
$ sudo python setup.py install # or su first
|
|
||||||
|
|
||||||
|
|
||||||
Windows
|
|
||||||
.......
|
|
||||||
|
|
||||||
I don't do Windows. However if someone provides me with a package for
|
|
||||||
Windows, I'll make it available. Don't ask me for help with Windows
|
|
||||||
because I can't help you.
|
|
||||||
|
|
||||||
Generally, though, running setup.py is similar to above::
|
|
||||||
|
|
||||||
C:\...> python setup.py install
|
|
||||||
C:\...> python setup.py bdist_wininst
|
|
||||||
|
|
||||||
The latter example should build a Windows installer package, if you
|
|
||||||
have the correct tools. In any event, you *must* have a C compiler.
|
|
||||||
Additionally, you have to set an environment variable (mysqlroot)
|
|
||||||
which is the path to your MySQL installation. In theory, it would be
|
|
||||||
possible to get this information out of the registry, but like I said,
|
|
||||||
I don't do Windows, but I'll accept a patch that does this.
|
|
||||||
|
|
||||||
On Windows, you will definitely have to edit site.cfg since there is
|
|
||||||
no mysql_config in the MySQL package.
|
|
||||||
|
|
||||||
|
|
||||||
Binary Packages
|
|
||||||
---------------
|
|
||||||
|
|
||||||
I don't plan to make binary packages any more. However, if someone
|
|
||||||
contributes one, I will make it available. Several OS vendors have
|
|
||||||
their own packages available.
|
|
||||||
|
|
||||||
|
|
||||||
Red Hat Linux
|
|
||||||
.............
|
|
||||||
|
|
||||||
MySQL-python is pre-packaged in Red Hat Linux 7.x and newer. This
|
|
||||||
includes Fedora Core and Red Hat Enterprise Linux.
|
|
||||||
|
|
||||||
|
|
||||||
Debian GNU/Linux
|
|
||||||
................
|
|
||||||
|
|
||||||
Packaged as `python-mysqldb`_::
|
|
||||||
|
|
||||||
# apt-get install python-mysqldb
|
|
||||||
|
|
||||||
Or use Synaptic.
|
|
||||||
|
|
||||||
.. _`python-mysqldb`: http://packages.debian.org/python-mysqldb
|
|
||||||
|
|
||||||
|
|
||||||
Ubuntu
|
|
||||||
......
|
|
||||||
|
|
||||||
Same as with Debian.
|
|
||||||
|
|
||||||
|
|
||||||
Gentoo Linux
|
|
||||||
............
|
|
||||||
|
|
||||||
Packaged as `mysql-python`_. ::
|
|
||||||
|
|
||||||
# emerge sync
|
|
||||||
# emerge mysql-python
|
|
||||||
# emerge zmysqlda # if you use Zope
|
|
||||||
|
|
||||||
.. _`mysql-python`: https://packages.gentoo.org/packages/search?q=mysql-python
|
|
||||||
|
|
||||||
|
|
||||||
BSD
|
|
||||||
...
|
|
||||||
|
|
||||||
MySQL-python is a ported package in FreeBSD, NetBSD, and OpenBSD,
|
|
||||||
although the name may vary to match OS conventions.
|
|
||||||
|
|
||||||
|
|
||||||
License
|
|
||||||
-------
|
|
||||||
|
|
||||||
GPL or the original license based on Python 1.5.2's license.
|
|
||||||
|
|
||||||
|
|
||||||
:Author: Andy Dustman <andy@dustman.net>
|
|
||||||
@ -3,7 +3,6 @@ recursive-include tests *.py
|
|||||||
include doc/conf.py
|
include doc/conf.py
|
||||||
include MANIFEST.in
|
include MANIFEST.in
|
||||||
include HISTORY.rst
|
include HISTORY.rst
|
||||||
include INSTALL.rst
|
|
||||||
include README.md
|
include README.md
|
||||||
include LICENSE
|
include LICENSE
|
||||||
include metadata.cfg
|
include metadata.cfg
|
||||||
|
|||||||
Reference in New Issue
Block a user