Metadata-Version: 2.1
Name: orbit-database-shell
Version: 0.99.93
Summary: Orbit-DB Shell
Home-page: https://gitlab.com/madpenguin/orbit-database-shell
Keywords: database,shell
Author: Gareth Bult
Author-email: gareth@madpenguin.uk
Requires-Python: >=3.10,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console :: Curses
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Database :: Front-Ends
Classifier: Topic :: File Formats :: JSON
Requires-Dist: Pygments (>=2.12.0,<3.0.0)
Requires-Dist: loguru (>=0.6.0,<0.7.0)
Requires-Dist: mysql-connector-python (>=8.0.33,<9.0.0)
Requires-Dist: orbit-database (>=0.99.91,<0.100.0)
Requires-Dist: prompt-toolkit
Requires-Dist: python-snappy (>=0.6.1,<0.7.0)
Requires-Dist: rich (>=13.3.4,<14.0.0)
Requires-Dist: termcolor (>=1.1.0,<2.0.0)
Requires-Dist: tqdm (>=4.65.0,<5.0.0)
Requires-Dist: ujson (>=5.4.0,<6.0.0)
Project-URL: Bug Tracker, https://gitlab.com/madpenguin/orbit-database-shell/-/issues
Project-URL: Documentation, https://gitlab.com/madpenguin/orbit-database-shell
Project-URL: Repository, https://gitlab.com/madpenguin/orbit-database-shell
Description-Content-Type: text/markdown

# Orbit Database Shell - Introduction

#### Welcome to the Orbit Database Shell repository and documentation. All project documentation is included within this repository and consists of markdown files and comments within the code. These are presented in real time by the "ZeroDocs" Orbit application which renders this content to HTML in real-time.

This project is the command line shell for the NoSQL database that underpins the Orbit Framework. It works in much the same way as the MySQL shell other than it works with Orbit Databases rather than MySQL databases. Maybe with a few other visualisation improvements too.

<table><tr><td width="50%"><img width="100%" src="https://gitlab.com/madpenguin/orbit-database-shell/-/raw/main/images/screenshot.png" /></td><td width="50%">
<h3 style="padding-left:1.4em">Features</h3>

* The ability to create and manage multiple databases
* Drill-down and testing facilities
* Examine data and database structures
* Import and export JSON data, import data directly from MySQL
* Grammar, colourisation and auto-complete for everything
* Operation timing and data size distribution analysis
* Detailed help system with examples
* It's all written in Python and it's <b>very</b> extensible

</td></tr></table>

### Installation

Start off by creating a virtual environment using the tool of your choosing (we currently use "pyenv") then (don't forget to activate the environment) do;
```bash
pip install orbit_database_shell
```
And to run the shell just do;

```bash
$ orbit_database_shell 

  .oooooo.             .o8        o8o      .           oooooooooo.   oooooooooo.
 d8P'  `Y8b           "888        `"'    .o8           `888'   `Y8b  `888'   `Y8b
888      888 oooo d8b  888oooo.  oooo  .o888oo          888      888  888     888
888      888 `888""8P  d88' `88b `888    888            888      888  888oooo888'
888      888  888      888   888  888    888   8888888  888      888  888    `88b
`88b    d88'  888      888   888  888    888 .          888     d88'  888    .88P
 `Y8bood8P'  d888b     `Y8bod8P' o888o   "888"         o888bood8P'   o888bood8P'

     Orbit Database Command Line Tool (c) Mad Penguin Consulting Ltd 2023
     To get started try help register or help for all available commands
none> 
```

And you're running ...
