From 2ec04adb6e7d3def6dfd85897334db73e064aa19 Mon Sep 17 00:00:00 2001 From: Karel van Klink <karel.vanklink@geant.org> Date: Thu, 28 Nov 2024 11:36:42 +0100 Subject: [PATCH] Replace Sphinx with MkDocs --- build-docs.sh | 5 +- docs/overrides/partials/logo.html | 2 + docs/scripts/gen_ref_pages.py | 38 ++++++ docs/source/Makefile | 20 --- docs/source/conf.py | 27 ---- docs/source/glossary.rst | 121 ------------------ docs/source/index.rst | 14 -- docs/source/module/api/index.rst | 15 --- docs/source/module/api/v1/index.rst | 16 --- docs/source/module/api/v1/network.rst | 6 - docs/source/module/api/v1/subscriptions.rst | 6 - docs/source/module/auth/api_key_auth.rst | 6 - docs/source/module/auth/index.rst | 16 --- docs/source/module/auth/oidc.rst | 6 - docs/source/module/auth/opa.rst | 6 - docs/source/module/cli/imports.rst | 6 - docs/source/module/cli/index.rst | 16 --- docs/source/module/cli/netbox.rst | 6 - docs/source/module/products/index.rst | 15 --- .../products/product_blocks/bgp_session.rst | 6 - .../products/product_blocks/edge_port.rst | 6 - .../module/products/product_blocks/index.rst | 29 ----- .../products/product_blocks/iptrunk.rst | 6 - .../lan_switch_interconnect.rst | 6 - .../product_blocks/nren_l3_core_service.rst | 6 - .../products/product_blocks/office_router.rst | 6 - .../products/product_blocks/opengear.rst | 6 - .../products/product_blocks/pop_vlan.rst | 6 - .../module/products/product_blocks/router.rst | 6 - .../product_blocks/service_binding_port.rst | 6 - .../module/products/product_blocks/site.rst | 6 - .../product_blocks/super_pop_switch.rst | 6 - .../module/products/product_blocks/switch.rst | 6 - .../products/product_types/edge_port.rst | 6 - .../module/products/product_types/index.rst | 27 ---- .../module/products/product_types/iptrunk.rst | 6 - .../product_types/lan_switch_interconnect.rst | 6 - .../product_types/nren_l3_core_service.rst | 6 - .../products/product_types/office_router.rst | 6 - .../products/product_types/opengear.rst | 6 - .../products/product_types/pop_vlan.rst | 6 - .../module/products/product_types/router.rst | 6 - .../module/products/product_types/site.rst | 6 - .../product_types/super_pop_switch.rst | 6 - .../module/products/product_types/switch.rst | 6 - .../module/schedules/clean_old_tasks.rst | 6 - docs/source/module/schedules/index.rst | 22 ---- docs/source/module/schedules/scheduling.rst | 6 - .../schedules/send_email_notifications.rst | 6 - docs/source/module/schedules/task_vacuum.rst | 6 - .../module/schedules/validate_products.rst | 6 - .../schedules/validate_subscriptions.rst | 6 - docs/source/module/services/index.rst | 24 ---- docs/source/module/services/infoblox.rst | 6 - docs/source/module/services/kentik_client.rst | 6 - .../module/services/librenms_client.rst | 6 - docs/source/module/services/lso_client.rst | 6 - docs/source/module/services/mailer.rst | 6 - docs/source/module/services/netbox_client.rst | 6 - docs/source/module/services/partners.rst | 6 - docs/source/module/services/processes.rst | 6 - docs/source/module/services/sharepoint.rst | 6 - docs/source/module/services/subscriptions.rst | 6 - docs/source/module/utils/device_info.rst | 6 - docs/source/module/utils/exceptions.rst | 6 - docs/source/module/utils/helpers.rst | 6 - docs/source/module/utils/index.rst | 27 ---- docs/source/module/utils/shared_enums.rst | 6 - docs/source/module/utils/types/base_site.rst | 6 - .../source/module/utils/types/coordinates.rst | 6 - .../module/utils/types/country_code.rst | 6 - docs/source/module/utils/types/index.rst | 24 ---- docs/source/module/utils/types/interfaces.rst | 6 - docs/source/module/utils/types/ip_address.rst | 6 - .../module/utils/types/netbox_router.rst | 6 - docs/source/module/utils/types/site_name.rst | 6 - docs/source/module/utils/types/tt_number.rst | 6 - .../module/utils/types/unique_field.rst | 6 - docs/source/module/utils/workflow_steps.rst | 6 - .../workflows/edge_port/create_edge_port.rst | 6 - .../edge_port/create_imported_edge_port.rst | 6 - .../workflows/edge_port/import_edge_port.rst | 6 - .../module/workflows/edge_port/index.rst | 20 --- .../workflows/edge_port/modify_edge_port.rst | 6 - .../edge_port/terminate_edge_port.rst | 6 - .../edge_port/validate_edge_port.rst | 6 - docs/source/module/workflows/index.rst | 23 ---- .../workflows/iptrunk/activate_iptrunk.rst | 6 - .../iptrunk/create_imported_iptrunk.rst | 6 - .../workflows/iptrunk/create_iptrunk.rst | 6 - .../module/workflows/iptrunk/deploy_twamp.rst | 6 - .../workflows/iptrunk/import_iptrunk.rst | 6 - .../source/module/workflows/iptrunk/index.rst | 24 ---- .../workflows/iptrunk/migrate_iptrunk.rst | 6 - .../workflows/iptrunk/modify_isis_metric.rst | 6 - .../iptrunk/modify_trunk_interface.rst | 6 - .../workflows/iptrunk/terminate_iptrunk.rst | 6 - .../workflows/iptrunk/validate_iptrunk.rst | 6 - .../create_imported_layer_2_circuit.rst | 6 - .../create_layer_2_circuit.rst | 6 - .../import_layer_2_circuit.rst | 6 - .../l2_circuit/nren_l3_core_service/index.rst | 20 --- .../modify_layer_2_circuit.rst | 6 - ...reate_imported_lan_switch_interconnect.rst | 6 - .../create_lan_switch_interconnect.rst | 6 - .../import_lan_switch_interconnect.rst | 6 - .../lan_switch_interconnect/index.rst | 19 --- .../terminate_lan_switch_interconnect.rst | 6 - .../validate_lan_switch_interconnect.rst | 6 - .../create_imported_nren_l3_core_service.rst | 6 - .../create_nren_l3_core_service.rst | 6 - .../import_nren_l3_core_service.rst | 6 - .../workflows/nren_l3_core_service/index.rst | 19 --- .../migrate_nren_l3_core_service.rst | 6 - .../modify_nren_l3_core_service.rst | 6 - .../create_imported_office_router.rst | 6 - .../office_router/import_office_router.rst | 6 - .../module/workflows/office_router/index.rst | 16 --- .../opengear/create_imported_opengear.rst | 6 - .../workflows/opengear/import_opengear.rst | 6 - .../module/workflows/opengear/index.rst | 16 --- .../workflows/router/activate_router.rst | 6 - .../router/create_imported_router.rst | 6 - .../module/workflows/router/create_router.rst | 6 - .../module/workflows/router/import_router.rst | 6 - docs/source/module/workflows/router/index.rst | 25 ---- .../router/modify_connection_strategy.rst | 6 - .../router/modify_kentik_license.rst | 6 - .../workflows/router/promote_p_to_pe.rst | 6 - .../workflows/router/redeploy_base_config.rst | 6 - .../workflows/router/terminate_router.rst | 6 - .../workflows/router/update_ibgp_mesh.rst | 6 - .../workflows/router/validate_router.rst | 6 - .../workflows/site/create_imported_site.rst | 6 - .../module/workflows/site/create_site.rst | 6 - .../module/workflows/site/import_site.rst | 6 - docs/source/module/workflows/site/index.rst | 19 --- .../module/workflows/site/modify_site.rst | 6 - .../module/workflows/site/terminate_site.rst | 6 - .../create_imported_super_pop_switch.rst | 6 - .../import_super_pop_switch.rst | 6 - .../workflows/super_pop_switch/index.rst | 16 --- .../workflows/switch/activate_switch.rst | 6 - .../switch/create_imported_switch.rst | 6 - .../module/workflows/switch/create_switch.rst | 6 - .../module/workflows/switch/import_switch.rst | 6 - docs/source/module/workflows/switch/index.rst | 20 --- .../workflows/switch/terminate_switch.rst | 6 - .../workflows/switch/validate_switch.rst | 6 - .../workflows/tasks/clean_old_tasks.rst | 6 - .../workflows/tasks/create_partners.rst | 6 - .../workflows/tasks/delete_partners.rst | 6 - docs/source/module/workflows/tasks/index.rst | 20 --- .../workflows/tasks/modify_partners.rst | 6 - .../tasks/send_email_notifications.rst | 6 - .../tasks/validate_geant_products.rst | 6 - docs/source/modules.rst | 55 -------- docs/source/quickstart.rst | 47 ------- docs/source/static/custom.css | 3 - docs/source/static/custom.js | 3 - docs/source/static/geant_logo_white.svg | 16 --- mkdocs.yml | 110 ++++++++++++++++ 162 files changed, 152 insertions(+), 1547 deletions(-) create mode 100644 docs/overrides/partials/logo.html create mode 100644 docs/scripts/gen_ref_pages.py delete mode 100644 docs/source/Makefile delete mode 100644 docs/source/conf.py delete mode 100644 docs/source/glossary.rst delete mode 100644 docs/source/index.rst delete mode 100644 docs/source/module/api/index.rst delete mode 100644 docs/source/module/api/v1/index.rst delete mode 100644 docs/source/module/api/v1/network.rst delete mode 100644 docs/source/module/api/v1/subscriptions.rst delete mode 100644 docs/source/module/auth/api_key_auth.rst delete mode 100644 docs/source/module/auth/index.rst delete mode 100644 docs/source/module/auth/oidc.rst delete mode 100644 docs/source/module/auth/opa.rst delete mode 100644 docs/source/module/cli/imports.rst delete mode 100644 docs/source/module/cli/index.rst delete mode 100644 docs/source/module/cli/netbox.rst delete mode 100644 docs/source/module/products/index.rst delete mode 100644 docs/source/module/products/product_blocks/bgp_session.rst delete mode 100644 docs/source/module/products/product_blocks/edge_port.rst delete mode 100644 docs/source/module/products/product_blocks/index.rst delete mode 100644 docs/source/module/products/product_blocks/iptrunk.rst delete mode 100644 docs/source/module/products/product_blocks/lan_switch_interconnect.rst delete mode 100644 docs/source/module/products/product_blocks/nren_l3_core_service.rst delete mode 100644 docs/source/module/products/product_blocks/office_router.rst delete mode 100644 docs/source/module/products/product_blocks/opengear.rst delete mode 100644 docs/source/module/products/product_blocks/pop_vlan.rst delete mode 100644 docs/source/module/products/product_blocks/router.rst delete mode 100644 docs/source/module/products/product_blocks/service_binding_port.rst delete mode 100644 docs/source/module/products/product_blocks/site.rst delete mode 100644 docs/source/module/products/product_blocks/super_pop_switch.rst delete mode 100644 docs/source/module/products/product_blocks/switch.rst delete mode 100644 docs/source/module/products/product_types/edge_port.rst delete mode 100644 docs/source/module/products/product_types/index.rst delete mode 100644 docs/source/module/products/product_types/iptrunk.rst delete mode 100644 docs/source/module/products/product_types/lan_switch_interconnect.rst delete mode 100644 docs/source/module/products/product_types/nren_l3_core_service.rst delete mode 100644 docs/source/module/products/product_types/office_router.rst delete mode 100644 docs/source/module/products/product_types/opengear.rst delete mode 100644 docs/source/module/products/product_types/pop_vlan.rst delete mode 100644 docs/source/module/products/product_types/router.rst delete mode 100644 docs/source/module/products/product_types/site.rst delete mode 100644 docs/source/module/products/product_types/super_pop_switch.rst delete mode 100644 docs/source/module/products/product_types/switch.rst delete mode 100644 docs/source/module/schedules/clean_old_tasks.rst delete mode 100644 docs/source/module/schedules/index.rst delete mode 100644 docs/source/module/schedules/scheduling.rst delete mode 100644 docs/source/module/schedules/send_email_notifications.rst delete mode 100644 docs/source/module/schedules/task_vacuum.rst delete mode 100644 docs/source/module/schedules/validate_products.rst delete mode 100644 docs/source/module/schedules/validate_subscriptions.rst delete mode 100644 docs/source/module/services/index.rst delete mode 100644 docs/source/module/services/infoblox.rst delete mode 100644 docs/source/module/services/kentik_client.rst delete mode 100644 docs/source/module/services/librenms_client.rst delete mode 100644 docs/source/module/services/lso_client.rst delete mode 100644 docs/source/module/services/mailer.rst delete mode 100644 docs/source/module/services/netbox_client.rst delete mode 100644 docs/source/module/services/partners.rst delete mode 100644 docs/source/module/services/processes.rst delete mode 100644 docs/source/module/services/sharepoint.rst delete mode 100644 docs/source/module/services/subscriptions.rst delete mode 100644 docs/source/module/utils/device_info.rst delete mode 100644 docs/source/module/utils/exceptions.rst delete mode 100644 docs/source/module/utils/helpers.rst delete mode 100644 docs/source/module/utils/index.rst delete mode 100644 docs/source/module/utils/shared_enums.rst delete mode 100644 docs/source/module/utils/types/base_site.rst delete mode 100644 docs/source/module/utils/types/coordinates.rst delete mode 100644 docs/source/module/utils/types/country_code.rst delete mode 100644 docs/source/module/utils/types/index.rst delete mode 100644 docs/source/module/utils/types/interfaces.rst delete mode 100644 docs/source/module/utils/types/ip_address.rst delete mode 100644 docs/source/module/utils/types/netbox_router.rst delete mode 100644 docs/source/module/utils/types/site_name.rst delete mode 100644 docs/source/module/utils/types/tt_number.rst delete mode 100644 docs/source/module/utils/types/unique_field.rst delete mode 100644 docs/source/module/utils/workflow_steps.rst delete mode 100644 docs/source/module/workflows/edge_port/create_edge_port.rst delete mode 100644 docs/source/module/workflows/edge_port/create_imported_edge_port.rst delete mode 100644 docs/source/module/workflows/edge_port/import_edge_port.rst delete mode 100644 docs/source/module/workflows/edge_port/index.rst delete mode 100644 docs/source/module/workflows/edge_port/modify_edge_port.rst delete mode 100644 docs/source/module/workflows/edge_port/terminate_edge_port.rst delete mode 100644 docs/source/module/workflows/edge_port/validate_edge_port.rst delete mode 100644 docs/source/module/workflows/index.rst delete mode 100644 docs/source/module/workflows/iptrunk/activate_iptrunk.rst delete mode 100644 docs/source/module/workflows/iptrunk/create_imported_iptrunk.rst delete mode 100644 docs/source/module/workflows/iptrunk/create_iptrunk.rst delete mode 100644 docs/source/module/workflows/iptrunk/deploy_twamp.rst delete mode 100644 docs/source/module/workflows/iptrunk/import_iptrunk.rst delete mode 100644 docs/source/module/workflows/iptrunk/index.rst delete mode 100644 docs/source/module/workflows/iptrunk/migrate_iptrunk.rst delete mode 100644 docs/source/module/workflows/iptrunk/modify_isis_metric.rst delete mode 100644 docs/source/module/workflows/iptrunk/modify_trunk_interface.rst delete mode 100644 docs/source/module/workflows/iptrunk/terminate_iptrunk.rst delete mode 100644 docs/source/module/workflows/iptrunk/validate_iptrunk.rst delete mode 100644 docs/source/module/workflows/l2_circuit/nren_l3_core_service/create_imported_layer_2_circuit.rst delete mode 100644 docs/source/module/workflows/l2_circuit/nren_l3_core_service/create_layer_2_circuit.rst delete mode 100644 docs/source/module/workflows/l2_circuit/nren_l3_core_service/import_layer_2_circuit.rst delete mode 100644 docs/source/module/workflows/l2_circuit/nren_l3_core_service/index.rst delete mode 100644 docs/source/module/workflows/l2_circuit/nren_l3_core_service/modify_layer_2_circuit.rst delete mode 100644 docs/source/module/workflows/lan_switch_interconnect/create_imported_lan_switch_interconnect.rst delete mode 100644 docs/source/module/workflows/lan_switch_interconnect/create_lan_switch_interconnect.rst delete mode 100644 docs/source/module/workflows/lan_switch_interconnect/import_lan_switch_interconnect.rst delete mode 100644 docs/source/module/workflows/lan_switch_interconnect/index.rst delete mode 100644 docs/source/module/workflows/lan_switch_interconnect/terminate_lan_switch_interconnect.rst delete mode 100644 docs/source/module/workflows/lan_switch_interconnect/validate_lan_switch_interconnect.rst delete mode 100644 docs/source/module/workflows/nren_l3_core_service/create_imported_nren_l3_core_service.rst delete mode 100644 docs/source/module/workflows/nren_l3_core_service/create_nren_l3_core_service.rst delete mode 100644 docs/source/module/workflows/nren_l3_core_service/import_nren_l3_core_service.rst delete mode 100644 docs/source/module/workflows/nren_l3_core_service/index.rst delete mode 100644 docs/source/module/workflows/nren_l3_core_service/migrate_nren_l3_core_service.rst delete mode 100644 docs/source/module/workflows/nren_l3_core_service/modify_nren_l3_core_service.rst delete mode 100644 docs/source/module/workflows/office_router/create_imported_office_router.rst delete mode 100644 docs/source/module/workflows/office_router/import_office_router.rst delete mode 100644 docs/source/module/workflows/office_router/index.rst delete mode 100644 docs/source/module/workflows/opengear/create_imported_opengear.rst delete mode 100644 docs/source/module/workflows/opengear/import_opengear.rst delete mode 100644 docs/source/module/workflows/opengear/index.rst delete mode 100644 docs/source/module/workflows/router/activate_router.rst delete mode 100644 docs/source/module/workflows/router/create_imported_router.rst delete mode 100644 docs/source/module/workflows/router/create_router.rst delete mode 100644 docs/source/module/workflows/router/import_router.rst delete mode 100644 docs/source/module/workflows/router/index.rst delete mode 100644 docs/source/module/workflows/router/modify_connection_strategy.rst delete mode 100644 docs/source/module/workflows/router/modify_kentik_license.rst delete mode 100644 docs/source/module/workflows/router/promote_p_to_pe.rst delete mode 100644 docs/source/module/workflows/router/redeploy_base_config.rst delete mode 100644 docs/source/module/workflows/router/terminate_router.rst delete mode 100644 docs/source/module/workflows/router/update_ibgp_mesh.rst delete mode 100644 docs/source/module/workflows/router/validate_router.rst delete mode 100644 docs/source/module/workflows/site/create_imported_site.rst delete mode 100644 docs/source/module/workflows/site/create_site.rst delete mode 100644 docs/source/module/workflows/site/import_site.rst delete mode 100644 docs/source/module/workflows/site/index.rst delete mode 100644 docs/source/module/workflows/site/modify_site.rst delete mode 100644 docs/source/module/workflows/site/terminate_site.rst delete mode 100644 docs/source/module/workflows/super_pop_switch/create_imported_super_pop_switch.rst delete mode 100644 docs/source/module/workflows/super_pop_switch/import_super_pop_switch.rst delete mode 100644 docs/source/module/workflows/super_pop_switch/index.rst delete mode 100644 docs/source/module/workflows/switch/activate_switch.rst delete mode 100644 docs/source/module/workflows/switch/create_imported_switch.rst delete mode 100644 docs/source/module/workflows/switch/create_switch.rst delete mode 100644 docs/source/module/workflows/switch/import_switch.rst delete mode 100644 docs/source/module/workflows/switch/index.rst delete mode 100644 docs/source/module/workflows/switch/terminate_switch.rst delete mode 100644 docs/source/module/workflows/switch/validate_switch.rst delete mode 100644 docs/source/module/workflows/tasks/clean_old_tasks.rst delete mode 100644 docs/source/module/workflows/tasks/create_partners.rst delete mode 100644 docs/source/module/workflows/tasks/delete_partners.rst delete mode 100644 docs/source/module/workflows/tasks/index.rst delete mode 100644 docs/source/module/workflows/tasks/modify_partners.rst delete mode 100644 docs/source/module/workflows/tasks/send_email_notifications.rst delete mode 100644 docs/source/module/workflows/tasks/validate_geant_products.rst delete mode 100644 docs/source/modules.rst delete mode 100644 docs/source/quickstart.rst delete mode 100644 docs/source/static/custom.css delete mode 100644 docs/source/static/custom.js delete mode 100644 docs/source/static/geant_logo_white.svg create mode 100644 mkdocs.yml diff --git a/build-docs.sh b/build-docs.sh index f68d5ad6d..02e3a4189 100755 --- a/build-docs.sh +++ b/build-docs.sh @@ -5,7 +5,6 @@ set -o nounset export OSS_PARAMS_FILENAME=../gso/oss-params-example.json export TESTING=true -pip install sphinx_rtd_theme sphinxcontrib-jquery +pip install mkdocstrings-python mkdocs_gen_files mkdocs-material mkdocs-literate-nav mkdocs-section-index -cd docs -sphinx-build source build +mkdocs build diff --git a/docs/overrides/partials/logo.html b/docs/overrides/partials/logo.html new file mode 100644 index 000000000..6987372c0 --- /dev/null +++ b/docs/overrides/partials/logo.html @@ -0,0 +1,2 @@ +<img id="logo_light_mode" src="{{ config.theme.logo_light_mode | url }}" alt="logo"> +<img id="logo_dark_mode" src="{{ config.theme.logo_dark_mode | url }}" alt="logo"> diff --git a/docs/scripts/gen_ref_pages.py b/docs/scripts/gen_ref_pages.py new file mode 100644 index 000000000..06843d7dc --- /dev/null +++ b/docs/scripts/gen_ref_pages.py @@ -0,0 +1,38 @@ +"""Generate the code reference pages. + +Source: https://mkdocstrings.github.io/recipes/ +""" + +from pathlib import Path + +import mkdocs_gen_files + +nav = mkdocs_gen_files.Nav() + +root = Path(__file__).parent.parent +src = root / "gso" + +for path in sorted(src.rglob("*.py")): + module_path = path.relative_to(src).with_suffix("") + doc_path = path.relative_to(src).with_suffix(".md") + full_doc_path = Path("reference", doc_path) + + parts = tuple(module_path.parts) + + if parts[-1] == "__init__": + parts = parts[:-1] + doc_path = doc_path.with_name("index.md") + full_doc_path = full_doc_path.with_name("index.md") + elif parts[-1] == "__main__": + continue + + nav[parts] = doc_path.as_posix() + + with mkdocs_gen_files.open(full_doc_path, "w") as fd: + identifier = ".".join(parts) + print("::: " + identifier, file=fd) + + mkdocs_gen_files.set_edit_path(full_doc_path, path.relative_to(root)) + +with mkdocs_gen_files.open("reference/SUMMARY.md", "w") as nav_file: + nav_file.writelines(nav.build_literate_nav()) diff --git a/docs/source/Makefile b/docs/source/Makefile deleted file mode 100644 index 43276bb92..000000000 --- a/docs/source/Makefile +++ /dev/null @@ -1,20 +0,0 @@ -# Minimal makefile for Sphinx documentation -# - -# You can set these variables from the command line, and also -# from the environment for the first two. -SPHINXOPTS ?= -SPHINXBUILD ?= sphinx-build -SOURCEDIR = . -BUILDDIR = ../build - -# Put it first so that "make" without argument is like "make help". -help: - @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) - -.PHONY: help Makefile - -# Catch-all target: route all unknown targets to Sphinx using the new -# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS). -%: Makefile - @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) diff --git a/docs/source/conf.py b/docs/source/conf.py deleted file mode 100644 index a38860b64..000000000 --- a/docs/source/conf.py +++ /dev/null @@ -1,27 +0,0 @@ -# -- Project information ----------------------------------------------------- -project = "GÉANT Service Orchestrator" -copyright = "2023-2024, GÉANT Vereniging" -author = "GÉANT Orchestration and Automation Team" - -# -- General configuration --------------------------------------------------- -extensions = ["sphinx_rtd_theme", "sphinx.ext.autodoc", "sphinxcontrib.jquery"] - -templates_path = ["templates"] -exclude_patterns = ["build", "Thumbs.db", ".DS_Store", "venv", "vale", "__init__.py"] - -# -- Options for HTML output ------------------------------------------------- -html_theme = "sphinx_rtd_theme" -html_static_path = ["static"] -html_theme_options = { - "style_nav_header_background": "rgb(0 63 95)", -} -html_css_files = ["custom.css"] -html_js_files = ["custom.js"] -html_logo = "static/geant_logo_white.svg" - -# Both the class' and the ``__init__`` method's docstring are concatenated and inserted. -autoclass_content = "both" -autodoc_typehints = "none" - -# Display todos by setting to True -todo_include_todos = True diff --git a/docs/source/glossary.rst b/docs/source/glossary.rst deleted file mode 100644 index b646c999f..000000000 --- a/docs/source/glossary.rst +++ /dev/null @@ -1,121 +0,0 @@ -Glossary of terms -================= - -.. glossary:: - - AAI - Authentication and Authorisation Infrastructure - - API - Application Programming Interface - - BFD - Bi-directional Forwarding Detection - - BGP - Border Gateway Protocol: a path vector routing protocol described in - `RFC 4271 <https://datatracker.ietf.org/doc/html/rfc4271>`_. - - CIDR - Classless Inter-Domain Routing. A method for denoting IP ranges in the form of ``9.9.0.0/16`` or - ``fe80:1234:abcd::/48``. - - CLI - Command Line Interface. - - CNAME - A type of DNS record that is used as an alias from one hostname to another - - CRUD - Create, Read, Update, Delete - - DNS - The Domain Name System. Used for correlating domain names to IP information, among others. - - FQDN - Fully Quantified Domain Name - - GAP - The GÉANT Automation Platform - - GSO - GÉANT Service Orchestrator - - IAS - IAS - - IPAM - IP Address Management - - ISIS - Intermediate System to Intermediate System: a routing protocol described in - `RFC 7142 <https://datatracker.ietf.org/doc/html/rfc7142>`_. - - ISO - International Organisation for Standardisation - - JSON - JavaScript Object Notation - - LACP - Link Aggregation Control Protocol - - LAG - Link Aggregation: a bundle of multiple network connections. - - LAN - Local Area Network - - LLDP - Link Layer Discovery Protocol - - LSO - Lightweight Service Orchestrator - - NET - Network Entity Title: used for :term:`ISIS` routing. - - NREN - National Research and Education Network - - OIDC - OpenID Connect - - OOB - Out-of-band access - - OPA - Open Policy Agent - - OSS - Operational Support Systems - - SBP - Service Binding Point, a logical construct used in the orchestrator to attach a partner subscription to a physical - (set of) ports. - - SDP - Service Demarcation Point: A logical construct used for modeling partner subscriptions. It models the link between - the physical and the service domains. - - SNMP - Simple Network Management Protocol: a protocol that's used for gathering data, widely used for network management - and monitoring. - - TWAMP - A Two-Way Active Measuring Protocol, as defined in `RFC 5357 <https://datatracker.ietf.org/doc/html/rfc5357>`_. - - UUID - Universally Unique Identifier - - VLAN - Virtual LAN - - WAN - Wide Area Network - - WFO - `Workflow Orchestrator <https://workfloworchestrator.org/>`_ - - Moodi - A service that does monitoring on demand during a workflow execution. \ No newline at end of file diff --git a/docs/source/index.rst b/docs/source/index.rst deleted file mode 100644 index 5818da8af..000000000 --- a/docs/source/index.rst +++ /dev/null @@ -1,14 +0,0 @@ -GÉANT Service Orchestrator -========================== - -Welcome to the documentation of the GÉANT Service Orchestrator, or :term:`GSO` for short. - -This documentation has the following sections: - -.. toctree:: - :caption: Contents - :maxdepth: 2 - - quickstart - modules - glossary diff --git a/docs/source/module/api/index.rst b/docs/source/module/api/index.rst deleted file mode 100644 index c1e75155b..000000000 --- a/docs/source/module/api/index.rst +++ /dev/null @@ -1,15 +0,0 @@ -``gso.api`` -=========== - -.. automodule:: gso.api - :members: - :show-inheritance: - -Subpackages ------------ - -.. toctree:: - :maxdepth: 2 - :titlesonly: - - v1/index diff --git a/docs/source/module/api/v1/index.rst b/docs/source/module/api/v1/index.rst deleted file mode 100644 index 58f463a02..000000000 --- a/docs/source/module/api/v1/index.rst +++ /dev/null @@ -1,16 +0,0 @@ -``gso.api.v1`` -============== - -.. automodule:: gso.api.v1 - :members: - :show-inheritance: - -Submodules ----------- - -.. toctree:: - :maxdepth: 2 - :titlesonly: - - subscriptions - network diff --git a/docs/source/module/api/v1/network.rst b/docs/source/module/api/v1/network.rst deleted file mode 100644 index a37f21d30..000000000 --- a/docs/source/module/api/v1/network.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.api.v1.network`` -====================== - -.. automodule:: gso.api.v1.network - :members: - :show-inheritance: diff --git a/docs/source/module/api/v1/subscriptions.rst b/docs/source/module/api/v1/subscriptions.rst deleted file mode 100644 index 4af3a7828..000000000 --- a/docs/source/module/api/v1/subscriptions.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.api.v1.subscriptions`` -============================ - -.. automodule:: gso.api.v1.subscriptions - :members: - :show-inheritance: diff --git a/docs/source/module/auth/api_key_auth.rst b/docs/source/module/auth/api_key_auth.rst deleted file mode 100644 index d17327cf8..000000000 --- a/docs/source/module/auth/api_key_auth.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.auth.api_key_auth`` -========================= - -.. automodule:: gso.auth.api_key_auth - :members: - :show-inheritance: diff --git a/docs/source/module/auth/index.rst b/docs/source/module/auth/index.rst deleted file mode 100644 index ec638c781..000000000 --- a/docs/source/module/auth/index.rst +++ /dev/null @@ -1,16 +0,0 @@ -``gso.auth`` -============ - -.. automodule:: gso.auth - :members: - :show-inheritance: - -Subpackages ------------ - -.. toctree:: - :maxdepth: 1 - - api_key_auth - oidc - opa diff --git a/docs/source/module/auth/oidc.rst b/docs/source/module/auth/oidc.rst deleted file mode 100644 index aa4eda940..000000000 --- a/docs/source/module/auth/oidc.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.auth.oidc`` -================= - -.. automodule:: gso.auth.oidc - :members: - :show-inheritance: diff --git a/docs/source/module/auth/opa.rst b/docs/source/module/auth/opa.rst deleted file mode 100644 index bd91aaccb..000000000 --- a/docs/source/module/auth/opa.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.auth.opa`` -================ - -.. automodule:: gso.auth.opa - :members: - :show-inheritance: diff --git a/docs/source/module/cli/imports.rst b/docs/source/module/cli/imports.rst deleted file mode 100644 index 5abfc3dda..000000000 --- a/docs/source/module/cli/imports.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.cli.imports`` -=================== - -.. automodule:: gso.cli.imports - :members: - :show-inheritance: diff --git a/docs/source/module/cli/index.rst b/docs/source/module/cli/index.rst deleted file mode 100644 index 7c105a3c6..000000000 --- a/docs/source/module/cli/index.rst +++ /dev/null @@ -1,16 +0,0 @@ -``gso.cli`` -=========== - -.. automodule:: gso.cli - :members: - :show-inheritance: - -Submodules ----------- - -.. toctree:: - :maxdepth: 2 - :titlesonly: - - imports - netbox diff --git a/docs/source/module/cli/netbox.rst b/docs/source/module/cli/netbox.rst deleted file mode 100644 index 8d379335e..000000000 --- a/docs/source/module/cli/netbox.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.cli.netbox`` -================== - -.. automodule:: gso.cli.netbox - :members: - :show-inheritance: diff --git a/docs/source/module/products/index.rst b/docs/source/module/products/index.rst deleted file mode 100644 index 75e79f797..000000000 --- a/docs/source/module/products/index.rst +++ /dev/null @@ -1,15 +0,0 @@ -``gso.products`` -================ - -.. automodule:: gso.products - :members: - :show-inheritance: - -Subpackages ------------ - -.. toctree:: - :maxdepth: 1 - - product_blocks/index - product_types/index diff --git a/docs/source/module/products/product_blocks/bgp_session.rst b/docs/source/module/products/product_blocks/bgp_session.rst deleted file mode 100644 index 5d3fe341e..000000000 --- a/docs/source/module/products/product_blocks/bgp_session.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.products.product_blocks.bgp_session`` -=========================================== - -.. automodule:: gso.products.product_blocks.bgp_session - :members: - :show-inheritance: diff --git a/docs/source/module/products/product_blocks/edge_port.rst b/docs/source/module/products/product_blocks/edge_port.rst deleted file mode 100644 index 4d6dbf1f3..000000000 --- a/docs/source/module/products/product_blocks/edge_port.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.products.product_blocks.edge_port`` -========================================= - -.. automodule:: gso.products.product_blocks.edge_port - :members: - :show-inheritance: diff --git a/docs/source/module/products/product_blocks/index.rst b/docs/source/module/products/product_blocks/index.rst deleted file mode 100644 index f7f2c8678..000000000 --- a/docs/source/module/products/product_blocks/index.rst +++ /dev/null @@ -1,29 +0,0 @@ -``gso.products.product_blocks`` -=============================== - -``gso.products.product_blocks`` package ---------------------------------------- - -.. automodule:: gso.products.product_blocks - :members: - :show-inheritance: - -Submodules ----------- - -.. toctree:: - :maxdepth: 1 - - bgp_session - edge_port - iptrunk - lan_switch_interconnect - nren_l3_core_service - office_router - opengear - pop_vlan - router - service_binding_port - site - super_pop_switch - switch diff --git a/docs/source/module/products/product_blocks/iptrunk.rst b/docs/source/module/products/product_blocks/iptrunk.rst deleted file mode 100644 index 150b7cbad..000000000 --- a/docs/source/module/products/product_blocks/iptrunk.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.products.product_blocks.iptrunk`` -======================================= - -.. automodule:: gso.products.product_blocks.iptrunk - :members: - :show-inheritance: diff --git a/docs/source/module/products/product_blocks/lan_switch_interconnect.rst b/docs/source/module/products/product_blocks/lan_switch_interconnect.rst deleted file mode 100644 index 2b9805da2..000000000 --- a/docs/source/module/products/product_blocks/lan_switch_interconnect.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.products.product_blocks.lan_switch_interconnect`` -======================================================= - -.. automodule:: gso.products.product_blocks.lan_switch_interconnect - :members: - :show-inheritance: diff --git a/docs/source/module/products/product_blocks/nren_l3_core_service.rst b/docs/source/module/products/product_blocks/nren_l3_core_service.rst deleted file mode 100644 index 53e849d98..000000000 --- a/docs/source/module/products/product_blocks/nren_l3_core_service.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.products.product_blocks.nren_l3_core_service`` -==================================================== - -.. automodule:: gso.products.product_blocks.nren_l3_core_service - :members: - :show-inheritance: diff --git a/docs/source/module/products/product_blocks/office_router.rst b/docs/source/module/products/product_blocks/office_router.rst deleted file mode 100644 index 4d6b64f99..000000000 --- a/docs/source/module/products/product_blocks/office_router.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.products.product_blocks.office_router`` -============================================= - -.. automodule:: gso.products.product_blocks.office_router - :members: - :show-inheritance: diff --git a/docs/source/module/products/product_blocks/opengear.rst b/docs/source/module/products/product_blocks/opengear.rst deleted file mode 100644 index 14f5c3d38..000000000 --- a/docs/source/module/products/product_blocks/opengear.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.products.product_blocks.opengear`` -======================================== - -.. automodule:: gso.products.product_blocks.opengear - :members: - :show-inheritance: diff --git a/docs/source/module/products/product_blocks/pop_vlan.rst b/docs/source/module/products/product_blocks/pop_vlan.rst deleted file mode 100644 index de5f3a833..000000000 --- a/docs/source/module/products/product_blocks/pop_vlan.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.products.product_blocks.pop_vlan`` -======================================== - -.. automodule:: gso.products.product_blocks.pop_vlan - :members: - :show-inheritance: diff --git a/docs/source/module/products/product_blocks/router.rst b/docs/source/module/products/product_blocks/router.rst deleted file mode 100644 index 4ef96d9cb..000000000 --- a/docs/source/module/products/product_blocks/router.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.products.product_blocks.router`` -====================================== - -.. automodule:: gso.products.product_blocks.router - :members: - :show-inheritance: diff --git a/docs/source/module/products/product_blocks/service_binding_port.rst b/docs/source/module/products/product_blocks/service_binding_port.rst deleted file mode 100644 index a7036dc21..000000000 --- a/docs/source/module/products/product_blocks/service_binding_port.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.products.product_blocks.service_binding_port`` -==================================================== - -.. automodule:: gso.products.product_blocks.service_binding_port - :members: - :show-inheritance: diff --git a/docs/source/module/products/product_blocks/site.rst b/docs/source/module/products/product_blocks/site.rst deleted file mode 100644 index 4b1415f44..000000000 --- a/docs/source/module/products/product_blocks/site.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.products.product_blocks.site`` -==================================== - -.. automodule:: gso.products.product_blocks.site - :members: - :show-inheritance: diff --git a/docs/source/module/products/product_blocks/super_pop_switch.rst b/docs/source/module/products/product_blocks/super_pop_switch.rst deleted file mode 100644 index 1f3808a75..000000000 --- a/docs/source/module/products/product_blocks/super_pop_switch.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.products.product_blocks.super_pop_switch`` -================================================ - -.. automodule:: gso.products.product_blocks.super_pop_switch - :members: - :show-inheritance: diff --git a/docs/source/module/products/product_blocks/switch.rst b/docs/source/module/products/product_blocks/switch.rst deleted file mode 100644 index a2041d513..000000000 --- a/docs/source/module/products/product_blocks/switch.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.products.product_blocks.switch`` -====================================== - -.. automodule:: gso.products.product_blocks.switch - :members: - :show-inheritance: diff --git a/docs/source/module/products/product_types/edge_port.rst b/docs/source/module/products/product_types/edge_port.rst deleted file mode 100644 index ae7140595..000000000 --- a/docs/source/module/products/product_types/edge_port.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.products.product_types.edge_port`` -======================================== - -.. automodule:: gso.products.product_types.edge_port - :members: - :show-inheritance: diff --git a/docs/source/module/products/product_types/index.rst b/docs/source/module/products/product_types/index.rst deleted file mode 100644 index 70f882d36..000000000 --- a/docs/source/module/products/product_types/index.rst +++ /dev/null @@ -1,27 +0,0 @@ -``gso.products.product_types`` -============================== - -``gso.products.product_types`` package --------------------------------------- - -.. automodule:: gso.products.product_types - :members: - :show-inheritance: - -Submodules ----------- - -.. toctree:: - :maxdepth: 1 - - edge_port - iptrunk - lan_switch_interconnect - nren_l3_core_service - office_router - opengear - pop_vlan - router - site - super_pop_switch - switch diff --git a/docs/source/module/products/product_types/iptrunk.rst b/docs/source/module/products/product_types/iptrunk.rst deleted file mode 100644 index 66f2de346..000000000 --- a/docs/source/module/products/product_types/iptrunk.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.products.product_types.iptrunk`` -====================================== - -.. automodule:: gso.products.product_types.iptrunk - :members: - :show-inheritance: diff --git a/docs/source/module/products/product_types/lan_switch_interconnect.rst b/docs/source/module/products/product_types/lan_switch_interconnect.rst deleted file mode 100644 index c740da278..000000000 --- a/docs/source/module/products/product_types/lan_switch_interconnect.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.products.product_types.lan_switch_interconnect`` -======================================================= - -.. automodule:: gso.products.product_types.lan_switch_interconnect - :members: - :show-inheritance: diff --git a/docs/source/module/products/product_types/nren_l3_core_service.rst b/docs/source/module/products/product_types/nren_l3_core_service.rst deleted file mode 100644 index 4440d033b..000000000 --- a/docs/source/module/products/product_types/nren_l3_core_service.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.products.product_types.nren_l3_core_service`` -=================================================== - -.. automodule:: gso.products.product_types.nren_l3_core_service - :members: - :show-inheritance: diff --git a/docs/source/module/products/product_types/office_router.rst b/docs/source/module/products/product_types/office_router.rst deleted file mode 100644 index d6e5b9974..000000000 --- a/docs/source/module/products/product_types/office_router.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.products.product_types.office_router`` -============================================ - -.. automodule:: gso.products.product_types.office_router - :members: - :show-inheritance: diff --git a/docs/source/module/products/product_types/opengear.rst b/docs/source/module/products/product_types/opengear.rst deleted file mode 100644 index 9bb652499..000000000 --- a/docs/source/module/products/product_types/opengear.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.products.product_types.opengear`` -======================================= - -.. automodule:: gso.products.product_types.opengear - :members: - :show-inheritance: diff --git a/docs/source/module/products/product_types/pop_vlan.rst b/docs/source/module/products/product_types/pop_vlan.rst deleted file mode 100644 index 0549d5bd7..000000000 --- a/docs/source/module/products/product_types/pop_vlan.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.products.product_types.pop_vlan`` -======================================= - -.. automodule:: gso.products.product_types.pop_vlan - :members: - :show-inheritance: diff --git a/docs/source/module/products/product_types/router.rst b/docs/source/module/products/product_types/router.rst deleted file mode 100644 index ec22c9a39..000000000 --- a/docs/source/module/products/product_types/router.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.products.product_types.router`` -===================================== - -.. automodule:: gso.products.product_types.router - :members: - :show-inheritance: diff --git a/docs/source/module/products/product_types/site.rst b/docs/source/module/products/product_types/site.rst deleted file mode 100644 index 2a24bffed..000000000 --- a/docs/source/module/products/product_types/site.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.products.product_types.site`` -=================================== - -.. automodule:: gso.products.product_types.site - :members: - :show-inheritance: diff --git a/docs/source/module/products/product_types/super_pop_switch.rst b/docs/source/module/products/product_types/super_pop_switch.rst deleted file mode 100644 index 442e48ffe..000000000 --- a/docs/source/module/products/product_types/super_pop_switch.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.products.product_types.super_pop_switch`` -=============================================== - -.. automodule:: gso.products.product_types.super_pop_switch - :members: - :show-inheritance: diff --git a/docs/source/module/products/product_types/switch.rst b/docs/source/module/products/product_types/switch.rst deleted file mode 100644 index 530222ba2..000000000 --- a/docs/source/module/products/product_types/switch.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.products.product_types.switch`` -===================================== - -.. automodule:: gso.products.product_types.switch - :members: - :show-inheritance: diff --git a/docs/source/module/schedules/clean_old_tasks.rst b/docs/source/module/schedules/clean_old_tasks.rst deleted file mode 100644 index 5d279b5ce..000000000 --- a/docs/source/module/schedules/clean_old_tasks.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.schedules.clean_old_tasks`` -================================= - -.. automodule:: gso.schedules.clean_old_tasks - :members: - :show-inheritance: diff --git a/docs/source/module/schedules/index.rst b/docs/source/module/schedules/index.rst deleted file mode 100644 index 947b330a8..000000000 --- a/docs/source/module/schedules/index.rst +++ /dev/null @@ -1,22 +0,0 @@ -``gso.schedules`` -================= - -``gso.schedules`` package -------------------------- - -.. automodule:: gso.schedules - :members: - :show-inheritance: - -Submodules ----------- - -.. toctree:: - :maxdepth: 1 - - clean_old_tasks - scheduling - send_email_notifications - task_vacuum - validate_products - validate_subscriptions diff --git a/docs/source/module/schedules/scheduling.rst b/docs/source/module/schedules/scheduling.rst deleted file mode 100644 index 28ffe1c46..000000000 --- a/docs/source/module/schedules/scheduling.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.schedules.scheduling`` -============================ - -.. automodule:: gso.schedules.scheduling - :members: - :show-inheritance: diff --git a/docs/source/module/schedules/send_email_notifications.rst b/docs/source/module/schedules/send_email_notifications.rst deleted file mode 100644 index ddc597afb..000000000 --- a/docs/source/module/schedules/send_email_notifications.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.schedules.send_email_notifications`` -========================================== - -.. automodule:: gso.schedules.send_email_notifications - :members: - :show-inheritance: diff --git a/docs/source/module/schedules/task_vacuum.rst b/docs/source/module/schedules/task_vacuum.rst deleted file mode 100644 index c167e5f40..000000000 --- a/docs/source/module/schedules/task_vacuum.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.schedules.task_vacuum`` -============================= - -.. automodule:: gso.schedules.task_vacuum - :members: - :show-inheritance: diff --git a/docs/source/module/schedules/validate_products.rst b/docs/source/module/schedules/validate_products.rst deleted file mode 100644 index b8a1cbbf8..000000000 --- a/docs/source/module/schedules/validate_products.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.schedules.validate_products`` -=================================== - -.. automodule:: gso.schedules.validate_products - :members: - :show-inheritance: diff --git a/docs/source/module/schedules/validate_subscriptions.rst b/docs/source/module/schedules/validate_subscriptions.rst deleted file mode 100644 index bd85dc6ed..000000000 --- a/docs/source/module/schedules/validate_subscriptions.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.schedules.validate_subscriptions`` -======================================== - -.. automodule:: gso.schedules.validate_subscriptions - :members: - :show-inheritance: diff --git a/docs/source/module/services/index.rst b/docs/source/module/services/index.rst deleted file mode 100644 index e7b017125..000000000 --- a/docs/source/module/services/index.rst +++ /dev/null @@ -1,24 +0,0 @@ -``gso.services`` -================ - -.. automodule:: gso.services - :members: - :show-inheritance: - -Submodules ----------- - -.. toctree:: - :maxdepth: 2 - :titlesonly: - - infoblox - kentik_client - librenms_client - lso_client - mailer - netbox_client - partners - processes - sharepoint - subscriptions diff --git a/docs/source/module/services/infoblox.rst b/docs/source/module/services/infoblox.rst deleted file mode 100644 index d05316c9a..000000000 --- a/docs/source/module/services/infoblox.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.services.infoblox`` -========================= - -.. automodule:: gso.services.infoblox - :members: - :show-inheritance: diff --git a/docs/source/module/services/kentik_client.rst b/docs/source/module/services/kentik_client.rst deleted file mode 100644 index b8090e23e..000000000 --- a/docs/source/module/services/kentik_client.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.services.kentik_client`` -============================== - -.. automodule:: gso.services.kentik_client - :members: - :show-inheritance: diff --git a/docs/source/module/services/librenms_client.rst b/docs/source/module/services/librenms_client.rst deleted file mode 100644 index 70243bb70..000000000 --- a/docs/source/module/services/librenms_client.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.services.librenms_client`` -================================ - -.. automodule:: gso.services.librenms_client - :members: - :show-inheritance: diff --git a/docs/source/module/services/lso_client.rst b/docs/source/module/services/lso_client.rst deleted file mode 100644 index 98b9eee9b..000000000 --- a/docs/source/module/services/lso_client.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.services.lso_client`` -=========================== - -.. automodule:: gso.services.lso_client - :members: - :show-inheritance: diff --git a/docs/source/module/services/mailer.rst b/docs/source/module/services/mailer.rst deleted file mode 100644 index f54148cfe..000000000 --- a/docs/source/module/services/mailer.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.services.mailer`` -======================= - -.. automodule:: gso.services.mailer - :members: - :show-inheritance: diff --git a/docs/source/module/services/netbox_client.rst b/docs/source/module/services/netbox_client.rst deleted file mode 100644 index 26891ede7..000000000 --- a/docs/source/module/services/netbox_client.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.services.netbox_client`` -============================== - -.. automodule:: gso.services.netbox_client - :members: - :show-inheritance: diff --git a/docs/source/module/services/partners.rst b/docs/source/module/services/partners.rst deleted file mode 100644 index a828b5a31..000000000 --- a/docs/source/module/services/partners.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.services.partners`` -========================= - -.. automodule:: gso.services.partners - :members: - :show-inheritance: diff --git a/docs/source/module/services/processes.rst b/docs/source/module/services/processes.rst deleted file mode 100644 index 7d7ffe612..000000000 --- a/docs/source/module/services/processes.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.services.processes`` -========================== - -.. automodule:: gso.services.processes - :members: - :show-inheritance: diff --git a/docs/source/module/services/sharepoint.rst b/docs/source/module/services/sharepoint.rst deleted file mode 100644 index 13d5d5b63..000000000 --- a/docs/source/module/services/sharepoint.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.services.sharepoint`` -=========================== - -.. automodule:: gso.services.sharepoint - :members: - :show-inheritance: diff --git a/docs/source/module/services/subscriptions.rst b/docs/source/module/services/subscriptions.rst deleted file mode 100644 index 8b2bfbed5..000000000 --- a/docs/source/module/services/subscriptions.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.services.subscriptions`` -============================== - -.. automodule:: gso.services.subscriptions - :members: - :show-inheritance: diff --git a/docs/source/module/utils/device_info.rst b/docs/source/module/utils/device_info.rst deleted file mode 100644 index 4a332bd7d..000000000 --- a/docs/source/module/utils/device_info.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.utils.device_info`` -========================= - -.. automodule:: gso.utils.device_info - :members: - :show-inheritance: diff --git a/docs/source/module/utils/exceptions.rst b/docs/source/module/utils/exceptions.rst deleted file mode 100644 index 98414a525..000000000 --- a/docs/source/module/utils/exceptions.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.utils.exceptions`` -======================== - -.. automodule:: gso.utils.exceptions - :members: - :show-inheritance: diff --git a/docs/source/module/utils/helpers.rst b/docs/source/module/utils/helpers.rst deleted file mode 100644 index 89717887b..000000000 --- a/docs/source/module/utils/helpers.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.utils.helpers`` -===================== - -.. automodule:: gso.utils.helpers - :members: - :show-inheritance: diff --git a/docs/source/module/utils/index.rst b/docs/source/module/utils/index.rst deleted file mode 100644 index 728969073..000000000 --- a/docs/source/module/utils/index.rst +++ /dev/null @@ -1,27 +0,0 @@ -``gso.utils`` -============= - -.. automodule:: gso.utils - :members: - :show-inheritance: - -Subpackages ------------ - -.. toctree:: - :maxdepth: 1 - - types/index - -Submodules ----------- - -.. toctree:: - :maxdepth: 2 - :titlesonly: - - device_info - exceptions - helpers - shared_enums - workflow_steps diff --git a/docs/source/module/utils/shared_enums.rst b/docs/source/module/utils/shared_enums.rst deleted file mode 100644 index 5fe261d49..000000000 --- a/docs/source/module/utils/shared_enums.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.utils.shared_enums`` -========================== - -.. automodule:: gso.utils.shared_enums - :members: - :show-inheritance: diff --git a/docs/source/module/utils/types/base_site.rst b/docs/source/module/utils/types/base_site.rst deleted file mode 100644 index ac952086a..000000000 --- a/docs/source/module/utils/types/base_site.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.utils.types.base_site`` -============================= - -.. automodule:: gso.utils.types.base_site - :members: - :show-inheritance: diff --git a/docs/source/module/utils/types/coordinates.rst b/docs/source/module/utils/types/coordinates.rst deleted file mode 100644 index 85c52ba10..000000000 --- a/docs/source/module/utils/types/coordinates.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.utils.types.coordinates`` -=============================== - -.. automodule:: gso.utils.types.coordinates - :members: - :show-inheritance: diff --git a/docs/source/module/utils/types/country_code.rst b/docs/source/module/utils/types/country_code.rst deleted file mode 100644 index 130b77afb..000000000 --- a/docs/source/module/utils/types/country_code.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.utils.types.country_code`` -================================ - -.. automodule:: gso.utils.types.country_code - :members: - :show-inheritance: diff --git a/docs/source/module/utils/types/index.rst b/docs/source/module/utils/types/index.rst deleted file mode 100644 index 2dcf23ec9..000000000 --- a/docs/source/module/utils/types/index.rst +++ /dev/null @@ -1,24 +0,0 @@ -``gso.utils.types`` -=================== - -.. automodule:: gso.utils.types - :members: - :show-inheritance: - - -Submodules ----------- - -.. toctree:: - :maxdepth: 2 - :titlesonly: - - base_site - coordinates - country_code - interfaces - ip_address - netbox_router - site_name - tt_number - unique_field diff --git a/docs/source/module/utils/types/interfaces.rst b/docs/source/module/utils/types/interfaces.rst deleted file mode 100644 index 95c9a3dac..000000000 --- a/docs/source/module/utils/types/interfaces.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.utils.types.interfaces`` -============================== - -.. automodule:: gso.utils.types.interfaces - :members: - :show-inheritance: diff --git a/docs/source/module/utils/types/ip_address.rst b/docs/source/module/utils/types/ip_address.rst deleted file mode 100644 index 68858af76..000000000 --- a/docs/source/module/utils/types/ip_address.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.utils.types.ip_address`` -============================== - -.. automodule:: gso.utils.types.ip_address - :members: - :show-inheritance: diff --git a/docs/source/module/utils/types/netbox_router.rst b/docs/source/module/utils/types/netbox_router.rst deleted file mode 100644 index 1d35d235e..000000000 --- a/docs/source/module/utils/types/netbox_router.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.utils.types.netbox_router`` -================================= - -.. automodule:: gso.utils.types.netbox_router - :members: - :show-inheritance: diff --git a/docs/source/module/utils/types/site_name.rst b/docs/source/module/utils/types/site_name.rst deleted file mode 100644 index df2934a6d..000000000 --- a/docs/source/module/utils/types/site_name.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.utils.types.site_name`` -============================= - -.. automodule:: gso.utils.types.site_name - :members: - :show-inheritance: diff --git a/docs/source/module/utils/types/tt_number.rst b/docs/source/module/utils/types/tt_number.rst deleted file mode 100644 index 43410a353..000000000 --- a/docs/source/module/utils/types/tt_number.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.utils.types.tt_number`` -============================= - -.. automodule:: gso.utils.types.tt_number - :members: - :show-inheritance: diff --git a/docs/source/module/utils/types/unique_field.rst b/docs/source/module/utils/types/unique_field.rst deleted file mode 100644 index 3a74a0d1f..000000000 --- a/docs/source/module/utils/types/unique_field.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.utils.types.unique_field`` -================================ - -.. automodule:: gso.utils.types.unique_field - :members: - :show-inheritance: diff --git a/docs/source/module/utils/workflow_steps.rst b/docs/source/module/utils/workflow_steps.rst deleted file mode 100644 index 050c063dc..000000000 --- a/docs/source/module/utils/workflow_steps.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.utils.workflow_steps`` -============================ - -.. automodule:: gso.utils.workflow_steps - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/edge_port/create_edge_port.rst b/docs/source/module/workflows/edge_port/create_edge_port.rst deleted file mode 100644 index 7cedc8078..000000000 --- a/docs/source/module/workflows/edge_port/create_edge_port.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.edge_port.create_edge_port`` -============================================ - -.. automodule:: gso.workflows.edge_port.create_edge_port - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/edge_port/create_imported_edge_port.rst b/docs/source/module/workflows/edge_port/create_imported_edge_port.rst deleted file mode 100644 index 38b8d7de0..000000000 --- a/docs/source/module/workflows/edge_port/create_imported_edge_port.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.edge_port.create_imported_edge_port`` -===================================================== - -.. automodule:: gso.workflows.edge_port.create_imported_edge_port - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/edge_port/import_edge_port.rst b/docs/source/module/workflows/edge_port/import_edge_port.rst deleted file mode 100644 index 31d54a707..000000000 --- a/docs/source/module/workflows/edge_port/import_edge_port.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.edge_port.import_edge_port`` -============================================ - -.. automodule:: gso.workflows.edge_port.import_edge_port - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/edge_port/index.rst b/docs/source/module/workflows/edge_port/index.rst deleted file mode 100644 index 51d11ff47..000000000 --- a/docs/source/module/workflows/edge_port/index.rst +++ /dev/null @@ -1,20 +0,0 @@ -``gso.workflows.edge_port`` -=========================== - -.. automodule:: gso.workflows.edge_port - :members: - :show-inheritance: - -Submodules ----------- - -.. toctree:: - :maxdepth: 2 - :titlesonly: - - create_edge_port - modify_edge_port - terminate_edge_port - validate_edge_port - import_edge_port - create_imported_edge_port diff --git a/docs/source/module/workflows/edge_port/modify_edge_port.rst b/docs/source/module/workflows/edge_port/modify_edge_port.rst deleted file mode 100644 index 88d013360..000000000 --- a/docs/source/module/workflows/edge_port/modify_edge_port.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.edge_port.modify_edge_port`` -============================================ - -.. automodule:: gso.workflows.edge_port.modify_edge_port - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/edge_port/terminate_edge_port.rst b/docs/source/module/workflows/edge_port/terminate_edge_port.rst deleted file mode 100644 index 4613d361d..000000000 --- a/docs/source/module/workflows/edge_port/terminate_edge_port.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.edge_port.terminate_edge_port`` -=============================================== - -.. automodule:: gso.workflows.edge_port.terminate_edge_port - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/edge_port/validate_edge_port.rst b/docs/source/module/workflows/edge_port/validate_edge_port.rst deleted file mode 100644 index a80e2eca9..000000000 --- a/docs/source/module/workflows/edge_port/validate_edge_port.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.edge_port.validate_edge_port`` -============================================== - -.. automodule:: gso.workflows.edge_port.validate_edge_port - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/index.rst b/docs/source/module/workflows/index.rst deleted file mode 100644 index 774573c9e..000000000 --- a/docs/source/module/workflows/index.rst +++ /dev/null @@ -1,23 +0,0 @@ -``gso.workflows`` -================= - -.. automodule:: gso.workflows - :members: - :show-inheritance: - -Subpackages ------------ - -.. toctree:: - :maxdepth: 2 - :titlesonly: - - edge_port/index - iptrunk/index - nren_l3_core_service/index - office_router/index - opengear/index - router/index - site/index - super_pop_switch/index - tasks/index diff --git a/docs/source/module/workflows/iptrunk/activate_iptrunk.rst b/docs/source/module/workflows/iptrunk/activate_iptrunk.rst deleted file mode 100644 index 9082a9df1..000000000 --- a/docs/source/module/workflows/iptrunk/activate_iptrunk.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.iptrunk.activate_iptrunk`` -========================================== - -.. automodule:: gso.workflows.iptrunk.activate_iptrunk - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/iptrunk/create_imported_iptrunk.rst b/docs/source/module/workflows/iptrunk/create_imported_iptrunk.rst deleted file mode 100644 index 1e0d42c73..000000000 --- a/docs/source/module/workflows/iptrunk/create_imported_iptrunk.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.iptrunk.create_imported_iptrunk`` -================================================= - -.. automodule:: gso.workflows.iptrunk.create_imported_iptrunk - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/iptrunk/create_iptrunk.rst b/docs/source/module/workflows/iptrunk/create_iptrunk.rst deleted file mode 100644 index 3105f0511..000000000 --- a/docs/source/module/workflows/iptrunk/create_iptrunk.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.iptrunk.create_iptrunk`` -======================================== - -.. automodule:: gso.workflows.iptrunk.create_iptrunk - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/iptrunk/deploy_twamp.rst b/docs/source/module/workflows/iptrunk/deploy_twamp.rst deleted file mode 100644 index 7fde13038..000000000 --- a/docs/source/module/workflows/iptrunk/deploy_twamp.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.iptrunk.deploy_twamp`` -====================================== - -.. automodule:: gso.workflows.iptrunk.deploy_twamp - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/iptrunk/import_iptrunk.rst b/docs/source/module/workflows/iptrunk/import_iptrunk.rst deleted file mode 100644 index 4d5379f9c..000000000 --- a/docs/source/module/workflows/iptrunk/import_iptrunk.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.iptrunk.import_iptrunk`` -======================================== - -.. automodule:: gso.workflows.iptrunk.import_iptrunk - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/iptrunk/index.rst b/docs/source/module/workflows/iptrunk/index.rst deleted file mode 100644 index 12e21b267..000000000 --- a/docs/source/module/workflows/iptrunk/index.rst +++ /dev/null @@ -1,24 +0,0 @@ -``gso.workflows.iptrunk`` -========================= - -.. automodule:: gso.workflows.iptrunk - :members: - :show-inheritance: - -Submodules ----------- - -.. toctree:: - :maxdepth: 2 - :titlesonly: - - activate_iptrunk - create_imported_iptrunk - create_iptrunk - deploy_twamp - import_iptrunk - migrate_iptrunk - modify_isis_metric - modify_trunk_interface - terminate_iptrunk - validate_iptrunk diff --git a/docs/source/module/workflows/iptrunk/migrate_iptrunk.rst b/docs/source/module/workflows/iptrunk/migrate_iptrunk.rst deleted file mode 100644 index 3ae52e5f7..000000000 --- a/docs/source/module/workflows/iptrunk/migrate_iptrunk.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.iptrunk.migrate_iptrunk`` -========================================= - -.. automodule:: gso.workflows.iptrunk.migrate_iptrunk - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/iptrunk/modify_isis_metric.rst b/docs/source/module/workflows/iptrunk/modify_isis_metric.rst deleted file mode 100644 index 3f3a17deb..000000000 --- a/docs/source/module/workflows/iptrunk/modify_isis_metric.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.iptrunk.modify_isis_metric`` -============================================ - -.. automodule:: gso.workflows.iptrunk.modify_isis_metric - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/iptrunk/modify_trunk_interface.rst b/docs/source/module/workflows/iptrunk/modify_trunk_interface.rst deleted file mode 100644 index aad531ead..000000000 --- a/docs/source/module/workflows/iptrunk/modify_trunk_interface.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.iptrunk.modify_trunk_interface`` -================================================ - -.. automodule:: gso.workflows.iptrunk.modify_trunk_interface - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/iptrunk/terminate_iptrunk.rst b/docs/source/module/workflows/iptrunk/terminate_iptrunk.rst deleted file mode 100644 index 9a11c0c4b..000000000 --- a/docs/source/module/workflows/iptrunk/terminate_iptrunk.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.iptrunk.terminate_iptrunk`` -=========================================== - -.. automodule:: gso.workflows.iptrunk.terminate_iptrunk - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/iptrunk/validate_iptrunk.rst b/docs/source/module/workflows/iptrunk/validate_iptrunk.rst deleted file mode 100644 index c009f8f73..000000000 --- a/docs/source/module/workflows/iptrunk/validate_iptrunk.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.iptrunk.validate_iptrunk`` -========================================== - -.. automodule:: gso.workflows.iptrunk.validate_iptrunk - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/l2_circuit/nren_l3_core_service/create_imported_layer_2_circuit.rst b/docs/source/module/workflows/l2_circuit/nren_l3_core_service/create_imported_layer_2_circuit.rst deleted file mode 100644 index c8683dd28..000000000 --- a/docs/source/module/workflows/l2_circuit/nren_l3_core_service/create_imported_layer_2_circuit.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.l2_circuit.create_imported_layer_2_circuit`` -============================================================ - -.. automodule:: gso.workflows.l2_circuit.create_imported_layer_2_circuit - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/l2_circuit/nren_l3_core_service/create_layer_2_circuit.rst b/docs/source/module/workflows/l2_circuit/nren_l3_core_service/create_layer_2_circuit.rst deleted file mode 100644 index c19b27a1f..000000000 --- a/docs/source/module/workflows/l2_circuit/nren_l3_core_service/create_layer_2_circuit.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.l2_circuit.create_layer_2_circuit`` -=================================================== - -.. automodule:: gso.workflows.l2_circuit.create_layer_2_circuit - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/l2_circuit/nren_l3_core_service/import_layer_2_circuit.rst b/docs/source/module/workflows/l2_circuit/nren_l3_core_service/import_layer_2_circuit.rst deleted file mode 100644 index 10231456b..000000000 --- a/docs/source/module/workflows/l2_circuit/nren_l3_core_service/import_layer_2_circuit.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.l2_circuit.import_layer_2_circuit`` -=================================================== - -.. automodule:: gso.workflows.l2_circuit.import_layer_2_circuit - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/l2_circuit/nren_l3_core_service/index.rst b/docs/source/module/workflows/l2_circuit/nren_l3_core_service/index.rst deleted file mode 100644 index 5e3d52fb1..000000000 --- a/docs/source/module/workflows/l2_circuit/nren_l3_core_service/index.rst +++ /dev/null @@ -1,20 +0,0 @@ -``gso.workflows.L2_circuit -========================== - -.. automodule:: gso.workflows.L2_circuit - :members: - :show-inheritance: - -Submodules ----------- - -.. toctree:: - :maxdepth: 2 - :titlesonly: - - create_layer_2_circuit - modify_layer_2_circuit - terminate_layer_2_circuit - create_imported_layer_2_circuit - import_layer_2_circuit - diff --git a/docs/source/module/workflows/l2_circuit/nren_l3_core_service/modify_layer_2_circuit.rst b/docs/source/module/workflows/l2_circuit/nren_l3_core_service/modify_layer_2_circuit.rst deleted file mode 100644 index f46d037ad..000000000 --- a/docs/source/module/workflows/l2_circuit/nren_l3_core_service/modify_layer_2_circuit.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.l2_circuit.modify_layer_2_circuit`` -=================================================== - -.. automodule:: gso.workflows.l2_circuit.modify_layer_2_circuit - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/lan_switch_interconnect/create_imported_lan_switch_interconnect.rst b/docs/source/module/workflows/lan_switch_interconnect/create_imported_lan_switch_interconnect.rst deleted file mode 100644 index 6900a2f8f..000000000 --- a/docs/source/module/workflows/lan_switch_interconnect/create_imported_lan_switch_interconnect.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.lan_switch_interconnect.create_imported_lan_switch_interconnect`` -================================================================================= - -.. automodule:: gso.workflows.lan_switch_interconnect.create_imported_lan_switch_interconnect - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/lan_switch_interconnect/create_lan_switch_interconnect.rst b/docs/source/module/workflows/lan_switch_interconnect/create_lan_switch_interconnect.rst deleted file mode 100644 index 9e1e9ce47..000000000 --- a/docs/source/module/workflows/lan_switch_interconnect/create_lan_switch_interconnect.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.lan_switch_interconnect.create_lan_switch_interconnect`` -======================================================================== - -.. automodule:: gso.workflows.lan_switch_interconnect.create_lan_switch_interconnect - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/lan_switch_interconnect/import_lan_switch_interconnect.rst b/docs/source/module/workflows/lan_switch_interconnect/import_lan_switch_interconnect.rst deleted file mode 100644 index 230944df9..000000000 --- a/docs/source/module/workflows/lan_switch_interconnect/import_lan_switch_interconnect.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.lan_switch_interconnect.import_lan_switch_interconnect`` -======================================================================== - -.. automodule:: gso.workflows.lan_switch_interconnect.import_lan_switch_interconnect - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/lan_switch_interconnect/index.rst b/docs/source/module/workflows/lan_switch_interconnect/index.rst deleted file mode 100644 index f8a8b4f8e..000000000 --- a/docs/source/module/workflows/lan_switch_interconnect/index.rst +++ /dev/null @@ -1,19 +0,0 @@ -``gso.workflows.lan_switch_interconnect`` -========================================= - -.. automodule:: gso.workflows.lan_switch_interconnect - :members: - :show-inheritance: - -Submodules ----------- - -.. toctree:: - :maxdepth: 2 - :titlesonly: - - create_imported_lan_switch_interconnect - create_lan_switch_interconnect - import_lan_switch_interconnect - terminate_lan_switch_interconnect - validate_lan_switch_interconnect diff --git a/docs/source/module/workflows/lan_switch_interconnect/terminate_lan_switch_interconnect.rst b/docs/source/module/workflows/lan_switch_interconnect/terminate_lan_switch_interconnect.rst deleted file mode 100644 index 7575a60fe..000000000 --- a/docs/source/module/workflows/lan_switch_interconnect/terminate_lan_switch_interconnect.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.lan_switch_interconnect.terminate_lan_switch_interconnect`` -=========================================================================== - -.. automodule:: gso.workflows.lan_switch_interconnect.terminate_lan_switch_interconnect - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/lan_switch_interconnect/validate_lan_switch_interconnect.rst b/docs/source/module/workflows/lan_switch_interconnect/validate_lan_switch_interconnect.rst deleted file mode 100644 index 17530cf9e..000000000 --- a/docs/source/module/workflows/lan_switch_interconnect/validate_lan_switch_interconnect.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.lan_switch_interconnect.validate_lan_switch_interconnect`` -========================================================================== - -.. automodule:: gso.workflows.lan_switch_interconnect.validate_lan_switch_interconnect - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/nren_l3_core_service/create_imported_nren_l3_core_service.rst b/docs/source/module/workflows/nren_l3_core_service/create_imported_nren_l3_core_service.rst deleted file mode 100644 index 249f9b824..000000000 --- a/docs/source/module/workflows/nren_l3_core_service/create_imported_nren_l3_core_service.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.nren_l3_core_service.create_imported_nren_l3_core_service`` -=========================================================================== - -.. automodule:: gso.workflows.nren_l3_core_service.create_imported_nren_l3_core_service - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/nren_l3_core_service/create_nren_l3_core_service.rst b/docs/source/module/workflows/nren_l3_core_service/create_nren_l3_core_service.rst deleted file mode 100644 index e1418b4c9..000000000 --- a/docs/source/module/workflows/nren_l3_core_service/create_nren_l3_core_service.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.nren_l3_core_service.create_nren_l3_core_service`` -================================================================== - -.. automodule:: gso.workflows.nren_l3_core_service.create_nren_l3_core_service - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/nren_l3_core_service/import_nren_l3_core_service.rst b/docs/source/module/workflows/nren_l3_core_service/import_nren_l3_core_service.rst deleted file mode 100644 index fdb67a1e8..000000000 --- a/docs/source/module/workflows/nren_l3_core_service/import_nren_l3_core_service.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.nren_l3_core_service.import_nren_l3_core_service`` -================================================================== - -.. automodule:: gso.workflows.nren_l3_core_service.import_nren_l3_core_service - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/nren_l3_core_service/index.rst b/docs/source/module/workflows/nren_l3_core_service/index.rst deleted file mode 100644 index aa55ff08c..000000000 --- a/docs/source/module/workflows/nren_l3_core_service/index.rst +++ /dev/null @@ -1,19 +0,0 @@ -``gso.workflows.nren_l3_core_service`` -====================================== - -.. automodule:: gso.workflows.nren_l3_core_service - :members: - :show-inheritance: - -Submodules ----------- - -.. toctree:: - :maxdepth: 2 - :titlesonly: - - create_nren_l3_core_service - create_imported_nren_l3_core_service - import_nren_l3_core_service - migrate_nren_l3_core_service - modify_nren_l3_core_service diff --git a/docs/source/module/workflows/nren_l3_core_service/migrate_nren_l3_core_service.rst b/docs/source/module/workflows/nren_l3_core_service/migrate_nren_l3_core_service.rst deleted file mode 100644 index 9a550c827..000000000 --- a/docs/source/module/workflows/nren_l3_core_service/migrate_nren_l3_core_service.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.nren_l3_core_service.migrate_nren_l3_core_service`` -=================================================================== - -.. automodule:: gso.workflows.nren_l3_core_service.migrate_nren_l3_core_service - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/nren_l3_core_service/modify_nren_l3_core_service.rst b/docs/source/module/workflows/nren_l3_core_service/modify_nren_l3_core_service.rst deleted file mode 100644 index bd33ee226..000000000 --- a/docs/source/module/workflows/nren_l3_core_service/modify_nren_l3_core_service.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.nren_l3_core_service.modify_nren_l3_core_service`` -================================================================== - -.. automodule:: gso.workflows.nren_l3_core_service.modify_nren_l3_core_service - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/office_router/create_imported_office_router.rst b/docs/source/module/workflows/office_router/create_imported_office_router.rst deleted file mode 100644 index a3136a813..000000000 --- a/docs/source/module/workflows/office_router/create_imported_office_router.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.office_router.create_imported_office_router`` -============================================================= - -.. automodule:: gso.workflows.office_router.create_imported_office_router - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/office_router/import_office_router.rst b/docs/source/module/workflows/office_router/import_office_router.rst deleted file mode 100644 index 50c55eb5f..000000000 --- a/docs/source/module/workflows/office_router/import_office_router.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.office_router.import_office_router`` -==================================================== - -.. automodule:: gso.workflows.office_router.import_office_router - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/office_router/index.rst b/docs/source/module/workflows/office_router/index.rst deleted file mode 100644 index d2aa53dfa..000000000 --- a/docs/source/module/workflows/office_router/index.rst +++ /dev/null @@ -1,16 +0,0 @@ -``gso.workflows.office_router`` -=============================== - -.. automodule:: gso.workflows.office_router - :members: - :show-inheritance: - -Submodules ----------- - -.. toctree:: - :maxdepth: 2 - :titlesonly: - - create_imported_office_router - import_office_router diff --git a/docs/source/module/workflows/opengear/create_imported_opengear.rst b/docs/source/module/workflows/opengear/create_imported_opengear.rst deleted file mode 100644 index 07765a76e..000000000 --- a/docs/source/module/workflows/opengear/create_imported_opengear.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.opengear.create_imported_opengear`` -=================================================================== - -.. automodule:: gso.workflows.opengear.create_imported_opengear - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/opengear/import_opengear.rst b/docs/source/module/workflows/opengear/import_opengear.rst deleted file mode 100644 index 9834c5b53..000000000 --- a/docs/source/module/workflows/opengear/import_opengear.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.opengear.import_opengear`` -========================================================== - -.. automodule:: gso.workflows.opengear.import_opengear - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/opengear/index.rst b/docs/source/module/workflows/opengear/index.rst deleted file mode 100644 index 69acd4555..000000000 --- a/docs/source/module/workflows/opengear/index.rst +++ /dev/null @@ -1,16 +0,0 @@ -``gso.workflows.opengear`` -================================== - -.. automodule:: gso.workflows.opengear - :members: - :show-inheritance: - -Submodules ----------- - -.. toctree:: - :maxdepth: 2 - :titlesonly: - - create_imported_opengear - import_opengear diff --git a/docs/source/module/workflows/router/activate_router.rst b/docs/source/module/workflows/router/activate_router.rst deleted file mode 100644 index 383502dd3..000000000 --- a/docs/source/module/workflows/router/activate_router.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.router.activate_router`` -======================================== - -.. automodule:: gso.workflows.router.activate_router - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/router/create_imported_router.rst b/docs/source/module/workflows/router/create_imported_router.rst deleted file mode 100644 index 8124fd0de..000000000 --- a/docs/source/module/workflows/router/create_imported_router.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.router.create_imported_router`` -=============================================== - -.. automodule:: gso.workflows.router.create_imported_router - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/router/create_router.rst b/docs/source/module/workflows/router/create_router.rst deleted file mode 100644 index e30abc03c..000000000 --- a/docs/source/module/workflows/router/create_router.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.router.create_router`` -====================================== - -.. automodule:: gso.workflows.router.create_router - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/router/import_router.rst b/docs/source/module/workflows/router/import_router.rst deleted file mode 100644 index c0544a275..000000000 --- a/docs/source/module/workflows/router/import_router.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.router.import_router`` -====================================== - -.. automodule:: gso.workflows.router.import_router - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/router/index.rst b/docs/source/module/workflows/router/index.rst deleted file mode 100644 index f10b52e24..000000000 --- a/docs/source/module/workflows/router/index.rst +++ /dev/null @@ -1,25 +0,0 @@ -``gso.workflows.router`` -======================== - -.. automodule:: gso.workflows.router - :members: - :show-inheritance: - -Submodules ----------- - -.. toctree:: - :maxdepth: 2 - :titlesonly: - - activate_router - create_imported_router - create_router - import_router - modify_connection_strategy - modify_kentik_license - promote_p_to_pe - redeploy_base_config - terminate_router - update_ibgp_mesh - validate_router diff --git a/docs/source/module/workflows/router/modify_connection_strategy.rst b/docs/source/module/workflows/router/modify_connection_strategy.rst deleted file mode 100644 index ddecdb9f5..000000000 --- a/docs/source/module/workflows/router/modify_connection_strategy.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.router.modify_connection_strategy`` -=================================================== - -.. automodule:: gso.workflows.router.modify_connection_strategy - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/router/modify_kentik_license.rst b/docs/source/module/workflows/router/modify_kentik_license.rst deleted file mode 100644 index 72bc88ba5..000000000 --- a/docs/source/module/workflows/router/modify_kentik_license.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.router.modify_kentik_license`` -============================================== - -.. automodule:: gso.workflows.router.modify_kentik_license - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/router/promote_p_to_pe.rst b/docs/source/module/workflows/router/promote_p_to_pe.rst deleted file mode 100644 index bb100c11b..000000000 --- a/docs/source/module/workflows/router/promote_p_to_pe.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.router.promote_p_to_pe`` -======================================== - -.. automodule:: gso.workflows.router.promote_p_to_pe - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/router/redeploy_base_config.rst b/docs/source/module/workflows/router/redeploy_base_config.rst deleted file mode 100644 index 1348f983d..000000000 --- a/docs/source/module/workflows/router/redeploy_base_config.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.router.redeploy_base_config`` -============================================= - -.. automodule:: gso.workflows.router.redeploy_base_config - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/router/terminate_router.rst b/docs/source/module/workflows/router/terminate_router.rst deleted file mode 100644 index 0ac1ec450..000000000 --- a/docs/source/module/workflows/router/terminate_router.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.router.terminate_router`` -========================================= - -.. automodule:: gso.workflows.router.terminate_router - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/router/update_ibgp_mesh.rst b/docs/source/module/workflows/router/update_ibgp_mesh.rst deleted file mode 100644 index 213aacb75..000000000 --- a/docs/source/module/workflows/router/update_ibgp_mesh.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.router.update_ibgp_mesh`` -========================================= - -.. automodule:: gso.workflows.router.update_ibgp_mesh - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/router/validate_router.rst b/docs/source/module/workflows/router/validate_router.rst deleted file mode 100644 index 3b44def24..000000000 --- a/docs/source/module/workflows/router/validate_router.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.router.validate_router`` -======================================== - -.. automodule:: gso.workflows.router.validate_router - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/site/create_imported_site.rst b/docs/source/module/workflows/site/create_imported_site.rst deleted file mode 100644 index 52fab323a..000000000 --- a/docs/source/module/workflows/site/create_imported_site.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.site.create_imported_site`` -=========================================== - -.. automodule:: gso.workflows.site.create_imported_site - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/site/create_site.rst b/docs/source/module/workflows/site/create_site.rst deleted file mode 100644 index 45a9ef49d..000000000 --- a/docs/source/module/workflows/site/create_site.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.site.create_site`` -================================== - -.. automodule:: gso.workflows.site.create_site - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/site/import_site.rst b/docs/source/module/workflows/site/import_site.rst deleted file mode 100644 index 5b5a94bc6..000000000 --- a/docs/source/module/workflows/site/import_site.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.site.import_site`` -================================== - -.. automodule:: gso.workflows.site.import_site - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/site/index.rst b/docs/source/module/workflows/site/index.rst deleted file mode 100644 index c1b8b06ba..000000000 --- a/docs/source/module/workflows/site/index.rst +++ /dev/null @@ -1,19 +0,0 @@ -``gso.workflows.site`` -====================== - -.. automodule:: gso.workflows.site - :members: - :show-inheritance: - -Submodules ----------- - -.. toctree:: - :maxdepth: 2 - :titlesonly: - - create_imported_site - create_site - import_site - modify_site - terminate_site diff --git a/docs/source/module/workflows/site/modify_site.rst b/docs/source/module/workflows/site/modify_site.rst deleted file mode 100644 index 0d05db724..000000000 --- a/docs/source/module/workflows/site/modify_site.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.site.modify_site`` -================================== - -.. automodule:: gso.workflows.site.modify_site - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/site/terminate_site.rst b/docs/source/module/workflows/site/terminate_site.rst deleted file mode 100644 index a54618c3c..000000000 --- a/docs/source/module/workflows/site/terminate_site.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.site.terminate_site`` -===================================== - -.. automodule:: gso.workflows.site.terminate_site - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/super_pop_switch/create_imported_super_pop_switch.rst b/docs/source/module/workflows/super_pop_switch/create_imported_super_pop_switch.rst deleted file mode 100644 index 58beb83ef..000000000 --- a/docs/source/module/workflows/super_pop_switch/create_imported_super_pop_switch.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.super_pop_switch.create_imported_super_pop_switch`` -=================================================================== - -.. automodule:: gso.workflows.super_pop_switch.create_imported_super_pop_switch - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/super_pop_switch/import_super_pop_switch.rst b/docs/source/module/workflows/super_pop_switch/import_super_pop_switch.rst deleted file mode 100644 index b7cb7e2ed..000000000 --- a/docs/source/module/workflows/super_pop_switch/import_super_pop_switch.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.super_pop_switch.import_super_pop_switch`` -========================================================== - -.. automodule:: gso.workflows.super_pop_switch.import_super_pop_switch - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/super_pop_switch/index.rst b/docs/source/module/workflows/super_pop_switch/index.rst deleted file mode 100644 index 48672f720..000000000 --- a/docs/source/module/workflows/super_pop_switch/index.rst +++ /dev/null @@ -1,16 +0,0 @@ -``gso.workflows.super_pop_switch`` -================================== - -.. automodule:: gso.workflows.super_pop_switch - :members: - :show-inheritance: - -Submodules ----------- - -.. toctree:: - :maxdepth: 2 - :titlesonly: - - create_imported_super_pop_switch - import_super_pop_switch diff --git a/docs/source/module/workflows/switch/activate_switch.rst b/docs/source/module/workflows/switch/activate_switch.rst deleted file mode 100644 index dc850fa58..000000000 --- a/docs/source/module/workflows/switch/activate_switch.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.switch.activate_switch`` -======================================== - -.. automodule:: gso.workflows.switch.activate_switch - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/switch/create_imported_switch.rst b/docs/source/module/workflows/switch/create_imported_switch.rst deleted file mode 100644 index 2dcd76641..000000000 --- a/docs/source/module/workflows/switch/create_imported_switch.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.switch.create_imported_switch`` -=============================================== - -.. automodule:: gso.workflows.switch.create_imported_switch - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/switch/create_switch.rst b/docs/source/module/workflows/switch/create_switch.rst deleted file mode 100644 index c2c8d1956..000000000 --- a/docs/source/module/workflows/switch/create_switch.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.switch.create_switch`` -====================================== - -.. automodule:: gso.workflows.switch.create_switch - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/switch/import_switch.rst b/docs/source/module/workflows/switch/import_switch.rst deleted file mode 100644 index 82f140766..000000000 --- a/docs/source/module/workflows/switch/import_switch.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.switch.import_switch`` -====================================== - -.. automodule:: gso.workflows.switch.import_switch - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/switch/index.rst b/docs/source/module/workflows/switch/index.rst deleted file mode 100644 index 160939de0..000000000 --- a/docs/source/module/workflows/switch/index.rst +++ /dev/null @@ -1,20 +0,0 @@ -``gso.workflows.switch`` -======================== - -.. automodule:: gso.workflows.switch - :members: - :show-inheritance: - -Submodules ----------- - -.. toctree:: - :maxdepth: 2 - :titlesonly: - - activate_switch - create_imported_switch - create_switch - import_switch - terminate_switch - validate_switch diff --git a/docs/source/module/workflows/switch/terminate_switch.rst b/docs/source/module/workflows/switch/terminate_switch.rst deleted file mode 100644 index 15d3336f7..000000000 --- a/docs/source/module/workflows/switch/terminate_switch.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.switch.terminate_switch`` -========================================= - -.. automodule:: gso.workflows.switch.terminate_switch - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/switch/validate_switch.rst b/docs/source/module/workflows/switch/validate_switch.rst deleted file mode 100644 index 40bbbf30d..000000000 --- a/docs/source/module/workflows/switch/validate_switch.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.switch.validate_switch`` -======================================== - -.. automodule:: gso.workflows.switch.validate_switch - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/tasks/clean_old_tasks.rst b/docs/source/module/workflows/tasks/clean_old_tasks.rst deleted file mode 100644 index 1a2c7bce0..000000000 --- a/docs/source/module/workflows/tasks/clean_old_tasks.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.tasks.clean_old_tasks`` -======================================= - -.. automodule:: gso.workflows.tasks.clean_old_tasks - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/tasks/create_partners.rst b/docs/source/module/workflows/tasks/create_partners.rst deleted file mode 100644 index 3755d6bca..000000000 --- a/docs/source/module/workflows/tasks/create_partners.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.tasks.create_partners`` -======================================= - -.. automodule:: gso.workflows.tasks.create_partners - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/tasks/delete_partners.rst b/docs/source/module/workflows/tasks/delete_partners.rst deleted file mode 100644 index 0a731a1d4..000000000 --- a/docs/source/module/workflows/tasks/delete_partners.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.tasks.delete_partners`` -======================================= - -.. automodule:: gso.workflows.tasks.delete_partners - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/tasks/index.rst b/docs/source/module/workflows/tasks/index.rst deleted file mode 100644 index b4a6c9ddf..000000000 --- a/docs/source/module/workflows/tasks/index.rst +++ /dev/null @@ -1,20 +0,0 @@ -``gso.workflows.tasks`` -======================= - -.. automodule:: gso.workflows.tasks - :members: - :show-inheritance: - -Submodules ----------- - -.. toctree:: - :maxdepth: 2 - :titlesonly: - - clean_old_tasks - create_partners - delete_partners - modify_partners - send_email_notifications - validate_geant_products diff --git a/docs/source/module/workflows/tasks/modify_partners.rst b/docs/source/module/workflows/tasks/modify_partners.rst deleted file mode 100644 index b360165a3..000000000 --- a/docs/source/module/workflows/tasks/modify_partners.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.tasks.modify_partners`` -======================================= - -.. automodule:: gso.workflows.tasks.modify_partners - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/tasks/send_email_notifications.rst b/docs/source/module/workflows/tasks/send_email_notifications.rst deleted file mode 100644 index 7be5d9492..000000000 --- a/docs/source/module/workflows/tasks/send_email_notifications.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.tasks.send_email_notifications`` -================================================ - -.. automodule:: gso.workflows.tasks.send_email_notifications - :members: - :show-inheritance: diff --git a/docs/source/module/workflows/tasks/validate_geant_products.rst b/docs/source/module/workflows/tasks/validate_geant_products.rst deleted file mode 100644 index 540b73460..000000000 --- a/docs/source/module/workflows/tasks/validate_geant_products.rst +++ /dev/null @@ -1,6 +0,0 @@ -``gso.workflows.tasks.validate_geant_products`` -=============================================== - -.. automodule:: gso.workflows.tasks.validate_geant_products - :members: - :show-inheritance: diff --git a/docs/source/modules.rst b/docs/source/modules.rst deleted file mode 100644 index ab1adef70..000000000 --- a/docs/source/modules.rst +++ /dev/null @@ -1,55 +0,0 @@ -========================= -Sub-packages and -modules -========================= - -This page lists references to the documentation of all sub-packages and -modules that make up :term:`GSO`. - -``gso`` -^^^^^^^ - -.. automodule:: gso - :members: - :show-inheritance: - -Subpackages ------------ - -.. toctree:: - :maxdepth: 2 - :titlesonly: - - module/api/index - module/auth/index - module/cli/index - module/products/index - module/schedules/index - module/services/index - module/utils/index - module/workflows/index - -Submodules ----------- - -``gso.main`` module -^^^^^^^^^^^^^^^^^^^ - -.. automodule:: gso.main - :members: - :undoc-members: - :show-inheritance: - -``gso.settings`` module -^^^^^^^^^^^^^^^^^^^^^^^ - -.. automodule:: gso.settings - :members: - :undoc-members: - :show-inheritance: - -``gso.worker`` module -^^^^^^^^^^^^^^^^^^^^^ - -.. automodule:: gso.worker - :members: - :undoc-members: - :show-inheritance: diff --git a/docs/source/quickstart.rst b/docs/source/quickstart.rst deleted file mode 100644 index d82a04c18..000000000 --- a/docs/source/quickstart.rst +++ /dev/null @@ -1,47 +0,0 @@ -Quickstart -========== - -Development environment and dependencies ----------------------------------------- - -- Install python 3.12 if you do not have it already: - - ``add-apt-repository ppa:deadsnakes/ppa`` - - ``apt install python3.12 python3.12-distutils`` -- Follow Steps 1 and 2 from here to install dependencies and setup DB: - `<https://workfloworchestrator.org/orchestrator-core/workshops/beginner/debian/>`_ -- To install the orchestrator GUI, you can follow the steps 5 and 6 from the previous link. -- Create a virtual environment: - - ``source /usr/share/virtualenvwrapper/virtualenvwrapper.sh`` - - ``mkvirtualenv --python python3.12 gso`` -- To use the virtual environment: - - ``source /usr/share/virtualenvwrapper/virtualenvwrapper.sh`` - - ``workon gso`` - -Installation ------------- - -Do all this inside the virtual environment. - -- Clone this repository -- ``pip install -r requirements.txt`` - - If you get an error because you pip version is too old, run this: - ``curl -sS https://bootstrap.pypa.io/get-pip.py | python3.12`` -- ``pip install -e .`` -- Create an ``oss-params.json`` based on the ``oss-params-example.json`` file inside ``/gso``. -- Export the oss-params file: ``export OSS_PARAMS_FILENAME="/path/to/oss-params.json"`` -- Upgrade DB to latest revision: ``PYTHONPATH=. python main.py db upgrade heads`` - -Run ---- - -- Start the workflow orchestrator core with ``uvicorn --host 0.0.0.0 --port 8080 main:app`` from inside the ``gso`` - directory of this repository. -- Start the GUI with ``yarn start``. - - -Useful workflow orchestrator resources --------------------------------------- - -- WFO API (Swagger): `<https://workfloworchestrator.org/orchestrator-core/architecture/application/api/>`_ -- WFO API (repository): - `<https://github.com/workfloworchestrator/orchestrator-core/tree/main/orchestrator/api/api_v1/endpoints>`_ diff --git a/docs/source/static/custom.css b/docs/source/static/custom.css deleted file mode 100644 index 7297b93dc..000000000 --- a/docs/source/static/custom.css +++ /dev/null @@ -1,3 +0,0 @@ -.wy-menu > p > span { - color: rgb(237 21 86); -} diff --git a/docs/source/static/custom.js b/docs/source/static/custom.js deleted file mode 100644 index 184b5ae8b..000000000 --- a/docs/source/static/custom.js +++ /dev/null @@ -1,3 +0,0 @@ -$(document).ready(function () { - $('a.external').attr('target', '_blank'); -}); diff --git a/docs/source/static/geant_logo_white.svg b/docs/source/static/geant_logo_white.svg deleted file mode 100644 index 31bfead62..000000000 --- a/docs/source/static/geant_logo_white.svg +++ /dev/null @@ -1,16 +0,0 @@ -<svg width="79" height="35" viewBox="0 0 79 35" fill="none" xmlns="http://www.w3.org/2000/svg"> -<g clip-path="url(#clip0_101_15)"> -<path d="M15.9 17.8C16.5 17.3 17 17.1 17.4 17.1C18.4 17.1 18.7 17.8 18.7 18.2C18.5 18.3 14.2 19.7 14 19.8C13.9 19.7 13.9 19.6 13.8 19.6C14 19.4 15.9 17.8 15.9 17.8Z" fill="white" fill-opacity="0.85"/> -<path d="M0 27C0 31.8 2.1 34.3 6.3 34.3C9.1 34.3 10.8 33.1 10.8 33L10.9 32.9V26.2H5.2V28.1C5.2 28.1 8.1 28.1 8.6 28.1C8.6 28.6 8.6 31.6 8.6 31.9C8.3 32.1 7.4 32.4 6.2 32.4C3.7 32.4 2.5 30.6 2.5 27C2.5 24.9 3.1 22.4 5.9 22.4C7.8 22.4 8.5 23.5 8.5 24.5V24.8H11.1V24.5C11.1 22.1 9 20.5 5.9 20.5C2.2 20.5 0 22.9 0 27Z" fill="white" fill-opacity="0.85"/> -<path d="M20.2 20.7H12.6V34.1H20.7V32.2C20.7 32.2 15.5 32.2 14.9 32.2C14.9 31.7 14.9 28.5 14.9 28C15.5 28 20.2 28 20.2 28V26.1C20.2 26.1 15.5 26.1 14.9 26.1C14.9 25.6 14.9 23 14.9 22.5C15.5 22.5 20.5 22.5 20.5 22.5V20.6H20.2V20.7Z" fill="white" fill-opacity="0.85"/> -<path d="M54.5 20.7H42.9C42.9 20.7 42.9 28.7 42.9 30.6C42 29 37.2 20.7 37.2 20.7H34.5V34.1H36.8C36.8 34.1 36.8 26.1 36.8 24.2C37.7 25.8 42.5 34.1 42.5 34.1H45.2C45.2 34.1 45.2 23.2 45.2 22.6C45.7 22.6 48.4 22.6 48.9 22.6C48.9 23.2 48.9 34.1 48.9 34.1H51.3C51.3 34.1 51.3 23.2 51.3 22.6C51.8 22.6 54.9 22.6 54.9 22.6V20.7H54.5V20.7Z" fill="white" fill-opacity="0.85"/> -<path d="M28.9 20.7H28.7H26.4L21.4 34.1H23.8C23.8 34.1 25.1 30.6 25.3 30.2C25.7 30.2 29.8 30.2 30.2 30.2C30.3 30.6 31.7 34.1 31.7 34.1H34L28.9 20.7ZM25.9 28.3C26.1 27.6 27.3 24.4 27.7 23.3C28.1 24.4 29.2 27.6 29.5 28.3C28.7 28.3 26.6 28.3 25.9 28.3Z" fill="white" fill-opacity="0.85"/> -<path d="M77 8C68.2 -2.9 32.6 12.5 23 16.5C22.3 16.8 21.4 16.7 20.9 15.7C21.3 16.7 22.1 17.1 23.1 16.7C35.8 11.6 66.5 0.600002 74.2 10.7C77.7 15.3 76.7 20.9 72.9 28.8C72.7 29.1 72.6 29.4 72.6 29.4C72.6 29.4 72.6 29.4 72.6 29.5C72.6 29.5 72.6 29.5 72.6 29.6C72.3 30.1 71.9 30.3 71.6 30.4C72 30.4 72.5 30.2 72.9 29.6C73 29.5 73.1 29.3 73.3 29C78.7 19.5 80.7 12.5 77 8Z" fill="white" fill-opacity="0.85"/> -<path d="M70.3 29.9C70.2 29.8 68.6 28.4 67 26.9C58.7 19 33.4 -5.3 22.4 1.1C19.3 2.9 18.8 8.2 20.7 15.2C20.7 15.3 20.8 15.4 20.8 15.5C21 16.2 21.5 16.7 22.2 16.7C21.7 16.6 21.3 16.2 21.1 15.7C21.1 15.6 21 15.5 21 15.5C21 15.4 20.9 15.3 20.9 15.1C20.9 15 20.9 14.9 20.8 14.9C19.8 9 21 5.1 23.4 3.5C32.3 -2.5 53.5 15.8 64.2 25C66.6 27.1 69.4 29.5 70.2 30.1C71.4 31 72.4 30 72.7 29.5C72.3 30.1 71.3 30.7 70.3 29.9Z" fill="white" fill-opacity="0.85"/> -</g> -<defs> -<clipPath id="clip0_101_15"> -<rect width="78.9" height="34.3" fill="white"/> -</clipPath> -</defs> -</svg> diff --git a/mkdocs.yml b/mkdocs.yml new file mode 100644 index 000000000..28cdc0a5c --- /dev/null +++ b/mkdocs.yml @@ -0,0 +1,110 @@ +# General +site_name: GÉANT Automation Platform +site_url: https://docs.gap.geant.org/ +site_author: GÉANT Orchestration and Automation Team +site_description: Documentation of the GÉANT Automation Platform and the GÉANT Service Orchestrator + +# Repositories +repo_name: geant-service-orchestrator +repo_url: https://gitlab.software.geant.org/goat/gap/geant-service-orchestrator + +# Theme +theme: + name: material + logo_light_mode: assets/images/logo.png + logo_dark_mode: assets/images/geant_logo_white.png + custom_dir: docs/overrides + icon: + repo: fontawesome/brands/gitlab + features: + - navigation.instant + - navigation.tracking + - navigation.sections + - toc.integrate + - navigation.path + - navigation.indexes + - content.code.copy + palette: + - media: "(prefers-color-scheme)" + toggle: + icon: material/auto-mode + name: Switch to light mode + - media: "(prefers-color-scheme: light)" + scheme: geant + primary: custom + toggle: + icon: material/weather-sunny + name: Switch to dark mode + - media: "(prefers-color-scheme: dark)" + scheme: slate + primary: custom + toggle: + icon: material/weather-night + name: Switch to system preference +extra_css: + - assets/stylesheets/extra.css + +plugins: + - search + - gen-files: + scripts: + - docs/scripts/gen_ref_pages.py + - literate-nav: + nav_file: SUMMARY.md + - section-index + - mkdocstrings + +# Page tree +nav: + - Home: index.md + - Architecture: + - architecture/index.md + - architecture/config_decomposition/index.md + - Components: + - architecture/components/index.md + - WFO: architecture/components/wfo/index.md + - Netbox: architecture/components/netbox/index.md + - Ansible: architecture/components/ansible/index.md + - LSO: architecture/components/lso/index.md + - DTAP: + - architecture/dtap/index.md + - Development: architecture/dtap/development.md + - Test: architecture/dtap/test.md + - Acceptance: architecture/dtap/acceptance.md + - Production: architecture/dtap/production.md + - Admin Guide: + - admin_guide/index.md + - Ansible: + - admin_guide/ansible/ansible.md + - GSO: + - Diagram: admin_guide/wfo/overview.md + - Sites: admin_guide/wfo/sites.md + - Routers: admin_guide/wfo/routers.md + - IP trunks: admin_guide/wfo/iptrunks.md + - OSS/BSS integration: + - Infoblox: admin_guide/oss_bss/ipam.md + - Netbox: admin_guide/oss_bss/netbox.md + - LibreNMS: admin_guide/oss_bss/librenms.md + - Kentik: admin_guide/oss_bss/kentik.md + - Code Documentation: reference/ + +# Extensions +markdown_extensions: + - admonition + - abbr + - attr_list + - md_in_html + - pymdownx.snippets: + auto_append: + - includes/glossary.md + - pymdownx.highlight: + anchor_linenums: true + line_spans: __span + pygments_lang_class: true + - pymdownx.inlinehilite + - pymdownx.snippets + - pymdownx.superfences: + custom_fences: + - name: mermaid + class: mermaid + format: !!python/name:pymdownx.superfences.fence_code_format -- GitLab