unasync¶
The unasync project’s goal is to produce a permissively licensed, tool that gives you the ability to transform your asynchronous code into synchronous code.
Why are we doing it ?¶
You can find the whole discussion here.
In short the TLDR; version is, Unasync gives you the ability to transform your asynchronous code placed in _async directory into into synchronous code and put it in directory named _sync i.e
async def f():
return await 1
will be transformed and placed in directory _sync
def f():
return 1
Installation¶
pip install unasync
Usage¶
To use the unasync project you need to install the package and then create a _async folder where you will place the asynchronous code that you want to transform into synchronous code.
And then in your setup.py
place the following code.
import unasync
setuptools.setup(
...
cmdclass={'build_py': unasync.cmdclass_build_py()},
...
)
Then create a file pyproject.toml in the root of your project and mention unasync as one of your build dependency.
[build-system]
requires = ["setuptools>=40.6.2", "wheel", "unasync"]
build-backend = "setuptools.build_meta"
And when you will build your package you will get your synchronous code in _sync folder.
If you’d like to customize where certain rules are applied you can pass
customized unasync.Rule
instances to unasync.cmdclass_build_py()
import unasync
setuptools.setup(
...
cmdclass={'build_py': unasync.cmdclass_build_py(rules=[
# This rule transforms files within 'ahip' -> 'hip'
# instead of the default '_async' -> '_sync'.
unasync.Rule("/ahip/", "/hip/"),
# This rule's 'fromdir' is more specific so will take precedent
# over the above rule if the path is within /ahip/tests/...
# This rule adds an additional token replacement over the default replacements.
unasync.Rule("/ahip/tests/", "/hip/tests/", additional_replacements={"ahip": "hip"}),
])},
...
)
Usage outside of setuptools¶
You can also use unasync without setuptools, to run unasync on tests, for example.
import unasync
unasync.unasync_files(
[file1, file2, ...],
rules=[
unasync.Rule("tests/", "tests_sync/", additional_replacements={"ahip": "hip"}),
]
)