Metadata-Version: 2.1
Name: arvados-python-client
Version: 2.7.0
Summary: Arvados client library
Home-page: https://arvados.org
Author: Arvados
Author-email: info@arvados.org
License: Apache 2.0
Download-URL: https://github.com/arvados/arvados.git
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Requires-Dist: ciso8601 (>=2.0.0)
Requires-Dist: future
Requires-Dist: google-api-core (<2.11.0)
Requires-Dist: google-api-python-client (>=2.1.0)
Requires-Dist: google-auth (<2)
Requires-Dist: httplib2 (<0.20.2,>=0.9.2)
Requires-Dist: protobuf (<4.0.0dev)
Requires-Dist: pycurl (<7.45.0,>=7.19.5.1)
Requires-Dist: pyparsing (<3)
Requires-Dist: ruamel.yaml (<0.17.22,>=0.15.54)
Requires-Dist: setuptools (>=40.3.0)
Requires-Dist: ws4py (>=0.4.2)
Requires-Dist: dataclasses ; python_version < "3.7"
Requires-Dist: typing-extensions (<4.8,>=3.7.4) ; python_version < "3.8"

.. Copyright (C) The Arvados Authors. All rights reserved.
..
.. SPDX-License-Identifier: Apache-2.0

=====================
Arvados Python Client
=====================

Overview
--------

This package provides the ``arvados`` module, an API client for
Arvados_.  It also includes higher-level functions to help you write
Crunch scripts, and command-line tools to store and retrieve data in
the Keep storage server.

.. _Arvados: https://arvados.org/

Installation
------------

Installing under your user account
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This method lets you install the package without root access.  However,
other users on the same system will need to reconfigure their shell in order
to be able to use it. Run the following to install the package in an
environment at ``~/arvclients``::

  python3 -m venv ~/arvclients
  ~/arvclients/bin/pip install arvados-python-client

Command line tools will be installed under ``~/arvclients/bin``. You can
test one by running::

  ~/arvclients/bin/arv-get --version

You can run these tools by specifying the full path every time, or you can
add the directory to your shell's search path by running::

  export PATH="$PATH:$HOME/arvclients/bin"

You can make this search path change permanent by adding this command to
your shell's configuration, for example ``~/.bashrc`` if you're using bash.
You can test the change by running::

  arv-get --version

Installing on Debian systems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1. Add this Arvados repository to your sources list::

     deb http://apt.arvados.org/ buster main

2. Update your package list.

3. Install the ``python3-arvados-python-client`` package.

Configuration
-------------

This client software needs two pieces of information to connect to
Arvados: the DNS name of the API server, and an API authorization
token.  You can set these in environment variables, or the file
``$HOME/.config/arvados/settings.conf``.  `The Arvados user
documentation
<http://doc.arvados.org/user/reference/api-tokens.html>`_ describes
how to find this information in the Arvados Workbench, and install it
on your system.

Testing and Development
-----------------------

This package is one part of the Arvados source package, and it has
integration tests to check interoperability with other Arvados
components.  Our `hacking guide
<https://dev.arvados.org/projects/arvados/wiki/Hacking_Python_SDK>`_
describes how to set up a development environment and run tests.


