winloop 0.8.0__tar.gz → 0.8.1__tar.gz

winloop-0.8.1/PKG-INFO

@@ -0,0 +1,161 @@
+Metadata-Version: 2.4
+Name: winloop
+Version: 0.8.1
+Summary: Windows version of uvloop
+Author-email: Vizonex <VizonexBusiness@gmail.com>
+License: MIT License
+Project-URL: github, https://github.com/Vizonex/Winloop
+Keywords: asyncio,networking
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: System :: Networking
+Requires-Python: >=3.9.0
+Description-Content-Type: text/markdown
+License-File: LICENSE-APACHE
+License-File: LICENSE-MIT
+Provides-Extra: test
+Requires-Dist: aiohttp>=3.10.5; extra == "test"
+Requires-Dist: flake8<8,>=5; extra == "test"
+Requires-Dist: psutil; extra == "test"
+Requires-Dist: pycodestyle<2.16,>=2.9; extra == "test"
+Requires-Dist: pyOpenSSL<26.5,>=23.0; extra == "test"
+Requires-Dist: mypy>=0.800; extra == "test"
+Provides-Extra: dev
+Requires-Dist: packaging; extra == "dev"
+Requires-Dist: setuptools>=60; extra == "dev"
+Requires-Dist: Cython==3.3.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: Sphinx<9.2.0,>=4.1.2; extra == "docs"
+Requires-Dist: sphinxcontrib-asyncio~=0.3.0; extra == "docs"
+Requires-Dist: sphinx_rtd_theme<3.2.0,>=0.5.2; extra == "docs"
+Dynamic: license-file
+
+<img src="https://raw.githubusercontent.com/Vizonex/Winloop/main/winloop.png" width="200px"/>
+
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![IDIM](https://raw.githubusercontent.com/Vizonex/IDIM-Badge/master/badge.svg)](https://github.com/Vizonex/IDIM-Badge)
+
+
+
+# Winloop
+[![PyPI version](https://badge.fury.io/py/winloop.svg)](https://badge.fury.io/py/winloop)
+![PyPI - Downloads](https://img.shields.io/pypi/dm/winloop)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache-yellow.svg)](https://opensource.org/licenses/Apache-2-0)
+
+An alternative library for uvloop compatibility with Windows because let's face it. Windows' Python asyncio standard library is garbage, especially when Windows Defender decides to eat half of your RAM.
+I never really liked the fact that I couldn't make anything run faster especially when you have fiber internet connections in place and you've done all the optimizations you could possibly think of. It always felt disappointing when `libuv` is available for Windows [but Windows was never compatible with uvloop.](https://github.com/MagicStack/uvloop/issues/14#issuecomment-575826367])
+
+Since nobody was willing to step in after so many years of waiting, I went ahead and downloaded the source code for uvloop and started modifying the source code to be Windows compatible by carefully removing and changing parts that were not made for Windows. Many hours of research went into making this library.
+
+The differences with __uvloop__ is that forking has been fully disabled and some smaller API calls had to be changed, error handling has been carefully modified and subprocesses release the GIL instead of forking out...
+
+There is a performance increase of about 5 times with Winloop compared to using the `WindowsSelectorEventLoopPolicy` and `WindowsProactorEventLoopPolicy` which have been known to trigger SSL problems in `Python 3.9`. Winloop is a very good replacement for solving those SSL problems as well. This library also has comparable performance to its brother uvloop.
+
+
+
+## How to install Winloop on your Windows Operating System
+
+```
+pip install winloop
+```
+
+You can also clone the repository and build the extension yourself by running the command below if you wish to use or build this library locally. Note that you will need Cython and The Visual C++ extensions
+to compile this library on your own.
+
+```
+python setup.py build_ext --inplace
+```
+
+## Testing with UV
+The __uv__ package manager is the preferred method for testing __winloop__ and it's author uses `ruff` and `uv` by default.
+
+```
+uv venv
+```
+
+```shell
+uv pip install winloop
+```
+If your bilding and testing it from your own fork the following should work.
+```shell
+uv pip install -e .
+```
+If your planning to setup.py build_ext commands
+you will need to install setuptools and cython
+```shell
+uv pip install cython setuptools
+```
+
+
+## Reporting issues
+
+If you find any bugs with this library be sure to open up an issue in the [issuetracker](https://github.com/Vizonex/Winloop/issues). The Winloop Contributors and the Owner when available will be happy try to help you figure out and diagnose your problems.
+
+
+## How To Use Winloop When Uvloop is not available
+
+```python
+# Here's A small Example of using winloop when uvloop is not available to us
+import sys
+import aiohttp
+
+async def main():
+    async with aiohttp.ClientSession("https://httpbin.org") as client:
+        async with client.get("/ip") as resp:
+            print(await resp.json())
+
+if __name__ == "__main__":
+    if sys.platform in ('win32', 'cygwin', 'cli'):
+        from winloop import run
+    else:
+        # if we're on apple or linux do this instead
+        from uvloop import run
+    run(main())
+  ```
+
+Alternatively, There's another way to do this involving a smaller resource called `winuvloop` which combines both uvloop and winloop together.
+
+```python
+import aiohttp
+import winuvloop
+
+async def main():
+    async with aiohttp.ClientSession("https://httpbin.org") as client:
+        async with client.get("/ip") as resp:
+            print(await resp.json())
+
+if __name__ == "__main__":
+    winuvloop.run(main())
+```
+
+
+## Videos
+- By me: https://www.youtube.com/watch?v=tz9RYJ6aBZ8  (I might make a tutorial on how to use and install winloop it for those who have reading problems)
+
+- My Presentation and Virtual Confrence Because I'm too busy to go to python conventions: https://www.youtube.com/watch?v=Cbb6trkKWXY
+
+
+## Contributing
+I put my heart and soul into this library ever since it began and any help is appreciated and means a lot to me, I have other things I wish to explore so every little bit helps. No matter what I go through in life, my heart is always here.
+
+### How Can I contribute?
+- Forking the library.
+- Mirroring Winloop's improvements on uvloop's side.
+- Reviewing pull requests.
+- Fixing or editing workflows.
+- Finding and editing spelling mistakes.

winloop-0.8.1/README.md

@@ -0,0 +1,115 @@
+<img src="https://raw.githubusercontent.com/Vizonex/Winloop/main/winloop.png" width="200px"/>
+
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![IDIM](https://raw.githubusercontent.com/Vizonex/IDIM-Badge/master/badge.svg)](https://github.com/Vizonex/IDIM-Badge)
+
+
+
+# Winloop
+[![PyPI version](https://badge.fury.io/py/winloop.svg)](https://badge.fury.io/py/winloop)
+![PyPI - Downloads](https://img.shields.io/pypi/dm/winloop)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache-yellow.svg)](https://opensource.org/licenses/Apache-2-0)
+
+An alternative library for uvloop compatibility with Windows because let's face it. Windows' Python asyncio standard library is garbage, especially when Windows Defender decides to eat half of your RAM.
+I never really liked the fact that I couldn't make anything run faster especially when you have fiber internet connections in place and you've done all the optimizations you could possibly think of. It always felt disappointing when `libuv` is available for Windows [but Windows was never compatible with uvloop.](https://github.com/MagicStack/uvloop/issues/14#issuecomment-575826367])
+
+Since nobody was willing to step in after so many years of waiting, I went ahead and downloaded the source code for uvloop and started modifying the source code to be Windows compatible by carefully removing and changing parts that were not made for Windows. Many hours of research went into making this library.
+
+The differences with __uvloop__ is that forking has been fully disabled and some smaller API calls had to be changed, error handling has been carefully modified and subprocesses release the GIL instead of forking out...
+
+There is a performance increase of about 5 times with Winloop compared to using the `WindowsSelectorEventLoopPolicy` and `WindowsProactorEventLoopPolicy` which have been known to trigger SSL problems in `Python 3.9`. Winloop is a very good replacement for solving those SSL problems as well. This library also has comparable performance to its brother uvloop.
+
+
+
+## How to install Winloop on your Windows Operating System
+
+```
+pip install winloop
+```
+
+You can also clone the repository and build the extension yourself by running the command below if you wish to use or build this library locally. Note that you will need Cython and The Visual C++ extensions
+to compile this library on your own.
+
+```
+python setup.py build_ext --inplace
+```
+
+## Testing with UV
+The __uv__ package manager is the preferred method for testing __winloop__ and it's author uses `ruff` and `uv` by default.
+
+```
+uv venv
+```
+
+```shell
+uv pip install winloop
+```
+If your bilding and testing it from your own fork the following should work.
+```shell
+uv pip install -e .
+```
+If your planning to setup.py build_ext commands
+you will need to install setuptools and cython
+```shell
+uv pip install cython setuptools
+```
+
+
+## Reporting issues
+
+If you find any bugs with this library be sure to open up an issue in the [issuetracker](https://github.com/Vizonex/Winloop/issues). The Winloop Contributors and the Owner when available will be happy try to help you figure out and diagnose your problems.
+
+
+## How To Use Winloop When Uvloop is not available
+
+```python
+# Here's A small Example of using winloop when uvloop is not available to us
+import sys
+import aiohttp
+
+async def main():
+    async with aiohttp.ClientSession("https://httpbin.org") as client:
+        async with client.get("/ip") as resp:
+            print(await resp.json())
+
+if __name__ == "__main__":
+    if sys.platform in ('win32', 'cygwin', 'cli'):
+        from winloop import run
+    else:
+        # if we're on apple or linux do this instead
+        from uvloop import run
+    run(main())
+  ```
+
+Alternatively, There's another way to do this involving a smaller resource called `winuvloop` which combines both uvloop and winloop together.
+
+```python
+import aiohttp
+import winuvloop
+
+async def main():
+    async with aiohttp.ClientSession("https://httpbin.org") as client:
+        async with client.get("/ip") as resp:
+            print(await resp.json())
+
+if __name__ == "__main__":
+    winuvloop.run(main())
+```
+
+
+## Videos
+- By me: https://www.youtube.com/watch?v=tz9RYJ6aBZ8  (I might make a tutorial on how to use and install winloop it for those who have reading problems)
+
+- My Presentation and Virtual Confrence Because I'm too busy to go to python conventions: https://www.youtube.com/watch?v=Cbb6trkKWXY
+
+
+## Contributing
+I put my heart and soul into this library ever since it began and any help is appreciated and means a lot to me, I have other things I wish to explore so every little bit helps. No matter what I go through in life, my heart is always here.
+
+### How Can I contribute?
+- Forking the library.
+- Mirroring Winloop's improvements on uvloop's side.
+- Reviewing pull requests.
+- Fixing or editing workflows.
+- Finding and editing spelling mistakes.

{winloop-0.8.0 → winloop-0.8.1}/pyproject.toml

@@ -43,7 +43,7 @@ test = [
     'aiohttp>=3.10.5',
     'flake8>=5,<8',
     'psutil',
-    'pycodestyle>=2.9,<2.15',
+    'pycodestyle>=2.9,<2.16',
     'pyOpenSSL>=23.0,<26.5',
     'mypy>=0.800'
 ]

{winloop-0.8.0 → winloop-0.8.1}/tests/test_process.py

@@ -38,6 +38,30 @@ class _RedirectFD(contextlib.AbstractContextManager):
 
 
 class _TestProcess:
+    @unittest.skipUnless(sys.platform == "win32", "Windows startupinfo")
+    def test_process_startupinfo(self):
+        async def test():
+            startupinfo = subprocess.STARTUPINFO()
+            startupinfo.dwFlags |= subprocess.STARTF_USESHOWWINDOW
+            startupinfo.wShowWindow = subprocess.SW_HIDE
+
+            proc = await asyncio.create_subprocess_exec(
+                sys.executable,
+                "-c",
+                "import sys; sys.stdout.write(sys.stdin.read())",
+                stdin=subprocess.PIPE,
+                stdout=subprocess.PIPE,
+                stderr=subprocess.PIPE,
+                startupinfo=startupinfo,
+            )
+
+            out, err = await proc.communicate(b"startupinfo")
+            self.assertEqual(out, b"startupinfo")
+            self.assertEqual(err, b"")
+            self.assertEqual(proc.returncode, 0)
+
+        self.loop.run_until_complete(test())
+
     def get_num_fds(self):
         # Winloop comment: use num_handles() as a meaningful
         # substitute for num_fds() on Windows.
@@ -940,6 +964,29 @@ print(n)"""
 
 
 class Test_UV_Process(_TestProcess, tb.UVTestCase):
+    @unittest.skipUnless(sys.platform == "win32", "Windows startupinfo")
+    def test_process_startupinfo_unsupported_flags(self):
+        async def test():
+            startupinfo = subprocess.STARTUPINFO()
+            startupinfo.dwFlags |= subprocess.STARTF_USESTDHANDLES
+
+            with self.assertRaisesRegex(ValueError, "startupinfo.dwFlags"):
+                await asyncio.create_subprocess_exec(
+                    sys.executable, "-c", "pass", startupinfo=startupinfo,
+                )
+
+        self.loop.run_until_complete(test())
+
+    @unittest.skipIf(sys.platform == "win32", "POSIX startupinfo validation")
+    def test_process_startupinfo_posix(self):
+        async def test():
+            with self.assertRaisesRegex(ValueError, "startupinfo"):
+                await asyncio.create_subprocess_exec(
+                    sys.executable, "-c", "pass", startupinfo=object(),
+                )
+
+        self.loop.run_until_complete(test())
+
     @unittest.skipIf(sys.platform != "win32", "problem is windows related only")
     def test_windows_issue_153(self):
         """Winloop issue 153 is related to bringing back the shlex parser