From 5c8c5212c021930ed2d3cc1b4bb73b23ec7cd374 Mon Sep 17 00:00:00 2001
From: Erik Reid <erik.reid@geant.org>
Date: Wed, 2 Jun 2021 11:37:15 +0200
Subject: [PATCH] flattened protocol.rst

---
 docs/source/protocol/data.rst      | 24 -------------
 docs/source/protocol/index.rst     | 16 +++++----
 docs/source/protocol/jobs.rst      | 26 --------------
 docs/source/protocol/lg.rst        | 12 -------
 docs/source/protocol/lnetd.rst     | 14 --------
 docs/source/protocol/msr.rst       | 57 ------------------------------
 inventory_provider/routes/data.py  | 25 +++++++++++++
 inventory_provider/routes/jobs.py  | 27 ++++++++++++++
 inventory_provider/routes/lg.py    | 12 +++++++
 inventory_provider/routes/lnetd.py | 15 ++++++++
 inventory_provider/routes/msr.py   | 57 ++++++++++++++++++++++++++++++
 11 files changed, 146 insertions(+), 139 deletions(-)
 delete mode 100644 docs/source/protocol/data.rst
 delete mode 100644 docs/source/protocol/jobs.rst
 delete mode 100644 docs/source/protocol/lg.rst
 delete mode 100644 docs/source/protocol/lnetd.rst
 delete mode 100644 docs/source/protocol/msr.rst

diff --git a/docs/source/protocol/data.rst b/docs/source/protocol/data.rst
deleted file mode 100644
index 2f7eec7d..00000000
--- a/docs/source/protocol/data.rst
+++ /dev/null
@@ -1,24 +0,0 @@
-.. poller endpoint docs
-
-
-Data Endpoints
-=========================
-
-These endpoints are temporary and will be removed.
-
-.. contents:: :local:
-
-/data/routers
----------------------------------
-
-.. autofunction:: inventory_provider.routes.data.routers
-
-/data/interfaces
----------------------------------
-
-.. autofunction:: inventory_provider.routes.data.router_interfaces
-
-/data/pop
----------------------------------
-
-.. autofunction:: inventory_provider.routes.data.equipment_location
diff --git a/docs/source/protocol/index.rst b/docs/source/protocol/index.rst
index d861e71d..2f389bfd 100644
--- a/docs/source/protocol/index.rst
+++ b/docs/source/protocol/index.rst
@@ -28,12 +28,16 @@ API modules
    :maxdepth: 2
    :caption: Contents:
 
-   lg
-   data
-   jobs
-   msr
-   lnetd
-
 .. automodule:: inventory_provider.routes.classifier
 
 .. automodule:: inventory_provider.routes.poller
+
+.. automodule:: inventory_provider.routes.msr
+
+.. automodule:: inventory_provider.routes.lg
+
+.. automodule:: inventory_provider.routes.lnetd
+
+.. automodule:: inventory_provider.routes.data
+
+.. automodule:: inventory_provider.routes.jobs
diff --git a/docs/source/protocol/jobs.rst b/docs/source/protocol/jobs.rst
deleted file mode 100644
index bd1707eb..00000000
--- a/docs/source/protocol/jobs.rst
+++ /dev/null
@@ -1,26 +0,0 @@
-.. poller endpoint docs
-
-
-Jobs Endpoints
-=========================
-
-These endpoints are used for monitoring running jobs.
-
-.. contents:: :local:
-
-/jobs/update
----------------------------------
-
-.. autofunction:: inventory_provider.routes.jobs.update
-
-
-/jobs/check-task-status
----------------------------------
-
-.. autofunction:: inventory_provider.routes.jobs.check_task_status
-
-
-/jobs/log
----------------------------------
-
-.. autofunction:: inventory_provider.routes.jobs.load_task_log
diff --git a/docs/source/protocol/lg.rst b/docs/source/protocol/lg.rst
deleted file mode 100644
index 363555fe..00000000
--- a/docs/source/protocol/lg.rst
+++ /dev/null
@@ -1,12 +0,0 @@
-.. LG endpoint docs
-
-
-LG Support Endpoints
-=========================
-
-These endpoints are intended for use by LG.
-
-/lg/interfaces
----------------------------------
-
-.. autofunction:: inventory_provider.routes.lg.routers
diff --git a/docs/source/protocol/lnetd.rst b/docs/source/protocol/lnetd.rst
deleted file mode 100644
index 6502451c..00000000
--- a/docs/source/protocol/lnetd.rst
+++ /dev/null
@@ -1,14 +0,0 @@
-.. LnetD endpoint docs
-
-
-LnetD support
-=========================
-
-This endpoint is intended for use with LnetD
-
-.. contents:: :local:
-
-/LnetD/interfaces</hostname>
----------------------------------
-
-.. autofunction:: inventory_provider.routes.lnetd.interfaces
diff --git a/docs/source/protocol/msr.rst b/docs/source/protocol/msr.rst
deleted file mode 100644
index 22d47455..00000000
--- a/docs/source/protocol/msr.rst
+++ /dev/null
@@ -1,57 +0,0 @@
-.. poller endpoint docs
-
-
-MSR Support Endpoints
-=========================
-
-These endpoints are intended for use by MSR.
-
-.. contents:: :local:
-
-/msr/access-services
----------------------------------
-
-.. autofunction:: inventory_provider.routes.msr.access_services
-
-
-/msr/bgp/logical-systems
--------------------------------------
-
-.. autofunction:: inventory_provider.routes.msr.get_logical_systems
-
-
-/msr/bgp/logical-system-peerings</name>
-------------------------------------------
-
-.. autofunction:: inventory_provider.routes.msr.logical_system_peerings
-
-
-/msr/bgp/groups
--------------------------------------
-
-.. autofunction:: inventory_provider.routes.msr.get_peering_groups
-
-
-/msr/bgp/group-peerings</name>
--------------------------------------
-
-.. autofunction:: inventory_provider.routes.msr.bgp_group_peerings
-
-
-/msr/bgp/routing-instances
--------------------------------------
-
-.. autofunction:: inventory_provider.routes.msr.get_peering_routing_instances
-
-
-/msr/bgp/routing-instance-peeringns</name>
---------------------------------------------
-
-.. autofunction:: inventory_provider.routes.msr.bgp_routing_instance_peerings
-
-helpers
--------------------------------------
-
-.. autofunction:: inventory_provider.routes.msr._handle_peering_group_list_request
-
-.. autofunction:: inventory_provider.routes.msr._handle_peering_group_request
diff --git a/inventory_provider/routes/data.py b/inventory_provider/routes/data.py
index 275d7a1a..aa422918 100644
--- a/inventory_provider/routes/data.py
+++ b/inventory_provider/routes/data.py
@@ -1,3 +1,28 @@
+"""
+
+Data Endpoints
+=========================
+
+These endpoints are temporary and will be removed.
+
+.. contents:: :local:
+
+/data/routers
+---------------------------------
+
+.. autofunction:: inventory_provider.routes.data.routers
+
+/data/interfaces
+---------------------------------
+
+.. autofunction:: inventory_provider.routes.data.router_interfaces
+
+/data/pop
+---------------------------------
+
+.. autofunction:: inventory_provider.routes.data.equipment_location
+
+"""
 import json
 import logging
 import re
