docs: fill Readme

Author: Lancetnik

.github/workflows/test.yml

@@ -108,7 +108,7 @@ jobs:
 
   # https://github.com/marketplace/actions/alls-green#why
   check:  # This job does nothing and is only used for the branch protection
-    if: always()
+    if: github.event.pull_request.draft == false
 
     needs:
       - coverage-combine

README.md

@@ -1 +1,119 @@
-# taskiq_faststream
+# Taskiq - FastStream
+
+<p align="center">
+    <a href="https://github.com/taskiq-python/taskiq-faststream/actions/workflows/test.yml" target="_blank">
+        <img src="https://github.com/taskiq-python/taskiq-faststream/actions/workflows/test.yml/badge.svg" alt="Tests status"/>
+    </a>
+    <a href="https://pypi.org/project/taskiq-faststream/" target="_blank">
+        <img src="https://img.shields.io/pypi/v/taskiq-faststream?label=pypi%20package" alt="Package version">
+    </a>
+    <a href="https://pepy.tech/project/taskiq-faststream" target="_blank">
+        <img src="https://static.pepy.tech/personalized-badge/taskiq-faststream?period=month&units=international_system&left_color=grey&right_color=blue" alt="downloads"/>
+    </a>
+    <br/>
+    <a href="https://pypi.org/project/taskiq-faststream" target="_blank">
+        <img src="https://img.shields.io/pypi/pyversions/taskiq-faststream.svg" alt="Supported Python versions">
+    </a>
+    <a href="https://github.com/taskiq-python/taskiq-faststream/blob/master/LICENSE" target="_blank">
+        <img alt="GitHub" src="https://img.shields.io/github/license/taskiq-python/taskiq-faststream?color=%23007ec6">
+    </a>
+</p>
+
+---
+
+The current package is just a wrapper for [**FastStream**](https://faststream.airt.ai/0.2/?utm_source=github&utm_medium=acquisition&utm_campaign=measure) objects to make them compatible with [**Taskiq**](https://taskiq-python.github.io/) library.
+
+The main goal of it - provide **FastStream** with a great **Taskiq** tasks [scheduling](https://taskiq-python.github.io/guide/scheduling-tasks.html) feature.
+
+## Installation
+
+If you already have **FastStream** project to interact with your Message Broker, you can add scheduling to it by installing just a **taskiq-faststream**
+
+```bash
+pip install taskiq-faststream
+```
+
+If you starting with a clear project, you can specify **taskiq-faststream** broker by the following distributions:
+
+```bash
+pip install taskiq-faststream[rabbit]
+# or
+pip install taskiq-faststream[kafka]
+# or
+pip install taskiq-faststream[nats]
+```
+
+## Usage
+
+The package gives you two classes: `AppWrapper` and `BrokerWrapper`
+
+These are just containers for the related **FastStream** objects to make them **taskiq**-compatible
+
+To create scheduling tasks for your broker, just wrap it to `BrokerWrapper` and use it like a regular **taskiq** Broker.
+
+```python
+# regular FastStream code
+from faststream.nats import NatsBroker
+
+broker = NatsBroker()
+
+@broker.subscriber("test-subject")
+async def handler(msg: str):
+    print(msg)
+
+# taskiq-faststream scheduling
+from taskiq import TaskiqScheduler
+from taskiq.schedule_sources import LabelScheduleSource
+from taskiq_faststream import BrokerWrapper
+
+# wrap FastStream object
+taskiq_broker = BrokerWrapper(broker)
+
+# create periodic task
+taskiq_broker.task(
+    message="Hi!",
+    subject="test-subject"
+    schedule=[{
+        "cron": "* * * * *",
+    }],
+)
+
+# create scheduler object
+scheduler=TaskiqScheduler(
+    broker=taskiq_broker,
+    sources=[LabelScheduleSource(taskiq_broker)],
+)
+```
+
+Also, you can wrap your **FastStream** application the same way (allows to use lifespan events and AsyncAPI documentation):
+
+```python
+# regular FastStream code
+from faststream import FastStream
+from faststream.nats import NatsBroker
+
+broker = NatsBroker()
+app = FastStream(broker)
+
+@broker.subscriber("test-subject")
+async def handler(msg: str):
+    print(msg)
+
+# wrap FastStream object
+from taskiq_faststream import AppWrapper
+taskiq_broker = AppWrapper(app)
+
+# Code below omitted 👇
+```
+
+Also, instead of using a final `message` argument, you can set a message callback to collect information right before sending:
+
+```python
+async def collect_information_to_send():
+    return "Message to send"
+
+taskiq_broker.task(
+    message=collect_information_to_send,
+    ...,
+)
+```