Add FastStream example to docs

[birthdaysgift]

Despite FastStream uses FastDepends under the hood the existing example for FastDepends from documentation doesn't work out of the box when used in FastStream handlers.

So I thought that having an explicit example of how to use dependency_injector with FastStream would be helpful for other devs seeking for a solution for such integration.

[ZipFile]

Suggested change

	This example shows how to use ``Dependency Injector`` with `FastStream <https://dummy.faststream.airt.ai/0.5/faststream/>`_.
	This example shows how to use ``Dependency Injector`` with `FastStream <https://github.com/ag2ai/faststream>`_.

[ZipFile]

Suggested change

	FastStream example
	=============
	FastStream example
	==================

[ZipFile]

Suggested change

	counter = providers.Singleton(Counter)
	broker = RedisBroker("redis://redis", logger=None)
	config = providers.Configuration()
	counter = providers.Singleton(Counter)
	broker = providers.Resource(RedisBroker, config.redis_url, logger=None)
	app = providers.Factory(FastStream, broker, logger=None)

If we're demonstrating integration, it would be better to go all-out.

[ZipFile]

see comment above

Suggested change

	await FastStream(broker, logger=None).run()
	app = await container.app()
	await app.run()

[ZipFile]

No DI container?

[ZipFile]

Suggested change

	Ensure that ``run.sh`` has execution permission:
	.. code-block:: bash
	sudo chmod +x ./run.sh

You can chmod +x ./run.sh and commit it right away. Git keeps track of mode flags.

[ZipFile]

Suggested change

	consumer:
	container_name: "${COMPOSE_PROJECT_NAME}-consumer"
	build:
	dockerfile: Dockerfile.consumer
	depends_on:
	- redis
	producer:
	container_name: "${COMPOSE_PROJECT_NAME}-producer"
	build:
	dockerfile: Dockerfile.producer
	consumer:
	image: faststream-example
	depends_on:
	- redis
	producer:
	image: faststream-example

See comment about extra Dockerfile.

[ZipFile]

Add reference to docs/examples/index.rst so it appears alongside other examples.

[ZipFile]

Suggested change

	docker container rm \
	faststream-example-producer \
	faststream-example-consumer \
	faststream-example-redis
	docker image rm \
	faststream-example-producer \
	faststream-example-consumer
	docker compose down --rmi local

Though, I'm not sure if this is a desired behavior, since user might want to tinker with an example app for longer. Better include it in the documentation.

[ZipFile]

Suggested change

	set +x