X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/19545d256d58a1ea71d127f2eb25443dcbd3db64..8171328873751d5bfd47cd9da3f6ff9a66c84659:/doc/sdk/python/sdk-python.html.textile.liquid diff --git a/doc/sdk/python/sdk-python.html.textile.liquid b/doc/sdk/python/sdk-python.html.textile.liquid index fa7c36c24b..56f0328042 100644 --- a/doc/sdk/python/sdk-python.html.textile.liquid +++ b/doc/sdk/python/sdk-python.html.textile.liquid @@ -18,7 +18,7 @@ If you are logged in to an Arvados VM, the Python SDK should be installed. To use the Python SDK elsewhere, you can install from PyPI or a distribution package. -The Python SDK supports Python 2.7 and 3.4+ +As of Arvados 2.2, the Python SDK requires Python 3.6+. The last version to support Python 2.7 is Arvados 2.0.4. h2. Option 1: Install from a distribution package @@ -26,7 +26,7 @@ This installation method is recommended to make the CLI tools available system-w First, configure the "Arvados package repositories":../../install/packages.html -{% assign arvados_component = 'python-arvados-python-client' %} +{% assign arvados_component = 'python3-arvados-python-client' %} {% include 'install_packages' %} @@ -38,16 +38,10 @@ Run @pip install arvados-python-client@ in an appropriate installation environme Note: -The SDK uses @pycurl@ which depends on the @libcurl@ C library. To build the module you may have to first install additional packages. On Debian 9 this is: +The SDK uses @pycurl@ which depends on the @libcurl@ C library. To build the module you may have to first install additional packages. On Debian 10 this is:
-$ apt-get install git build-essential python-dev libcurl4-openssl-dev libssl1.0-dev -- -For Python 3 this is - -
-$ apt-get install git build-essential python3-dev libcurl4-openssl-dev libssl1.0-dev +$ apt-get install git build-essential python3-dev libcurl4-openssl-dev libssl-devIf your version of @pip@ is 1.4 or newer, the @pip install@ command might give an error: "Could not find a version that satisfies the requirement arvados-python-client". If this happens, try @pip install --pre arvados-python-client@. @@ -60,8 +54,8 @@ If you installed with pip (option 1, above):
~$python
-Python 2.7.4 (default, Sep 26 2013, 03:20:26) -[GCC 4.7.3] on linux2 +Python 3.7.3 (default, Jul 25 2020, 13:03:44) +[GCC 8.3.0] on linux Type "help", "copyright", "credits" or "license" for more information. >>>import arvados
>>>arvados.api('v1')
@@ -71,11 +65,15 @@ Type "help", "copyright", "credits" or "license" for more information. If you installed from a distribution package (option 2): the package includes a virtualenv, which means the correct Python environment needs to be loaded before the Arvados SDK can be imported. This can be done by activating the virtualenv first: +{% include 'notebox_begin_warning' %} +If you are on Ubuntu 18.04, please note that the Arvados packages that use Python depend on the python-3.8 package. This means they are installed under @/usr/share/python3.8@, not @/usr/share/python3@. You will need to update the commands below accordingly. +{% include 'notebox_end' %} +- ~$source /usr/share/python2.7/dist/python-arvados-python-client/bin/activate
+~$source /usr/share/python3/dist/python3-arvados-python-client/bin/activate
(python-arvados-python-client) ~$python
-Python 2.7.4 (default, Sep 26 2013, 03:20:26) -[GCC 4.7.3] on linux2 +Python 3.7.3 (default, Jul 25 2020, 13:03:44) +[GCC 8.3.0] on linux Type "help", "copyright", "credits" or "license" for more information. >>>import arvados
>>>arvados.api('v1')
@@ -86,9 +84,9 @@ Type "help", "copyright", "credits" or "license" for more information. Or alternatively, by using the Python executable from the virtualenv directly:- ~$/usr/share/python2.7/dist/python-arvados-python-client/bin/python
-Python 2.7.4 (default, Sep 26 2013, 03:20:26) -[GCC 4.7.3] on linux2 +~$/usr/share/python3/dist/python3-arvados-python-client/bin/python
+Python 3.7.3 (default, Jul 25 2020, 13:03:44) +[GCC 8.3.0] on linux Type "help", "copyright", "credits" or "license" for more information. >>>import arvados
>>>arvados.api('v1')