nbforager 0.8.0__tar.gz → 0.8.2__tar.gz

{nbforager-0.8.0 → nbforager-0.8.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: nbforager
-Version: 0.8.0
+Version: 0.8.2
 Summary: Python package designed to assist in working with the Netbox REST API. The filter parameters are identical to those in the Web UI filter form. It replaces brief data with full information, and Netbox objects are represented as a recursive multidimensional dictionary.
 License: Apache-2.0
 Keywords: netbox
@@ -23,7 +23,7 @@ Requires-Dist: requests (>=2,<3)
 Requires-Dist: tabulate (>=0.9,<0.10)
 Requires-Dist: vhelpers (>=0.3)
 Project-URL: Bug Tracker, https://github.com/vladimirs-git/nbforager/issues
-Project-URL: Download URL, https://github.com/vladimirs-git/nbforager/archive/refs/tags/0.8.0.tar.gz
+Project-URL: Download URL, https://github.com/vladimirs-git/nbforager/archive/refs/tags/0.8.2.tar.gz
 Project-URL: homepage, https://github.com/vladimirs-git/nbforager
 Project-URL: repository, https://github.com/vladimirs-git/nbforager
 Description-Content-Type: text/x-rst

{nbforager-0.8.0 → nbforager-0.8.2}/nbforager/api/base_c.py

@@ -13,13 +13,13 @@ from operator import itemgetter
 from queue import Queue
 from threading import Thread
 from typing import Callable
-from urllib.parse import urlencode, ParseResult
+from urllib.parse import ParseResult
 
 import netports
 import requests
 from requests import Session, Response
 from requests.exceptions import ReadTimeout, ConnectionError as RequestsConnectionError
-from vhelpers import vdict, vlist, vparam
+from vhelpers import vlist, vparam
 
 from nbforager import helpers as h
 from nbforager.api import extended_get
@@ -293,7 +293,7 @@ class BaseC:
         params_d_["brief"] = 1
         params_d_["limit"] = 1
         params_l: LParam = vparam.from_dict(params_d_)
-        url = f"{self.url_base}{path}?{urlencode(params_l)}"
+        url = f"{self.url_base}{path}?{urllib.parse.urlencode(params_l)}"
         response: Response = self._retry_requests(url)
 
         count = 0
@@ -316,62 +316,43 @@ class BaseC:
 
         :return: Netbox objects. Update self _results.
         """
-        offset = 0
-        if offsets := params_d.get("offset"):
-            offset = int(offsets[0])
+        params_d = params_d.copy()
+        if "limit" not in params_d:
+            params_d["limit"] = [self.limit]
+        if "offset" not in params_d:
+            params_d["offset"] = [0]
 
-        max_limit: int = self._set_limit(params_d)
         params_l: LParam = vparam.from_dict(params_d)
+        url = f"{self.url_base}{path}?{urllib.parse.urlencode(params_l)}"
 
         results: LDAny = []
         while True:
-            params_i = [*params_l, ("offset", offset)]
-            url = f"{self.url_base}{path}?{urlencode(params_i)}"
             response: Response = self._retry_requests(url)
-            if response.ok:
-                html: str = response.content.decode("utf-8")
-                data: DAny = json.loads(html)
-                results_: LDAny = list(data["results"])
-                results.extend(results_)
-            else:
-                results_ = []
-
-            # stop requests if limit reached
-            if self.limit != len(results_):
+            if not response.ok:
                 break
-            if max_limit and max_limit <= len(results):
+
+            html: str = response.content.decode("utf-8")
+            data: DAny = json.loads(html)
+            results_: LDAny = list(data["results"])
+            results.extend(results_)
+
+            # retrieve next offset from Response
+            if url_next := str(data.get("next") or ""):
+                url = url_next
+            else:
                 break
 
-            # next iteration
+            # Sleep before the next iteration to reduce server load
             if self.interval:
                 time.sleep(self.interval)
-            offset += self.limit
 
         return results
 
-    def _set_limit(self, params_d: DList) -> int:
-        """Update limit valur in params_d based on limit and max_limit
-
-        :return: Max limit value, update params_d["limit"] value
-        """
-        limit = 0
-        if limit_ := list(vdict.pop(data=params_d, key="limit") or []):
-            limit = int(limit_[0])
-        if not limit:
-            limit = self.limit
-        max_limit = 0
-        if max_limit_ := list(vdict.pop(data=params_d, key="max_limit") or []):
-            max_limit = int(max_limit_[0])
-        if max_limit and max_limit < limit:
-            limit = max_limit
-        params_d["limit"] = [limit]
-        return max_limit
-
     def _query_data_thread(self, path: str, params_d: DAny) -> None:
-        """Retrieve data from the Netbox.
+        """Retrieve data from the Netbox and appends results to the internal results list.
 
-        If the number of items in the result exceeds the limit, iterate through the offset
-        in a loop mode.
+        If the params_d does not have `offset` and the received Response contains "next" URL,
+            the method will recurse to fetch the next set of data.
 
         :param path: Section of the URL that points to the model.
         :param params_d: Parameters to request from the Netbox.
@@ -379,12 +360,26 @@ class BaseC:
         :return: Netbox objects. Update self _results.
         """
         params_l: LParam = vparam.from_dict(params_d)
-        url = f"{self.url_base}{path}?{urlencode(params_l)}"
+        url = f"{self.url_base}{path}?{urllib.parse.urlencode(params_l)}"
+
         response: Response = self._retry_requests(url)
-        if response.ok:
-            html: str = response.content.decode("utf-8")
-            data: DAny = json.loads(html)
-            results_: LDAny = list(data["results"])
+        if not response.ok:
+            return
+
+        html: str = response.content.decode("utf-8")
+        data: DAny = json.loads(html)
+        results_: LDAny = list(data["results"])
+        self._results.extend(results_)
+
+        # threading mode manage offset in top level method
+        if "offset" in params_d:
+            return
+
+        # retrieve next offset from Response
+        if url_next := str(data.get("next") or ""):
+            url_o: ParseResult = urllib.parse.urlparse(url_next)
+            params_d_: DAny = urllib.parse.parse_qs(url_o.query)
+            results_ = self._query_loop(path=path, params_d=params_d_)
             self._results.extend(results_)
 
     def _query_pages_count(self, params_ld: LDList) -> LDAny:

{nbforager-0.8.0 → nbforager-0.8.2}/nbforager/api/connector.py

@@ -5,6 +5,7 @@
 from __future__ import annotations
 
 import json
+from typing import Generator
 
 from requests import Response
 from vhelpers import vdict
@@ -169,3 +170,6 @@ class Connector(BaseC):
         html: str = response.content.decode("utf-8")
         data: DAny = dict(json.loads(html))
         return data
+
+
+GConnector = Generator[Connector, None, None]

nbforager-0.8.2/nbforager/constants.py

@@ -0,0 +1,283 @@
+"""Constants for apps and models."""
+
+from nbforager.types_ import DLStr
+
+APPS = (
+    "circuits",
+    "core",
+    "dcim",
+    "extras",
+    "ipam",
+    "plugins",
+    "tenancy",
+    "users",
+    "virtualization",
+    "wireless",
+)
+"""Application names for NetBox v3.5."""
+
+DEPENDENT_MODELS: DLStr = {
+    "circuits/circuit-terminations": [
+        "circuits/circuits",
+        "circuits/provider-networks",
+        "dcim/cable-terminations",
+        "dcim/sites",
+        "extras/tags",
+    ],
+    "circuits/circuit-types": ["extras/tags"],
+    "circuits/circuits": [
+        "circuits/circuit-types",
+        "circuits/provider-accounts",
+        "circuits/providers",
+        "extras/tags",
+        "tenancy/tenants",
+    ],
+    "circuits/provider-accounts": ["circuits/providers", "extras/tags"],
+    "circuits/provider-networks": ["circuits/providers", "extras/tags"],
+    "circuits/providers": ["extras/tags", "ipam/asns"],
+    "core/data-files": ["core/data-sources"],
+    "core/data-sources": ["extras/tags"],
+    "core/jobs": ["extras/content-types"],
+    "dcim/cable-terminations": [
+        "dcim/cables",
+        "dcim/devices",
+        "dcim/locations",
+        "dcim/racks",
+        "dcim/sites",
+    ],
+    "dcim/cables": ["extras/tags", "tenancy/tenants"],
+    "dcim/console-port-templates": ["dcim/device-types", "dcim/module-types"],
+    "dcim/console-ports": [
+        "dcim/cable-terminations",
+        "dcim/devices",
+        "dcim/modules",
+        "extras/tags",
+    ],
+    "dcim/console-server-port-templates": ["dcim/device-types", "dcim/module-types"],
+    "dcim/console-server-ports": [
+        "dcim/cable-terminations",
+        "dcim/devices",
+        "dcim/modules",
+        "extras/tags",
+    ],
+    "dcim/device-bay-templates": ["dcim/device-types"],
+    "dcim/device-bays": ["dcim/devices", "extras/tags"],
+    "dcim/device-roles": ["extras/config-templates", "extras/tags"],
+    "dcim/device-types": ["dcim/manufacturers", "extras/tags"],
+    "dcim/devices": [
+        "dcim/device-roles",
+        "dcim/device-types",
+        "dcim/locations",
+        "dcim/platforms",
+        "dcim/racks",
+        "dcim/sites",
+        "dcim/virtual-chassis",
+        "extras/config-templates",
+        "extras/tags",
+        "tenancy/tenants",
+        "virtualization/clusters",
+    ],
+    "dcim/front-port-templates": [
+        "dcim/device-types",
+        "dcim/module-types",
+        "dcim/rear-port-templates",
+    ],
+    "dcim/front-ports": [
+        "dcim/cable-terminations",
+        "dcim/devices",
+        "dcim/modules",
+        "dcim/rear-ports",
+        "extras/tags",
+    ],
+    "dcim/interface-templates": ["dcim/device-types", "dcim/module-types"],
+    "dcim/interfaces": [
+        "dcim/cable-terminations",
+        "dcim/devices",
+        "dcim/modules",
+        "dcim/virtual-device-contexts",
+        "extras/tags",
+        "ipam/ip-addresses",
+        "ipam/l2vpn-terminations",
+        "ipam/vlans",
+        "ipam/vrfs",
+        "virtualization/interfaces",
+        "wireless/wireless-lans",
+    ],
+    "dcim/inventory-item-roles": ["extras/tags"],
+    "dcim/inventory-item-templates": [
+        "dcim/device-types",
+        "dcim/inventory-item-roles",
+        "dcim/manufacturers",
+    ],
+    "dcim/inventory-items": [
+        "dcim/devices",
+        "dcim/inventory-item-roles",
+        "dcim/manufacturers",
+        "extras/tags",
+    ],
+    "dcim/locations": ["dcim/sites", "extras/tags", "ipam/vlan-groups", "tenancy/tenants"],
+    "dcim/manufacturers": ["extras/tags"],
+    "dcim/module-bay-templates": ["dcim/device-types"],
+    "dcim/module-bays": ["dcim/devices", "extras/tags"],
+    "dcim/module-types": ["dcim/manufacturers", "extras/tags"],
+    "dcim/modules": ["dcim/devices", "dcim/module-bays", "dcim/module-types", "extras/tags"],
+    "dcim/platforms": ["dcim/manufacturers", "extras/config-templates", "extras/tags"],
+    "dcim/power-feeds": [
+        "dcim/cable-terminations",
+        "dcim/power-panels",
+        "dcim/racks",
+        "extras/tags",
+    ],
+    "dcim/power-outlet-templates": [
+        "dcim/device-types",
+        "dcim/module-types",
+        "dcim/power-port-templates",
+    ],
+    "dcim/power-outlets": [
+        "dcim/cable-terminations",
+        "dcim/devices",
+        "dcim/modules",
+        "dcim/power-ports",
+        "extras/tags",
+    ],
+    "dcim/power-panels": ["dcim/locations", "dcim/sites", "extras/tags"],
+    "dcim/power-port-templates": ["dcim/device-types", "dcim/module-types"],
+    "dcim/power-ports": ["dcim/cable-terminations", "dcim/devices", "dcim/modules", "extras/tags"],
+    "dcim/rack-reservations": ["dcim/racks", "extras/tags", "tenancy/tenants", "users/users"],
+    "dcim/rack-roles": ["extras/tags"],
+    "dcim/racks": [
+        "dcim/locations",
+        "dcim/rack-roles",
+        "dcim/sites",
+        "extras/tags",
+        "ipam/vlan-groups",
+        "tenancy/tenants",
+    ],
+    "dcim/rear-port-templates": ["dcim/device-types", "dcim/module-types"],
+    "dcim/rear-ports": ["dcim/cable-terminations", "dcim/devices", "dcim/modules", "extras/tags"],
+    "dcim/regions": ["extras/tags", "ipam/vlan-groups"],
+    "dcim/site-groups": ["extras/tags", "ipam/vlan-groups"],
+    "dcim/sites": [
+        "dcim/regions",
+        "dcim/site-groups",
+        "extras/tags",
+        "ipam/asns",
+        "ipam/vlan-groups",
+        "tenancy/tenants",
+    ],
+    "dcim/virtual-chassis": ["dcim/devices", "extras/tags"],
+    "dcim/virtual-device-contexts": ["dcim/devices", "extras/tags", "tenancy/tenants"],
+    "extras/config-contexts": [
+        "dcim/device-roles",
+        "dcim/device-types",
+        "dcim/locations",
+        "dcim/platforms",
+        "dcim/regions",
+        "dcim/site-groups",
+        "dcim/sites",
+        "extras/tags",
+        "tenancy/tenant-groups",
+        "tenancy/tenants",
+        "virtualization/cluster-groups",
+        "virtualization/cluster-types",
+        "virtualization/clusters",
+    ],
+    "extras/config-templates": ["extras/tags"],
+    "extras/content-types": [],
+    "extras/custom-fields": ["extras/content-types"],
+    "extras/custom-links": ["extras/content-types"],
+    "extras/export-templates": ["extras/content-types"],
+    "extras/image-attachments": ["extras/content-types"],
+    "extras/journal-entries": ["extras/content-types", "extras/tags", "users/users"],
+    "extras/object-changes": ["users/users"],
+    "extras/saved-filters": ["extras/content-types", "users/users"],
+    "extras/tags": [],
+    "extras/webhooks": ["extras/content-types"],
+    "ipam/aggregates": ["extras/tags", "ipam/rirs", "tenancy/tenants"],
+    "ipam/asn-ranges": ["extras/tags", "ipam/rirs", "tenancy/tenants"],
+    "ipam/asns": ["extras/tags", "ipam/rirs", "tenancy/tenants"],
+    "ipam/fhrp-group-assignments": ["extras/content-types", "ipam/fhrp-groups"],
+    "ipam/fhrp-groups": ["extras/tags", "ipam/ip-addresses"],
+    "ipam/ip-addresses": ["extras/tags", "ipam/vrfs", "tenancy/tenants"],
+    "ipam/ip-ranges": ["extras/tags", "ipam/roles", "ipam/vrfs", "tenancy/tenants"],
+    "ipam/l2vpn-terminations": ["extras/tags", "ipam/l2vpns"],
+    "ipam/l2vpns": ["extras/tags", "ipam/route-targets", "tenancy/tenants"],
+    "ipam/prefixes": [
+        "dcim/sites",
+        "extras/tags",
+        "ipam/roles",
+        "ipam/vlans",
+        "ipam/vrfs",
+        "tenancy/tenants",
+    ],
+    "ipam/rirs": ["extras/tags"],
+    "ipam/roles": ["extras/tags"],
+    "ipam/route-targets": ["extras/tags", "tenancy/tenants"],
+    "ipam/service-templates": ["extras/tags"],
+    "ipam/services": [
+        "dcim/devices",
+        "extras/tags",
+        "ipam/ip-addresses",
+        "virtualization/virtual-machines",
+    ],
+    "ipam/vlan-groups": ["extras/content-types", "extras/tags"],
+    "ipam/vlans": [
+        "dcim/sites",
+        "extras/tags",
+        "ipam/l2vpn-terminations",
+        "ipam/roles",
+        "ipam/vlan-groups",
+        "tenancy/tenants",
+    ],
+    "ipam/vrfs": ["extras/tags", "ipam/route-targets", "tenancy/tenants"],
+    "tenancy/contact-assignments": [
+        "extras/content-types",
+        "tenancy/contact-roles",
+        "tenancy/contacts",
+    ],
+    "tenancy/contact-groups": ["extras/tags"],
+    "tenancy/contact-roles": ["extras/tags"],
+    "tenancy/contacts": ["extras/tags", "tenancy/contact-groups"],
+    "tenancy/tenant-groups": ["extras/tags"],
+    "tenancy/tenants": ["extras/tags", "tenancy/tenant-groups"],
+    "users/groups": [],
+    "users/permissions": ["extras/content-types", "users/groups", "users/users"],
+    "users/tokens": ["users/users"],
+    "users/users": [],
+    "virtualization/cluster-groups": ["extras/tags", "ipam/vlan-groups"],
+    "virtualization/cluster-types": ["extras/tags"],
+    "virtualization/clusters": [
+        "dcim/sites",
+        "extras/tags",
+        "ipam/vlan-groups",
+        "tenancy/tenants",
+        "virtualization/cluster-groups",
+        "virtualization/cluster-types",
+    ],
+    "virtualization/interfaces": [
+        "extras/tags",
+        "ipam/ip-addresses",
+        "ipam/l2vpn-terminations",
+        "ipam/vlans",
+        "ipam/vrfs",
+        "virtualization/virtual-machines",
+    ],
+    "virtualization/virtual-machines": [
+        "dcim/device-roles",
+        "dcim/devices",
+        "dcim/platforms",
+        "dcim/sites",
+        "extras/tags",
+        "tenancy/tenants",
+        "virtualization/clusters",
+    ],
+    "wireless/wireless-lan-groups": ["extras/tags"],
+    "wireless/wireless-lans": [
+        "extras/tags",
+        "ipam/vlans",
+        "tenancy/tenants",
+        "wireless/wireless-lan-groups",
+    ],
+    "wireless/wireless-links": ["extras/tags", "tenancy/tenants"],
+}
+"""Models dependency for Netbox v3.5."""

{nbforager-0.8.0 → nbforager-0.8.2}/nbforager/helpers.py

@@ -9,286 +9,13 @@ from urllib.parse import ParseResult, urlencode, urlparse, parse_qs
 from vhelpers import vlist, vparam, vint
 
 from nbforager.exceptions import NbApiError
+from nbforager.constants import DEPENDENT_MODELS
 from nbforager.types_ import LStr, LDAny, DDDLInt, LValue, LParam, LDList, DList, DLStr, ODLStr
 from nbforager.types_ import LTInt2, DAny, SeqStr, SStr, TValues, TLists, T2Str, T3Str, T3StrInt
 
-# Netbox v3.5
-DEPENDENT_MODELS: DLStr = {
-    "circuits/circuit-terminations": [
-        "circuits/circuits",
-        "circuits/provider-networks",
-        "dcim/cable-terminations",
-        "dcim/sites",
-        "extras/tags",
-    ],
-    "circuits/circuit-types": ["extras/tags"],
-    "circuits/circuits": [
-        "circuits/circuit-types",
-        "circuits/provider-accounts",
-        "circuits/providers",
-        "extras/tags",
-        "tenancy/tenants",
-    ],
-    "circuits/provider-accounts": ["circuits/providers", "extras/tags"],
-    "circuits/provider-networks": ["circuits/providers", "extras/tags"],
-    "circuits/providers": ["extras/tags", "ipam/asns"],
-    "core/data-files": ["core/data-sources"],
-    "core/data-sources": ["extras/tags"],
-    "core/jobs": ["extras/content-types"],
-    "dcim/cable-terminations": [
-        "dcim/cables",
-        "dcim/devices",
-        "dcim/locations",
-        "dcim/racks",
-        "dcim/sites",
-    ],
-    "dcim/cables": ["extras/tags", "tenancy/tenants"],
-    "dcim/console-port-templates": ["dcim/device-types", "dcim/module-types"],
-    "dcim/console-ports": [
-        "dcim/cable-terminations",
-        "dcim/devices",
-        "dcim/modules",
-        "extras/tags",
-    ],
-    "dcim/console-server-port-templates": ["dcim/device-types", "dcim/module-types"],
-    "dcim/console-server-ports": [
-        "dcim/cable-terminations",
-        "dcim/devices",
-        "dcim/modules",
-        "extras/tags",
-    ],
-    "dcim/device-bay-templates": ["dcim/device-types"],
-    "dcim/device-bays": ["dcim/devices", "extras/tags"],
-    "dcim/device-roles": ["extras/config-templates", "extras/tags"],
-    "dcim/device-types": ["dcim/manufacturers", "extras/tags"],
-    "dcim/devices": [
-        "dcim/device-roles",
-        "dcim/device-types",
-        "dcim/locations",
-        "dcim/platforms",
-        "dcim/racks",
-        "dcim/sites",
-        "dcim/virtual-chassis",
-        "extras/config-templates",
-        "extras/tags",
-        "tenancy/tenants",
-        "virtualization/clusters",
-    ],
-    "dcim/front-port-templates": [
-        "dcim/device-types",
-        "dcim/module-types",
-        "dcim/rear-port-templates",
-    ],
-    "dcim/front-ports": [
-        "dcim/cable-terminations",
-        "dcim/devices",
-        "dcim/modules",
-        "dcim/rear-ports",
-        "extras/tags",
-    ],
-    "dcim/interface-templates": ["dcim/device-types", "dcim/module-types"],
-    "dcim/interfaces": [
-        "dcim/cable-terminations",
-        "dcim/devices",
-        "dcim/modules",
-        "dcim/virtual-device-contexts",
-        "extras/tags",
-        "ipam/ip-addresses",
-        "ipam/l2vpn-terminations",
-        "ipam/vlans",
-        "ipam/vrfs",
-        "virtualization/interfaces",
-        "wireless/wireless-lans",
-    ],
-    "dcim/inventory-item-roles": ["extras/tags"],
-    "dcim/inventory-item-templates": [
-        "dcim/device-types",
-        "dcim/inventory-item-roles",
-        "dcim/manufacturers",
-    ],
-    "dcim/inventory-items": [
-        "dcim/devices",
-        "dcim/inventory-item-roles",
-        "dcim/manufacturers",
-        "extras/tags",
-    ],
-    "dcim/locations": ["dcim/sites", "extras/tags", "ipam/vlan-groups", "tenancy/tenants"],
-    "dcim/manufacturers": ["extras/tags"],
-    "dcim/module-bay-templates": ["dcim/device-types"],
-    "dcim/module-bays": ["dcim/devices", "extras/tags"],
-    "dcim/module-types": ["dcim/manufacturers", "extras/tags"],
-    "dcim/modules": ["dcim/devices", "dcim/module-bays", "dcim/module-types", "extras/tags"],
-    "dcim/platforms": ["dcim/manufacturers", "extras/config-templates", "extras/tags"],
-    "dcim/power-feeds": [
-        "dcim/cable-terminations",
-        "dcim/power-panels",
-        "dcim/racks",
-        "extras/tags",
-    ],
-    "dcim/power-outlet-templates": [
-        "dcim/device-types",
-        "dcim/module-types",
-        "dcim/power-port-templates",
-    ],
-    "dcim/power-outlets": [
-        "dcim/cable-terminations",
-        "dcim/devices",
-        "dcim/modules",
-        "dcim/power-ports",
-        "extras/tags",
-    ],
-    "dcim/power-panels": ["dcim/locations", "dcim/sites", "extras/tags"],
-    "dcim/power-port-templates": ["dcim/device-types", "dcim/module-types"],
-    "dcim/power-ports": ["dcim/cable-terminations", "dcim/devices", "dcim/modules", "extras/tags"],
-    "dcim/rack-reservations": ["dcim/racks", "extras/tags", "tenancy/tenants", "users/users"],
-    "dcim/rack-roles": ["extras/tags"],
-    "dcim/racks": [
-        "dcim/locations",
-        "dcim/rack-roles",
-        "dcim/sites",
-        "extras/tags",
-        "ipam/vlan-groups",
-        "tenancy/tenants",
-    ],
-    "dcim/rear-port-templates": ["dcim/device-types", "dcim/module-types"],
-    "dcim/rear-ports": ["dcim/cable-terminations", "dcim/devices", "dcim/modules", "extras/tags"],
-    "dcim/regions": ["extras/tags", "ipam/vlan-groups"],
-    "dcim/site-groups": ["extras/tags", "ipam/vlan-groups"],
-    "dcim/sites": [
-        "dcim/regions",
-        "dcim/site-groups",
-        "extras/tags",
-        "ipam/asns",
-        "ipam/vlan-groups",
-        "tenancy/tenants",
-    ],
-    "dcim/virtual-chassis": ["dcim/devices", "extras/tags"],
-    "dcim/virtual-device-contexts": ["dcim/devices", "extras/tags", "tenancy/tenants"],
-    "extras/branchs": ["users/users"],
-    "extras/config-contexts": [
-        "dcim/device-roles",
-        "dcim/device-types",
-        "dcim/locations",
-        "dcim/platforms",
-        "dcim/regions",
-        "dcim/site-groups",
-        "dcim/sites",
-        "extras/tags",
-        "tenancy/tenant-groups",
-        "tenancy/tenants",
-        "virtualization/cluster-groups",
-        "virtualization/cluster-types",
-        "virtualization/clusters",
-    ],
-    "extras/config-templates": ["extras/tags"],
-    "extras/content-types": [],
-    "extras/custom-fields": ["extras/content-types"],
-    "extras/custom-links": ["extras/content-types"],
-    "extras/dashboards": ["users/users"],
-    "extras/export-templates": ["extras/content-types"],
-    "extras/image-attachments": ["extras/content-types"],
-    "extras/journal-entries": ["extras/content-types", "extras/tags", "users/users"],
-    "extras/object-changes": ["users/users"],
-    "extras/saved-filters": ["extras/content-types", "users/users"],
-    "extras/tagged-items": ["extras/content-types", "extras/tags"],
-    "extras/tags": [],
-    "extras/webhooks": ["extras/content-types"],
-    "ipam/aggregates": ["extras/tags", "ipam/rirs", "tenancy/tenants"],
-    "ipam/asn-ranges": ["extras/tags", "ipam/rirs", "tenancy/tenants"],
-    "ipam/asns": ["extras/tags", "ipam/rirs", "tenancy/tenants"],
-    "ipam/fhrp-group-assignments": ["extras/content-types", "ipam/fhrp-groups"],
-    "ipam/fhrp-groups": ["extras/tags", "ipam/ip-addresses"],
-    "ipam/ip-addresses": ["extras/tags", "ipam/vrfs", "tenancy/tenants"],
-    "ipam/ip-ranges": ["extras/tags", "ipam/roles", "ipam/vrfs", "tenancy/tenants"],
-    "ipam/l2vpn-terminations": ["extras/tags", "ipam/l2vpns"],
-    "ipam/l2vpns": ["extras/tags", "ipam/route-targets", "tenancy/tenants"],
-    "ipam/prefixes": [
-        "dcim/sites",
-        "extras/tags",
-        "ipam/roles",
-        "ipam/vlans",
-        "ipam/vrfs",
-        "tenancy/tenants",
-    ],
-    "ipam/rirs": ["extras/tags"],
-    "ipam/roles": ["extras/tags"],
-    "ipam/route-targets": ["extras/tags", "tenancy/tenants"],
-    "ipam/service-templates": ["extras/tags"],
-    "ipam/services": [
-        "dcim/devices",
-        "extras/tags",
-        "ipam/ip-addresses",
-        "virtualization/virtual-machines",
-    ],
-    "ipam/vlan-groups": ["extras/content-types", "extras/tags"],
-    "ipam/vlans": [
-        "dcim/sites",
-        "extras/tags",
-        "ipam/l2vpn-terminations",
-        "ipam/roles",
-        "ipam/vlan-groups",
-        "tenancy/tenants",
-    ],
-    "ipam/vrfs": ["extras/tags", "ipam/route-targets", "tenancy/tenants"],
-    "nb_config_checker/tasks": ["extras/tags", "users/users"],
-    "social_django/user-social-auths": ["users/users"],
-    "taggit/tagged-items": ["extras/content-types"],
-    "tenancy/contact-assignments": [
-        "extras/content-types",
-        "tenancy/contact-roles",
-        "tenancy/contacts",
-    ],
-    "tenancy/contact-groups": ["extras/tags"],
-    "tenancy/contact-roles": ["extras/tags"],
-    "tenancy/contacts": ["extras/tags", "tenancy/contact-groups"],
-    "tenancy/tenant-groups": ["extras/tags"],
-    "tenancy/tenants": ["extras/tags", "tenancy/tenant-groups"],
-    "users/groups": [],
-    "users/permissions": ["extras/content-types", "users/groups", "users/users"],
-    "users/tokens": ["users/users"],
-    "users/user-preferences": ["users/users"],
-    "users/users": [],
-    "virtualization/cluster-groups": ["extras/tags", "ipam/vlan-groups"],
-    "virtualization/cluster-types": ["extras/tags"],
-    "virtualization/clusters": [
-        "dcim/sites",
-        "extras/tags",
-        "ipam/vlan-groups",
-        "tenancy/tenants",
-        "virtualization/cluster-groups",
-        "virtualization/cluster-types",
-    ],
-    "virtualization/interfaces": [
-        "extras/tags",
-        "ipam/ip-addresses",
-        "ipam/l2vpn-terminations",
-        "ipam/vlans",
-        "ipam/vrfs",
-        "virtualization/virtual-machines",
-    ],
-    "virtualization/virtual-machines": [
-        "dcim/device-roles",
-        "dcim/devices",
-        "dcim/platforms",
-        "dcim/sites",
-        "extras/tags",
-        "tenancy/tenants",
-        "virtualization/clusters",
-    ],
-    "wireless/wireless-lan-groups": ["extras/tags"],
-    "wireless/wireless-lans": [
-        "extras/tags",
-        "ipam/vlans",
-        "tenancy/tenants",
-        "wireless/wireless-lan-groups",
-    ],
-    "wireless/wireless-links": ["extras/tags", "tenancy/tenants"],
-}
-"""Models dependency for Netbox v3.5"""
-
 
 def dependency_ordered_paths(dependency: ODLStr = None) -> LStr:
-    """Order paths based on dependencies. Models with the lowes count dependencies will be first.
+    """Order paths based on dependencies. Models with the lowes count of dependencies will be first.
 
     :param dependency: Dictionary representing dependencies,
         where key is the parent model and value is a list of child models.

{nbforager-0.8.0 → nbforager-0.8.2}/nbforager/nb_api.py

@@ -10,6 +10,7 @@ from requests import Response
 
 from nbforager import helpers as h
 from nbforager.api.circuits import CircuitsAC
+from nbforager.api.connector import Connector, GConnector
 from nbforager.api.core import CoreAC
 from nbforager.api.dcim import DcimAC
 from nbforager.api.extras import ExtrasAC
@@ -20,22 +21,10 @@ from nbforager.api.tenancy import TenancyAC
 from nbforager.api.users import UsersAC
 from nbforager.api.virtualization import VirtualizationAC
 from nbforager.api.wireless import WirelessAC
+from nbforager.constants import APPS
 from nbforager.parser.nb_parser import NbParser
 from nbforager.types_ import ODLStr, ODDAny, DAny, LDAny, LStr, LT2Str
 
-APPS = (
-    "circuits",
-    "core",
-    "dcim",
-    "extras",
-    "ipam",
-    "plugins",
-    "tenancy",
-    "users",
-    "virtualization",
-    "wireless",
-)
-
 
 class NbApi:
     """NbApi, Python wrapper of Netbox REST API.
@@ -282,8 +271,17 @@ class NbApi:
                 app_paths.append(path)
         return app_paths
 
-    def connectors(self) -> ODDAny:
-        """Return list of Connector instances ordered"""
+    def connectors(self) -> GConnector:
+        """Return generator of Connector instances ordered based on dependencies.
+            Connectors to models with the lowes count of dependencies will be first.
+
+        :return: Generator of Connector instances.
+        """
+        paths: LStr = h.dependency_ordered_paths()
+        for path in paths:
+            app, model = h.path_to_attrs(path)
+            connector: Connector = getattr(getattr(self, app), model)
+            yield connector
 
     def copy(self, **kwargs) -> NbApi:
         """Create a duplicate of the object.

{nbforager-0.8.0 → nbforager-0.8.2}/nbforager/types_.py

@@ -2,7 +2,7 @@
 
 from datetime import datetime
 from pathlib import Path
-from typing import Any, Dict, List, Optional, Set, Tuple, Union, Sequence, TypeVar
+from typing import Any, Dict, List, Optional, Sequence, Set, TypeVar, Tuple, Union
 
 # 1 level
 DAny = Dict[str, Any]
@@ -10,6 +10,7 @@ DInt = Dict[str, int]
 DObj = Dict[str, object]
 DStr = Dict[str, str]
 Int = int
+IntStr = Union[int, str]
 LBool = List[bool]
 LInt = List[int]
 LPath = List[Path]
@@ -22,11 +23,10 @@ SInt = Set[int]
 SStr = Set[str]
 SeqStr = Sequence[str]
 Str = str
-IntStr = Union[int, str]
 T = TypeVar("T")
 T2Str = Tuple[str, str]
-T3StrInt = Tuple[str, str, int]
 T3Str = Tuple[str, str, str]
+T3StrInt = Tuple[str, str, int]
 TLists = (list, set, tuple)
 TStr = Tuple[str, ...]
 TValues = (str, int, float)

{nbforager-0.8.0 → nbforager-0.8.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "nbforager"
-version = "0.8.0"
+version = "0.8.2"
 description = "Python package designed to assist in working with the Netbox REST API. The filter parameters are identical to those in the Web UI filter form. It replaces brief data with full information, and Netbox objects are represented as a recursive multidimensional dictionary."
 authors = ["Vladimirs Prusakovs <vladimir.prusakovs@gmail.com>"]
 readme = "README.rst"
@@ -19,7 +19,7 @@ classifiers = [
 homepage = "https://github.com/vladimirs-git/nbforager"
 repository = "https://github.com/vladimirs-git/nbforager"
 "Bug Tracker" = "https://github.com/vladimirs-git/nbforager/issues"
-"Download URL" = "https://github.com/vladimirs-git/nbforager/archive/refs/tags/0.8.0.tar.gz"
+"Download URL" = "https://github.com/vladimirs-git/nbforager/archive/refs/tags/0.8.2.tar.gz"
 
 [tool.poetry.dependencies]
 python = "^3.11"