Metadata-Version: 2.0
Name: trino-admin
Version: 2.16
Summary: Trino-admin installs, configures, and manages Trino/Presto installations.
Home-page: https://github.com/wgzhao/trino-admin
Author: wgzhao
Author-email: UNKNOWN
License: APLv2
Keywords: trino-admin
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Requires-Dist: Fabric (==1.14.1)
Requires-Dist: argparse (==1.4.0)
Requires-Dist: bcrypt (==3.1.3)
Requires-Dist: cffi (==1.15.0)
Requires-Dist: cryptography (==2.6)
Requires-Dist: flake8 (==3.9.2)
Requires-Dist: overrides (==2.8.0)
Requires-Dist: paramiko (==2.7.2)
Requires-Dist: pip (==20.3.4)
Requires-Dist: pycparser (==2.20)
Requires-Dist: pyjks (==20.0.0)
Requires-Dist: pyjwt (==1.7.1)
Requires-Dist: requests (==2.26.0)
Requires-Dist: retrying (==1.3.3)
Requires-Dist: setuptools (==42.0.2)
Requires-Dist: wheel (==0.36.2)

trino-admin 
============

.. image:: https://img.shields.io/pypi/dm/trino-admin.svg
    :target: https://pypi.org/project/trino-admin/

.. image:: https://img.shields.io/pypi/v/trino-admin.svg
    :target: https://pypi.org/project/trino-admin/

.. image:: https://img.shields.io/pypi/pyversions/trino-admin.svg
    :target: https://pypi.org/project/trino-admin/

.. image:: https://img.shields.io/pypi/implementation/trino-admin.svg
    :target: https://pypi.org/project/trino-admin/

.. image:: https://readthedocs.org/projects/trino-admin/badge/?version=latest
    :target: https://trino-admin.readthedocs.io/en/latest/?badge=latest
    :alt: Documentation Status

Trino-admin installs, configures, and manages Trino/Presto installations.

documentation can be found at https://trino-admin.readthedocs.io/en/latest/

Requirements
------------

1. Python 2.7
2. `Docker <https://www.docker.com/>`__. (Only required for development,
   if you want to run the system tests)

   -  If you DO NOT have Docker already installed, you can run the
      ``install-docker.sh`` script in the ``bin`` directory of this
      project. That script has only been tested on Ubuntu 14.04.

   -  If you have Docker already installed, you need to make sure that
      your user has been added to the docker group. This will enable you
      to run commands without ``sudo``, which is a requirement for some
      unit tests. To enable sudoless docker access run the following::


          $ sudo groupadd docker
          $ sudo gpasswd -a ${USER} docker
          $ sudo service docker restart


      If the user you added to the docker group is the same one you’re
      logged in as, you will need to log out and back in so that the
      changes can take effect.
3. trino or presto command line (Optional)

Building
--------

Trino-admin makes use of ``make`` as its build tool. ``make`` in turn
calls out to various utilities (e.g. ``tox``, ``flake8``,
``sphinx-apidoc``, ``python``) in order to perform the requested
actions.

In order to get started with ``trino-admin``,

1. Fork the ``trino-admin`` repo on GitHub,

   https://github.com/wgzhao/trino-admin.

2. Clone your fork locally ::

    $ git clone git@github.com:your_name_here/trino-admin.git

3. Install your local copy into a virtualenv. Assuming you have
   virtualenvwrapper installed, this is how you set up your fork for
   local development ::


    $ mkvirtualenv trinoadmin
    $ cd trinoadmin/
    $ python setup.py develop

4. Create a branch for local development ::

    $ git checkout -b name-of-your-bugfix-or-feature

   Now you can make your changes locally.

5. When you’re done making changes, check that your changes pass
   ``make clean lint test``, which runs flake8 and the unit tests (which
   test both Python 2.6 and 2.7). To run the product tests
   (``make test-all``), you need docker installed. You may also need to
   run ``pip install wheel`` in your virtualenv. To install and start
   docker use ::

    $ wget -qO- https://get.docker.com/ | sh

    # Add current user to Docker group to run without sudo
    $ sudo gpasswd -a ${USER} docker
    $ sudo service docker restart

Building the installer
~~~~~~~~~~~~~~~~~~~~~~

The two tasks used to build the trino-admin installer are ``dist`` and
``dist-offline``. The ``dist`` task builds an installer that requires
internet connectivity during installation. The ``dist-offline`` task
builds an installer that does not require internet connectivity during
installation. Instead the offline installer downloads all dependencies
at build time and points ``pip`` to those dependencies during
installation.

License
-------

Free software: Apache License Version 2.0 (APLv2).



