doc: ch8 - added more examples from anyio.

Author: aligheshlaghi97

docs/8. Introduction to AnyIO and Trio/ex_8_6.py

@@ -0,0 +1,26 @@
+import anyio
+
+
+async def producer(sender):
+    async with sender:
+        for value in range(5):
+            await sender.send(value)
+            await anyio.sleep(1)
+
+
+async def consumer(receiver):
+    async with receiver:
+        async for value in receiver:
+            print(f'Got number {value}')
+            await anyio.sleep(1)
+
+
+async def main():
+    sender, receiver = anyio.create_memory_object_stream()
+    async with anyio.create_task_group() as tg:
+        async with sender, receiver:
+            tg.start_soon(producer, sender.clone())
+            tg.start_soon(consumer, receiver.clone())
+
+
+anyio.run(main)

docs/8. Introduction to AnyIO and Trio/ex_8_7.py

@@ -0,0 +1,31 @@
+from pathlib import Path
+
+import anyio
+from anyio import to_thread
+
+
+def print_dir_content():
+    current_dir = Path.cwd()
+    for file in current_dir.iterdir():
+        print(file)
+
+
+async def display_dir_content(event):
+    await to_thread.run_sync(print_dir_content)
+    event.set()
+
+
+async def wait_print_finished(event):
+    print('wait dir printing is finished')
+    await event.wait()
+    print('finished!')
+
+
+async def main():
+    event = anyio.Event()
+    async with anyio.create_task_group() as tg:
+        tg.start_soon(display_dir_content, event)
+        tg.start_soon(wait_print_finished, event)
+
+
+anyio.run(main)

docs/8. Introduction to AnyIO and Trio/index.md

@@ -92,10 +92,18 @@ run(main, backend='trio')
 ```
 
 
-## Integrating AnyIO and Trio into Existing Projects
-
-
-
+And let's see a typical `consumer-producer` pattern in `anyio` which  looks like `Trio`'s example:
+```python
+# ex_8_6
+{% include_relative ex_8_6.py %}
+```
 
+If you want to do some blocking task, `anyio.to_thread` API seem do to a good job.
+One example would be to read the file names in the current path.
+[from this article](https://lewoudar.medium.com/anyio-all-you-need-for-async-programming-stuff-4cd084d0f6bd)
+```python
+# ex_8_7
+{% include_relative ex_8_7.py %}
+```
 
-## Best Practices and Advanced Concepts
+## Integrating AnyIO and Trio into Existing Projects

docs/index.md

@@ -72,7 +72,6 @@ this repository has you covered.
       - Exploring Trio
       - Getting Started with AnyIO
       - Integrating AnyIO and Trio into Existing Projects
-      - Best Practices and Advanced Concepts
 
 9. * **Task Scheduling and Queues: Celery, APScheduler, and Beyond**
       - Introduction to Task Scheduling and Queues

requirements.txt

@@ -2,3 +2,4 @@ pytest~=8.3.3
 httpx~=0.27.2
 starlette==0.41.0
 trio~=0.22.0
+anyio[trio]~=4.8.0