Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
48 commits
Select commit Hold shift + click to select a range
48be658
refactor: polywrap-msgpack package
Niraj-Kamdar Jun 3, 2023
a83969a
refactor: polywrap-manifest package
Niraj-Kamdar Jun 3, 2023
f8d7853
refactor: polywrap-core package
Niraj-Kamdar Jun 3, 2023
011ebf9
refactor: polywrap-core docs
Niraj-Kamdar Jun 5, 2023
773f10b
refactor: polywrap-wasm package
Niraj-Kamdar Jun 5, 2023
c7a6317
refactor: polywrap-plugin package
Niraj-Kamdar Jun 5, 2023
5df78c1
feat: add unit-tests for remaining functions
Niraj-Kamdar Jun 6, 2023
febebb3
feat: add wrap test harness
Niraj-Kamdar Jun 5, 2023
082c1de
fix: skipping trivial CVE for now
Niraj-Kamdar Jun 5, 2023
ca863de
fix: test-cases tests
Niraj-Kamdar Jun 5, 2023
743fd8a
refactor: polywrap-uri-resolvers
Niraj-Kamdar Jun 5, 2023
6a9a173
refactor: polywrap-client
Niraj-Kamdar Jun 5, 2023
8b9c164
refactor: polywrap-client-config-builder package
Niraj-Kamdar Jun 6, 2023
c66bfeb
fix: typing issue
Niraj-Kamdar Jun 5, 2023
5147e6a
wip: config-builder tests
Niraj-Kamdar Jun 7, 2023
b885018
feat(client-config-builder): add env tests
Niraj-Kamdar Jun 8, 2023
a9ff0e9
wip: add interface tests
Niraj-Kamdar Jun 8, 2023
7bb7700
feat: complete interface tests
Niraj-Kamdar Jun 8, 2023
bf83473
feat: add package tests
Niraj-Kamdar Jun 8, 2023
f4ffd1d
feat: add wrapper tests
Niraj-Kamdar Jun 8, 2023
16939d6
feat: add redirect tests
Niraj-Kamdar Jun 8, 2023
58fe236
feat: add resolver tests
Niraj-Kamdar Jun 10, 2023
a1e7421
refactor: black fixes
Niraj-Kamdar Jun 10, 2023
bba3a07
debug: try adjusting examples produced with strategies
Niraj-Kamdar Jun 10, 2023
970903f
debug: adjusting assumptions
Niraj-Kamdar Jun 10, 2023
9442be4
fix: docs
Niraj-Kamdar Jun 11, 2023
088fd65
chore: remove unnecessary tox file
Niraj-Kamdar Jun 11, 2023
316a3ee
feat: add readthedocs.yaml
Niraj-Kamdar Jun 11, 2023
0ad13a5
debug: try fix
Niraj-Kamdar Jun 11, 2023
755eb3c
debug
Niraj-Kamdar Jun 11, 2023
85c84a6
debug
Niraj-Kamdar Jun 11, 2023
d4429a6
feat: add examples and doctest to test those
Niraj-Kamdar Jun 13, 2023
e02d8ba
docs: improve msgpack docs
Niraj-Kamdar Jun 13, 2023
4c7c4ca
chore: updating core for better docs
Niraj-Kamdar Jun 13, 2023
2c358f3
wip:docs
Niraj-Kamdar Jun 13, 2023
e5c3599
fix: docs
Niraj-Kamdar Jun 13, 2023
a90b90d
docs: improve documentation
Niraj-Kamdar Jun 13, 2023
78d917f
feat: improve docs
Niraj-Kamdar Jun 14, 2023
7342151
feat: improve docs
Niraj-Kamdar Jun 14, 2023
71c0b64
feat: export errors from polywrap msgpack
Niraj-Kamdar Jun 14, 2023
231c526
feat: remove pycln from polywrap-msgpack
Niraj-Kamdar Jun 14, 2023
09d1d4e
fix: client-config-builder types
Niraj-Kamdar Jun 14, 2023
7e60731
fix: typing and linting issues
Niraj-Kamdar Jun 14, 2023
09dabaa
fix: typing issue
Niraj-Kamdar Jun 14, 2023
aa09e71
fix: typing issues in polywrap-uri-resolvers
Niraj-Kamdar Jun 14, 2023
cb79ccf
feat: add errors in the docstring
Niraj-Kamdar Jun 14, 2023
f3fd32d
chore: remove the unnecessary files
Niraj-Kamdar Jun 14, 2023
282184d
Merge remote-tracking branch 'origin/dev' into nk/refactor-docs
Niraj-Kamdar Jun 14, 2023
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 43 additions & 0 deletions .readthedocs.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
# .readthedocs.yaml
# Read the Docs configuration file
# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details

# Required
version: 2

# Set the OS, Python version and other tools you might need
build:
os: ubuntu-22.04
tools:
python: "3.10"
# You can also specify other tool versions:
# nodejs: "19"
# rust: "1.64"
# golang: "1.19"
jobs:
post_create_environment:
# Install poetry
# https://python-poetry.org/docs/#installing-manually
- pip install poetry
# Tell poetry to not use a virtual environment
- poetry config virtualenvs.create false
post_install:
# Install dependencies with 'docs' dependency group
# https://python-poetry.org/docs/managing-dependencies/#dependency-groups
- cd docs && poetry install && cd ..

