.. _install:

**************
安装指南
**************

如果能访问外网，推荐使用 pip 安装。较新版本的 Python 通常自带 pip。如果你的 Python 不包含 pip，可以参考
`地址 <https://pip.pypa.io/en/stable/installing/>`_ 安装，推荐使用 `阿里云镜像 <http://mirrors.aliyun.com/help/pypi>`_
加快下载速度。

接着升级 pip 和 setuptools 的版本：

.. code-block:: sh

    pip install -U pip setuptools

此后可以安装 PyODPS：

.. code-block:: sh

    pip install pyodps

如果安装时出现 `urllib3 v2.0 only supports OpenSSL 1.1.1+` 的报错，需要先安装一个兼容旧版
OpenSSL 的 urllib3 版本

.. code-block:: sh

    pip install urllib3\<2.0

此后再安装 PyODPS。

检查安装完成：

.. code-block:: sh

    python -c "from odps import ODPS"

如果使用的python不是系统默认的python版本，安装完pip则可以：

.. code-block:: sh

    /home/tops/bin/python2.7 -m pip install -U pip setuptools

其余步骤类似。