# Tasks

Tasks are a great way to schedule coroutines to be run outside your event/command handler.  
Tasks are managed by TSBot and automatically cleaned up on done/closing.

```python
async def example_task(bot: TSBot):
    print("Example task called")
    # Do something with the bot


bot.register_task(example_task)
```

You can pass arguments to your task by providing them to the [bot.register_task()](tsbot.bot.TSBot.register_task) method after the handler.

```python
async def example_task(bot: TSBot, arg1: int, arg2: str):
    print("Example task called")
    # Do something with the bot


bot.register_task(example_task, 1, "test")
```

```{warning}
Task handlers should be well behaved. Tasks can be cancelled at any point.
This mainly happens when the bot is closing and cleaning up running tasks.
You should never block task cancelling by catching [asyncio.CancelledError](asyncio.CancelledError) and ignoring it.
This will hang your bot on close.
If you need to do clean up in your task, catch the [asyncio.CancelledError](asyncio.CancelledError), do clean up, and return or re raise the exception.
```

```{warning}
Task handling is started before the bot is connected to the server.
If you need the bot to be connected to the TeamSpeak server, Use build-in
`connect` [event](./events.md#built-in-events) event handlers to register tasks.
```

## Every task

Every tasks are a way for you to schedule a task to run periodically.
For example you could implement a AFK mover:

```{literalinclude} ../../examples/plugin_AFK_mover.py
:language: python
```