Metadata-Version: 2.4
Name: mcstatusio
Version: 0.1.0
Summary: A Python wrapper for the mcstatus.io API.
Author-email: Rezn1r <rezn1r@proton.me>
License-Expression: MIT
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp>=3.13.1
Requires-Dist: requests>=2.32.5
Dynamic: license-file

# MCStatusio
A Python wrapper for [mcstatus](httos://mcstatus.io/) API. 

## Installation
You can install the package via pip:
```bash
pip install ???
```

## Usage

### Bedrock Server Status

```python 
from mcstatusio import BedrockServer

server = BedrockServer("play.example.com", 19132)
status = server.status()

if not status.online:
    print("The server is offline.")
else:
    print(f"The server has {status.players.online} players online.")

```

### Java Server Status

```python
from mcstatusio import JavaServer

server = JavaServer("play.example.com", 25565)
status = server.status()

if not status.online:
    print("The server is offline.")
else:
    print(f"The server has {status.players.online} players online.")
```

## Async Usage

### Bedrock Server Status

```python 
import asyncio
from mcstatusio import BedrockServer

server = BedrockServer("play.example.com", 19132)
status = asyncio.run(server.async_status())

if not status.online:
    print("The server is offline.")
else:
    print(f"The server has {status.players.online} players online.")

```

### Java Server Status

```python
import asyncio
from mcstatusio import JavaServer

server = JavaServer("play.example.com", 25565)
status = asyncio.run(server.async_status())

if not status.online:
    print("The server is offline.")
else:
    print(f"The server has {status.players.online} players online.")
```

## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details

## Contributing
Contributions are welcome! Please open an issue or submit a pull request on GitHub.
