From 057e20163d2676e9f6e1510ee81d313199152aee Mon Sep 17 00:00:00 2001 From: "Sam G." Date: Thu, 28 Mar 2024 23:11:30 -0700 Subject: [PATCH] initial commit --- .python-version | 1 + MANIFEST.in | 0 Makefile | 16 + README.md | 21 + .../co3/__init__.py | 1 + .../co3/accessor.py | 1 + .../co3/accessors/__init__.py | 1 + .../co3/accessors/fts.py | 1 + .../co3/accessors/sql.py | 1 + .../co3/accessors/vss.py | 1 + .../co3/co3.py | 1 + .../co3/collector.py | 1 + .../co3/composer.py | 1 + .../co3/database.py | 1 + .../co3/databases/__init__.py | 1 + .../co3/databases/fts.py | 1 + .../co3/databases/sql.py | 1 + .../co3/databases/vss.py | 1 + .../co3/indexer.py | 1 + .../co3/manager.py | 1 + .../co3/managers/__init__.py | 1 + .../co3/managers/fts.py | 1 + .../co3/managers/sql.py | 1 + .../co3/managers/vss.py | 1 + .../co3/mapper.py | 1 + .../co3/relation.py | 1 + .../co3/relations/__init__.py | 1 + .../co3/util/__init__.py | 1 + .../co3/util/db.py | 1 + .../co3/util/regex.py | 1 + .../co4/__init__.py | 1 + .../co4/accessor.py | 1 + .../co4/accessors/__init__.py | 1 + .../co4/accessors/fts.py | 1 + .../co4/accessors/table.py | 1 + .../co4/accessors/vss.py | 1 + .../co4/co4.py | 1 + .../co4/collector.py | 1 + .../co4/composer.py | 1 + .../co4/databases/__init__.py | 1 + .../co4/databases/_base.py | 1 + .../co4/databases/core.py | 1 + .../co4/databases/fts.py | 1 + .../co4/databases/vss.py | 1 + .../co4/indexer.py | 1 + .../co4/manager.py | 1 + .../co4/managers/__init__.py | 1 + .../co4/managers/core.py | 1 + .../co4/managers/fts.py | 1 + .../co4/managers/vss.py | 1 + .../co4/utils/db.py | 1 + .../co4/utils/paths.py | 1 + co3.egg-info/PKG-INFO | 30 + co3.egg-info/SOURCES.txt | 34 + co3.egg-info/dependency_links.txt | 1 + co3.egg-info/requires.txt | 1 + co3.egg-info/top_level.txt | 1 + co3/__init__.py | 109 +++ co3/__pycache__/__init__.cpython-311.pyc | Bin 0 -> 4735 bytes co3/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 4929 bytes co3/__pycache__/accessor.cpython-311.pyc | Bin 0 -> 1921 bytes co3/__pycache__/accessor.cpython-312.pyc | Bin 0 -> 1563 bytes co3/__pycache__/co3.cpython-312.pyc | Bin 0 -> 4577 bytes co3/__pycache__/co4.cpython-311.pyc | Bin 0 -> 9350 bytes co3/__pycache__/collector.cpython-311.pyc | Bin 0 -> 5939 bytes co3/__pycache__/collector.cpython-312.pyc | Bin 0 -> 5485 bytes co3/__pycache__/composer.cpython-311.pyc | Bin 0 -> 4226 bytes co3/__pycache__/composer.cpython-312.pyc | Bin 0 -> 4393 bytes co3/__pycache__/database.cpython-312.pyc | Bin 0 -> 3967 bytes co3/__pycache__/indexer.cpython-311.pyc | Bin 0 -> 16212 bytes co3/__pycache__/indexer.cpython-312.pyc | Bin 0 -> 15090 bytes co3/__pycache__/manager.cpython-311.pyc | Bin 0 -> 1611 bytes co3/__pycache__/manager.cpython-312.pyc | Bin 0 -> 2097 bytes co3/__pycache__/mapper.cpython-312.pyc | Bin 0 -> 8703 bytes co3/__pycache__/relation.cpython-312.pyc | Bin 0 -> 2163 bytes co3/accessor.py | 28 + co3/accessors/__init__.py | 24 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 1632 bytes .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 1570 bytes .../__pycache__/_base.cpython-311.pyc | Bin 0 -> 2329 bytes co3/accessors/__pycache__/fts.cpython-311.pyc | Bin 0 -> 6623 bytes co3/accessors/__pycache__/fts.cpython-312.pyc | Bin 0 -> 6149 bytes co3/accessors/__pycache__/sql.cpython-312.pyc | Bin 0 -> 5255 bytes .../__pycache__/table.cpython-311.pyc | Bin 0 -> 3851 bytes co3/accessors/__pycache__/vss.cpython-311.pyc | Bin 0 -> 4799 bytes co3/accessors/__pycache__/vss.cpython-312.pyc | Bin 0 -> 4247 bytes co3/accessors/fts.py | 147 +++ co3/accessors/sql.py | 96 ++ co3/accessors/vss.py | 100 ++ co3/co3.py | 106 ++ co3/collector.py | 109 +++ co3/composer.py | 89 ++ co3/database.py | 87 ++ co3/databases/__init__.py | 3 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 335 bytes .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 311 bytes .../__pycache__/_base.cpython-311.pyc | Bin 0 -> 3140 bytes .../__pycache__/core.cpython-311.pyc | Bin 0 -> 5703 bytes co3/databases/__pycache__/fts.cpython-311.pyc | Bin 0 -> 787 bytes co3/databases/__pycache__/fts.cpython-312.pyc | Bin 0 -> 537 bytes co3/databases/__pycache__/sql.cpython-312.pyc | Bin 0 -> 3034 bytes co3/databases/__pycache__/vss.cpython-312.pyc | Bin 0 -> 537 bytes co3/databases/fts.py | 8 + co3/databases/sql.py | 34 + co3/databases/vss.py | 9 + co3/indexer.py | 433 ++++++++ co3/manager.py | 38 + co3/managers/__init__.py | 3 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 175 bytes .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 321 bytes .../__pycache__/_base.cpython-311.pyc | Bin 0 -> 2434 bytes co3/managers/__pycache__/core.cpython-311.pyc | Bin 0 -> 20298 bytes co3/managers/__pycache__/fts.cpython-311.pyc | Bin 0 -> 9776 bytes co3/managers/__pycache__/fts.cpython-312.pyc | Bin 0 -> 10130 bytes co3/managers/__pycache__/sql.cpython-312.pyc | Bin 0 -> 18544 bytes co3/managers/__pycache__/vss.cpython-312.pyc | Bin 0 -> 6451 bytes co3/managers/fts.py | 216 ++++ co3/managers/sql.py | 383 ++++++++ co3/managers/vss.py | 142 +++ co3/mapper.py | 208 ++++ co3/relation.py | 37 + co3/relations/__init__.py | 16 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 1269 bytes co3/util/__init__.py | 2 + co3/util/__pycache__/__init__.cpython-311.pyc | Bin 0 -> 266 bytes co3/util/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 226 bytes co3/util/__pycache__/db.cpython-311.pyc | Bin 0 -> 17611 bytes co3/util/__pycache__/db.cpython-312.pyc | Bin 0 -> 14828 bytes co3/util/__pycache__/paths.cpython-311.pyc | Bin 0 -> 3879 bytes co3/util/__pycache__/regex.cpython-311.pyc | Bin 0 -> 549 bytes co3/util/__pycache__/regex.cpython-312.pyc | Bin 0 -> 499 bytes co3/util/db.py | 375 +++++++ co3/util/regex.py | 7 + docs/Makefile | 20 + docs/_autoref/co4.accessors.rst | 34 + docs/_autoref/co4.collectors.rst | 18 + docs/_autoref/co4.composers.rst | 26 + docs/_autoref/co4.databases.rst | 34 + docs/_autoref/co4.managers.rst | 34 + docs/_autoref/co4.rst | 70 ++ docs/_autoref/modules.rst | 7 + .../doctrees/_autoref/co4.accessors.doctree | Bin 0 -> 3542 bytes .../doctrees/_autoref/co4.collectors.doctree | Bin 0 -> 2999 bytes .../doctrees/_autoref/co4.composers.doctree | Bin 0 -> 3264 bytes .../doctrees/_autoref/co4.databases.doctree | Bin 0 -> 3538 bytes docs/_build/doctrees/_autoref/co4.doctree | Bin 0 -> 4902 bytes .../doctrees/_autoref/co4.managers.doctree | Bin 0 -> 3521 bytes docs/_build/doctrees/_autoref/modules.doctree | Bin 0 -> 2754 bytes docs/_build/doctrees/environment.pickle | Bin 0 -> 87074 bytes docs/_build/doctrees/index.doctree | Bin 0 -> 4510 bytes .../reference/documentation/index.doctree | Bin 0 -> 3154 bytes .../reference/documentation/sphinx.doctree | Bin 0 -> 21759 bytes docs/_build/html/.buildinfo | 4 + docs/_build/html/_autoref/co4.accessors.html | 300 ++++++ docs/_build/html/_autoref/co4.collectors.html | 292 ++++++ docs/_build/html/_autoref/co4.composers.html | 296 ++++++ docs/_build/html/_autoref/co4.databases.html | 300 ++++++ docs/_build/html/_autoref/co4.html | 352 +++++++ docs/_build/html/_autoref/co4.managers.html | 300 ++++++ docs/_build/html/_autoref/modules.html | 297 ++++++ .../_sources/_autoref/co4.accessors.rst.txt | 34 + .../_sources/_autoref/co4.collectors.rst.txt | 18 + .../_sources/_autoref/co4.composers.rst.txt | 26 + .../_sources/_autoref/co4.databases.rst.txt | 34 + .../_sources/_autoref/co4.managers.rst.txt | 34 + .../_build/html/_sources/_autoref/co4.rst.txt | 70 ++ .../html/_sources/_autoref/modules.rst.txt | 7 + docs/_build/html/_sources/index.md.txt | 24 + .../reference/documentation/index.md.txt | 8 + .../reference/documentation/sphinx.md.txt | 111 +++ docs/_build/html/_static/basic.css | 925 ++++++++++++++++++ docs/_build/html/_static/debug.css | 69 ++ docs/_build/html/_static/doctools.js | 156 +++ .../html/_static/documentation_options.js | 13 + docs/_build/html/_static/file.png | Bin 0 -> 286 bytes docs/_build/html/_static/language_data.js | 199 ++++ docs/_build/html/_static/minus.png | Bin 0 -> 90 bytes docs/_build/html/_static/plus.png | Bin 0 -> 90 bytes docs/_build/html/_static/pygments.css | 258 +++++ .../html/_static/scripts/furo-extensions.js | 0 docs/_build/html/_static/scripts/furo.js | 3 + .../html/_static/scripts/furo.js.LICENSE.txt | 7 + docs/_build/html/_static/scripts/furo.js.map | 1 + docs/_build/html/_static/searchtools.js | 574 +++++++++++ docs/_build/html/_static/skeleton.css | 296 ++++++ docs/_build/html/_static/sphinx_highlight.js | 154 +++ .../html/_static/styles/furo-extensions.css | 2 + .../_static/styles/furo-extensions.css.map | 1 + docs/_build/html/_static/styles/furo.css | 2 + docs/_build/html/_static/styles/furo.css.map | 1 + docs/_build/html/genindex.html | 247 +++++ docs/_build/html/index.html | 306 ++++++ docs/_build/html/objects.inv | 5 + .../html/reference/documentation/index.html | 268 +++++ .../html/reference/documentation/sphinx.html | 384 ++++++++ docs/_build/html/search.html | 255 +++++ docs/_build/html/searchindex.js | 1 + docs/conf.py | 35 + docs/index.md | 24 + docs/make.bat | 35 + docs/reference/documentation/index.md | 8 + docs/reference/documentation/sphinx.md | 111 +++ pyproject.toml | 27 + requirements.txt | 8 + tests/co4_example.py | 47 + tests/imports.py | 20 + 206 files changed, 10154 insertions(+) create mode 100644 .python-version create mode 100644 MANIFEST.in create mode 100644 Makefile create mode 100644 README.md create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/__init__.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/accessor.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/accessors/__init__.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/accessors/fts.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/accessors/sql.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/accessors/vss.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/co3.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/collector.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/composer.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/database.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/databases/__init__.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/databases/fts.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/databases/sql.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/databases/vss.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/indexer.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/manager.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/managers/__init__.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/managers/fts.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/managers/sql.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/managers/vss.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/mapper.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/relation.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/relations/__init__.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/util/__init__.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/util/db.py create mode 120000 build/__editable__.co3-0.1.1-py3-none-any/co3/util/regex.py create mode 120000 build/__editable__.co4-0.1.1-py3-none-any/co4/__init__.py create mode 120000 build/__editable__.co4-0.1.1-py3-none-any/co4/accessor.py create mode 120000 build/__editable__.co4-0.1.1-py3-none-any/co4/accessors/__init__.py create mode 120000 build/__editable__.co4-0.1.1-py3-none-any/co4/accessors/fts.py create mode 120000 build/__editable__.co4-0.1.1-py3-none-any/co4/accessors/table.py create mode 120000 build/__editable__.co4-0.1.1-py3-none-any/co4/accessors/vss.py create mode 120000 build/__editable__.co4-0.1.1-py3-none-any/co4/co4.py create mode 120000 build/__editable__.co4-0.1.1-py3-none-any/co4/collector.py create mode 120000 build/__editable__.co4-0.1.1-py3-none-any/co4/composer.py create mode 120000 build/__editable__.co4-0.1.1-py3-none-any/co4/databases/__init__.py create mode 120000 build/__editable__.co4-0.1.1-py3-none-any/co4/databases/_base.py create mode 120000 build/__editable__.co4-0.1.1-py3-none-any/co4/databases/core.py create mode 120000 build/__editable__.co4-0.1.1-py3-none-any/co4/databases/fts.py create mode 120000 build/__editable__.co4-0.1.1-py3-none-any/co4/databases/vss.py create mode 120000 build/__editable__.co4-0.1.1-py3-none-any/co4/indexer.py create mode 120000 build/__editable__.co4-0.1.1-py3-none-any/co4/manager.py create mode 120000 build/__editable__.co4-0.1.1-py3-none-any/co4/managers/__init__.py create mode 120000 build/__editable__.co4-0.1.1-py3-none-any/co4/managers/core.py create mode 120000 build/__editable__.co4-0.1.1-py3-none-any/co4/managers/fts.py create mode 120000 build/__editable__.co4-0.1.1-py3-none-any/co4/managers/vss.py create mode 120000 build/__editable__.co4-0.1.1-py3-none-any/co4/utils/db.py create mode 120000 build/__editable__.co4-0.1.1-py3-none-any/co4/utils/paths.py create mode 100644 co3.egg-info/PKG-INFO create mode 100644 co3.egg-info/SOURCES.txt create mode 100644 co3.egg-info/dependency_links.txt create mode 100644 co3.egg-info/requires.txt create mode 100644 co3.egg-info/top_level.txt create mode 100644 co3/__init__.py create mode 100644 co3/__pycache__/__init__.cpython-311.pyc create mode 100644 co3/__pycache__/__init__.cpython-312.pyc create mode 100644 co3/__pycache__/accessor.cpython-311.pyc create mode 100644 co3/__pycache__/accessor.cpython-312.pyc create mode 100644 co3/__pycache__/co3.cpython-312.pyc create mode 100644 co3/__pycache__/co4.cpython-311.pyc create mode 100644 co3/__pycache__/collector.cpython-311.pyc create mode 100644 co3/__pycache__/collector.cpython-312.pyc create mode 100644 co3/__pycache__/composer.cpython-311.pyc create mode 100644 co3/__pycache__/composer.cpython-312.pyc create mode 100644 co3/__pycache__/database.cpython-312.pyc create mode 100644 co3/__pycache__/indexer.cpython-311.pyc create mode 100644 co3/__pycache__/indexer.cpython-312.pyc create mode 100644 co3/__pycache__/manager.cpython-311.pyc create mode 100644 co3/__pycache__/manager.cpython-312.pyc create mode 100644 co3/__pycache__/mapper.cpython-312.pyc create mode 100644 co3/__pycache__/relation.cpython-312.pyc create mode 100644 co3/accessor.py create mode 100644 co3/accessors/__init__.py create mode 100644 co3/accessors/__pycache__/__init__.cpython-311.pyc create mode 100644 co3/accessors/__pycache__/__init__.cpython-312.pyc create mode 100644 co3/accessors/__pycache__/_base.cpython-311.pyc create mode 100644 co3/accessors/__pycache__/fts.cpython-311.pyc create mode 100644 co3/accessors/__pycache__/fts.cpython-312.pyc create mode 100644 co3/accessors/__pycache__/sql.cpython-312.pyc create mode 100644 co3/accessors/__pycache__/table.cpython-311.pyc create mode 100644 co3/accessors/__pycache__/vss.cpython-311.pyc create mode 100644 co3/accessors/__pycache__/vss.cpython-312.pyc create mode 100644 co3/accessors/fts.py create mode 100644 co3/accessors/sql.py create mode 100644 co3/accessors/vss.py create mode 100644 co3/co3.py create mode 100644 co3/collector.py create mode 100644 co3/composer.py create mode 100644 co3/database.py create mode 100644 co3/databases/__init__.py create mode 100644 co3/databases/__pycache__/__init__.cpython-311.pyc create mode 100644 co3/databases/__pycache__/__init__.cpython-312.pyc create mode 100644 co3/databases/__pycache__/_base.cpython-311.pyc create mode 100644 co3/databases/__pycache__/core.cpython-311.pyc create mode 100644 co3/databases/__pycache__/fts.cpython-311.pyc create mode 100644 co3/databases/__pycache__/fts.cpython-312.pyc create mode 100644 co3/databases/__pycache__/sql.cpython-312.pyc create mode 100644 co3/databases/__pycache__/vss.cpython-312.pyc create mode 100644 co3/databases/fts.py create mode 100644 co3/databases/sql.py create mode 100644 co3/databases/vss.py create mode 100644 co3/indexer.py create mode 100644 co3/manager.py create mode 100644 co3/managers/__init__.py create mode 100644 co3/managers/__pycache__/__init__.cpython-311.pyc create mode 100644 co3/managers/__pycache__/__init__.cpython-312.pyc create mode 100644 co3/managers/__pycache__/_base.cpython-311.pyc create mode 100644 co3/managers/__pycache__/core.cpython-311.pyc create mode 100644 co3/managers/__pycache__/fts.cpython-311.pyc create mode 100644 co3/managers/__pycache__/fts.cpython-312.pyc create mode 100644 co3/managers/__pycache__/sql.cpython-312.pyc create mode 100644 co3/managers/__pycache__/vss.cpython-312.pyc create mode 100644 co3/managers/fts.py create mode 100644 co3/managers/sql.py create mode 100644 co3/managers/vss.py create mode 100644 co3/mapper.py create mode 100644 co3/relation.py create mode 100644 co3/relations/__init__.py create mode 100644 co3/relations/__pycache__/__init__.cpython-312.pyc create mode 100644 co3/util/__init__.py create mode 100644 co3/util/__pycache__/__init__.cpython-311.pyc create mode 100644 co3/util/__pycache__/__init__.cpython-312.pyc create mode 100644 co3/util/__pycache__/db.cpython-311.pyc create mode 100644 co3/util/__pycache__/db.cpython-312.pyc create mode 100644 co3/util/__pycache__/paths.cpython-311.pyc create mode 100644 co3/util/__pycache__/regex.cpython-311.pyc create mode 100644 co3/util/__pycache__/regex.cpython-312.pyc create mode 100644 co3/util/db.py create mode 100644 co3/util/regex.py create mode 100644 docs/Makefile create mode 100644 docs/_autoref/co4.accessors.rst create mode 100644 docs/_autoref/co4.collectors.rst create mode 100644 docs/_autoref/co4.composers.rst create mode 100644 docs/_autoref/co4.databases.rst create mode 100644 docs/_autoref/co4.managers.rst create mode 100644 docs/_autoref/co4.rst create mode 100644 docs/_autoref/modules.rst create mode 100644 docs/_build/doctrees/_autoref/co4.accessors.doctree create mode 100644 docs/_build/doctrees/_autoref/co4.collectors.doctree create mode 100644 docs/_build/doctrees/_autoref/co4.composers.doctree create mode 100644 docs/_build/doctrees/_autoref/co4.databases.doctree create mode 100644 docs/_build/doctrees/_autoref/co4.doctree create mode 100644 docs/_build/doctrees/_autoref/co4.managers.doctree create mode 100644 docs/_build/doctrees/_autoref/modules.doctree create mode 100644 docs/_build/doctrees/environment.pickle create mode 100644 docs/_build/doctrees/index.doctree create mode 100644 docs/_build/doctrees/reference/documentation/index.doctree create mode 100644 docs/_build/doctrees/reference/documentation/sphinx.doctree create mode 100644 docs/_build/html/.buildinfo create mode 100644 docs/_build/html/_autoref/co4.accessors.html create mode 100644 docs/_build/html/_autoref/co4.collectors.html create mode 100644 docs/_build/html/_autoref/co4.composers.html create mode 100644 docs/_build/html/_autoref/co4.databases.html create mode 100644 docs/_build/html/_autoref/co4.html create mode 100644 docs/_build/html/_autoref/co4.managers.html create mode 100644 docs/_build/html/_autoref/modules.html create mode 100644 docs/_build/html/_sources/_autoref/co4.accessors.rst.txt create mode 100644 docs/_build/html/_sources/_autoref/co4.collectors.rst.txt create mode 100644 docs/_build/html/_sources/_autoref/co4.composers.rst.txt create mode 100644 docs/_build/html/_sources/_autoref/co4.databases.rst.txt create mode 100644 docs/_build/html/_sources/_autoref/co4.managers.rst.txt create mode 100644 docs/_build/html/_sources/_autoref/co4.rst.txt create mode 100644 docs/_build/html/_sources/_autoref/modules.rst.txt create mode 100644 docs/_build/html/_sources/index.md.txt create mode 100644 docs/_build/html/_sources/reference/documentation/index.md.txt create mode 100644 docs/_build/html/_sources/reference/documentation/sphinx.md.txt create mode 100644 docs/_build/html/_static/basic.css create mode 100644 docs/_build/html/_static/debug.css create mode 100644 docs/_build/html/_static/doctools.js create mode 100644 docs/_build/html/_static/documentation_options.js create mode 100644 docs/_build/html/_static/file.png create mode 100644 docs/_build/html/_static/language_data.js create mode 100644 docs/_build/html/_static/minus.png create mode 100644 docs/_build/html/_static/plus.png create mode 100644 docs/_build/html/_static/pygments.css create mode 100644 docs/_build/html/_static/scripts/furo-extensions.js create mode 100644 docs/_build/html/_static/scripts/furo.js create mode 100644 docs/_build/html/_static/scripts/furo.js.LICENSE.txt create mode 100644 docs/_build/html/_static/scripts/furo.js.map create mode 100644 docs/_build/html/_static/searchtools.js create mode 100644 docs/_build/html/_static/skeleton.css create mode 100644 docs/_build/html/_static/sphinx_highlight.js create mode 100644 docs/_build/html/_static/styles/furo-extensions.css create mode 100644 docs/_build/html/_static/styles/furo-extensions.css.map create mode 100644 docs/_build/html/_static/styles/furo.css create mode 100644 docs/_build/html/_static/styles/furo.css.map create mode 100644 docs/_build/html/genindex.html create mode 100644 docs/_build/html/index.html create mode 100644 docs/_build/html/objects.inv create mode 100644 docs/_build/html/reference/documentation/index.html create mode 100644 docs/_build/html/reference/documentation/sphinx.html create mode 100644 docs/_build/html/search.html create mode 100644 docs/_build/html/searchindex.js create mode 100644 docs/conf.py create mode 100644 docs/index.md create mode 100644 docs/make.bat create mode 100644 docs/reference/documentation/index.md create mode 100644 docs/reference/documentation/sphinx.md create mode 100644 pyproject.toml create mode 100644 requirements.txt create mode 100644 tests/co4_example.py create mode 100644 tests/imports.py diff --git a/.python-version b/.python-version new file mode 100644 index 0000000..94aa8a4 --- /dev/null +++ b/.python-version @@ -0,0 +1 @@ +co4 diff --git a/MANIFEST.in b/MANIFEST.in new file mode 100644 index 0000000..e69de29 diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..8d88d76 --- /dev/null +++ b/Makefile @@ -0,0 +1,16 @@ +PYTHON=/home/smgr/.pyenv/versions/co4/bin/python +BASH=/usr/bin/bash + + +## ------------------ docs ------------------ ## +docs-build: + sphinx-apidoc --module-first -o docs/_autoref/ co4 + make -C docs/ html + +docs-serve: + cd docs/_build/html && python -m http.server 9090 + +docs-clean: + make -C docs/ clean +## ------------------------------------------ ## + diff --git a/README.md b/README.md new file mode 100644 index 0000000..fff4fd0 --- /dev/null +++ b/README.md @@ -0,0 +1,21 @@ +# Overview +`co3` is a package for file conversion and associated database operations. The `CO3` base class +provides a standard interface for performing conversions, preparing inserts, and +interacting with database schemas that mirror the class hierarchy. + +Simplified description of the operational model: + +**Goal**: interact with a storage medium (database, pickled structure, VSS framework) with +a known schema. + +- **Accessor** to provide access to stored items +- **Composer** to compose common access points (e.g., JOINed tables) +- **Indexer** to index/cache access queries +- **Manager** to manage storage state (e.g., supported inserts, database syncs) +- **Collector** to collect data for updating storage state +- **Database** to collect data for updating storage state +- **Mapper** to collect data for updating storage state +- **Relation** to collect data for updating storage state + +**CO3** is an abstract base class that makes it easy to integrate this model with object +hierarchies that mirror a storage schema. diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/__init__.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/__init__.py new file mode 120000 index 0000000..6945f64 --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/__init__.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/__init__.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/accessor.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/accessor.py new file mode 120000 index 0000000..2ef50e7 --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/accessor.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/accessor.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/accessors/__init__.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/accessors/__init__.py new file mode 120000 index 0000000..d57d1d7 --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/accessors/__init__.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/accessors/__init__.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/accessors/fts.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/accessors/fts.py new file mode 120000 index 0000000..a015fd1 --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/accessors/fts.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/accessors/fts.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/accessors/sql.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/accessors/sql.py new file mode 120000 index 0000000..3f162d7 --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/accessors/sql.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/accessors/sql.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/accessors/vss.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/accessors/vss.py new file mode 120000 index 0000000..e0e5848 --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/accessors/vss.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/accessors/vss.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/co3.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/co3.py new file mode 120000 index 0000000..202952a --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/co3.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/co3.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/collector.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/collector.py new file mode 120000 index 0000000..6d2ae9a --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/collector.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/collector.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/composer.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/composer.py new file mode 120000 index 0000000..7802f23 --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/composer.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/composer.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/database.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/database.py new file mode 120000 index 0000000..8438d1e --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/database.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/database.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/databases/__init__.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/databases/__init__.py new file mode 120000 index 0000000..36b6a34 --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/databases/__init__.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/databases/__init__.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/databases/fts.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/databases/fts.py new file mode 120000 index 0000000..7cff9ab --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/databases/fts.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/databases/fts.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/databases/sql.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/databases/sql.py new file mode 120000 index 0000000..9b158a9 --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/databases/sql.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/databases/sql.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/databases/vss.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/databases/vss.py new file mode 120000 index 0000000..c92c586 --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/databases/vss.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/databases/vss.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/indexer.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/indexer.py new file mode 120000 index 0000000..410ce45 --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/indexer.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/indexer.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/manager.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/manager.py new file mode 120000 index 0000000..e575dc4 --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/manager.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/manager.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/managers/__init__.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/managers/__init__.py new file mode 120000 index 0000000..5e3ac6f --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/managers/__init__.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/managers/__init__.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/managers/fts.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/managers/fts.py new file mode 120000 index 0000000..fd3745f --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/managers/fts.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/managers/fts.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/managers/sql.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/managers/sql.py new file mode 120000 index 0000000..cbeec0f --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/managers/sql.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/managers/sql.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/managers/vss.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/managers/vss.py new file mode 120000 index 0000000..58f2c07 --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/managers/vss.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/managers/vss.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/mapper.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/mapper.py new file mode 120000 index 0000000..3fd58c9 --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/mapper.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/mapper.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/relation.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/relation.py new file mode 120000 index 0000000..0b07dfb --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/relation.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/relation.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/relations/__init__.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/relations/__init__.py new file mode 120000 index 0000000..25617d3 --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/relations/__init__.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/relations/__init__.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/util/__init__.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/util/__init__.py new file mode 120000 index 0000000..00f184b --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/util/__init__.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/util/__init__.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/util/db.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/util/db.py new file mode 120000 index 0000000..0f263c2 --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/util/db.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/util/db.py \ No newline at end of file diff --git a/build/__editable__.co3-0.1.1-py3-none-any/co3/util/regex.py b/build/__editable__.co3-0.1.1-py3-none-any/co3/util/regex.py new file mode 120000 index 0000000..eeb2ce3 --- /dev/null +++ b/build/__editable__.co3-0.1.1-py3-none-any/co3/util/regex.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co3/co3/util/regex.py \ No newline at end of file diff --git a/build/__editable__.co4-0.1.1-py3-none-any/co4/__init__.py b/build/__editable__.co4-0.1.1-py3-none-any/co4/__init__.py new file mode 120000 index 0000000..2185402 --- /dev/null +++ b/build/__editable__.co4-0.1.1-py3-none-any/co4/__init__.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co4/co4/__init__.py \ No newline at end of file diff --git a/build/__editable__.co4-0.1.1-py3-none-any/co4/accessor.py b/build/__editable__.co4-0.1.1-py3-none-any/co4/accessor.py new file mode 120000 index 0000000..fe0209c --- /dev/null +++ b/build/__editable__.co4-0.1.1-py3-none-any/co4/accessor.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co4/co4/accessor.py \ No newline at end of file diff --git a/build/__editable__.co4-0.1.1-py3-none-any/co4/accessors/__init__.py b/build/__editable__.co4-0.1.1-py3-none-any/co4/accessors/__init__.py new file mode 120000 index 0000000..67548ba --- /dev/null +++ b/build/__editable__.co4-0.1.1-py3-none-any/co4/accessors/__init__.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co4/co4/accessors/__init__.py \ No newline at end of file diff --git a/build/__editable__.co4-0.1.1-py3-none-any/co4/accessors/fts.py b/build/__editable__.co4-0.1.1-py3-none-any/co4/accessors/fts.py new file mode 120000 index 0000000..c266881 --- /dev/null +++ b/build/__editable__.co4-0.1.1-py3-none-any/co4/accessors/fts.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co4/co4/accessors/fts.py \ No newline at end of file diff --git a/build/__editable__.co4-0.1.1-py3-none-any/co4/accessors/table.py b/build/__editable__.co4-0.1.1-py3-none-any/co4/accessors/table.py new file mode 120000 index 0000000..2e05a5d --- /dev/null +++ b/build/__editable__.co4-0.1.1-py3-none-any/co4/accessors/table.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co4/co4/accessors/table.py \ No newline at end of file diff --git a/build/__editable__.co4-0.1.1-py3-none-any/co4/accessors/vss.py b/build/__editable__.co4-0.1.1-py3-none-any/co4/accessors/vss.py new file mode 120000 index 0000000..97eacf6 --- /dev/null +++ b/build/__editable__.co4-0.1.1-py3-none-any/co4/accessors/vss.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co4/co4/accessors/vss.py \ No newline at end of file diff --git a/build/__editable__.co4-0.1.1-py3-none-any/co4/co4.py b/build/__editable__.co4-0.1.1-py3-none-any/co4/co4.py new file mode 120000 index 0000000..e4548c1 --- /dev/null +++ b/build/__editable__.co4-0.1.1-py3-none-any/co4/co4.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co4/co4/co4.py \ No newline at end of file diff --git a/build/__editable__.co4-0.1.1-py3-none-any/co4/collector.py b/build/__editable__.co4-0.1.1-py3-none-any/co4/collector.py new file mode 120000 index 0000000..f762f63 --- /dev/null +++ b/build/__editable__.co4-0.1.1-py3-none-any/co4/collector.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co4/co4/collector.py \ No newline at end of file diff --git a/build/__editable__.co4-0.1.1-py3-none-any/co4/composer.py b/build/__editable__.co4-0.1.1-py3-none-any/co4/composer.py new file mode 120000 index 0000000..2220175 --- /dev/null +++ b/build/__editable__.co4-0.1.1-py3-none-any/co4/composer.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co4/co4/composer.py \ No newline at end of file diff --git a/build/__editable__.co4-0.1.1-py3-none-any/co4/databases/__init__.py b/build/__editable__.co4-0.1.1-py3-none-any/co4/databases/__init__.py new file mode 120000 index 0000000..124710b --- /dev/null +++ b/build/__editable__.co4-0.1.1-py3-none-any/co4/databases/__init__.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co4/co4/databases/__init__.py \ No newline at end of file diff --git a/build/__editable__.co4-0.1.1-py3-none-any/co4/databases/_base.py b/build/__editable__.co4-0.1.1-py3-none-any/co4/databases/_base.py new file mode 120000 index 0000000..0620c20 --- /dev/null +++ b/build/__editable__.co4-0.1.1-py3-none-any/co4/databases/_base.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co4/co4/databases/_base.py \ No newline at end of file diff --git a/build/__editable__.co4-0.1.1-py3-none-any/co4/databases/core.py b/build/__editable__.co4-0.1.1-py3-none-any/co4/databases/core.py new file mode 120000 index 0000000..ddb8a85 --- /dev/null +++ b/build/__editable__.co4-0.1.1-py3-none-any/co4/databases/core.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co4/co4/databases/core.py \ No newline at end of file diff --git a/build/__editable__.co4-0.1.1-py3-none-any/co4/databases/fts.py b/build/__editable__.co4-0.1.1-py3-none-any/co4/databases/fts.py new file mode 120000 index 0000000..8fba3cb --- /dev/null +++ b/build/__editable__.co4-0.1.1-py3-none-any/co4/databases/fts.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co4/co4/databases/fts.py \ No newline at end of file diff --git a/build/__editable__.co4-0.1.1-py3-none-any/co4/databases/vss.py b/build/__editable__.co4-0.1.1-py3-none-any/co4/databases/vss.py new file mode 120000 index 0000000..2daa6c6 --- /dev/null +++ b/build/__editable__.co4-0.1.1-py3-none-any/co4/databases/vss.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co4/co4/databases/vss.py \ No newline at end of file diff --git a/build/__editable__.co4-0.1.1-py3-none-any/co4/indexer.py b/build/__editable__.co4-0.1.1-py3-none-any/co4/indexer.py new file mode 120000 index 0000000..757ffd2 --- /dev/null +++ b/build/__editable__.co4-0.1.1-py3-none-any/co4/indexer.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co4/co4/indexer.py \ No newline at end of file diff --git a/build/__editable__.co4-0.1.1-py3-none-any/co4/manager.py b/build/__editable__.co4-0.1.1-py3-none-any/co4/manager.py new file mode 120000 index 0000000..8585495 --- /dev/null +++ b/build/__editable__.co4-0.1.1-py3-none-any/co4/manager.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co4/co4/manager.py \ No newline at end of file diff --git a/build/__editable__.co4-0.1.1-py3-none-any/co4/managers/__init__.py b/build/__editable__.co4-0.1.1-py3-none-any/co4/managers/__init__.py new file mode 120000 index 0000000..1c4ff87 --- /dev/null +++ b/build/__editable__.co4-0.1.1-py3-none-any/co4/managers/__init__.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co4/co4/managers/__init__.py \ No newline at end of file diff --git a/build/__editable__.co4-0.1.1-py3-none-any/co4/managers/core.py b/build/__editable__.co4-0.1.1-py3-none-any/co4/managers/core.py new file mode 120000 index 0000000..872cf15 --- /dev/null +++ b/build/__editable__.co4-0.1.1-py3-none-any/co4/managers/core.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co4/co4/managers/core.py \ No newline at end of file diff --git a/build/__editable__.co4-0.1.1-py3-none-any/co4/managers/fts.py b/build/__editable__.co4-0.1.1-py3-none-any/co4/managers/fts.py new file mode 120000 index 0000000..d9fae88 --- /dev/null +++ b/build/__editable__.co4-0.1.1-py3-none-any/co4/managers/fts.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co4/co4/managers/fts.py \ No newline at end of file diff --git a/build/__editable__.co4-0.1.1-py3-none-any/co4/managers/vss.py b/build/__editable__.co4-0.1.1-py3-none-any/co4/managers/vss.py new file mode 120000 index 0000000..bd70f75 --- /dev/null +++ b/build/__editable__.co4-0.1.1-py3-none-any/co4/managers/vss.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co4/co4/managers/vss.py \ No newline at end of file diff --git a/build/__editable__.co4-0.1.1-py3-none-any/co4/utils/db.py b/build/__editable__.co4-0.1.1-py3-none-any/co4/utils/db.py new file mode 120000 index 0000000..7e332ab --- /dev/null +++ b/build/__editable__.co4-0.1.1-py3-none-any/co4/utils/db.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co4/co4/utils/db.py \ No newline at end of file diff --git a/build/__editable__.co4-0.1.1-py3-none-any/co4/utils/paths.py b/build/__editable__.co4-0.1.1-py3-none-any/co4/utils/paths.py new file mode 120000 index 0000000..f3790de --- /dev/null +++ b/build/__editable__.co4-0.1.1-py3-none-any/co4/utils/paths.py @@ -0,0 +1 @@ +/home/smgr/Documents/projects/ontolog/co4/co4/utils/paths.py \ No newline at end of file diff --git a/co3.egg-info/PKG-INFO b/co3.egg-info/PKG-INFO new file mode 100644 index 0000000..17a54cd --- /dev/null +++ b/co3.egg-info/PKG-INFO @@ -0,0 +1,30 @@ +Metadata-Version: 2.1 +Name: co3 +Version: 0.1.1 +Summary: Lightweight ORM +Author-email: Sam Griesemer +Classifier: Programming Language :: Python :: 3 +Classifier: License :: OSI Approved :: MIT License +Classifier: Operating System :: OS Independent +Requires-Python: >=3.11 +Description-Content-Type: text/markdown +Requires-Dist: tqdm + +# Overview +`co4` is a package for file conversion and associated database operations. The `CO4` base class +provides a standard interface for performing conversions, preparing inserts, and +interacting with database schemas that mirror the class hierarchy. + +Simplified description of the operational model: + +**Goal**: interact with a storage medium (database, pickled structure, VSS framework) with +a known schema. + +- **Accessor** to provide access to stored items +- **Composer** to compose common access points (e.g., JOINed tables) +- **Indexer** to index/cache access queries +- **Manager** to manage storage state (e.g., supported inserts, database syncs) +- **Collector** to collect data for updating storage state + +**CO4** is an abstract base class that makes it easy to integrate this model with object +hierarchies that mirror a storage schema. diff --git a/co3.egg-info/SOURCES.txt b/co3.egg-info/SOURCES.txt new file mode 100644 index 0000000..fde29fa --- /dev/null +++ b/co3.egg-info/SOURCES.txt @@ -0,0 +1,34 @@ +MANIFEST.in +README.md +pyproject.toml +co3/__init__.py +co3/accessor.py +co3/co3.py +co3/collector.py +co3/composer.py +co3/database.py +co3/indexer.py +co3/manager.py +co3/mapper.py +co3/relation.py +co3.egg-info/PKG-INFO +co3.egg-info/SOURCES.txt +co3.egg-info/dependency_links.txt +co3.egg-info/requires.txt +co3.egg-info/top_level.txt +co3/accessors/__init__.py +co3/accessors/fts.py +co3/accessors/sql.py +co3/accessors/vss.py +co3/databases/__init__.py +co3/databases/fts.py +co3/databases/sql.py +co3/databases/vss.py +co3/managers/__init__.py +co3/managers/fts.py +co3/managers/sql.py +co3/managers/vss.py +co3/relations/__init__.py +co3/util/__init__.py +co3/util/db.py +co3/util/regex.py \ No newline at end of file diff --git a/co3.egg-info/dependency_links.txt b/co3.egg-info/dependency_links.txt new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/co3.egg-info/dependency_links.txt @@ -0,0 +1 @@ + diff --git a/co3.egg-info/requires.txt b/co3.egg-info/requires.txt new file mode 100644 index 0000000..78620c4 --- /dev/null +++ b/co3.egg-info/requires.txt @@ -0,0 +1 @@ +tqdm diff --git a/co3.egg-info/top_level.txt b/co3.egg-info/top_level.txt new file mode 100644 index 0000000..7d71d10 --- /dev/null +++ b/co3.egg-info/top_level.txt @@ -0,0 +1 @@ +co3 diff --git a/co3/__init__.py b/co3/__init__.py new file mode 100644 index 0000000..0b6fc93 --- /dev/null +++ b/co3/__init__.py @@ -0,0 +1,109 @@ +''' +Database submodule + +- `db`: contains SQLAlchemy-based schema definitions +- `accessors`: convenience methods for accessing database entries +- `populate`: convenience methods for populating database tables + +The `accessors` and `populate` submodules are each split into `schema` and `fts` method +groups. The former concerns methods relating to the actual database schema, the latter to +their SQLite FTS counterparts. + +Note: Subpackages organization + Subpackages are broken up by inheritance. Within a given submodule, you have a + `_base.py` file defining the base class associated with that submodule's title, along + with concrete subclasses of that base in their own files. Deeper inheritance would + recursively extend this structure. The `__init__.py` for a given submodule then + exposes the concrete instances, leaving the base hidden. For example, + + accessors/ + _base.py + core.py + fts.py + + `core` and `fts` house the `CoreAccessor` and `FTSAccessor` classes, respectively, + and are the direct subclasses of the `Accessor` parent found in the `_base`. This base + class _could_ be placed outside of the submodule in the parent directory (imported + with something like `from db import accessor` instead of `from db.accessor import + _base`). This is entirely valid, but I tend to prefer when the base class is among its + direct children, as + + - In this case at least, the base doesn't need to be exposed + - The base class is being stowed away under an appropriately named submodule; having a + separate `accessor.py` and `accessors/` file/directory can feel a little cluttered. + - It makes imports across the accessors feel standardized: + + ```py + from localsys.db.accessors._base import Accessor + + from localsys.db.accessors.core import CoreAccessor + ``` + + Both have the same level of nesting to reach the class. + + Frankly, both means of organization are perfectly fine, and as far as I can tell, + semantically sound in their own right. This particular scheme is just a preference in + the moment, and so long as I keep things consistent, choosing one over the other + shouldn't matter. + + Additionally, note how `__init__.py`s are typically set up when providing wider access + to internal modules. The `init` typically pulls out classes from sibling modules + (i.e., files), but will import subpackages are the topmost level. For example, for the + structure + + ``` + db/ + __init__.py + accessors/ + __init__.py + _base.py + core.py + fts.py + ``` + + we have + + ```db/__init__.py + from localsys.db import accessors + ``` + + which just imports the subpackage `accessors`. However, within subpackage: + + ```db/accessors/__init__.py + from localsys.db.accessors.core import CoreAccessor + ``` + + we don't just import the submodule `core`; we did into the file to grab the relevant + class and pull it into the outer namespace. Overarching point: `__init__.py` files + typically reach into the sibling files (submodules) and pull out classes. Given that + this behavior is recursive, `__init__.py` then respect subpackages (nested + directories), importing them at the top-level and expecting an internal `__init__.py` + will have managed access appropriately. + +Note: Organization for inheritance over composition + At a glance, the organization of subpackages here feels like it clashes with those + seen in `localsys.primitives`. `note_components`, for instance, houses the components + for the outer `note` module. Contrast this with how the `core` submodule looks: it's + composing `*/core.py` files across subpackages `accessors` and `managers`, rather than + a single subpackage like `note`. This seems inconsistent, but the subpackages here are + actually still organized in the same way: by inheritance. It just happens that the + all of the note components inherit from the same base class, and are thus confined to + a single subpackage. This aside, the subpackages themselves are still created around + inheritance, wrapping up a base and direct subclasses. +''' + +from co3.accessor import Accessor +from co3.co3 import CO3 +from co3.collector import Collector +from co3.composer import Composer +from co3.database import Database +from co3.indexer import Indexer +from co3.manager import Manager +from co3.mapper import Mapper +from co3.relation import Relation + +from co3 import accessors +from co3 import databases +from co3 import managers +from co3 import relations +from co3 import util diff --git a/co3/__pycache__/__init__.cpython-311.pyc b/co3/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..279a32106ba0cbb81710977e3306c0be336fc58c GIT binary patch literal 4735 zcmai2O>Y~?5hW$rlDRgJWX}uqCI?#qMP7V~HdsI_!-;@ojl>2L2mv_FnI_q*p6Nk% zk0>s3&R@t+SmfXMX!x2_ZU*)cU{85f-Sa^ia0E&o&U9DT$E){h{KJzclM#Nd?*6MT ze=!>Uo4&L^2kGL+KjY$`qhfSDD#pcu8J7pw2V=TEG>7HU^$}kmnFr;=>xX>(z#Nw+ z*C%}a&^#(9*Au=zHlLM`uOH+3&D2SK4Bm&*|UHU3=B-(Y}C*TA*(`Uoy|T(FQijK$$TSx zZFCU23RYw>sw{3>1)n9)Cu?V$+Rp^pM-ZiQl$%^R7Rwz1+bE}lgtIg87acab5>l)+YSX7{Bm-4n|FdG`3o^WnMq5nH4@jpqmyU?uSho|;bXi*mgt1wMkGIrwlzO9Y;NZ&HQWQ%OS0;wB zE`v=Ul*FN{ZqckQMOw{PV+f}y284kqkq%(#RvKMQ#j*+FN<>&$Q9HE)61M;fr*6;? z*egq5UFhK1bV_T!(WXH1&Dpm{m%AEz35C%KT z(Fk=~Azh)rSH*eEnh;r*bxp#BH#V2X@BFM-cE$BGE@_L17QwBJPwb;cYqt$Mi@oR5 zTO;3C5FT?Tx$corR1gG2XseWOrNFVu&=PJ5P&!rrrIXc-*#TK(rBo6^f_+17=gtJ< zt%1V-l&TNlL~ zQG4-S;{$3J0nXB`BNvkYCEBh6K*N71wp)IJxsZ|C<-1aD2l15Ab?_HxBJ{31w8EPHdqx%@VF&`^IKie zxmz$zJ8|%d=praRWE;X9hn*zq8OcH>dV?543`&B&Z|RUh`BQ(cYY7D1Gc6-fk2e{b%`@z7*2JE{a^P6Eb>V<=pBZ7T7vPwXNG#muObTg zR|458G-+oV5_!79_1eiLZ-MHlTQo7JB#J2Y8^IBp(r*MZ0d1mj4|HL?d4(KE2b}>r zYl{QU_d6!ylg;)hkL1*O)1sTa^5R+NzCY!rXD0?NF%!SzIg+NnXqZO;MOuOp2z=6w zWz&1kprD|mIFJk~hC_)uli0Vqf_DS-Rm1{?hs`AkCZPhIbQWos(gb~^2?uMyi(RMh zO?~Vr_a}2V2oqB^NR=n3eUjU7w~|HWmo4lo((oP9!&F6eTH0T`*+y2GT@G zd1yycHeKE4wd JxSzw7{{ggsIK=<} literal 0 HcmV?d00001 diff --git a/co3/__pycache__/__init__.cpython-312.pyc b/co3/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d700a87290e482f0793b6695d6874f8a6d5639ee GIT binary patch literal 4929 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 be4mqr(b0EYJLw<*|IPo%<$u0nHuwA=rvU;{ literal 0 HcmV?d00001 diff --git a/co3/__pycache__/accessor.cpython-312.pyc b/co3/__pycache__/accessor.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b4c4b53635fb107e478d47fb1350d311b720fcba GIT binary patch literal 1563 zcmY+EL2Dd06o94KU3)W*le#TU+Dl(r2wh0lg($nYM=zG0%g(Q9y;Yno=>>a~I#nYrG4#ANG$J)Iip zwMS8BZuiglewr%pt&8IgXLqzz9z>Xe%7Q3hSV-l}NEdzZ=|JTIs)4h^{s08{VOd&N zDG6RxU^B3#a-!0<@LgCn!uvQ^)xb&*sT~>#TMGKBKpk@n2D(4EZPbo3u=(W!c;rNh zyZtS&4z-INRcKYD3bJ9529uD5l{~jaJaOf=FIB2Dox=7|Ijwv*{+r@^*x_|^LsSFo z7o^I>&{R^VRXPnmbS-T0dfC~h*c|f1h^|xe1NK|=m_La!{)9*Db9Tg!qAZfpL0dMy z=fB4LY>z#qeONYGr&;s0*UZxVTUgJU*c`JFLm%2}q7qxet6!MAL~B^t`De=mo2zA? z_ucZEO^3NED!*Jh`>je*utjB!?JuYHlTasFv94Q=+#K!?%@PWpP8zeLeMj89=F9~y zH*w`Bj8HKIh4rGZ+3&2^ki6HFBy)_ganS6wM$JyEZqJwy-*Coaz%rScB?(f>?JOUq zQIBT{Kw=~);YXm0O7$l&z$0A^VAbZO^~wQWg`rfD-7j+79Rh!qhnE0W0|d{5(cdYA zf>KXx_{s@gAaX6`S1RqhZC7`p_fc!2p-S2?T zps*Eb(KD05K;4#8G}2kFFjI`=0MVN$9J4*X#}b+kg^)tR-4z^lqPppo$-=?1D=ZU2?V4s2988^U!HR_v@~a8F~qxo+GTR1ncK;cd7-!zW@ULO|x6L z=iWv2i=+P=vmf_gu$bQn%_&LY=*}hg4l363x}a~Ss^?4mQHiVT4QjUK08M* zu#Ww<5fixT$cvY*Pa>hLoVV{z?)08}ABXt5nEwEqlLqJfG@9ehvnz~Wea5aoV;??e N*IvZv&B=vJ{{u=irD*^F literal 0 HcmV?d00001 diff --git a/co3/__pycache__/co3.cpython-312.pyc b/co3/__pycache__/co3.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5d4e7aacee7d8e31c4a4d3894d740d992bdc7dbf GIT binary patch literal 4577 zcmcIn+ix7z89%f4UEfmMA;}WpB!a-gW-Y+E$fZdkh6o88aS;zo>1I50ygO!gW|=c% zv(~yqRirv9RgF*;w^dam9xw`0dF(^~gTB}V6l)r(mD-oSIXG<*PyKyoX4gwVee2Qg znRETlcR#=L=b@njLwTm6&HrJ9vA~$^bRdZ&+OkL5c`2@Sj%=8szW<=q7GM*h!qgjmR#K0%{ z-uPfUQ5w)K5Gh=Eak4-awT>Xu9J%mZ94`AVEo5OBQ-E^n{}orfURE;rQGWc0{jCT!1z= zTxU^ul7uZQEy%XxLw}00;Wk^YgN?FM_$QfUwv-6dOP=16VYa1vzNOnnBC?gLsZF-q z8%6aqc*!c8hj(1btt2{$S6C@AYs7}{Egz%h52E^&c8$HGT~3;;uB~WS6CG_n(P1^U zkg5)Qg?+5emb7rNMhv=6jjT~hhN=0$F~XsEubs{HPo=g59CtSyOZMQyQxKDQfl~y~Z{9aXW;PG0N=Uq*!pv;GduS^ym{Z&(KD;5&vQq1M#feL_OOb5%t}db01b~q z&Kp9d_`JlqMH`@@A0sZ`}X`N+Vxnt?cK3X{=0IK+E-W^=;S*CaJW>b@Dz5x`)G>2`x^dWq?24g zF1)*RCF?tVaAm0P^r5>>ANpUXzw@or!Aa6g5-&d4U6rfD9rlZdC=@zcC(%h>kF^9# zrYJD-El-$;T;vJTS}z8gdaG0jbDp437iO4jdTyAt9NB{3hlRTEo1!^~xv*eK3MPuK zFx$|j?)zRuD{c9rDZ{i3kR8Kpt>%cOTCFq^CJkGLDMxRLFioiuYiO4YN8$+dV&4i= zG#zGYD*1(3N|dfCL#-BOqV|3~gn6P-Q&bD8xv1NL2=ldQcdaJLCj1-avI-oJ{C>Ik zZNIL>JU@(i`7cxysl}tKBfB|vu=pj*08C)8Ufo3H(8>E`*Dw$H!xdGY17?9Q=AzGTVo&1&yGzxMRn;;lpXuP<)=ouy5;(?oqYNhj})vlEYf^!f*{ zfA|I{=AYBH2al~jzqWj9O1RlV|w$UPY>Q0IkS~JqY_3b9p<17*sN9y z3$9e~Gl{!$(e|MTXjSc%r%G9b!kunokSU13`Y4nqQ{R{vDt7hBjQYK7Zc=1Vn0%1@f zPe5l1l}gcN)qsCf1J@Yt$CG`x9Y4XRpTU(X1#U6dQE;K4h@9jXq9i}XU9YY?)-tYf zz=Ph6+)u>~{8r%O>cj!knzP$nH#{_B52kLNjYc2qMDEHH* z+bzD6gSmZ53eNQN-XpD~oFWoP;T09pJ7Zp?ZE-!5S4 zf`@jbky+OlPzJ!2N(?-@Vb!su^^0`ja=K@^4r!#-Y(Wp?LMC{zZOBXTg8MEY7BG?J zbD_(21j}%%>UEskLmF7tqdcc{qXTL|{ciVo8O%umNJ22E4Q#_}j_cRB9@G`aAu(b` zm%e4&96SV$^;RIhua+s%HSUS+E11Z2c;YFO{_vp?6<3KN5p*kb5 zbq_W)JSzf%P`+>^q=nxQPykaVzZ3(MOVFdrdzk$}tSHNIk z2)?9)S#rZB!c_S|MG^W23?iuy1OyB^~k+_2j62R$BUl)!Y3DdsIl@P@m@ zbq>$;+b!|1j1vo<1CcAi+7Q76i*P0r5-HswFfOUrKxA4@-VtN^{*+)405mNvy)P%ovtQy5i1D;$Ucn(ozQ@A>rR5_KgZOY*4biYElRJU~tp z$Gm|7N#K+oI|tWa{eA7%we5lOt-;Y>zHs%0^>dq#ZXW&g$6H6HKOcN{XYA15#wu%* z*UrCpeq(BTtg`9f7@OQ0oKy;)E#^)8`s?Ost$>>+u?Zjw0w|jzRhHod*>Ed1ztzByE4##7oy|K}~;dJ^`1XPF& zL22YPT>({(ogLe)b($21r-(mRNd7`A9+8RIcZwM4g_g~N#-ZlUL literal 0 HcmV?d00001 diff --git a/co3/__pycache__/co4.cpython-311.pyc b/co3/__pycache__/co4.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8f1362085d90ce2d0520673fdac6633c015aa1a5 GIT binary patch literal 9350 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 literal 0 HcmV?d00001 diff --git a/co3/__pycache__/collector.cpython-311.pyc b/co3/__pycache__/collector.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a709f04d2c320cfcc82e15b326b623f44ad52c01 GIT binary patch literal 5939 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 yskiQ3?MS`z-b-tli3$_OTlO{yATjPW}f6O$Z(U literal 0 HcmV?d00001 diff --git a/co3/__pycache__/collector.cpython-312.pyc b/co3/__pycache__/collector.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4d3aac1e4673245bb6e95c2c638bc5a992e0b59e GIT binary patch literal 5485 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 literal 0 HcmV?d00001 diff --git a/co3/__pycache__/composer.cpython-311.pyc b/co3/__pycache__/composer.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3008c657b6a29a43ecd101df3754801b7797b52e GIT binary patch literal 4226 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 S?ZC*_r+<*_pa0{9vHripwUu4~ literal 0 HcmV?d00001 diff --git a/co3/__pycache__/composer.cpython-312.pyc b/co3/__pycache__/composer.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8d71fc9d299d8b37f3d84d94fb36a04508e74e65 GIT binary patch literal 4393 zcmai1&2JmW6`$pYL{W0&#&Rtw6)={aMs(;^P`ha3_@fb>6ft1Ch+Gs9S}a$)LuuvZ zE;F-~Oo2*tFc7(L8Xwx&IVFc2Y8Wm2f8=5}39J%16exP=O|e=e2vDHEH?yQ9yB`B^ zI6FJ@=FNNW_j_+Y-M6pE(E3LIB|aEp?636DZJBhi{bLMnGoQ^d-|{n|RnN?2EE;FS zY&|!Z!?@qiU$^G+8Rqw0XZO;LbA7E`so=hrWvp0<>y20mSuD=DO7L1NdEJegZWy+> zFKR&)L<>A|=R?6gy);OII8r=rCMxg+PZqJ8M{d%TZpf1u6M`#mQPkbyVj!d|y~P%v z3T$DQAt6$UY3usmeW^T(XPB*RHwsMkr2k)ohT0d`0j@cUfSI z3g``w=a+<+@SQ_mor0_qKYo_aP*<^e(3#<9_)O22GLv}RTZqN{I6BLnNVw8XKPm5nq{So zTfs{$?@euRNzn6R=_XK&5NVw1r_MwqX#Y`^oj2`K82IFhRs(MWi+0j;!XiePi0P%Mj(z{VS)>p_h)^3%K2 z-A2{cTlUzSSn>eb`z3AfcdYfHHe15@$wppiGpFaPHk)O4txKg$r{HKqIZnrbM?Yac zS8GO|B!X6S3g_RxJiQp##k8s~$m#R3*Q|>uQPZ#+QIwjFqa+UFg=sH7k^T(n+KpCc zpy%q+JC}x%|jhkqsSukQlVLw)8<`qX()EI$y^;AtkxYD#_Mjo)a~x*>AtU(Ry0ru4}iCVbSlb+f1-I z3u!a+3wEE)WqoTd2VL1*-p``%^K(bSsNRUA{eo9r&l5_;QdN;%=j*ZG zL^jjP5*$e|l79e2BLY2SrUU?OClv@M@?B6==(dEMB%x!bzMqs3YVlt_4k z4*YE{qA33n^DElR4bgx=Q9ve+v-+JbknHZ%X)IHOcTibj=uu(xVPW)(!ni^2?(>On zG&vM8tF^<#lWomPQhs5qZTZ$c;yW~HwK4%)%e1W};*clWQvVYZcwZ=1hEzY@KUrG7@9x@&|NdTD;X1yfXw0uJdvPqRVFiYzbVro@~9MhB{XQK}~#+m?Nyo9tJA%5FS@Y zc2KedtaEsyR?)4qt^I8H!28jSXe0ZNJ~njV)`>fVpAR1Wxb~Nk?`{lij!%44{;>RL zy!>#y{MoqunB@je-MFw(xpnZ%;juf{@UhMPqhAgmx|4tJolk!B`ybvfe{tm8 zpY0R(&)>UxYv9iFkH(KZ96$D_{V#3}VDHut8=Kt7zPHbSGKCa0F$I7IrTGT^&z03u z50ZM1?obG%;6Nc@tyX%Td{dwpMWv@BkZ3LSY3~aLkyGYDty>K5coKDvu`V2qG1*)@ zVNcC7(2IiAXM0xe&HWsE)EGM0xWM+0y#Mx%w;v53emH#i<71xMRFFgj zoucEIw2817a-6r2Oh{!s4LeTKY6z#{O1G{kkPtty=QxtYYd6a&j6jz|_O6whHrGvM zbC6b2rz;zZjBnm$UuA~!g~#Jo{<+6}Bl*egaxQOcrSwW&9F?-V9_s9~7es{5P|u;9 zERREgB3IBC9TkAz^3&-8uGK{Tlt6Q>_i=hwPGgxqeFTGV*4b}bU$Yl2TX$PDGDj01 zmHK5Ff1Un@n=FRGyriQ#_=r7WBj13IB!#*zGIvxp+qE)<)5er%#NL|mHX#OW{v%gO>FlKSqH!V9uD8p;NO#&uJ!-` literal 0 HcmV?d00001 diff --git a/co3/__pycache__/database.cpython-312.pyc b/co3/__pycache__/database.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5aa06660dc2cd5490e05089118ae2cb93310f3a8 GIT binary patch literal 3967 zcmbss%WfRUv1gyN4?aXWp+r)0Q#NC)LoN>qVnwzU$f946LL-sl!(PVCncm%@XQ$WQ zvm}>Z0ZgC(BoIK+iAr*?54i~XgCKv9i)hjiv48;~k3(*>7$AU8sp@%fNj)wZaBHfn ztE+43+5FqkP?5m%_gSO9S0LmcNW@PjLJn^OvP~RPBaY#uJfmj7JME=f=~~)AUdGF` zvbC(nvtF*1ujMtK^UPMER?v9fE4E6tl0j008_Q?nLyq2j=z$SZwc!+bpE%}i;uIdF zBHlUJGHExvlm&2VJ5V$b zbcs{GW^?YqxuChheUS3rq&I$Xea_+1U15Q{!WC6b(ea$3>MYqFQ(&?bEp5jyxd$S` zXI^p~2;qsd`n&iVYqdQfR-3Nfq;8lS;#WnhEfkl4=Od3G`XOjqZF;aQ&MxwEi>Kc07txA1M&3b0}xTS?)HlfF%AMP70;x5)#b@u`)aEO3W_ zn;YN`1DzkBM}USjOm>X|T^OKGIYrPi)-6@aeKU4&-(*qn`}tNFc{|EteKvj^{to{F zV4L)e9}{5en2QfkIBY0OoCD@3A++*%p-&Pb1~P2bFJhA z2kkWDHK@ik`zux>jh>I0blH-})un`mE0!m0=2&s&=d|7V9;a%Ws*bMu7K7i2Xhp)d=Xd_RLJgp zLyAs&ZmCP5Y}>+DkmP}Qf$BC^6C^p*B9?WOtW~-Yl|T@Gftyqzv=QhV(T*3W4w|l_ z+Aq3Ez}MQJMm6cGAgr!>=obgg?RbHDQ(K`oy+E@H7#Ps%r~n&Cn1c>&cw&ipUbmX; zd~dN*=$ml^lQ;_cc`M9bi3tN#l);z={hZ}uvG&V@LG7170T03mS5o~9b`UuP@(MGR z((isc--K>5uUZW`zaZ>R3%aYChsa~oR`bFSgeMyFw)m0$#qGG-?)FU!j&uXdT0a$+ zS2bo$;StvWY>9iIidv_ExzGqY!&eLP7wGhdr$4nZBUqd9~)L0nhsFd*9`K%RbnV^j?G#$W}+ z7RD(7lRzN8;yN5MUttgD0VEUm8?GNF`@%cnIKt5){8=E}z-6Ah4#G*CF!N%sP`3_U znmU3j|20T1_h~Nbq>|WY$+hILqnj? z`_4SfDqHwIgaiz!(kp(Kx=MAp9(Re}CPUjB10|tg=*3^;`jC1!7H|@y)rm{um7gV= zp!c6%6v2l$elR1r^RARa-Z$iF@UKF@Q~46Wel9d~eI(Xa4H@$&he^9Z{xe2KE<7}+ z<@bR+7C+2E9lwi!K({5!@ILuGtLMf|-ymIb-&m}qM{wR!GoTa#SFlb&bm4I(k~D~803JZVNh7nbjUvqHw( zAgsy&Hpt_V(|3AXy@%%H|7!x&CtMWtR6pSk^pjpV<`T`ha@>+zTelvXQ%_rx1P)8? zdCrj25YS{Gf?)J4XJhQ>eH2hV%94d=Yq&uwsm1pyX^Fv;qX7CP-FGe9<4iu~_pEM> z>%&O`X!>2)r{(~F*GnUhN|RreCilyucdl(+dsKd9r~JxZd1n9RS2q{-%2WFgme037 ze`rp;z!^UQU2qpac4yFY8goZK&z|r2IqPdl@mPw~L7PX@IUMU+>}b&3jQw~DOq3%CPUcH4G-Dud zL&kLwR_6ggmoJkkXw!SGE)_zTNkQOVaaYo_A-?I8e%W4Uy;~`$Qtj{{k3s)rC5YE>O-n}Jur2dFy zF(2+G`hu=3OXAH-&t3UFTsPy(k?uUY!N`|UD|oilgz2?^uZ5E zZur}jnZ0nB2J8T_CodV<^9MP-U}UGF1;7&CxrBEv;$^av5f3nkA1ci!dl4HW*_qI8 zG`TVgR}RY&Hh3@(mjawM{T#Rq-l5aVa80O&Elo)6*S==OeMn;EL#cvPbal~g4LLe3 zxs>`gQ)uwuIvfG?4{=Wp&jUic?zlU@Gv5jWds$*b$68Z}9Hb4y_%>BEGKXh~G4c%= p{}-A52LCAhJuXaajz20)>=Y*MUED3ax{>>D?y@oSgaFW={6BAl$DsfK literal 0 HcmV?d00001 diff --git a/co3/__pycache__/indexer.cpython-311.pyc b/co3/__pycache__/indexer.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..772dcb5c3a2de57fe478b86129d89b20c7406512 GIT binary patch literal 16212 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 literal 0 HcmV?d00001 diff --git a/co3/__pycache__/indexer.cpython-312.pyc b/co3/__pycache__/indexer.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1507dedee96c53534792a90122b16208e5ae731d GIT binary patch literal 15090 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 literal 0 HcmV?d00001 diff --git a/co3/__pycache__/manager.cpython-312.pyc b/co3/__pycache__/manager.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ac0677989b4dee6de0dbb94681e445bcdf4926f7 GIT binary patch literal 2097 zcmb_d&5ImG6tC*(o|*0JhcSL+QAuqum?5$EpooVM5?vJ!S%fSE=F-%5*UYr(u4=1# z+|01TAPc(&^d@^2ye#qS|M22b`r<(^-gX&7;+}l3re~dnTp||q>-VbaebxKDs-G7Y zd;;T2Ks&xm$nPjjhf^`*H-XtFF=>;S#!gBzr|nSWYiTWW+ivEyJxUxByF27TrPQtu zyjFeqqkoG_-WA&S?`WRqLbHz2%oMy3uSY#DyNT?wm=}DL8^IK8;6FUGzGfJMA1`mRHbQub)Yr)#%n-! z>8^u^71JH^gL9AGcRKVwb;t)~kM21gCw6w4aqSEGz5f~6CWSSCvaViTQ&B$?vM{T;Rv(K97$pmp zs_tr}-mqUbDNm3ObOY2aSpdeMqY>H5^ci4I#d3m+4y=3)$qLe@fDY#l`H8e^F>Sjs z@)VM-?YM1E)K4L!0kSuPlqSga8F>!m#*FL_nytCAQQ?8VMG5g4jL8J%$F?eLMJYGN zA`AeP3f9%Cp92a^;9Hdqz))57#IOidg$68f*ampuEK*X!F~OA81b8uP$gsTB@Q)$e1i>3T4WY%8%pu43H*SO7KBkv*fO}x=mCb3R zMbjEW1)*^(Y&{FiKG~+*B*b|;2IPRQx2RqM3Hre`BJEhgpc-R(9)4vr3=^3YVK{uI zDpN3>c^=ly9FP(D^*q~izg(Cg3aWTAkhkbw1ZIDxDL$wAEKD8H^4z*AKFsn|V7*2B z9wvN1HHK_ZeHuvB%;MibrZeYZ*SHB}ME+P@`K7t?^l@lRM!yJT)@LJ2x^QcW;nFns zYT{+wy^O^6(9>l6WKZ?U?KNDSI-1Dr|MugWfsBUpQ!gmJddkOo>kQUh@=Szb>4#ya z;(m(!d>DSx=V`UF6o$nh7a@R`jh2-0XdQ2_GBwxOr_-vFrK@h=@#sXg#b^N{<|mx)0|GUH*-{_Q(fkhbJEY0nMrOPXGV_ literal 0 HcmV?d00001 diff --git a/co3/__pycache__/mapper.cpython-312.pyc b/co3/__pycache__/mapper.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..598cc8381d4a6f57e65e0729280be82801a95df1 GIT binary patch literal 8703 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 literal 0 HcmV?d00001 diff --git a/co3/accessors/__pycache__/_base.cpython-311.pyc b/co3/accessors/__pycache__/_base.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2f2bd8acc34cb32529245f4d3daae2ce414a6eb1 GIT binary patch literal 2329 zcmaJCO>Y}TbauV|cH(|u(!~83zA**60;!@OLMm;7ilU|{NEBaI>z#4DVb|-RtMqFPq2B}(0`L;{ZJ0I@K}4~Uqf`||(5kIEv1&}xF zPCBV-O0LE2w3Df3B%QFcPOh3$kcvJ*B)Nu2YFkBU2Yvxm$4G1*mD0Zpwxsylb;E1G zoF%kwv~7=Argshac-ymV4n)Fqn{{hJP@Yk>^0yd$F}tq#q-m%)0aPw)Voa_1OV5W>%eW;@I1q8P!e5I&PdJI z4Q4nL4B_V`FT9}51*=KV zO~bKF!?u^P5jY`KhhX3qb0I|DGJd-Tp(I$C+@KIBnL%vTantq0u3HwNMA~-E3{xnQ zBj_0X_Fn?Di8@LL=|BZQ&^&smh{uuC19wWQuW@SE{Y1cXaUSDm)0Kwn&%x6qUnv}X8s$)2fZO;OpjFhL zII*s6D8}5fLCZST3Y?W6DvdT#LgisMslKTgSMSW<0yA8EaLE> zoJXJg9mSJPAlR~)2)Eu#hSb5i^N;%u=HQ_1P&Debm1GMFxJ+uL6w84YCd_8y20yky zJwIjCxNEoJF$&*&mDKzU$fE=@5kEgcYC_F0e=IL_j00LZIuiIG%g11W&jMOSd)fTP z#cuZ0lfvY;Z*IMF@5|k(N^h#NTR77zoOxV0_o#4gw{W3XxUfF+q=>gZd|WI)DwZGI z+AW^#70<3;*_iF;k8X6jsUkZJ3TMoN!4yu&wA}?_6M29`Sd5af7(L%RT1RDvU$84m z<{eE%9Sy=5-Q;CMtq46&&A*Zm`%&2jEjy7W8Ga~+oYge#Hle!dLc>hTI5Y7y{V{In z^fonh(NwvAC}bVzWTMT;5c?`Oe9fb`y;3|#MvULI{ZzDRQmD!>%5~@|4VQ3{NLlkT zPq1Vx=}?7GS}PMH>3Y6!3XbqgfL768IrMVz?u}mI^m?YBJvu;2`hzEvC%2CECf{HG zbT2=-zVglMTc^Kg_m>{hH8Kfl|}&+X>tdil9-YEI^fiIA1lnVC{b6e)Bis_TA6 z*BzI%Z9(UB{bt*+hbu{4C$6dM>=2yuQ(>Eu{4M&Ce9 z#!~|%&>&v!kvatLtBw0k-a+{oqC*&usCU1en&p_IYptZB(VkH&!xuEp&AzKdmaZsd3A}Ohr zx%gu+nCJ>J0PHP6iOP_vewMlz1o$IX0hy=){u7`ee_y)bo9~qs{HoQ nL^m9JXsSCp`smf}=;)(2x}#%|IH8C*{x^Oq<$u0lReJO{Y|%Rv literal 0 HcmV?d00001 diff --git a/co3/accessors/__pycache__/fts.cpython-311.pyc b/co3/accessors/__pycache__/fts.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..fa6fd3283ffd99eb9b800a5b9016ab36e30dd298 GIT binary patch literal 6623 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 R)O8~mi0zF1zd&C;`_IX}<7of@ literal 0 HcmV?d00001 diff --git a/co3/accessors/__pycache__/sql.cpython-312.pyc b/co3/accessors/__pycache__/sql.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..15d6bc30874ef8fcea1e7de7d1d7fd72104ffe30 GIT binary patch literal 5255 zcmbtY-ESMm5#PJx@lz5dQJK(JO={VS^PxJCniwn!=EPf3l#e`m z?-+|Ng(`)B(r(aLXbZ_ri>Plg?6xkNqAt)sAV6QJ%8Asg4LC>&G;eN{z-gX3v&SPT z+HqTSr5ow2RYBHhcZp^CSLdH&6$>X3$Oe2aHcih znrVx-2}C4XV3Ay^EFN!%cCfA;5y=?QLW@Leq7ki`woQw@AbUx22E;oGQnck`Y(xdy zb6mA%;Maf5qD-CA={Pjxq?(+e*qgV~`bFq{Dw(9FX)vt6NOjdp8`-F6hbPskysk2r zW&0;ycn)|vO*)G?)C)hj`qptEKadNs}sdVOl&Vq4p(dTF^X;eoa0r z{VF&wTFyK`iv;&l6fb!k)&z-qZDDlVa@Z4rXA5PPNdfoS?y9KjqpGD&sV2QhSQ|>g zL%tXpoG~(V(9ERR;HZ(zXK2x9KMUkL!nnmPu`M6Xc>W&H}*Yn(@I5C0U0{`1EMc1@g{` zEB##Lj>(~$Y~hff3d@9&xS)}^_%gXd;!;6?W2-ZUd$8jdJ+?oQ$f_BdNZ7$dB4cQI z9qUbr#HqZhS9-#UgjLAVL{4RD#!Mst5KXZ;p9u-zO>(JW=@WCD+f?E;>O$EYaElYG`M_6=7g6s`jW+?t9pt<(>jL4Zz(P2G!y-5jM5sEH6c& zC|#<|v?RXX>H(Q~=~88^8Me?5@}dbv;Z1P$zo_}4In$?P z4NEcextzf)swqw^ax`Hi+XI2N%d)41}Cpm zJH&su&oY6Bp2`J@!u^RIf>4({nc#9~y6bEdtLs2inok2+Ae&u1rO@?o`_=yUBS)`v z{^XgJ{3?B~W8g25qu0V?*V}h)w)d=buK3EkhRUsnwj?pqa*K$~Ew{X+wX@XpuTKJ` zV@%*mydHVXKc1`_38t?`%4^W54-K>R2L^puW?i&7O-|?KqQrJsRnA?<;VKPfUKUAF zE|OV)LkBcxc?PtdZ#BE^yP>lvxF9HsMbBlSE?SG@5P(8c>8w_XA$C(bo7D3fO(YH7 zjQVXElMd4swJE#VR1KCTlomQ_m-KEZadStw%vCJ>w&UQ9T0L`MOP7|3+b>Brwu9Na=!pTtxS2!bj zl7>?B)@0!p2H=EuG>Aa67%ciPi*6PVd9S3N13&~F*ec3#%BBsLQB-B($a6;yPb#PK zlob>;rJ|oytQo36I{Ru`1Bc3;-F`iNk}Ad&X1K~;lhW!`uhekwCJ zTSlcdBMbJ(TPE0u+p8LMYWqKqc`wg7hqi4v#f*F|F;y5+^fXu-@=@?+`ApVSEJNX) z5XBC0Lu8H93Mlm|1!KTJp2}Q-_lzE!m^?Oqcyim!sF_ptg5A_qiqRB*|Ed@Zrhu1` z9GpmW+c<-1lyQw5O;8ceQ^4=#b<4!Cx;Lq2mApxnVGtULY1B;ajaDVM&F5;N;5Zbd zSq+ZAwkX381=$!n*Jum-8vL-Y0|9r;0E!2(J%r>Cl40!eIxg0hPtQ;W!P;pirkRnk z{jN!Ezq=J%*3+4^#YSLkG{oIILw9L=Fmy1C&vr-y`$I&r5=NFi3mow;tJ#yhu5; z%jNZ~NA@AF_54HU4kB}CX=sJ6NA{FPooLj5p?}r7IsjQq*+1sw?^Ul3`@~Fu$DI|Z ze0kh~2rm^qMOhQTJ5|Qddy6u=ujZqRUQI&Bcd6pTHHrJfW|!~uLQ6oYX>o$ok8Kzw zyQ3!X)!sAyF-{7&jpZnjl*$vH||BM`vpB8Qc zxaZE!t=#_>01Tl0w)h+0Mc-O@a7)JSPc(W+!xzur|rwZ7b!hG#SnXT z7;ZLZVeq}ljHy#e=0UCxLK=8}%MMKE;i?;W`!P+jgOKd0I>v&6<9j6dV#5%Xb`#WM z=qm9$7DI45ELQoP#W2gYn^DSTna(S46LdK5nD`3HE!1GTFZ{#K_mUAd1tJJY6VKt6 zBnZL{(sP6C`5S4uLHa%<-G3(?H^^@IzwIT$Be%Wq<>9s;$fy1n1fk>n;OhP>J>~lk NuC)(+Mv%iT^=}1pje7t9 literal 0 HcmV?d00001 diff --git a/co3/accessors/__pycache__/table.cpython-311.pyc b/co3/accessors/__pycache__/table.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a77af73000d0f22e21e7096bcd6e600fce17d3e1 GIT binary patch literal 3851 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 MEycY10G^)W|JkTgkpKVy literal 0 HcmV?d00001 diff --git a/co3/accessors/__pycache__/vss.cpython-312.pyc b/co3/accessors/__pycache__/vss.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9732100ccb2f1aa8e92b6a274fa9fe3b716f2afd GIT binary patch literal 4247 zcmb7HTWk|o8a^|gvFBoEOcF?NQZkL%1~(+(y4?oKEh+3S5LFvWktsXtcqWOHu_w$K z192T~9wMz%u?pSpic|=dzJY>N_G$Zw`n1x%*b1$!ft4bam%bT7wcS4Le`b7B2vYaR z{?C7I|D5yvw{!j#2nYxYbC??cCve}9MzydNX8j54ZP?sz<|VQiRjcbZFmmBzXb%%5Pl8X`N4(m6Cvsnh}&^{Dg$f*pE*vYMBC zZKbj(>Vr1h(B@Q8^)66Ro<}@V{i;tBR1W^UCXRbmVS$bMbLbis4UD2lz!uMsj@C9s zS7efkfj>FSdJ4$jsGG=w+AWK87X29ju5N)qm_RwT@_)5L4d_^IPaP-H4q!aO1T-nN6s7Kh)LoP!1u61K>V4vG zUK&{(DK(#Xc%V3RzA$t?f8v9D@WKlZ9cU_hQEU5CY3ovUF}plm>>Ma`4iq~F3!Q_j zorhPYck_ zd9)@Lh81FTCQEq;{eLNCKXT+o5zLttJB$5uFQ4G@@E zDOJn+Il!2$un0~}BER`MAu^E06ABFmv#s%%_5NP6gb?SfMX{qGcI3rysViLU+F$6} zzuI*$H~h%o=@?R1LF&qLUGA9~SX3>bX#*Ne!&9oHDP*M;SXYJM$7)DHo%v4WQ zBvcZG+Fr09NNEsUoyh5pPo`7T*xW_N_?mP~jwM5JW2oOjN^$3A+F!!3GO`yI;XWXa z$1P;ZyF{%{Z$z`g)s3RANLyG`Tb70L`*#15S@)hMUZr_x#a7Tm{fd#W)G zat~$IV((`8s%o2aEPS;VX)6Muf{O=ppRHa!=DeHlElY2QxgWw==6rM99B&Occo&Bs*lK?6SBfES`y>*1my8c5Z~v-tf+EiEXz!TTVm?EKP!Gh zUzZq|4WlssQd?yn@5u0HeObS=LR5vrWF=o~i==&hJA)c9CK-1_v0ADf+1jlZF!%pF zl(TFGkWmA-7`5p(Q`b^f7==?&@ShW}qKK5aAP{pU<-M2*)?-0r9IW+`{<>ui%0^0) zjdA&6k89FByL-lTBR-9RNf~g@=($u|I+F4IhS;Rsoe6f!s-a;>c97#pvO5`}%zijt zgtl4Bm{F$fCLA|RO&L$8;#R^)nZ*3yT1h%>9_UOOD+$#WCQKte+Z^T9Xh;CJkMMZCWwYvL(k8>!HKuUE~swo`Wu1 z51h7G8H6)nn;~bgJwRKzuBGkm%Wp1s=6`W8AN*xQ$_}>Pm;OHTan^A;5RHHH0v*VnCq zVZ?mh%>a$i-yegnb5N6rG68=mYeyqZHFj)N`+oJyLE)-lk_X!*;BDfGZQO?05P+tX%0MoZw@HatL+q zD1}~oCPvuSwXN-C7HYV;ZQEY<5sm}yKRj?wesMkyj^NxiedGoTH&5F~UTS(`%z43? zhhST_fG_JY9bRn7S)0Z&+Yc|V{_3mCBoWr;Cp7DfbB8t0Lfdsva>9Ga{T7LWKXHd$ zjE|TXp-C>Wn0%n@p(yGx3Oq(l|3>YPk@y{I`@xH-ZrHlek!vgRp#mRT{?#hKbKd)c Qd7q+MZ|wR3k=hadKlg&i^8f$< literal 0 HcmV?d00001 diff --git a/co3/accessors/fts.py b/co3/accessors/fts.py new file mode 100644 index 0000000..2a7cf9c --- /dev/null +++ b/co3/accessors/fts.py @@ -0,0 +1,147 @@ +import sqlalchemy as sa + +from co3 import util +from co3.accessor import Accessor + + +class FTSAccessor(Accessor): + def search( + self, + table_name : str, + select_cols : str | list | None = '*', + search_cols : str | None = None, + q : str | None = None, + colq : str | None = None, + snip_col : int | None = 0, + hl_col : int | None = 0, + limit : int | None = 100, + snip : int | None = 64, + tokenizer : str | None = 'unicode61', + group_by : str | None = None, + agg_cols : list | None = None, + wherein_dict: dict | None = None, + unique_on : dict | None = None, + ): + ''' + Execute a search query against an indexed FTS table for specific primitives. This + method is mostly a generic FTS handler, capable of handling queries to any available + FTS table with a matching naming scheme (`fts__`). The current + intention is support all tokenizers, for file, note, block, and link primitives. + + Search results include all FTS table columns, as well as SQLite-supported `snippet`s + and `highlight`s for matches. Matches are filtered and ordered by SQLite's + `MATCH`-based score for the text & column queries. Results are (a list of) fully + expanded dictionaries housing column-value pairs. + + Note: + GROUP BY cannot be paired with SQLITE FTS extensions; thus, we perform manual + group checks on the result set in Python before response + + Analysis: + The returned JSON structure has been (loosely) optimized for speed on the client + side. Fully forming individual dictionary based responses saves time in + Javascript, as the JSON parser is expected to be able to create the objects + faster than post-hoc construction in JS. This return structure was compared + against returning an array of arrays (all ordered in the same fashion), along with + a column list to be associated with each of the result values. While this saves + some size on the payload (the same column names don't have to be transmitted for + each result), the size of the returned content massively outweighs the + predominantly short column names. The only way this structure would be viable is + if a significant amount was saved on transfer compared to the slow down in JS + object construction; this is (almost) never the case. + + Parameters: + table_name : name of FTS table to search + search_cols : space separated string of columns to use for primary queries + q : search query + colq : column constraint string; must conform to SQLite standards (e.g., + `:` + snip_col : table column to use for snippets (default: 1; source content column) + hl_col : table column to use for highlights (default: 2; format column, applied + to HTML targets) + limit : maximum number of results to return in the SQL query + snip : snippet length (max: 64) + tokenizer : tokenizer to use (assumes relevant FTS table has been built) + ... + wherein_dict: (col-name, value-list) pairs to match result set against, via + WHERE ... IN clauses + + Returns: + Dictionary with search results (list of column indexed dictionaries) and relevant + metadata. + ''' + search_q = '' + + if type(select_cols) is list: + select_cols = ', '.join(select_cols) + + # construct main search query + if search_cols and q: + search_q = f'{{{search_cols}}} : {q}' + + # add auxiliary search constraints + if colq: + search_q += f' {colq}' + + search_q = search_q.strip() + + hl_start = '' + hl_end = '' + + fts_table_name = f'{table_name}_fts_{tokenizer}' + + sql = f''' + SELECT + {select_cols}, + snippet({fts_table_name}, {snip_col}, '{hl_start}', '{hl_end}', '...', {snip}) AS snippet, + highlight({fts_table_name}, {hl_col}, '{hl_start}', '{hl_end}') AS highlight + FROM {fts_table_name} + ''' + + where_clauses = [] + if search_q: + where_clauses.append(f"{fts_table_name} MATCH '{search_q}'\n") + + if wherein_dict: + for col, vals in wherein_dict.items(): + where_clauses.append(f'{col} IN {tuple(vals)}\n') + + if where_clauses: + where_str = " AND ".join(where_clauses) + sql += f'WHERE {where_str}' + + sql += f'ORDER BY rank LIMIT {limit};' + + row_dicts, cols = self.raw_select(sql, include_cols=True) + + if group_by is None: + return row_dicts, cols + + if agg_cols is None: + agg_cols = [] + + # "group by" block ID and wrangle the links into a list + # note we can't perform native GROUP BYs with FTS results + group_by_idx = {} + for row in row_dicts: + group_by_attr = row.get(group_by) + + # add new entries + for agg_col in agg_cols: + row[f'{agg_col}_agg'] = set() + + if group_by_attr is None: + continue + + if group_by_attr not in group_by_idx: + group_by_idx[group_by_attr] = row + + for agg_col in agg_cols: + if agg_col in row: + group_by_idx[group_by_attr][f'{agg_col}_agg'].add(row[agg_col]) + + return { + 'results' : group_by_idx, + 'columns' : cols, + 'num_results' : len(row_dicts), + } diff --git a/co3/accessors/sql.py b/co3/accessors/sql.py new file mode 100644 index 0000000..1ee0fea --- /dev/null +++ b/co3/accessors/sql.py @@ -0,0 +1,96 @@ +from pathlib import Path +from collections.abc import Iterable +import inspect +from functools import cache + +import sqlalchemy as sa + +from co3 import util +from co3.accessor import Accessor +from co3.relation import Relation + +#from co3.databases.sql import RelationalDatabase, TabularDatabase, SQLDatabase +from co3.relations import TabularRelation, SQLTable + + +class RelationalAccessor[D: 'RelationalDatabase', R: Relation](Accessor[D]): + pass + + +class TabularAccessor[D: 'TabularDatabase', R: TabularRelation](RelationalAccessor[D, R]): + pass + + +class SQLAccessor(TabularAccessor['SQLDatabase', SQLTable]): + def raw_select( + self, + sql, + bind_params=None, + mappings=False, + include_cols=False, + ): + res_method = utils.db.sa_exec_dicts + if mappings: + res_method = utils.db.sa_exec_mappings + + return res_method(self.database.engine, sa.text(sql), bind_params=bind_params, include_cols=include_cols) + + def select( + self, + table: sa.Table | sa.Subquery | sa.Join, + cols = None, + where = None, + distinct_on = None, + order_by = None, + limit = 0, + mappings = False, + include_cols = False, + ): + ''' + Perform a SELECT query against the provided table-like object (see + `check_table()`). + + Deprecated: String aliases + String aliases for tables are no longer supported. This method no longer checks + against any specific schema table-maps or Composers. Instead, this should be + done outside the Accessor. + + Parameters: + group_by: list of columns to group by; for now serves as a proxy for DISTINCT + (no aggregation methods accepted) + order_by: column to order results by (can use .desc() to order + by descending) + ''' + if where is None: + where = sa.true() + + res_method = utils.db.sa_exec_dicts + if mappings: + res_method = utils.db.sa_exec_mappings + + stmt = sa.select(table).where(where) + if cols is not None: + stmt = sa.select(*cols).select_from(table).where(where) + + if distinct_on is not None: + stmt = stmt.group_by(distinct_on) + + if order_by is not None: + stmt = stmt.order_by(order_by) + + if limit > 0: + stmt = stmt.limit(limit) + + return res_method(self.engine, stmt, include_cols=include_cols) + + def select_one(self, table, cols=None, where=None, mappings=False, include_cols=False): + res = self.select(table, cols, where, mappings, include_cols, limit=1) + + if include_cols and len(res[0]) > 0: + return res[0][0], res[1] + + if len(res) > 0: + return res[0] + + return None + diff --git a/co3/accessors/vss.py b/co3/accessors/vss.py new file mode 100644 index 0000000..46d119c --- /dev/null +++ b/co3/accessors/vss.py @@ -0,0 +1,100 @@ +import pickle +import logging +from pathlib import Path +import time + +import sqlalchemy as sa +#from sentence_transformers import SentenceTransformer, util + +from co3.accessor import Accessor + + +logger = logging.getLogger(__name__) + +class VSSAccessor(Accessor): + def __init__(self, cache_path): + super().__init__() + + self._model = None + self._embeddings = None + + self._embedding_size = 384 + self.embedding_path = Path(cache_path, 'embeddings.pkl') + + def write_embeddings(self, embedding_dict): + self.embedding_path.write_bytes(pickle.dumps(embedding_dict)) + + def read_embeddings(self): + if not self.embedding_path.exists(): + logger.warning( + f'Attempting to access non-existent embeddings at {self.embedding_path}' + ) + return None + + return pickle.loads(self.embedding_path.read_bytes()) + + @property + def model(self): + if self._model is None: + # model trained with 128 token seqs + self._model = SentenceTransformer('sentence-transformers/all-MiniLM-L12-v2') + return self._model + + @property + def embeddings(self): + if self._embeddings is None: + self._embeddings = self.read_embeddings() + return self._embeddings + + def embed_chunks(self, chunks, batch_size=64, show_prog=True): + return self.model.encode( + chunks, + batch_size = batch_size, + show_progress_bar = show_prog, + convert_to_numpy = True, + normalize_embeddings = True + ) + + def search( + self, + query : str, + index_name : str, + limit : int = 10, + score_threshold = 0.5, + ): + ''' + Parameters: + index_name: one of ['chunks','blocks','notes'] + ''' + if not query: + return None + + if index_name not in self.embeddings: + logger.warning( + f'Index "{index_name}" does not exist' + ) + return None + + start = time.time() + + query_embedding = self.embed_chunks(query, show_prog=False) + index_ids, index_embeddings, index_items = self.embeddings[index_name] + + hits = util.semantic_search( + query_embedding, + index_embeddings, + top_k=limit, + score_function=util.dot_score + )[0] + + hits = [hit for hit in hits if hit['score'] >= score_threshold] + + for hit in hits: + idx = hit['corpus_id'] + hit['group_name'] = index_ids[idx] + hit['item'] = index_items[idx] + + logger.info(f'{len(hits)} hits in {time.time()-start:.2f}s') + + return hits + diff --git a/co3/co3.py b/co3/co3.py new file mode 100644 index 0000000..0018d87 --- /dev/null +++ b/co3/co3.py @@ -0,0 +1,106 @@ +''' +CO4 + +CO4 is an abstract base class for scaffolding object hierarchies and managing operations +with associated database schemas. It facilitates something like a "lightweight ORM" for +classes/tables/states with fixed transformations of interest. The canonical use case is +managing hierarchical document relations, format conversions, and syntactical components. +''' + +import inspect +import logging +from functools import wraps, partial + +#from localsys.db.schema import tables + +logger = logging.getLogger(__name__) + + +#def register_format(_format): +# def decorator(func): +# self.collate.format_map[_format] = func +# +# @wraps(func) +# def register(*args, **kwargs): +# return func(*args, **kwargs) +# +# return register +# return decorator + +def collate(action_key, action_groups=None): + def decorator(func): + if action_groups is None: + action_groups = [None] + func._action_data = (action_key, action_groups) + return func + return decorator + +class FormatRegistryMeta(type): + def __new__(cls, name, bases, attrs): + action_registry = {} + + # add registered superclass methods; iterate over bases (usually just one), then + # that base's chain down (reversed), then methods from each subclass + for base in bases: + for _class in reversed(base.mro()): + methods = inspect.getmembers(_class, predicate=inspect.isfunction) + for _, method in methods: + if hasattr(method, '_action_data'): + action_key, action_groups = method._action_data + action_registry[action_key] = (method, action_groups) + + # add final registered formats for the current class, overwriting any found in + # superclass chain + for attr_name, attr_value in attrs.items(): + if hasattr(attr_value, '_action_data'): + action_key, action_groups = attr_value._action_data + action_registry[action_key] = (method, action_groups) + + attrs['action_map'] = action_registry + + return super().__new__(cls, name, bases, attrs) + +class CO3(metaclass=FormatRegistryMeta): + ''' + CO3: COllate, COllect, COmpose - conversion & DB insertion base + + - Collate: organize and transform conversion outputs, possibly across class components + - Collect: gather core attributes, conversion data, and subcomponents for DB insertion + - Compose: construct object-associated DB table references through the class hierarchy + + Note: on action groups + Group keys are simply named collections to make it easy for storage components to + be attached to action subsets. They do _not_ augment the action registration + namespace, meaning the action key should still be unique; the group key is purely + auxiliary. + + Action methods can also be attached to several groups, in case there is + overlapping utility within or across schemas or storage media. In this case, it + becomes particularly critical to ensure registered `collate` methods really are + just "gathering results" from possibly heavy-duty operations, rather than + performing them when called, so as to reduce wasted computation. + ''' + @property + def attributes(self): + ''' + Method to define how a subtype's inserts should be handled under `collect` for + canonical attributes, i.e., inserts to the type's table. + ''' + return vars(self) + + @property + def components(self): + ''' + Method to define how a subtype's inserts should be handled under `collect` for + constituent components that need handling. + ''' + return [] + + def collate(self, action_key, *action_args, **action_kwargs): + if action_key not in self.action_map: + logger.debug(f'Collation for {action_key} not supported') + return None + else: + return self.action_map[action_key](self) + + diff --git a/co3/collector.py b/co3/collector.py new file mode 100644 index 0000000..3880504 --- /dev/null +++ b/co3/collector.py @@ -0,0 +1,109 @@ +''' +Defines the Collector base class. + +This module is the critical "middleware" connecting the primitive object definitions and +their representations in the database. It operates with full knowledge of how both are +defined, and abstracts away both the prep work for DB insertions as well as updates +trickling down the primitive hierarchy. + +The `src` format target is re-used for both canonical tables/primitives, as well as +_conversion_matter tables in tables/conversions under the `src` format. The latter +is meant to extend those attributes that are format-specific (i.e., would change when, say, +converting to `html5`), and thus need to be broken across the format dimension. + +Note: + Despite the structure of the database module, this class does not currently inherit + from a super class in localsys.db (like the accessors and managers, for instance). + This will likely ultimately be the model that's embraced, but until FTS (or other + groups) need a collector, this will be remain an independent class. It is, however, + named like a concrete subclass, taking on the "Core" prefix. +''' + +from pathlib import Path +from collections import defaultdict +import logging +import importlib +import subprocess +from uuid import uuid4 + +import sqlalchemy as sa + +from co3 import util +#from localsys.db.schema import tables + + +logger = logging.getLogger(__name__) + +class Collector: + def __init__(self): + self._inserts = defaultdict(lambda: defaultdict(list)) + + @property + def inserts(self): + return self._inserts_from_receipts() + + def _inserts_from_receipts(self, receipts=None, pop=False): + inserts = defaultdict(list) + + if receipts is None: + receipts = list(self._inserts.keys()) + + for receipt in receipts: + if pop: insert_dict = self._inserts.pop(receipt, {}) + else: insert_dict = self._inserts[receipt] + + for table, insert_list in insert_dict.items(): + inserts[table].extend(insert_list) + + return dict(inserts) + + def _reset_session(self): + self._inserts = defaultdict(lambda: defaultdict(list)) + + def _generate_unique_receipt(self): + return str(uuid4()) + + def add_insert(self, table_name, insert_dict, receipts=None): + ''' + TODO: formalize table_name mapping; at class level provide a `table_map`, or provide + the table object itself to this method + ''' + if table_name not in tables.table_map: + #logger.debug(f'Inserts provided for non-existent table {table_name}') + return None + + receipt = self._generate_unique_receipt() + + self._inserts[receipt][table_name].append( + utils.db.prepare_insert( + tables.table_map[table_name], + insert_dict + ) + ) + + if receipts is not None: + receipts.append(receipt) + + return receipt + + def collect_inserts(self, receipts=None): + ''' + Collect insert-ready dictionaries for the core primitive schema. This method is + effectively a light wrapper around the File and Note-based collection logic + elsewhere in the class. + + The overall collection scheme embraces a session-like sequential update model to + an internal insert tracker. The sequence of insert methods is ordered according to + the schema hierarchy, and higher level inserts dictate the scope for lower level + inserts (all methods check and populate the same `inserts` dictionary). Calling + this method flushes any existing inserts, ensuring a re-scan takes place across + calls (or "sessions"). + + Parameters: + skip_updated: whether to ignore primitives with existing up-to-date + database entries + + Returns: + Table name-indexed dictionary of insert lists (of column name-indexed dicts) + ''' + return self._inserts_from_receipts(receipts, pop=True) diff --git a/co3/composer.py b/co3/composer.py new file mode 100644 index 0000000..6161518 --- /dev/null +++ b/co3/composer.py @@ -0,0 +1,89 @@ +''' +Composer + +Base for manually defining table compositions outside those natural to the schema +hierarchy (i.e., constructable by a `CO4.compose()` call). + +Example: suppose we have a simple object hierarchy A(CO4) -> B -> C. C's in-built +`compose()` method may not always be desirable when constructing composite tables and +running related queries. In this case, a custom Composer can be used to make needed +composite tables easier to reference; in the case below, we define the "BC" composite +table. + +``` +class ExampleComposer(Composer): + + @register_table + def BC(self): + full_B = B.compose(full=True) + full_C = C.compose(full=True) + + return full_B.join( + full_C, + full_B.c.name == full_C.c.name, # TODO: is this fine? or do we need base table refs + outer=True + ) +''' +from pathlib import Path + +from co3.mapper import Mapper + + +def register_table(table_name=None): + ''' + Registry decorator for defined composer classes. Decorating a class method simply + attaches a `table_name` attribute to it, setting it to either a provided value or the + name of the method itself. Methods with a `table_name` attribute are later swept up at + the class level and placed in the `table_map`. + ''' + def decorator(func): + if table_name is None: + table_name = func.__name__ + func.table_name = table_name + return func + return decorator + +class Composer[M: Mapper]: + ''' + Base composer wrapper for table groupings. + + The schema is centered around a connected group of tables (via foreign keys). Thus, + most operations need to be coordinated across tables. The `accessors` submodules + are mostly intended to provide a "secondary layer" over the base set of tables in the + schema, exposing common higher level table compositions (i.e., chained JOINs). See + concrete instances (e.g., CoreAccess, FTSAccessor) for actual implementations these + tables; the base class does not expose + + Tables in subclasses are registered with the `register_table` decorator, automatically + indexing them under the provided name and making them available via the `table_map`. + ''' + def __init__(self): + self._set_tables() + + def _set_tables(self): + ''' + Skip properties (so appropriate delays can be used), and + + Set the table registry at the class level. This only takes place during the first + instantiation of the class, and makes it possible to definitively tie methods to + composed tables during lookup with `get_table()`. + ''' + cls = self.__class__ + + # in case the class has already be instantiated + if hasattr(cls, 'table_map'): return + + table_map = {} + for key, value in cls.__dict__.items(): + if isinstance(value, property): + continue # Skip properties + if callable(value) and hasattr(value, 'table_name'): + table_map[value.table_name] = value(self) + + cls.table_map = table_map + + def get_table(self, table_name): + ''' + Retrieve the named table composition, if defined. + ''' + return self.table_map.get(table_name) diff --git a/co3/database.py b/co3/database.py new file mode 100644 index 0000000..2b46052 --- /dev/null +++ b/co3/database.py @@ -0,0 +1,87 @@ +''' +Database + +Central object for defining storage protocol-specific interfaces. The database wraps up +central items for interacting with database resources, namely the Accessor and Manager +objects. + +The Database type hierarchy attempts to be exceedingly general; SQL-derivatives should +subclass from the RelationalDatabase subtype, for example, which itself becomes a new +generic via type dependence on Relation. +''' + +import logging +from typing import Self + +from co3.accessor import Accessor +from co3.composer import Composer +from co3.manager import Manager +from co3.indexer import Indexer + +logger = logging.getLogger(__name__) + + +class Database: + accessor: type[Accessor[Self]] = Accessor + manager: type[Manager[Self]] = Manager + + def __init__(self, resource): + ''' + Variables: + _local_cache: a database-local property store for ad-hoc CacheBlock-esque + methods, that are nevertheless _not_ query/group-by responses to + pass on to the Indexer. Dependent properties should write to the + this cache and check for existence of stored results; the cache + state must be managed globally. + ''' + self.resource = resource + + self._access = self.accessor(self) + self._manage = self.manager(self) + + self._index = Indexer(self._access) + self._local_cache = {} + + self.reset_cache = False + + @property + def engine(self): + ''' + Database property to provide a singleton engine for DB interaction, initializing + the database if it doesn't already exist. + + TODO: figure out thread safety across engines and/or connection. Any issue with + hanging on to the same engine instance for the Database instance? + ''' + raise NotImplementedError + + def connect(self): + self.engine.connect() + + @property + def access(self): + return self._access + + @property + def compose(self): + return self._compose + + @property + def index(self): + if self.reset_cache: + self._index.cache_clear() + self.reset_cache = False + return self._index + + @property + def manage(self): + ''' + Accessing `.manage` queues a cache clear on the external index, as well wipes the + local index. + ''' + self.reset_cache = True + self._local_cache = {} + return self._manage + + def populate_indexes(self): pass + diff --git a/co3/databases/__init__.py b/co3/databases/__init__.py new file mode 100644 index 0000000..17bdc87 --- /dev/null +++ b/co3/databases/__init__.py @@ -0,0 +1,3 @@ +from co3.databases.sql import * +from co3.databases.fts import FTSDatabase +from co3.databases.vss import VSSDatabase diff --git a/co3/databases/__pycache__/__init__.cpython-311.pyc b/co3/databases/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9e9cc9d3c81e5cfefc81501c27fc210538aeb835 GIT binary patch literal 335 zcmZ3^%ge<81Tl>Ysp&xaF^B^LOi;#WIUr*?LkdF*V-7&ryk0@&FAkgB{FKt1RJ$TjP%r{U z62-#EP|2dn`Vyo`lkpa#7Led}3kh~fEJ;jCEKUV+!-C;lKTXzKg30;DdMQx(V!h(R z9CV?ylHwv3pn>S(WyQrstU&RV44*;v{c_gN$j?pHFV0Ob(s#*EF3nBND=F45D9X=D zO$IXZ^Gfn_^3(N!_JJ|nPW|}!%)HE!_;|g7%3mBdx%nxjIjMFLuXXO literal 0 HcmV?d00001 diff --git a/co3/databases/__pycache__/_base.cpython-311.pyc b/co3/databases/__pycache__/_base.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a8721769c561362fb8cb4965e87c7703c6b636c9 GIT binary patch literal 3140 zcma(TO>Yxd@U6YJ*Rh?1q|}f&@DPcFrNpLc4;4j~fE4J#OvNH4{6;LL9w|i>oJXx_T`j3{u3E8r zycC!7n3bq&B~2j_!pKT8P|8LgD}+3S*Bhl&gj^wJe2bWg#}VMb>vPhka+Tz@zYtx@ zD{lItA=rg-nF(R@0Ka6{o3>zxr;z`N(J(3!O?=QW*(&2@U!VL$ePsU!nCyUMCB-DA z$Y+E_ODc=9n5mox4vUu(EDl&iVp=K5G{B;Wnd%lPjj)s%+aiwve+sWRN@<{iCkLn* zpeBZ>qd?V$sAFalw2zx3;CagPc+qf-W$?_^4BvNGEBju%iMr=+xgSt41)aoq|8D?0 zWP?0{@9+qlxk2>44v^>{!=T&-2_GKF1Odfef`l0qIS>qxhy`pX6U+!muk?2x+9MIH ztHC;53ougwte;qB1VR=yegQQj)E}Q4yk;z0Oq}bJkfU36*|7AoQLeIc)S#vx;RQ*j zO>Q?Cch;zIY|iL)n^VJFsM=+E2_-JVsv8ST+-$Ls)?icbTW3zyHpM)3s)j=i(9>XF zgVrhoa|G2Jwxd%}!PklvZnv5X%WIS~(X<>!!d!=6J{aL~&KYtm^`^jJ|lUShee{DC!knT(rxrIz≀ow(T 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 literal 0 HcmV?d00001 diff --git a/co3/databases/__pycache__/fts.cpython-311.pyc b/co3/databases/__pycache__/fts.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3a19a9bba1109e4e96e6e5fa9503b7aaffbacf95 GIT binary patch literal 787 zcmZuuy>1gh5T3ms-(eCN8bloN0G8051e7Qeu|;U0AXM9&*0)O#y7ih}yGUmw9w1%b z0EBoMm*ylYDmo)0id4+pPh^YC?#+I)GdJ_i?3exhE};DQ{#T9|z)vz-2^+9^jo=a_ zNLGMmoH4>);c1`y750ljhdiusP;_*}BL*IvfDAu@>?rox2l$3xEj*UdDGcIYWDZ!l zcPyM5iJ2JViT3U1Z%&`(xpK}}au1DFL!+n0DYCohekms6Oxe82SRKf}l1(3vOHja> z1nw!H2P)(p6=7Y5b-k)UTkqB2RvBm6L}-;|WjD*Tk@JG^UY32Bi=y_}0F#!nXlPj) zP8sJ7E88J6(lx8Eut5{9hUq(_RqFJaO-Cl5Yc-j`uD%@|zz zcIJ}lxs5SXrKp5^fNF8QR=xh>#j1Bm>R@p~%id|@sja2KdoncWbdI#&*na&TKkN# m6+Bt)?iD;lJDE(?q4EAXwmnA$XjRESEq4IrQ`zB zCZ-or7EP##b*qk~O4j=b3!o5?1OkJafkkapC!SGC)ykKiQ@CN6MT~}F(F{YzlUb^` z6^8e-DAhN@Lb<|?Dg#1|TR2P`c!9Ngbu;j9IitR06X6eeJYzJ=r9Tz?j>ZT)%X!Kt ze$0=`om9g~f1Jzy^g%c%QicYCY+;zgveSJ$Uv>_jMq<0ZR-Rj^(ytYS`n_UTm1>8w zkD}W3j;dEyby>OBueBAG!X2cId#uMFh&@czU&=0qACnNWg2ONHR?z#k4AOn>{Q(|j F??3r1g|z?x literal 0 HcmV?d00001 diff --git a/co3/databases/__pycache__/sql.cpython-312.pyc b/co3/databases/__pycache__/sql.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..aa1f42420d01e153f20fa6c26a9d555c5f485419 GIT binary patch literal 3034 zcmbVOO>7fa5Pom{?>J6^A%#%NQb6D&jUiO3s-_9F5lJOt2|`7+2yGVcvvIX+hqs%y zkwA6TNc@~~D5VEf`Orfx+N#GK!x8nu3RFcaRUE3S>WwxE`lfOGpj!UbCc*qrv@>pLMif+A(0dKHX};J zj4Dwxro@CSY{bokk}#7>((F(=ge+pD%uc0K@KGaeb}3zEx6)0CMD*AKx$SSL^uRja zvfcvgM9VrOkqM$F7l_`$GOT+C*xe3!#>&?DRJQXkTx6*mo@Pd|LEZScW^3m)i)BOZ zmQ&2o>~giD8OI6*W?5D4cAeJF&lwtT3Oc4wo(L9T)3a_frB$>N<8InF3D!xl@Oj)Y zFvv zCcoLqw*lLBDF3`t!O4wRX3@sW>udvkWZ=V#W~IJ z-*l;}JwMCTS&eI^rK%h+&M~JPcXq@0)&(uCQmNVkgQ%52g+3q+$xRKlcn}e^BzRM+ z@m|#09uN`N4`B7=3WRoLczpTv-NVagoZ+e3D%W`A989IKa{%#f4L-49Q#48OlT zes|CEgfo1iHh~)Z>Zcor>t~$I8%}!YLHLA7jkf{jq!DsEhf1u%c)6frWZ%nL( zH)zBIY7H+1d$!(`@vA09K-QnjeNUvjYxEgt_u3yg~#H5 zGf0}HF$s1rR~pv@eA){{+@=kUFDMa?rIV!`i-&JTf>`#_(uBJRPYmP$_ucn;4{p9n z6Ym_fo`rXvDu8$vZNYqu#oHwU#|d5Fm?hhEJ3zNh;_HS4=EK=YvmFI#(RRVDlQKL3 z@N+)yWzDk6rHUwi*#f*;#d+D9n`In9dcczLPqvtCmn$Xf9pPgJ8{6D^Cq0WDcu+od zZbmK(TnL*Pq-WP5613W;_PH71?VwiC<#}ce%AN&yv1VDJTr4x#{eor#Ve%&$FJn8! z9m=)^8_MSy90`vm+f`Zf4qD~1CcG95xY(e~H8AGrrUEMd{m@J;S1enr6quS7`l5P8 zh32ylM#;<5EU~V^+A}dw^>z>MXuOBG8iuMilkm zQX~?8lp=@5mh3wxmp*lJ6Ik1eWA!&1J@vPo%z%>~ydR!e$-TRz-#NBaa&pJ9v=>L~ z`x>-468~;~r3P1AwpSAbWvtui^vGsbYV~1y~v71Hn0EV4#G5?LD|g;&cLP z80mxlk)@MP|JY-(+6@0@C69x7`-rkqB3K3W{ud<$$7_^hJl4Z3k?v9JOKti~62*Q`o#-9Zr9tSrb$U2b2 zSpccRhHK$ge)G@aJ0#+KoxlK2R=WCXlPg_2zL@aRjPJo#WIH56!}p<`a25himi@-P z_c6f7T-BWqEdm}^O_wzXae{l7^{ S6N_i-+nsIwj|uQ1D*pqRHnlwf literal 0 HcmV?d00001 diff --git a/co3/databases/__pycache__/vss.cpython-312.pyc b/co3/databases/__pycache__/vss.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7e6325496e43c1bb97e140531963f9a0da01c21c GIT binary patch literal 537 zcmXw#zfQw25XR5>(?q4EAXwH4^7rRC322vk@tjR{QB<-8y+5%KhqEdv2ggw^ES$_wqwssvN2= ziW=7kx?Wl}W$oU)*3?u8w~%&z&y3%fN0{orRBa4DHX&pKr(Y0kpz~X^Nc*Mp2Y3{{ E|7)Rzq5uE@ literal 0 HcmV?d00001 diff --git a/co3/databases/fts.py b/co3/databases/fts.py new file mode 100644 index 0000000..f8817ef --- /dev/null +++ b/co3/databases/fts.py @@ -0,0 +1,8 @@ +from co3.database import Database + +from co3.accessors.fts import FTSAccessor +from co3.managers.fts import FTSManager + +class FTSDatabase(Database): + accessor = FTSAccessor + manager = FTSManager diff --git a/co3/databases/sql.py b/co3/databases/sql.py new file mode 100644 index 0000000..9c4b08d --- /dev/null +++ b/co3/databases/sql.py @@ -0,0 +1,34 @@ +from typing import Self + +from co3.database import Database + +from co3.accessors.sql import RelationalAccessor, TabularAccessor, SQLAccessor +from co3.managers.sql import RelationalManager, TabularManager, SQLManager + +from co3.relation import Relation +from co3.relations import TabularRelation, SQLTable + + +class RelationalDatabase[R: Relation](Database): + accessor: type[RelationalAccessor[Self, R]] = RelationalAccessor[Self, R] + manager: type[RelationalManager[Self, R]] = RelationalManager[Self, R] + + +class TabularDatabase[R: TabularRelation](RelationalDatabase[R]): + ''' + accessor/manager assignments satisfy supertype's type settings; + `TabluarAccessor[Self, R]` is of type `type[RelationalAccessor[Self, R]]` + (and yes, `type[]` specifies that the variable is itself being set to a type or a + class, rather than a satisfying _instance_) + ''' + accessor: type[TabularAccessor[Self, R]] = TabularAccessor[Self, R] + manager: type[TabularManager[Self, R]] = TabularManager[Self, R] + + +class SQLDatabase[R: SQLTable](TabularDatabase[R]): + accessor = SQLAccessor + manager = SQLManager + + +class SQLiteDatabase(SQLDatabase[SQLTable]): + pass diff --git a/co3/databases/vss.py b/co3/databases/vss.py new file mode 100644 index 0000000..f02016b --- /dev/null +++ b/co3/databases/vss.py @@ -0,0 +1,9 @@ +from co3.database import Database + +from co3.accessors.vss import VSSAccessor +from co3.managers.vss import VSSManager + + +class VSSDatabase(Database): + accessor = VSSAccessor + manager = VSSManager diff --git a/co3/indexer.py b/co3/indexer.py new file mode 100644 index 0000000..be87d1b --- /dev/null +++ b/co3/indexer.py @@ -0,0 +1,433 @@ +import time +import logging +import threading +from collections import defaultdict +from collections.abc import Iterable + +import sqlalchemy as sa + + +logger = logging.getLogger(__name__) + +class Indexer: + ''' + Indexer class + + Provides restricted access to an underlying Accessor to enable more efficient, superficial + caching. + + Cache clearing is to be handled by a wrapper class, like the Database. + + Caching occurs at the class level, with indexes prefixed by table's origin Composer. + This means that cached selects/group-bys will be available regardless of the provided + Accessors so long as the same Composer is used under the hood. + ''' + _cls_select_cache = {} + _cls_groupby_cache = defaultdict(dict) + + def __init__(self, accessor, cache_select=True, cache_groupby=True): + self.accessor = accessor + + # set instance caches; if remains None, methods can't index + self._select_cache = None + self._groupby_cache = None + + if cache_groupby and not cache_select: + raise ValueError('cannot cache groupbys without select caching enabled') + + if cache_select: + self._select_cache = self._cls_select_cache + + if cache_groupby: + self._groupby_cache = self._cls_groupby_cache + + self._access_lock = threading.Lock() + + def cache_clear(self, group_by_only=False): + self._groupby_cache.clear() + if not group_by_only: + self._select_cache.clear() + + def cache_block( + self, + table, + **kwargs, + ): + ''' + Provide a user-friendly, dynamically re-indexable + ''' + return CacheBlock( + indexer = self, + table = table, + **kwargs, + ) + + def cached_query( + self, + table, + + cols = None, + where = None, + distinct_on = None, + order_by = None, + limit = 0, + + group_by = None, + agg_on = None, + index_on = None, + ): + ''' + Like `group_by`, but makes a full query to the Accessors table `table_name` and + caches the results. The processing performed by the GROUP BY is also cached. + + Update: `cached_select` and `cached_group_by` now unified by a single + `cached_query` method. This allows better defined GROUP BY caches, that are + reactive to the full set of parameters returning the result set (and not just the + table, requiring a full query). + + Note: on cache keys + Cache keys are now fully stringified, as many objects are now allowed to be + native SQLAlchemy objects. Indexing these objects works, but doing so will + condition the cache on their memory addresses, which isn't what we want. + SQLAlchemy converts most join/column/table-like objects to reasonable strings, + which will look the same regardless of instance. + + Context: this became a clear issue when passing in more + `order_by=.desc()`. The `desc()` causes the index to store the column in + an instance-specific way, rather than an easily re-usable, canonical column + reference. Each time the CoreDatabase.files() was being called, for instance, + that @property would be re-evaluated, causing `desc()` to be re-initialized, + and thus look different to the cache. Stringifying everything prevents this + (although this could well be an indication that only a single `cache_block` + should ever be returned be database properties). + + Note: on access locks + A double-checked locking scheme is employed before both of the stages (select + and manual group by), using the same lock. This resolves the common scenario + where many threads need to look up a query in the cache, experience a cache + miss, and try to do the work. This non-linearly explodes the total time to + wait in my experience, so doing this only when needed saves tons of time, + especially in high-congestion moments. + ''' + start = time.time() + cache_key = tuple(map(str, (table, cols, where, distinct_on, order_by, limit))) + + # apparently this is the double-check locking scheme (didn't realize when implementing) + if self._select_cache is None or cache_key not in self._select_cache: + # cache re-compute possible, acquire lock to continue. A later thread may + # acquire this after work has been done by an earlier thread, so re-eval the + # condition below before actually performing a DB read. If access results in a + # cache hit, locking isn't needed. + with self._access_lock: + if self._select_cache is None or cache_key not in self._select_cache: + results = self.accessor.select( + table, + cols=cols, + where=where, + distinct_on=distinct_on, + order_by=order_by, + limit=limit, + mappings=True + ) + + # cache results if select_cache is defined + if self._select_cache is not None: + self._select_cache[cache_key] = results + + logger.debug( + f'Indexer "select" cache miss for table "{table}": access in {time.time()-start:.4f}s' + ) + else: + results = self._select_cache[cache_key] + logger.debug( + f'Indexer "select" cache hit for table "{table}": access in {time.time()-start:.4f}s' + ) + else: + results = self._select_cache[cache_key] + logger.debug( + f'Indexer "select" cache hit for table "{table}": access in {time.time()-start:.4f}s' + ) + + start = time.time() + cache_key = (*cache_key, group_by, agg_on, index_on) + + if group_by is not None: + if self._groupby_cache is None or cache_key not in self._groupby_cache: + with self._access_lock: + if self._groupby_cache is None or cache_key not in self._groupby_cache: + results = self.group_by( + results, + group_by = group_by, + agg_on = agg_on, + index_on = index_on, + return_index = True, + ) + + if self._groupby_cache is not None: + self._groupby_cache[cache_key] = results + + logger.debug( + f'Indexer "group_by" cache miss for table "{table}": access in {time.time()-start:.4f}s' + ) + else: + results = self._groupby_cache[cache_key] + logger.debug( + f'Indexer "group_by" cache hit for table "{table}": access in {time.time()-start:.4f}s' + ) + else: + results = self._groupby_cache[cache_key] + logger.debug( + f'Indexer "group_by" cache hit for table "{table}": access in {time.time()-start:.4f}s' + ) + + return results + + @classmethod + def group_by( + cls, + rows, + group_by, + agg_on=None, + index_on=None, + return_index=False, + ): + ''' + Post-query "group by"-like aggregation. Creates an index over a set of columns + (`group_by_cols`), and aggregates values from `agg_cols` under the groups. + + Rows can be dicts or mappings, and columns can be strings or SQLAlchemy columns. + To ensure the right columns are being used for the operation, it's best to pass in + mappings and use SQA columns if you aren't sure exactly how the keys look in your + results (dicts can have ambiguous keys across tables with the same columns and/or + different labeling schemes altogether). + + TODO: add a flag that handles None's as distinct. That is, for the group_by + column(s) of interest, if rows in the provided query set have NULL values for + these columns, treat all such rows as their "own group" and return them alongside + the grouped/aggregated ones. This is behavior desired by something like + FTSManager.recreate(), which wants to bundle up conversions for blocks + (effectively grouping by blocks.name and link.id, aggregating on + block_conversions.format, then flattening). You could either do this, or as the + caller just make sure to first filter the result set before grouping (e.g., + splitting the NULL-valued rows from those that are well-defined), and then + stitching the two sets back together afterward. + + Multi-dim update: + + - group_by: can be a tuple of tuples of columns. Each inner tuple is a nested + "group by index" in the group by index + - + ''' + if not rows: + return {} if return_index else [] + + rows_are_mappings = not isinstance(rows[0], dict) + + if not rows_are_mappings: + if isinstance(group_by, sa.Column): + group_by = group_by.name + else: + group_by = str(group_by) + + #if group_by is None: group_by = [] + #elif not isinstance(group_by, Iterable): group_by = [group_by] + + if agg_on is None: agg_on = [] + elif not isinstance(agg_on, Iterable): agg_on = [agg_on] + + if index_on is None: index_on = [] + elif not isinstance(index_on, Iterable): index_on = [index_on] + + agg_on_names = [] + for agg in agg_on: + # if a SQA column, can either use `.name` or `str(c)`. The latter includes the + # table name, the former doesn't; ambiguity can be introduced here. + if isinstance(agg, sa.Column): + agg_on_names.append(agg.name) + else: + agg_on_names.append(str(agg)) + + index_on_names = [] + for index in index_on: + # if a SQA column, can either use `.name` or `str(c)`. The latter includes the + # table name, the former doesn't; ambiguity can be introduced here. + if isinstance(index, sa.Column): + index_on_names.append(index.name) + else: + index_on_names.append(str(index)) + + # when rows are dicts, use columns' string names + if not rows_are_mappings: + agg_on = agg_on_names + index_on = index_on_names + + #print(f'rows_are_mappings: {rows_are_mappings}') + #print(f'group_by: {group_by}') + #print(f'agg_on: {agg_on}') + #print(f'agg_on_names: {agg_on_names}') + #print(f'index_on: {index_on}') + #print(f'index_on_names: {index_on_names}') + + # "group by" block ID and wrangle the links into a list + group_by_idx = {} + for row in rows: + # generic get + group_by_attr = row.get(group_by) + + # wrap possible mapping dict + row_dict = dict(row) + + # add new entries; standardize + #aggregates = {} + #for agg_name in agg_on_names: + # aggregates[agg_name] = [] + #row_dict['aggregates'] = aggregates + row_dict['aggregates'] = [] + + indexes = {} + for index_name in index_on_names: + indexes[index_name] = {} + row_dict['indexes'] = indexes + + if group_by_attr is None: + continue + + if group_by_attr not in group_by_idx: + group_by_idx[group_by_attr] = row_dict + + # actually include all agg cols, even if None, so agg array indexes align + agg_dict = { + agg_on_names[i] : row.get(agg_col) + for i, agg_col in enumerate(agg_on) + } + + #aggregates = group_by_idx[group_by_attr]['aggregates'] + #for agg_key, agg_val in agg_dict.items(): + # aggregates[agg_key].append(agg_val) + aggregates = group_by_idx[group_by_attr]['aggregates'] + aggregates.append(agg_dict) + + indexes = group_by_idx[group_by_attr]['indexes'] + for i, index_col in enumerate(index_on): + index_name = index_on_names[i] + indexes[index_name][row[index_col]] = agg_dict + + if return_index: + return group_by_idx + + return list(group_by_idx.values()) + +class CacheBlock: + ''' + CacheBlock class + + Wraps up a set of query parameters for a specific entity, and provides cached access + to different types of "re-queries" via an associated Indexer. + + The goal here is to help build/define entities as the possibly complex transformations + on the base schema that they are. For example, the Note primitive (entity) + incorporates details across `files`, `notes`, `note_conversions`, and + `note_conversion_matter` tables (defined in a single endpoint by a Composer), often + needs to be selected in particular ways (via an Accessor), and results stored for fast + access later on (handled by an Indexer). This pipeline can be daunting and requires + too many moving parts to be handled explicitly everywhere. CacheBlocks wrap up a set + of query "preferences," exposing a simpler interface for downstream access to + entities. It still allows for low-level control over re-grouping/indexing, raw hits to + the actual DB, etc, but keeps things tighter and well-behaved for the Indexer. + + You can think of these as the Indexer's "fingers"; they're deployable mini-Indexes + that "send back" results to the class cache, which is "broadcast" to all other + instances for use when necessary. + + Note: Example usage + + ```py + cb = CacheBlock() + + # Set up cached queries with chained params or via call: + + cb.where(t.notes.c.name=="name").group_by(t.note_conversions.c.format) + cb() # get results + + # - OR - # (use strings when known) + + cb.where(t.notes.c.name=="name").group_by('format') + cb() # get results + + # - OR - # (use kwargs in the call; results returned right away) + + cb( + where=(t.notes.c.name=="name"), + group_by='format' + ) + ``` + + ''' + def __init__( + self, + indexer, + table, + + cols = None, + where = None, + distinct_on = None, + order_by = None, + limit = 0, + + group_by = None, + agg_on = None, + index_on = None, + ): + self.indexer = indexer + + self.query_args = { + 'table' : table, + + 'cols' : cols, + 'where' : where, + 'distinct_on' : distinct_on, + 'order_by' : order_by, + 'limit' : limit, + + 'group_by' : group_by, + 'agg_on' : agg_on, + 'index_on' : index_on, + } + + def _query(self, **kwargs): + '''Make cached query with defaults, override with those provided''' + return self.indexer.cached_query(**{ + k : (v if k not in kwargs else kwargs[k]) + for k,v in self.query_args.items() + }) + + def __call__(self, **kwargs): + ''' + TODO: overload this for the queries, i.e. getting keys or returning aggregates + ''' + return self._query(**kwargs) + + def where(self, where): + self.query_args['where'] = where + return self + #return self._query(where=where) + + def distinct_on(self, distinct_on): + self.query_args['distinct_on'] = distinct_on + return self + #return self._query(distinct_on=distinct_on) + + def order_by(self, order_by): + self.query_args['order_by'] = order_by + return self + #return self._query(order_by=order_by) + + def limit(self, limit): + self.query_args['limit'] = limit + return self + + def group_by(self, group_by): + self.query_args['group_by'] = group_by + return self + #return self._query(group_by=group_by) + diff --git a/co3/manager.py b/co3/manager.py new file mode 100644 index 0000000..f8ced6d --- /dev/null +++ b/co3/manager.py @@ -0,0 +1,38 @@ +''' +Manager + +Wrapper for state-changing database operations. Managers expose the formalized means of +interacting with an underlying database, like inserts and schema recreation. +''' +from pathlib import Path +from abc import ABCMeta, abstractmethod + +#from co3.database import Database + + +class Manager[D: 'Database'](metaclass=ABCMeta): + ''' + Management wrapper class for table groupings. + + The schema is centered around a connected group of tables (via foreign keys). Thus, + most operations need to be coordinated across tables. A few common operations are + wrapped up in this class to then also be mirrored for the FTS counterparts. + ''' + def __init__(self, database: D): + self.database = database + + @abstractmethod + def recreate(self): + raise NotImplementedError + + @abstractmethod + def migrate(self): + raise NotImplementedError + + @abstractmethod + def insert(self): + raise NotImplementedError + + @abstractmethod + def sync(self): + raise NotImplementedError diff --git a/co3/managers/__init__.py b/co3/managers/__init__.py new file mode 100644 index 0000000..7c0a91a --- /dev/null +++ b/co3/managers/__init__.py @@ -0,0 +1,3 @@ +from co3.managers.sql import SQLManager +from co3.managers.fts import FTSManager +from co3.managers.vss import VSSManager diff --git a/co3/managers/__pycache__/__init__.cpython-311.pyc b/co3/managers/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9820f79ec2a274b924a4dfec5b6ad60589c41de2 GIT binary patch literal 175 zcmZ3^%ge<81ojiZr`7}M#~=<2FhUuh*?^4c3@Hr344RC7D;bKIfc(!O$zM+T8Tq-X z`o+2FMfxuJ$)&lec_qdA1x5K;smVY_eqKp_PJX(6a=r-|=O*SQrl%Ga>&M4u=4F<| p$LkeT{^GF7%}*)KNwq6t1sVymw3r`Ad|+l|WcF7S9nN373X8fMrGY~p}zjRb{)LulT+&^+z(h~D45;sbElD%{Hi$^Rb$tbCb zm=iY+Sloyx9Lcm|&lkX0ZWJzib+;=@O?r26x&_P*VyLQ7RMn|gHE50+n_AUm8ES5# zJ=j0!9!98Yv8*)l4b%qII)~-}&7MQ^fZFHKA*zFW`DExW5$q8ONu6;rry-QbFj633 zVT_-0(rhx0U7rYnmm`j2Qu7(E^QhJI!n!Eu)hkO4hK1W;0l}WYF1*S(qnN<45GD*U z37H!Mq~65QaweL4eV2d!)C$N?@L>pH9;(CMIP z5$$UWP+2x5U_E3b$vP~odm$?si7A-B%!lD@Vx^#vfFmduu@ zG0kyK8DsRL7He$aipShb2YIY#|ypKan>gKDxus%$3U5w0J4FOC-IiK zJ#svG6{g`W_?-fd+%s2TA)8V;{wFZtI9h=@9UEWAeIbf_?F*YLXE@dNK-$5X#KF}r zTmk3DU}yZG#p=pP&#hR!^Sjv|*FUenp>H5feYQiV=nHGvCR_n!S}WOn1f+0jHkWb} zqt4>Qh6^F`TTmBLYogOyk_Wt(OP!BO*rGKlM#vJum|ud4%OI~^?hk*O>T$ruLm(UI zWN2*rc6(_0W#Ro_K7Mv%_nX71%F$HiurPa6n0-;W`MhxRuyE_BaBJ({%OZaE*^6TN zd9nQ4lf&ZNQE_f-e*59c*!cE(+b;6UAaEdQGTbU@(wH3-1MQ6;H9iFVzLtzHMDc^5 z=`&eojD9J*Vqa4}2`M0TC9yekIfITIETkPYhzLwa8_2@((1zlE_<( ze*|PdjbK`}If+UlTR{8)WaI4D(XEW#L6VH>nduH1BsQ`}J9;K_rGtRHGGMv+I0Z(L zHPO+v%uELXky{g+-==`|uD7HHrAF0-@&&%$IryLx^)Xn0@1tsZ->a!^PYhCXxhWl& zAxiAtC7ZVVSZ`TQ{{c{!gA&Vc$aiG*so1@?Z>MSboX-L#`$ud8=@^=(9iz$i;B$!KY)+XyD{|^7DO#zLH!2U9hjL{U0pkD&PPB literal 0 HcmV?d00001 diff --git a/co3/managers/__pycache__/core.cpython-311.pyc b/co3/managers/__pycache__/core.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..dfd4f2078aeb324d42966d6a420436c76f0c910a GIT binary patch literal 20298 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 literal 0 HcmV?d00001 diff --git a/co3/managers/__pycache__/fts.cpython-311.pyc b/co3/managers/__pycache__/fts.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..75f58cda409bdfd245a95ab23ff30655e01857a3 GIT binary patch literal 9776 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 CTjSpV literal 0 HcmV?d00001 diff --git a/co3/managers/__pycache__/sql.cpython-312.pyc b/co3/managers/__pycache__/sql.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..08ab1465ef83468e1f3933e0cbf45d1b7272b271 GIT binary patch literal 18544 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 0 + cols = inserts[0].keys() + + # all keys should match + assert all([cols == d.keys() for d in inserts]) + + logger.info(f'FTS recreate: insert post-processing took {time.time()-start:.2f}s') + + util.db.populate_fts5( + self.engine, + ['search'], + columns=list(cols), + inserts=inserts, + ) + + def update(self): pass + + def sync(self): pass + + def migrate(self): pass + + + +def recreate_old(self): + full_table = schema.leftward_block_conversions() + primitive_tables = schema.primitive_tables() + + virtual_inserts = [] + for ptype, table in primitive_tables.items(): + table_rows = db.util.sa_exec_dicts(self.engine, sa.select(table)) + for row in table_rows: + pdict = util.db.prepare_insert(full_table, row) + pdict['ptype'] = ptype + + virtual_inserts.append(pdict) + + select_cols = [ + tables.blocks.c.name, tables.blocks.c.content, + tables.blocks.c.html, tables.blocks.c.header, + tables.blocks.c.block_pos, tables.blocks.c.note_name, + + tables.links.c.to_file, + + tables.notes.c.link, + + tables.note_conversion_matter.c.type, + tables.note_conversion_matter.c.summary, + + 'ptype', + ] + + util.db.populate_fts5( + self.engine, + 'search', + columns=select_cols, + inserts=virtual_inserts, + ) + diff --git a/co3/managers/sql.py b/co3/managers/sql.py new file mode 100644 index 0000000..43b676a --- /dev/null +++ b/co3/managers/sql.py @@ -0,0 +1,383 @@ +''' +Note: Common on insert behavior + - Tables with unique constraints have been equipped with `sqlite_on_conflict_unique` + flags, enabling conflicting bulk inserts to replace conflicting rows gracefully. No + need to worry about explicitly handling upserts. + - The bulk insert via conn.execute(,) automatically ignores + irrelevant column names within provided record dicts, whereas explicit .values() calls + for non-bulk inserts will throw errors if not aligned perfectly. We want to keep these + bulk calls AND allow update/replacements on conflict; the setting above allows this + bulk usage to continue as is. + +Note: Options for insert/update model + 1. Collect all possible update objects, and use a SQLite bulk insert that only updates + if needed (based on modified time, for example). This sounds on the surface like + the right approach since we defer as much to bulk SQL logic, but it's far and away + the worse option b/c prepping all file/note/etc objects is too expensive to + ultimately throw away when finding out an update isn't needed. For example, if we + wanted to perform note updates _inside_ the SQL call (like an `INSERT .. UPDATE .. + IF`, as opposed to determining the objects to insert _outside_ of the SQL call), + you would need to bring each of the note's HTML prior to the insert check. There's + no 2-stage processing here where you can check if the note needs to be converted + b/c it's out of date, and only then perform the computation. + 2. Instantiate objects sequentially, each time checking with the DB to see if full + processing is needed. This makes much more sense when the full processing is very + expensive, as it is with Note conversion. This would iterate through available notes, + perform a `SELECT` on the target table to see if the note needs updating, and if so + perform the remaining computation. Those objects then get added to a "update object + list" to be inserted in bulk, but you make sequential `SELECT` checks before that. + + The one extra optimization you could maybe make here is doing a full SELECT on the + target table and bring all rows into memory before iterating through the objects. + This would likely make it faster than whatever SQLAlchemy overhead there may be. It + also might just be outright required given Connection objects aren't thread-safe; + we can get away with single thread global SELECT, threaded checking during object + build, then single thread bulk INSERT. (**Note**: this is what the method does). +''' + +from pathlib import Path +from collections import defaultdict +import logging +import threading +import math +import time +import pprint +from concurrent.futures import wait, as_completed + +import sqlalchemy as sa +from tqdm.auto import tqdm + +from co3 import util + +from co3.manager import Manager +from co3.relation import Relation +#from co3.databases import SQLDatabase +#from localsys.reloader.router._base import ChainRouter, Event +from co3.relations import TabularRelation, SQLTable + + +logger = logging.getLogger(__name__) + + +class RelationalManager[D: 'RelationalDatabase', R: Relation](Manager[D]): + pass + + +class TabularManager[D: 'TabularDatabase', R: TabularRelation](RelationalManager[D, R]): + pass + + +class SQLManager(TabularManager['SQLDatabase', SQLTable]): + ''' + Core schema table manager. Exposes common operations and facilitates joint operations + needed for highly connected schemas. + + In particular, Managers expose insertion abstractions that take table-indexed groups + of rows and bundle them under a single transaction. This is important for table groups + with foreign keys and cascading deletions: inserts need to be coordinated. Note that + actually collecting the inserts that need to take place is outside the scope of the + Manager (see the Collector). We do, however, implement a `sync` operation that can + saturates a router with events (dynamically) and sweeps up inserts on session basis + from an attached collector. + ''' + conversion_formats = ['src', 'html5'] + + def __init__(self, *args, **kwargs): + super().__init__(*args, **kwargs) + + self.routers = [] + + self._router = None + self._insert_lock = threading.Lock() + + @property + def router(self): + if self._router is None: + self._router = ChainRouter(self.routers) + return self._router + + def add_router(self, router): + self.routers.append(router) + + def recreate(self): + tables.metadata.drop_all(self.engine) + tables.metadata.create_all(self.engine, checkfirst=True) + + def update(self): pass + + def insert(self, inserts: dict): + ''' + Perform provided table inserts. + + Parameters: + inserts: table-indexed dictionary of insert lists + ''' + total_inserts = sum([len(ilist) for ilist in inserts.values()]) + if total_inserts < 1: return + + logger.info(f'Total of {total_inserts} sync inserts to perform') + + # TODO: add some exception handling? may be fine w default propagation + start = time.time() + with self.engine.connect() as connection: + with self._insert_lock: + for table_str in inserts: + table_inserts = inserts[table_str] + if len(table_inserts) == 0: continue + + table = tables.table_map[table_str] + + logger.info( + f'Inserting {len(table_inserts)} out-of-date entries into table "{table_str}"' + ) + + connection.execute( + sa.insert(table), + table_inserts + ) + connection.commit() + logger.info(f'Insert transaction completed successfully in {time.time()-start:.2f}s') + + def _file_sync_bools(self): + synced_bools = [] + fpaths = utils.paths.iter_nested_paths(self.collector.basepath, no_dir=True) + db_rpath_index = self.database.files.group_by('rpath')() + + for fpath in fpaths: + file = File(fpath, self.collector.basepath) + db_file = db_rpath_index.get(file.rpath) + + file_in_sync = db_file and float(db_file.get('mtime','0')) >= file.mtime + synced_bools.append(file_in_sync) + + return fpaths, synced_bools + + def sync( + self, + limit=0, + chunk_time=0, + dry=False, + chunk_size_cap=1000, + print_report=True, + ): + ''' + Note: + Could be dangerous if going from fast file processing to note processing. + Imagine estimating 1000 iter/sec, then transferring that to the next batch + when it's more like 0.2 iter/sec. We would lose any chunking. (Luckily, in + practice, turns out that notes are almost always processed before the huge set + of nested files lurking and we don't experience this issue.) + ''' + #filepaths, update_bools = self.collector.file_inserts(dry_run=True) + #fpaths_to_update = [f for (f, b) in zip(filepaths, update_bools) if not b] + filepaths, update_bools = self._file_sync_bools() + fpaths_to_update = [f for (f, b) in zip(filepaths, update_bools) if not b] + + def calc_chunk_size(sec_per_file): + ''' + Chunk cap only applied here; if manually set elsewhere in the method, it's + intentional e.g., if chunk_time <= 0 and we just want one big iteration. + ''' + return min(max(int(chunk_time / sec_per_file), 1), chunk_size_cap) + + # nothing to do + if not fpaths_to_update: + logger.info('Sync has nothing to do, exiting') + return None + + ood_count = len(fpaths_to_update) + total_fps = len(filepaths) + ood_prcnt = ood_count/total_fps*100 + logger.info( + f'Pre-sync scan yielded {ood_count}/{total_fps} ({ood_prcnt:.2f}%) out-of-date files' + ) + + if limit <= 0: limit = ood_count + + if chunk_time <= 0: + chunk_size = ood_count + else: + chunk_size = calc_chunk_size(5) + + dry_inserts = None + remaining = limit + + chunk_time_used = 0 + pbar = tqdm( + desc=f'Adaptive chunked sync for [limit {limit}]', + total=remaining, + ) + + report = [] + def collect_report(): + report.append({ + 'chunk_size': chunk_limit, + 'chunk_time_used': chunk_time_used, + }) + + with pbar as _: + while remaining > 0: + time_pcnt = chunk_time_used / max(chunk_time,1) * 100 + pbar.set_description( + f'Adaptive chunked sync [size {chunk_size} (max {chunk_size_cap})] ' + f'[prev chunk {chunk_time_used:.2f}s/{chunk_time}s ({time_pcnt:.2f}%)]' + ) + + chunk_limit = min(remaining, chunk_size) + start_idx = limit - remaining + chunk_fpaths = fpaths_to_update[start_idx:start_idx+chunk_limit] + + chunk_time_start = time.time() + #inserts = self.collector.collect_inserts( + # chunk_fpaths, + # skip_updated=False, # saves on DB check given provided list + #) + + # 1) flush synthetic events for the batch through the chained router + # 2) block until completed and sweep up the collected inserts + futures = self.router.submit([ + Event( + endpoint=str(self.collector.basepath), + name=str(path.relative_to(self.collector.basepath)), + action=[0xffffffff], # synthetic action to match any flag filters + ) for path in chunk_fpaths + ]) + + for future in tqdm( + as_completed(futures), + total=chunk_size, + desc=f'Awaiting chunk futures [submitted {len(futures)}/{chunk_size}]' + ): + #print('Finished future', cfuture) + try: + result = future.result() + except Exception as e: + logger.warning(f"Sync job failed with exception {e}") + + #wait(futures)#, timeout=10) + inserts = self.collector.collect_inserts() + + chunk_time_used = time.time() - chunk_time_start + + collect_report() + #if not inserts: break + + if dry: + if dry_inserts is None: + dry_inserts = inserts + else: + for ik, iv in inserts.items(): + dry_inserts[ik].extend(iv) + else: + self.insert(inserts) + + remaining -= chunk_limit + + # re-calculate chunk size + sec_per_file = chunk_time_used / chunk_size + chunk_size = calc_chunk_size(sec_per_file) + + #pbar.update(n=limit-remaining) + pbar.update(n=chunk_limit) + + if print_report: + num_chunks = len(report) + total_ins = sum(map(lambda c:c['chunk_size'], report)) + avg_chunk = total_ins / num_chunks + total_time = sum(map(lambda c:c['chunk_time_used'], report)) + avg_time = total_time / num_chunks + time_match = avg_time / max(chunk_time*100, 1) + + print( 'Sync report: ') + print(f' Total chunks : {num_chunks} ') + print(f' Total file inserts : {total_ins} / {limit} ') + print(f' Average chunk size : {avg_chunk:.2f} ') + print(f' Total time spent : {total_time:.2f}s ') + print(f' Average time / chunk : {avg_time:.2f}s / {chunk_time}s') + print(f' Percent time match : {time_match:.2f}% ') + + if dry: return dry_inserts + + def migrate(self): + # create MD object representation current DB state + pre_metadata = sa.MetaData() + pre_metadata.reflect(bind=self.engine) + + table_rows = {} + for table_name, table in pre_metadata.tables.items(): + # pre-migration rows + select_results = utils.db.sa_execute(self.engine, sa.select(table)) + named_results = utils.db.named_results(table, select_results) + + table_rows[table_name] = named_results + + + #table_update_map = { + # 'files': ( + # lambda r: File(Path(NOTEPATH, r['name']), NOTEPATH).get_table_data() + # ), + # 'notes': ( + # lambda r: Note(Path(NOTEPATH, r['name']), NOTEPATH).get_table_data() + # ), + # 'note_conversion_matter': ( + # lambda r: Note(Path(NOTEPATH, r['name']), NOTEPATH).get_table_data() + # ), + #} + + # update schema + self.recreate() + + with self.engine.connect() as connection: + for table_name, table in tables.metadata.tables.items(): + if table_name not in table_rows: continue + + logger.info(f'Migrating table "{table_name}"') + + if table_name == 'files': + update_note_rows = [] + + for i,note_row in enumerate(table_rows['files']): + file = File(Path(NOTEPATH, note_row['name']), NOTEPATH) + u_note_row = utils.db.prepare_insert( + tables.files, + file.get_table_data() + ) + note_row.update({k:v for k,v in u_note_row.items() if v}) + update_note_rows.append(note_row) + + table_rows['files'] = update_note_rows + elif table_name == 'notes': + update_note_rows = [] + + for note_row in table_rows['notes']: + note = Note(Path(NOTEPATH, note_row['name']), NOTEPATH) + u_note_row = utils.db.prepare_insert( + tables.notes, + note.get_table_data() + ) + note_row.update({k:v for k,v in u_note_row.items() if v}) + update_note_rows.append(note_row) + + table_rows['notes'] = update_note_rows + + # generic update blueprint for later; now doesn't matter as conversion based + # inserts require re-converting...so you may as well just do a full re-build. + #update_rows = [] + #if table_name in table_update_map: + # for i,row in enumerate(table_rows['files']): + # update_obj = table_update_map[table_name](row) + + # u_row = utils.db.prepare_insert( + # table, + # note.get_table_data() + # ) + # note_row.update({k:v for k,v in u_note_row.items() if v}) + # update_note_rows.append(note_row) + + connection.execute( + sa.insert(table), + table_rows[table_name] + ) + + connection.commit() + diff --git a/co3/managers/vss.py b/co3/managers/vss.py new file mode 100644 index 0000000..4727cf8 --- /dev/null +++ b/co3/managers/vss.py @@ -0,0 +1,142 @@ +from collections import defaultdict +import logging +import pickle +import time +from pathlib import Path + +import numpy as np +from tqdm import tqdm +import sqlalchemy as sa + +from co3.manager import Manager +from co3 import util + + +logger = logging.getLogger(__name__) + +class VSSManager(Manager): + def __init__(self, database, engine=None): + super().__init__(database, engine) + + from localsys.db.databases.core import CoreDatabase + + self.core_db = CoreDatabase() + + def recreate(self): + start = time.time() + + chunks = [] + chunk_ids = [] + block_map = {} + for note_name, note_groupby in self.core_db.blocks().items(): + blocks = note_groupby.get('aggregates', []) + for block in blocks: + if block.get('format') != 'src': continue + + block_name = block.get('name', '') + block_content = block.get('content', '') + block_map[block_name] = block_content + + block_chunks, chunk_ranges = utils.embed.split_block(block_content) + + chunks.extend(block_chunks) + chunk_ids.extend([f'{block_name}@{r[0]}:{r[1]}' for r in chunk_ranges]) + + logger.info(f'VSS pre-index SELECT took {time.time()-start:.2f}s') + start = time.time() + + # one-time batched embedding + chunk_embeddings = self.database.access.embed_chunks(chunks) + + logger.info(f'VSS embeddings took {time.time()-start:.2f}s') + start = time.time() + + # aggregate embeddings up the content hierarchy + zero_embed = lambda: np.atleast_2d( + np.zeros(self.database.access._embedding_size, dtype='float32') + ) + block_embedding_map = defaultdict(zero_embed) + note_embedding_map = defaultdict(zero_embed) + + for i, chunk_id in enumerate(chunk_ids): + at_split = chunk_id.split('@') + note_name = at_split[0] + block_name = '@'.join(at_split[:3]) + + block_embedding_map[block_name] += chunk_embeddings[i] + note_embedding_map[note_name] += chunk_embeddings[i] + + # re-normalize aggregated embeddings + # > little inefficient but gobbled up asymptotically by chunk processing + # > could o/w first convert each map to a full 2D np array, then back + for embed_map in [block_embedding_map, note_embedding_map]: + for k, agg_embedding in embed_map.items(): + embed_map[k] = utils.embed.unit_row_wise(agg_embedding) + + logger.info(f'VSS recreate: pre-index SELECT took {time.time()-start:.2f}s') + + # cols = ['rowid', 'chunk_embedding'] + # def pack_inserts(embeddings): + # return [ + # { cols[0]: i, cols[1]: embedding.tobytes() } + # for i, embedding in enumerate(embeddings) + # ] + + # chunk_inserts = pack_inserts(chunk_embeddings) + # block_inserts = pack_inserts(block_embedding_map.values()) + # note_inserts = pack_inserts(note_embedding_map.values()) + + chunk_ids = chunk_ids + block_ids = list(block_embedding_map.keys()) + note_ids = list(note_embedding_map.keys()) + + block_embeddings = np.vstack(list(block_embedding_map.values())) + note_embeddings = np.vstack(list(note_embedding_map.values())) + + blocks = [block_map[b] for b in block_ids] + notes = note_ids + + self.database.access.write_embeddings({ + 'chunks': (chunk_ids, chunk_embeddings, chunks), + 'blocks': (block_ids, block_embeddings, blocks), + 'notes' : (note_ids, note_embeddings, notes), + }) + + logger.info(f'Post-embedding parsing took {time.time()-start:.2f}s') + + # utils.db.create_vss0( + # self.engine, + # 'chunks', + # columns=list(cols), + # inserts=chunk_inserts, + # populate=True, + # reset=True, + # embedding_size=self._embedding_size, + # ) + + def update(self): pass + + def sync(self): pass + + def migrate(self): pass + + def _archive_note_embed(self): + for block in blocks: + content = block.get('content') + if not content: continue + + block_chunks = utils.embed.split_block(content) + chunks.extend(block_chunks) + + embeddings = utils.embed.embed_chunks(chunks) + block_embeddings = utils.embed.map_groups(embeddings, embed_block_map) + + self.convert_map['vect'] = block_embeddings + + note_embedding = utils.embed.unit_row_wise( + embeddings.sum(axis=0).reshape(1, -1) + ) + + return { + 'content': note_embedding.tobytes(), + } diff --git a/co3/mapper.py b/co3/mapper.py new file mode 100644 index 0000000..813a70e --- /dev/null +++ b/co3/mapper.py @@ -0,0 +1,208 @@ +''' +Mapper + +Used to house useful objects for storage schemas (e.g., SQLAlchemy table definitions). +Provides a general interface for mapping from CO4 class names to storage structures for +auto-collection and composition. + +Example: + +mapper = Mapper[sa.Table]() + +mapper.attach( + Type, + attributes=TypeTable, + collation=CollateTable, + collation_groups={ + 'name': NameConversions + } +) +''' +from collections import defaultdict + +from co3.co3 import CO3 +from co3.relation import Relation + + +class Mapper[R: Relation]: + ''' + Mapper base class for housing schema components and managing relationships between CO3 + types and storage targets (of type R). + ''' + def __init__(self): + self.attribute_comps: dict[CO3, R] = {} + self.collation_groups: dict[CO3, dict[str|None, R]] = defaultdict(dict) + + def attach( + self, + type_ref : CO3, + attr_comp : R, + coll_comp : R | None = None, + coll_groups : dict[str | None, R] = None + ) -> None: + ''' + Parameters: + type_ref: CO3 subtype to map to provided storage components + attr_comp: storage component for provided type's canonical attributes + coll_comp: storage component for provided type's default/unnamed collation + targets + coll_groups: storage components for named collation groups; dict mapping group + names to components + ''' + self.attribute_comps[type_ref] = attr_comp + + if coll_comp is not None: + self.collation_groups[type_ref][None] = attr_comp + + if coll_groups is not None: + self.collation_groups[type_ref].update(attr_comp) + + def join_attribute_relations(self, r1: R, r2: R) -> R: + ''' + Specific mechanism for joining attribute-based relations. + ''' + pass + + def join_collation_relations(self, r1: R, r2: R) -> R: + ''' + Specific mechanism for joining collation-based relations. + ''' + pass + + def get_connective_data( + self, + type_instance: CO3, + action_key, + action_group=None, + ) -> dict: + ''' + Return data relevant for connecting collation entries to primary storage + containers. This is typically some combination of the action key and a unique + identifier from the target CO3 instance to form a unique key for inserts from + actions. This is called just prior to collector send-off for collation inserts and + injected alongside collation data. + ''' + return {} + + def get_attribute_comp(self, type_ref: CO3) -> R | None: + return self.attribute_comps.get(type_ref, None) + + def get_collation_comp(self, type_ref: CO3, group=str | None) -> R | None: + return self.collation_group.get(type_ref, {}).get(group, None) + + def collect(self, collector, mapper, action_keys=None) -> dict: + ''' + Stages inserts up the inheritance chain, and down through components. + + Note: + Even with ORM, a method like this would be needed to trace up parent tables and + how inserts should be handled for inheritance. ORM would make component + inserts a little easier perhaps, since they can be attached as attributes to + constructed row objects and a sa.Relationship will handle the rest. Granted, + we don't do a whole lot more here: we just call `collect` over those + components, adding them to the collector session all the same. + + Returns: dict with keys and values relevant for associated SQLite tables + ''' + if action_keys is None: + action_keys = list(self.action_map.keys()) + + receipts = [] + for _cls in reversed(self.__class__.__mro__[:-2]): + attribute_component = mapper.get_attribute_comp(_cls) + + # require an attribute component for type consideration + if attribute_component is None: + continue + + collector.add_insert( + attribute_component, + self.attributes, + receipts=receipts, + ) + + for action_key in action_keys: + collation_data = self.collate(action_key) + + # if method either returned no data or isn't registered, ignore + if collation_data is None: + continue + + _, action_groups = self.action_map[action_key] + for action_group in action_groups: + collation_component = mapper.get_collation_comp(_cls, group=action_group) + + if collation_component is None: + continue + + # gather connective data for collation components + connective_data = mapper.get_connective_data(self, action_key, action_group) + + collector.add_insert( + collation_component, + { + **connective_data, + **collation_data, + }, + receipts=receipts, + ) + + # handle components + for comp in self.components: + receipts.extend(comp.collect(collector, formats=formats)) + + return receipts + + @classmethod + def compose(cls, outer=False, conversion=False, full=False): + ''' + Note: + Comparing to ORM, this method would likely also still be needed, since it may + not be explicitly clear how some JOINs should be handled up the inheritance + chain (for components / sa.Relationships, it's a little easier). + + Parameters: + outer: whether to use outer joins down the chain + conversion: whether to return conversion joins or base primitives + full: whether to return fully connected primitive and conversion table + ''' + def join_builder(outer=False, conversion=False): + head_table = None + last_table = None + join_table = None + + for _cls in reversed(cls.__mro__[:-2]): + table_str = None + table_prefix = _cls.table_prefix + + if conversion: table_str = f'{table_prefix}_conversions' + else: table_str = f'{table_prefix}s' + + if table_str not in tables.table_map: + continue + + table = tables.table_map[table_str] + + if join_table is None: + head_table = table + join_table = table + else: + if conversion: + join_condition = last_table.c.name_fmt == table.c.name_fmt + else: + join_condition = last_table.c.name == table.c.name + + join_table = join_table.join(table, join_condition, isouter=outer) + + last_table = table + + return join_table, head_table + + if full: + # note how the join isn't an OUTER join b/w the two + core, core_h = join_builder(outer=outer, conversion=False) + conv, conv_h = join_builder(outer=outer, conversion=True) + return core.join(conv, core_h.c.name == conv_h.c.name) + + join_table, _ = join_builder(outer=outer, conversion=conversion) + return join_table diff --git a/co3/relation.py b/co3/relation.py new file mode 100644 index 0000000..b2049ee --- /dev/null +++ b/co3/relation.py @@ -0,0 +1,37 @@ +''' +Relation + +Loose wrapper for table-like objects to be used in various database contexts. Relations +can be thought of generally as named data containers that contain tuples of attributes +(adhering to relational algebra terms). Relation subtypes are referred to commonly across +CO3 generics, serving as a fundamental abstraction within particular storage protocols. + +Note: development tasks + As it stands, the Relation skeleton is incredibly lax compared to the properties and + operations that should be formally available, according its pure relational algebra + analog. + + Relations are also generic up to a type T, which ultimately serves as the base object + for Relation instances. We aren't attempting to implement some generally useful + table-like class here; instead we're just exposing a lightweight interface that's + needed for a few CO3 contexts, and commonly off-loading most of the heavy-lifting to + true relation objects like SQLAlchemy tables. +''' +from typing import Self + + +class Relation[T]: + def __init__(self, name, obj: T): + self.name = name + self.obj = obj + + def get_attributes(self): + raise NotImplementedError + + def join( + self, + corelation: Self, + on, + outer=False + ): + raise NotImplementedError diff --git a/co3/relations/__init__.py b/co3/relations/__init__.py new file mode 100644 index 0000000..5bc5ba3 --- /dev/null +++ b/co3/relations/__init__.py @@ -0,0 +1,16 @@ +import sqlalchemy as sa + +from co3.relation import Relation + + +class DictRelation(Relation[dict]): + def get_attributes(self): + return tuple(self.obj.keys()) + +class TabularRelation(Relation[sa.Table]): + def get_attributes(self): + return tuple(self.obj.columns) + + +class SQLTable(Relation[sa.Table]): + pass diff --git a/co3/relations/__pycache__/__init__.cpython-312.pyc b/co3/relations/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3916fdebffff0cbb828e71f816187a26645d08ea GIT binary patch literal 1269 zcmb6YJx|*}^v-sOlLpccKGasKU`S{dqN+=W3RNno9jZtz3@8#h8T)_)JBB-3BB(=$ z3>`tO6quMJeo7Y*L#u1IszbL*Nf)NRX9oxt13l^9d-p!>eSaAq&Js8qPw47ACFCbQ z&d*Sv=za#GO&sD-msBZW&DA`;s#BtoSH#g<#4)(ejr*W?q{mj(R3uA*YzSnup6mZM zfUfALBmFe!n>W%oo3xbqjlWe&RGII%YXvpGVGsOIAfxDX?*eKQ9z|c(9NHpPy{VOS zm7A;C!G-O)J{lQtF_-RZ0BsUn$ljB>2CT%XrxFZ!9`#vAecJ`np%rkN3c^j7E8SnI zD`SHzOdCs>(k2eBY-V}bF+d%k@z<2$%vh6>OuIQ&O z%Z$|;wScji&88Yz;{mgRK-5;kfXkhSgPG1;6{f+hoB;5F{K${)F1DBUmfFjE%b(b3 zzHn?7x|m3%V7NuMchVjqX;gmIF3&QxUd6NoQ`!+a(xwX z@h)c{wnkIt!rM0xsLNp*#T}3fTo7>&LBj0=J4eMxch8>Zf~|nfb5wXo!(vF7l+#i+b83XkvZMVQkwa=y{{db2j)qB>MwzJ6!t%l CaQb=x literal 0 HcmV?d00001 diff --git a/co3/util/__init__.py b/co3/util/__init__.py new file mode 100644 index 0000000..9ba947c --- /dev/null +++ b/co3/util/__init__.py @@ -0,0 +1,2 @@ +from co3.util import db +from co3.util import regex diff --git a/co3/util/__pycache__/__init__.cpython-311.pyc b/co3/util/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c1dc52d5233721f34d12200ea10b4e4c09ba43f4 GIT binary patch literal 266 zcmZ3^%ge<81WWq9rzm6l}Y6c;fARTQxRiIohWL8^b*>u2QW zrs@~xrWfhElYN|XQd_s8Tol7`8oON`al!F7;K7ue0*kJW=VX!UP0wA s4x8Nkl+v73yCP1Yd5l0@tPdnUFf%eT-e8cpfQoJ~NMFE)ir9gA075cEaR2}S literal 0 HcmV?d00001 diff --git a/co3/util/__pycache__/__init__.cpython-312.pyc b/co3/util/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..fa6295083141e0f07a3114a6a225b249945298a5 GIT binary patch literal 226 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 literal 0 HcmV?d00001 diff --git a/co3/util/__pycache__/db.cpython-312.pyc b/co3/util/__pycache__/db.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9572a984af90ee26f1bdcb717ba45aae84b3e08d GIT binary patch literal 14828 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 literal 0 HcmV?d00001 diff --git a/co3/util/__pycache__/regex.cpython-312.pyc b/co3/util/__pycache__/regex.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..05794a0152d47c41d416da80055b0126508c47f4 GIT binary patch literal 499 zcmYjNF;Buk6n@th6dNT(-HgCSW3&N`izv}JF|fGRD8crEV9Swf8^Jg@I1`;noLCJ% z#RbAZQr(=~NIIA>c~^`2lJ~vuy?giGclWxyyaddiyI;7=;s;OWCWge{W26TL7{~+- z1i;V`=1qUm5C-Tc(*#3&08Q*5Mf&8W@@+g*ETk`#O!46CXj?m1^sqI!ATi|2{1Ss6 zI6;v^V=m#h0!+jm48rw|$iIV-4#Ic}ict1YMG?J(UbV29vzygxT%ovz+n#8V4V@tbcji6s!sBOyH4FygPA+6 zj<*tQsyL()ETjB$qs;A12KVqTZ%pLWNKW-v`^H$_n#kFaoE^*gp_KPo2Pl#!Q0y(} z#A?+|O!@nQAum8>&SMN_iv^1qu89w6oTXg0on|l<5khYen?_+h`FPwbJ(Y&Z?079V MgoH04v>S~029`=}5&!@I literal 0 HcmV?d00001 diff --git a/co3/util/db.py b/co3/util/db.py new file mode 100644 index 0000000..ac1543a --- /dev/null +++ b/co3/util/db.py @@ -0,0 +1,375 @@ +''' +Example usage for this file's utilities: + +# get SA engine, creating folder hierarchy to provided DB path +engine = db.get_engine() + +# execute a single SA statement, returns a CursorResult +select_results = db.sa_execute(engine, sa.select()) + +# convert raw results to dictionaries, keys corresponding to col names +select_dicts = db.named_results(
, select_results) + +# use table defaults and cols to create compliant insert +insert_dicts = [ db.prepare_insert(
, sd) for sd in select_dicts ] + +# perform a bulk insert +with engine.connect() as connection: + connection.execute( + sa.insert(
), + insert_dicts + ) +''' + +import time +import logging +import functools +import sqlalchemy as sa +from pathlib import Path + + +logger = logging.getLogger(__name__) + +def get_engine(db_path, echo=False): + Path(db_path).parent.mkdir(parents=True, exist_ok=True) + return sa.create_engine(f"sqlite:///{db_path}", echo=echo) + +def named_results(table, results): + ''' + Note the implications of this for results from compound tables containing the same + column names: only the last column name will be indexed. + ''' + return [ + { c.name:r[i] for i, c in enumerate(table.columns) } + for r in results + ] + +# RAW CURSOR-RESULT MANIPULATION -- SEE SA-PREFIXED METHODS FOR CONN-WRAPPED COUNTERPARTS +def result_mappings(results): + return results.mappings() + +def result_mappings_all(results): + return result_mappings(results).all() + +def result_dicts(results, query_cols=None): + ''' + Parse SQLAlchemy results into Python dicts. Leverages mappings to associate full + column name context. + + If `query_cols` is provided, their implicit names will be used for the keys of the + returned dictionaries. This information is not available under CursorResults and thus + must be provided separately. This will yield results like the following: + + [..., {'table1.col':, 'table2.col':, ...}, ...] + + Instead of the automatic mapping names: + + [..., {'col':, 'col_1':, ...}, ...] + + which can make accessing certain results a little more intuitive. + ''' + if query_cols: + return [ + { str(c):r[c] for c in query_cols } + for r in result_mappings_all(results) + ] + + return [dict(r) for r in result_mappings_all(results)] + +def sa_execute(engine, stmt, bind_params=None, include_cols=False): + ''' + Simple single-statement execution in a with-block + ''' + with engine.connect() as conn: + res = conn.execute(stmt, bind_params) + + if include_cols: + cols = list(res.mappings().keys()) + return res, cols + + return res + +def sa_exec_mappings(engine, stmt, bind_params=None, include_cols=False): + ''' + All mappings fetched inside of connect context, safe to access outside + ''' + with engine.connect() as conn: + res = conn.execute(stmt, bind_params) + mappings = result_mappings_all(res) + + if include_cols: + cols = list(res.mappings().keys()) + return mappings, cols + + return mappings + +def sa_exec_dicts(engine, stmt, bind_params=None, include_cols=False): + with engine.connect() as conn: + res = conn.execute(stmt, bind_params) + dicts = result_dicts(res) + + if include_cols: + cols = list(res.mappings().keys()) + return dicts, cols + + return dicts + +def sa_exec_explicit(engine, stmt, bind_params=None): + with engine.connect() as conn: + trans = conn.begin() # start a new transaction explicitly + try: + result = conn.execute(stmt, bind_params) + trans.commit() # commit the transaction explicitly + return result + except: + trans.rollback() # rollback the transaction explicitly + raise + +def prepare_insert(table, value_dict): + ''' + Modifies insert dictionary with full table column defaults + ''' + insert_dict = get_column_defaults(table) + #insert_dict.update(value_dict) + insert_dict.update( + { k:v for k,v in value_dict.items() if k in insert_dict } + ) + + return insert_dict + +def deferred_fkey(target, **kwargs): + return sa.ForeignKey( + target, + deferrable=True, + initially='DEFERRED', + **kwargs + ) + +def deferred_cd_fkey(target, **kwargs): + ''' + Prefer this when using FKEYs; need to really justify _not_ having a CASCADE deletion + enabled + ''' + return deferred_fkey(target, ondelete='CASCADE', **kwargs) + +def get_column_defaults(table, include_all=True): + ''' + Provide column:default pairs for a provided SQLAlchemy table. + + Parameters: + table: SQLAlchemy table + include_all: whether to include all columns, even those without explicit defaults + ''' + default_values = {} + for column in table.columns: + if column.default is not None: + default_values[column.name] = column.default.arg + elif column.nullable: + default_values[column.name] = None + else: + # assume empty string if include_all and col has no explicit default + # and isn't nullable + if include_all and column.name != 'id': + default_values[column.name] = '' + + return default_values + +def get_column_names_str_table(engine, table: str): + col_sql = f'PRAGMA table_info({table});' + with engine.connect() as connection: + try: + cols = connection.execute(sa.text(col_sql)) + except sa.exc.OperationalError as e: + logger.error(f'Column retrieval for table "{table}" failed') + raise + + return cols + +def create_fts5( + engine, + table: sa.Table | str, + columns=None, + populate=False, + inserts=None, + reset_fts=False, + tokenizer='unicode61', + ): + ''' + Create and optionally populate an FTS5 table in SQLite. Can be used directly for + existing tables in the same database. It can also be used for composite tables (i.e., + those created from JOINs) or really any other data by providing explicit inserts and + column names to use during population. + + Parameters: + table: either SQLAlchemy table instance, or table name string + columns: list of SQLAlchemy table columns to insert into virtual table. These + columns must be present in the provided table if not manually specifying + inserts (since the table must be queried automatically) + inserts: + ''' + is_sa_table = isinstance(table, sa.Table) + table_name = table.name if is_sa_table else table + + if columns is None: + if is_sa_table: + columns = [c.name for c in table.c] + else: + columns = get_column_names_str_table(engine, table) + + col_str = ", ".join(columns) + fts_table_name = f'{table_name}_fts_{tokenizer}' + + sql = f""" + CREATE VIRTUAL TABLE {fts_table_name} USING fts5 + ( + {col_str}, + tokenize = '{tokenizer}' + ); + """ + + sql_insert = f""" + INSERT INTO {fts_table_name} + ( + {col_str} + ) + """ + if inserts is None: + sql_insert += f""" + SELECT {col_str} + FROM {table_name}; + """ + else: + sql_insert += f""" + VALUES ({', '.join(':' + c for c in columns)}) + """ + + sql_drop = f"DROP TABLE IF EXISTS {fts_table_name}" + + with engine.connect() as connection: + if reset_fts: + connection.execute(sa.text(sql_drop)) + + connection.execute(sa.text(sql)) + + if populate: + if inserts is None: + connection.execute(sa.text(sql_insert)) + else: + connection.execute( + sa.text(sql_insert), + inserts, + ) + + connection.commit() + +def populate_fts5(engine, tables, columns=None, inserts=None): + # create indexes + tokenizers = ['unicode61', 'porter', 'trigram'] + + for table in tables: + for tokenizer in tokenizers: + start = time.time() + create_fts5( + engine, + table, + columns=columns, + populate=True, + inserts=inserts, + reset_fts=True, + tokenizer=tokenizer + ) + + is_sa_table = isinstance(table, sa.Table) + table_name = table.name if is_sa_table else table + print(f'Created FTS5 index for table "{table_name}+{tokenizer}"; took {time.time() - start}s') + + +def create_vss0( + engine, + table: sa.Table | str, + columns=None, + populate=False, + inserts=None, + reset=False, + embedding_size=384, + ): + ''' + Create a VSS table + + Parameters: + table: either SQLAlchemy table instance, or table name string + columns: list of SQLAlchemy table columns to insert into virtual table. These + columns must be present in the provided table if not manually specifying + inserts (since the table must be queried automatically) + inserts: + ''' + is_sa_table = isinstance(table, sa.Table) + table_name = table.name if is_sa_table else table + + if columns is None: + if is_sa_table: + columns = [c.name for c in table.c] + else: + columns = get_column_names_str_table(engine, table) + + col_str = ", ".join(columns) + vss_table_name = f'{table_name}_vss' + + sql = f""" + CREATE VIRTUAL TABLE {vss_table_name} USING vss0 + ( + chunk_embedding({embedding_size}), + query_embedding({embedding_size}), + ); + """ + + sql_insert = f""" + INSERT INTO {vss_table_name} + ( + rowid, chunk_embedding + ) + """ + if inserts is None: + sql_insert += f""" + SELECT {col_str} + FROM {table_name}; + """ + else: + sql_insert += f""" + VALUES ({', '.join(':' + c for c in columns)}) + """ + + sql_drop = f"DROP TABLE IF EXISTS {vss_table_name}" + + with engine.connect() as connection: + if reset: + connection.execute(sa.text(sql_drop)) + + connection.execute(sa.text(sql)) + + if populate: + if inserts is None: + connection.execute(sa.text(sql_insert)) + else: + connection.execute( + sa.text(sql_insert), + inserts, + ) + + connection.commit() + +def fts5_prep_composite(engine, table, table_name, columns=None): + ''' + Helper method for prepping JOIN tables for FTS5 creation. + ''' + table.name = table_name + + rows, cols = utils.db.sa_execute( + engine, + sa.select(*select_cols).select_from(all_search), + include_cols=True + ) + rows = utils.db.result_dicts(rows) + + return table, rows, cols + diff --git a/co3/util/regex.py b/co3/util/regex.py new file mode 100644 index 0000000..8ba41d4 --- /dev/null +++ b/co3/util/regex.py @@ -0,0 +1,7 @@ +import re + + +camel2snake_regex = re.compile(r'(?LWNeeR#?ncbDNQm{)5f}J~e?#G#X&s_h}`1{|^rQ*-+=$wme(x-8p z$(U*HHe(stlx4=B`G!esz9Bv&aaU z&5!d2Z}N>-{sC{fh7l%VwJofVfCy0mbmspdd9U_Lrat?rKmJ5q%8CML}H%2b^61#|p+L`hTjTrm%qG z_fLajQiI}P35u1ffU}Q*I6vYGVSpnxZ_R@9YM9TcaZ!8caOX!Z)@!+dPR{TCIbHHc z?z&Ml(+Le+PC#B`1&S`{vSFm5i9fvL+A|#%V`&3-;IsMr)0Eca*7zg7bL3iMmN7-am>!Fmg2W9?b1b$> zhXh`Zv20gMs}ig_Mn)u%ci4sF1|n3a-d!C@X)x5S%8-PeFu=Fw+MFiyWy9^Ui2!Pb z8mnhY4cCa-(2n7*`V4DG0^hfn zHwjZpD#B?NCrknH5Nc$++bNN*S!onjygOLgSuw%?aoy7BB7oV^+shj(C*5vH0EMPG z@JW!6cb$Z0V~aTeaK~7$Vb*Zh6pN&aNz8JT3ET+O$dPMCG8-XBz#(E3DjSK3=S|lQ zuPRxH+?qgbbz+<5WL|$jwGarDp2}zv4DJ+?qO!x?FGRU!HkM?PhI-m%lU!;>>L-g5 zi3~XrT9oy!=dn1u5%8glHpvSh6j7BFEO$MW#N{x&}c+fG1+z4NAqM0fhk!8VJ zjQifgP=X;QL@JE`e)qoX<}4=wg`p)eWWmXHkPIne51rv|a$|D+ z?O*`0?&qh5%d9Wec;MZB&@2LgCNV6<^%z{oCgi<)kDma~t{O!v=7VHm{;QdJbSe$? zddyT`Ff%HAp!)~hqzRn0@TQ=JV#EF6raM4Erexlm^8| z@0CP`y5H6*MVI|%(bO71T`Sh*k|Z*s6|@Htr-%m^Up5<1E+E9|W1GW87;TGrwIYEj zsz*j58=(eftZ+5(1SX;tJ&}guO(ZQ_G0dLF9yOB=S&aTYMF^ZR11I|tw2lc&sYnQ> z@W8S~*n8C+jbcqkC8tf@I?GPN4C^*aE0LEsxbpMp>XyP6iUm0T*2RQ zm{{L{?UtnFR0}bzjpmDHXdw*5kZ%NG`Tc-@;Ai|9f68C-U%2Ipzvu6)YXuE+nj_>e zQGS^6XH))i%I%cDpIUx52+uGXKjl3fdyZp-zvC0@I`z9PoOL3B3JK97fKn1#c&1lo zRhN`{$Q8Aa4rMYgmqPXWig2#oTC&)hc`XiIU9t}_puW=Xs?7Z*3YC9){7aj2+qxZHLe NsIX#<@VMJy|38L&T6zEg literal 0 HcmV?d00001 diff --git a/docs/_build/doctrees/_autoref/co4.collectors.doctree b/docs/_build/doctrees/_autoref/co4.collectors.doctree new file mode 100644 index 0000000000000000000000000000000000000000..c5f656665d0760c0af25fe33a3a6cdf753814959 GIT binary patch literal 2999 zcmb7GTZ0x5xZ={~fj5J(X6jBKf^8BKLb zybpo)AXlsn=d7S8Vqxej?PWrcckAtfB&<4sr>nUQ*e4XJ;2^I+#GSw^(uYw;%b1S47*ZX^hC03}s-Of9_ z%X_cF1K#%?E39NIOa5k}o{SSEC3Y!oJ}+o;M&~TV9oTT?XSRr$e9-P)sB-KU6dBpT z4}G7sCGc(EtusIMSER^UICWF%2h>_Erp}_`SmCxvO{}JuNNNm}`0nI1tG;$pS1g4o zGSqAqZJh5}I*&_%@AF%HkKg9o{K$Vl;VNSjlg;(y+q#`*QfT!nsx%XoTP4+eg3>2Q z)l3L=D4xxtW~CWpZBWpilPx#pyVY4V&EyA-><2%&X{J&qk!;zun`^4NLCEfLmE9@7 z6MMivL*e``y8H$H_wc`u|3ehTzbcD4uFUx(WH4CW;0I(2ryq$N zJt8bmR0^x$`_9gezdkks-?!Hn3Da6>!fBpLrqS`3YGQ-muR6WrrBiwd{%B)m!v+7# zk1D6j1e&e4*B3T+`h!>ifMz)QBT-QBLrL?w!}LeHQ^;GmV*EADK)95otN=_9MgSwH zzMH6gh8ochkpie}CKiEr{V0x7vQ+sk0c;IZmldSNAG%s91fZvLDx<^wQd1&3p8Zl) z80Jz%7Fop80b3NxFtWO{gh*n^Yhgr%&wY{#L#HwpQfJv~cma;>p%?=ulq7@GVQofc zA`WrfJvZYQf*7VtBC?JaB$y`3RVy_g@KYu z*|5E+nNs8)nc+X-))wZQ$pmUMF3v4i`B>@sB={TAvP=M$#Ig*>V{sfi&>!D>`~>|R z=~=SjK5CZkziixtsWjsCjOnppc2>p!`zPFH62bbGPC=p6@^G@_j{wMwwA^e9AO>@g zg$sXR&T~r_go`8xTGZ_WTesdtTL8GpfawQU}5?Z(RDB%?O;NUB=q040p zvHQ#w2oYa2j#f*W=si{O=tR#c1+jGH^$O|ZnJQW~^C6?+r z!)yX@4v`d~Wiebazti|kd5dYcrmdbbP{Z4-6}pi^cm+Yl@0}y1(YJ-$X4pU0w5!p{s42@;5ep)hoE`FiH~T;-CnAw|)hn z2HYjRXSM!4n(;3D2wLC~3WDL;XaIyNU^`LP)Vr;^Jj-2?C(@-6JM(yqgES7kdOpN! I+)c;-0wZadU;qFB literal 0 HcmV?d00001 diff --git a/docs/_build/doctrees/_autoref/co4.composers.doctree b/docs/_build/doctrees/_autoref/co4.composers.doctree new file mode 100644 index 0000000000000000000000000000000000000000..75417526a0b21b3a0d0f0dd90b49a165fbc51130 GIT binary patch literal 3264 zcmb7GTWcIQ6i)2y+Pn6y?IaEv8?vx4IyyR+Pv?9(f42VlZ~IF5^E;;CBA*Uun&v8H zCiu-%B`#yR4IjhfzrtB~%LvbeeADEk+X2@M$~tywOWjvMZPh=b&;Bw%SIxpF%aUrmD8;H+Du(B zUyKl-X5*;i{D!5IxE1&gzr(lrUB1o_{Hq~X85^2xqK7}!V47i})$c&Y3{`HGRFfeR zA0kvUB-B|2n^7`{VxSH3xp%bYMtrNfhz3c%+pK-}XE(}J>Lg+iGN$>a#*SJCy1cCc))kf+#_v{uSge+b?3k|#x6IUOFwY>RFYL$XIa~j$4ROp9X(@tdz}_Web}}SA8#1ckVJW z9V?v$NcsjuSrBwUd=U&x-l-%^vQk3c3Cl^toA6j4sEPF0Z);X4ZHZ)W8Q@#G>uHxw z<2y|jPnIQ;Sn^gFQPt-TNrj;!8560a+-Uj&J+_Tx3_77~G8paEYGf?pD~7lCR{Vk! zOax^kvOHQ#ao<~*L~u{l67{(kn+s)=Pf&$YWWt6YcOUwG!3qLU7+NwZ0o#s}5k>5= zGyH9CZDGD24k0#!;?#1L50st^gWr#uWdP75mSwmei|g2g{P4lkXTYvjb$E6Q+|B%~E!db`C5n3p<@>gHUR2IxvrK(s)W|i9weM19$b9YY(Tk$5T{RE0T*$e zD~Gh21kO=CDiQe@HPEoa^~e(#16K4z7K>LZTD4*vxK09UCL6I7{d>((W zmIb+jztcFToq_F^q}3<~F|3Vei*{@wOo5PZL}B&)h@bKI`~`o`U-RF%K#0LV3kC<$Qi+JB}z(w zj~wu_}qKX14wt3*8>Jt(b5{jCKwyIPKG#c-YJ=5&&Z0935 zs*u_Tq*{!4$&~-or~a*;+4b6Mql6O4($1Yb_v6gHXKwyz{QYm|LhC-sQ zWX!a88?lUR$};0m{ewUKYk%Lh6n&+oRT1;<0yH8nl320Kzx1vf)Qw1Ve|COdv&aaU z&5!d2Z}Rn*{yuNHh7l%VwJo<7$;bVe8akw!=`V5`9nmrK;Q;h6|HLLCkh9d@_%gy~ zP7#mseAl(eJORGunzOhM-Q`4N%pckzb!}>l5<_c{Z^&;=#5&}%9wk&GitydYXj*=4 z#5P|nh6qrxQP8n&-OzE^@_d`$OrpLuRul*WM*U{ z#{(ojK&W~^s5KHcgJc0kUuooX`{0rt^3C!hDkS+%wRY_v?J$+GO%Q8=+4UvS3?Bsd zs0{9q-wqJ)&yhF31B}1K?=F7#@Oyxq_}4`)y;7Y&L<%=@CD!X$u7Rf&Uv}B*vlI<)d8@%=A)!7U2^k(raaz7^|TE}%23b;B4 ziW|#NjEr7E;%tQl5W`Ocg4BT6TLL0Ds{w&%KE&bdfX;;hj{ZLk$ND2M)D#vl{QhY$ zOlmOfp9ce+eH4aTKe>1u4r*lbZ7A92QJoXxqwQ}?)*7b@`vu4Q8d#D z4LnXjTw}#_NtF#F4Nd&P1=p^0Sd66&#BtGeBdY=tlR52fRg#i^-G*kyh-{3PW;YOZ z@pOz7NRef+cg>$^V!>tex2Gws$*u8+eEZO~#w=rsf-OB3=u4&zO>-`maD`7aPo)37O9hki*hi*%;Tq;8ncFX|ZCD-OOnJ*h|mrVpvGt^jJDK%Up zW!l(DJTj&8YWHPYZnCTHYi~DX9pj zS)4Eh#6zf&@ou|Bx@M(OSn+OuWoN|%|HpMpql*BlqqmkfR!+K|kN^rzbKsL8A@4c~ z&Bhip0N{?XzJxi$T~!R+8DhfQ*+8L6KvN+dGmSZGn! z=QfFjro$v8GK+G(>I?MP7Lw8Egrdn{v@=s9BM}~Rj3C#;7o2FOibiBvuomOKH!+am zp2{Wab2l^>$|f753KNkE)gJto!+i z;WFz>H6D1k7c`3iph*l%aXkjtu>pDS?xV-Rv#UnYiuoW}nE$FWA70Q0}IZuFS&>-_ux1&!oLnnlbF;DPA@m@}3sQWFQ zQgqpG7EP@I)YW2LE=eLII)ipU;uP`V;>%_O$_0ctePnaE2xDzAtIkMZit3S($VRAv ziWRN|p1?G;q9@W&yosb`D~7rA$fIV`A&b$!CkTNvX5eHmg4PjXDHRF91Rhwn2zz%n zL!(%eQORjjx5l#LFu%Hul1tFMC`FOQ0?lEFp=!*)O(>jQ1clNvAXo5r9H!ORV7n!0 zInhE4Yoqz18CnR#Fy!k&SbpE<@A)Zz%AfET{1smp>oa6{OOq1`Y{OOdx zm~uPi@1~aD3BprM#ZPz-$DZLB;cxlGx=#IW3um23ph7~l2%waN7OwQltm=|d54oZi z(xFV|yq`tWWul1YMlKn{3e z)}PMgr-0^-{{hW{|4`6&_@6?fJW7Xio>>xa&c($IZ;C8RY#b_T94@yV2P&MgMtI!q Gu>T*K%2xOQ literal 0 HcmV?d00001 diff --git a/docs/_build/doctrees/_autoref/co4.doctree b/docs/_build/doctrees/_autoref/co4.doctree new file mode 100644 index 0000000000000000000000000000000000000000..e21a9d85b6d173b899304ad08aaedff40bbbdc59 GIT binary patch literal 4902 zcmb7I-D)Jq71pkHB+Y0v`q^D2VOJY3!S*ikXdLiGl8gM{+$|9#b`o-7nwsvKsg}CC zI#t!Xql-Xt;o!lAA-MAZ0fQlr5HJ|>2mym3k6izA(-3|9=_jM}5WO2%ZAdvyrx!nn*pT#^e`N#RwKj(kUpV+=)FSN{*&vUzh z8NLXkK=CAhFSjF_Zo){Pmg~1Q_f061db#L{EwTMx{zUX`&x9u8jUl`1%eP)hnSa6N zJf~@xb?05aAoK0P_w&M=t(3vG$;F}Vd$qG-({7bMp4mH5nDG28n=(6K#;9)@lb4v6Z_MNkTIX= zc&;YDCO^E#fV03*KdK#Ys&;te=4fD?VB zR>rB!lAw{IB70&35s}7_;13PRYM%a-#6}n(QIkU&j!Bgh@Tx+Rx{+ImB zeycU+%P2xbtHJg{=d|YK!uD9e44X1aG%3B`QW~=ataHn_9fpY?WdWasQQ@BWm3T+| zM*L3vp4*+6Edrhzkw3cw>af%?97LN(a+)vgmI#9Y1+lbyrJ7o>lVtIfD<0&}HtfLh zU&|!A#M}YuY84O4%G=_^Wn+kB{;ZoqyI&??{6eub}g!(m* zM+6y92W?lp0{V}e0sXWA^l=L)nHbY^1!LFvT6j>p2Hw2_Ub&HUKwdw%g8HwULH)b| z^=S(#83NSOi>rXIcVsPW7+3?_v837}JE*T6TY>)1%|L(I0R4j&Xh-DAhpU*cbz?1L zs9yv5h%y}}0bg*{L44iN3h;k#2Kbu>;2*UBlbLbp!BxE1Ik6Tll>a}tJL&a06j2H3e9O1id2ZBZQ zYtJ6?MTn>wW-?t(>e*hvr`a6lMlYC35H-wDoW+pzks_ZHsQd#v3KPW06)hd#4gzD#C- ziHL*&xQgy|k&7)mqHBh?64~1!=(QJQaq86+L|~mD1p8FNB2u{TB(4A`{VP$bc@{`- z5fh~j_#%~>d(D-OCBE^VhdL}My6**{X48m(lwNLErGYXV0*pp6xH^NgmYb>Q}x ze!&P@dsmA*A#DLtzKhNosVZJU(L<^)FejOVh*21aCjaHZ>voj#)I(6vekZtFz{rp! zbRY1jIPABDF{%FXWCF21O)rg*$*ENHNpA1cOy>Y*dWOeHk3l+iARoW_=39v8NX`6? zdXlWvzgDTITL@A1f~(Vzo0+qL4PYWn9Kl#0mlRY{Ko^W1djd|zUR|Cw08eB8xp3|k??iAYz>K9bRAseDNjAxjd zb8Jtz&>zAnP|IL{#TJe`9c|zCs3k3~`4B_ftbW;|62cb($hS#Y{C;x&6h(gi8XbO0 zNb#ZgKzt(pEoTV~=h&2*-QFg1p$45mJUsZU|*bMck<(%BK;I3w;z&g@>3F3$fw zKLqJ00Kim8XjiD_6@h9>ig^eh=oL?8R5Q>`z1I=ev->TL{mQCabkx$14PF^KQSNtj zl_R(yW6$#O0RqHypMPAN3=BB8w%;!0A0w9U=f6h%;Y$!I8Q*R+7*`mqx2~3Ww-!6n Y?3R~wkaSLb83eSumKzbZ4B7Pbe+scS&Hw-a literal 0 HcmV?d00001 diff --git a/docs/_build/doctrees/_autoref/co4.managers.doctree b/docs/_build/doctrees/_autoref/co4.managers.doctree new file mode 100644 index 0000000000000000000000000000000000000000..9a26e45ea18d43bb91891ee42b98bed0d63a719a GIT binary patch literal 3521 zcmb7HTW=Fb6b6Ew*omD42t|U>qKX14wt3*8>Jt(bY85pPZB?lfXf)m(d#2gl+0G?6 zs*u_Tq*{!4$&{bc_x`hfv+G@7XwnkN($1MP=km=t-<zs>h(x-8p z$(U*HHewmslx4=B`Uk)JSN^_hDf&`Nt0Lyz1!zQEB(Y+df8kv>s2h>!{_Om^W|0vx ztB>;rZ}RmQ{yuNHh7l%V3tR45Bp>%vn$a;+`jebSNBHtVAL^HXV3QEX8CtJ>8DBG} zh{kxn>sq7^pRc**Eb2pdIT0E2hjvI^n;N6U&>CbLvRf0e4w@7Qe;U_`dskz-7t?IvuOQS2HN}AXoBd;GzdIGcu9m z0n#2IR6QWn8VQ?0QUlRf8tL3VxMYWXv%G~0M!r+6UHf}GOl52ngjyhWeMvNf2eCaW zV>{%x0|NYGq|NUD;ZO0qi{Cx`9v~(Dd67!5ROb&7L3{ClYwNj3S{+}JE*NXiajA@* zlg^DL1R{X)Nts=h+}R5ARKNMKRG%%R+F439IO|n~*$dJ1X3@+OKRY10i0LW}aC8m~ zA1%Q!GI|AtGxz5p3_lD6vH-%~5(vT990bJjJ_cuob1npM^S>cD*5^a8us?_3*AIhW zvH-#UIS|0te?hPi&bbi44XazRV7NKb6%Wo!?caIwJqK$Gd4N35?)91*`9pWjD4OYn z2HGZIs`Ph9>^tf@@bgEXL9Xs<`O7kyU|tNzJocm89fbx1pIaA{*mj*$vEG zyc8n^7GzoMUGqnpSg=?9)HJ0vxi$WfZy&nWm}N{+(4)s9reJJC(;SP<(jkGDBP`pq zrBw-59U~(Wm^$pjaRU*m6Ys8!q%@f{Y+>`@qU(eQE3+w?jHF6EBwdXMA}5hd!#k*9 z@@6Sv2`ePzr7)aS?*%;04$K~qL${?^E|nn(J7$3Il52CC)XRq3WfK9^3^i6)N)6YD z+0c&RuKSXz45&dvF`7cs0{jsRN%=oqS7gA5uq=`>w7hFsGwOZO(*obOmNyAgN-Dx> z7AH&r@epccyxT63Ua-|LwY^(Rl#X(Ob(KD<|DfNC1VVIq*r4kawMg zW@C#tA8^N5U&2`7t||t?jY-UMlnLAj)X1T0Mlu^AN5COs6e=5uiRVq%4NoYUi`*rF z+UmqM%}HHW{&IO3r;jsMI*8-Sc`Gro0z|F zPvsKzxf_}bWs{9jg^5Uo@!#&;bKRWf1fVdqWK;mQ6(mE7*h6Qy8{C*&e>oUHto!+i z;WFz>H6D1k7c`3iph*l%aXkjtu>pDS?xV-Rv#UnYiuoX!oBymbk4~kbUXPgS3uZ=z z4|M;4n>2y5mZ3wmP;9tA*l_zO$duH*Stmd=SdjUt+tDYPp%cQzm?!w5crPb1)cuxD zDZ1B59>T0nrmn4x9ok6=Faf*0w@ny3CnFICpkh6^W(cIe>&yQ zr`%5Y+o|Pug76e$@Dtv{v1d3&_!~a4uCsWzg|kj1P$3~&1W-ys3s-t&R*RBS54oZi z(xFW1aw$}=tq5!F){@0m<+V6;WywCMSed~6d#ko)J9q&>Fp;!@KD^tEWRl<>kON+r z^`|rWDWG}nzeBU&UlOz({)x~ikJ4eyGfU#lT3p=lrpThi#-XCd;d0w?pu!nzgvZ?u G`~LvQYf#(( literal 0 HcmV?d00001 diff --git a/docs/_build/doctrees/_autoref/modules.doctree b/docs/_build/doctrees/_autoref/modules.doctree new file mode 100644 index 0000000000000000000000000000000000000000..67cd7140efaea776f603904022865e84ab615e89 GIT binary patch literal 2754 zcmZ8jOK%%D5O!=!mSjnOBq<6cZV?n|5;V4oB8Q@<0_n}D4@D6mhk&4VsU>SJx#c64 z4*^=BDQbYXu)n2$uOD|;Ygq;aFNecXIbWiR^4&l<9)vO zE@hYazsUPtmgZ8sxsZUCe2AY1ks^_^{__k+vc~;E(v2 zKju69B)pz+U9y=i3p4wv1Iy=3;xSY-0W z`L>@U;X$U$N_&;BA<}@ww-A8NoMG!|wR>M8G5!RQeTCms{GQ?W0>4M$aMK|&2Y5!* z`Cf!^x1VtTJJK)~Dw95E3xV*EIscJ{K}nZ6s~nH#yFiXsbwPo1A@w}oggzH}j{4t( zNqf2z43sbD%&hbl=!a)nb>6M{X z#Z08@$)@wCx0OkDKmgX6Xh=j?7_F8qRO$2xr+1pV)={7)cOzJL*RhSi3=f>4%1WA0 zA*g*}m~GhBbJ|haq~7Y(NciOMUYKUyBrcPVx#N|jVQ?5&=A2Lk8u6&>tc3xu7+4be zZ>aPrQ`ee(?Oo+vyx<2HVOTK53^BYxyj)^AYM0(ftR}#jB<`nO zIPRq)UB_^|(Ap{O*xKg#y)a1)jw+MoLYp!|GPNLBML^~>H!Ms(Y9vguT0*Xb<7Cx= z@Yo(`TN1Q1tkT92$=)--w;e{D%5K>UM{Fs8nxoF!l~OPCayIt`+)b~jQ9unEhS3s| zAxf07lvMmDOoakQgsDvD(28N`-Qx87Q!DWO`0gfQ#%M!0Rk;M^P-7i8v(`tbn0f)#zRP^{V@_v}6p+s&)VOxM(liZgT>G%g!Yk>gujG{6b zJg6l#`%~?2MU`bf*JN2HJ{_`Ur7a`tCu@pij=UFEH2gduxv+FDQzC7Yd#k=ckByOx zMJLov2BVW!jjZNW_$+uoQ zr%%6q1w5x_k!_eyl3Vj%ugs%UY2xc8GiQRiMePIKKjW^Ha5i*wjuy((JRXD-5V9m) zZ*~a~TP23vghP9+99`*R5(s^!ut7!o+uM}rKU|QrmOohf-|@^ za`f*tLg0)!IC+>s>yogN3Q6!lNmI5C`>1_lfUI)S%(R=Z!_@oq1PFs>mY{h-MWJ$m z=5WMOQ!vaXT>nQ13e<9VwqSna=1a3X9N&>Pj{=BcZP6|IsfF;KfP60rn{WP>zp-JM z1n#;*gdZY*dt><%{C~s8HcZxwRiB<@0wquGVX={b-_>O(dR^!qzf4FI@-N9{+iIL&80$RkdpJ^!pEONk=vG=-_e?syf v<1b)8UTx?jyt6Fo-8k$9#~ty0C$3Aj-@Yh7ks?)Vl&9I&j)8Pr`}x`b;4?`6 literal 0 HcmV?d00001 diff --git a/docs/_build/doctrees/environment.pickle b/docs/_build/doctrees/environment.pickle new file mode 100644 index 0000000000000000000000000000000000000000..7ffbe48647697fe2bcbcbc79f3af6f8d3148ecb2 GIT binary patch literal 87074 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 literal 0 HcmV?d00001 diff --git a/docs/_build/doctrees/reference/documentation/index.doctree b/docs/_build/doctrees/reference/documentation/index.doctree new file mode 100644 index 0000000000000000000000000000000000000000..21283580c6bc12af19e7ace55a0705b328c659f2 GIT binary patch literal 3154 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 W)ifDWX;tKcBQJp=^KLKMto + + + + + + + + co4.accessors package - co4 documentation + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
co4 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+ +
+ +
+ +
+
+
+

co4.accessors package#

+
+

Submodules#

+
+
+

co4.accessors.fts module#

+
+
+

co4.accessors.table module#

+
+
+

co4.accessors.vss module#

+
+
+ +
+
+ +
+ +
+
+ + + + + \ No newline at end of file diff --git a/docs/_build/html/_autoref/co4.collectors.html b/docs/_build/html/_autoref/co4.collectors.html new file mode 100644 index 0000000..1867725 --- /dev/null +++ b/docs/_build/html/_autoref/co4.collectors.html @@ -0,0 +1,292 @@ + + + + + + + + + co4.collectors package - co4 documentation + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
co4 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+ +
+ +
+ +
+
+
+

co4.collectors package#

+
+

Submodules#

+
+
+

co4.collectors.core module#

+
+
+ +
+
+ +
+ +
+
+ + + + + \ No newline at end of file diff --git a/docs/_build/html/_autoref/co4.composers.html b/docs/_build/html/_autoref/co4.composers.html new file mode 100644 index 0000000..35d3349 --- /dev/null +++ b/docs/_build/html/_autoref/co4.composers.html @@ -0,0 +1,296 @@ + + + + + + + + + co4.composers package - co4 documentation + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
co4 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+ +
+ +
+ +
+
+
+

co4.composers package#

+
+

Submodules#

+
+
+

co4.composers.core module#

+
+
+

co4.composers.fts module#

+
+
+ +
+
+ +
+ +
+
+ + + + + \ No newline at end of file diff --git a/docs/_build/html/_autoref/co4.databases.html b/docs/_build/html/_autoref/co4.databases.html new file mode 100644 index 0000000..97f3f95 --- /dev/null +++ b/docs/_build/html/_autoref/co4.databases.html @@ -0,0 +1,300 @@ + + + + + + + + + co4.databases package - co4 documentation + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
co4 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+ +
+ +
+ +
+
+
+

co4.databases package#

+
+

Submodules#

+
+
+

co4.databases.core module#

+
+
+

co4.databases.fts module#

+
+
+

co4.databases.vss module#

+
+
+ +
+
+ +
+ +
+
+ + + + + \ No newline at end of file diff --git a/docs/_build/html/_autoref/co4.html b/docs/_build/html/_autoref/co4.html new file mode 100644 index 0000000..cbf2136 --- /dev/null +++ b/docs/_build/html/_autoref/co4.html @@ -0,0 +1,352 @@ + + + + + + + + + co4 package - co4 documentation + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
co4 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+ +
+ +
+ +
+
+
+

co4 package#

+
+

Subpackages#

+
+ +
+
+
+

Submodules#

+
+
+

co4.accessor module#

+
+
+

co4.co4 module#

+
+
+

co4.collector module#

+
+
+

co4.composer module#

+
+
+

co4.indexer module#

+
+
+

co4.manager module#

+
+
+ +
+
+ +
+ +
+
+ + + + + \ No newline at end of file diff --git a/docs/_build/html/_autoref/co4.managers.html b/docs/_build/html/_autoref/co4.managers.html new file mode 100644 index 0000000..7482d65 --- /dev/null +++ b/docs/_build/html/_autoref/co4.managers.html @@ -0,0 +1,300 @@ + + + + + + + + + co4.managers package - co4 documentation + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
co4 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+ +
+ +
+ +
+
+
+

co4.managers package#

+
+

Submodules#

+
+
+

co4.managers.core module#

+
+
+

co4.managers.fts module#

+
+
+

co4.managers.vss module#

+
+
+ +
+
+ +
+ +
+
+ + + + + \ No newline at end of file diff --git a/docs/_build/html/_autoref/modules.html b/docs/_build/html/_autoref/modules.html new file mode 100644 index 0000000..c7d96e9 --- /dev/null +++ b/docs/_build/html/_autoref/modules.html @@ -0,0 +1,297 @@ + + + + + + + + + co4 - co4 documentation + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
co4 documentation
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+ +
+ +
+ +
+
+
+

co4#

+
+ +
+
+ +
+
+
+ +
+ + +
+
+
+
+ Copyright © 2023, Sam Griesemer +
+ Made with Sphinx and @pradyunsg's + + Furo + +
+
+ +
+
+ +
+
+ +
+
+ + + + + \ No newline at end of file diff --git a/docs/_build/html/_sources/_autoref/co4.accessors.rst.txt b/docs/_build/html/_sources/_autoref/co4.accessors.rst.txt new file mode 100644 index 0000000..f1233e2 --- /dev/null +++ b/docs/_build/html/_sources/_autoref/co4.accessors.rst.txt @@ -0,0 +1,34 @@ +co4.accessors package +===================== + +.. automodule:: co4.accessors + :members: + :undoc-members: + :show-inheritance: + +Submodules +---------- + +co4.accessors.fts module +------------------------ + +.. automodule:: co4.accessors.fts + :members: + :undoc-members: + :show-inheritance: + +co4.accessors.table module +-------------------------- + +.. automodule:: co4.accessors.table + :members: + :undoc-members: + :show-inheritance: + +co4.accessors.vss module +------------------------ + +.. automodule:: co4.accessors.vss + :members: + :undoc-members: + :show-inheritance: diff --git a/docs/_build/html/_sources/_autoref/co4.collectors.rst.txt b/docs/_build/html/_sources/_autoref/co4.collectors.rst.txt new file mode 100644 index 0000000..72d7ce2 --- /dev/null +++ b/docs/_build/html/_sources/_autoref/co4.collectors.rst.txt @@ -0,0 +1,18 @@ +co4.collectors package +====================== + +.. automodule:: co4.collectors + :members: + :undoc-members: + :show-inheritance: + +Submodules +---------- + +co4.collectors.core module +-------------------------- + +.. automodule:: co4.collectors.core + :members: + :undoc-members: + :show-inheritance: diff --git a/docs/_build/html/_sources/_autoref/co4.composers.rst.txt b/docs/_build/html/_sources/_autoref/co4.composers.rst.txt new file mode 100644 index 0000000..5eb604b --- /dev/null +++ b/docs/_build/html/_sources/_autoref/co4.composers.rst.txt @@ -0,0 +1,26 @@ +co4.composers package +===================== + +.. automodule:: co4.composers + :members: + :undoc-members: + :show-inheritance: + +Submodules +---------- + +co4.composers.core module +------------------------- + +.. automodule:: co4.composers.core + :members: + :undoc-members: + :show-inheritance: + +co4.composers.fts module +------------------------ + +.. automodule:: co4.composers.fts + :members: + :undoc-members: + :show-inheritance: diff --git a/docs/_build/html/_sources/_autoref/co4.databases.rst.txt b/docs/_build/html/_sources/_autoref/co4.databases.rst.txt new file mode 100644 index 0000000..d542e91 --- /dev/null +++ b/docs/_build/html/_sources/_autoref/co4.databases.rst.txt @@ -0,0 +1,34 @@ +co4.databases package +===================== + +.. automodule:: co4.databases + :members: + :undoc-members: + :show-inheritance: + +Submodules +---------- + +co4.databases.core module +------------------------- + +.. automodule:: co4.databases.core + :members: + :undoc-members: + :show-inheritance: + +co4.databases.fts module +------------------------ + +.. automodule:: co4.databases.fts + :members: + :undoc-members: + :show-inheritance: + +co4.databases.vss module +------------------------ + +.. automodule:: co4.databases.vss + :members: + :undoc-members: + :show-inheritance: diff --git a/docs/_build/html/_sources/_autoref/co4.managers.rst.txt b/docs/_build/html/_sources/_autoref/co4.managers.rst.txt new file mode 100644 index 0000000..cea3f3d --- /dev/null +++ b/docs/_build/html/_sources/_autoref/co4.managers.rst.txt @@ -0,0 +1,34 @@ +co4.managers package +==================== + +.. automodule:: co4.managers + :members: + :undoc-members: + :show-inheritance: + +Submodules +---------- + +co4.managers.core module +------------------------ + +.. automodule:: co4.managers.core + :members: + :undoc-members: + :show-inheritance: + +co4.managers.fts module +----------------------- + +.. automodule:: co4.managers.fts + :members: + :undoc-members: + :show-inheritance: + +co4.managers.vss module +----------------------- + +.. automodule:: co4.managers.vss + :members: + :undoc-members: + :show-inheritance: diff --git a/docs/_build/html/_sources/_autoref/co4.rst.txt b/docs/_build/html/_sources/_autoref/co4.rst.txt new file mode 100644 index 0000000..7d5ccfc --- /dev/null +++ b/docs/_build/html/_sources/_autoref/co4.rst.txt @@ -0,0 +1,70 @@ +co4 package +=========== + +.. automodule:: co4 + :members: + :undoc-members: + :show-inheritance: + +Subpackages +----------- + +.. toctree:: + :maxdepth: 4 + + co4.accessors + co4.collectors + co4.composers + co4.databases + co4.managers + +Submodules +---------- + +co4.accessor module +------------------- + +.. automodule:: co4.accessor + :members: + :undoc-members: + :show-inheritance: + +co4.co4 module +-------------- + +.. automodule:: co4.co4 + :members: + :undoc-members: + :show-inheritance: + +co4.collector module +-------------------- + +.. automodule:: co4.collector + :members: + :undoc-members: + :show-inheritance: + +co4.composer module +------------------- + +.. automodule:: co4.composer + :members: + :undoc-members: + :show-inheritance: + +co4.indexer module +------------------ + +.. automodule:: co4.indexer + :members: + :undoc-members: + :show-inheritance: + +co4.manager module +------------------ + +.. automodule:: co4.manager + :members: + :undoc-members: + :show-inheritance: diff --git a/docs/_build/html/_sources/_autoref/modules.rst.txt b/docs/_build/html/_sources/_autoref/modules.rst.txt new file mode 100644 index 0000000..a72e900 --- /dev/null +++ b/docs/_build/html/_sources/_autoref/modules.rst.txt @@ -0,0 +1,7 @@ +co4 +=== + +.. toctree:: + :maxdepth: 4 + + co4 diff --git a/docs/_build/html/_sources/index.md.txt b/docs/_build/html/_sources/index.md.txt new file mode 100644 index 0000000..cd39ee1 --- /dev/null +++ b/docs/_build/html/_sources/index.md.txt @@ -0,0 +1,24 @@ +# `co4` package docs +{ref}`genindex` +{ref}`modindex` +{ref}`search` + +```{toctree} +:maxdepth: 3 +:caption: Autoref + +_autoref/co4.rst +``` + +```{toctree} +:maxdepth: 3 +:caption: Contents + +reference/documentation/index +reference/site/index +``` + +```{include} ../../README.md +``` + + diff --git a/docs/_build/html/_sources/reference/documentation/index.md.txt b/docs/_build/html/_sources/reference/documentation/index.md.txt new file mode 100644 index 0000000..a14cdde --- /dev/null +++ b/docs/_build/html/_sources/reference/documentation/index.md.txt @@ -0,0 +1,8 @@ +# Documentation + +```{toctree} +:hidden: + +sphinx +``` + diff --git a/docs/_build/html/_sources/reference/documentation/sphinx.md.txt b/docs/_build/html/_sources/reference/documentation/sphinx.md.txt new file mode 100644 index 0000000..33d6f27 --- /dev/null +++ b/docs/_build/html/_sources/reference/documentation/sphinx.md.txt @@ -0,0 +1,111 @@ +# Sphinx +The primary driver of this package's documentation is Sphinx's `autodoc` extension, +using the [Furo theme][1]. + +**High-level details**: + +- `sphinx-apidoc` generates package-based documentation to the `_autoref/` directory, + with navigation available under "Autoref" in the sidebar. +- Markdown-based documentation files are manually written under the `reference/` + directory, showing up under "Contents" in the sidebar. + +## Detailed directory structure +All files are placed under `docs/sphinx`: + +- `_`-prefixed are Sphinx-managed directories + * `_build/html/` houses output HTML files + * `_autoref/` is the target for module-based RST files written by `autodoc` +- `reference/`: houses all manually written documentation (totally separate from + auto-generated package docs) +- `conf.py`: single Sphinx configuration file +- `index.md`: documentation index, setups up a persistent sidebar across all other pages + +For manually written documentation under `reference/`, topics are nested as needed. Within +a nested directory `reference/`, an `index.md` should created with content like: + +``` +# + +\`\`\`{toctree} +:hidden: + +sub-topic-1.rst +sub-topic-2.rst +... +\`\`\` +``` + +This will add the nested directory to the sidebar navigation, using the name set under the +top-level header. See [Markdown syntax][#markdown-syntax] for more details on the syntax. + +## Sphinx autodoc +Sphinx's `autodoc` extension allows automatic generation of documents according to +(Python) subpackage structure and available docstrings. A few notes here: + +- In the `conf.py` file, autodoc is enabled by adding `"sphinx.ext.autodoc"` to + the extensions list. `"sphinx.ext.viewcode"` can also be added to provide + links to source code. +- Documents are actually generated by calling the `sphinx-apidoc` CLI command. The + current Makefile uses the following call: + + ```sh + sphinx-apidoc --module-first -o docs/sphinx/_autoref/ localsys + ``` + + This writes the automatically generated docs for modules in the package at the + local directory `localsys/` to the `docs/sphinx/_autoref` directory. These are + reStructuredText files by default. + * `--module-first` places the module-level descriptions at the top of the module page. + By default, this is placed at the bottom (oddly), and can be obscured by large lists + of subpackages if this flag isn't provided. + * See available `sphinx-apidoc` options [here][2], as well as more advanced config + [here][3]. + + +## Markdown syntax +The `myst_parser` extension enables Markdown (or something close to it) to be used when +writing documentation files. The Sphinx directives can be difficult to track, and +they change slightly under the MyST Markdown syntax. The following are a few common +blocks: + +**Page hierarchies**: the following will generate link hierarchy according to the provided +pages: + +``` +\`\`\`{toctree} +:maxdepth: +:caption:
+:hidden: + +example-file-1 +example-file-2 +example-dir/index +... +\`\`\` +``` + +- `:maxdepth:` limits the depth of nesting +- `:caption:` title for the group of pages +- `:hidden:` if provided, links will only show in the sidebar (hidden on the page) +- Constituent files: listed files will be rendered as a link directly. If a listed file + has a `{toctree}` directive, this tree will be rendered in place of the page's link as a + dropdown. The dropdown will be named according to the file's top-level heading, and + clicking directly on the dropdown header will show that page's content. Files found in + the tree will be placed as links under the dropdown, recursively subject to same rules + described here. + +**Include files**: the following will include file content +pages: + +``` +\`\`\`{include} README.md +\`\`\` +``` + +**Reference directives** + + +[1]: https://pradyunsg.me/furo/ +[2]: https://www.sphinx-doc.org/en/master/man/sphinx-apidoc.html +[3]: https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html# + diff --git a/docs/_build/html/_static/basic.css b/docs/_build/html/_static/basic.css new file mode 100644 index 0000000..30fee9d --- /dev/null +++ b/docs/_build/html/_static/basic.css @@ -0,0 +1,925 @@ +/* + * basic.css + * ~~~~~~~~~ + * + * Sphinx stylesheet -- basic theme. + * + * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/* -- main layout ----------------------------------------------------------- */ + +div.clearer { + clear: both; +} + +div.section::after { + display: block; + content: ''; + clear: left; +} + +/* -- relbar ---------------------------------------------------------------- */ + +div.related { + width: 100%; + font-size: 90%; +} + +div.related h3 { + display: none; +} + +div.related ul { + margin: 0; + padding: 0 0 0 10px; + list-style: none; +} + +div.related li { + display: inline; +} + +div.related li.right { + float: right; + margin-right: 5px; +} + +/* -- sidebar --------------------------------------------------------------- */ + +div.sphinxsidebarwrapper { + padding: 10px 5px 0 10px; +} + +div.sphinxsidebar { + float: left; + width: 230px; + margin-left: -100%; + font-size: 90%; + word-wrap: break-word; + overflow-wrap : break-word; +} + +div.sphinxsidebar ul { + list-style: none; +} + +div.sphinxsidebar ul ul, +div.sphinxsidebar ul.want-points { + margin-left: 20px; + list-style: square; +} + +div.sphinxsidebar ul ul { + margin-top: 0; + margin-bottom: 0; +} + +div.sphinxsidebar form { + margin-top: 10px; +} + +div.sphinxsidebar input { + border: 1px solid #98dbcc; + font-family: sans-serif; + font-size: 1em; +} + +div.sphinxsidebar #searchbox form.search { + overflow: hidden; +} + +div.sphinxsidebar #searchbox input[type="text"] { + float: left; + width: 80%; + padding: 0.25em; + box-sizing: border-box; +} + +div.sphinxsidebar #searchbox input[type="submit"] { + float: left; + width: 20%; + border-left: none; + padding: 0.25em; + box-sizing: border-box; +} + + +img { + border: 0; + max-width: 100%; +} + +/* -- search page ----------------------------------------------------------- */ + +ul.search { + margin: 10px 0 0 20px; + padding: 0; +} + +ul.search li { + padding: 5px 0 5px 20px; + background-image: url(file.png); + background-repeat: no-repeat; + background-position: 0 7px; +} + +ul.search li a { + font-weight: bold; +} + +ul.search li p.context { + color: #888; + margin: 2px 0 0 30px; + text-align: left; +} + +ul.keywordmatches li.goodmatch a { + font-weight: bold; +} + +/* -- index page ------------------------------------------------------------ */ + +table.contentstable { + width: 90%; + margin-left: auto; + margin-right: auto; +} + +table.contentstable p.biglink { + line-height: 150%; +} + +a.biglink { + font-size: 1.3em; +} + +span.linkdescr { + font-style: italic; + padding-top: 5px; + font-size: 90%; +} + +/* -- general index --------------------------------------------------------- */ + +table.indextable { + width: 100%; +} + +table.indextable td { + text-align: left; + vertical-align: top; +} + +table.indextable ul { + margin-top: 0; + margin-bottom: 0; + list-style-type: none; +} + +table.indextable > tbody > tr > td > ul { + padding-left: 0em; +} + +table.indextable tr.pcap { + height: 10px; +} + +table.indextable tr.cap { + margin-top: 10px; + background-color: #f2f2f2; +} + +img.toggler { + margin-right: 3px; + margin-top: 3px; + cursor: pointer; +} + +div.modindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +div.genindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +/* -- domain module index --------------------------------------------------- */ + +table.modindextable td { + padding: 2px; + border-collapse: collapse; +} + +/* -- general body styles --------------------------------------------------- */ + +div.body { + min-width: 360px; + max-width: 800px; +} + +div.body p, div.body dd, div.body li, div.body blockquote { + -moz-hyphens: auto; + -ms-hyphens: auto; + -webkit-hyphens: auto; + hyphens: auto; +} + +a.headerlink { + visibility: hidden; +} + +a:visited { + color: #551A8B; +} + +h1:hover > a.headerlink, +h2:hover > a.headerlink, +h3:hover > a.headerlink, +h4:hover > a.headerlink, +h5:hover > a.headerlink, +h6:hover > a.headerlink, +dt:hover > a.headerlink, +caption:hover > a.headerlink, +p.caption:hover > a.headerlink, +div.code-block-caption:hover > a.headerlink { + visibility: visible; +} + +div.body p.caption { + text-align: inherit; +} + +div.body td { + text-align: left; +} + +.first { + margin-top: 0 !important; +} + +p.rubric { + margin-top: 30px; + font-weight: bold; +} + +img.align-left, figure.align-left, .figure.align-left, object.align-left { + clear: left; + float: left; + margin-right: 1em; +} + +img.align-right, figure.align-right, .figure.align-right, object.align-right { + clear: right; + float: right; + margin-left: 1em; +} + +img.align-center, figure.align-center, .figure.align-center, object.align-center { + display: block; + margin-left: auto; + margin-right: auto; +} + +img.align-default, figure.align-default, .figure.align-default { + display: block; + margin-left: auto; + margin-right: auto; +} + +.align-left { + text-align: left; +} + +.align-center { + text-align: center; +} + +.align-default { + text-align: center; +} + +.align-right { + text-align: right; +} + +/* -- sidebars -------------------------------------------------------------- */ + +div.sidebar, +aside.sidebar { + margin: 0 0 0.5em 1em; + border: 1px solid #ddb; + padding: 7px; + background-color: #ffe; + width: 40%; + float: right; + clear: right; + overflow-x: auto; +} + +p.sidebar-title { + font-weight: bold; +} + +nav.contents, +aside.topic, +div.admonition, div.topic, blockquote { + clear: left; +} + +/* -- topics ---------------------------------------------------------------- */ + +nav.contents, +aside.topic, +div.topic { + border: 1px solid #ccc; + padding: 7px; + margin: 10px 0 10px 0; +} + +p.topic-title { + font-size: 1.1em; + font-weight: bold; + margin-top: 10px; +} + +/* -- admonitions ----------------------------------------------------------- */ + +div.admonition { + margin-top: 10px; + margin-bottom: 10px; + padding: 7px; +} + +div.admonition dt { + font-weight: bold; +} + +p.admonition-title { + margin: 0px 10px 5px 0px; + font-weight: bold; +} + +div.body p.centered { + text-align: center; + margin-top: 25px; +} + +/* -- content of sidebars/topics/admonitions -------------------------------- */ + +div.sidebar > :last-child, +aside.sidebar > :last-child, +nav.contents > :last-child, +aside.topic > :last-child, +div.topic > :last-child, +div.admonition > :last-child { + margin-bottom: 0; +} + +div.sidebar::after, +aside.sidebar::after, +nav.contents::after, +aside.topic::after, +div.topic::after, +div.admonition::after, +blockquote::after { + display: block; + content: ''; + clear: both; +} + +/* -- tables ---------------------------------------------------------------- */ + +table.docutils { + margin-top: 10px; + margin-bottom: 10px; + border: 0; + border-collapse: collapse; +} + +table.align-center { + margin-left: auto; + margin-right: auto; +} + +table.align-default { + margin-left: auto; + margin-right: auto; +} + +table caption span.caption-number { + font-style: italic; +} + +table caption span.caption-text { +} + +table.docutils td, table.docutils th { + padding: 1px 8px 1px 5px; + border-top: 0; + border-left: 0; + border-right: 0; + border-bottom: 1px solid #aaa; +} + +th { + text-align: left; + padding-right: 5px; +} + +table.citation { + border-left: solid 1px gray; + margin-left: 1px; +} + +table.citation td { + border-bottom: none; +} + +th > :first-child, +td > :first-child { + margin-top: 0px; +} + +th > :last-child, +td > :last-child { + margin-bottom: 0px; +} + +/* -- figures --------------------------------------------------------------- */ + +div.figure, figure { + margin: 0.5em; + padding: 0.5em; +} + +div.figure p.caption, figcaption { + padding: 0.3em; +} + +div.figure p.caption span.caption-number, +figcaption span.caption-number { + font-style: italic; +} + +div.figure p.caption span.caption-text, +figcaption span.caption-text { +} + +/* -- field list styles ----------------------------------------------------- */ + +table.field-list td, table.field-list th { + border: 0 !important; +} + +.field-list ul { + margin: 0; + padding-left: 1em; +} + +.field-list p { + margin: 0; +} + +.field-name { + -moz-hyphens: manual; + -ms-hyphens: manual; + -webkit-hyphens: manual; + hyphens: manual; +} + +/* -- hlist styles ---------------------------------------------------------- */ + +table.hlist { + margin: 1em 0; +} + +table.hlist td { + vertical-align: top; +} + +/* -- object description styles --------------------------------------------- */ + +.sig { + font-family: 'Consolas', 'Menlo', 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', monospace; +} + +.sig-name, code.descname { + background-color: transparent; + font-weight: bold; +} + +.sig-name { + font-size: 1.1em; +} + +code.descname { + font-size: 1.2em; +} + +.sig-prename, code.descclassname { + background-color: transparent; +} + +.optional { + font-size: 1.3em; +} + +.sig-paren { + font-size: larger; +} + +.sig-param.n { + font-style: italic; +} + +/* C++ specific styling */ + +.sig-inline.c-texpr, +.sig-inline.cpp-texpr { + font-family: unset; +} + +.sig.c .k, .sig.c .kt, +.sig.cpp .k, .sig.cpp .kt { + color: #0033B3; +} + +.sig.c .m, +.sig.cpp .m { + color: #1750EB; +} + +.sig.c .s, .sig.c .sc, +.sig.cpp .s, .sig.cpp .sc { + color: #067D17; +} + + +/* -- other body styles ----------------------------------------------------- */ + +ol.arabic { + list-style: decimal; +} + +ol.loweralpha { + list-style: lower-alpha; +} + +ol.upperalpha { + list-style: upper-alpha; +} + +ol.lowerroman { + list-style: lower-roman; +} + +ol.upperroman { + list-style: upper-roman; +} + +:not(li) > ol > li:first-child > :first-child, +:not(li) > ul > li:first-child > :first-child { + margin-top: 0px; +} + +:not(li) > ol > li:last-child > :last-child, +:not(li) > ul > li:last-child > :last-child { + margin-bottom: 0px; +} + +ol.simple ol p, +ol.simple ul p, +ul.simple ol p, +ul.simple ul p { + margin-top: 0; +} + +ol.simple > li:not(:first-child) > p, +ul.simple > li:not(:first-child) > p { + margin-top: 0; +} + +ol.simple p, +ul.simple p { + margin-bottom: 0; +} + +aside.footnote > span, +div.citation > span { + float: left; +} +aside.footnote > span:last-of-type, +div.citation > span:last-of-type { + padding-right: 0.5em; +} +aside.footnote > p { + margin-left: 2em; +} +div.citation > p { + margin-left: 4em; +} +aside.footnote > p:last-of-type, +div.citation > p:last-of-type { + margin-bottom: 0em; +} +aside.footnote > p:last-of-type:after, +div.citation > p:last-of-type:after { + content: ""; + clear: both; +} + +dl.field-list { + display: grid; + grid-template-columns: fit-content(30%) auto; +} + +dl.field-list > dt { + font-weight: bold; + word-break: break-word; + padding-left: 0.5em; + padding-right: 5px; +} + +dl.field-list > dd { + padding-left: 0.5em; + margin-top: 0em; + margin-left: 0em; + margin-bottom: 0em; +} + +dl { + margin-bottom: 15px; +} + +dd > :first-child { + margin-top: 0px; +} + +dd ul, dd table { + margin-bottom: 10px; +} + +dd { + margin-top: 3px; + margin-bottom: 10px; + margin-left: 30px; +} + +.sig dd { + margin-top: 0px; + margin-bottom: 0px; +} + +.sig dl { + margin-top: 0px; + margin-bottom: 0px; +} + +dl > dd:last-child, +dl > dd:last-child > :last-child { + margin-bottom: 0; +} + +dt:target, span.highlighted { + background-color: #fbe54e; +} + +rect.highlighted { + fill: #fbe54e; +} + +dl.glossary dt { + font-weight: bold; + font-size: 1.1em; +} + +.versionmodified { + font-style: italic; +} + +.system-message { + background-color: #fda; + padding: 5px; + border: 3px solid red; +} + +.footnote:target { + background-color: #ffa; +} + +.line-block { + display: block; + margin-top: 1em; + margin-bottom: 1em; +} + +.line-block .line-block { + margin-top: 0; + margin-bottom: 0; + margin-left: 1.5em; +} + +.guilabel, .menuselection { + font-family: sans-serif; +} + +.accelerator { + text-decoration: underline; +} + +.classifier { + font-style: oblique; +} + +.classifier:before { + font-style: normal; + margin: 0 0.5em; + content: ":"; + display: inline-block; +} + +abbr, acronym { + border-bottom: dotted 1px; + cursor: help; +} + +.translated { + background-color: rgba(207, 255, 207, 0.2) +} + +.untranslated { + background-color: rgba(255, 207, 207, 0.2) +} + +/* -- code displays --------------------------------------------------------- */ + +pre { + overflow: auto; + overflow-y: hidden; /* fixes display issues on Chrome browsers */ +} + +pre, div[class*="highlight-"] { + clear: both; +} + +span.pre { + -moz-hyphens: none; + -ms-hyphens: none; + -webkit-hyphens: none; + hyphens: none; + white-space: nowrap; +} + +div[class*="highlight-"] { + margin: 1em 0; +} + +td.linenos pre { + border: 0; + background-color: transparent; + color: #aaa; +} + +table.highlighttable { + display: block; +} + +table.highlighttable tbody { + display: block; +} + +table.highlighttable tr { + display: flex; +} + +table.highlighttable td { + margin: 0; + padding: 0; +} + +table.highlighttable td.linenos { + padding-right: 0.5em; +} + +table.highlighttable td.code { + flex: 1; + overflow: hidden; +} + +.highlight .hll { + display: block; +} + +div.highlight pre, +table.highlighttable pre { + margin: 0; +} + +div.code-block-caption + div { + margin-top: 0; +} + +div.code-block-caption { + margin-top: 1em; + padding: 2px 5px; + font-size: small; +} + +div.code-block-caption code { + background-color: transparent; +} + +table.highlighttable td.linenos, +span.linenos, +div.highlight span.gp { /* gp: Generic.Prompt */ + user-select: none; + -webkit-user-select: text; /* Safari fallback only */ + -webkit-user-select: none; /* Chrome/Safari */ + -moz-user-select: none; /* Firefox */ + -ms-user-select: none; /* IE10+ */ +} + +div.code-block-caption span.caption-number { + padding: 0.1em 0.3em; + font-style: italic; +} + +div.code-block-caption span.caption-text { +} + +div.literal-block-wrapper { + margin: 1em 0; +} + +code.xref, a code { + background-color: transparent; + font-weight: bold; +} + +h1 code, h2 code, h3 code, h4 code, h5 code, h6 code { + background-color: transparent; +} + +.viewcode-link { + float: right; +} + +.viewcode-back { + float: right; + font-family: sans-serif; +} + +div.viewcode-block:target { + margin: -1px -10px; + padding: 0 10px; +} + +/* -- math display ---------------------------------------------------------- */ + +img.math { + vertical-align: middle; +} + +div.body div.math p { + text-align: center; +} + +span.eqno { + float: right; +} + +span.eqno a.headerlink { + position: absolute; + z-index: 1; +} + +div.math:hover a.headerlink { + visibility: visible; +} + +/* -- printout stylesheet --------------------------------------------------- */ + +@media print { + div.document, + div.documentwrapper, + div.bodywrapper { + margin: 0 !important; + width: 100%; + } + + div.sphinxsidebar, + div.related, + div.footer, + #top-link { + display: none; + } +} \ No newline at end of file diff --git a/docs/_build/html/_static/debug.css b/docs/_build/html/_static/debug.css new file mode 100644 index 0000000..74d4aec --- /dev/null +++ b/docs/_build/html/_static/debug.css @@ -0,0 +1,69 @@ +/* + This CSS file should be overridden by the theme authors. It's + meant for debugging and developing the skeleton that this theme provides. +*/ +body { + font-family: -apple-system, "Segoe UI", Roboto, Helvetica, Arial, sans-serif, + "Apple Color Emoji", "Segoe UI Emoji"; + background: lavender; +} +.sb-announcement { + background: rgb(131, 131, 131); +} +.sb-announcement__inner { + background: black; + color: white; +} +.sb-header { + background: lightskyblue; +} +.sb-header__inner { + background: royalblue; + color: white; +} +.sb-header-secondary { + background: lightcyan; +} +.sb-header-secondary__inner { + background: cornflowerblue; + color: white; +} +.sb-sidebar-primary { + background: lightgreen; +} +.sb-main { + background: blanchedalmond; +} +.sb-main__inner { + background: antiquewhite; +} +.sb-header-article { + background: lightsteelblue; +} +.sb-article-container { + background: snow; +} +.sb-article-main { + background: white; +} +.sb-footer-article { + background: lightpink; +} +.sb-sidebar-secondary { + background: lightgoldenrodyellow; +} +.sb-footer-content { + background: plum; +} +.sb-footer-content__inner { + background: palevioletred; +} +.sb-footer { + background: pink; +} +.sb-footer__inner { + background: salmon; +} +.sb-article { + background: white; +} diff --git a/docs/_build/html/_static/doctools.js b/docs/_build/html/_static/doctools.js new file mode 100644 index 0000000..d06a71d --- /dev/null +++ b/docs/_build/html/_static/doctools.js @@ -0,0 +1,156 @@ +/* + * doctools.js + * ~~~~~~~~~~~ + * + * Base JavaScript utilities for all Sphinx HTML documentation. + * + * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ +"use strict"; + +const BLACKLISTED_KEY_CONTROL_ELEMENTS = new Set([ + "TEXTAREA", + "INPUT", + "SELECT", + "BUTTON", +]); + +const _ready = (callback) => { + if (document.readyState !== "loading") { + callback(); + } else { + document.addEventListener("DOMContentLoaded", callback); + } +}; + +/** + * Small JavaScript module for the documentation. + */ +const Documentation = { + init: () => { + Documentation.initDomainIndexTable(); + Documentation.initOnKeyListeners(); + }, + + /** + * i18n support + */ + TRANSLATIONS: {}, + PLURAL_EXPR: (n) => (n === 1 ? 0 : 1), + LOCALE: "unknown", + + // gettext and ngettext don't access this so that the functions + // can safely bound to a different name (_ = Documentation.gettext) + gettext: (string) => { + const translated = Documentation.TRANSLATIONS[string]; + switch (typeof translated) { + case "undefined": + return string; // no translation + case "string": + return translated; // translation exists + default: + return translated[0]; // (singular, plural) translation tuple exists + } + }, + + ngettext: (singular, plural, n) => { + const translated = Documentation.TRANSLATIONS[singular]; + if (typeof translated !== "undefined") + return translated[Documentation.PLURAL_EXPR(n)]; + return n === 1 ? singular : plural; + }, + + addTranslations: (catalog) => { + Object.assign(Documentation.TRANSLATIONS, catalog.messages); + Documentation.PLURAL_EXPR = new Function( + "n", + `return (${catalog.plural_expr})` + ); + Documentation.LOCALE = catalog.locale; + }, + + /** + * helper function to focus on search bar + */ + focusSearchBar: () => { + document.querySelectorAll("input[name=q]")[0]?.focus(); + }, + + /** + * Initialise the domain index toggle buttons + */ + initDomainIndexTable: () => { + const toggler = (el) => { + const idNumber = el.id.substr(7); + const toggledRows = document.querySelectorAll(`tr.cg-${idNumber}`); + if (el.src.substr(-9) === "minus.png") { + el.src = `${el.src.substr(0, el.src.length - 9)}plus.png`; + toggledRows.forEach((el) => (el.style.display = "none")); + } else { + el.src = `${el.src.substr(0, el.src.length - 8)}minus.png`; + toggledRows.forEach((el) => (el.style.display = "")); + } + }; + + const togglerElements = document.querySelectorAll("img.toggler"); + togglerElements.forEach((el) => + el.addEventListener("click", (event) => toggler(event.currentTarget)) + ); + togglerElements.forEach((el) => (el.style.display = "")); + if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) togglerElements.forEach(toggler); + }, + + initOnKeyListeners: () => { + // only install a listener if it is really needed + if ( + !DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS && + !DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS + ) + return; + + document.addEventListener("keydown", (event) => { + // bail for input elements + if (BLACKLISTED_KEY_CONTROL_ELEMENTS.has(document.activeElement.tagName)) return; + // bail with special keys + if (event.altKey || event.ctrlKey || event.metaKey) return; + + if (!event.shiftKey) { + switch (event.key) { + case "ArrowLeft": + if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break; + + const prevLink = document.querySelector('link[rel="prev"]'); + if (prevLink && prevLink.href) { + window.location.href = prevLink.href; + event.preventDefault(); + } + break; + case "ArrowRight": + if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break; + + const nextLink = document.querySelector('link[rel="next"]'); + if (nextLink && nextLink.href) { + window.location.href = nextLink.href; + event.preventDefault(); + } + break; + } + } + + // some keyboard layouts may need Shift to get / + switch (event.key) { + case "/": + if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS) break; + Documentation.focusSearchBar(); + event.preventDefault(); + } + }); + }, +}; + +// quick alias for translations +const _ = Documentation.gettext; + +_ready(Documentation.init); diff --git a/docs/_build/html/_static/documentation_options.js b/docs/_build/html/_static/documentation_options.js new file mode 100644 index 0000000..7e4c114 --- /dev/null +++ b/docs/_build/html/_static/documentation_options.js @@ -0,0 +1,13 @@ +const DOCUMENTATION_OPTIONS = { + VERSION: '', + LANGUAGE: 'en', + COLLAPSE_INDEX: false, + BUILDER: 'html', + FILE_SUFFIX: '.html', + LINK_SUFFIX: '.html', + HAS_SOURCE: true, + SOURCELINK_SUFFIX: '.txt', + NAVIGATION_WITH_KEYS: false, + SHOW_SEARCH_SUMMARY: true, + ENABLE_SEARCH_SHORTCUTS: true, +}; \ No newline at end of file diff --git a/docs/_build/html/_static/file.png b/docs/_build/html/_static/file.png new file mode 100644 index 0000000000000000000000000000000000000000..a858a410e4faa62ce324d814e4b816fff83a6fb3 GIT binary patch literal 286 zcmV+(0pb3MP)s`hMrGg#P~ix$^RISR_I47Y|r1 z_CyJOe}D1){SET-^Amu_i71Lt6eYfZjRyw@I6OQAIXXHDfiX^GbOlHe=Ae4>0m)d(f|Me07*qoM6N<$f}vM^LjV8( literal 0 HcmV?d00001 diff --git a/docs/_build/html/_static/language_data.js b/docs/_build/html/_static/language_data.js new file mode 100644 index 0000000..250f566 --- /dev/null +++ b/docs/_build/html/_static/language_data.js @@ -0,0 +1,199 @@ +/* + * language_data.js + * ~~~~~~~~~~~~~~~~ + * + * This script contains the language-specific data used by searchtools.js, + * namely the list of stopwords, stemmer, scorer and splitter. + * + * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +var stopwords = ["a", "and", "are", "as", "at", "be", "but", "by", "for", "if", "in", "into", "is", "it", "near", "no", "not", "of", "on", "or", "such", "that", "the", "their", "then", "there", "these", "they", "this", "to", "was", "will", "with"]; + + +/* Non-minified version is copied as a separate JS file, is available */ + +/** + * Porter Stemmer + */ +var Stemmer = function() { + + var step2list = { + ational: 'ate', + tional: 'tion', + enci: 'ence', + anci: 'ance', + izer: 'ize', + bli: 'ble', + alli: 'al', + entli: 'ent', + eli: 'e', + ousli: 'ous', + ization: 'ize', + ation: 'ate', + ator: 'ate', + alism: 'al', + iveness: 'ive', + fulness: 'ful', + ousness: 'ous', + aliti: 'al', + iviti: 'ive', + biliti: 'ble', + logi: 'log' + }; + + var step3list = { + icate: 'ic', + ative: '', + alize: 'al', + iciti: 'ic', + ical: 'ic', + ful: '', + ness: '' + }; + + var c = "[^aeiou]"; // consonant + var v = "[aeiouy]"; // vowel + var C = c + "[^aeiouy]*"; // consonant sequence + var V = v + "[aeiou]*"; // vowel sequence + + var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is m>0 + var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1 + var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1 + var s_v = "^(" + C + ")?" + v; // vowel in stem + + this.stemWord = function (w) { + var stem; + var suffix; + var firstch; + var origword = w; + + if (w.length < 3) + return w; + + var re; + var re2; + var re3; + var re4; + + firstch = w.substr(0,1); + if (firstch == "y") + w = firstch.toUpperCase() + w.substr(1); + + // Step 1a + re = /^(.+?)(ss|i)es$/; + re2 = /^(.+?)([^s])s$/; + + if (re.test(w)) + w = w.replace(re,"$1$2"); + else if (re2.test(w)) + w = w.replace(re2,"$1$2"); + + // Step 1b + re = /^(.+?)eed$/; + re2 = /^(.+?)(ed|ing)$/; + if (re.test(w)) { + var fp = re.exec(w); + re = new RegExp(mgr0); + if (re.test(fp[1])) { + re = /.$/; + w = w.replace(re,""); + } + } + else if (re2.test(w)) { + var fp = re2.exec(w); + stem = fp[1]; + re2 = new RegExp(s_v); + if (re2.test(stem)) { + w = stem; + re2 = /(at|bl|iz)$/; + re3 = new RegExp("([^aeiouylsz])\\1$"); + re4 = new RegExp("^" + C + v + "[^aeiouwxy]$"); + if (re2.test(w)) + w = w + "e"; + else if (re3.test(w)) { + re = /.$/; + w = w.replace(re,""); + } + else if (re4.test(w)) + w = w + "e"; + } + } + + // Step 1c + re = /^(.+?)y$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(s_v); + if (re.test(stem)) + w = stem + "i"; + } + + // Step 2 + re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + suffix = fp[2]; + re = new RegExp(mgr0); + if (re.test(stem)) + w = stem + step2list[suffix]; + } + + // Step 3 + re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + suffix = fp[2]; + re = new RegExp(mgr0); + if (re.test(stem)) + w = stem + step3list[suffix]; + } + + // Step 4 + re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/; + re2 = /^(.+?)(s|t)(ion)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(mgr1); + if (re.test(stem)) + w = stem; + } + else if (re2.test(w)) { + var fp = re2.exec(w); + stem = fp[1] + fp[2]; + re2 = new RegExp(mgr1); + if (re2.test(stem)) + w = stem; + } + + // Step 5 + re = /^(.+?)e$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(mgr1); + re2 = new RegExp(meq1); + re3 = new RegExp("^" + C + v + "[^aeiouwxy]$"); + if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) + w = stem; + } + re = /ll$/; + re2 = new RegExp(mgr1); + if (re.test(w) && re2.test(w)) { + re = /.$/; + w = w.replace(re,""); + } + + // and turn initial Y back to y + if (firstch == "y") + w = firstch.toLowerCase() + w.substr(1); + return w; + } +} + diff --git a/docs/_build/html/_static/minus.png b/docs/_build/html/_static/minus.png new file mode 100644 index 0000000000000000000000000000000000000000..d96755fdaf8bb2214971e0db9c1fd3077d7c419d GIT binary patch literal 90 zcmeAS@N?(olHy`uVBq!ia0vp^+#t*WBp7;*Yy1LIik>cxAr*|t7R?Mi>2?kWtu=nj kDsEF_5m^0CR;1wuP-*O&G^0G}KYk!hp00i_>zopr08q^qX#fBK literal 0 HcmV?d00001 diff --git a/docs/_build/html/_static/plus.png b/docs/_build/html/_static/plus.png new file mode 100644 index 0000000000000000000000000000000000000000..7107cec93a979b9a5f64843235a16651d563ce2d GIT binary patch literal 90 zcmeAS@N?(olHy`uVBq!ia0vp^+#t*WBp7;*Yy1LIik>cxAr*|t7R?Mi>2?kWtu>-2 m3q%Vub%g%s<8sJhVPMczOq}xhg9DJoz~JfX=d#Wzp$Pyb1r*Kz literal 0 HcmV?d00001 diff --git a/docs/_build/html/_static/pygments.css b/docs/_build/html/_static/pygments.css new file mode 100644 index 0000000..c2e07c7 --- /dev/null +++ b/docs/_build/html/_static/pygments.css @@ -0,0 +1,258 @@ +.highlight pre { line-height: 125%; } +.highlight td.linenos .normal { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; } +.highlight span.linenos { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; } +.highlight td.linenos .special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } +.highlight span.linenos.special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } +.highlight .hll { background-color: #ffffcc } +.highlight { background: #f8f8f8; } +.highlight .c { color: #8f5902; font-style: italic } /* Comment */ +.highlight .err { color: #a40000; border: 1px solid #ef2929 } /* Error */ +.highlight .g { color: #000000 } /* Generic */ +.highlight .k { color: #204a87; font-weight: bold } /* Keyword */ +.highlight .l { color: #000000 } /* Literal */ +.highlight .n { color: #000000 } /* Name */ +.highlight .o { color: #ce5c00; font-weight: bold } /* Operator */ +.highlight .x { color: #000000 } /* Other */ +.highlight .p { color: #000000; font-weight: bold } /* Punctuation */ +.highlight .ch { color: #8f5902; font-style: italic } /* Comment.Hashbang */ +.highlight .cm { color: #8f5902; font-style: italic } /* Comment.Multiline */ +.highlight .cp { color: #8f5902; font-style: italic } /* Comment.Preproc */ +.highlight .cpf { color: #8f5902; font-style: italic } /* Comment.PreprocFile */ +.highlight .c1 { color: #8f5902; font-style: italic } /* Comment.Single */ +.highlight .cs { color: #8f5902; font-style: italic } /* Comment.Special */ +.highlight .gd { color: #a40000 } /* Generic.Deleted */ +.highlight .ge { color: #000000; font-style: italic } /* Generic.Emph */ +.highlight .ges { color: #000000; font-weight: bold; font-style: italic } /* Generic.EmphStrong */ +.highlight .gr { color: #ef2929 } /* Generic.Error */ +.highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */ +.highlight .gi { color: #00A000 } /* Generic.Inserted */ +.highlight .go { color: #000000; font-style: italic } /* Generic.Output */ +.highlight .gp { color: #8f5902 } /* Generic.Prompt */ +.highlight .gs { color: #000000; font-weight: bold } /* Generic.Strong */ +.highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */ +.highlight .gt { color: #a40000; font-weight: bold } /* Generic.Traceback */ +.highlight .kc { color: #204a87; font-weight: bold } /* Keyword.Constant */ +.highlight .kd { color: #204a87; font-weight: bold } /* Keyword.Declaration */ +.highlight .kn { color: #204a87; font-weight: bold } /* Keyword.Namespace */ +.highlight .kp { color: #204a87; font-weight: bold } /* Keyword.Pseudo */ +.highlight .kr { color: #204a87; font-weight: bold } /* Keyword.Reserved */ +.highlight .kt { color: #204a87; font-weight: bold } /* Keyword.Type */ +.highlight .ld { color: #000000 } /* Literal.Date */ +.highlight .m { color: #0000cf; font-weight: bold } /* Literal.Number */ +.highlight .s { color: #4e9a06 } /* Literal.String */ +.highlight .na { color: #c4a000 } /* Name.Attribute */ +.highlight .nb { color: #204a87 } /* Name.Builtin */ +.highlight .nc { color: #000000 } /* Name.Class */ +.highlight .no { color: #000000 } /* Name.Constant */ +.highlight .nd { color: #5c35cc; font-weight: bold } /* Name.Decorator */ +.highlight .ni { color: #ce5c00 } /* Name.Entity */ +.highlight .ne { color: #cc0000; font-weight: bold } /* Name.Exception */ +.highlight .nf { color: #000000 } /* Name.Function */ +.highlight .nl { color: #f57900 } /* Name.Label */ +.highlight .nn { color: #000000 } /* Name.Namespace */ +.highlight .nx { color: #000000 } /* Name.Other */ +.highlight .py { color: #000000 } /* Name.Property */ +.highlight .nt { color: #204a87; font-weight: bold } /* Name.Tag */ +.highlight .nv { color: #000000 } /* Name.Variable */ +.highlight .ow { color: #204a87; font-weight: bold } /* Operator.Word */ +.highlight .pm { color: #000000; font-weight: bold } /* Punctuation.Marker */ +.highlight .w { color: #f8f8f8 } /* Text.Whitespace */ +.highlight .mb { color: #0000cf; font-weight: bold } /* Literal.Number.Bin */ +.highlight .mf { color: #0000cf; font-weight: bold } /* Literal.Number.Float */ +.highlight .mh { color: #0000cf; font-weight: bold } /* Literal.Number.Hex */ +.highlight .mi { color: #0000cf; font-weight: bold } /* Literal.Number.Integer */ +.highlight .mo { color: #0000cf; font-weight: bold } /* Literal.Number.Oct */ +.highlight .sa { color: #4e9a06 } /* Literal.String.Affix */ +.highlight .sb { color: #4e9a06 } /* Literal.String.Backtick */ +.highlight .sc { color: #4e9a06 } /* Literal.String.Char */ +.highlight .dl { color: #4e9a06 } /* Literal.String.Delimiter */ +.highlight .sd { color: #8f5902; font-style: italic } /* Literal.String.Doc */ +.highlight .s2 { color: #4e9a06 } /* Literal.String.Double */ +.highlight .se { color: #4e9a06 } /* Literal.String.Escape */ +.highlight .sh { color: #4e9a06 } /* Literal.String.Heredoc */ +.highlight .si { color: #4e9a06 } /* Literal.String.Interpol */ +.highlight .sx { color: #4e9a06 } /* Literal.String.Other */ +.highlight .sr { color: #4e9a06 } /* Literal.String.Regex */ +.highlight .s1 { color: #4e9a06 } /* Literal.String.Single */ +.highlight .ss { color: #4e9a06 } /* Literal.String.Symbol */ +.highlight .bp { color: #3465a4 } /* Name.Builtin.Pseudo */ +.highlight .fm { color: #000000 } /* Name.Function.Magic */ +.highlight .vc { color: #000000 } /* Name.Variable.Class */ +.highlight .vg { color: #000000 } /* Name.Variable.Global */ +.highlight .vi { color: #000000 } /* Name.Variable.Instance */ +.highlight .vm { color: #000000 } /* Name.Variable.Magic */ +.highlight .il { color: #0000cf; font-weight: bold } /* Literal.Number.Integer.Long */ +@media not print { +body[data-theme="dark"] .highlight pre { line-height: 125%; } +body[data-theme="dark"] .highlight td.linenos .normal { color: #aaaaaa; background-color: transparent; padding-left: 5px; padding-right: 5px; } +body[data-theme="dark"] .highlight span.linenos { color: #aaaaaa; background-color: transparent; padding-left: 5px; padding-right: 5px; } +body[data-theme="dark"] .highlight td.linenos .special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } +body[data-theme="dark"] .highlight span.linenos.special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } +body[data-theme="dark"] .highlight .hll { background-color: #404040 } +body[data-theme="dark"] .highlight { background: #202020; color: #d0d0d0 } +body[data-theme="dark"] .highlight .c { color: #ababab; font-style: italic } /* Comment */ +body[data-theme="dark"] .highlight .err { color: #a61717; background-color: #e3d2d2 } /* Error */ +body[data-theme="dark"] .highlight .esc { color: #d0d0d0 } /* Escape */ +body[data-theme="dark"] .highlight .g { color: #d0d0d0 } /* Generic */ +body[data-theme="dark"] .highlight .k { color: #6ebf26; font-weight: bold } /* Keyword */ +body[data-theme="dark"] .highlight .l { color: #d0d0d0 } /* Literal */ +body[data-theme="dark"] .highlight .n { color: #d0d0d0 } /* Name */ +body[data-theme="dark"] .highlight .o { color: #d0d0d0 } /* Operator */ +body[data-theme="dark"] .highlight .x { color: #d0d0d0 } /* Other */ +body[data-theme="dark"] .highlight .p { color: #d0d0d0 } /* Punctuation */ +body[data-theme="dark"] .highlight .ch { color: #ababab; font-style: italic } /* Comment.Hashbang */ +body[data-theme="dark"] .highlight .cm { color: #ababab; font-style: italic } /* Comment.Multiline */ +body[data-theme="dark"] .highlight .cp { color: #ff3a3a; font-weight: bold } /* Comment.Preproc */ +body[data-theme="dark"] .highlight .cpf { color: #ababab; font-style: italic } /* Comment.PreprocFile */ +body[data-theme="dark"] .highlight .c1 { color: #ababab; font-style: italic } /* Comment.Single */ +body[data-theme="dark"] .highlight .cs { color: #e50808; font-weight: bold; background-color: #520000 } /* Comment.Special */ +body[data-theme="dark"] .highlight .gd { color: #d22323 } /* Generic.Deleted */ +body[data-theme="dark"] .highlight .ge { color: #d0d0d0; font-style: italic } /* Generic.Emph */ +body[data-theme="dark"] .highlight .ges { color: #d0d0d0; font-weight: bold; font-style: italic } /* Generic.EmphStrong */ +body[data-theme="dark"] .highlight .gr { color: #d22323 } /* Generic.Error */ +body[data-theme="dark"] .highlight .gh { color: #ffffff; font-weight: bold } /* Generic.Heading */ +body[data-theme="dark"] .highlight .gi { color: #589819 } /* Generic.Inserted */ +body[data-theme="dark"] .highlight .go { color: #cccccc } /* Generic.Output */ +body[data-theme="dark"] .highlight .gp { color: #aaaaaa } /* Generic.Prompt */ +body[data-theme="dark"] .highlight .gs { color: #d0d0d0; font-weight: bold } /* Generic.Strong */ +body[data-theme="dark"] .highlight .gu { color: #ffffff; text-decoration: underline } /* Generic.Subheading */ +body[data-theme="dark"] .highlight .gt { color: #d22323 } /* Generic.Traceback */ +body[data-theme="dark"] .highlight .kc { color: #6ebf26; font-weight: bold } /* Keyword.Constant */ +body[data-theme="dark"] .highlight .kd { color: #6ebf26; font-weight: bold } /* Keyword.Declaration */ +body[data-theme="dark"] .highlight .kn { color: #6ebf26; font-weight: bold } /* Keyword.Namespace */ +body[data-theme="dark"] .highlight .kp { color: #6ebf26 } /* Keyword.Pseudo */ +body[data-theme="dark"] .highlight .kr { color: #6ebf26; font-weight: bold } /* Keyword.Reserved */ +body[data-theme="dark"] .highlight .kt { color: #6ebf26; font-weight: bold } /* Keyword.Type */ +body[data-theme="dark"] .highlight .ld { color: #d0d0d0 } /* Literal.Date */ +body[data-theme="dark"] .highlight .m { color: #51b2fd } /* Literal.Number */ +body[data-theme="dark"] .highlight .s { color: #ed9d13 } /* Literal.String */ +body[data-theme="dark"] .highlight .na { color: #bbbbbb } /* Name.Attribute */ +body[data-theme="dark"] .highlight .nb { color: #2fbccd } /* Name.Builtin */ +body[data-theme="dark"] .highlight .nc { color: #71adff; text-decoration: underline } /* Name.Class */ +body[data-theme="dark"] .highlight .no { color: #40ffff } /* Name.Constant */ +body[data-theme="dark"] .highlight .nd { color: #ffa500 } /* Name.Decorator */ +body[data-theme="dark"] .highlight .ni { color: #d0d0d0 } /* Name.Entity */ +body[data-theme="dark"] .highlight .ne { color: #bbbbbb } /* Name.Exception */ +body[data-theme="dark"] .highlight .nf { color: #71adff } /* Name.Function */ +body[data-theme="dark"] .highlight .nl { color: #d0d0d0 } /* Name.Label */ +body[data-theme="dark"] .highlight .nn { color: #71adff; text-decoration: underline } /* Name.Namespace */ +body[data-theme="dark"] .highlight .nx { color: #d0d0d0 } /* Name.Other */ +body[data-theme="dark"] .highlight .py { color: #d0d0d0 } /* Name.Property */ +body[data-theme="dark"] .highlight .nt { color: #6ebf26; font-weight: bold } /* Name.Tag */ +body[data-theme="dark"] .highlight .nv { color: #40ffff } /* Name.Variable */ +body[data-theme="dark"] .highlight .ow { color: #6ebf26; font-weight: bold } /* Operator.Word */ +body[data-theme="dark"] .highlight .pm { color: #d0d0d0 } /* Punctuation.Marker */ +body[data-theme="dark"] .highlight .w { color: #666666 } /* Text.Whitespace */ +body[data-theme="dark"] .highlight .mb { color: #51b2fd } /* Literal.Number.Bin */ +body[data-theme="dark"] .highlight .mf { color: #51b2fd } /* Literal.Number.Float */ +body[data-theme="dark"] .highlight .mh { color: #51b2fd } /* Literal.Number.Hex */ +body[data-theme="dark"] .highlight .mi { color: #51b2fd } /* Literal.Number.Integer */ +body[data-theme="dark"] .highlight .mo { color: #51b2fd } /* Literal.Number.Oct */ +body[data-theme="dark"] .highlight .sa { color: #ed9d13 } /* Literal.String.Affix */ +body[data-theme="dark"] .highlight .sb { color: #ed9d13 } /* Literal.String.Backtick */ +body[data-theme="dark"] .highlight .sc { color: #ed9d13 } /* Literal.String.Char */ +body[data-theme="dark"] .highlight .dl { color: #ed9d13 } /* Literal.String.Delimiter */ +body[data-theme="dark"] .highlight .sd { color: #ed9d13 } /* Literal.String.Doc */ +body[data-theme="dark"] .highlight .s2 { color: #ed9d13 } /* Literal.String.Double */ +body[data-theme="dark"] .highlight .se { color: #ed9d13 } /* Literal.String.Escape */ +body[data-theme="dark"] .highlight .sh { color: #ed9d13 } /* Literal.String.Heredoc */ +body[data-theme="dark"] .highlight .si { color: #ed9d13 } /* Literal.String.Interpol */ +body[data-theme="dark"] .highlight .sx { color: #ffa500 } /* Literal.String.Other */ +body[data-theme="dark"] .highlight .sr { color: #ed9d13 } /* Literal.String.Regex */ +body[data-theme="dark"] .highlight .s1 { color: #ed9d13 } /* Literal.String.Single */ +body[data-theme="dark"] .highlight .ss { color: #ed9d13 } /* Literal.String.Symbol */ +body[data-theme="dark"] .highlight .bp { color: #2fbccd } /* Name.Builtin.Pseudo */ +body[data-theme="dark"] .highlight .fm { color: #71adff } /* Name.Function.Magic */ +body[data-theme="dark"] .highlight .vc { color: #40ffff } /* Name.Variable.Class */ +body[data-theme="dark"] .highlight .vg { color: #40ffff } /* Name.Variable.Global */ +body[data-theme="dark"] .highlight .vi { color: #40ffff } /* Name.Variable.Instance */ +body[data-theme="dark"] .highlight .vm { color: #40ffff } /* Name.Variable.Magic */ +body[data-theme="dark"] .highlight .il { color: #51b2fd } /* Literal.Number.Integer.Long */ +@media (prefers-color-scheme: dark) { +body:not([data-theme="light"]) .highlight pre { line-height: 125%; } +body:not([data-theme="light"]) .highlight td.linenos .normal { color: #aaaaaa; background-color: transparent; padding-left: 5px; padding-right: 5px; } +body:not([data-theme="light"]) .highlight span.linenos { color: #aaaaaa; background-color: transparent; padding-left: 5px; padding-right: 5px; } +body:not([data-theme="light"]) .highlight td.linenos .special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } +body:not([data-theme="light"]) .highlight span.linenos.special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } +body:not([data-theme="light"]) .highlight .hll { background-color: #404040 } +body:not([data-theme="light"]) .highlight { background: #202020; color: #d0d0d0 } +body:not([data-theme="light"]) .highlight .c { color: #ababab; font-style: italic } /* Comment */ +body:not([data-theme="light"]) .highlight .err { color: #a61717; background-color: #e3d2d2 } /* Error */ +body:not([data-theme="light"]) .highlight .esc { color: #d0d0d0 } /* Escape */ +body:not([data-theme="light"]) .highlight .g { color: #d0d0d0 } /* Generic */ +body:not([data-theme="light"]) .highlight .k { color: #6ebf26; font-weight: bold } /* Keyword */ +body:not([data-theme="light"]) .highlight .l { color: #d0d0d0 } /* Literal */ +body:not([data-theme="light"]) .highlight .n { color: #d0d0d0 } /* Name */ +body:not([data-theme="light"]) .highlight .o { color: #d0d0d0 } /* Operator */ +body:not([data-theme="light"]) .highlight .x { color: #d0d0d0 } /* Other */ +body:not([data-theme="light"]) .highlight .p { color: #d0d0d0 } /* Punctuation */ +body:not([data-theme="light"]) .highlight .ch { color: #ababab; font-style: italic } /* Comment.Hashbang */ +body:not([data-theme="light"]) .highlight .cm { color: #ababab; font-style: italic } /* Comment.Multiline */ +body:not([data-theme="light"]) .highlight .cp { color: #ff3a3a; font-weight: bold } /* Comment.Preproc */ +body:not([data-theme="light"]) .highlight .cpf { color: #ababab; font-style: italic } /* Comment.PreprocFile */ +body:not([data-theme="light"]) .highlight .c1 { color: #ababab; font-style: italic } /* Comment.Single */ +body:not([data-theme="light"]) .highlight .cs { color: #e50808; font-weight: bold; background-color: #520000 } /* Comment.Special */ +body:not([data-theme="light"]) .highlight .gd { color: #d22323 } /* Generic.Deleted */ +body:not([data-theme="light"]) .highlight .ge { color: #d0d0d0; font-style: italic } /* Generic.Emph */ +body:not([data-theme="light"]) .highlight .ges { color: #d0d0d0; font-weight: bold; font-style: italic } /* Generic.EmphStrong */ +body:not([data-theme="light"]) .highlight .gr { color: #d22323 } /* Generic.Error */ +body:not([data-theme="light"]) .highlight .gh { color: #ffffff; font-weight: bold } /* Generic.Heading */ +body:not([data-theme="light"]) .highlight .gi { color: #589819 } /* Generic.Inserted */ +body:not([data-theme="light"]) .highlight .go { color: #cccccc } /* Generic.Output */ +body:not([data-theme="light"]) .highlight .gp { color: #aaaaaa } /* Generic.Prompt */ +body:not([data-theme="light"]) .highlight .gs { color: #d0d0d0; font-weight: bold } /* Generic.Strong */ +body:not([data-theme="light"]) .highlight .gu { color: #ffffff; text-decoration: underline } /* Generic.Subheading */ +body:not([data-theme="light"]) .highlight .gt { color: #d22323 } /* Generic.Traceback */ +body:not([data-theme="light"]) .highlight .kc { color: #6ebf26; font-weight: bold } /* Keyword.Constant */ +body:not([data-theme="light"]) .highlight .kd { color: #6ebf26; font-weight: bold } /* Keyword.Declaration */ +body:not([data-theme="light"]) .highlight .kn { color: #6ebf26; font-weight: bold } /* Keyword.Namespace */ +body:not([data-theme="light"]) .highlight .kp { color: #6ebf26 } /* Keyword.Pseudo */ +body:not([data-theme="light"]) .highlight .kr { color: #6ebf26; font-weight: bold } /* Keyword.Reserved */ +body:not([data-theme="light"]) .highlight .kt { color: #6ebf26; font-weight: bold } /* Keyword.Type */ +body:not([data-theme="light"]) .highlight .ld { color: #d0d0d0 } /* Literal.Date */ +body:not([data-theme="light"]) .highlight .m { color: #51b2fd } /* Literal.Number */ +body:not([data-theme="light"]) .highlight .s { color: #ed9d13 } /* Literal.String */ +body:not([data-theme="light"]) .highlight .na { color: #bbbbbb } /* Name.Attribute */ +body:not([data-theme="light"]) .highlight .nb { color: #2fbccd } /* Name.Builtin */ +body:not([data-theme="light"]) .highlight .nc { color: #71adff; text-decoration: underline } /* Name.Class */ +body:not([data-theme="light"]) .highlight .no { color: #40ffff } /* Name.Constant */ +body:not([data-theme="light"]) .highlight .nd { color: #ffa500 } /* Name.Decorator */ +body:not([data-theme="light"]) .highlight .ni { color: #d0d0d0 } /* Name.Entity */ +body:not([data-theme="light"]) .highlight .ne { color: #bbbbbb } /* Name.Exception */ +body:not([data-theme="light"]) .highlight .nf { color: #71adff } /* Name.Function */ +body:not([data-theme="light"]) .highlight .nl { color: #d0d0d0 } /* Name.Label */ +body:not([data-theme="light"]) .highlight .nn { color: #71adff; text-decoration: underline } /* Name.Namespace */ +body:not([data-theme="light"]) .highlight .nx { color: #d0d0d0 } /* Name.Other */ +body:not([data-theme="light"]) .highlight .py { color: #d0d0d0 } /* Name.Property */ +body:not([data-theme="light"]) .highlight .nt { color: #6ebf26; font-weight: bold } /* Name.Tag */ +body:not([data-theme="light"]) .highlight .nv { color: #40ffff } /* Name.Variable */ +body:not([data-theme="light"]) .highlight .ow { color: #6ebf26; font-weight: bold } /* Operator.Word */ +body:not([data-theme="light"]) .highlight .pm { color: #d0d0d0 } /* Punctuation.Marker */ +body:not([data-theme="light"]) .highlight .w { color: #666666 } /* Text.Whitespace */ +body:not([data-theme="light"]) .highlight .mb { color: #51b2fd } /* Literal.Number.Bin */ +body:not([data-theme="light"]) .highlight .mf { color: #51b2fd } /* Literal.Number.Float */ +body:not([data-theme="light"]) .highlight .mh { color: #51b2fd } /* Literal.Number.Hex */ +body:not([data-theme="light"]) .highlight .mi { color: #51b2fd } /* Literal.Number.Integer */ +body:not([data-theme="light"]) .highlight .mo { color: #51b2fd } /* Literal.Number.Oct */ +body:not([data-theme="light"]) .highlight .sa { color: #ed9d13 } /* Literal.String.Affix */ +body:not([data-theme="light"]) .highlight .sb { color: #ed9d13 } /* Literal.String.Backtick */ +body:not([data-theme="light"]) .highlight .sc { color: #ed9d13 } /* Literal.String.Char */ +body:not([data-theme="light"]) .highlight .dl { color: #ed9d13 } /* Literal.String.Delimiter */ +body:not([data-theme="light"]) .highlight .sd { color: #ed9d13 } /* Literal.String.Doc */ +body:not([data-theme="light"]) .highlight .s2 { color: #ed9d13 } /* Literal.String.Double */ +body:not([data-theme="light"]) .highlight .se { color: #ed9d13 } /* Literal.String.Escape */ +body:not([data-theme="light"]) .highlight .sh { color: #ed9d13 } /* Literal.String.Heredoc */ +body:not([data-theme="light"]) .highlight .si { color: #ed9d13 } /* Literal.String.Interpol */ +body:not([data-theme="light"]) .highlight .sx { color: #ffa500 } /* Literal.String.Other */ +body:not([data-theme="light"]) .highlight .sr { color: #ed9d13 } /* Literal.String.Regex */ +body:not([data-theme="light"]) .highlight .s1 { color: #ed9d13 } /* Literal.String.Single */ +body:not([data-theme="light"]) .highlight .ss { color: #ed9d13 } /* Literal.String.Symbol */ +body:not([data-theme="light"]) .highlight .bp { color: #2fbccd } /* Name.Builtin.Pseudo */ +body:not([data-theme="light"]) .highlight .fm { color: #71adff } /* Name.Function.Magic */ +body:not([data-theme="light"]) .highlight .vc { color: #40ffff } /* Name.Variable.Class */ +body:not([data-theme="light"]) .highlight .vg { color: #40ffff } /* Name.Variable.Global */ +body:not([data-theme="light"]) .highlight .vi { color: #40ffff } /* Name.Variable.Instance */ +body:not([data-theme="light"]) .highlight .vm { color: #40ffff } /* Name.Variable.Magic */ +body:not([data-theme="light"]) .highlight .il { color: #51b2fd } /* Literal.Number.Integer.Long */ +} +} \ No newline at end of file diff --git a/docs/_build/html/_static/scripts/furo-extensions.js b/docs/_build/html/_static/scripts/furo-extensions.js new file mode 100644 index 0000000..e69de29 diff --git a/docs/_build/html/_static/scripts/furo.js b/docs/_build/html/_static/scripts/furo.js new file mode 100644 index 0000000..32e7c05 --- /dev/null +++ b/docs/_build/html/_static/scripts/furo.js @@ -0,0 +1,3 @@ +/*! For license information please see furo.js.LICENSE.txt */ +(()=>{var t={212:function(t,e,n){var o,r;r=void 0!==n.g?n.g:"undefined"!=typeof window?window:this,o=function(){return function(t){"use strict";var e={navClass:"active",contentClass:"active",nested:!1,nestedClass:"active",offset:0,reflow:!1,events:!0},n=function(t,e,n){if(n.settings.events){var o=new CustomEvent(t,{bubbles:!0,cancelable:!0,detail:n});e.dispatchEvent(o)}},o=function(t){var e=0;if(t.offsetParent)for(;t;)e+=t.offsetTop,t=t.offsetParent;return e>=0?e:0},r=function(t){t&&t.sort((function(t,e){return o(t.content)=Math.max(document.body.scrollHeight,document.documentElement.scrollHeight,document.body.offsetHeight,document.documentElement.offsetHeight,document.body.clientHeight,document.documentElement.clientHeight)},l=function(t,e){var n=t[t.length-1];if(function(t,e){return!(!s()||!c(t.content,e,!0))}(n,e))return n;for(var o=t.length-1;o>=0;o--)if(c(t[o].content,e))return t[o]},a=function(t,e){if(e.nested&&t.parentNode){var n=t.parentNode.closest("li");n&&(n.classList.remove(e.nestedClass),a(n,e))}},i=function(t,e){if(t){var o=t.nav.closest("li");o&&(o.classList.remove(e.navClass),t.content.classList.remove(e.contentClass),a(o,e),n("gumshoeDeactivate",o,{link:t.nav,content:t.content,settings:e}))}},u=function(t,e){if(e.nested){var n=t.parentNode.closest("li");n&&(n.classList.add(e.nestedClass),u(n,e))}};return function(o,c){var s,a,d,f,m,v={setup:function(){s=document.querySelectorAll(o),a=[],Array.prototype.forEach.call(s,(function(t){var e=document.getElementById(decodeURIComponent(t.hash.substr(1)));e&&a.push({nav:t,content:e})})),r(a)},detect:function(){var t=l(a,m);t?d&&t.content===d.content||(i(d,m),function(t,e){if(t){var o=t.nav.closest("li");o&&(o.classList.add(e.navClass),t.content.classList.add(e.contentClass),u(o,e),n("gumshoeActivate",o,{link:t.nav,content:t.content,settings:e}))}}(t,m),d=t):d&&(i(d,m),d=null)}},h=function(e){f&&t.cancelAnimationFrame(f),f=t.requestAnimationFrame(v.detect)},g=function(e){f&&t.cancelAnimationFrame(f),f=t.requestAnimationFrame((function(){r(a),v.detect()}))};return v.destroy=function(){d&&i(d,m),t.removeEventListener("scroll",h,!1),m.reflow&&t.removeEventListener("resize",g,!1),a=null,s=null,d=null,f=null,m=null},m=function(){var t={};return Array.prototype.forEach.call(arguments,(function(e){for(var n in e){if(!e.hasOwnProperty(n))return;t[n]=e[n]}})),t}(e,c||{}),v.setup(),v.detect(),t.addEventListener("scroll",h,!1),m.reflow&&t.addEventListener("resize",g,!1),v}}(r)}.apply(e,[]),void 0===o||(t.exports=o)}},e={};function n(o){var r=e[o];if(void 0!==r)return r.exports;var c=e[o]={exports:{}};return t[o].call(c.exports,c,c.exports,n),c.exports}n.n=t=>{var e=t&&t.__esModule?()=>t.default:()=>t;return n.d(e,{a:e}),e},n.d=(t,e)=>{for(var o in e)n.o(e,o)&&!n.o(t,o)&&Object.defineProperty(t,o,{enumerable:!0,get:e[o]})},n.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(t){if("object"==typeof window)return window}}(),n.o=(t,e)=>Object.prototype.hasOwnProperty.call(t,e),(()=>{"use strict";var t=n(212),e=n.n(t),o=null,r=null,c=window.pageYOffset||document.documentElement.scrollTop;const s=64;function l(){const t=localStorage.getItem("theme")||"auto";var e;"light"!==(e=window.matchMedia("(prefers-color-scheme: dark)").matches?"auto"===t?"light":"light"==t?"dark":"auto":"auto"===t?"dark":"dark"==t?"light":"auto")&&"dark"!==e&&"auto"!==e&&(console.error(`Got invalid theme mode: ${e}. Resetting to auto.`),e="auto"),document.body.dataset.theme=e,localStorage.setItem("theme",e),console.log(`Changed to ${e} mode.`)}function a(){!function(){const t=document.getElementsByClassName("theme-toggle");Array.from(t).forEach((t=>{t.addEventListener("click",l)}))}(),function(){let t=0,e=!1;window.addEventListener("scroll",(function(n){t=window.scrollY,e||(window.requestAnimationFrame((function(){var n;n=t,0==Math.floor(r.getBoundingClientRect().top)?r.classList.add("scrolled"):r.classList.remove("scrolled"),function(t){tc&&document.documentElement.classList.remove("show-back-to-top"),c=t}(n),function(t){null!==o&&(0==t?o.scrollTo(0,0):Math.ceil(t)>=Math.floor(document.documentElement.scrollHeight-window.innerHeight)?o.scrollTo(0,o.scrollHeight):document.querySelector(".scroll-current"))}(n),e=!1})),e=!0)})),window.scroll()}(),null!==o&&new(e())(".toc-tree a",{reflow:!0,recursive:!0,navClass:"scroll-current",offset:()=>{let t=parseFloat(getComputedStyle(document.documentElement).fontSize);return r.getBoundingClientRect().height+.5*t+1}})}document.addEventListener("DOMContentLoaded",(function(){document.body.parentNode.classList.remove("no-js"),r=document.querySelector("header"),o=document.querySelector(".toc-scroll"),a()}))})()})(); +//# sourceMappingURL=furo.js.map \ No newline at end of file diff --git a/docs/_build/html/_static/scripts/furo.js.LICENSE.txt b/docs/_build/html/_static/scripts/furo.js.LICENSE.txt new file mode 100644 index 0000000..1632189 --- /dev/null +++ b/docs/_build/html/_static/scripts/furo.js.LICENSE.txt @@ -0,0 +1,7 @@ +/*! + * gumshoejs v5.1.2 (patched by @pradyunsg) + * A simple, framework-agnostic scrollspy script. + * (c) 2019 Chris Ferdinandi + * MIT License + * http://github.com/cferdinandi/gumshoe + */ diff --git a/docs/_build/html/_static/scripts/furo.js.map b/docs/_build/html/_static/scripts/furo.js.map new file mode 100644 index 0000000..4705302 --- /dev/null +++ b/docs/_build/html/_static/scripts/furo.js.map @@ -0,0 +1 @@ +{"version":3,"file":"scripts/furo.js","mappings":"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","sources":["webpack:///./src/furo/assets/scripts/gumshoe-patched.js","webpack:///webpack/bootstrap","webpack:///webpack/runtime/compat get default export","webpack:///webpack/runtime/define property getters","webpack:///webpack/runtime/global","webpack:///webpack/runtime/hasOwnProperty shorthand","webpack:///./src/furo/assets/scripts/furo.js"],"sourcesContent":["/*!\n * gumshoejs v5.1.2 (patched by @pradyunsg)\n * A simple, framework-agnostic scrollspy script.\n * (c) 2019 Chris Ferdinandi\n * MIT License\n * http://github.com/cferdinandi/gumshoe\n */\n\n(function (root, factory) {\n if (typeof define === \"function\" && define.amd) {\n define([], function () {\n return factory(root);\n });\n } else if (typeof exports === \"object\") {\n module.exports = factory(root);\n } else {\n root.Gumshoe = factory(root);\n }\n})(\n typeof global !== \"undefined\"\n ? global\n : typeof window !== \"undefined\"\n ? window\n : this,\n function (window) {\n \"use strict\";\n\n //\n // Defaults\n //\n\n var defaults = {\n // Active classes\n navClass: \"active\",\n contentClass: \"active\",\n\n // Nested navigation\n nested: false,\n nestedClass: \"active\",\n\n // Offset & reflow\n offset: 0,\n reflow: false,\n\n // Event support\n events: true,\n };\n\n //\n // Methods\n //\n\n /**\n * Merge two or more objects together.\n * @param {Object} objects The objects to merge together\n * @returns {Object} Merged values of defaults and options\n */\n var extend = function () {\n var merged = {};\n Array.prototype.forEach.call(arguments, function (obj) {\n for (var key in obj) {\n if (!obj.hasOwnProperty(key)) return;\n merged[key] = obj[key];\n }\n });\n return merged;\n };\n\n /**\n * Emit a custom event\n * @param {String} type The event type\n * @param {Node} elem The element to attach the event to\n * @param {Object} detail Any details to pass along with the event\n */\n var emitEvent = function (type, elem, detail) {\n // Make sure events are enabled\n if (!detail.settings.events) return;\n\n // Create a new event\n var event = new CustomEvent(type, {\n bubbles: true,\n cancelable: true,\n detail: detail,\n });\n\n // Dispatch the event\n elem.dispatchEvent(event);\n };\n\n /**\n * Get an element's distance from the top of the Document.\n * @param {Node} elem The element\n * @return {Number} Distance from the top in pixels\n */\n var getOffsetTop = function (elem) {\n var location = 0;\n if (elem.offsetParent) {\n while (elem) {\n location += elem.offsetTop;\n elem = elem.offsetParent;\n }\n }\n return location >= 0 ? location : 0;\n };\n\n /**\n * Sort content from first to last in the DOM\n * @param {Array} contents The content areas\n */\n var sortContents = function (contents) {\n if (contents) {\n contents.sort(function (item1, item2) {\n var offset1 = getOffsetTop(item1.content);\n var offset2 = getOffsetTop(item2.content);\n if (offset1 < offset2) return -1;\n return 1;\n });\n }\n };\n\n /**\n * Get the offset to use for calculating position\n * @param {Object} settings The settings for this instantiation\n * @return {Float} The number of pixels to offset the calculations\n */\n var getOffset = function (settings) {\n // if the offset is a function run it\n if (typeof settings.offset === \"function\") {\n return parseFloat(settings.offset());\n }\n\n // Otherwise, return it as-is\n return parseFloat(settings.offset);\n };\n\n /**\n * Get the document element's height\n * @private\n * @returns {Number}\n */\n var getDocumentHeight = function () {\n return Math.max(\n document.body.scrollHeight,\n document.documentElement.scrollHeight,\n document.body.offsetHeight,\n document.documentElement.offsetHeight,\n document.body.clientHeight,\n document.documentElement.clientHeight,\n );\n };\n\n /**\n * Determine if an element is in view\n * @param {Node} elem The element\n * @param {Object} settings The settings for this instantiation\n * @param {Boolean} bottom If true, check if element is above bottom of viewport instead\n * @return {Boolean} Returns true if element is in the viewport\n */\n var isInView = function (elem, settings, bottom) {\n var bounds = elem.getBoundingClientRect();\n var offset = getOffset(settings);\n if (bottom) {\n return (\n parseInt(bounds.bottom, 10) <\n (window.innerHeight || document.documentElement.clientHeight)\n );\n }\n return parseInt(bounds.top, 10) <= offset;\n };\n\n /**\n * Check if at the bottom of the viewport\n * @return {Boolean} If true, page is at the bottom of the viewport\n */\n var isAtBottom = function () {\n if (\n Math.ceil(window.innerHeight + window.pageYOffset) >=\n getDocumentHeight()\n )\n return true;\n return false;\n };\n\n /**\n * Check if the last item should be used (even if not at the top of the page)\n * @param {Object} item The last item\n * @param {Object} settings The settings for this instantiation\n * @return {Boolean} If true, use the last item\n */\n var useLastItem = function (item, settings) {\n if (isAtBottom() && isInView(item.content, settings, true)) return true;\n return false;\n };\n\n /**\n * Get the active content\n * @param {Array} contents The content areas\n * @param {Object} settings The settings for this instantiation\n * @return {Object} The content area and matching navigation link\n */\n var getActive = function (contents, settings) {\n var last = contents[contents.length - 1];\n if (useLastItem(last, settings)) return last;\n for (var i = contents.length - 1; i >= 0; i--) {\n if (isInView(contents[i].content, settings)) return contents[i];\n }\n };\n\n /**\n * Deactivate parent navs in a nested navigation\n * @param {Node} nav The starting navigation element\n * @param {Object} settings The settings for this instantiation\n */\n var deactivateNested = function (nav, settings) {\n // If nesting isn't activated, bail\n if (!settings.nested || !nav.parentNode) return;\n\n // Get the parent navigation\n var li = nav.parentNode.closest(\"li\");\n if (!li) return;\n\n // Remove the active class\n li.classList.remove(settings.nestedClass);\n\n // Apply recursively to any parent navigation elements\n deactivateNested(li, settings);\n };\n\n /**\n * Deactivate a nav and content area\n * @param {Object} items The nav item and content to deactivate\n * @param {Object} settings The settings for this instantiation\n */\n var deactivate = function (items, settings) {\n // Make sure there are items to deactivate\n if (!items) return;\n\n // Get the parent list item\n var li = items.nav.closest(\"li\");\n if (!li) return;\n\n // Remove the active class from the nav and content\n li.classList.remove(settings.navClass);\n items.content.classList.remove(settings.contentClass);\n\n // Deactivate any parent navs in a nested navigation\n deactivateNested(li, settings);\n\n // Emit a custom event\n emitEvent(\"gumshoeDeactivate\", li, {\n link: items.nav,\n content: items.content,\n settings: settings,\n });\n };\n\n /**\n * Activate parent navs in a nested navigation\n * @param {Node} nav The starting navigation element\n * @param {Object} settings The settings for this instantiation\n */\n var activateNested = function (nav, settings) {\n // If nesting isn't activated, bail\n if (!settings.nested) return;\n\n // Get the parent navigation\n var li = nav.parentNode.closest(\"li\");\n if (!li) return;\n\n // Add the active class\n li.classList.add(settings.nestedClass);\n\n // Apply recursively to any parent navigation elements\n activateNested(li, settings);\n };\n\n /**\n * Activate a nav and content area\n * @param {Object} items The nav item and content to activate\n * @param {Object} settings The settings for this instantiation\n */\n var activate = function (items, settings) {\n // Make sure there are items to activate\n if (!items) return;\n\n // Get the parent list item\n var li = items.nav.closest(\"li\");\n if (!li) return;\n\n // Add the active class to the nav and content\n li.classList.add(settings.navClass);\n items.content.classList.add(settings.contentClass);\n\n // Activate any parent navs in a nested navigation\n activateNested(li, settings);\n\n // Emit a custom event\n emitEvent(\"gumshoeActivate\", li, {\n link: items.nav,\n content: items.content,\n settings: settings,\n });\n };\n\n /**\n * Create the Constructor object\n * @param {String} selector The selector to use for navigation items\n * @param {Object} options User options and settings\n */\n var Constructor = function (selector, options) {\n //\n // Variables\n //\n\n var publicAPIs = {};\n var navItems, contents, current, timeout, settings;\n\n //\n // Methods\n //\n\n /**\n * Set variables from DOM elements\n */\n publicAPIs.setup = function () {\n // Get all nav items\n navItems = document.querySelectorAll(selector);\n\n // Create contents array\n contents = [];\n\n // Loop through each item, get it's matching content, and push to the array\n Array.prototype.forEach.call(navItems, function (item) {\n // Get the content for the nav item\n var content = document.getElementById(\n decodeURIComponent(item.hash.substr(1)),\n );\n if (!content) return;\n\n // Push to the contents array\n contents.push({\n nav: item,\n content: content,\n });\n });\n\n // Sort contents by the order they appear in the DOM\n sortContents(contents);\n };\n\n /**\n * Detect which content is currently active\n */\n publicAPIs.detect = function () {\n // Get the active content\n var active = getActive(contents, settings);\n\n // if there's no active content, deactivate and bail\n if (!active) {\n if (current) {\n deactivate(current, settings);\n current = null;\n }\n return;\n }\n\n // If the active content is the one currently active, do nothing\n if (current && active.content === current.content) return;\n\n // Deactivate the current content and activate the new content\n deactivate(current, settings);\n activate(active, settings);\n\n // Update the currently active content\n current = active;\n };\n\n /**\n * Detect the active content on scroll\n * Debounced for performance\n */\n var scrollHandler = function (event) {\n // If there's a timer, cancel it\n if (timeout) {\n window.cancelAnimationFrame(timeout);\n }\n\n // Setup debounce callback\n timeout = window.requestAnimationFrame(publicAPIs.detect);\n };\n\n /**\n * Update content sorting on resize\n * Debounced for performance\n */\n var resizeHandler = function (event) {\n // If there's a timer, cancel it\n if (timeout) {\n window.cancelAnimationFrame(timeout);\n }\n\n // Setup debounce callback\n timeout = window.requestAnimationFrame(function () {\n sortContents(contents);\n publicAPIs.detect();\n });\n };\n\n /**\n * Destroy the current instantiation\n */\n publicAPIs.destroy = function () {\n // Undo DOM changes\n if (current) {\n deactivate(current, settings);\n }\n\n // Remove event listeners\n window.removeEventListener(\"scroll\", scrollHandler, false);\n if (settings.reflow) {\n window.removeEventListener(\"resize\", resizeHandler, false);\n }\n\n // Reset variables\n contents = null;\n navItems = null;\n current = null;\n timeout = null;\n settings = null;\n };\n\n /**\n * Initialize the current instantiation\n */\n var init = function () {\n // Merge user options into defaults\n settings = extend(defaults, options || {});\n\n // Setup variables based on the current DOM\n publicAPIs.setup();\n\n // Find the currently active content\n publicAPIs.detect();\n\n // Setup event listeners\n window.addEventListener(\"scroll\", scrollHandler, false);\n if (settings.reflow) {\n window.addEventListener(\"resize\", resizeHandler, false);\n }\n };\n\n //\n // Initialize and return the public APIs\n //\n\n init();\n return publicAPIs;\n };\n\n //\n // Return the Constructor\n //\n\n return Constructor;\n },\n);\n","// The module cache\nvar __webpack_module_cache__ = {};\n\n// The require function\nfunction __webpack_require__(moduleId) {\n\t// Check if module is in cache\n\tvar cachedModule = __webpack_module_cache__[moduleId];\n\tif (cachedModule !== undefined) {\n\t\treturn cachedModule.exports;\n\t}\n\t// Create a new module (and put it into the cache)\n\tvar module = __webpack_module_cache__[moduleId] = {\n\t\t// no module.id needed\n\t\t// no module.loaded needed\n\t\texports: {}\n\t};\n\n\t// Execute the module function\n\t__webpack_modules__[moduleId].call(module.exports, module, module.exports, __webpack_require__);\n\n\t// Return the exports of the module\n\treturn module.exports;\n}\n\n","// getDefaultExport function for compatibility with non-harmony modules\n__webpack_require__.n = (module) => {\n\tvar getter = module && module.__esModule ?\n\t\t() => (module['default']) :\n\t\t() => (module);\n\t__webpack_require__.d(getter, { a: getter });\n\treturn getter;\n};","// define getter functions for harmony exports\n__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n\t\tif(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n\t\t\tObject.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n\t\t}\n\t}\n};","__webpack_require__.g = (function() {\n\tif (typeof globalThis === 'object') return globalThis;\n\ttry {\n\t\treturn this || new Function('return this')();\n\t} catch (e) {\n\t\tif (typeof window === 'object') return window;\n\t}\n})();","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","import Gumshoe from \"./gumshoe-patched.js\";\n\n////////////////////////////////////////////////////////////////////////////////\n// Scroll Handling\n////////////////////////////////////////////////////////////////////////////////\nvar tocScroll = null;\nvar header = null;\nvar lastScrollTop = window.pageYOffset || document.documentElement.scrollTop;\nconst GO_TO_TOP_OFFSET = 64;\n\nfunction scrollHandlerForHeader() {\n if (Math.floor(header.getBoundingClientRect().top) == 0) {\n header.classList.add(\"scrolled\");\n } else {\n header.classList.remove(\"scrolled\");\n }\n}\n\nfunction scrollHandlerForBackToTop(positionY) {\n if (positionY < GO_TO_TOP_OFFSET) {\n document.documentElement.classList.remove(\"show-back-to-top\");\n } else {\n if (positionY < lastScrollTop) {\n document.documentElement.classList.add(\"show-back-to-top\");\n } else if (positionY > lastScrollTop) {\n document.documentElement.classList.remove(\"show-back-to-top\");\n }\n }\n lastScrollTop = positionY;\n}\n\nfunction scrollHandlerForTOC(positionY) {\n if (tocScroll === null) {\n return;\n }\n\n // top of page.\n if (positionY == 0) {\n tocScroll.scrollTo(0, 0);\n } else if (\n // bottom of page.\n Math.ceil(positionY) >=\n Math.floor(document.documentElement.scrollHeight - window.innerHeight)\n ) {\n tocScroll.scrollTo(0, tocScroll.scrollHeight);\n } else {\n // somewhere in the middle.\n const current = document.querySelector(\".scroll-current\");\n if (current == null) {\n return;\n }\n\n // https://github.com/pypa/pip/issues/9159 This breaks scroll behaviours.\n // // scroll the currently \"active\" heading in toc, into view.\n // const rect = current.getBoundingClientRect();\n // if (0 > rect.top) {\n // current.scrollIntoView(true); // the argument is \"alignTop\"\n // } else if (rect.bottom > window.innerHeight) {\n // current.scrollIntoView(false);\n // }\n }\n}\n\nfunction scrollHandler(positionY) {\n scrollHandlerForHeader();\n scrollHandlerForBackToTop(positionY);\n scrollHandlerForTOC(positionY);\n}\n\n////////////////////////////////////////////////////////////////////////////////\n// Theme Toggle\n////////////////////////////////////////////////////////////////////////////////\nfunction setTheme(mode) {\n if (mode !== \"light\" && mode !== \"dark\" && mode !== \"auto\") {\n console.error(`Got invalid theme mode: ${mode}. Resetting to auto.`);\n mode = \"auto\";\n }\n\n document.body.dataset.theme = mode;\n localStorage.setItem(\"theme\", mode);\n console.log(`Changed to ${mode} mode.`);\n}\n\nfunction cycleThemeOnce() {\n const currentTheme = localStorage.getItem(\"theme\") || \"auto\";\n const prefersDark = window.matchMedia(\"(prefers-color-scheme: dark)\").matches;\n\n if (prefersDark) {\n // Auto (dark) -> Light -> Dark\n if (currentTheme === \"auto\") {\n setTheme(\"light\");\n } else if (currentTheme == \"light\") {\n setTheme(\"dark\");\n } else {\n setTheme(\"auto\");\n }\n } else {\n // Auto (light) -> Dark -> Light\n if (currentTheme === \"auto\") {\n setTheme(\"dark\");\n } else if (currentTheme == \"dark\") {\n setTheme(\"light\");\n } else {\n setTheme(\"auto\");\n }\n }\n}\n\n////////////////////////////////////////////////////////////////////////////////\n// Setup\n////////////////////////////////////////////////////////////////////////////////\nfunction setupScrollHandler() {\n // Taken from https://developer.mozilla.org/en-US/docs/Web/API/Document/scroll_event\n let last_known_scroll_position = 0;\n let ticking = false;\n\n window.addEventListener(\"scroll\", function (e) {\n last_known_scroll_position = window.scrollY;\n\n if (!ticking) {\n window.requestAnimationFrame(function () {\n scrollHandler(last_known_scroll_position);\n ticking = false;\n });\n\n ticking = true;\n }\n });\n window.scroll();\n}\n\nfunction setupScrollSpy() {\n if (tocScroll === null) {\n return;\n }\n\n // Scrollspy -- highlight table on contents, based on scroll\n new Gumshoe(\".toc-tree a\", {\n reflow: true,\n recursive: true,\n navClass: \"scroll-current\",\n offset: () => {\n let rem = parseFloat(getComputedStyle(document.documentElement).fontSize);\n return header.getBoundingClientRect().height + 0.5 * rem + 1;\n },\n });\n}\n\nfunction setupTheme() {\n // Attach event handlers for toggling themes\n const buttons = document.getElementsByClassName(\"theme-toggle\");\n Array.from(buttons).forEach((btn) => {\n btn.addEventListener(\"click\", cycleThemeOnce);\n });\n}\n\nfunction setup() {\n setupTheme();\n setupScrollHandler();\n setupScrollSpy();\n}\n\n////////////////////////////////////////////////////////////////////////////////\n// Main entrypoint\n////////////////////////////////////////////////////////////////////////////////\nfunction main() {\n document.body.parentNode.classList.remove(\"no-js\");\n\n header = document.querySelector(\"header\");\n tocScroll = document.querySelector(\".toc-scroll\");\n\n setup();\n}\n\ndocument.addEventListener(\"DOMContentLoaded\", main);\n"],"names":["root","g","window","this","defaults","navClass","contentClass","nested","nestedClass","offset","reflow","events","emitEvent","type","elem","detail","settings","event","CustomEvent","bubbles","cancelable","dispatchEvent","getOffsetTop","location","offsetParent","offsetTop","sortContents","contents","sort","item1","item2","content","isInView","bottom","bounds","getBoundingClientRect","parseFloat","getOffset","parseInt","innerHeight","document","documentElement","clientHeight","top","isAtBottom","Math","ceil","pageYOffset","max","body","scrollHeight","offsetHeight","getActive","last","length","item","useLastItem","i","deactivateNested","nav","parentNode","li","closest","classList","remove","deactivate","items","link","activateNested","add","selector","options","navItems","current","timeout","publicAPIs","querySelectorAll","Array","prototype","forEach","call","getElementById","decodeURIComponent","hash","substr","push","active","activate","scrollHandler","cancelAnimationFrame","requestAnimationFrame","detect","resizeHandler","destroy","removeEventListener","merged","arguments","obj","key","hasOwnProperty","extend","setup","addEventListener","factory","__webpack_module_cache__","__webpack_require__","moduleId","cachedModule","undefined","exports","module","__webpack_modules__","n","getter","__esModule","d","a","definition","o","Object","defineProperty","enumerable","get","globalThis","Function","e","prop","tocScroll","header","lastScrollTop","scrollTop","GO_TO_TOP_OFFSET","cycleThemeOnce","currentTheme","localStorage","getItem","mode","matchMedia","matches","console","error","dataset","theme","setItem","log","buttons","getElementsByClassName","from","btn","setupTheme","last_known_scroll_position","ticking","scrollY","positionY","floor","scrollHandlerForBackToTop","scrollTo","querySelector","scrollHandlerForTOC","scroll","setupScrollHandler","recursive","rem","getComputedStyle","fontSize","height"],"sourceRoot":""} \ No newline at end of file diff --git a/docs/_build/html/_static/searchtools.js b/docs/_build/html/_static/searchtools.js new file mode 100644 index 0000000..7918c3f --- /dev/null +++ b/docs/_build/html/_static/searchtools.js @@ -0,0 +1,574 @@ +/* + * searchtools.js + * ~~~~~~~~~~~~~~~~ + * + * Sphinx JavaScript utilities for the full-text search. + * + * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ +"use strict"; + +/** + * Simple result scoring code. + */ +if (typeof Scorer === "undefined") { + var Scorer = { + // Implement the following function to further tweak the score for each result + // The function takes a result array [docname, title, anchor, descr, score, filename] + // and returns the new score. + /* + score: result => { + const [docname, title, anchor, descr, score, filename] = result + return score + }, + */ + + // query matches the full name of an object + objNameMatch: 11, + // or matches in the last dotted part of the object name + objPartialMatch: 6, + // Additive scores depending on the priority of the object + objPrio: { + 0: 15, // used to be importantResults + 1: 5, // used to be objectResults + 2: -5, // used to be unimportantResults + }, + // Used when the priority is not in the mapping. + objPrioDefault: 0, + + // query found in title + title: 15, + partialTitle: 7, + // query found in terms + term: 5, + partialTerm: 2, + }; +} + +const _removeChildren = (element) => { + while (element && element.lastChild) element.removeChild(element.lastChild); +}; + +/** + * See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions#escaping + */ +const _escapeRegExp = (string) => + string.replace(/[.*+\-?^${}()|[\]\\]/g, "\\$&"); // $& means the whole matched string + +const _displayItem = (item, searchTerms, highlightTerms) => { + const docBuilder = DOCUMENTATION_OPTIONS.BUILDER; + const docFileSuffix = DOCUMENTATION_OPTIONS.FILE_SUFFIX; + const docLinkSuffix = DOCUMENTATION_OPTIONS.LINK_SUFFIX; + const showSearchSummary = DOCUMENTATION_OPTIONS.SHOW_SEARCH_SUMMARY; + const contentRoot = document.documentElement.dataset.content_root; + + const [docName, title, anchor, descr, score, _filename] = item; + + let listItem = document.createElement("li"); + let requestUrl; + let linkUrl; + if (docBuilder === "dirhtml") { + // dirhtml builder + let dirname = docName + "/"; + if (dirname.match(/\/index\/$/)) + dirname = dirname.substring(0, dirname.length - 6); + else if (dirname === "index/") dirname = ""; + requestUrl = contentRoot + dirname; + linkUrl = requestUrl; + } else { + // normal html builders + requestUrl = contentRoot + docName + docFileSuffix; + linkUrl = docName + docLinkSuffix; + } + let linkEl = listItem.appendChild(document.createElement("a")); + linkEl.href = linkUrl + anchor; + linkEl.dataset.score = score; + linkEl.innerHTML = title; + if (descr) { + listItem.appendChild(document.createElement("span")).innerHTML = + " (" + descr + ")"; + // highlight search terms in the description + if (SPHINX_HIGHLIGHT_ENABLED) // set in sphinx_highlight.js + highlightTerms.forEach((term) => _highlightText(listItem, term, "highlighted")); + } + else if (showSearchSummary) + fetch(requestUrl) + .then((responseData) => responseData.text()) + .then((data) => { + if (data) + listItem.appendChild( + Search.makeSearchSummary(data, searchTerms) + ); + // highlight search terms in the summary + if (SPHINX_HIGHLIGHT_ENABLED) // set in sphinx_highlight.js + highlightTerms.forEach((term) => _highlightText(listItem, term, "highlighted")); + }); + Search.output.appendChild(listItem); +}; +const _finishSearch = (resultCount) => { + Search.stopPulse(); + Search.title.innerText = _("Search Results"); + if (!resultCount) + Search.status.innerText = Documentation.gettext( + "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories." + ); + else + Search.status.innerText = _( + `Search finished, found ${resultCount} page(s) matching the search query.` + ); +}; +const _displayNextItem = ( + results, + resultCount, + searchTerms, + highlightTerms, +) => { + // results left, load the summary and display it + // this is intended to be dynamic (don't sub resultsCount) + if (results.length) { + _displayItem(results.pop(), searchTerms, highlightTerms); + setTimeout( + () => _displayNextItem(results, resultCount, searchTerms, highlightTerms), + 5 + ); + } + // search finished, update title and status message + else _finishSearch(resultCount); +}; + +/** + * Default splitQuery function. Can be overridden in ``sphinx.search`` with a + * custom function per language. + * + * The regular expression works by splitting the string on consecutive characters + * that are not Unicode letters, numbers, underscores, or emoji characters. + * This is the same as ``\W+`` in Python, preserving the surrogate pair area. + */ +if (typeof splitQuery === "undefined") { + var splitQuery = (query) => query + .split(/[^\p{Letter}\p{Number}_\p{Emoji_Presentation}]+/gu) + .filter(term => term) // remove remaining empty strings +} + +/** + * Search Module + */ +const Search = { + _index: null, + _queued_query: null, + _pulse_status: -1, + + htmlToText: (htmlString) => { + const htmlElement = new DOMParser().parseFromString(htmlString, 'text/html'); + htmlElement.querySelectorAll(".headerlink").forEach((el) => { el.remove() }); + const docContent = htmlElement.querySelector('[role="main"]'); + if (docContent !== undefined) return docContent.textContent; + console.warn( + "Content block not found. Sphinx search tries to obtain it via '[role=main]'. Could you check your theme or template." + ); + return ""; + }, + + init: () => { + const query = new URLSearchParams(window.location.search).get("q"); + document + .querySelectorAll('input[name="q"]') + .forEach((el) => (el.value = query)); + if (query) Search.performSearch(query); + }, + + loadIndex: (url) => + (document.body.appendChild(document.createElement("script")).src = url), + + setIndex: (index) => { + Search._index = index; + if (Search._queued_query !== null) { + const query = Search._queued_query; + Search._queued_query = null; + Search.query(query); + } + }, + + hasIndex: () => Search._index !== null, + + deferQuery: (query) => (Search._queued_query = query), + + stopPulse: () => (Search._pulse_status = -1), + + startPulse: () => { + if (Search._pulse_status >= 0) return; + + const pulse = () => { + Search._pulse_status = (Search._pulse_status + 1) % 4; + Search.dots.innerText = ".".repeat(Search._pulse_status); + if (Search._pulse_status >= 0) window.setTimeout(pulse, 500); + }; + pulse(); + }, + + /** + * perform a search for something (or wait until index is loaded) + */ + performSearch: (query) => { + // create the required interface elements + const searchText = document.createElement("h2"); + searchText.textContent = _("Searching"); + const searchSummary = document.createElement("p"); + searchSummary.classList.add("search-summary"); + searchSummary.innerText = ""; + const searchList = document.createElement("ul"); + searchList.classList.add("search"); + + const out = document.getElementById("search-results"); + Search.title = out.appendChild(searchText); + Search.dots = Search.title.appendChild(document.createElement("span")); + Search.status = out.appendChild(searchSummary); + Search.output = out.appendChild(searchList); + + const searchProgress = document.getElementById("search-progress"); + // Some themes don't use the search progress node + if (searchProgress) { + searchProgress.innerText = _("Preparing search..."); + } + Search.startPulse(); + + // index already loaded, the browser was quick! + if (Search.hasIndex()) Search.query(query); + else Search.deferQuery(query); + }, + + /** + * execute search (requires search index to be loaded) + */ + query: (query) => { + const filenames = Search._index.filenames; + const docNames = Search._index.docnames; + const titles = Search._index.titles; + const allTitles = Search._index.alltitles; + const indexEntries = Search._index.indexentries; + + // stem the search terms and add them to the correct list + const stemmer = new Stemmer(); + const searchTerms = new Set(); + const excludedTerms = new Set(); + const highlightTerms = new Set(); + const objectTerms = new Set(splitQuery(query.toLowerCase().trim())); + splitQuery(query.trim()).forEach((queryTerm) => { + const queryTermLower = queryTerm.toLowerCase(); + + // maybe skip this "word" + // stopwords array is from language_data.js + if ( + stopwords.indexOf(queryTermLower) !== -1 || + queryTerm.match(/^\d+$/) + ) + return; + + // stem the word + let word = stemmer.stemWord(queryTermLower); + // select the correct list + if (word[0] === "-") excludedTerms.add(word.substr(1)); + else { + searchTerms.add(word); + highlightTerms.add(queryTermLower); + } + }); + + if (SPHINX_HIGHLIGHT_ENABLED) { // set in sphinx_highlight.js + localStorage.setItem("sphinx_highlight_terms", [...highlightTerms].join(" ")) + } + + // console.debug("SEARCH: searching for:"); + // console.info("required: ", [...searchTerms]); + // console.info("excluded: ", [...excludedTerms]); + + // array of [docname, title, anchor, descr, score, filename] + let results = []; + _removeChildren(document.getElementById("search-progress")); + + const queryLower = query.toLowerCase(); + for (const [title, foundTitles] of Object.entries(allTitles)) { + if (title.toLowerCase().includes(queryLower) && (queryLower.length >= title.length/2)) { + for (const [file, id] of foundTitles) { + let score = Math.round(100 * queryLower.length / title.length) + results.push([ + docNames[file], + titles[file] !== title ? `${titles[file]} > ${title}` : title, + id !== null ? "#" + id : "", + null, + score, + filenames[file], + ]); + } + } + } + + // search for explicit entries in index directives + for (const [entry, foundEntries] of Object.entries(indexEntries)) { + if (entry.includes(queryLower) && (queryLower.length >= entry.length/2)) { + for (const [file, id] of foundEntries) { + let score = Math.round(100 * queryLower.length / entry.length) + results.push([ + docNames[file], + titles[file], + id ? "#" + id : "", + null, + score, + filenames[file], + ]); + } + } + } + + // lookup as object + objectTerms.forEach((term) => + results.push(...Search.performObjectSearch(term, objectTerms)) + ); + + // lookup as search terms in fulltext + results.push(...Search.performTermsSearch(searchTerms, excludedTerms)); + + // let the scorer override scores with a custom scoring function + if (Scorer.score) results.forEach((item) => (item[4] = Scorer.score(item))); + + // now sort the results by score (in opposite order of appearance, since the + // display function below uses pop() to retrieve items) and then + // alphabetically + results.sort((a, b) => { + const leftScore = a[4]; + const rightScore = b[4]; + if (leftScore === rightScore) { + // same score: sort alphabetically + const leftTitle = a[1].toLowerCase(); + const rightTitle = b[1].toLowerCase(); + if (leftTitle === rightTitle) return 0; + return leftTitle > rightTitle ? -1 : 1; // inverted is intentional + } + return leftScore > rightScore ? 1 : -1; + }); + + // remove duplicate search results + // note the reversing of results, so that in the case of duplicates, the highest-scoring entry is kept + let seen = new Set(); + results = results.reverse().reduce((acc, result) => { + let resultStr = result.slice(0, 4).concat([result[5]]).map(v => String(v)).join(','); + if (!seen.has(resultStr)) { + acc.push(result); + seen.add(resultStr); + } + return acc; + }, []); + + results = results.reverse(); + + // for debugging + //Search.lastresults = results.slice(); // a copy + // console.info("search results:", Search.lastresults); + + // print the results + _displayNextItem(results, results.length, searchTerms, highlightTerms); + }, + + /** + * search for object names + */ + performObjectSearch: (object, objectTerms) => { + const filenames = Search._index.filenames; + const docNames = Search._index.docnames; + const objects = Search._index.objects; + const objNames = Search._index.objnames; + const titles = Search._index.titles; + + const results = []; + + const objectSearchCallback = (prefix, match) => { + const name = match[4] + const fullname = (prefix ? prefix + "." : "") + name; + const fullnameLower = fullname.toLowerCase(); + if (fullnameLower.indexOf(object) < 0) return; + + let score = 0; + const parts = fullnameLower.split("."); + + // check for different match types: exact matches of full name or + // "last name" (i.e. last dotted part) + if (fullnameLower === object || parts.slice(-1)[0] === object) + score += Scorer.objNameMatch; + else if (parts.slice(-1)[0].indexOf(object) > -1) + score += Scorer.objPartialMatch; // matches in last name + + const objName = objNames[match[1]][2]; + const title = titles[match[0]]; + + // If more than one term searched for, we require other words to be + // found in the name/title/description + const otherTerms = new Set(objectTerms); + otherTerms.delete(object); + if (otherTerms.size > 0) { + const haystack = `${prefix} ${name} ${objName} ${title}`.toLowerCase(); + if ( + [...otherTerms].some((otherTerm) => haystack.indexOf(otherTerm) < 0) + ) + return; + } + + let anchor = match[3]; + if (anchor === "") anchor = fullname; + else if (anchor === "-") anchor = objNames[match[1]][1] + "-" + fullname; + + const descr = objName + _(", in ") + title; + + // add custom score for some objects according to scorer + if (Scorer.objPrio.hasOwnProperty(match[2])) + score += Scorer.objPrio[match[2]]; + else score += Scorer.objPrioDefault; + + results.push([ + docNames[match[0]], + fullname, + "#" + anchor, + descr, + score, + filenames[match[0]], + ]); + }; + Object.keys(objects).forEach((prefix) => + objects[prefix].forEach((array) => + objectSearchCallback(prefix, array) + ) + ); + return results; + }, + + /** + * search for full-text terms in the index + */ + performTermsSearch: (searchTerms, excludedTerms) => { + // prepare search + const terms = Search._index.terms; + const titleTerms = Search._index.titleterms; + const filenames = Search._index.filenames; + const docNames = Search._index.docnames; + const titles = Search._index.titles; + + const scoreMap = new Map(); + const fileMap = new Map(); + + // perform the search on the required terms + searchTerms.forEach((word) => { + const files = []; + const arr = [ + { files: terms[word], score: Scorer.term }, + { files: titleTerms[word], score: Scorer.title }, + ]; + // add support for partial matches + if (word.length > 2) { + const escapedWord = _escapeRegExp(word); + Object.keys(terms).forEach((term) => { + if (term.match(escapedWord) && !terms[word]) + arr.push({ files: terms[term], score: Scorer.partialTerm }); + }); + Object.keys(titleTerms).forEach((term) => { + if (term.match(escapedWord) && !titleTerms[word]) + arr.push({ files: titleTerms[word], score: Scorer.partialTitle }); + }); + } + + // no match but word was a required one + if (arr.every((record) => record.files === undefined)) return; + + // found search word in contents + arr.forEach((record) => { + if (record.files === undefined) return; + + let recordFiles = record.files; + if (recordFiles.length === undefined) recordFiles = [recordFiles]; + files.push(...recordFiles); + + // set score for the word in each file + recordFiles.forEach((file) => { + if (!scoreMap.has(file)) scoreMap.set(file, {}); + scoreMap.get(file)[word] = record.score; + }); + }); + + // create the mapping + files.forEach((file) => { + if (fileMap.has(file) && fileMap.get(file).indexOf(word) === -1) + fileMap.get(file).push(word); + else fileMap.set(file, [word]); + }); + }); + + // now check if the files don't contain excluded terms + const results = []; + for (const [file, wordList] of fileMap) { + // check if all requirements are matched + + // as search terms with length < 3 are discarded + const filteredTermCount = [...searchTerms].filter( + (term) => term.length > 2 + ).length; + if ( + wordList.length !== searchTerms.size && + wordList.length !== filteredTermCount + ) + continue; + + // ensure that none of the excluded terms is in the search result + if ( + [...excludedTerms].some( + (term) => + terms[term] === file || + titleTerms[term] === file || + (terms[term] || []).includes(file) || + (titleTerms[term] || []).includes(file) + ) + ) + break; + + // select one (max) score for the file. + const score = Math.max(...wordList.map((w) => scoreMap.get(file)[w])); + // add result to the result list + results.push([ + docNames[file], + titles[file], + "", + null, + score, + filenames[file], + ]); + } + return results; + }, + + /** + * helper function to return a node containing the + * search summary for a given text. keywords is a list + * of stemmed words. + */ + makeSearchSummary: (htmlText, keywords) => { + const text = Search.htmlToText(htmlText); + if (text === "") return null; + + const textLower = text.toLowerCase(); + const actualStartPosition = [...keywords] + .map((k) => textLower.indexOf(k.toLowerCase())) + .filter((i) => i > -1) + .slice(-1)[0]; + const startWithContext = Math.max(actualStartPosition - 120, 0); + + const top = startWithContext === 0 ? "" : "..."; + const tail = startWithContext + 240 < text.length ? "..." : ""; + + let summary = document.createElement("p"); + summary.classList.add("context"); + summary.textContent = top + text.substr(startWithContext, 240).trim() + tail; + + return summary; + }, +}; + +_ready(Search.init); diff --git a/docs/_build/html/_static/skeleton.css b/docs/_build/html/_static/skeleton.css new file mode 100644 index 0000000..467c878 --- /dev/null +++ b/docs/_build/html/_static/skeleton.css @@ -0,0 +1,296 @@ +/* Some sane resets. */ +html { + height: 100%; +} + +body { + margin: 0; + min-height: 100%; +} + +/* All the flexbox magic! */ +body, +.sb-announcement, +.sb-content, +.sb-main, +.sb-container, +.sb-container__inner, +.sb-article-container, +.sb-footer-content, +.sb-header, +.sb-header-secondary, +.sb-footer { + display: flex; +} + +/* These order things vertically */ +body, +.sb-main, +.sb-article-container { + flex-direction: column; +} + +/* Put elements in the center */ +.sb-header, +.sb-header-secondary, +.sb-container, +.sb-content, +.sb-footer, +.sb-footer-content { + justify-content: center; +} +/* Put elements at the ends */ +.sb-article-container { + justify-content: space-between; +} + +/* These elements grow. */ +.sb-main, +.sb-content, +.sb-container, +article { + flex-grow: 1; +} + +/* Because padding making this wider is not fun */ +article { + box-sizing: border-box; +} + +/* The announcements element should never be wider than the page. */ +.sb-announcement { + max-width: 100%; +} + +.sb-sidebar-primary, +.sb-sidebar-secondary { + flex-shrink: 0; + width: 17rem; +} + +.sb-announcement__inner { + justify-content: center; + + box-sizing: border-box; + height: 3rem; + + overflow-x: auto; + white-space: nowrap; +} + +/* Sidebars, with checkbox-based toggle */ +.sb-sidebar-primary, +.sb-sidebar-secondary { + position: fixed; + height: 100%; + top: 0; +} + +.sb-sidebar-primary { + left: -17rem; + transition: left 250ms ease-in-out; +} +.sb-sidebar-secondary { + right: -17rem; + transition: right 250ms ease-in-out; +} + +.sb-sidebar-toggle { + display: none; +} +.sb-sidebar-overlay { + position: fixed; + top: 0; + width: 0; + height: 0; + + transition: width 0ms ease 250ms, height 0ms ease 250ms, opacity 250ms ease; + + opacity: 0; + background-color: rgba(0, 0, 0, 0.54); +} + +#sb-sidebar-toggle--primary:checked + ~ .sb-sidebar-overlay[for="sb-sidebar-toggle--primary"], +#sb-sidebar-toggle--secondary:checked + ~ .sb-sidebar-overlay[for="sb-sidebar-toggle--secondary"] { + width: 100%; + height: 100%; + opacity: 1; + transition: width 0ms ease, height 0ms ease, opacity 250ms ease; +} + +#sb-sidebar-toggle--primary:checked ~ .sb-container .sb-sidebar-primary { + left: 0; +} +#sb-sidebar-toggle--secondary:checked ~ .sb-container .sb-sidebar-secondary { + right: 0; +} + +/* Full-width mode */ +.drop-secondary-sidebar-for-full-width-content + .hide-when-secondary-sidebar-shown { + display: none !important; +} +.drop-secondary-sidebar-for-full-width-content .sb-sidebar-secondary { + display: none !important; +} + +/* Mobile views */ +.sb-page-width { + width: 100%; +} + +.sb-article-container, +.sb-footer-content__inner, +.drop-secondary-sidebar-for-full-width-content .sb-article, +.drop-secondary-sidebar-for-full-width-content .match-content-width { + width: 100vw; +} + +.sb-article, +.match-content-width { + padding: 0 1rem; + box-sizing: border-box; +} + +@media (min-width: 32rem) { + .sb-article, + .match-content-width { + padding: 0 2rem; + } +} + +/* Tablet views */ +@media (min-width: 42rem) { + .sb-article-container { + width: auto; + } + .sb-footer-content__inner, + .drop-secondary-sidebar-for-full-width-content .sb-article, + .drop-secondary-sidebar-for-full-width-content .match-content-width { + width: 42rem; + } + .sb-article, + .match-content-width { + width: 42rem; + } +} +@media (min-width: 46rem) { + .sb-footer-content__inner, + .drop-secondary-sidebar-for-full-width-content .sb-article, + .drop-secondary-sidebar-for-full-width-content .match-content-width { + width: 46rem; + } + .sb-article, + .match-content-width { + width: 46rem; + } +} +@media (min-width: 50rem) { + .sb-footer-content__inner, + .drop-secondary-sidebar-for-full-width-content .sb-article, + .drop-secondary-sidebar-for-full-width-content .match-content-width { + width: 50rem; + } + .sb-article, + .match-content-width { + width: 50rem; + } +} + +/* Tablet views */ +@media (min-width: 59rem) { + .sb-sidebar-secondary { + position: static; + } + .hide-when-secondary-sidebar-shown { + display: none !important; + } + .sb-footer-content__inner, + .drop-secondary-sidebar-for-full-width-content .sb-article, + .drop-secondary-sidebar-for-full-width-content .match-content-width { + width: 59rem; + } + .sb-article, + .match-content-width { + width: 42rem; + } +} +@media (min-width: 63rem) { + .sb-footer-content__inner, + .drop-secondary-sidebar-for-full-width-content .sb-article, + .drop-secondary-sidebar-for-full-width-content .match-content-width { + width: 63rem; + } + .sb-article, + .match-content-width { + width: 46rem; + } +} +@media (min-width: 67rem) { + .sb-footer-content__inner, + .drop-secondary-sidebar-for-full-width-content .sb-article, + .drop-secondary-sidebar-for-full-width-content .match-content-width { + width: 67rem; + } + .sb-article, + .match-content-width { + width: 50rem; + } +} + +/* Desktop views */ +@media (min-width: 76rem) { + .sb-sidebar-primary { + position: static; + } + .hide-when-primary-sidebar-shown { + display: none !important; + } + .sb-footer-content__inner, + .drop-secondary-sidebar-for-full-width-content .sb-article, + .drop-secondary-sidebar-for-full-width-content .match-content-width { + width: 59rem; + } + .sb-article, + .match-content-width { + width: 42rem; + } +} + +/* Full desktop views */ +@media (min-width: 80rem) { + .sb-article, + .match-content-width { + width: 46rem; + } + .sb-footer-content__inner, + .drop-secondary-sidebar-for-full-width-content .sb-article, + .drop-secondary-sidebar-for-full-width-content .match-content-width { + width: 63rem; + } +} + +@media (min-width: 84rem) { + .sb-article, + .match-content-width { + width: 50rem; + } + .sb-footer-content__inner, + .drop-secondary-sidebar-for-full-width-content .sb-article, + .drop-secondary-sidebar-for-full-width-content .match-content-width { + width: 67rem; + } +} + +@media (min-width: 88rem) { + .sb-footer-content__inner, + .drop-secondary-sidebar-for-full-width-content .sb-article, + .drop-secondary-sidebar-for-full-width-content .match-content-width { + width: 67rem; + } + .sb-page-width { + width: 88rem; + } +} diff --git a/docs/_build/html/_static/sphinx_highlight.js b/docs/_build/html/_static/sphinx_highlight.js new file mode 100644 index 0000000..8a96c69 --- /dev/null +++ b/docs/_build/html/_static/sphinx_highlight.js @@ -0,0 +1,154 @@ +/* Highlighting utilities for Sphinx HTML documentation. */ +"use strict"; + +const SPHINX_HIGHLIGHT_ENABLED = true + +/** + * highlight a given string on a node by wrapping it in + * span elements with the given class name. + */ +const _highlight = (node, addItems, text, className) => { + if (node.nodeType === Node.TEXT_NODE) { + const val = node.nodeValue; + const parent = node.parentNode; + const pos = val.toLowerCase().indexOf(text); + if ( + pos >= 0 && + !parent.classList.contains(className) && + !parent.classList.contains("nohighlight") + ) { + let span; + + const closestNode = parent.closest("body, svg, foreignObject"); + const isInSVG = closestNode && closestNode.matches("svg"); + if (isInSVG) { + span = document.createElementNS("http://www.w3.org/2000/svg", "tspan"); + } else { + span = document.createElement("span"); + span.classList.add(className); + } + + span.appendChild(document.createTextNode(val.substr(pos, text.length))); + const rest = document.createTextNode(val.substr(pos + text.length)); + parent.insertBefore( + span, + parent.insertBefore( + rest, + node.nextSibling + ) + ); + node.nodeValue = val.substr(0, pos); + /* There may be more occurrences of search term in this node. So call this + * function recursively on the remaining fragment. + */ + _highlight(rest, addItems, text, className); + + if (isInSVG) { + const rect = document.createElementNS( + "http://www.w3.org/2000/svg", + "rect" + ); + const bbox = parent.getBBox(); + rect.x.baseVal.value = bbox.x; + rect.y.baseVal.value = bbox.y; + rect.width.baseVal.value = bbox.width; + rect.height.baseVal.value = bbox.height; + rect.setAttribute("class", className); + addItems.push({ parent: parent, target: rect }); + } + } + } else if (node.matches && !node.matches("button, select, textarea")) { + node.childNodes.forEach((el) => _highlight(el, addItems, text, className)); + } +}; +const _highlightText = (thisNode, text, className) => { + let addItems = []; + _highlight(thisNode, addItems, text, className); + addItems.forEach((obj) => + obj.parent.insertAdjacentElement("beforebegin", obj.target) + ); +}; + +/** + * Small JavaScript module for the documentation. + */ +const SphinxHighlight = { + + /** + * highlight the search words provided in localstorage in the text + */ + highlightSearchWords: () => { + if (!SPHINX_HIGHLIGHT_ENABLED) return; // bail if no highlight + + // get and clear terms from localstorage + const url = new URL(window.location); + const highlight = + localStorage.getItem("sphinx_highlight_terms") + || url.searchParams.get("highlight") + || ""; + localStorage.removeItem("sphinx_highlight_terms") + url.searchParams.delete("highlight"); + window.history.replaceState({}, "", url); + + // get individual terms from highlight string + const terms = highlight.toLowerCase().split(/\s+/).filter(x => x); + if (terms.length === 0) return; // nothing to do + + // There should never be more than one element matching "div.body" + const divBody = document.querySelectorAll("div.body"); + const body = divBody.length ? divBody[0] : document.querySelector("body"); + window.setTimeout(() => { + terms.forEach((term) => _highlightText(body, term, "highlighted")); + }, 10); + + const searchBox = document.getElementById("searchbox"); + if (searchBox === null) return; + searchBox.appendChild( + document + .createRange() + .createContextualFragment( + '

' + + '' + + _("Hide Search Matches") + + "

" + ) + ); + }, + + /** + * helper function to hide the search marks again + */ + hideSearchWords: () => { + document + .querySelectorAll("#searchbox .highlight-link") + .forEach((el) => el.remove()); + document + .querySelectorAll("span.highlighted") + .forEach((el) => el.classList.remove("highlighted")); + localStorage.removeItem("sphinx_highlight_terms") + }, + + initEscapeListener: () => { + // only install a listener if it is really needed + if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS) return; + + document.addEventListener("keydown", (event) => { + // bail for input elements + if (BLACKLISTED_KEY_CONTROL_ELEMENTS.has(document.activeElement.tagName)) return; + // bail with special keys + if (event.shiftKey || event.altKey || event.ctrlKey || event.metaKey) return; + if (DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS && (event.key === "Escape")) { + SphinxHighlight.hideSearchWords(); + event.preventDefault(); + } + }); + }, +}; + +_ready(() => { + /* Do not call highlightSearchWords() when we are on the search page. + * It will highlight words from the *previous* search query. + */ + if (typeof Search === "undefined") SphinxHighlight.highlightSearchWords(); + SphinxHighlight.initEscapeListener(); +}); diff --git a/docs/_build/html/_static/styles/furo-extensions.css b/docs/_build/html/_static/styles/furo-extensions.css new file mode 100644 index 0000000..bc447f2 --- /dev/null +++ b/docs/_build/html/_static/styles/furo-extensions.css @@ -0,0 +1,2 @@ +#furo-sidebar-ad-placement{padding:var(--sidebar-item-spacing-vertical) var(--sidebar-item-spacing-horizontal)}#furo-sidebar-ad-placement .ethical-sidebar{background:var(--color-background-secondary);border:none;box-shadow:none}#furo-sidebar-ad-placement .ethical-sidebar:hover{background:var(--color-background-hover)}#furo-sidebar-ad-placement .ethical-sidebar a{color:var(--color-foreground-primary)}#furo-sidebar-ad-placement .ethical-callout a{color:var(--color-foreground-secondary)!important}#furo-readthedocs-versions{background:transparent;display:block;position:static;width:100%}#furo-readthedocs-versions .rst-versions{background:#1a1c1e}#furo-readthedocs-versions .rst-current-version{background:var(--color-sidebar-item-background);cursor:unset}#furo-readthedocs-versions .rst-current-version:hover{background:var(--color-sidebar-item-background)}#furo-readthedocs-versions .rst-current-version .fa-book{color:var(--color-foreground-primary)}#furo-readthedocs-versions>.rst-other-versions{padding:0}#furo-readthedocs-versions>.rst-other-versions small{opacity:1}#furo-readthedocs-versions .injected .rst-versions{position:unset}#furo-readthedocs-versions:focus-within,#furo-readthedocs-versions:hover{box-shadow:0 0 0 1px var(--color-sidebar-background-border)}#furo-readthedocs-versions:focus-within .rst-current-version,#furo-readthedocs-versions:hover .rst-current-version{background:#1a1c1e;font-size:inherit;height:auto;line-height:inherit;padding:12px;text-align:right}#furo-readthedocs-versions:focus-within .rst-current-version .fa-book,#furo-readthedocs-versions:hover .rst-current-version .fa-book{color:#fff;float:left}#furo-readthedocs-versions:focus-within .fa-caret-down,#furo-readthedocs-versions:hover .fa-caret-down{display:none}#furo-readthedocs-versions:focus-within .injected,#furo-readthedocs-versions:focus-within .rst-current-version,#furo-readthedocs-versions:focus-within .rst-other-versions,#furo-readthedocs-versions:hover .injected,#furo-readthedocs-versions:hover .rst-current-version,#furo-readthedocs-versions:hover .rst-other-versions{display:block}#furo-readthedocs-versions:focus-within>.rst-current-version,#furo-readthedocs-versions:hover>.rst-current-version{display:none}.highlight:hover button.copybtn{color:var(--color-code-foreground)}.highlight button.copybtn{align-items:center;background-color:var(--color-code-background);border:none;color:var(--color-background-item);cursor:pointer;height:1.25em;opacity:1;right:.5rem;top:.625rem;transition:color .3s,opacity .3s;width:1.25em}.highlight button.copybtn:hover{background-color:var(--color-code-background);color:var(--color-brand-content)}.highlight button.copybtn:after{background-color:transparent;color:var(--color-code-foreground);display:none}.highlight button.copybtn.success{color:#22863a;transition:color 0ms}.highlight button.copybtn.success:after{display:block}.highlight button.copybtn svg{padding:0}body{--sd-color-primary:var(--color-brand-primary);--sd-color-primary-highlight:var(--color-brand-content);--sd-color-primary-text:var(--color-background-primary);--sd-color-shadow:rgba(0,0,0,.05);--sd-color-card-border:var(--color-card-border);--sd-color-card-border-hover:var(--color-brand-content);--sd-color-card-background:var(--color-card-background);--sd-color-card-text:var(--color-foreground-primary);--sd-color-card-header:var(--color-card-marginals-background);--sd-color-card-footer:var(--color-card-marginals-background);--sd-color-tabs-label-active:var(--color-brand-content);--sd-color-tabs-label-hover:var(--color-foreground-muted);--sd-color-tabs-label-inactive:var(--color-foreground-muted);--sd-color-tabs-underline-active:var(--color-brand-content);--sd-color-tabs-underline-hover:var(--color-foreground-border);--sd-color-tabs-underline-inactive:var(--color-background-border);--sd-color-tabs-overline:var(--color-background-border);--sd-color-tabs-underline:var(--color-background-border)}.sd-tab-content{box-shadow:0 -2px var(--sd-color-tabs-overline),0 1px var(--sd-color-tabs-underline)}.sd-card{box-shadow:0 .1rem .25rem var(--sd-color-shadow),0 0 .0625rem rgba(0,0,0,.1)}.sd-shadow-sm{box-shadow:0 .1rem .25rem var(--sd-color-shadow),0 0 .0625rem rgba(0,0,0,.1)!important}.sd-shadow-md{box-shadow:0 .3rem .75rem var(--sd-color-shadow),0 0 .0625rem rgba(0,0,0,.1)!important}.sd-shadow-lg{box-shadow:0 .6rem 1.5rem var(--sd-color-shadow),0 0 .0625rem rgba(0,0,0,.1)!important}.sd-card-hover:hover{transform:none}.sd-cards-carousel{gap:.25rem;padding:.25rem}body{--tabs--label-text:var(--color-foreground-muted);--tabs--label-text--hover:var(--color-foreground-muted);--tabs--label-text--active:var(--color-brand-content);--tabs--label-text--active--hover:var(--color-brand-content);--tabs--label-background:transparent;--tabs--label-background--hover:transparent;--tabs--label-background--active:transparent;--tabs--label-background--active--hover:transparent;--tabs--padding-x:0.25em;--tabs--margin-x:1em;--tabs--border:var(--color-background-border);--tabs--label-border:transparent;--tabs--label-border--hover:var(--color-foreground-muted);--tabs--label-border--active:var(--color-brand-content);--tabs--label-border--active--hover:var(--color-brand-content)}[role=main] .container{max-width:none;padding-left:0;padding-right:0}.shadow.docutils{border:none;box-shadow:0 .2rem .5rem rgba(0,0,0,.05),0 0 .0625rem rgba(0,0,0,.1)!important}.sphinx-bs .card{background-color:var(--color-background-secondary);color:var(--color-foreground)} +/*# sourceMappingURL=furo-extensions.css.map*/ \ No newline at end of file diff --git a/docs/_build/html/_static/styles/furo-extensions.css.map b/docs/_build/html/_static/styles/furo-extensions.css.map new file mode 100644 index 0000000..9ba5637 --- /dev/null +++ b/docs/_build/html/_static/styles/furo-extensions.css.map @@ -0,0 +1 @@ +{"version":3,"file":"styles/furo-extensions.css","mappings":"AAGA,2BACE,oFACA,4CAKE,6CAHA,YACA,eAEA,CACA,kDACE,yCAEF,8CACE,sCAEJ,8CACE,kDAEJ,2BAGE,uBACA,cAHA,gBACA,UAEA,CAGA,yCACE,mBAEF,gDAEE,gDADA,YACA,CACA,sDACE,gDACF,yDACE,sCAEJ,+CACE,UACA,qDACE,UAGF,mDACE,eAEJ,yEAEE,4DAEA,mHASE,mBAPA,kBAEA,YADA,oBAGA,aADA,gBAIA,CAEA,qIAEE,WADA,UACA,CAEJ,uGACE,aAEF,iUAGE,cAEF,mHACE,aC1EJ,gCACE,mCAEF,0BAKE,mBAUA,8CACA,YAFA,mCAKA,eAZA,cALA,UASA,YADA,YAYA,iCAdA,YAcA,CAEA,gCAEE,8CADA,gCACA,CAEF,gCAGE,6BADA,mCADA,YAEA,CAEF,kCAEE,cADA,oBACA,CACA,wCACE,cAEJ,8BACE,UC5CN,KAEE,6CAA8C,CAC9C,uDAAwD,CACxD,uDAAwD,CAGxD,iCAAsC,CAGtC,+CAAgD,CAChD,uDAAwD,CACxD,uDAAwD,CACxD,oDAAqD,CACrD,6DAA8D,CAC9D,6DAA8D,CAG9D,uDAAwD,CACxD,yDAA0D,CAC1D,4DAA6D,CAC7D,2DAA4D,CAC5D,8DAA+D,CAC/D,iEAAkE,CAClE,uDAAwD,CACxD,wDAAyD,CAG3D,gBACE,qFAGF,SACE,6EAEF,cACE,uFAEF,cACE,uFAEF,cACE,uFAGF,qBACE,eAEF,mBACE,WACA,eChDF,KACE,gDAAiD,CACjD,uDAAwD,CACxD,qDAAsD,CACtD,4DAA6D,CAC7D,oCAAqC,CACrC,2CAA4C,CAC5C,4CAA6C,CAC7C,mDAAoD,CACpD,wBAAyB,CACzB,oBAAqB,CACrB,6CAA8C,CAC9C,gCAAiC,CACjC,yDAA0D,CAC1D,uDAAwD,CACxD,8DAA+D,CCbjE,uBACE,eACA,eACA,gBAGF,iBACE,YACA,+EAGF,iBACE,mDACA","sources":["webpack:///./src/furo/assets/styles/extensions/_readthedocs.sass","webpack:///./src/furo/assets/styles/extensions/_copybutton.sass","webpack:///./src/furo/assets/styles/extensions/_sphinx-design.sass","webpack:///./src/furo/assets/styles/extensions/_sphinx-inline-tabs.sass","webpack:///./src/furo/assets/styles/extensions/_sphinx-panels.sass"],"sourcesContent":["// This file contains the styles used for tweaking how ReadTheDoc's embedded\n// contents would show up inside the theme.\n\n#furo-sidebar-ad-placement\n padding: var(--sidebar-item-spacing-vertical) var(--sidebar-item-spacing-horizontal)\n .ethical-sidebar\n // Remove the border and box-shadow.\n border: none\n box-shadow: none\n // Manage the background colors.\n background: var(--color-background-secondary)\n &:hover\n background: var(--color-background-hover)\n // Ensure the text is legible.\n a\n color: var(--color-foreground-primary)\n\n .ethical-callout a\n color: var(--color-foreground-secondary) !important\n\n#furo-readthedocs-versions\n position: static\n width: 100%\n background: transparent\n display: block\n\n // Make the background color fit with the theme's aesthetic.\n .rst-versions\n background: rgb(26, 28, 30)\n\n .rst-current-version\n cursor: unset\n background: var(--color-sidebar-item-background)\n &:hover\n background: var(--color-sidebar-item-background)\n .fa-book\n color: var(--color-foreground-primary)\n\n > .rst-other-versions\n padding: 0\n small\n opacity: 1\n\n .injected\n .rst-versions\n position: unset\n\n &:hover,\n &:focus-within\n box-shadow: 0 0 0 1px var(--color-sidebar-background-border)\n\n .rst-current-version\n // Undo the tweaks done in RTD's CSS\n font-size: inherit\n line-height: inherit\n height: auto\n text-align: right\n padding: 12px\n\n // Match the rest of the body\n background: #1a1c1e\n\n .fa-book\n float: left\n color: white\n\n .fa-caret-down\n display: none\n\n .rst-current-version,\n .rst-other-versions,\n .injected\n display: block\n\n > .rst-current-version\n display: none\n",".highlight\n &:hover button.copybtn\n color: var(--color-code-foreground)\n\n button.copybtn\n // Make it visible\n opacity: 1\n\n // Align things correctly\n align-items: center\n\n height: 1.25em\n width: 1.25em\n\n top: 0.625rem // $code-spacing-vertical\n right: 0.5rem\n\n // Make it look better\n color: var(--color-background-item)\n background-color: var(--color-code-background)\n border: none\n\n // Change to cursor to make it obvious that you can click on it\n cursor: pointer\n\n // Transition smoothly, for aesthetics\n transition: color 300ms, opacity 300ms\n\n &:hover\n color: var(--color-brand-content)\n background-color: var(--color-code-background)\n\n &::after\n display: none\n color: var(--color-code-foreground)\n background-color: transparent\n\n &.success\n transition: color 0ms\n color: #22863a\n &::after\n display: block\n\n svg\n padding: 0\n","body\n // Colors\n --sd-color-primary: var(--color-brand-primary)\n --sd-color-primary-highlight: var(--color-brand-content)\n --sd-color-primary-text: var(--color-background-primary)\n\n // Shadows\n --sd-color-shadow: rgba(0, 0, 0, 0.05)\n\n // Cards\n --sd-color-card-border: var(--color-card-border)\n --sd-color-card-border-hover: var(--color-brand-content)\n --sd-color-card-background: var(--color-card-background)\n --sd-color-card-text: var(--color-foreground-primary)\n --sd-color-card-header: var(--color-card-marginals-background)\n --sd-color-card-footer: var(--color-card-marginals-background)\n\n // Tabs\n --sd-color-tabs-label-active: var(--color-brand-content)\n --sd-color-tabs-label-hover: var(--color-foreground-muted)\n --sd-color-tabs-label-inactive: var(--color-foreground-muted)\n --sd-color-tabs-underline-active: var(--color-brand-content)\n --sd-color-tabs-underline-hover: var(--color-foreground-border)\n --sd-color-tabs-underline-inactive: var(--color-background-border)\n --sd-color-tabs-overline: var(--color-background-border)\n --sd-color-tabs-underline: var(--color-background-border)\n\n// Tabs\n.sd-tab-content\n box-shadow: 0 -2px var(--sd-color-tabs-overline), 0 1px var(--sd-color-tabs-underline)\n\n// Shadows\n.sd-card // Have a shadow by default\n box-shadow: 0 0.1rem 0.25rem var(--sd-color-shadow), 0 0 0.0625rem rgba(0, 0, 0, 0.1)\n\n.sd-shadow-sm\n box-shadow: 0 0.1rem 0.25rem var(--sd-color-shadow), 0 0 0.0625rem rgba(0, 0, 0, 0.1) !important\n\n.sd-shadow-md\n box-shadow: 0 0.3rem 0.75rem var(--sd-color-shadow), 0 0 0.0625rem rgba(0, 0, 0, 0.1) !important\n\n.sd-shadow-lg\n box-shadow: 0 0.6rem 1.5rem var(--sd-color-shadow), 0 0 0.0625rem rgba(0, 0, 0, 0.1) !important\n\n// Cards\n.sd-card-hover:hover // Don't change scale on hover\n transform: none\n\n.sd-cards-carousel // Have a bit of gap in the carousel by default\n gap: 0.25rem\n padding: 0.25rem\n","// This file contains styles to tweak sphinx-inline-tabs to work well with Furo.\n\nbody\n --tabs--label-text: var(--color-foreground-muted)\n --tabs--label-text--hover: var(--color-foreground-muted)\n --tabs--label-text--active: var(--color-brand-content)\n --tabs--label-text--active--hover: var(--color-brand-content)\n --tabs--label-background: transparent\n --tabs--label-background--hover: transparent\n --tabs--label-background--active: transparent\n --tabs--label-background--active--hover: transparent\n --tabs--padding-x: 0.25em\n --tabs--margin-x: 1em\n --tabs--border: var(--color-background-border)\n --tabs--label-border: transparent\n --tabs--label-border--hover: var(--color-foreground-muted)\n --tabs--label-border--active: var(--color-brand-content)\n --tabs--label-border--active--hover: var(--color-brand-content)\n","// This file contains styles to tweak sphinx-panels to work well with Furo.\n\n// sphinx-panels includes Bootstrap 4, which uses .container which can conflict\n// with docutils' `.. container::` directive.\n[role=\"main\"] .container\n max-width: initial\n padding-left: initial\n padding-right: initial\n\n// Make the panels look nicer!\n.shadow.docutils\n border: none\n box-shadow: 0 0.2rem 0.5rem rgba(0, 0, 0, 0.05), 0 0 0.0625rem rgba(0, 0, 0, 0.1) !important\n\n// Make panel colors respond to dark mode\n.sphinx-bs .card\n background-color: var(--color-background-secondary)\n color: var(--color-foreground)\n"],"names":[],"sourceRoot":""} \ No newline at end of file diff --git a/docs/_build/html/_static/styles/furo.css b/docs/_build/html/_static/styles/furo.css new file mode 100644 index 0000000..3d29a21 --- /dev/null +++ b/docs/_build/html/_static/styles/furo.css @@ -0,0 +1,2 @@ +/*! normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css */html{-webkit-text-size-adjust:100%;line-height:1.15}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}[type=button],[type=reset],[type=submit],button{-webkit-appearance:button}[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner,button::-moz-focus-inner{border-style:none;padding:0}[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring,button:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}[hidden],template{display:none}@media print{.content-icon-container,.headerlink,.mobile-header,.related-pages{display:none!important}.highlight{border:.1pt solid var(--color-foreground-border)}a,blockquote,dl,ol,pre,table,ul{page-break-inside:avoid}caption,figure,h1,h2,h3,h4,h5,h6,img{page-break-after:avoid;page-break-inside:avoid}dl,ol,ul{page-break-before:avoid}}.visually-hidden{clip:rect(0,0,0,0)!important;border:0!important;height:1px!important;margin:-1px!important;overflow:hidden!important;padding:0!important;position:absolute!important;white-space:nowrap!important;width:1px!important}:-moz-focusring{outline:auto}body{--font-stack:-apple-system,BlinkMacSystemFont,Segoe UI,Helvetica,Arial,sans-serif,Apple Color Emoji,Segoe UI Emoji;--font-stack--monospace:"SFMono-Regular",Menlo,Consolas,Monaco,Liberation Mono,Lucida Console,monospace;--font-size--normal:100%;--font-size--small:87.5%;--font-size--small--2:81.25%;--font-size--small--3:75%;--font-size--small--4:62.5%;--sidebar-caption-font-size:var(--font-size--small--2);--sidebar-item-font-size:var(--font-size--small);--sidebar-search-input-font-size:var(--font-size--small);--toc-font-size:var(--font-size--small--3);--toc-font-size--mobile:var(--font-size--normal);--toc-title-font-size:var(--font-size--small--4);--admonition-font-size:0.8125rem;--admonition-title-font-size:0.8125rem;--code-font-size:var(--font-size--small--2);--api-font-size:var(--font-size--small);--header-height:calc(var(--sidebar-item-line-height) + var(--sidebar-item-spacing-vertical)*4);--header-padding:0.5rem;--sidebar-tree-space-above:1.5rem;--sidebar-caption-space-above:1rem;--sidebar-item-line-height:1rem;--sidebar-item-spacing-vertical:0.5rem;--sidebar-item-spacing-horizontal:1rem;--sidebar-item-height:calc(var(--sidebar-item-line-height) + var(--sidebar-item-spacing-vertical)*2);--sidebar-expander-width:var(--sidebar-item-height);--sidebar-search-space-above:0.5rem;--sidebar-search-input-spacing-vertical:0.5rem;--sidebar-search-input-spacing-horizontal:0.5rem;--sidebar-search-input-height:1rem;--sidebar-search-icon-size:var(--sidebar-search-input-height);--toc-title-padding:0.25rem 0;--toc-spacing-vertical:1.5rem;--toc-spacing-horizontal:1.5rem;--toc-item-spacing-vertical:0.4rem;--toc-item-spacing-horizontal:1rem;--icon-search:url('data:image/svg+xml;charset=utf-8,');--icon-pencil:url('data:image/svg+xml;charset=utf-8,');--icon-abstract:url('data:image/svg+xml;charset=utf-8,');--icon-info:url('data:image/svg+xml;charset=utf-8,');--icon-flame:url('data:image/svg+xml;charset=utf-8,');--icon-question:url('data:image/svg+xml;charset=utf-8,');--icon-warning:url('data:image/svg+xml;charset=utf-8,');--icon-failure:url('data:image/svg+xml;charset=utf-8,');--icon-spark:url('data:image/svg+xml;charset=utf-8,');--color-admonition-title--caution:#ff9100;--color-admonition-title-background--caution:rgba(255,145,0,.2);--color-admonition-title--warning:#ff9100;--color-admonition-title-background--warning:rgba(255,145,0,.2);--color-admonition-title--danger:#ff5252;--color-admonition-title-background--danger:rgba(255,82,82,.2);--color-admonition-title--attention:#ff5252;--color-admonition-title-background--attention:rgba(255,82,82,.2);--color-admonition-title--error:#ff5252;--color-admonition-title-background--error:rgba(255,82,82,.2);--color-admonition-title--hint:#00c852;--color-admonition-title-background--hint:rgba(0,200,82,.2);--color-admonition-title--tip:#00c852;--color-admonition-title-background--tip:rgba(0,200,82,.2);--color-admonition-title--important:#00bfa5;--color-admonition-title-background--important:rgba(0,191,165,.2);--color-admonition-title--note:#00b0ff;--color-admonition-title-background--note:rgba(0,176,255,.2);--color-admonition-title--seealso:#448aff;--color-admonition-title-background--seealso:rgba(68,138,255,.2);--color-admonition-title--admonition-todo:grey;--color-admonition-title-background--admonition-todo:hsla(0,0%,50%,.2);--color-admonition-title:#651fff;--color-admonition-title-background:rgba(101,31,255,.2);--icon-admonition-default:var(--icon-abstract);--color-topic-title:#14b8a6;--color-topic-title-background:rgba(20,184,166,.2);--icon-topic-default:var(--icon-pencil);--color-problematic:#b30000;--color-foreground-primary:#000;--color-foreground-secondary:#5a5c63;--color-foreground-muted:#646776;--color-foreground-border:#878787;--color-background-primary:#fff;--color-background-secondary:#f8f9fb;--color-background-hover:#efeff4;--color-background-hover--transparent:#efeff400;--color-background-border:#eeebee;--color-background-item:#ccc;--color-announcement-background:#000000dd;--color-announcement-text:#eeebee;--color-brand-primary:#2962ff;--color-brand-content:#2a5adf;--color-api-background:var(--color-background-hover--transparent);--color-api-background-hover:var(--color-background-hover);--color-api-overall:var(--color-foreground-secondary);--color-api-name:var(--color-problematic);--color-api-pre-name:var(--color-problematic);--color-api-paren:var(--color-foreground-secondary);--color-api-keyword:var(--color-foreground-primary);--color-highlight-on-target:#ffc;--color-inline-code-background:var(--color-background-secondary);--color-highlighted-background:#def;--color-highlighted-text:var(--color-foreground-primary);--color-guilabel-background:#ddeeff80;--color-guilabel-border:#bedaf580;--color-guilabel-text:var(--color-foreground-primary);--color-admonition-background:transparent;--color-table-header-background:var(--color-background-secondary);--color-table-border:var(--color-background-border);--color-card-border:var(--color-background-secondary);--color-card-background:transparent;--color-card-marginals-background:var(--color-background-secondary);--color-header-background:var(--color-background-primary);--color-header-border:var(--color-background-border);--color-header-text:var(--color-foreground-primary);--color-sidebar-background:var(--color-background-secondary);--color-sidebar-background-border:var(--color-background-border);--color-sidebar-brand-text:var(--color-foreground-primary);--color-sidebar-caption-text:var(--color-foreground-muted);--color-sidebar-link-text:var(--color-foreground-secondary);--color-sidebar-link-text--top-level:var(--color-brand-primary);--color-sidebar-item-background:var(--color-sidebar-background);--color-sidebar-item-background--current:var( --color-sidebar-item-background );--color-sidebar-item-background--hover:linear-gradient(90deg,var(--color-background-hover--transparent) 0%,var(--color-background-hover) var(--sidebar-item-spacing-horizontal),var(--color-background-hover) 100%);--color-sidebar-item-expander-background:transparent;--color-sidebar-item-expander-background--hover:var( --color-background-hover );--color-sidebar-search-text:var(--color-foreground-primary);--color-sidebar-search-background:var(--color-background-secondary);--color-sidebar-search-background--focus:var(--color-background-primary);--color-sidebar-search-border:var(--color-background-border);--color-sidebar-search-icon:var(--color-foreground-muted);--color-toc-background:var(--color-background-primary);--color-toc-title-text:var(--color-foreground-muted);--color-toc-item-text:var(--color-foreground-secondary);--color-toc-item-text--hover:var(--color-foreground-primary);--color-toc-item-text--active:var(--color-brand-primary);--color-content-foreground:var(--color-foreground-primary);--color-content-background:transparent;--color-link:var(--color-brand-content);--color-link--hover:var(--color-brand-content);--color-link-underline:var(--color-background-border);--color-link-underline--hover:var(--color-foreground-border)}.only-light{display:block!important}html body .only-dark{display:none!important}@media not print{body[data-theme=dark]{--color-problematic:#ee5151;--color-foreground-primary:#ffffffcc;--color-foreground-secondary:#9ca0a5;--color-foreground-muted:#81868d;--color-foreground-border:#666;--color-background-primary:#131416;--color-background-secondary:#1a1c1e;--color-background-hover:#1e2124;--color-background-hover--transparent:#1e212400;--color-background-border:#303335;--color-background-item:#444;--color-announcement-background:#000000dd;--color-announcement-text:#eeebee;--color-brand-primary:#2b8cee;--color-brand-content:#368ce2;--color-highlighted-background:#083563;--color-guilabel-background:#08356380;--color-guilabel-border:#13395f80;--color-api-keyword:var(--color-foreground-secondary);--color-highlight-on-target:#330;--color-admonition-background:#18181a;--color-card-border:var(--color-background-secondary);--color-card-background:#18181a;--color-card-marginals-background:var(--color-background-hover)}html body[data-theme=dark] .only-light{display:none!important}body[data-theme=dark] .only-dark{display:block!important}@media(prefers-color-scheme:dark){body:not([data-theme=light]){--color-problematic:#ee5151;--color-foreground-primary:#ffffffcc;--color-foreground-secondary:#9ca0a5;--color-foreground-muted:#81868d;--color-foreground-border:#666;--color-background-primary:#131416;--color-background-secondary:#1a1c1e;--color-background-hover:#1e2124;--color-background-hover--transparent:#1e212400;--color-background-border:#303335;--color-background-item:#444;--color-announcement-background:#000000dd;--color-announcement-text:#eeebee;--color-brand-primary:#2b8cee;--color-brand-content:#368ce2;--color-highlighted-background:#083563;--color-guilabel-background:#08356380;--color-guilabel-border:#13395f80;--color-api-keyword:var(--color-foreground-secondary);--color-highlight-on-target:#330;--color-admonition-background:#18181a;--color-card-border:var(--color-background-secondary);--color-card-background:#18181a;--color-card-marginals-background:var(--color-background-hover)}html body:not([data-theme=light]) .only-light{display:none!important}body:not([data-theme=light]) .only-dark{display:block!important}}}body[data-theme=auto] .theme-toggle svg.theme-icon-when-auto,body[data-theme=dark] .theme-toggle svg.theme-icon-when-dark,body[data-theme=light] .theme-toggle svg.theme-icon-when-light{display:block}body{font-family:var(--font-stack)}code,kbd,pre,samp{font-family:var(--font-stack--monospace)}body{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}article{line-height:1.5}h1,h2,h3,h4,h5,h6{border-radius:.5rem;font-weight:700;line-height:1.25;margin:.5rem -.5rem;padding-left:.5rem;padding-right:.5rem}h1+p,h2+p,h3+p,h4+p,h5+p,h6+p{margin-top:0}h1{font-size:2.5em;margin-bottom:1rem}h1,h2{margin-top:1.75rem}h2{font-size:2em}h3{font-size:1.5em}h4{font-size:1.25em}h5{font-size:1.125em}h6{font-size:1em}small{font-size:80%;opacity:75%}p{margin-bottom:.75rem;margin-top:.5rem}hr.docutils{background-color:var(--color-background-border);border:0;height:1px;margin:2rem 0;padding:0}.centered{text-align:center}a{color:var(--color-link);text-decoration:underline;text-decoration-color:var(--color-link-underline)}a:hover{color:var(--color-link--hover);text-decoration-color:var(--color-link-underline--hover)}a.muted-link{color:inherit}a.muted-link:hover{color:var(--color-link);text-decoration-color:var(--color-link-underline--hover)}html{overflow-x:hidden;overflow-y:scroll;scroll-behavior:smooth}.sidebar-scroll,.toc-scroll,article[role=main] *{scrollbar-color:var(--color-foreground-border) transparent;scrollbar-width:thin}.sidebar-scroll::-webkit-scrollbar,.toc-scroll::-webkit-scrollbar,article[role=main] ::-webkit-scrollbar{height:.25rem;width:.25rem}.sidebar-scroll::-webkit-scrollbar-thumb,.toc-scroll::-webkit-scrollbar-thumb,article[role=main] ::-webkit-scrollbar-thumb{background-color:var(--color-foreground-border);border-radius:.125rem}body,html{background:var(--color-background-primary);color:var(--color-foreground-primary);height:100%}article{background:var(--color-content-background);color:var(--color-content-foreground);overflow-wrap:break-word}.page{display:flex;min-height:100%}.mobile-header{background-color:var(--color-header-background);border-bottom:1px solid var(--color-header-border);color:var(--color-header-text);display:none;height:var(--header-height);width:100%;z-index:10}.mobile-header.scrolled{border-bottom:none;box-shadow:0 0 .2rem rgba(0,0,0,.1),0 .2rem .4rem rgba(0,0,0,.2)}.mobile-header .header-center a{color:var(--color-header-text);text-decoration:none}.main{display:flex;flex:1}.sidebar-drawer{background:var(--color-sidebar-background);border-right:1px solid var(--color-sidebar-background-border);box-sizing:border-box;display:flex;justify-content:flex-end;min-width:15em;width:calc(50% - 26em)}.sidebar-container,.toc-drawer{box-sizing:border-box;width:15em}.toc-drawer{background:var(--color-toc-background);padding-right:1rem}.sidebar-sticky,.toc-sticky{display:flex;flex-direction:column;height:min(100%,100vh);height:100vh;position:sticky;top:0}.sidebar-scroll,.toc-scroll{flex-grow:1;flex-shrink:1;overflow:auto;scroll-behavior:smooth}.content{display:flex;flex-direction:column;justify-content:space-between;padding:0 3em;width:46em}.icon{display:inline-block;height:1rem;width:1rem}.icon svg{height:100%;width:100%}.announcement{align-items:center;background-color:var(--color-announcement-background);color:var(--color-announcement-text);display:flex;height:var(--header-height);overflow-x:auto}.announcement+.page{min-height:calc(100% - var(--header-height))}.announcement-content{box-sizing:border-box;min-width:100%;padding:.5rem;text-align:center;white-space:nowrap}.announcement-content a{color:var(--color-announcement-text);text-decoration-color:var(--color-announcement-text)}.announcement-content a:hover{color:var(--color-announcement-text);text-decoration-color:var(--color-link--hover)}.no-js .theme-toggle-container{display:none}.theme-toggle-container{vertical-align:middle}.theme-toggle{background:transparent;border:none;cursor:pointer;padding:0}.theme-toggle svg{color:var(--color-foreground-primary);display:none;height:1rem;vertical-align:middle;width:1rem}.theme-toggle-header{float:left;padding:1rem .5rem}.nav-overlay-icon,.toc-overlay-icon{cursor:pointer;display:none}.nav-overlay-icon .icon,.toc-overlay-icon .icon{color:var(--color-foreground-secondary);height:1rem;width:1rem}.nav-overlay-icon,.toc-header-icon{align-items:center;justify-content:center}.toc-content-icon{height:1.5rem;width:1.5rem}.content-icon-container{display:flex;float:right;gap:.5rem;margin-bottom:1rem;margin-left:1rem;margin-top:1.5rem}.content-icon-container .edit-this-page svg{color:inherit;height:1rem;width:1rem}.sidebar-toggle{display:none;position:absolute}.sidebar-toggle[name=__toc]{left:20px}.sidebar-toggle:checked{left:40px}.overlay{background-color:rgba(0,0,0,.54);height:0;opacity:0;position:fixed;top:0;transition:width 0ms,height 0ms,opacity .25s ease-out;width:0}.sidebar-overlay{z-index:20}.toc-overlay{z-index:40}.sidebar-drawer{transition:left .25s ease-in-out;z-index:30}.toc-drawer{transition:right .25s ease-in-out;z-index:50}#__navigation:checked~.sidebar-overlay{height:100%;opacity:1;width:100%}#__navigation:checked~.page .sidebar-drawer{left:0;top:0}#__toc:checked~.toc-overlay{height:100%;opacity:1;width:100%}#__toc:checked~.page .toc-drawer{right:0;top:0}.back-to-top{background:var(--color-background-primary);border-radius:1rem;box-shadow:0 .2rem .5rem rgba(0,0,0,.05),0 0 1px 0 hsla(220,9%,46%,.502);display:none;font-size:.8125rem;left:0;margin-left:50%;padding:.5rem .75rem .5rem .5rem;position:fixed;text-decoration:none;top:1rem;transform:translateX(-50%);z-index:10}.back-to-top svg{fill:currentColor;display:inline-block;height:1rem;width:1rem}.back-to-top span{margin-left:.25rem}.show-back-to-top .back-to-top{align-items:center;display:flex}@media(min-width:97em){html{font-size:110%}}@media(max-width:82em){.toc-content-icon{display:flex}.toc-drawer{border-left:1px solid var(--color-background-muted);height:100vh;position:fixed;right:-15em;top:0}.toc-tree{border-left:none;font-size:var(--toc-font-size--mobile)}.sidebar-drawer{width:calc(50% - 18.5em)}}@media(max-width:67em){.nav-overlay-icon{display:flex}.sidebar-drawer{height:100vh;left:-15em;position:fixed;top:0;width:15em}.toc-header-icon{display:flex}.theme-toggle-content,.toc-content-icon{display:none}.theme-toggle-header{display:block}.mobile-header{align-items:center;display:flex;justify-content:space-between;position:sticky;top:0}.mobile-header .header-left,.mobile-header .header-right{display:flex;height:var(--header-height);padding:0 var(--header-padding)}.mobile-header .header-left label,.mobile-header .header-right label{height:100%;-webkit-user-select:none;-moz-user-select:none;user-select:none;width:100%}.nav-overlay-icon .icon,.theme-toggle svg{height:1.25rem;width:1.25rem}:target{scroll-margin-top:var(--header-height)}.back-to-top{top:calc(var(--header-height) + .5rem)}.page{flex-direction:column;justify-content:center}.content{margin-left:auto;margin-right:auto}}@media(max-width:52em){.content{overflow-x:auto;width:100%}}@media(max-width:46em){.content{padding:0 1em}article aside.sidebar{float:none;margin:1rem 0;width:100%}}.admonition,.topic{background:var(--color-admonition-background);border-radius:.2rem;box-shadow:0 .2rem .5rem rgba(0,0,0,.05),0 0 .0625rem rgba(0,0,0,.1);font-size:var(--admonition-font-size);margin:1rem auto;overflow:hidden;padding:0 .5rem .5rem;page-break-inside:avoid}.admonition>:nth-child(2),.topic>:nth-child(2){margin-top:0}.admonition>:last-child,.topic>:last-child{margin-bottom:0}.admonition p.admonition-title,p.topic-title{font-size:var(--admonition-title-font-size);font-weight:500;line-height:1.3;margin:0 -.5rem .5rem;padding:.4rem .5rem .4rem 2rem;position:relative}.admonition p.admonition-title:before,p.topic-title:before{content:"";height:1rem;left:.5rem;position:absolute;width:1rem}p.admonition-title{background-color:var(--color-admonition-title-background)}p.admonition-title:before{background-color:var(--color-admonition-title);-webkit-mask-image:var(--icon-admonition-default);mask-image:var(--icon-admonition-default);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat}p.topic-title{background-color:var(--color-topic-title-background)}p.topic-title:before{background-color:var(--color-topic-title);-webkit-mask-image:var(--icon-topic-default);mask-image:var(--icon-topic-default);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat}.admonition{border-left:.2rem solid var(--color-admonition-title)}.admonition.caution{border-left-color:var(--color-admonition-title--caution)}.admonition.caution>.admonition-title{background-color:var(--color-admonition-title-background--caution)}.admonition.caution>.admonition-title:before{background-color:var(--color-admonition-title--caution);-webkit-mask-image:var(--icon-spark);mask-image:var(--icon-spark)}.admonition.warning{border-left-color:var(--color-admonition-title--warning)}.admonition.warning>.admonition-title{background-color:var(--color-admonition-title-background--warning)}.admonition.warning>.admonition-title:before{background-color:var(--color-admonition-title--warning);-webkit-mask-image:var(--icon-warning);mask-image:var(--icon-warning)}.admonition.danger{border-left-color:var(--color-admonition-title--danger)}.admonition.danger>.admonition-title{background-color:var(--color-admonition-title-background--danger)}.admonition.danger>.admonition-title:before{background-color:var(--color-admonition-title--danger);-webkit-mask-image:var(--icon-spark);mask-image:var(--icon-spark)}.admonition.attention{border-left-color:var(--color-admonition-title--attention)}.admonition.attention>.admonition-title{background-color:var(--color-admonition-title-background--attention)}.admonition.attention>.admonition-title:before{background-color:var(--color-admonition-title--attention);-webkit-mask-image:var(--icon-warning);mask-image:var(--icon-warning)}.admonition.error{border-left-color:var(--color-admonition-title--error)}.admonition.error>.admonition-title{background-color:var(--color-admonition-title-background--error)}.admonition.error>.admonition-title:before{background-color:var(--color-admonition-title--error);-webkit-mask-image:var(--icon-failure);mask-image:var(--icon-failure)}.admonition.hint{border-left-color:var(--color-admonition-title--hint)}.admonition.hint>.admonition-title{background-color:var(--color-admonition-title-background--hint)}.admonition.hint>.admonition-title:before{background-color:var(--color-admonition-title--hint);-webkit-mask-image:var(--icon-question);mask-image:var(--icon-question)}.admonition.tip{border-left-color:var(--color-admonition-title--tip)}.admonition.tip>.admonition-title{background-color:var(--color-admonition-title-background--tip)}.admonition.tip>.admonition-title:before{background-color:var(--color-admonition-title--tip);-webkit-mask-image:var(--icon-info);mask-image:var(--icon-info)}.admonition.important{border-left-color:var(--color-admonition-title--important)}.admonition.important>.admonition-title{background-color:var(--color-admonition-title-background--important)}.admonition.important>.admonition-title:before{background-color:var(--color-admonition-title--important);-webkit-mask-image:var(--icon-flame);mask-image:var(--icon-flame)}.admonition.note{border-left-color:var(--color-admonition-title--note)}.admonition.note>.admonition-title{background-color:var(--color-admonition-title-background--note)}.admonition.note>.admonition-title:before{background-color:var(--color-admonition-title--note);-webkit-mask-image:var(--icon-pencil);mask-image:var(--icon-pencil)}.admonition.seealso{border-left-color:var(--color-admonition-title--seealso)}.admonition.seealso>.admonition-title{background-color:var(--color-admonition-title-background--seealso)}.admonition.seealso>.admonition-title:before{background-color:var(--color-admonition-title--seealso);-webkit-mask-image:var(--icon-info);mask-image:var(--icon-info)}.admonition.admonition-todo{border-left-color:var(--color-admonition-title--admonition-todo)}.admonition.admonition-todo>.admonition-title{background-color:var(--color-admonition-title-background--admonition-todo)}.admonition.admonition-todo>.admonition-title:before{background-color:var(--color-admonition-title--admonition-todo);-webkit-mask-image:var(--icon-pencil);mask-image:var(--icon-pencil)}.admonition-todo>.admonition-title{text-transform:uppercase}dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) dd{margin-left:2rem}dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) dd>:first-child{margin-top:.125rem}dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .field-list,dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) dd>:last-child{margin-bottom:.75rem}dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .field-list>dt{font-size:var(--font-size--small);text-transform:uppercase}dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .field-list dd:empty{margin-bottom:.5rem}dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .field-list dd>ul{margin-left:-1.2rem}dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .field-list dd>ul>li>p:nth-child(2){margin-top:0}dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .field-list dd>ul>li>p+p:last-child:empty{margin-bottom:0;margin-top:0}dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple)>dt{color:var(--color-api-overall)}.sig:not(.sig-inline){background:var(--color-api-background);border-radius:.25rem;font-family:var(--font-stack--monospace);font-size:var(--api-font-size);font-weight:700;margin-left:-.25rem;margin-right:-.25rem;padding:.25rem .5rem .25rem 3em;text-indent:-2.5em;transition:background .1s ease-out}.sig:not(.sig-inline):hover{background:var(--color-api-background-hover)}.sig:not(.sig-inline) a.reference .viewcode-link{font-weight:400;width:3.5rem}em.property{font-style:normal}em.property:first-child{color:var(--color-api-keyword)}.sig-name{color:var(--color-api-name)}.sig-prename{color:var(--color-api-pre-name);font-weight:400}.sig-paren{color:var(--color-api-paren)}.sig-param{font-style:normal}.versionmodified{font-style:italic}div.deprecated p,div.versionadded p,div.versionchanged p{margin-bottom:.125rem;margin-top:.125rem}.viewcode-back,.viewcode-link{float:right;text-align:right}.line-block{margin-bottom:.75rem;margin-top:.5rem}.line-block .line-block{margin-bottom:0;margin-top:0;padding-left:1rem}.code-block-caption,article p.caption,table>caption{font-size:var(--font-size--small);text-align:center}.toctree-wrapper.compound .caption,.toctree-wrapper.compound :not(.caption)>.caption-text{font-size:var(--font-size--small);margin-bottom:0;text-align:initial;text-transform:uppercase}.toctree-wrapper.compound>ul{margin-bottom:0;margin-top:0}.sig-inline,code.literal{background:var(--color-inline-code-background);border-radius:.2em;font-size:var(--font-size--small--2);padding:.1em .2em}pre.literal-block .sig-inline,pre.literal-block code.literal{font-size:inherit;padding:0}p .sig-inline,p code.literal{border:1px solid var(--color-background-border)}.sig-inline{font-family:var(--font-stack--monospace)}div[class*=" highlight-"],div[class^=highlight-]{display:flex;margin:1em 0}div[class*=" highlight-"] .table-wrapper,div[class^=highlight-] .table-wrapper,pre{margin:0;padding:0}pre{overflow:auto}article[role=main] .highlight pre{line-height:1.5}.highlight pre,pre.literal-block{font-size:var(--code-font-size);padding:.625rem .875rem}pre.literal-block{background-color:var(--color-code-background);border-radius:.2rem;color:var(--color-code-foreground);margin-bottom:1rem;margin-top:1rem}.highlight{border-radius:.2rem;width:100%}.highlight .gp,.highlight span.linenos{pointer-events:none;-webkit-user-select:none;-moz-user-select:none;user-select:none}.highlight .hll{display:block;margin-left:-.875rem;margin-right:-.875rem;padding-left:.875rem;padding-right:.875rem}.code-block-caption{background-color:var(--color-code-background);border-bottom:1px solid;border-radius:.25rem;border-bottom-left-radius:0;border-bottom-right-radius:0;border-color:var(--color-background-border);color:var(--color-code-foreground);display:flex;font-weight:300;padding:.625rem .875rem}.code-block-caption+div[class]{margin-top:0}.code-block-caption+div[class] pre{border-top-left-radius:0;border-top-right-radius:0}.highlighttable{display:block;width:100%}.highlighttable tbody{display:block}.highlighttable tr{display:flex}.highlighttable td.linenos{background-color:var(--color-code-background);border-bottom-left-radius:.2rem;border-top-left-radius:.2rem;color:var(--color-code-foreground);padding:.625rem 0 .625rem .875rem}.highlighttable .linenodiv{box-shadow:-.0625rem 0 var(--color-foreground-border) inset;font-size:var(--code-font-size);padding-right:.875rem}.highlighttable td.code{display:block;flex:1;overflow:hidden;padding:0}.highlighttable td.code .highlight{border-bottom-left-radius:0;border-top-left-radius:0}.highlight span.linenos{box-shadow:-.0625rem 0 var(--color-foreground-border) inset;display:inline-block;margin-right:.875rem;padding-left:0;padding-right:.875rem}.footnote-reference{font-size:var(--font-size--small--4);vertical-align:super}dl.footnote.brackets{color:var(--color-foreground-secondary);display:grid;font-size:var(--font-size--small);grid-template-columns:max-content auto}dl.footnote.brackets dt{margin:0}dl.footnote.brackets dt>.fn-backref{margin-left:.25rem}dl.footnote.brackets dt:after{content:":"}dl.footnote.brackets dt .brackets:before{content:"["}dl.footnote.brackets dt .brackets:after{content:"]"}dl.footnote.brackets dd{margin:0;padding:0 1rem}aside.footnote{color:var(--color-foreground-secondary);font-size:var(--font-size--small)}aside.footnote>span,div.citation>span{float:left;font-weight:500;padding-right:.25rem}aside.footnote>p,div.citation>p{margin-left:2rem}img{box-sizing:border-box;height:auto;max-width:100%}article .figure,article figure{border-radius:.2rem;margin:0}article .figure :last-child,article figure :last-child{margin-bottom:0}article .align-left{clear:left;float:left;margin:0 1rem 1rem}article .align-right{clear:right;float:right;margin:0 1rem 1rem}article .align-center,article .align-default{display:block;margin-left:auto;margin-right:auto;text-align:center}article table.align-default{display:table;text-align:initial}.domainindex-jumpbox,.genindex-jumpbox{border-bottom:1px solid var(--color-background-border);border-top:1px solid var(--color-background-border);padding:.25rem}.domainindex-section h2,.genindex-section h2{margin-bottom:.5rem;margin-top:.75rem}.domainindex-section ul,.genindex-section ul{margin-bottom:0;margin-top:0}ol,ul{margin-bottom:1rem;margin-top:1rem;padding-left:1.2rem}ol li>p:first-child,ul li>p:first-child{margin-bottom:.25rem;margin-top:.25rem}ol li>p:last-child,ul li>p:last-child{margin-top:.25rem}ol li>ol,ol li>ul,ul li>ol,ul li>ul{margin-bottom:.5rem;margin-top:.5rem}ol.arabic{list-style:decimal}ol.loweralpha{list-style:lower-alpha}ol.upperalpha{list-style:upper-alpha}ol.lowerroman{list-style:lower-roman}ol.upperroman{list-style:upper-roman}.simple li>ol,.simple li>ul,.toctree-wrapper li>ol,.toctree-wrapper li>ul{margin-bottom:0;margin-top:0}.field-list dt,.option-list dt,dl.footnote dt,dl.glossary dt,dl.simple dt,dl:not([class]) dt{font-weight:500;margin-top:.25rem}.field-list dt+dt,.option-list dt+dt,dl.footnote dt+dt,dl.glossary dt+dt,dl.simple dt+dt,dl:not([class]) dt+dt{margin-top:0}.field-list dt .classifier:before,.option-list dt .classifier:before,dl.footnote dt .classifier:before,dl.glossary dt .classifier:before,dl.simple dt .classifier:before,dl:not([class]) dt .classifier:before{content:":";margin-left:.2rem;margin-right:.2rem}.field-list dd ul,.field-list dd>p:first-child,.option-list dd ul,.option-list dd>p:first-child,dl.footnote dd ul,dl.footnote dd>p:first-child,dl.glossary dd ul,dl.glossary dd>p:first-child,dl.simple dd ul,dl.simple dd>p:first-child,dl:not([class]) dd ul,dl:not([class]) dd>p:first-child{margin-top:.125rem}.field-list dd ul,.option-list dd ul,dl.footnote dd ul,dl.glossary dd ul,dl.simple dd ul,dl:not([class]) dd ul{margin-bottom:.125rem}.math-wrapper{overflow-x:auto;width:100%}div.math{position:relative;text-align:center}div.math .headerlink,div.math:focus .headerlink{display:none}div.math:hover .headerlink{display:inline-block}div.math span.eqno{position:absolute;right:.5rem;top:50%;transform:translateY(-50%);z-index:1}abbr[title]{cursor:help}.problematic{color:var(--color-problematic)}kbd:not(.compound){background-color:var(--color-background-secondary);border:1px solid var(--color-foreground-border);border-radius:.2rem;box-shadow:0 .0625rem 0 rgba(0,0,0,.2),inset 0 0 0 .125rem var(--color-background-primary);color:var(--color-foreground-primary);display:inline-block;font-size:var(--font-size--small--3);margin:0 .2rem;padding:0 .2rem;vertical-align:text-bottom}blockquote{background:var(--color-background-secondary);border-left:4px solid var(--color-background-border);margin-left:0;margin-right:0;padding:.5rem 1rem}blockquote .attribution{font-weight:600;text-align:right}blockquote.highlights,blockquote.pull-quote{font-size:1.25em}blockquote.epigraph,blockquote.pull-quote{border-left-width:0;border-radius:.5rem}blockquote.highlights{background:transparent;border-left-width:0}p .reference img{vertical-align:middle}p.rubric{font-size:1.125em;font-weight:700;line-height:1.25}dd p.rubric{font-size:var(--font-size--small);font-weight:inherit;line-height:inherit;text-transform:uppercase}article .sidebar{background-color:var(--color-background-secondary);border:1px solid var(--color-background-border);border-radius:.2rem;clear:right;float:right;margin-left:1rem;margin-right:0;width:30%}article .sidebar>*{padding-left:1rem;padding-right:1rem}article .sidebar>ol,article .sidebar>ul{padding-left:2.2rem}article .sidebar .sidebar-title{border-bottom:1px solid var(--color-background-border);font-weight:500;margin:0;padding:.5rem 1rem}.table-wrapper{margin-bottom:.5rem;margin-top:1rem;overflow-x:auto;padding:.2rem .2rem .75rem;width:100%}table.docutils{border-collapse:collapse;border-radius:.2rem;border-spacing:0;box-shadow:0 .2rem .5rem rgba(0,0,0,.05),0 0 .0625rem rgba(0,0,0,.1)}table.docutils th{background:var(--color-table-header-background)}table.docutils td,table.docutils th{border-bottom:1px solid var(--color-table-border);border-left:1px solid var(--color-table-border);border-right:1px solid var(--color-table-border);padding:0 .25rem}table.docutils td p,table.docutils th p{margin:.25rem}table.docutils td:first-child,table.docutils th:first-child{border-left:none}table.docutils td:last-child,table.docutils th:last-child{border-right:none}table.docutils td.text-left,table.docutils th.text-left{text-align:left}table.docutils td.text-right,table.docutils th.text-right{text-align:right}table.docutils td.text-center,table.docutils th.text-center{text-align:center}:target{scroll-margin-top:.5rem}@media(max-width:67em){:target{scroll-margin-top:calc(.5rem + var(--header-height))}section>span:target{scroll-margin-top:calc(.8rem + var(--header-height))}}.headerlink{font-weight:100;-webkit-user-select:none;-moz-user-select:none;user-select:none}.code-block-caption>.headerlink,dl dt>.headerlink,figcaption p>.headerlink,h1>.headerlink,h2>.headerlink,h3>.headerlink,h4>.headerlink,h5>.headerlink,h6>.headerlink,p.caption>.headerlink,table>caption>.headerlink{margin-left:.5rem;visibility:hidden}.code-block-caption:hover>.headerlink,dl dt:hover>.headerlink,figcaption p:hover>.headerlink,h1:hover>.headerlink,h2:hover>.headerlink,h3:hover>.headerlink,h4:hover>.headerlink,h5:hover>.headerlink,h6:hover>.headerlink,p.caption:hover>.headerlink,table>caption:hover>.headerlink{visibility:visible}.code-block-caption>.toc-backref,dl dt>.toc-backref,figcaption p>.toc-backref,h1>.toc-backref,h2>.toc-backref,h3>.toc-backref,h4>.toc-backref,h5>.toc-backref,h6>.toc-backref,p.caption>.toc-backref,table>caption>.toc-backref{color:inherit;text-decoration-line:none}figure:hover>figcaption>p>.headerlink,table:hover>caption>.headerlink{visibility:visible}:target>h1:first-of-type,:target>h2:first-of-type,:target>h3:first-of-type,:target>h4:first-of-type,:target>h5:first-of-type,:target>h6:first-of-type,span:target~h1:first-of-type,span:target~h2:first-of-type,span:target~h3:first-of-type,span:target~h4:first-of-type,span:target~h5:first-of-type,span:target~h6:first-of-type{background-color:var(--color-highlight-on-target)}:target>h1:first-of-type code.literal,:target>h2:first-of-type code.literal,:target>h3:first-of-type code.literal,:target>h4:first-of-type code.literal,:target>h5:first-of-type code.literal,:target>h6:first-of-type code.literal,span:target~h1:first-of-type code.literal,span:target~h2:first-of-type code.literal,span:target~h3:first-of-type code.literal,span:target~h4:first-of-type code.literal,span:target~h5:first-of-type code.literal,span:target~h6:first-of-type code.literal{background-color:transparent}.literal-block-wrapper:target .code-block-caption,.this-will-duplicate-information-and-it-is-still-useful-here li :target,figure:target,table:target>caption{background-color:var(--color-highlight-on-target)}dt:target{background-color:var(--color-highlight-on-target)!important}.footnote-reference:target,.footnote>dt:target+dd{background-color:var(--color-highlight-on-target)}.guilabel{background-color:var(--color-guilabel-background);border:1px solid var(--color-guilabel-border);border-radius:.5em;color:var(--color-guilabel-text);font-size:.9em;padding:0 .3em}footer{display:flex;flex-direction:column;font-size:var(--font-size--small);margin-top:2rem}.bottom-of-page{align-items:center;border-top:1px solid var(--color-background-border);color:var(--color-foreground-secondary);display:flex;justify-content:space-between;line-height:1.5;margin-top:1rem;padding-bottom:1rem;padding-top:1rem}@media(max-width:46em){.bottom-of-page{flex-direction:column-reverse;gap:.25rem;text-align:center}}.bottom-of-page .left-details{font-size:var(--font-size--small)}.bottom-of-page .right-details{display:flex;flex-direction:column;gap:.25rem;text-align:right}.bottom-of-page .icons{display:flex;font-size:1rem;gap:.25rem;justify-content:flex-end}.bottom-of-page .icons a{text-decoration:none}.bottom-of-page .icons img,.bottom-of-page .icons svg{font-size:1.125rem;height:1em;width:1em}.related-pages a{align-items:center;display:flex;text-decoration:none}.related-pages a:hover .page-info .title{color:var(--color-link);text-decoration:underline;text-decoration-color:var(--color-link-underline)}.related-pages a svg.furo-related-icon,.related-pages a svg.furo-related-icon>use{color:var(--color-foreground-border);flex-shrink:0;height:.75rem;margin:0 .5rem;width:.75rem}.related-pages a.next-page{clear:right;float:right;max-width:50%;text-align:right}.related-pages a.prev-page{clear:left;float:left;max-width:50%}.related-pages a.prev-page svg{transform:rotate(180deg)}.page-info{display:flex;flex-direction:column;overflow-wrap:anywhere}.next-page .page-info{align-items:flex-end}.page-info .context{align-items:center;color:var(--color-foreground-muted);display:flex;font-size:var(--font-size--small);padding-bottom:.1rem;text-decoration:none}ul.search{list-style:none;padding-left:0}ul.search li{border-bottom:1px solid var(--color-background-border);padding:1rem 0}[role=main] .highlighted{background-color:var(--color-highlighted-background);color:var(--color-highlighted-text)}.sidebar-brand{display:flex;flex-direction:column;flex-shrink:0;padding:var(--sidebar-item-spacing-vertical) var(--sidebar-item-spacing-horizontal);text-decoration:none}.sidebar-brand-text{color:var(--color-sidebar-brand-text);font-size:1.5rem;overflow-wrap:break-word}.sidebar-brand-text,.sidebar-logo-container{margin:var(--sidebar-item-spacing-vertical) 0}.sidebar-logo{display:block;margin:0 auto;max-width:100%}.sidebar-search-container{align-items:center;background:var(--color-sidebar-search-background);display:flex;margin-top:var(--sidebar-search-space-above);position:relative}.sidebar-search-container:focus-within,.sidebar-search-container:hover{background:var(--color-sidebar-search-background--focus)}.sidebar-search-container:before{background-color:var(--color-sidebar-search-icon);content:"";height:var(--sidebar-search-icon-size);left:var(--sidebar-item-spacing-horizontal);-webkit-mask-image:var(--icon-search);mask-image:var(--icon-search);position:absolute;width:var(--sidebar-search-icon-size)}.sidebar-search{background:transparent;border:none;border-bottom:1px solid var(--color-sidebar-search-border);border-top:1px solid var(--color-sidebar-search-border);box-sizing:border-box;color:var(--color-sidebar-search-foreground);padding:var(--sidebar-search-input-spacing-vertical) var(--sidebar-search-input-spacing-horizontal) var(--sidebar-search-input-spacing-vertical) calc(var(--sidebar-item-spacing-horizontal) + var(--sidebar-search-input-spacing-horizontal) + var(--sidebar-search-icon-size));width:100%;z-index:10}.sidebar-search:focus{outline:none}.sidebar-search::-moz-placeholder{font-size:var(--sidebar-search-input-font-size)}.sidebar-search::placeholder{font-size:var(--sidebar-search-input-font-size)}#searchbox .highlight-link{margin:0;padding:var(--sidebar-item-spacing-vertical) var(--sidebar-item-spacing-horizontal) 0;text-align:center}#searchbox .highlight-link a{color:var(--color-sidebar-search-icon);font-size:var(--font-size--small--2)}.sidebar-tree{font-size:var(--sidebar-item-font-size);margin-bottom:var(--sidebar-item-spacing-vertical);margin-top:var(--sidebar-tree-space-above)}.sidebar-tree ul{display:flex;flex-direction:column;list-style:none;margin-bottom:0;margin-top:0;padding:0}.sidebar-tree li{margin:0;position:relative}.sidebar-tree li>ul{margin-left:var(--sidebar-item-spacing-horizontal)}.sidebar-tree .icon,.sidebar-tree .reference{color:var(--color-sidebar-link-text)}.sidebar-tree .reference{box-sizing:border-box;display:inline-block;height:100%;line-height:var(--sidebar-item-line-height);overflow-wrap:anywhere;padding:var(--sidebar-item-spacing-vertical) var(--sidebar-item-spacing-horizontal);text-decoration:none;width:100%}.sidebar-tree .reference:hover{background:var(--color-sidebar-item-background--hover)}.sidebar-tree .reference.external:after{color:var(--color-sidebar-link-text);content:url("data:image/svg+xml;charset=utf-8,%3Csvg width='12' height='12' xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' stroke-width='1.5' stroke='%23607D8B' fill='none' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M0 0h24v24H0z' stroke='none'/%3E%3Cpath d='M11 7H6a2 2 0 0 0-2 2v9a2 2 0 0 0 2 2h9a2 2 0 0 0 2-2v-5M10 14 20 4M15 4h5v5'/%3E%3C/svg%3E");margin:0 .25rem;vertical-align:middle}.sidebar-tree .current-page>.reference{font-weight:700}.sidebar-tree label{align-items:center;cursor:pointer;display:flex;height:var(--sidebar-item-height);justify-content:center;position:absolute;right:0;top:0;-webkit-user-select:none;-moz-user-select:none;user-select:none;width:var(--sidebar-expander-width)}.sidebar-tree .caption,.sidebar-tree :not(.caption)>.caption-text{color:var(--color-sidebar-caption-text);font-size:var(--sidebar-caption-font-size);font-weight:700;margin:var(--sidebar-caption-space-above) 0 0 0;padding:var(--sidebar-item-spacing-vertical) var(--sidebar-item-spacing-horizontal);text-transform:uppercase}.sidebar-tree li.has-children>.reference{padding-right:var(--sidebar-expander-width)}.sidebar-tree .toctree-l1>.reference,.sidebar-tree .toctree-l1>label .icon{color:var(--color-sidebar-link-text--top-level)}.sidebar-tree label{background:var(--color-sidebar-item-expander-background)}.sidebar-tree label:hover{background:var(--color-sidebar-item-expander-background--hover)}.sidebar-tree .current>.reference{background:var(--color-sidebar-item-background--current)}.sidebar-tree .current>.reference:hover{background:var(--color-sidebar-item-background--hover)}.toctree-checkbox{display:none;position:absolute}.toctree-checkbox~ul{display:none}.toctree-checkbox~label .icon svg{transform:rotate(90deg)}.toctree-checkbox:checked~ul{display:block}.toctree-checkbox:checked~label .icon svg{transform:rotate(-90deg)}.toc-title-container{padding:var(--toc-title-padding);padding-top:var(--toc-spacing-vertical)}.toc-title{color:var(--color-toc-title-text);font-size:var(--toc-title-font-size);padding-left:var(--toc-spacing-horizontal);text-transform:uppercase}.no-toc{display:none}.toc-tree-container{padding-bottom:var(--toc-spacing-vertical)}.toc-tree{border-left:1px solid var(--color-background-border);font-size:var(--toc-font-size);line-height:1.3;padding-left:calc(var(--toc-spacing-horizontal) - var(--toc-item-spacing-horizontal))}.toc-tree>ul>li:first-child{padding-top:0}.toc-tree>ul>li:first-child>ul{padding-left:0}.toc-tree>ul>li:first-child>a{display:none}.toc-tree ul{list-style-type:none;margin-bottom:0;margin-top:0;padding-left:var(--toc-item-spacing-horizontal)}.toc-tree li{padding-top:var(--toc-item-spacing-vertical)}.toc-tree li.scroll-current>.reference{color:var(--color-toc-item-text--active);font-weight:700}.toc-tree .reference{color:var(--color-toc-item-text);overflow-wrap:anywhere;text-decoration:none}.toc-scroll{max-height:100vh;overflow-y:scroll}.contents:not(.this-will-duplicate-information-and-it-is-still-useful-here){background:rgba(255,0,0,.25);color:var(--color-problematic)}.contents:not(.this-will-duplicate-information-and-it-is-still-useful-here):before{content:"ERROR: Adding a table of contents in Furo-based documentation is unnecessary, and does not work well with existing styling.Add a 'this-will-duplicate-information-and-it-is-still-useful-here' class, if you want an escape hatch."}.text-align\:left>p{text-align:left}.text-align\:center>p{text-align:center}.text-align\:right>p{text-align:right} +/*# sourceMappingURL=furo.css.map*/ \ No newline at end of file diff --git a/docs/_build/html/_static/styles/furo.css.map b/docs/_build/html/_static/styles/furo.css.map new file mode 100644 index 0000000..1924b33 --- /dev/null +++ b/docs/_build/html/_static/styles/furo.css.map @@ -0,0 +1 @@ +{"version":3,"file":"styles/furo.css","mappings":"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F,kBACA,CACE,wEACA,CARA,YACA,CAKF,mBAFF,MACE,CAIE,gBAJF,iCAJE,cAGJ,CANI,oBAEA,CAKF,SAIE,2BADA,UACA,kBAGF,sCACA,CAFF,WACE,WACA,mBACE,kDACA,0EACA,uDAKJ,aACE,mDAII,CAJJ,6CAII,4BACA,sCACE,kEACA,+CACE,aACA,WADA,+BACA,uEANN,YACE,mDAEE,mBADF,0CACE,CADF,qBACE,0DACA,YACE,4DACA,sEANN,YACE,8CACA,kBADA,UACA,2CACE,2EACA,cACE,kEACA,mEANN,yBACE,4DACA,sBACE,+EAEE,iEACA,qEANN,sCACE,CAGE,iBAHF,gBAGE,qBACE,CAJJ,uBACA,gDACE,wDACA,6DAHF,2CACA,CADA,gBACA,eACE,CAGE,sBANN,8BACE,CAII,iBAFF,4DACA,WACE,YADF,uCACE,6EACA,2BANN,8CACE,kDACA,0CACE,8BACA,yFACE,sBACA,sFALJ,mEACA,sBACE,kEACA,6EACE,uCACA,kEALJ,qGAEE,kEACA,6EACE,uCACA,kEALJ,8CACA,uDACE,sEACA,2EACE,sCACA,iEALJ,mGACA,qCACE,oDACA,0DACE,6GACA,gDAGR,yDCrEA,sEACE,CACA,6GACE,gEACF,iGAIF,wFACE,qDAGA,mGAEE,2CAEF,4FACE,gCACF,wGACE,8DAEE,6FAIA,iJAKN,6GACE,gDAKF,yDACA,qCAGA,6BACA,kBACA,qDAKA,oCAEA,+DAGA,2CAGE,oDAIA,oEAEE,qBAGJ,wDAEE,uCAEF,kEAGA,8CAEA,uDAKA,oCAEA,yDAEE,gEAKF,+CC5FA,0EAGE,CACA,qDCLJ,+DAIE,sCAIA,kEACE,yBACA,2FAMA,gBACA,yGCbF,mBAOA,2MAIA,4HAYA,0DACE,8GAYF,8HAQE,mBAEA,6HAOF,YAGA,mIAME,eACA,CAFF,YAEE,4FAMJ,8BAEE,uBAYA,sCAEE,CAJF,oBAEA,CARA,wCAEA,CAHA,8BACA,CAFA,eACA,CAGA,wCAEA,CAEA,mDAIE,kCACE,6BACA,4CAKJ,kDAIA,eACE,aAGF,8BACE,uDACA,sCACA,cAEA,+BACA,CA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","sources":["webpack:///./node_modules/normalize.css/normalize.css","webpack:///./src/furo/assets/styles/base/_print.sass","webpack:///./src/furo/assets/styles/base/_screen-readers.sass","webpack:///./src/furo/assets/styles/base/_theme.sass","webpack:///./src/furo/assets/styles/variables/_fonts.scss","webpack:///./src/furo/assets/styles/variables/_spacing.scss","webpack:///./src/furo/assets/styles/variables/_icons.scss","webpack:///./src/furo/assets/styles/variables/_admonitions.scss","webpack:///./src/furo/assets/styles/variables/_colors.scss","webpack:///./src/furo/assets/styles/base/_typography.sass","webpack:///./src/furo/assets/styles/_scaffold.sass","webpack:///./src/furo/assets/styles/content/_admonitions.sass","webpack:///./src/furo/assets/styles/content/_api.sass","webpack:///./src/furo/assets/styles/content/_blocks.sass","webpack:///./src/furo/assets/styles/content/_captions.sass","webpack:///./src/furo/assets/styles/content/_code.sass","webpack:///./src/furo/assets/styles/content/_footnotes.sass","webpack:///./src/furo/assets/styles/content/_images.sass","webpack:///./src/furo/assets/styles/content/_indexes.sass","webpack:///./src/furo/assets/styles/content/_lists.sass","webpack:///./src/furo/assets/styles/content/_math.sass","webpack:///./src/furo/assets/styles/content/_misc.sass","webpack:///./src/furo/assets/styles/content/_rubrics.sass","webpack:///./src/furo/assets/styles/content/_sidebar.sass","webpack:///./src/furo/assets/styles/content/_tables.sass","webpack:///./src/furo/assets/styles/content/_target.sass","webpack:///./src/furo/assets/styles/content/_gui-labels.sass","webpack:///./src/furo/assets/styles/components/_footer.sass","webpack:///./src/furo/assets/styles/components/_sidebar.sass","webpack:///./src/furo/assets/styles/components/_table_of_contents.sass","webpack:///./src/furo/assets/styles/_shame.sass"],"sourcesContent":["/*! normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css */\n\n/* Document\n ========================================================================== */\n\n/**\n * 1. Correct the line height in all browsers.\n * 2. Prevent adjustments of font size after orientation changes in iOS.\n */\n\nhtml {\n line-height: 1.15; /* 1 */\n -webkit-text-size-adjust: 100%; /* 2 */\n}\n\n/* Sections\n ========================================================================== */\n\n/**\n * Remove the margin in all browsers.\n */\n\nbody {\n margin: 0;\n}\n\n/**\n * Render the `main` element consistently in IE.\n */\n\nmain {\n display: block;\n}\n\n/**\n * Correct the font size and margin on `h1` elements within `section` and\n * `article` contexts in Chrome, Firefox, and Safari.\n */\n\nh1 {\n font-size: 2em;\n margin: 0.67em 0;\n}\n\n/* Grouping content\n ========================================================================== */\n\n/**\n * 1. Add the correct box sizing in Firefox.\n * 2. Show the overflow in Edge and IE.\n */\n\nhr {\n box-sizing: content-box; /* 1 */\n height: 0; /* 1 */\n overflow: visible; /* 2 */\n}\n\n/**\n * 1. Correct the inheritance and scaling of font size in all browsers.\n * 2. Correct the odd `em` font sizing in all browsers.\n */\n\npre {\n font-family: monospace, monospace; /* 1 */\n font-size: 1em; /* 2 */\n}\n\n/* Text-level semantics\n ========================================================================== */\n\n/**\n * Remove the gray background on active links in IE 10.\n */\n\na {\n background-color: transparent;\n}\n\n/**\n * 1. Remove the bottom border in Chrome 57-\n * 2. Add the correct text decoration in Chrome, Edge, IE, Opera, and Safari.\n */\n\nabbr[title] {\n border-bottom: none; /* 1 */\n text-decoration: underline; /* 2 */\n text-decoration: underline dotted; /* 2 */\n}\n\n/**\n * Add the correct font weight in Chrome, Edge, and Safari.\n */\n\nb,\nstrong {\n font-weight: bolder;\n}\n\n/**\n * 1. Correct the inheritance and scaling of font size in all browsers.\n * 2. Correct the odd `em` font sizing in all browsers.\n */\n\ncode,\nkbd,\nsamp {\n font-family: monospace, monospace; /* 1 */\n font-size: 1em; /* 2 */\n}\n\n/**\n * Add the correct font size in all browsers.\n */\n\nsmall {\n font-size: 80%;\n}\n\n/**\n * Prevent `sub` and `sup` elements from affecting the line height in\n * all browsers.\n */\n\nsub,\nsup {\n font-size: 75%;\n line-height: 0;\n position: relative;\n vertical-align: baseline;\n}\n\nsub {\n bottom: -0.25em;\n}\n\nsup {\n top: -0.5em;\n}\n\n/* Embedded content\n ========================================================================== */\n\n/**\n * Remove the border on images inside links in IE 10.\n */\n\nimg {\n border-style: none;\n}\n\n/* Forms\n ========================================================================== */\n\n/**\n * 1. Change the font styles in all browsers.\n * 2. Remove the margin in Firefox and Safari.\n */\n\nbutton,\ninput,\noptgroup,\nselect,\ntextarea {\n font-family: inherit; /* 1 */\n font-size: 100%; /* 1 */\n line-height: 1.15; /* 1 */\n margin: 0; /* 2 */\n}\n\n/**\n * Show the overflow in IE.\n * 1. Show the overflow in Edge.\n */\n\nbutton,\ninput { /* 1 */\n overflow: visible;\n}\n\n/**\n * Remove the inheritance of text transform in Edge, Firefox, and IE.\n * 1. Remove the inheritance of text transform in Firefox.\n */\n\nbutton,\nselect { /* 1 */\n text-transform: none;\n}\n\n/**\n * Correct the inability to style clickable types in iOS and Safari.\n */\n\nbutton,\n[type=\"button\"],\n[type=\"reset\"],\n[type=\"submit\"] {\n -webkit-appearance: button;\n}\n\n/**\n * Remove the inner border and padding in Firefox.\n */\n\nbutton::-moz-focus-inner,\n[type=\"button\"]::-moz-focus-inner,\n[type=\"reset\"]::-moz-focus-inner,\n[type=\"submit\"]::-moz-focus-inner {\n border-style: none;\n padding: 0;\n}\n\n/**\n * Restore the focus styles unset by the previous rule.\n */\n\nbutton:-moz-focusring,\n[type=\"button\"]:-moz-focusring,\n[type=\"reset\"]:-moz-focusring,\n[type=\"submit\"]:-moz-focusring {\n outline: 1px dotted ButtonText;\n}\n\n/**\n * Correct the padding in Firefox.\n */\n\nfieldset {\n padding: 0.35em 0.75em 0.625em;\n}\n\n/**\n * 1. Correct the text wrapping in Edge and IE.\n * 2. Correct the color inheritance from `fieldset` elements in IE.\n * 3. Remove the padding so developers are not caught out when they zero out\n * `fieldset` elements in all browsers.\n */\n\nlegend {\n box-sizing: border-box; /* 1 */\n color: inherit; /* 2 */\n display: table; /* 1 */\n max-width: 100%; /* 1 */\n padding: 0; /* 3 */\n white-space: normal; /* 1 */\n}\n\n/**\n * Add the correct vertical alignment in Chrome, Firefox, and Opera.\n */\n\nprogress {\n vertical-align: baseline;\n}\n\n/**\n * Remove the default vertical scrollbar in IE 10+.\n */\n\ntextarea {\n overflow: auto;\n}\n\n/**\n * 1. Add the correct box sizing in IE 10.\n * 2. Remove the padding in IE 10.\n */\n\n[type=\"checkbox\"],\n[type=\"radio\"] {\n box-sizing: border-box; /* 1 */\n padding: 0; /* 2 */\n}\n\n/**\n * Correct the cursor style of increment and decrement buttons in Chrome.\n */\n\n[type=\"number\"]::-webkit-inner-spin-button,\n[type=\"number\"]::-webkit-outer-spin-button {\n height: auto;\n}\n\n/**\n * 1. Correct the odd appearance in Chrome and Safari.\n * 2. Correct the outline style in Safari.\n */\n\n[type=\"search\"] {\n -webkit-appearance: textfield; /* 1 */\n outline-offset: -2px; /* 2 */\n}\n\n/**\n * Remove the inner padding in Chrome and Safari on macOS.\n */\n\n[type=\"search\"]::-webkit-search-decoration {\n -webkit-appearance: none;\n}\n\n/**\n * 1. Correct the inability to style clickable types in iOS and Safari.\n * 2. Change font properties to `inherit` in Safari.\n */\n\n::-webkit-file-upload-button {\n -webkit-appearance: button; /* 1 */\n font: inherit; /* 2 */\n}\n\n/* Interactive\n ========================================================================== */\n\n/*\n * Add the correct display in Edge, IE 10+, and Firefox.\n */\n\ndetails {\n display: block;\n}\n\n/*\n * Add the correct display in all browsers.\n */\n\nsummary {\n display: list-item;\n}\n\n/* Misc\n ========================================================================== */\n\n/**\n * Add the correct display in IE 10+.\n */\n\ntemplate {\n display: none;\n}\n\n/**\n * Add the correct display in IE 10.\n */\n\n[hidden] {\n display: none;\n}\n","// This file contains styles for managing print media.\n\n////////////////////////////////////////////////////////////////////////////////\n// Hide elements not relevant to print media.\n////////////////////////////////////////////////////////////////////////////////\n@media print\n // Hide icon container.\n .content-icon-container\n display: none !important\n\n // Hide showing header links if hovering over when printing.\n .headerlink\n display: none !important\n\n // Hide mobile header.\n .mobile-header\n display: none !important\n\n // Hide navigation links.\n .related-pages\n display: none !important\n\n////////////////////////////////////////////////////////////////////////////////\n// Tweaks related to decolorization.\n////////////////////////////////////////////////////////////////////////////////\n@media print\n // Apply a border around code which no longer have a color background.\n .highlight\n border: 0.1pt solid var(--color-foreground-border)\n\n////////////////////////////////////////////////////////////////////////////////\n// Avoid page break in some relevant cases.\n////////////////////////////////////////////////////////////////////////////////\n@media print\n ul, ol, dl, a, table, pre, blockquote\n page-break-inside: avoid\n\n h1, h2, h3, h4, h5, h6, img, figure, caption\n page-break-inside: avoid\n page-break-after: avoid\n\n ul, ol, dl\n page-break-before: avoid\n",".visually-hidden\n position: absolute !important\n width: 1px !important\n height: 1px !important\n padding: 0 !important\n margin: -1px !important\n overflow: hidden !important\n clip: rect(0,0,0,0) !important\n white-space: nowrap !important\n border: 0 !important\n\n:-moz-focusring\n outline: auto\n","// This file serves as the \"skeleton\" of the theming logic.\n//\n// This contains the bulk of the logic for handling dark mode, color scheme\n// toggling and the handling of color-scheme-specific hiding of elements.\n\nbody\n @include fonts\n @include spacing\n @include icons\n @include admonitions\n @include default-admonition(#651fff, \"abstract\")\n @include default-topic(#14B8A6, \"pencil\")\n\n @include colors\n\n.only-light\n display: block !important\nhtml body .only-dark\n display: none !important\n\n// Ignore dark-mode hints if print media.\n@media not print\n // Enable dark-mode, if requested.\n body[data-theme=\"dark\"]\n @include colors-dark\n\n html & .only-light\n display: none !important\n .only-dark\n display: block !important\n\n // Enable dark mode, unless explicitly told to avoid.\n @media (prefers-color-scheme: dark)\n body:not([data-theme=\"light\"])\n @include colors-dark\n\n html & .only-light\n display: none !important\n .only-dark\n display: block !important\n\n//\n// Theme toggle presentation\n//\nbody[data-theme=\"auto\"]\n .theme-toggle svg.theme-icon-when-auto\n display: block\n\nbody[data-theme=\"dark\"]\n .theme-toggle svg.theme-icon-when-dark\n display: block\n\nbody[data-theme=\"light\"]\n .theme-toggle svg.theme-icon-when-light\n display: block\n","// Fonts used by this theme.\n//\n// There are basically two things here -- using the system font stack and\n// defining sizes for various elements in %ages. We could have also used `em`\n// but %age is easier to reason about for me.\n\n@mixin fonts {\n // These are adapted from https://systemfontstack.com/\n --font-stack: -apple-system, BlinkMacSystemFont, Segoe UI, Helvetica, Arial,\n sans-serif, Apple Color Emoji, Segoe UI Emoji;\n --font-stack--monospace: \"SFMono-Regular\", Menlo, Consolas, Monaco,\n Liberation Mono, Lucida Console, monospace;\n\n --font-size--normal: 100%;\n --font-size--small: 87.5%;\n --font-size--small--2: 81.25%;\n --font-size--small--3: 75%;\n --font-size--small--4: 62.5%;\n\n // Sidebar\n --sidebar-caption-font-size: var(--font-size--small--2);\n --sidebar-item-font-size: var(--font-size--small);\n --sidebar-search-input-font-size: var(--font-size--small);\n\n // Table of Contents\n --toc-font-size: var(--font-size--small--3);\n --toc-font-size--mobile: var(--font-size--normal);\n --toc-title-font-size: var(--font-size--small--4);\n\n // Admonitions\n //\n // These aren't defined in terms of %ages, since nesting these is permitted.\n --admonition-font-size: 0.8125rem;\n --admonition-title-font-size: 0.8125rem;\n\n // Code\n --code-font-size: var(--font-size--small--2);\n\n // API\n --api-font-size: var(--font-size--small);\n}\n","// Spacing for various elements on the page\n//\n// If the user wants to tweak things in a certain way, they are permitted to.\n// They also have to deal with the consequences though!\n\n@mixin spacing {\n // Header!\n --header-height: calc(\n var(--sidebar-item-line-height) + 4 * #{var(--sidebar-item-spacing-vertical)}\n );\n --header-padding: 0.5rem;\n\n // Sidebar\n --sidebar-tree-space-above: 1.5rem;\n --sidebar-caption-space-above: 1rem;\n\n --sidebar-item-line-height: 1rem;\n --sidebar-item-spacing-vertical: 0.5rem;\n --sidebar-item-spacing-horizontal: 1rem;\n --sidebar-item-height: calc(\n var(--sidebar-item-line-height) + 2 *#{var(--sidebar-item-spacing-vertical)}\n );\n\n --sidebar-expander-width: var(--sidebar-item-height); // be square\n\n --sidebar-search-space-above: 0.5rem;\n --sidebar-search-input-spacing-vertical: 0.5rem;\n --sidebar-search-input-spacing-horizontal: 0.5rem;\n --sidebar-search-input-height: 1rem;\n --sidebar-search-icon-size: var(--sidebar-search-input-height);\n\n // Table of Contents\n --toc-title-padding: 0.25rem 0;\n --toc-spacing-vertical: 1.5rem;\n --toc-spacing-horizontal: 1.5rem;\n --toc-item-spacing-vertical: 0.4rem;\n --toc-item-spacing-horizontal: 1rem;\n}\n","// Expose theme icons as CSS variables.\n\n$icons: (\n // Adapted from tabler-icons\n // url: https://tablericons.com/\n \"search\":\n url('data:image/svg+xml;charset=utf-8,'),\n // Factored out from mkdocs-material on 24-Aug-2020.\n // url: https://squidfunk.github.io/mkdocs-material/reference/admonitions/\n \"pencil\":\n url('data:image/svg+xml;charset=utf-8,'),\n \"abstract\":\n url('data:image/svg+xml;charset=utf-8,'),\n \"info\":\n url('data:image/svg+xml;charset=utf-8,'),\n \"flame\":\n url('data:image/svg+xml;charset=utf-8,'),\n \"question\":\n url('data:image/svg+xml;charset=utf-8,'),\n \"warning\":\n url('data:image/svg+xml;charset=utf-8,'),\n \"failure\":\n url('data:image/svg+xml;charset=utf-8,'),\n \"spark\":\n url('data:image/svg+xml;charset=utf-8,')\n);\n\n@mixin icons {\n @each $name, $glyph in $icons {\n --icon-#{$name}: #{$glyph};\n }\n}\n","// Admonitions\n\n// Structure of these is:\n// admonition-class: color \"icon-name\";\n//\n// The colors are translated into CSS variables below. The icons are\n// used directly in the main declarations to set the `mask-image` in\n// the title.\n\n// prettier-ignore\n$admonitions: (\n // Each of these has an reST directives for it.\n \"caution\": #ff9100 \"spark\",\n \"warning\": #ff9100 \"warning\",\n \"danger\": #ff5252 \"spark\",\n \"attention\": #ff5252 \"warning\",\n \"error\": #ff5252 \"failure\",\n \"hint\": #00c852 \"question\",\n \"tip\": #00c852 \"info\",\n \"important\": #00bfa5 \"flame\",\n \"note\": #00b0ff \"pencil\",\n \"seealso\": #448aff \"info\",\n \"admonition-todo\": #808080 \"pencil\"\n);\n\n@mixin default-admonition($color, $icon-name) {\n --color-admonition-title: #{$color};\n --color-admonition-title-background: #{rgba($color, 0.2)};\n\n --icon-admonition-default: var(--icon-#{$icon-name});\n}\n\n@mixin default-topic($color, $icon-name) {\n --color-topic-title: #{$color};\n --color-topic-title-background: #{rgba($color, 0.2)};\n\n --icon-topic-default: var(--icon-#{$icon-name});\n}\n\n@mixin admonitions {\n @each $name, $values in $admonitions {\n --color-admonition-title--#{$name}: #{nth($values, 1)};\n --color-admonition-title-background--#{$name}: #{rgba(\n nth($values, 1),\n 0.2\n )};\n }\n}\n","// Colors used throughout this theme.\n//\n// The aim is to give the user more control. Thus, instead of hard-coding colors\n// in various parts of the stylesheet, the approach taken is to define all\n// colors as CSS variables and reusing them in all the places.\n//\n// `colors-dark` depends on `colors` being included at a lower specificity.\n\n@mixin colors {\n --color-problematic: #b30000;\n\n // Base Colors\n --color-foreground-primary: black; // for main text and headings\n --color-foreground-secondary: #5a5c63; // for secondary text\n --color-foreground-muted: #646776; // for muted text\n --color-foreground-border: #878787; // for content borders\n\n --color-background-primary: white; // for content\n --color-background-secondary: #f8f9fb; // for navigation + ToC\n --color-background-hover: #efeff4ff; // for navigation-item hover\n --color-background-hover--transparent: #efeff400;\n --color-background-border: #eeebee; // for UI borders\n --color-background-item: #ccc; // for \"background\" items (eg: copybutton)\n\n // Announcements\n --color-announcement-background: #000000dd;\n --color-announcement-text: #eeebee;\n\n // Brand colors\n --color-brand-primary: #2962ff;\n --color-brand-content: #2a5adf;\n\n // API documentation\n --color-api-background: var(--color-background-hover--transparent);\n --color-api-background-hover: var(--color-background-hover);\n --color-api-overall: var(--color-foreground-secondary);\n --color-api-name: var(--color-problematic);\n --color-api-pre-name: var(--color-problematic);\n --color-api-paren: var(--color-foreground-secondary);\n --color-api-keyword: var(--color-foreground-primary);\n --color-highlight-on-target: #ffffcc;\n\n // Inline code background\n --color-inline-code-background: var(--color-background-secondary);\n\n // Highlighted text (search)\n --color-highlighted-background: #ddeeff;\n --color-highlighted-text: var(--color-foreground-primary);\n\n // GUI Labels\n --color-guilabel-background: #ddeeff80;\n --color-guilabel-border: #bedaf580;\n --color-guilabel-text: var(--color-foreground-primary);\n\n // Admonitions!\n --color-admonition-background: transparent;\n\n //////////////////////////////////////////////////////////////////////////////\n // Everything below this should be one of:\n // - var(...)\n // - *-gradient(...)\n // - special literal values (eg: transparent, none)\n //////////////////////////////////////////////////////////////////////////////\n\n // Tables\n --color-table-header-background: var(--color-background-secondary);\n --color-table-border: var(--color-background-border);\n\n // Cards\n --color-card-border: var(--color-background-secondary);\n --color-card-background: transparent;\n --color-card-marginals-background: var(--color-background-secondary);\n\n // Header\n --color-header-background: var(--color-background-primary);\n --color-header-border: var(--color-background-border);\n --color-header-text: var(--color-foreground-primary);\n\n // Sidebar (left)\n --color-sidebar-background: var(--color-background-secondary);\n --color-sidebar-background-border: var(--color-background-border);\n\n --color-sidebar-brand-text: var(--color-foreground-primary);\n --color-sidebar-caption-text: var(--color-foreground-muted);\n --color-sidebar-link-text: var(--color-foreground-secondary);\n --color-sidebar-link-text--top-level: var(--color-brand-primary);\n\n --color-sidebar-item-background: var(--color-sidebar-background);\n --color-sidebar-item-background--current: var(\n --color-sidebar-item-background\n );\n --color-sidebar-item-background--hover: linear-gradient(\n 90deg,\n var(--color-background-hover--transparent) 0%,\n var(--color-background-hover) var(--sidebar-item-spacing-horizontal),\n var(--color-background-hover) 100%\n );\n\n --color-sidebar-item-expander-background: transparent;\n --color-sidebar-item-expander-background--hover: var(\n --color-background-hover\n );\n\n --color-sidebar-search-text: var(--color-foreground-primary);\n --color-sidebar-search-background: var(--color-background-secondary);\n --color-sidebar-search-background--focus: var(--color-background-primary);\n --color-sidebar-search-border: var(--color-background-border);\n --color-sidebar-search-icon: var(--color-foreground-muted);\n\n // Table of Contents (right)\n --color-toc-background: var(--color-background-primary);\n --color-toc-title-text: var(--color-foreground-muted);\n --color-toc-item-text: var(--color-foreground-secondary);\n --color-toc-item-text--hover: var(--color-foreground-primary);\n --color-toc-item-text--active: var(--color-brand-primary);\n\n // Actual page contents\n --color-content-foreground: var(--color-foreground-primary);\n --color-content-background: transparent;\n\n // Links\n --color-link: var(--color-brand-content);\n --color-link--hover: var(--color-brand-content);\n --color-link-underline: var(--color-background-border);\n --color-link-underline--hover: var(--color-foreground-border);\n}\n\n@mixin colors-dark {\n --color-problematic: #ee5151;\n\n // Base Colors\n --color-foreground-primary: #ffffffcc; // for main text and headings\n --color-foreground-secondary: #9ca0a5; // for secondary text\n --color-foreground-muted: #81868d; // for muted text\n --color-foreground-border: #666666; // for content borders\n\n --color-background-primary: #131416; // for content\n --color-background-secondary: #1a1c1e; // for navigation + ToC\n --color-background-hover: #1e2124ff; // for navigation-item hover\n --color-background-hover--transparent: #1e212400;\n --color-background-border: #303335; // for UI borders\n --color-background-item: #444; // for \"background\" items (eg: copybutton)\n\n // Announcements\n --color-announcement-background: #000000dd;\n --color-announcement-text: #eeebee;\n\n // Brand colors\n --color-brand-primary: #2b8cee;\n --color-brand-content: #368ce2;\n\n // Highlighted text (search)\n --color-highlighted-background: #083563;\n\n // GUI Labels\n --color-guilabel-background: #08356380;\n --color-guilabel-border: #13395f80;\n\n // API documentation\n --color-api-keyword: var(--color-foreground-secondary);\n --color-highlight-on-target: #333300;\n\n // Admonitions\n --color-admonition-background: #18181a;\n\n // Cards\n --color-card-border: var(--color-background-secondary);\n --color-card-background: #18181a;\n --color-card-marginals-background: var(--color-background-hover);\n}\n","// This file contains the styling for making the content throughout the page,\n// including fonts, paragraphs, headings and spacing among these elements.\n\nbody\n font-family: var(--font-stack)\npre,\ncode,\nkbd,\nsamp\n font-family: var(--font-stack--monospace)\n\n// Make fonts look slightly nicer.\nbody\n -webkit-font-smoothing: antialiased\n -moz-osx-font-smoothing: grayscale\n\n// Line height from Bootstrap 4.1\narticle\n line-height: 1.5\n\n//\n// Headings\n//\nh1,\nh2,\nh3,\nh4,\nh5,\nh6\n line-height: 1.25\n font-weight: bold\n\n border-radius: 0.5rem\n margin-top: 0.5rem\n margin-bottom: 0.5rem\n margin-left: -0.5rem\n margin-right: -0.5rem\n padding-left: 0.5rem\n padding-right: 0.5rem\n\n + p\n margin-top: 0\n\nh1\n font-size: 2.5em\n margin-top: 1.75rem\n margin-bottom: 1rem\nh2\n font-size: 2em\n margin-top: 1.75rem\nh3\n font-size: 1.5em\nh4\n font-size: 1.25em\nh5\n font-size: 1.125em\nh6\n font-size: 1em\n\nsmall\n opacity: 75%\n font-size: 80%\n\n// Paragraph\np\n margin-top: 0.5rem\n margin-bottom: 0.75rem\n\n// Horizontal rules\nhr.docutils\n height: 1px\n padding: 0\n margin: 2rem 0\n background-color: var(--color-background-border)\n border: 0\n\n.centered\n text-align: center\n\n// Links\na\n text-decoration: underline\n\n color: var(--color-link)\n text-decoration-color: var(--color-link-underline)\n\n &:hover\n color: var(--color-link--hover)\n text-decoration-color: var(--color-link-underline--hover)\n &.muted-link\n color: inherit\n &:hover\n color: var(--color-link)\n text-decoration-color: var(--color-link-underline--hover)\n","// This file contains the styles for the overall layouting of the documentation\n// skeleton, including the responsive changes as well as sidebar toggles.\n//\n// This is implemented as a mobile-last design, which isn't ideal, but it is\n// reasonably good-enough and I got pretty tired by the time I'd finished this\n// to move the rules around to fix this. Shouldn't take more than 3-4 hours,\n// if you know what you're doing tho.\n\n// HACK: Not all browsers account for the scrollbar width in media queries.\n// This results in horizontal scrollbars in the breakpoint where we go\n// from displaying everything to hiding the ToC. We accomodate for this by\n// adding a bit of padding to the TOC drawer, disabling the horizontal\n// scrollbar and allowing the scrollbars to cover the padding.\n// https://www.456bereastreet.com/archive/201301/media_query_width_and_vertical_scrollbars/\n\n// HACK: Always having the scrollbar visible, prevents certain browsers from\n// causing the content to stutter horizontally between taller-than-viewport and\n// not-taller-than-viewport pages.\n\nhtml\n overflow-x: hidden\n overflow-y: scroll\n scroll-behavior: smooth\n\n.sidebar-scroll, .toc-scroll, article[role=main] *\n // Override Firefox scrollbar style\n scrollbar-width: thin\n scrollbar-color: var(--color-foreground-border) transparent\n\n // Override Chrome scrollbar styles\n &::-webkit-scrollbar\n width: 0.25rem\n height: 0.25rem\n &::-webkit-scrollbar-thumb\n background-color: var(--color-foreground-border)\n border-radius: 0.125rem\n\n//\n// Overalls\n//\nhtml,\nbody\n height: 100%\n color: var(--color-foreground-primary)\n background: var(--color-background-primary)\n\narticle\n color: var(--color-content-foreground)\n background: var(--color-content-background)\n overflow-wrap: break-word\n\n.page\n display: flex\n // fill the viewport for pages with little content.\n min-height: 100%\n\n.mobile-header\n width: 100%\n height: var(--header-height)\n background-color: var(--color-header-background)\n color: var(--color-header-text)\n border-bottom: 1px solid var(--color-header-border)\n\n // Looks like sub-script/super-script have this, and we need this to\n // be \"on top\" of those.\n z-index: 10\n\n // We don't show the header on large screens.\n display: none\n\n // Add shadow when scrolled\n &.scrolled\n border-bottom: none\n box-shadow: 0 0 0.2rem rgba(0, 0, 0, 0.1), 0 0.2rem 0.4rem rgba(0, 0, 0, 0.2)\n\n .header-center\n a\n color: var(--color-header-text)\n text-decoration: none\n\n.main\n display: flex\n flex: 1\n\n// Sidebar (left) also covers the entire left portion of screen.\n.sidebar-drawer\n box-sizing: border-box\n\n border-right: 1px solid var(--color-sidebar-background-border)\n background: var(--color-sidebar-background)\n\n display: flex\n justify-content: flex-end\n // These next two lines took me two days to figure out.\n width: calc((100% - #{$full-width}) / 2 + #{$sidebar-width})\n min-width: $sidebar-width\n\n// Scroll-along sidebars\n.sidebar-container,\n.toc-drawer\n box-sizing: border-box\n width: $sidebar-width\n\n.toc-drawer\n background: var(--color-toc-background)\n // See HACK described on top of this document\n padding-right: 1rem\n\n.sidebar-sticky,\n.toc-sticky\n position: sticky\n top: 0\n height: min(100%, 100vh)\n height: 100vh\n\n display: flex\n flex-direction: column\n\n.sidebar-scroll,\n.toc-scroll\n flex-grow: 1\n flex-shrink: 1\n\n overflow: auto\n scroll-behavior: smooth\n\n// Central items.\n.content\n padding: 0 $content-padding\n width: $content-width\n\n display: flex\n flex-direction: column\n justify-content: space-between\n\n.icon\n display: inline-block\n height: 1rem\n width: 1rem\n svg\n width: 100%\n height: 100%\n\n//\n// Accommodate announcement banner\n//\n.announcement\n background-color: var(--color-announcement-background)\n color: var(--color-announcement-text)\n\n height: var(--header-height)\n display: flex\n align-items: center\n overflow-x: auto\n & + .page\n min-height: calc(100% - var(--header-height))\n\n.announcement-content\n box-sizing: border-box\n padding: 0.5rem\n min-width: 100%\n white-space: nowrap\n text-align: center\n\n a\n color: var(--color-announcement-text)\n text-decoration-color: var(--color-announcement-text)\n\n &:hover\n color: var(--color-announcement-text)\n text-decoration-color: var(--color-link--hover)\n\n////////////////////////////////////////////////////////////////////////////////\n// Toggles for theme\n////////////////////////////////////////////////////////////////////////////////\n.no-js .theme-toggle-container // don't show theme toggle if there's no JS\n display: none\n\n.theme-toggle-container\n vertical-align: middle\n\n.theme-toggle\n cursor: pointer\n border: none\n padding: 0\n background: transparent\n\n.theme-toggle svg\n vertical-align: middle\n height: 1rem\n width: 1rem\n color: var(--color-foreground-primary)\n display: none\n\n.theme-toggle-header\n float: left\n padding: 1rem 0.5rem\n\n////////////////////////////////////////////////////////////////////////////////\n// Toggles for elements\n////////////////////////////////////////////////////////////////////////////////\n.toc-overlay-icon, .nav-overlay-icon\n display: none\n cursor: pointer\n\n .icon\n color: var(--color-foreground-secondary)\n height: 1rem\n width: 1rem\n\n.toc-header-icon, .nav-overlay-icon\n // for when we set display: flex\n justify-content: center\n align-items: center\n\n.toc-content-icon\n height: 1.5rem\n width: 1.5rem\n\n.content-icon-container\n float: right\n display: flex\n margin-top: 1.5rem\n margin-left: 1rem\n margin-bottom: 1rem\n gap: 0.5rem\n\n .edit-this-page svg\n color: inherit\n height: 1rem\n width: 1rem\n\n.sidebar-toggle\n position: absolute\n display: none\n// \n.sidebar-toggle[name=\"__toc\"]\n left: 20px\n.sidebar-toggle:checked\n left: 40px\n// \n\n.overlay\n position: fixed\n top: 0\n width: 0\n height: 0\n\n transition: width 0ms, height 0ms, opacity 250ms ease-out\n\n opacity: 0\n background-color: rgba(0, 0, 0, 0.54)\n.sidebar-overlay\n z-index: 20\n.toc-overlay\n z-index: 40\n\n// Keep things on top and smooth.\n.sidebar-drawer\n z-index: 30\n transition: left 250ms ease-in-out\n.toc-drawer\n z-index: 50\n transition: right 250ms ease-in-out\n\n// Show the Sidebar\n#__navigation:checked\n & ~ .sidebar-overlay\n width: 100%\n height: 100%\n opacity: 1\n & ~ .page\n .sidebar-drawer\n top: 0\n left: 0\n // Show the toc sidebar\n#__toc:checked\n & ~ .toc-overlay\n width: 100%\n height: 100%\n opacity: 1\n & ~ .page\n .toc-drawer\n top: 0\n right: 0\n\n////////////////////////////////////////////////////////////////////////////////\n// Back to top\n////////////////////////////////////////////////////////////////////////////////\n.back-to-top\n text-decoration: none\n\n display: none\n position: fixed\n left: 0\n top: 1rem\n padding: 0.5rem\n padding-right: 0.75rem\n border-radius: 1rem\n font-size: 0.8125rem\n\n background: var(--color-background-primary)\n box-shadow: 0 0.2rem 0.5rem rgba(0, 0, 0, 0.05), #6b728080 0px 0px 1px 0px\n\n z-index: 10\n\n margin-left: 50%\n transform: translateX(-50%)\n svg\n height: 1rem\n width: 1rem\n fill: currentColor\n display: inline-block\n\n span\n margin-left: 0.25rem\n\n .show-back-to-top &\n display: flex\n align-items: center\n\n////////////////////////////////////////////////////////////////////////////////\n// Responsive layouting\n////////////////////////////////////////////////////////////////////////////////\n// Make things a bit bigger on bigger screens.\n@media (min-width: $full-width + $sidebar-width)\n html\n font-size: 110%\n\n@media (max-width: $full-width)\n // Collapse \"toc\" into the icon.\n .toc-content-icon\n display: flex\n .toc-drawer\n position: fixed\n height: 100vh\n top: 0\n right: -$sidebar-width\n border-left: 1px solid var(--color-background-muted)\n .toc-tree\n border-left: none\n font-size: var(--toc-font-size--mobile)\n\n // Accomodate for a changed content width.\n .sidebar-drawer\n width: calc((100% - #{$full-width - $sidebar-width}) / 2 + #{$sidebar-width})\n\n@media (max-width: $full-width - $sidebar-width)\n // Collapse \"navigation\".\n .nav-overlay-icon\n display: flex\n .sidebar-drawer\n position: fixed\n height: 100vh\n width: $sidebar-width\n\n top: 0\n left: -$sidebar-width\n\n // Swap which icon is visible.\n .toc-header-icon\n display: flex\n .toc-content-icon, .theme-toggle-content\n display: none\n .theme-toggle-header\n display: block\n\n // Show the header.\n .mobile-header\n position: sticky\n top: 0\n display: flex\n justify-content: space-between\n align-items: center\n\n .header-left,\n .header-right\n display: flex\n height: var(--header-height)\n padding: 0 var(--header-padding)\n label\n height: 100%\n width: 100%\n user-select: none\n\n .nav-overlay-icon .icon,\n .theme-toggle svg\n height: 1.25rem\n width: 1.25rem\n\n // Add a scroll margin for the content\n :target\n scroll-margin-top: var(--header-height)\n\n // Show back-to-top below the header\n .back-to-top\n top: calc(var(--header-height) + 0.5rem)\n\n // Center the page, and accommodate for the header.\n .page\n flex-direction: column\n justify-content: center\n .content\n margin-left: auto\n margin-right: auto\n\n@media (max-width: $content-width + 2* $content-padding)\n // Content should respect window limits.\n .content\n width: 100%\n overflow-x: auto\n\n@media (max-width: $content-width)\n .content\n padding: 0 $content-padding--small\n // Don't float sidebars to the right.\n article aside.sidebar\n float: none\n width: 100%\n margin: 1rem 0\n","//\n// The design here is strongly inspired by mkdocs-material.\n.admonition, .topic\n margin: 1rem auto\n padding: 0 0.5rem 0.5rem 0.5rem\n\n background: var(--color-admonition-background)\n\n border-radius: 0.2rem\n box-shadow: 0 0.2rem 0.5rem rgba(0, 0, 0, 0.05), 0 0 0.0625rem rgba(0, 0, 0, 0.1)\n\n font-size: var(--admonition-font-size)\n\n overflow: hidden\n page-break-inside: avoid\n\n // First element should have no margin, since the title has it.\n > :nth-child(2)\n margin-top: 0\n\n // Last item should have no margin, since we'll control that w/ padding\n > :last-child\n margin-bottom: 0\n\n.admonition p.admonition-title,\np.topic-title\n position: relative\n margin: 0 -0.5rem 0.5rem\n padding-left: 2rem\n padding-right: .5rem\n padding-top: .4rem\n padding-bottom: .4rem\n\n font-weight: 500\n font-size: var(--admonition-title-font-size)\n line-height: 1.3\n\n // Our fancy icon\n &::before\n content: \"\"\n position: absolute\n left: 0.5rem\n width: 1rem\n height: 1rem\n\n// Default styles\np.admonition-title\n background-color: var(--color-admonition-title-background)\n &::before\n background-color: var(--color-admonition-title)\n mask-image: var(--icon-admonition-default)\n mask-repeat: no-repeat\n\np.topic-title\n background-color: var(--color-topic-title-background)\n &::before\n background-color: var(--color-topic-title)\n mask-image: var(--icon-topic-default)\n mask-repeat: no-repeat\n\n//\n// Variants\n//\n.admonition\n border-left: 0.2rem solid var(--color-admonition-title)\n\n @each $type, $value in $admonitions\n &.#{$type}\n border-left-color: var(--color-admonition-title--#{$type})\n > .admonition-title\n background-color: var(--color-admonition-title-background--#{$type})\n &::before\n background-color: var(--color-admonition-title--#{$type})\n mask-image: var(--icon-#{nth($value, 2)})\n\n.admonition-todo > .admonition-title\n text-transform: uppercase\n","// This file stylizes the API documentation (stuff generated by autodoc). It's\n// deeply nested due to how autodoc structures the HTML without enough classes\n// to select the relevant items.\n\n// API docs!\ndl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple)\n // Tweak the spacing of all the things!\n dd\n margin-left: 2rem\n > :first-child\n margin-top: 0.125rem\n > :last-child\n margin-bottom: 0.75rem\n\n // This is used for the arguments\n .field-list\n margin-bottom: 0.75rem\n\n // \"Headings\" (like \"Parameters\" and \"Return\")\n > dt\n text-transform: uppercase\n font-size: var(--font-size--small)\n\n dd:empty\n margin-bottom: 0.5rem\n dd > ul\n margin-left: -1.2rem\n > li\n > p:nth-child(2)\n margin-top: 0\n // When the last-empty-paragraph follows a paragraph, it doesn't need\n // to augument the existing spacing.\n > p + p:last-child:empty\n margin-top: 0\n margin-bottom: 0\n\n // Colorize the elements\n > dt\n color: var(--color-api-overall)\n\n.sig:not(.sig-inline)\n font-weight: bold\n\n font-size: var(--api-font-size)\n font-family: var(--font-stack--monospace)\n\n margin-left: -0.25rem\n margin-right: -0.25rem\n padding-top: 0.25rem\n padding-bottom: 0.25rem\n padding-right: 0.5rem\n\n // These are intentionally em, to properly match the font size.\n padding-left: 3em\n text-indent: -2.5em\n\n border-radius: 0.25rem\n\n background: var(--color-api-background)\n transition: background 100ms ease-out\n\n &:hover\n background: var(--color-api-background-hover)\n\n // adjust the size of the [source] link on the right.\n a.reference\n .viewcode-link\n font-weight: normal\n width: 3.5rem\n\nem.property\n font-style: normal\n &:first-child\n color: var(--color-api-keyword)\n.sig-name\n color: var(--color-api-name)\n.sig-prename\n font-weight: normal\n color: var(--color-api-pre-name)\n.sig-paren\n color: var(--color-api-paren)\n.sig-param\n font-style: normal\n\n.versionmodified\n font-style: italic\ndiv.versionadded, div.versionchanged, div.deprecated\n p\n margin-top: 0.125rem\n margin-bottom: 0.125rem\n\n// Align the [docs] and [source] to the right.\n.viewcode-link, .viewcode-back\n float: right\n text-align: right\n",".line-block\n margin-top: 0.5rem\n margin-bottom: 0.75rem\n .line-block\n margin-top: 0rem\n margin-bottom: 0rem\n padding-left: 1rem\n","// Captions\narticle p.caption,\ntable > caption,\n.code-block-caption\n font-size: var(--font-size--small)\n text-align: center\n\n// Caption above a TOCTree\n.toctree-wrapper.compound\n .caption, :not(.caption) > .caption-text\n font-size: var(--font-size--small)\n text-transform: uppercase\n\n text-align: initial\n margin-bottom: 0\n\n > ul\n margin-top: 0\n margin-bottom: 0\n","// Inline code\ncode.literal, .sig-inline\n background: var(--color-inline-code-background)\n border-radius: 0.2em\n // Make the font smaller, and use padding to recover.\n font-size: var(--font-size--small--2)\n padding: 0.1em 0.2em\n\n pre.literal-block &\n font-size: inherit\n padding: 0\n\n p &\n border: 1px solid var(--color-background-border)\n\n.sig-inline\n font-family: var(--font-stack--monospace)\n\n// Code and Literal Blocks\n$code-spacing-vertical: 0.625rem\n$code-spacing-horizontal: 0.875rem\n\n// Wraps every literal block + line numbers.\ndiv[class*=\" highlight-\"],\ndiv[class^=\"highlight-\"]\n margin: 1em 0\n display: flex\n\n .table-wrapper\n margin: 0\n padding: 0\n\npre\n margin: 0\n padding: 0\n overflow: auto\n\n // Needed to have more specificity than pygments' \"pre\" selector. :(\n article[role=\"main\"] .highlight &\n line-height: 1.5\n\n &.literal-block,\n .highlight &\n font-size: var(--code-font-size)\n padding: $code-spacing-vertical $code-spacing-horizontal\n\n // Make it look like all the other blocks.\n &.literal-block\n margin-top: 1rem\n margin-bottom: 1rem\n\n border-radius: 0.2rem\n background-color: var(--color-code-background)\n color: var(--color-code-foreground)\n\n// All code is always contained in this.\n.highlight\n width: 100%\n border-radius: 0.2rem\n\n // Make line numbers and prompts un-selectable.\n .gp, span.linenos\n user-select: none\n pointer-events: none\n\n // Expand the line-highlighting.\n .hll\n display: block\n margin-left: -$code-spacing-horizontal\n margin-right: -$code-spacing-horizontal\n padding-left: $code-spacing-horizontal\n padding-right: $code-spacing-horizontal\n\n/* Make code block captions be nicely integrated */\n.code-block-caption\n display: flex\n padding: $code-spacing-vertical $code-spacing-horizontal\n\n border-radius: 0.25rem\n border-bottom-left-radius: 0\n border-bottom-right-radius: 0\n font-weight: 300\n border-bottom: 1px solid\n\n background-color: var(--color-code-background)\n color: var(--color-code-foreground)\n border-color: var(--color-background-border)\n\n + div[class]\n margin-top: 0\n pre\n border-top-left-radius: 0\n border-top-right-radius: 0\n\n// When `html_codeblock_linenos_style` is table.\n.highlighttable\n width: 100%\n display: block\n tbody\n display: block\n\n tr\n display: flex\n\n // Line numbers\n td.linenos\n background-color: var(--color-code-background)\n color: var(--color-code-foreground)\n padding: $code-spacing-vertical $code-spacing-horizontal\n padding-right: 0\n border-top-left-radius: 0.2rem\n border-bottom-left-radius: 0.2rem\n\n .linenodiv\n padding-right: $code-spacing-horizontal\n font-size: var(--code-font-size)\n box-shadow: -0.0625rem 0 var(--color-foreground-border) inset\n\n // Actual code\n td.code\n padding: 0\n display: block\n flex: 1\n overflow: hidden\n\n .highlight\n border-top-left-radius: 0\n border-bottom-left-radius: 0\n\n// When `html_codeblock_linenos_style` is inline.\n.highlight\n span.linenos\n display: inline-block\n padding-left: 0\n padding-right: $code-spacing-horizontal\n margin-right: $code-spacing-horizontal\n box-shadow: -0.0625rem 0 var(--color-foreground-border) inset\n","// Inline Footnote Reference\n.footnote-reference\n font-size: var(--font-size--small--4)\n vertical-align: super\n\n// Definition list, listing the content of each note.\n// docutils <= 0.17\ndl.footnote.brackets\n font-size: var(--font-size--small)\n color: var(--color-foreground-secondary)\n\n display: grid\n grid-template-columns: max-content auto\n dt\n margin: 0\n > .fn-backref\n margin-left: 0.25rem\n\n &:after\n content: \":\"\n\n .brackets\n &:before\n content: \"[\"\n &:after\n content: \"]\"\n\n dd\n margin: 0\n padding: 0 1rem\n\n// docutils >= 0.18\naside.footnote\n font-size: var(--font-size--small)\n color: var(--color-foreground-secondary)\n\naside.footnote > span,\ndiv.citation > span\n float: left\n font-weight: 500\n padding-right: 0.25rem\n\naside.footnote > p,\ndiv.citation > p\n margin-left: 2rem\n","//\n// Figures\n//\nimg\n box-sizing: border-box\n max-width: 100%\n height: auto\n\narticle\n figure, .figure\n border-radius: 0.2rem\n\n margin: 0\n :last-child\n margin-bottom: 0\n\n .align-left\n float: left\n clear: left\n margin: 0 1rem 1rem\n\n .align-right\n float: right\n clear: right\n margin: 0 1rem 1rem\n\n .align-default,\n .align-center\n display: block\n text-align: center\n margin-left: auto\n margin-right: auto\n\n // WELL, table needs to be stylised like a table.\n table.align-default\n display: table\n text-align: initial\n",".genindex-jumpbox, .domainindex-jumpbox\n border-top: 1px solid var(--color-background-border)\n border-bottom: 1px solid var(--color-background-border)\n padding: 0.25rem\n\n.genindex-section, .domainindex-section\n h2\n margin-top: 0.75rem\n margin-bottom: 0.5rem\n ul\n margin-top: 0\n margin-bottom: 0\n","ul,\nol\n padding-left: 1.2rem\n\n // Space lists out like paragraphs\n margin-top: 1rem\n margin-bottom: 1rem\n // reduce margins within li.\n li\n > p:first-child\n margin-top: 0.25rem\n margin-bottom: 0.25rem\n\n > p:last-child\n margin-top: 0.25rem\n\n > ul,\n > ol\n margin-top: 0.5rem\n margin-bottom: 0.5rem\n\nol\n &.arabic\n list-style: decimal\n &.loweralpha\n list-style: lower-alpha\n &.upperalpha\n list-style: upper-alpha\n &.lowerroman\n list-style: lower-roman\n &.upperroman\n list-style: upper-roman\n\n// Don't space lists out when they're \"simple\" or in a `.. toctree::`\n.simple,\n.toctree-wrapper\n li\n > ul,\n > ol\n margin-top: 0\n margin-bottom: 0\n\n// Definition Lists\n.field-list,\n.option-list,\ndl:not([class]),\ndl.simple,\ndl.footnote,\ndl.glossary\n dt\n font-weight: 500\n margin-top: 0.25rem\n + dt\n margin-top: 0\n\n .classifier::before\n content: \":\"\n margin-left: 0.2rem\n margin-right: 0.2rem\n\n dd\n > p:first-child,\n ul\n margin-top: 0.125rem\n\n ul\n margin-bottom: 0.125rem\n",".math-wrapper\n width: 100%\n overflow-x: auto\n\ndiv.math\n position: relative\n text-align: center\n\n .headerlink,\n &:focus .headerlink\n display: none\n\n &:hover .headerlink\n display: inline-block\n\n span.eqno\n position: absolute\n right: 0.5rem\n top: 50%\n transform: translate(0, -50%)\n z-index: 1\n","// Abbreviations\nabbr[title]\n cursor: help\n\n// \"Problematic\" content, as identified by Sphinx\n.problematic\n color: var(--color-problematic)\n\n// Keyboard / Mouse \"instructions\"\nkbd:not(.compound)\n margin: 0 0.2rem\n padding: 0 0.2rem\n border-radius: 0.2rem\n border: 1px solid var(--color-foreground-border)\n color: var(--color-foreground-primary)\n vertical-align: text-bottom\n\n font-size: var(--font-size--small--3)\n display: inline-block\n\n box-shadow: 0 0.0625rem 0 rgba(0, 0, 0, 0.2), inset 0 0 0 0.125rem var(--color-background-primary)\n\n background-color: var(--color-background-secondary)\n\n// Blockquote\nblockquote\n border-left: 4px solid var(--color-background-border)\n background: var(--color-background-secondary)\n\n margin-left: 0\n margin-right: 0\n padding: 0.5rem 1rem\n\n .attribution\n font-weight: 600\n text-align: right\n\n &.pull-quote,\n &.highlights\n font-size: 1.25em\n\n &.epigraph,\n &.pull-quote\n border-left-width: 0\n border-radius: 0.5rem\n\n &.highlights\n border-left-width: 0\n background: transparent\n\n// Center align embedded-in-text images\np .reference img\n vertical-align: middle\n","p.rubric\n line-height: 1.25\n font-weight: bold\n font-size: 1.125em\n\n // For Numpy-style documentation that's got rubrics within it.\n // https://github.com/pradyunsg/furo/discussions/505\n dd &\n line-height: inherit\n font-weight: inherit\n\n font-size: var(--font-size--small)\n text-transform: uppercase\n","article .sidebar\n float: right\n clear: right\n width: 30%\n\n margin-left: 1rem\n margin-right: 0\n\n border-radius: 0.2rem\n background-color: var(--color-background-secondary)\n border: var(--color-background-border) 1px solid\n\n > *\n padding-left: 1rem\n padding-right: 1rem\n\n > ul, > ol // lists need additional padding, because bullets.\n padding-left: 2.2rem\n\n .sidebar-title\n margin: 0\n padding: 0.5rem 1rem\n border-bottom: var(--color-background-border) 1px solid\n\n font-weight: 500\n\n// TODO: subtitle\n// TODO: dedicated variables?\n",".table-wrapper\n width: 100%\n overflow-x: auto\n margin-top: 1rem\n margin-bottom: 0.5rem\n padding: 0.2rem 0.2rem 0.75rem\n\ntable.docutils\n border-radius: 0.2rem\n border-spacing: 0\n border-collapse: collapse\n\n box-shadow: 0 0.2rem 0.5rem rgba(0, 0, 0, 0.05), 0 0 0.0625rem rgba(0, 0, 0, 0.1)\n\n th\n background: var(--color-table-header-background)\n\n td,\n th\n // Space things out properly\n padding: 0 0.25rem\n\n // Get the borders looking just-right.\n border-left: 1px solid var(--color-table-border)\n border-right: 1px solid var(--color-table-border)\n border-bottom: 1px solid var(--color-table-border)\n\n p\n margin: 0.25rem\n\n &:first-child\n border-left: none\n &:last-child\n border-right: none\n\n // MyST-parser tables set these classes for control of column alignment\n &.text-left\n text-align: left\n &.text-right\n text-align: right\n &.text-center\n text-align: center\n",":target\n scroll-margin-top: 0.5rem\n\n@media (max-width: $full-width - $sidebar-width)\n :target\n scroll-margin-top: calc(0.5rem + var(--header-height))\n\n // When a heading is selected\n section > span:target\n scroll-margin-top: calc(0.8rem + var(--header-height))\n\n// Permalinks\n.headerlink\n font-weight: 100\n user-select: none\n\nh1,\nh2,\nh3,\nh4,\nh5,\nh6,\ndl dt,\np.caption,\nfigcaption p,\ntable > caption,\n.code-block-caption\n > .headerlink\n margin-left: 0.5rem\n visibility: hidden\n &:hover > .headerlink\n visibility: visible\n\n // Don't change to link-like, if someone adds the contents directive.\n > .toc-backref\n color: inherit\n text-decoration-line: none\n\n// Figure and table captions are special.\nfigure:hover > figcaption > p > .headerlink,\ntable:hover > caption > .headerlink\n visibility: visible\n\n:target >, // Regular section[id] style anchors\nspan:target ~ // Non-regular span[id] style \"extra\" anchors\n h1,\n h2,\n h3,\n h4,\n h5,\n h6\n &:nth-of-type(1)\n background-color: var(--color-highlight-on-target)\n // .headerlink\n // visibility: visible\n code.literal\n background-color: transparent\n\ntable:target > caption,\nfigure:target\n background-color: var(--color-highlight-on-target)\n\n// Inline page contents\n.this-will-duplicate-information-and-it-is-still-useful-here li :target\n background-color: var(--color-highlight-on-target)\n\n// Code block permalinks\n.literal-block-wrapper:target .code-block-caption\n background-color: var(--color-highlight-on-target)\n\n// When a definition list item is selected\n//\n// There isn't really an alternative to !important here, due to the\n// high-specificity of API documentation's selector.\ndt:target\n background-color: var(--color-highlight-on-target) !important\n\n// When a footnote reference is selected\n.footnote > dt:target + dd,\n.footnote-reference:target\n background-color: var(--color-highlight-on-target)\n",".guilabel\n background-color: var(--color-guilabel-background)\n border: 1px solid var(--color-guilabel-border)\n color: var(--color-guilabel-text)\n\n padding: 0 0.3em\n border-radius: 0.5em\n font-size: 0.9em\n","// This file contains the styles used for stylizing the footer that's shown\n// below the content.\n\nfooter\n font-size: var(--font-size--small)\n display: flex\n flex-direction: column\n\n margin-top: 2rem\n\n// Bottom of page information\n.bottom-of-page\n display: flex\n align-items: center\n justify-content: space-between\n\n margin-top: 1rem\n padding-top: 1rem\n padding-bottom: 1rem\n\n color: var(--color-foreground-secondary)\n border-top: 1px solid var(--color-background-border)\n\n line-height: 1.5\n\n @media (max-width: $content-width)\n text-align: center\n flex-direction: column-reverse\n gap: 0.25rem\n\n .left-details\n font-size: var(--font-size--small)\n\n .right-details\n display: flex\n flex-direction: column\n gap: 0.25rem\n text-align: right\n\n .icons\n display: flex\n justify-content: flex-end\n gap: 0.25rem\n font-size: 1rem\n\n a\n text-decoration: none\n\n svg,\n img\n font-size: 1.125rem\n height: 1em\n width: 1em\n\n// Next/Prev page information\n.related-pages\n a\n display: flex\n align-items: center\n\n text-decoration: none\n &:hover .page-info .title\n text-decoration: underline\n color: var(--color-link)\n text-decoration-color: var(--color-link-underline)\n\n svg.furo-related-icon,\n svg.furo-related-icon > use\n flex-shrink: 0\n\n color: var(--color-foreground-border)\n\n width: 0.75rem\n height: 0.75rem\n margin: 0 0.5rem\n\n &.next-page\n max-width: 50%\n\n float: right\n clear: right\n text-align: right\n\n &.prev-page\n max-width: 50%\n\n float: left\n clear: left\n\n svg\n transform: rotate(180deg)\n\n.page-info\n display: flex\n flex-direction: column\n overflow-wrap: anywhere\n\n .next-page &\n align-items: flex-end\n\n .context\n display: flex\n align-items: center\n\n padding-bottom: 0.1rem\n\n color: var(--color-foreground-muted)\n font-size: var(--font-size--small)\n text-decoration: none\n","// This file contains the styles for the contents of the left sidebar, which\n// contains the navigation tree, logo, search etc.\n\n////////////////////////////////////////////////////////////////////////////////\n// Brand on top of the scrollable tree.\n////////////////////////////////////////////////////////////////////////////////\n.sidebar-brand\n display: flex\n flex-direction: column\n flex-shrink: 0\n\n padding: var(--sidebar-item-spacing-vertical) var(--sidebar-item-spacing-horizontal)\n text-decoration: none\n\n.sidebar-brand-text\n color: var(--color-sidebar-brand-text)\n overflow-wrap: break-word\n margin: var(--sidebar-item-spacing-vertical) 0\n font-size: 1.5rem\n\n.sidebar-logo-container\n margin: var(--sidebar-item-spacing-vertical) 0\n\n.sidebar-logo\n margin: 0 auto\n display: block\n max-width: 100%\n\n////////////////////////////////////////////////////////////////////////////////\n// Search\n////////////////////////////////////////////////////////////////////////////////\n.sidebar-search-container\n display: flex\n align-items: center\n margin-top: var(--sidebar-search-space-above)\n\n position: relative\n\n background: var(--color-sidebar-search-background)\n &:hover,\n &:focus-within\n background: var(--color-sidebar-search-background--focus)\n\n &::before\n content: \"\"\n position: absolute\n left: var(--sidebar-item-spacing-horizontal)\n width: var(--sidebar-search-icon-size)\n height: var(--sidebar-search-icon-size)\n\n background-color: var(--color-sidebar-search-icon)\n mask-image: var(--icon-search)\n\n.sidebar-search\n box-sizing: border-box\n\n border: none\n border-top: 1px solid var(--color-sidebar-search-border)\n border-bottom: 1px solid var(--color-sidebar-search-border)\n\n padding-top: var(--sidebar-search-input-spacing-vertical)\n padding-bottom: var(--sidebar-search-input-spacing-vertical)\n padding-right: var(--sidebar-search-input-spacing-horizontal)\n padding-left: calc(var(--sidebar-item-spacing-horizontal) + var(--sidebar-search-input-spacing-horizontal) + var(--sidebar-search-icon-size))\n\n width: 100%\n\n color: var(--color-sidebar-search-foreground)\n background: transparent\n z-index: 10\n\n &:focus\n outline: none\n\n &::placeholder\n font-size: var(--sidebar-search-input-font-size)\n\n//\n// Hide Search Matches link\n//\n#searchbox .highlight-link\n padding: var(--sidebar-item-spacing-vertical) var(--sidebar-item-spacing-horizontal) 0\n margin: 0\n text-align: center\n\n a\n color: var(--color-sidebar-search-icon)\n font-size: var(--font-size--small--2)\n\n////////////////////////////////////////////////////////////////////////////////\n// Structure/Skeleton of the navigation tree (left)\n////////////////////////////////////////////////////////////////////////////////\n.sidebar-tree\n font-size: var(--sidebar-item-font-size)\n margin-top: var(--sidebar-tree-space-above)\n margin-bottom: var(--sidebar-item-spacing-vertical)\n\n ul\n padding: 0\n margin-top: 0\n margin-bottom: 0\n\n display: flex\n flex-direction: column\n\n list-style: none\n\n li\n position: relative\n margin: 0\n\n > ul\n margin-left: var(--sidebar-item-spacing-horizontal)\n\n .icon\n color: var(--color-sidebar-link-text)\n\n .reference\n box-sizing: border-box\n color: var(--color-sidebar-link-text)\n\n // Fill the parent.\n display: inline-block\n line-height: var(--sidebar-item-line-height)\n text-decoration: none\n\n // Don't allow long words to cause wrapping.\n overflow-wrap: anywhere\n\n height: 100%\n width: 100%\n\n padding: var(--sidebar-item-spacing-vertical) var(--sidebar-item-spacing-horizontal)\n\n &:hover\n background: var(--color-sidebar-item-background--hover)\n\n // Add a nice little \"external-link\" arrow here.\n &.external::after\n content: url('data:image/svg+xml,')\n margin: 0 0.25rem\n vertical-align: middle\n color: var(--color-sidebar-link-text)\n\n // Make the current page reference bold.\n .current-page > .reference\n font-weight: bold\n\n label\n position: absolute\n top: 0\n right: 0\n height: var(--sidebar-item-height)\n width: var(--sidebar-expander-width)\n\n cursor: pointer\n user-select: none\n\n display: flex\n justify-content: center\n align-items: center\n\n .caption, :not(.caption) > .caption-text\n font-size: var(--sidebar-caption-font-size)\n color: var(--color-sidebar-caption-text)\n\n font-weight: bold\n text-transform: uppercase\n\n margin: var(--sidebar-caption-space-above) 0 0 0\n padding: var(--sidebar-item-spacing-vertical) var(--sidebar-item-spacing-horizontal)\n\n // If it has children, add a bit more padding to wrap the content to avoid\n // overlapping with the +:hidden: + +example-file-1 +example-file-2 +example-dir/index +... +\`\`\` +``` + +- `:maxdepth:` limits the depth of nesting +- `:caption:` title for the group of pages +- `:hidden:` if provided, links will only show in the sidebar (hidden on the page) +- Constituent files: listed files will be rendered as a link directly. If a listed file + has a `{toctree}` directive, this tree will be rendered in place of the page's link as a + dropdown. The dropdown will be named according to the file's top-level heading, and + clicking directly on the dropdown header will show that page's content. Files found in + the tree will be placed as links under the dropdown, recursively subject to same rules + described here. + +**Include files**: the following will include file content +pages: + +``` +\`\`\`{include} README.md +\`\`\` +``` + +**Reference directives** + + +[1]: https://pradyunsg.me/furo/ +[2]: https://www.sphinx-doc.org/en/master/man/sphinx-apidoc.html +[3]: https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html# + diff --git a/pyproject.toml b/pyproject.toml new file mode 100644 index 0000000..c5e7a78 --- /dev/null +++ b/pyproject.toml @@ -0,0 +1,27 @@ +[build-system] +requires = ["setuptools"] +build-backend = "setuptools.build_meta" + +[project] +name = "co3" +version = "0.1.1" +authors = [ + { name="Sam Griesemer", email="samgriesemer@gmail.com" }, +] +description = "Lightweight ORM" +readme = "README.md" +requires-python = ">=3.11" +classifiers = [ + "Programming Language :: Python :: 3", + "License :: OSI Approved :: MIT License", + "Operating System :: OS Independent", +] +dependencies = [ + "tqdm" +] + +[tool.setuptools.packages.find] +#where = ["localsys"] # this is too deeply nested, need to remain at root level & use +#include; by default, `where` is `.` +include = ["co3*"] # pattern to match package names + diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000..f05ce5b --- /dev/null +++ b/requirements.txt @@ -0,0 +1,8 @@ +# -- sphinx docs -- +sphinx +sphinx-togglebutton +furo +myst-parser + +sqlalchemy +numpy diff --git a/tests/co4_example.py b/tests/co4_example.py new file mode 100644 index 0000000..1758a6b --- /dev/null +++ b/tests/co4_example.py @@ -0,0 +1,47 @@ +''' +content -> converted +state -> transformed +''' + +from co3 import CO3, collate +from co3.databases import SQLiteDatabase +from co3 import Mapper + + +class Tomato(CO3): + def __init__(self, size, ripe): + self.size = size + self.ripe = ripe + + @property + def attributes(self): + return vars(self) + + @collate('diced') + def dice(self): + return self.size / 2 + + @collate('roasted') + def roast(self): + return self.size / 2 + + +tomato_table = sa.Table() + +mapper = Mapper() +mapper.attach( + Tomato, + tomato_table +) + + +tomato = Tomato(5, False) +mapper.collect(tomato, for='diced') + +db = SQLiteDatabse('resource.sqlite') +db.sync(mapper) + +dict_results = db.select( + mapper.compose(Tomato), + tomato_table.c.size == 5 +) diff --git a/tests/imports.py b/tests/imports.py new file mode 100644 index 0000000..d8a7813 --- /dev/null +++ b/tests/imports.py @@ -0,0 +1,20 @@ +from co3 import Accessor +from co3 import CO3 +from co3 import Collector +from co3 import Composer +from co3 import Database +from co3 import Indexer +from co3 import Manager +from co3 import Mapper +from co3 import Relation + + +from co3.accessors import SQLAccessor + +from co3.databases import SQLDatabase +from co3.databases import SQLiteDatabase + +from co3.managers import SQLManager + +from co3.relations import TabularRelation +from co3.relations import SQLTable