diff --git a/inventory_provider/routes/jobs.py b/inventory_provider/routes/jobs.py
index 00f6a6a2..078e8a56 100644
--- a/inventory_provider/routes/jobs.py
+++ b/inventory_provider/routes/jobs.py
@@ -1,3 +1,30 @@
+"""
+Jobs Endpoints
+=========================
+
+These endpoints are used for monitoring running jobs.
+
+.. contents:: :local:
+
+/jobs/update
+---------------------------------
+
+.. autofunction:: inventory_provider.routes.jobs.update
+
+
+/jobs/check-task-status
+---------------------------------
+
+.. autofunction:: inventory_provider.routes.jobs.check_task_status
+
+
+/jobs/log
+---------------------------------
+
+.. autofunction:: inventory_provider.routes.jobs.load_task_log
+
+
+"""
 import json
 import logging
 
diff --git a/inventory_provider/routes/lg.py b/inventory_provider/routes/lg.py
index c615aa7d..4f2a7561 100644
--- a/inventory_provider/routes/lg.py
+++ b/inventory_provider/routes/lg.py
@@ -1,3 +1,15 @@
+"""
+LG Support Endpoints
+=========================
+
+These endpoints are intended for use by LG.
+
+/lg/interfaces
+---------------------------------
+
+.. autofunction:: inventory_provider.routes.lg.routers
+
+"""
 import json
 import logging
 
diff --git a/inventory_provider/routes/lnetd.py b/inventory_provider/routes/lnetd.py
index 0025ef21..346f857e 100644
--- a/inventory_provider/routes/lnetd.py
+++ b/inventory_provider/routes/lnetd.py
@@ -1,3 +1,18 @@
+"""
+
+LnetD support
+=========================
+
+This endpoint is intended for use with LnetD
+
+.. contents:: :local:
+
+/LnetD/interfaces</hostname>
+---------------------------------
+
+.. autofunction:: inventory_provider.routes.lnetd.interfaces
+
+"""
 import json
 import logging
 import re
diff --git a/inventory_provider/routes/msr.py b/inventory_provider/routes/msr.py
index d970e962..6e53111f 100644
--- a/inventory_provider/routes/msr.py
+++ b/inventory_provider/routes/msr.py
@@ -1,3 +1,60 @@
+"""
+MSR Support Endpoints
+=========================
+
+These endpoints are intended for use by MSR.
+
+.. contents:: :local:
+
+/msr/access-services
+---------------------------------
+
+.. autofunction:: inventory_provider.routes.msr.access_services
+
+
+/msr/bgp/logical-systems
+-------------------------------------
+
+.. autofunction:: inventory_provider.routes.msr.get_logical_systems
+
+
+/msr/bgp/logical-system-peerings</name>
+------------------------------------------
+
+.. autofunction:: inventory_provider.routes.msr.logical_system_peerings
+
+
+/msr/bgp/groups
+-------------------------------------
+
+.. autofunction:: inventory_provider.routes.msr.get_peering_groups
+
+
+/msr/bgp/group-peerings</name>
+-------------------------------------
+
+.. autofunction:: inventory_provider.routes.msr.bgp_group_peerings
+
+
+/msr/bgp/routing-instances
+-------------------------------------
+
+.. autofunction:: inventory_provider.routes.msr.get_peering_routing_instances
+
+
+/msr/bgp/routing-instance-peeringns</name>
+--------------------------------------------
+
+.. autofunction:: inventory_provider.routes.msr.bgp_routing_instance_peerings
+
+helpers
+-------------------------------------
+
+.. autofunction:: inventory_provider.routes.msr._handle_peering_group_list_request
+
+.. autofunction:: inventory_provider.routes.msr._handle_peering_group_request
+
+"""
 import itertools
 import json
 
-- 
GitLab