Metadata-Version: 2.1
Name: aio-mc-rcon
Version: 3.0.1
Summary: An async library/wrapper for interacting with remote consoles on Minecraft Java Edition servers
Home-page: https://github.com/Iapetus-11/aio-mc-rcon
Author: Iapetus-11
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown

# Aio-MC-RCON ![Code Quality](https://www.codefactor.io/repository/github/iapetus-11/aio-mc-rcon/badge) ![PYPI Version](https://img.shields.io/pypi/v/aio-mc-rcon.svg) ![PYPI Downloads](https://img.shields.io/pypi/dw/aio-mc-rcon?color=0FAE6E) ![Views](https://api.ghprofile.me/view?username=iapetus-11.aio-mc-rcon&color=0FAE6E&label=views&style=flat)
An asynchronous RCON client/wrapper written in Python for Minecraft Java Edition servers!

## Installation
```
pip install -U aio-mc-rcon
```

## Example Usage
- See the [examples folder](examples).

## Documentation
#### *class* aiomcrcon.**Client**(host: *str*, port: *int*, password: *str*):
- Arguments:
  - `host: str` - *The hostname / ip of the server to connect to.*
  - `port: int` - *The port of the server to connect to.*
  - `password: str` - *The password to connect, can be found as the value under `rcon.password` in the `server.properties` file.*
- Methods:
  - `connect(timeout: int = 2)` - *where `timeout` has a default value of 2 seconds.*
  - `send_cmd(cmd: str, timeout: int = 2)` - *where `cmd` is the command to be executed on the server and timeout has a default value of 2 seconds.*
  - `close()` - *closes the connection between the client and server.*

#### *exception* aiomcrcon.**RCONConnectionError**
- *Raised when the connection to the server fails.*

#### *exception* aiomcrcon.**IncorrectPasswordError**
- *Raised when the provided password/authentication is invalid.*

#### *exception* aiomcrcon.**ClientNotConnectedError**
- *Raised when the connect() method hasn't been called yet, and commands cannot be sent.*


