X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/2f66d4cc05e9442a9bb69969744d0750a02a1ed4..499240fcfa25c10bc22277b7d382dcbc31436cbe:/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..4639306922 100644 --- a/doc/sdk/python/sdk-python.html.textile.liquid +++ b/doc/sdk/python/sdk-python.html.textile.liquid @@ -16,66 +16,33 @@ h2. Installation 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. +To use the Python SDK elsewhere, you can install it "from an Arvados distribution package":#package-install or "from PyPI using pip":#pip-install. -The Python SDK supports Python 2.7 and 3.4+ +{% include 'notebox_begin_warning' %} +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. +{% include 'notebox_end' %} -h2. Option 1: Install from a distribution package +h2(#package-install). Install from a distribution package -This installation method is recommended to make the CLI tools available system-wide. It can coexist with the installation method described in option 2, below. +This installation method is recommended to make the CLI tools available system-wide. It can coexist with the pip installation method described below. 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' %} -h2. Option 2: Install with pip +{% 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' %} -This installation method is recommended to use the SDK in your own Python programs. If installed into a @virtualenv@, it can coexist with the system-wide installation method from a distribution package. - -Run @pip install arvados-python-client@ in an appropriate installation environment, such as a @virtualenv@. - -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: - -
-$ 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 -- -If 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@. - -h2. Test installation - -If the SDK is installed and your @ARVADOS_API_HOST@ and @ARVADOS_API_TOKEN@ environment variables are set up correctly (see "api-tokens":{{site.baseurl}}/user/reference/api-tokens.html for details), @import arvados@ should produce no errors. - -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 -Type "help", "copyright", "credits" or "license" for more information. ->>>import arvados
->>>arvados.api('v1')
-<apiclient.discovery.Resource object at 0x233bb50> -
~$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')
@@ -83,12 +50,12 @@ Type "help", "copyright", "credits" or "license" for more information.
~$/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')
@@ -96,34 +63,35 @@ Type "help", "copyright", "credits" or "license" for more information.
arvados.api(api_version).plural_resource_type().api_method(parameter=value, ...).execute()
-
-+$ apt-get install git build-essential python3-dev libcurl4-openssl-dev libssl-dev +-Many API methods accept a parameter whose name is the same as the resource type. For example, @links.create@ accepts a parameter called @link@. This parameter should be given as @body@. +Run @python3 -m pip install arvados-python-client@ in an appropriate installation environment, such as a @virtualenv@. -
arvados.api('v1').links().create(
- uuid=test_link['uuid'],
- body={'properties':{'foo':'bar'}}).execute()
-
-arv = arvados.api('v1')
-j = arv.jobs().list().execute()
-
+~$python3
+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')
+<apiclient.discovery.Resource object at 0x233bb50> +