feat: add wrap test harness (#185)

Author: Niraj-Kamdar

packages/polywrap-test-cases/.gitignore

@@ -0,0 +1 @@
+wrappers/

packages/polywrap-test-cases/README.md

@@ -0,0 +1,36 @@
+# polywrap-wasm
+
+Python implementation of the plugin wrapper runtime.
+
+## Usage
+
+### Invoke Plugin Wrapper
+
+```python
+from typing import Any, Dict, List, Union, Optional
+from polywrap_manifest import AnyWrapManifest
+from polywrap_plugin import PluginModule
+from polywrap_core import Invoker, Uri, InvokerOptions, UriPackageOrWrapper, Env
+
+class GreetingModule(PluginModule[None]):
+    def __init__(self, config: None):
+        super().__init__(config)
+
+    def greeting(self, args: Dict[str, Any], client: Invoker[UriPackageOrWrapper], env: Optional[Env] = None):
+        return f"Greetings from: {args['name']}"
+
+manifest = cast(AnyWrapManifest, {})
+wrapper = PluginWrapper(greeting_module, manifest)
+args = {
+    "name": "Joe"
+}
+options: InvokeOptions[UriPackageOrWrapper] = InvokeOptions(
+    uri=Uri.from_str("ens/greeting.eth"),
+    method="greeting",
+    args=args
+)
+invoker: Invoker = ...
+
+result = await wrapper.invoke(options, invoker)
+assert result, "Greetings from: Joe"
+```

packages/polywrap-test-cases/poetry.lock

@@ -0,0 +1,39 @@
+"""This package contains the utility functions to fetch the wrappers\
+    from the wasm-test-harness repo."""
+import io
+import os
+import zipfile
+from urllib.error import HTTPError
+from urllib.request import urlopen
+
+
+def get_path_to_test_wrappers() -> str:
+    """Get the path to the test wrappers."""
+    return os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "wrappers"))
+
+
+def fetch_file(url: str) -> bytes:
+    """Fetch a file using HTTP."""
+    with urlopen(url) as response:
+        if response.status != 200:
+            raise HTTPError(
+                url, response.status, "Failed to fetch file", response.headers, None
+            )
+        return response.read()
+
+
+def unzip_file(file_buffer: bytes, destination: str) -> None:
+    """Unzip a file to a destination."""
+    with zipfile.ZipFile(io.BytesIO(file_buffer), "r") as zip_ref:
+        zip_ref.extractall(destination)
+
+
+def fetch_wrappers() -> None:
+    """Fetch the wrappers from the wasm-test-harness repo."""
+    tag = "0.1.0"
+    repo_name = "wasm-test-harness"
+    url = f"https://github.com/polywrap/{repo_name}/releases/download/{tag}/wrappers"
+
+    buffer = fetch_file(url)
+    zip_built_folder = get_path_to_test_wrappers()
+    unzip_file(buffer, zip_built_folder)

packages/polywrap-test-cases/polywrap_test_cases/__init__.py

@@ -0,0 +1,5 @@
+"""This module contains the main entry point of the package."""
+from . import fetch_wrappers
+
+if __name__ == "__main__":
+    fetch_wrappers()

packages/polywrap-test-cases/polywrap_test_cases/__main__.py

@@ -0,0 +1,59 @@
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.poetry]
+name = "polywrap-test-cases"
+version = "0.1.0a29"
+description = "Plugin package"
+authors = ["Cesar <cesar@polywrap.io>"]
+readme = "README.md"
+
+[tool.poetry.dependencies]
+python = "^3.10"
+
+[tool.poetry.dev-dependencies]
+pytest = "^7.1.2"
+pytest-asyncio = "^0.19.0"
+pylint = "^2.15.4"
+black = "^22.10.0"
+bandit = { version = "^1.7.4", extras = ["toml"]}
+tox = "^3.26.0"
+tox-poetry = "^0.4.1"
+isort = "^5.10.1"
+pyright = "^1.1.275"
+pydocstyle = "^6.1.1"
+
+[tool.poetry.group.dev.dependencies]
+pycln = "^2.1.3"
+
+[tool.bandit]
+exclude_dirs = ["tests"]
+skips = ["B310"]
+
+[tool.black]
+target-version = ["py310"]
+
+[tool.pyright]
+typeCheckingMode = "strict"
+reportShadowedImports = false
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = [
+    "tests"
+]
+
+[tool.pylint]
+disable = [
+]
+ignore = [
+    "tests/"
+]
+
+[tool.isort]
+profile = "black"
+multi_line_output = 3
+
+[tool.pydocstyle]
+# default

packages/polywrap-test-cases/polywrap_test_cases/py.typed

@@ -0,0 +1,16 @@
+import os
+from polywrap_test_cases import get_path_to_test_wrappers
+import pytest
+
+
+@pytest.mark.parametrize(
+    "wrapper", ["asyncify", "bigint-type", "enum-type", "map-type"]
+)
+@pytest.mark.parametrize("language", ["as", "rs"])
+def test_wrappers_exist(wrapper: str, language: str):
+    assert os.path.exists(get_path_to_test_wrappers())
+    wrapper_path = os.path.join(get_path_to_test_wrappers(), wrapper, "implementations", language)
+    assert os.path.exists(wrapper_path)
+    assert os.path.isdir(wrapper_path)
+    assert os.path.exists(os.path.join(wrapper_path, "wrap.info"))
+    assert os.path.exists(os.path.join(wrapper_path, "wrap.wasm"))

packages/polywrap-test-cases/pyproject.toml

@@ -0,0 +1,34 @@
+[tox]
+isolated_build = True
+envlist = py310
+
+[testenv]
+commands =
+    python -m polywrap_test_cases
+    pytest tests/
+
+[testenv:getwraps]
+commands = 
+    python -m polywrap_test_cases
+
+[testenv:lint]
+commands =
+    isort --check-only polywrap_test_cases
+    black --check polywrap_test_cases
+    pycln --check polywrap_test_cases --disable-all-dunder-policy
+    pylint polywrap_test_cases
+    pydocstyle polywrap_test_cases
+
+[testenv:typecheck]
+commands = 
+    pyright polywrap_test_cases
+
+[testenv:secure]
+commands = 
+    bandit -r polywrap_test_cases -c pyproject.toml
+
+[testenv:dev]
+commands = 
+    isort polywrap_test_cases
+    black polywrap_test_cases
+    pycln polywrap_test_cases --disable-all-dunder-policy

packages/polywrap-test-cases/tests/test_sanity.py

@@ -39,6 +39,10 @@
       {
         "name": "polywrap-plugin",
         "path": "packages/polywrap-plugin"
+      },
+      {
+        "name": "polywrap-test-cases",
+        "path": "packages/polywrap-test-cases"
       }
   ],
   "settings": {