syncra 1.0.3

A utility for creating synchronous and asynchronous compatible methods.

syncra

?? Syncra provides async harmony. See the examples below to learn how to create functions and classes that work in both synchronous and asynchronous contexts.

Features

• Async and Sync Compatibility: Easily create functions that work in both synchronous and asynchronous contexts.
• Flexible Initialization: Use AsyncObj for classes requiring asynchronous initialization.
• Decorator for Async Methods: Simplify async method usage with the sync_compat decorator.

Installation

Install via pip:

pip install syncra

Usage

sync_async_factory

Create a function that can be called synchronously or asynchronously:

from syncra import sync_async_factory
import asyncio

def sync_func(x):
    return x * 2


async def async_func(x):
    await asyncio.sleep(0.1)
    return x * 2


syncra = sync_async_factory(sync_func, async_func)

# Usage:
result = syncra(5)  # Synchronous


async def main():  # Asynchronous
    result = await syncra(5)

@sync_compat Decorator

Make an async function compatible with sync calls

from syncra import sync_compat
import asyncio


@sync_compat
async def async_function(x):
    await asyncio.sleep(0.1)
    return x * 2


# Usage:
result = async_function(5)  # Synchronous


async def main():  # Asynchronous
    result = await async_function(5)

AsyncObj Class

Create a class that can be initialized asynchronously:

from syncra import AsyncObj


class MyAsyncClass(AsyncObj):
    async def __ainit__(self, x):
        self.x = x


# Usage:
async def main():
    obj = await MyAsyncClass(10)
    print(obj.x)

Licence

This project is licensed under the MIT License.