Metadata-Version: 2.1
Name: arvados-python-client
Version: 2.6.3
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 (>=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 won't be able to use it.

1. Run ``pip install --user arvados-python-client``.

2. In your shell configuration, make sure you add ``$HOME/.local/bin``
   to your PATH environment variable.  For example, you could add the
   command ``PATH=$PATH:$HOME/.local/bin`` to your ``.bashrc`` file.

3. Reload your shell configuration.  For example, bash users could run
   ``source ~/.bashrc``.

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.


