Metadata-Version: 2.1
Name: backend.ai-client
Version: 19.9.0b4
Summary: Backend.AI Client for Python
Home-page: https://github.com/lablup/backend.ai-client-py
Author: Lablup Inc.
Author-email: joongi@lablup.com
License: MIT
Description: Backend.AI Client
        =================
        
        .. image:: https://badge.fury.io/py/backend.ai-client.svg
           :target: https://badge.fury.io/py/backend.ai-client
           :alt: PyPI version
        
        .. image:: https://img.shields.io/pypi/pyversions/backend.ai-client.svg
           :target: https://pypi.org/project/backend.ai-client/
           :alt: Python Versions
        
        .. image:: https://readthedocs.org/projects/backendai-client-sdk-for-python/badge/?version=latest
           :target: https://docs.client-py.backend.ai/en/latest/?badge=latest
           :alt: SDK Documentation
        
        .. image:: https://travis-ci.com/lablup/backend.ai-client-py.svg?branch=master
           :target: https://travis-ci.com/lablup/backend.ai-client-py
           :alt: Build Status (Linux)
        
        .. image:: https://ci.appveyor.com/api/projects/status/5h6r1cmbx2965yn1/branch/master?svg=true
           :target: https://ci.appveyor.com/project/lablup/backend.ai-client-py/branch/master
           :alt: Build Status (Windows)
        
        .. image:: https://codecov.io/gh/lablup/backend.ai-client-py/branch/master/graph/badge.svg
           :target: https://codecov.io/gh/lablup/backend.ai-client-py
           :alt: Code Coverage
        
        The official API client library for `Backend.AI <https://backend.ai>`_
        
        
        Usage
        -----
        
        You should set the access key and secret key as environment variables to use the API.
        Grab your keypair from `cloud.backend.ai <https://cloud.backend.ai>`_ or your cluster
        admin.
        
        On Linux/macOS, create a shell script as ``my-backend-ai.sh`` and run it before using
        the ``backend.ai`` command:
        
        .. code-block:: sh
        
           export BACKEND_ACCESS_KEY=...
           export BACKEND_SECRET_KEY=...
           export BACKEND_ENDPOINT=https://my-precious-cluster
        
        On Windows, create a batch file as ``my-backend-ai.bat`` and run it before using
        the ``backend.ai`` command:
        
        .. code-block:: bat
        
           chcp 65001
           set PYTHONIOENCODING=UTF-8
           set BACKEND_ACCESS_KEY=...
           set BACKEND_SECRET_KEY=...
           set BACKEND_ENDPOINT=https://my-precious-cluster
        
        Note that it switches to the UTF-8 codepage for correct display of
        special characters used in the console logs.
        
        
        Command-line Interface
        ----------------------
        
        ``backend.ai`` command is the entry point of all sub commands.
        (Alternatively you can use a verbosely long version: ``python -m
        ai.backend.client.cli``)
        
        Highlight: ``run`` command
        ~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        To run the code specified in the command line directly,
        use ``-c`` option to pass the code string (like a shell).
        
        .. code-block:: console
        
           $ backend.ai run python:3.6-ubuntu18.04 -c "print('hello world')"
           ∙ Client session token: d3694dda6e5a9f1e5c718e07bba291a9
           ✔ Kernel (ID: zuF1OzMIhFknyjUl7Apbvg) is ready.
           hello world
        
        By default, you need to specify language with full version tag like
        ``python:3.6-ubuntu18.04``. Depending on the Backend.AI admin's language
        alias settings, this can be shortened just as ``python``. If you want to
        know defined language aliases, contact the admin of Backend.AI server.
        
        You can even run a C code on-the-fly. (Note that we put a dollar sign before
        the single-quoted code argument so that the shell to interpret ``'\n'`` as
        actual newlines.)
        
        .. code-block:: console
        
           $ backend.ai run gcc:gcc6.4-alpine3.8 -c $'#include <stdio.h>\nint main() {printf("hello world\\n");}'
           ∙ Client session token: abc06ee5e03fce60c51148c6d2dd6126
           ✔ Kernel (ID: d1YXvee-uAJTx4AKYyeksA) is ready.
           hello world
        
        For larger programs, you may upload multiple files and then build & execute
        them.  The below is a simple example to run `a sample C program
        <https://gist.github.com/achimnol/df464c6a3fe05b21e9b06d5b80e986c5>`_.
        
        .. code-block:: console
        
           $ git clone https://gist.github.com/achimnol/df464c6a3fe05b21e9b06d5b80e986c5 c-example
           Cloning into 'c-example'...
           Unpacking objects: 100% (5/5), done.
           $ cd c-example
           $ backend.ai run gcc:gcc6.4-alpine3.8 main.c mylib.c mylib.h
           ∙ Client session token: 1c352a572bc751a81d1f812186093c47
           ✔ Kernel (ID: kJ6CgWR7Tz3_v2WsDHOwLQ) is ready.
           ✔ Uploading done.
           ✔ Build finished.
           myvalue is 42
           your name? LABLUP
           hello, LABLUP!
        
        Please refer the ``--help`` manual provided by the ``run`` command.
        
        You may use a shortcut command ``lcc`` and ``lpython`` instead of typing the full
        Python module path like:
        
        .. code-block:: console
        
           $ lcc main.c mylib.c mylib.h
        
        Since the client version 1.1.5, the sessions are no longer automatically cleaned up.
        To do that, add ``--rm`` option to the ``run`` command, like Docker CLI.
        
        Highlight: ``ps`` and ``terminate`` command
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        You can see the list of currently running sessions using your API keypair.
        
        .. code-block:: console
        
           $ backend.ai ps
           Session ID    Lang/runtime              Tag    Created At                        Terminated At    Status      CPU Cores    CPU Used (ms)    Total Memory (MiB)    Used Memory (MiB)    GPU Cores
           ------------  ------------------------  -----  --------------------------------  ---------------  --------  -----------  ---------------  --------------------  -------------------  -----------
           88ee10a027    lablup/python:3.6-ubuntu         2018-12-11T03:53:14.802206+00:00                   RUNNING             1            16314                  1024                 39.2            0
           fce7830826    lablup/python:3.6-ubuntu         2018-12-11T03:50:10.150740+00:00                   RUNNING             1            15391                  1024                 39.2            0
        
        If you set ``-t`` option in the ``run`` command, it will be used as the session ID—you may use it to assign a human-readable, easy-to-type alias for your sessions.
        These session IDs can be reused after the current session using the same ID terminates.
        
        To terminate a session, you can use ``terminate`` or ``rm`` command.
        
        .. code-block:: console
        
           $ backend.ai terminate 5baafb2136029228ca9d873e1f2b4f6a
           ✔ Done.
        
        Highlight: ``proxy`` command
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        To use API development tools such as GraphiQL for the admin API, run an insecure
        local API proxy.  This will attach all the necessary authorization headers to your
        vanilla HTTP API requests.
        
        .. code-block:: console
        
           $ backend.ai proxy
           ∙ Starting an insecure API proxy at http://localhost:8084
        
        More commands?
        ~~~~~~~~~~~~~~
        
        Please run ``backend.ai --help`` to see more commands.
        
        
        Troubleshooting (FAQ)
        ---------------------
        
        * There are error reports related to ``simplejson`` with Anaconda on Windows.
          This package no longer depends on simplejson since v1.0.5, so you may uninstall it
          safely since Python 3.5+ offers almost identical ``json`` module in the standard
          library.
        
          If you really need to keep the ``simplejson`` package, uninstall the existing
          simplejson package manually and try reinstallation of it by downloading `a
          pre-built binary wheel from here
          <https://www.lfd.uci.edu/%7Egohlke/pythonlibs/#simplejson>`_.
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Operating System :: POSIX
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Environment :: No Input/Output (Daemon)
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development
Requires-Python: >=3.5
Provides-Extra: ci
Provides-Extra: dev
Provides-Extra: docs
Provides-Extra: test
