Metadata-Version: 2.1
Name: dogehouse
Version: 3.0.0
Summary: Python wrapper for the dogehouse API
Home-page: https://github.com/tusharsadhwani/dogehouse.py
Author: Tushar Sadhwani
Author-email: tushar.sadhwani000@gmail.com
License: MIT
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: websockets (==8.1)
Provides-Extra: dev
Requires-Dist: pytest (>=6.2.2) ; extra == 'dev'

# dogehouse.py

Python wrapper for the dogehouse API.

[![pypi](https://img.shields.io/badge/pypi-dogehouse-blue)](https://pypi.org/project/dogehouse)

## Documentation

You can find the documentation at [The DogeGarden Wiki](https://wiki.dogegarden.net)

## Installation

`pip install dogehouse`

## Example

```python
from dogehouse import DogeClient
from dogehouse.entities import ReadyEvent, UserJoinEvent, MessageEvent

doge = DogeClient("token", "refresh_token")


@doge.on_ready
async def make_my_room(event: ReadyEvent) -> None:
    print(f"Successfully connected as @{event.user.username}!")
    await doge.create_room("Hello World!")


@doge.on_user_join
async def greet_user(event: UserJoinEvent) -> None:
    await doge.send_message(f"Hello @{event.user.username}")


@doge.command
async def echo(event: MessageEvent) -> None:
    msg = event.message
    await doge.send_message(f'@{msg.author.username} said {msg.content}')


doge.run()
```

Check [examples](./examples/basic_bot.py) for more feature usage.

## Tokens

- Go to [dogehouse.tv](https://dogehouse.tv)
- Open Developer options (<kbd>F12</kbd> or <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd>)
- Go to Application > Local Storage > dogehouse&period;tv
- There lies your `TOKEN` and `REFRESH_TOKEN`


