Metadata-Version: 2.4
Name: py-mineatar
Version: 1.0.0
Summary: A Python wrapper for the Mineatar API.
Author-email: Rezn1r <rezn1r@proton.me>
License-Expression: MIT
Project-URL: Homepage, https://github.com/rzn1r/py-mineatar
Keywords: mineatar,minecraft,api,wrapper
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp>=3.13.2
Requires-Dist: pytest>=8.4.2
Requires-Dist: pytest-asyncio>=1.2.0
Requires-Dist: requests>=2.32.5
Dynamic: license-file

# py-mineatar
A Python wrapper for mineatar.io

## Installation
You can install the package via pip:

```bash
pip install py-mineatar
```

## Usage
Here's an example of how to use the `py-mineatar` package:

### Synchronous Example

```python
from mineatar import MineatarClient

with MineatarClient() as client:
    avatar_bytes = client.get_skin("069a79f4-44e9-4726-a5be-fca90e38aaf5") # Notch's UUID

    # Save the avatar image
    with open("notch_skin.png", "wb") as f:
        f.write(avatar_bytes)
```

### Asynchronous Example

```python
import asyncio
from mineatar import AsyncMineatarClient

async def main():
    async with AsyncMineatarClient() as client:
        avatar_bytes = await client.get_skin("069a79f4-44e9-4726-a5be-fca90e38aaf5") # Notch's UUID

        # Save the avatar image
        with open("notch_skin.png", "wb") as f:
            f.write(avatar_bytes)

asyncio.run(main())
```

## Features
- Fast and easy access to Minecraft avatars and skins.
- Supports both synchronous and asynchronous operations.
- Simple and easy-to-use.

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

## Contributing
Contributions are welcome! Please feel free to submit a pull request or open an issue.
