Metadata-Version: 2.1
Name: crash
Version: 0.31.5
Summary: CrateDB Shell
Home-page: https://github.com/crate/crash
Author: Crate.io
Author-email: office@crate.io
License: Apache License 2.0
Keywords: crate db data client shell
Platform: any
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Database
Requires-Python: >=3.7
Description-Content-Type: text/x-rst
License-File: LICENSE
License-File: NOTICE
Requires-Dist: colorama <1
Requires-Dist: Pygments <3,>=2.4
Requires-Dist: crate >=0.35.2
Requires-Dist: platformdirs <5
Requires-Dist: prompt-toolkit <4,>=3.0
Requires-Dist: tabulate <0.10,>=0.9
Requires-Dist: sqlparse <0.6.0,>=0.4.4
Requires-Dist: verlib2 <0.3
Provides-Extra: argcompletion
Requires-Dist: argcomplete ; extra == 'argcompletion'
Provides-Extra: devel
Requires-Dist: coverage <8 ; extra == 'devel'
Requires-Dist: flake8 <8 ; extra == 'devel'
Requires-Dist: isort <6 ; extra == 'devel'
Provides-Extra: test
Requires-Dist: crate[test] ; extra == 'test'
Requires-Dist: zc.customdoctests <2 ; extra == 'test'
Requires-Dist: cratedb-toolkit[test] ; extra == 'test'

=================
The CrateDB Shell
=================

.. image:: https://github.com/crate/crash/actions/workflows/main.yml/badge.svg
    :target: https://github.com/crate/crash/actions/workflows/main.yml
    :alt: Outcome of CI

.. image:: https://img.shields.io/pypi/v/crash.svg
    :target: https://pypi.python.org/pypi/crash
    :alt: Most recent version on PyPI

.. image:: https://img.shields.io/pypi/pyversions/crash.svg
    :target: https://pypi.python.org/pypi/crash
    :alt: Supported Python versions

.. image:: https://img.shields.io/github/license/crate/crash
    :target: https://github.com/crate/crash/blob/master/LICENSE
    :alt: License

.. image:: https://static.pepy.tech/badge/crash/month
    :target: https://www.pepy.tech/projects/crash
    :alt: Number of downloads per month

|

The CrateDB Shell (aka *Crash*) is an interactive `command-line interface`_
(CLI) tool for interacting with CrateDB.

Screenshot
==========

.. image:: https://raw.githubusercontent.com/crate/crash/master/docs/query.png
    :alt: A screenshot of Crash


Documentation
=============
The official documentation is available at `CrateDB shell documentation`_.


Installation
============

Python Package
--------------

Crash is available as a `pip`_ package.

To install, run::

    pip install crash

Now, run it::

    crash

To update, run::

    pip install -U crash

Standalone
----------

Crash is also available as a standalone executable that includes all the
necessary dependencies.

First, download the executable file::

    curl -o crash https://cdn.crate.io/downloads/releases/crash_standalone_latest

Then, set the executable bit::

    chmod +x crash

Now, run it::

    ./crash

If you would like to run ``crash`` from any directory, and without the leading
``./``, the file has to be in a directory that is on your `PATH`_.

Troubleshooting
===============

The documentation section about `troubleshooting connection errors`_ provides
support and guidelines how to debug and resolve problems when connecting to
`CrateDB`_ or `CrateDB Cloud`_.

Contributing
============

This project is primarily maintained by Crate.io_, but we welcome community
contributions!

See the `developer docs`_ and the `contribution docs`_ for more information.

Help
====

Looking for more help? Check out our `support channels`_.


.. _command-line interface: https://en.wikipedia.org/wiki/Command-line_interface
.. _contribution docs: CONTRIBUTING.rst
.. _Crate.io: https://cratedb.com/
.. _CrateDB: https://github.com/crate/crate
.. _CrateDB Cloud: https://console.cratedb.cloud
.. _CrateDB shell documentation: https://cratedb.com/docs/crate/crash/
.. _developer docs: DEVELOP.rst
.. _PATH: https://en.wikipedia.org/wiki/PATH_(variable)
.. _pip: https://pypi.python.org/pypi/pip
.. _support channels: https://cratedb.com/support/
.. _troubleshooting connection errors: https://cratedb.com/docs/crate/crash/en/latest/troubleshooting.html
