Metadata-Version: 2.1
Name: discordshell
Version: 0.0.1
Summary: DShell is a package that combines with discord.py and Jishaku to turn a Discord channel into a shell on which bash commands can be run.
Home-page: https://github.com/ImNimboss/dshell
Author: ImNimboss
Author-email: nimbossthegreat@gmail.com
License: MIT
Project-URL: Documentation, https://github.com/ImNimboss/dshell/tree/main/Documentation
Project-URL: Issue Tracker, https://github.com/ImNimboss/dshell/issues
Project-URL: Source, https://github.com/ImNimboss/dshell
Keywords: shell,discord,terminal,powershell,command-prompt,internet,console,shell-access,utility
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
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 :: Implementation :: CPython
Classifier: Topic :: Communications
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: System :: Shells
Classifier: Topic :: System :: System Shells
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Terminals
Classifier: Topic :: Terminals :: Terminal Emulators/X Terminals
Classifier: Topic :: Utilities
Requires-Python: >=3.6.0
Description-Content-Type: text/markdown

<p align="center"><img src="assets/readme/dshell-logo.png" alt="DShell Logo"></p>

# DShell

```
DISCLAIMER: DShell is not on PyPI yet since it is still undergoing its testing phase. To help out, install it from GitHub.
```

<a href="https://pypi.org/project/dshell" target="_blank" rel="noopener noreferrer">
    <img src="https://img.shields.io/pypi/v/dshell.svg?color=9cf&logo=pypi" alt="PyPI DShell version number">
    <img src="https://img.shields.io/pypi/dm/dshell?color=9cf&logo=pypi" alt="PyPI downloads per month">
    <img src="https://img.shields.io/pypi/pyversions/dshell.svg?color=9cf&logo=pypi" alt="PyPI supported Python versions">
</a>
<a href="https://github.com/ImNimboss/dshell/issues" target="_blank" rel="noopener noreferrer">
    <img src="https://img.shields.io/github/issues/ImNimboss/dshell?color=9cf&logo=github" alt="Number of open GitHub issues">
</a>
<a href="https://github.com/ImNimboss/dshell/contributors" target="_blank" rel="noopener noreferrer">
    <img src="https://img.shields.io/github/contributors/ImNimboss/dshell?color=9cf&logo=github" alt="Number of contributors">
</a>
<a href="https://discord.gg/FcxqdJ7AQq" target="_blank" rel="noopener noreferrer">
    <img src="https://img.shields.io/discord/930791886522810399?color=9cf&logo=discord&label=discord" alt="Discord server">
</a>

## Description

Discord shell or dshell for short is a Python package that combines with [discord.py](https://github.com/Rapptz/discord.py) and [Jishaku](https://github.com/Gorialis/jishaku) to transform an ordinary Discord channel into one capable of running bash commands using a Discord bot.

## Typical usage

<!--Ratio of height:width of image should be 87:84-->
<p align="center"><img src="assets/readme/dshell-example.gif" height="435" width="420"></p>

## When would I use this?

* When you want to use shell commands on your virtual machine without logging into it
* When you want a collaborative terminal with other developers of your team
* When you're simply too lazy to open your shell and would rather do it in an open Discord app
* When you want to run shell commands from your Discord bot's directory easily
* When you want to run shell commands on something that simply looks better than your shell

## Main Features

- [x] - Customizable
- [x] - Easy to use
- [x] - Asynchronous
- [x] - Doesn't favor a particular fork, written in raw archived discord.py (as a result it is compatible with all forks that use the `discord` import)
- [x] - Lightweight
- [x] - Regularly maintained

## Links
* [Documentation](https://github.com/ImNimboss/dshell/tree/main/Documentation)
* [PyPI](https://pypi.org)
* [Issue Tracking](https://github.com/ImNimboss/dshell/issues)
* [Discord server](https://discord.gg/FcxqdJ7AQq)

## Installation and upgrades

```
pip install discordshell
```
for the stable version (recommended).

```
pip install -U dshell
```
to update your stable version.

```
pip install git+https://github.com/ImNimboss/dshell
```
to install it straight off of GitHub (you need git installed for this).

```
pip install -U git+https://github.com/ImNimboss/dshell
```
to upgrade your version that you got from GitHub.

## How to use

Check [Documentation/Basics.md](https://github.com/ImNimboss/dshell/blob/main/Documentation/Basics.md)

## Examples

Check [Documentation/Examples.md](https://github.com/ImNimboss/dshell/blob/main/Documentation/Examples.md)