# Build documentation in the "docs/" directory with Sphinx
sphinx:
configuration: docs/source/conf.py

# Optionally build your docs in additional formats such as PDF and ePub
# formats:
# - pdf
# - epub

# Optional but recommended, declare the Python requirements required
# to build your documentation
# See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
# python:
# install:
# - requirements: docs/requirements.txt
1 change: 1 addition & 0 deletions docs/build.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
sphinx-build source/ build
1 change: 1 addition & 0 deletions docs/clean.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
rm -Rf ./source/**/*.rst
8 changes: 8 additions & 0 deletions docs/docgen.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
sphinx-apidoc ../packages/polywrap-msgpack/polywrap_msgpack -o ./source/polywrap-msgpack -e
sphinx-apidoc ../packages/polywrap-manifest/polywrap_manifest -o ./source/polywrap-manifest -e
sphinx-apidoc ../packages/polywrap-core/polywrap_core -o ./source/polywrap-core -e
sphinx-apidoc ../packages/polywrap-wasm/polywrap_wasm -o ./source/polywrap-wasm -e
sphinx-apidoc ../packages/polywrap-plugin/polywrap_plugin -o ./source/polywrap-plugin -e
sphinx-apidoc ../packages/polywrap-uri-resolvers/polywrap_uri_resolvers -o ./source/polywrap-uri-resolvers -e
sphinx-apidoc ../packages/polywrap-client/polywrap_client -o ./source/polywrap-client -e
sphinx-apidoc ../packages/polywrap-client-config-builder/polywrap_client_config_builder -o ./source/polywrap-client-config-builder -e
497 changes: 136 additions & 361 deletions docs/poetry.lock

Large diffs are not rendered by default.

4 changes: 1 addition & 3 deletions docs/pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,6 @@ name = "docs"
version = "0.1.0"
description = ""
authors = ["Niraj <niraj@polywrap.io>"]
readme = "README.md"

