aio.web: Add app

phlax · phlax · commit 8880c13ff41d · 2023-09-05T10:34:21.000+01:00
Signed-off-by: Ryan Northey &lt;ryan@synca.io&gt;
diff --git a/README.md b/README.md
@@ -120,6 +120,21 @@ pypi: https://pypi.org/project/aio.run.runner
 ---
 
 
+#### [aio.web](aio.web)
+
+version: 0.1.0.dev0
+
+pypi: https://pypi.org/project/aio.web
+
+##### requirements:
+
+- [abstracts](https://pypi.org/project/abstracts) >=0.0.12
+- [aiohttp](https://pypi.org/project/aiohttp)
+- [pyyaml](https://pypi.org/project/pyyaml)
+
+---
+
+
 #### [dependatool](dependatool)
 
 version: 0.2.3.dev0
diff --git a/aio.web/BUILD b/aio.web/BUILD
@@ -0,0 +1,2 @@
+
+toolshed_package("aio.web")
diff --git a/aio.web/README.rst b/aio.web/README.rst
@@ -0,0 +1,5 @@
+
+aio.web
+=======
+
+Web utils for asyncio.
diff --git a/aio.web/VERSION b/aio.web/VERSION
@@ -0,0 +1 @@
+0.1.0-dev
diff --git a/aio.web/aio/web/BUILD b/aio.web/aio/web/BUILD
@@ -0,0 +1,18 @@
+
+toolshed_library(
+    "aio.web",
+    dependencies=[
+        "//deps:reqs#abstracts",
+        "//deps:reqs#aiohttp",
+        "//deps:reqs#pyyaml",
+    ],
+    sources=[
+        "__init__.py",
+        "abstract/__init__.py",
+        "abstract/downloader.py",
+        "downloader.py",
+        "exceptions.py",
+        "interface.py",
+        "typing.py",
+    ],
+)
diff --git a/aio.web/aio/web/__init__.py b/aio.web/aio/web/__init__.py
@@ -0,0 +1,14 @@
+
+from .abstract import (
+    ADownloader,
+    AChecksumDownloader)
+from .interface import (
+    IDownloader,
+    IChecksumDownloader)
+
+
+__all__ = (
+    "ADownloader",
+    "AChecksumDownloader",
+    "IDownloader",
+    "IChecksumDownloader")
diff --git a/aio.web/aio/web/abstract/__init__.py b/aio.web/aio/web/abstract/__init__.py
@@ -0,0 +1,7 @@
+from .downloader import ADownloader, AChecksumDownloader
+
+
+__all__ = (
+    "ADownloader",
+    "AChecksumDownloader",
+)
diff --git a/aio.web/aio/web/abstract/downloader.py b/aio.web/aio/web/abstract/downloader.py
@@ -0,0 +1,20 @@
+
+import abstracts
+
+from aio.web import interface
+
+
+@abstracts.implementer(interface.IDownloader)
+class ADownloader(metaclass=abstracts.Abstraction):
+
+    async def download(self):
+        """Download content from the interwebs."""
+        pass
+
+
+@abstracts.implementer(interface.IChecksumDownloader)
+class AChecksumDownloader(ADownloader, metaclass=abstracts.Abstraction):
+
+    async def checksum(self):
+        """Download content from the interwebs."""
+        pass
diff --git a/aio.web/aio/web/downloader.py b/aio.web/aio/web/downloader.py
@@ -0,0 +1,14 @@
+
+import abstracts
+
+from aio.web import abstract
+
+
+@abstracts.implementer(abstract.ADownloader)
+class Downloader:
+    pass
+
+
+@abstracts.implementer(abstract.AChecksumDownloader)
+class ChecksumDownloader:
+    pass
diff --git a/aio.web/aio/web/exceptions.py b/aio.web/aio/web/exceptions.py
@@ -0,0 +1,7 @@
+
+class ChecksumError(Exception):
+    pass
+
+
+class DownloadError(Exception):
+    pass
diff --git a/aio.web/aio/web/interface.py b/aio.web/aio/web/interface.py
@@ -0,0 +1,18 @@
+
+import abstracts
+
+
+class IDownloader(metaclass=abstracts.Interface):
+
+    @abstracts.interfacemethod
+    async def download(self) -> int:
+        """Download content from the interwebs."""
+        raise NotImplementedError
+
+
+class IChecksumDownloader(IDownloader, metaclass=abstracts.Interface):
+
+    @abstracts.interfacemethod
+    async def checksum(self, content) -> int:
+        """Checksum some content."""
+        raise NotImplementedError
diff --git a/aio.web/aio/web/py.typed b/aio.web/aio/web/py.typed
diff --git a/aio.web/aio/web/typing.py b/aio.web/aio/web/typing.py
diff --git a/aio.web/setup.cfg b/aio.web/setup.cfg
@@ -0,0 +1,55 @@
+[metadata]
+name = aio.web
+version = file: VERSION
+author = Ryan Northey
+author_email = ryan@synca.io
+maintainer = Ryan Northey
+maintainer_email = ryan@synca.io
+license = Apache Software License 2.0
+url = https://github.com/envoyproxy/toolshed/tree/main/aio.web
+description = A collection of functional utils for asyncio
+long_description = file: README.rst
+classifiers =
+    Development Status :: 4 - Beta
+    Framework :: Pytest
+    Intended Audience :: Developers
+    Topic :: Software Development :: Testing
+    Programming Language :: Python
+    Programming Language :: Python :: 3
+    Programming Language :: Python :: 3.8
+    Programming Language :: Python :: 3.9
+    Programming Language :: Python :: 3 :: Only
+    Programming Language :: Python :: Implementation :: CPython
+    Operating System :: OS Independent
+    License :: OSI Approved :: Apache Software License
+
+[options]
+python_requires = >=3.8
+py_modules = aio.web
+packages = find_namespace:
+install_requires =
+    abstracts>=0.0.12
+    aiohttp
+    pyyaml
+
+[options.extras_require]
+test =
+    pytest
+    pytest-asyncio
+    pytest-coverage
+    pytest-iters
+    pytest-patches
+lint = flake8
+types =
+    mypy
+publish = wheel
+
+[options.package_data]
+* = py.typed
+
+[options.packages.find]
+include = aio.*
+exclude =
+    build.*
+    tests.*
+    dist.*
diff --git a/aio.web/setup.py b/aio.web/setup.py
@@ -0,0 +1,5 @@
+#!/usr/bin/env python
+
+from setuptools import setup  # type:ignore
+
+setup()
diff --git a/aio.web/tests/BUILD b/aio.web/tests/BUILD
@@ -0,0 +1,10 @@
+
+toolshed_tests(
+    "aio.web",
+    dependencies=[
+        "//deps:reqs#abstracts",
+        "//deps:reqs#aiohttp",
+        "//deps:reqs#pyyaml",
+        "//deps:reqs#pytest-asyncio",
+    ],
+)
diff --git a/aio.web/tests/test_downloader.py b/aio.web/tests/test_downloader.py
@@ -0,0 +1,19 @@
+
+from aio.web import abstract, downloader
+
+
+def test_downloader_constructor(patches):
+    args = tuple(f"ARG{i}" for i in range(0, 3))
+    kwargs = {f"K{i}": f"V{i}" for i in range(0, 3)}
+    patched = patches(
+        "abstract.ADownloader.__init__",
+        prefix="aio.web.downloader")
+
+    with patched as (m_super, ):
+        m_super.return_value = None
+        dl = downloader.Downloader(*args, **kwargs)
+
+    assert isinstance(dl, abstract.ADownloader)
+    assert (
+        m_super.call_args
+        == [args, kwargs])

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
++
 +aio.web
 +=======
++
 +Web utils for asyncio.