pop-loop

pop-loop Contains plugins that allow alternate io loops to be used to run asynchronous code in pop projects.

About

Pop used the asyncio loop by default in a built-in mod at 'hub.pop.loop'. It became necessary to split the mod into it's own project for more loop capabilities. For testing, loop management was difficult, but paired with pytest-pop, pop-loop makes async testing easy.

What is POP?

This project is built with pop, a Python-based implementation of Plugin Oriented Programming (POP). POP seeks to bring together concepts and wisdom from the history of computing in new ways to solve modern computing problems.

For more information:

• Intro to Plugin Oriented Programming (POP)
• pop-awesome
• pop-create

Getting Started

Prerequisites

• Python 3.8+
• git (if installing from source, or contributing to the project)

Installation

If wanting to use pop-loop, you can do so by either installing from PyPI or from source.

Install from PyPI

> If package is available via PyPI, include the directions. > > bash > pip install pop-loop >

Install Extras

> pop-loop can be installed with extras to enable the different loop > plugins in this project. > > trio: .. code-block:: bash > > > pip install pop-loop[trio] > > uvloop: .. code-block:: bash > > > pip install pop-loop[uvloop] > > qt: .. code-block:: bash > > > pip install pop-loop[qt]

Install from source

# clone repo
git clone git@gitlab.com/saltstack/pop/pop-loop.git
cd pop-loop

# Setup venv
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Usage

Describe some basic example use case for this plugin.

Examples

uvloop example: .. code-block:: python

> import asyncio import pop.hub > > hub = pop.hub.Hub() > > hub.pop.loop.create(loop_plugin="uv") task = > hub.pop.Loop.create(asyncio.sleep(0)) > hub.pop.Loop.run_until_complete(task)

trio example: .. code-block:: python

> import asyncio import pop.hub > > hub = pop.hub.Hub() > > hub.pop.loop.create(loop_plugin="trio") task = > hub.pop.Loop.create(asyncio.sleep(0)) > hub.pop.Loop.run_until_complete(task)

QT example: .. code-block:: python

> import asyncio import pop.hub import PyQt5.QtWidgets as pyqt5 > > hub = pop.hub.Hub() hub.loop.qt.APP = pyqt5.QApplication([]) > hub.pop.loop.create(loop_plugin="qt") > > task = hub.pop.Loop.create(asyncio.sleep(0)) > hub.pop.Loop.run_until_complete(task)

Acknowledgements

• Img Shields for making repository badges easy.