[tool.poetry.dependencies]
python = "^3.10"
Expand All @@ -22,5 +21,4 @@ polywrap-client-config-builder = { path = "../packages/polywrap-client-config-bu

[tool.poetry.group.dev.dependencies]
sphinx = "^6.1.3"
sphinx-rtd-theme = "^1.2.0"

sphinx-rtd-theme = "^1.2.0"
3 changes: 1 addition & 2 deletions docs/source/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ Welcome to polywrap-client's documentation!
===========================================

.. toctree::
:maxdepth: 2
:maxdepth: 1
:caption: Contents:

polywrap-msgpack/modules.rst
Expand All @@ -20,7 +20,6 @@ Welcome to polywrap-client's documentation!
polywrap-client-config-builder/modules.rst



Indices and tables
==================

Expand Down
7 changes: 0 additions & 7 deletions docs/source/polywrap-core/polywrap_core.types.invoke_args.rst

This file was deleted.

Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
polywrap\_core.types.invoke\_options module
===========================================

.. automodule:: polywrap_core.types.invoke_options
:members:
:undoc-members:
:show-inheritance:

This file was deleted.

This file was deleted.

This file was deleted.

21 changes: 0 additions & 21 deletions docs/source/polywrap-core/polywrap_core.types.options.rst

This file was deleted.

This file was deleted.

12 changes: 1 addition & 11 deletions docs/source/polywrap-core/polywrap_core.types.rst
Original file line number Diff line number Diff line change
@@ -1,14 +1,6 @@
polywrap\_core.types package
============================

Subpackages
-----------

.. toctree::
:maxdepth: 4

polywrap_core.types.options

Submodules
----------

Expand All @@ -17,15 +9,13 @@ Submodules

polywrap_core.types.client
polywrap_core.types.config
polywrap_core.types.env
polywrap_core.types.errors
polywrap_core.types.file_reader
polywrap_core.types.invocable
polywrap_core.types.invoke_args
polywrap_core.types.invoke_options
polywrap_core.types.invoker
polywrap_core.types.invoker_client
polywrap_core.types.uri
polywrap_core.types.uri_like
polywrap_core.types.uri_package
polywrap_core.types.uri_package_wrapper
polywrap_core.types.uri_resolution_context
Expand Down
7 changes: 0 additions & 7 deletions docs/source/polywrap-core/polywrap_core.types.uri_like.rst

This file was deleted.

Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
polywrap\_core.utils.build\_clean\_uri\_history module
======================================================

.. automodule:: polywrap_core.utils.build_clean_uri_history
:members:
:undoc-members:
:show-inheritance:
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
polywrap\_core.utils.get\_env\_from\_resolution\_path module
============================================================

.. automodule:: polywrap_core.utils.get_env_from_resolution_path
:members:
:undoc-members:
:show-inheritance:
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
polywrap\_core.utils.get\_implementations module
================================================

.. automodule:: polywrap_core.utils.get_implementations
:members:
:undoc-members:
:show-inheritance:
7 changes: 0 additions & 7 deletions docs/source/polywrap-core/polywrap_core.utils.instance_of.rst

This file was deleted.

7 changes: 0 additions & 7 deletions docs/source/polywrap-core/polywrap_core.utils.maybe_async.rst

This file was deleted.

5 changes: 3 additions & 2 deletions docs/source/polywrap-core/polywrap_core.utils.rst
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,9 @@ Submodules
.. toctree::
:maxdepth: 4

polywrap_core.utils.instance_of
polywrap_core.utils.maybe_async
polywrap_core.utils.build_clean_uri_history
polywrap_core.utils.get_env_from_resolution_path
polywrap_core.utils.get_implementations

Module contents
---------------
Expand Down
7 changes: 7 additions & 0 deletions docs/source/polywrap-manifest/polywrap_manifest.errors.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
polywrap\_manifest.errors module
================================

.. automodule:: polywrap_manifest.errors
:members:
:undoc-members:
:show-inheritance:
1 change: 1 addition & 0 deletions docs/source/polywrap-manifest/polywrap_manifest.rst
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ Submodules
:maxdepth: 4

polywrap_manifest.deserialize
polywrap_manifest.errors
polywrap_manifest.manifest
polywrap_manifest.wrap_0_1

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
polywrap\_core.types.env module
polywrap\_msgpack.errors module
===============================

.. automodule:: polywrap_core.types.env
.. automodule:: polywrap_msgpack.errors
:members:
:undoc-members:
:show-inheritance:
1 change: 1 addition & 0 deletions docs/source/polywrap-msgpack/polywrap_msgpack.rst
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,7 @@ Submodules

polywrap_msgpack.decoder
polywrap_msgpack.encoder
polywrap_msgpack.errors
polywrap_msgpack.sanitize

Module contents
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
polywrap\_plugin.resolution\_context\_override\_client module
=============================================================

.. automodule:: polywrap_plugin.resolution_context_override_client
:members:
:undoc-members:
:show-inheritance:
1 change: 1 addition & 0 deletions docs/source/polywrap-plugin/polywrap_plugin.rst
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ Submodules

polywrap_plugin.module
polywrap_plugin.package
polywrap_plugin.resolution_context_override_client
polywrap_plugin.wrapper

Module contents
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ Submodules
:maxdepth: 4

polywrap_uri_resolvers.resolvers.aggregator.uri_resolver_aggregator
polywrap_uri_resolvers.resolvers.aggregator.uri_resolver_aggregator_base

Module contents
---------------
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
polywrap\_uri\_resolvers.resolvers.aggregator.uri\_resolver\_aggregator\_base module
====================================================================================

.. automodule:: polywrap_uri_resolvers.resolvers.aggregator.uri_resolver_aggregator_base
:members:
:undoc-members:
:show-inheritance:

This file was deleted.

Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
polywrap\_uri\_resolvers.resolvers.cache.resolution\_result\_cache\_resolver module
===================================================================================

.. automodule:: polywrap_uri_resolvers.resolvers.cache.resolution_result_cache_resolver
:members:
:undoc-members:
:show-inheritance:
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,7 @@ Submodules
.. toctree::
:maxdepth: 4

polywrap_uri_resolvers.resolvers.cache.cache_resolver
polywrap_uri_resolvers.resolvers.cache.request_synchronizer_resolver
polywrap_uri_resolvers.resolvers.cache.resolution_result_cache_resolver

Module contents
---------------
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
polywrap\_uri\_resolvers.resolvers.cache.request\_synchronizer\_resolver module
polywrap\_uri\_resolvers.resolvers.legacy.package\_to\_wrapper\_resolver module
===============================================================================

.. automodule:: polywrap_uri_resolvers.resolvers.cache.request_synchronizer_resolver
.. automodule:: polywrap_uri_resolvers.resolvers.legacy.package_to_wrapper_resolver
:members:
:undoc-members:
:show-inheritance:
Original file line number Diff line number Diff line change
@@ -1,6 +1,14 @@
polywrap\_uri\_resolvers.resolvers.legacy package
=================================================

Subpackages
-----------

.. toctree::
:maxdepth: 4

polywrap_uri_resolvers.resolvers.legacy.wrapper_cache

Submodules
----------

Expand All @@ -9,7 +17,9 @@ Submodules

polywrap_uri_resolvers.resolvers.legacy.base_resolver
polywrap_uri_resolvers.resolvers.legacy.fs_resolver
polywrap_uri_resolvers.resolvers.legacy.package_to_wrapper_resolver
polywrap_uri_resolvers.resolvers.legacy.redirect_resolver
polywrap_uri_resolvers.resolvers.legacy.wrapper_cache_resolver

Module contents
---------------
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
polywrap\_uri\_resolvers.resolvers.legacy.wrapper\_cache.in\_memory\_wrapper\_cache module
==========================================================================================

.. automodule:: polywrap_uri_resolvers.resolvers.legacy.wrapper_cache.in_memory_wrapper_cache
:members:
:undoc-members:
:show-inheritance:
Loading