diff --git a/gso/auth/oidc.py b/gso/auth/oidc.py
index 02720fe170e55250218f5bdc2f722add2b88d3ad..ccbbe16382de30d092fd3d90c534d7499757cfc7 100644
--- a/gso/auth/oidc.py
+++ b/gso/auth/oidc.py
@@ -43,7 +43,7 @@ def ensure_openid_config_loaded(func: Callable) -> Callable:
class OIDCAuthentication(OIDCAuth):
- """OIDCUser class extends the ``HTTPBearer`` class to do extra verification.
+ """OIDCUser class extends the `HTTPBearer` class to do extra verification.
The class will act as follows: Validate the Credentials at the AAI proxy by calling the UserInfo endpoint.
"""
diff --git a/gso/cli/imports.py b/gso/cli/imports.py
index fad9d1e14328b4319d60ed066cbc79b188c7b584..fc81b03b3f3c45c54f95db64a872c91cbeee1be6 100644
--- a/gso/cli/imports.py
+++ b/gso/cli/imports.py
@@ -64,11 +64,11 @@ class CreatePartner(BaseModel):
class SiteImportModel(BaseSiteValidatorModel):
- """The required input for importing an existing ``gso.products.product_types.site``."""
+ """The required input for importing an existing `gso.products.product_types.site`."""
class RouterImportModel(BaseModel):
- """Required fields for importing an existing ``gso.product.product_types.router``."""
+ """Required fields for importing an existing `gso.product.product_types.router`."""
partner: str
router_site: str
@@ -82,7 +82,7 @@ class RouterImportModel(BaseModel):
class SwitchImportModel(BaseModel):
- """Required fields for importing an existing ``gso.product.product_types.switch``."""
+ """Required fields for importing an existing `gso.product.product_types.switch`."""
fqdn: str
ts_port: PortNumber
@@ -92,7 +92,7 @@ class SwitchImportModel(BaseModel):
class SuperPopSwitchImportModel(BaseModel):
- """Required fields for importing an existing ``gso.product.product_types.super_pop_switch``."""
+ """Required fields for importing an existing `gso.product.product_types.super_pop_switch`."""
partner: str
super_pop_switch_site: str
@@ -102,7 +102,7 @@ class SuperPopSwitchImportModel(BaseModel):
class OfficeRouterImportModel(BaseModel):
- """Required fields for importing an existing ``gso.product.product_types.office_router``."""
+ """Required fields for importing an existing `gso.product.product_types.office_router`."""
partner: str
office_router_site: str
@@ -113,7 +113,7 @@ class OfficeRouterImportModel(BaseModel):
class IptrunkImportModel(BaseModel):
- """Required fields for importing an existing ``gso.products.product_types.iptrunk``."""
+ """Required fields for importing an existing `gso.products.product_types.iptrunk`."""
partner: str
gs_id: IMPORTED_GS_ID | None
@@ -178,7 +178,7 @@ class IptrunkImportModel(BaseModel):
class OpenGearImportModel(BaseModel):
- """Required fields for importing an existing ``gso.products.product_types.opengear``."""
+ """Required fields for importing an existing `gso.products.product_types.opengear`."""
partner: str
opengear_site: str
@@ -189,7 +189,7 @@ class OpenGearImportModel(BaseModel):
class EdgePortImportModel(BaseModel):
- """Required fields for importing an existing ``gso.products.product_types.edge_port``."""
+ """Required fields for importing an existing `gso.products.product_types.edge_port`."""
node: str
service_type: EdgePortType
diff --git a/gso/products/product_blocks/bgp_session.py b/gso/products/product_blocks/bgp_session.py
index 8113654ae2304be9ee1d265630925508b8eb1be3..863a2da0ac904a5522b58fb15e048c9ee013173b 100644
--- a/gso/products/product_blocks/bgp_session.py
+++ b/gso/products/product_blocks/bgp_session.py
@@ -14,9 +14,13 @@ class IPFamily(strEnum):
"""Possible IP families of a BGP peering."""
V4UNICAST = "ipv4"
+ """Unicast IPv4"""
V6UNICAST = "ipv6"
+ """Unicast IPv6"""
V4MULTICAST = "mcast-ipv4"
+ """Multicast IPv4"""
V6MULTICAST = "mcast-ipv6"
+ """Multicast IPv6"""
@strawberry.enum
@@ -24,11 +28,13 @@ class IPTypes(strEnum):
"""Possible IP types of a BGP peering."""
IPV4 = "ipv4"
+ """IPv4"""
IPV6 = "ipv6"
+ """IPv6"""
class BGPSessionInactive(ProductBlockModel, lifecycle=[SubscriptionLifecycle.INITIAL], product_block_name="BGPSession"):
- """A BGP session that is currently inactive. See ``BGPSession``."""
+ """A BGP session that is currently inactive. See `BGPSession`."""
peer_address: IPAddress | None = None
families: list[IPFamily] = Field(default_factory=list)
@@ -45,7 +51,7 @@ class BGPSessionInactive(ProductBlockModel, lifecycle=[SubscriptionLifecycle.INI
class BGPSessionProvisioning(BGPSessionInactive, lifecycle=[SubscriptionLifecycle.PROVISIONING]):
- """A BGP session that is currently being provisioned. See ``BGPSession``."""
+ """A BGP session that is currently being provisioned. See `BGPSession`."""
peer_address: IPAddress
families: list[IPFamily]
@@ -62,29 +68,32 @@ class BGPSessionProvisioning(BGPSessionInactive, lifecycle=[SubscriptionLifecycl
class BGPSession(BGPSessionProvisioning, lifecycle=[SubscriptionLifecycle.ACTIVE]):
- """A BGP session that is currently deployed in the network."""
+ """A BGP session that is currently deployed in the network.
+
+ Attributes:
+ peer_address: The peering address of the session.
+ families: The list of IP families enabled for this session.
+ has_custom_policies: Whether any custom policies exist for this session.
+ authentication_key: The authentication key of the BGP session.
+ multipath_enabled: Whether multi-path is enabled.
+ send_default_route: Whether we send a last resort route.
+ is_multi_hop: Whether this session is multi-hop or not. Defaults to no.
+ is_passive: Whether this is a passive session.
+ rtbh_enabled: Whether Remote Triggered Blackhole is enabled.
+ bfd_enabled: Settings for BFD.
+ ip_type: The IP type of the session.
+ prefix_limit: A prefix limit, if required.
+ """
- #: The peering address of the session.
peer_address: IPAddress
- #: The list of IP families enabled for this session.
families: list[IPFamily]
- #: Whether any custom policies exist for this session.
has_custom_policies: bool
- #: The authentication key of the BGP session.
authentication_key: str | None
- #: Whether multi-path is enabled.
multipath_enabled: bool
- #: Whether we send a last resort route.
send_default_route: bool
- #: Whether this session is multi-hop or not. Defaults to no.
is_multi_hop: bool
- #: Whether this is a passive session.
is_passive: bool
- #: Whether Remote Triggered Blackhole is enabled
rtbh_enabled: bool
- #: Settings for BFD.
bfd_enabled: bool
- #: The IP type of the session.
ip_type: IPTypes
- #: A prefix limit, if required
prefix_limit: NonNegativeInt | None
diff --git a/gso/products/product_blocks/iptrunk.py b/gso/products/product_blocks/iptrunk.py
index 9ffaa7881826325950d2cd0a08b2ed03bcc9c4a0..785d0550a009e71d13cdaa013a224c774b4be0c7 100644
--- a/gso/products/product_blocks/iptrunk.py
+++ b/gso/products/product_blocks/iptrunk.py
@@ -94,7 +94,7 @@ class IptrunkBlockInactive(
lifecycle=[SubscriptionLifecycle.INITIAL],
product_block_name="IptrunkBlock",
):
- """A trunk that's currently inactive, see ``IptrunkBlock``."""
+ """A trunk that's currently inactive, see `IptrunkBlock`."""
gs_id: str | None = None
iptrunk_description: str | None = None
@@ -108,7 +108,7 @@ class IptrunkBlockInactive(
class IptrunkBlockProvisioning(IptrunkBlockInactive, lifecycle=[SubscriptionLifecycle.PROVISIONING]):
- """A trunk that's currently being provisioned, see ``IptrunkBlock``."""
+ """A trunk that's currently being provisioned, see `IptrunkBlock`."""
gs_id: str | None = None
iptrunk_description: str | None = None
@@ -122,23 +122,26 @@ class IptrunkBlockProvisioning(IptrunkBlockInactive, lifecycle=[SubscriptionLife
class IptrunkBlock(IptrunkBlockProvisioning, lifecycle=[SubscriptionLifecycle.ACTIVE]):
- """A trunk that's currently deployed in the network."""
+ """A trunk that's currently deployed in the network.
+
+ Attributes:
+ gs_id: GÉANT service ID associated with this trunk.
+ iptrunk_description: A human-readable description of this trunk.
+ iptrunk_type: The type of trunk, can be either dark fibre or leased capacity.
+ iptrunk_speed: The speed of the trunk, measured per interface associated with it.
+ iptrunk_minimum_links: The minimum amount of links the trunk should consist of.
+ iptrunk_isis_metric: The ISIS metric of this link.
+ iptrunk_ipv4_network: The IPv4 network used for this trunk.
+ iptrunk_ipv6_network: The IPv6 network used for this trunk.
+ iptrunk_sides: The two sides that the trunk is connected to.
+ """
- #: GÉANT service ID associated with this trunk.
gs_id: str | None = None
- #: A human-readable description of this trunk.
iptrunk_description: str | None = None
- #: The type of trunk, can be either dark fibre or leased capacity.
iptrunk_type: IptrunkType
- #: The speed of the trunk, measured per interface associated with it.
iptrunk_speed: PhysicalPortCapacity
- #: The minimum amount of links the trunk should consist of.
iptrunk_minimum_links: int
- #: The ISIS metric of this link
iptrunk_isis_metric: int
- #: The IPv4 network used for this trunk.
iptrunk_ipv4_network: ipaddress.IPv4Network
- #: The IPv6 network used for this trunk.
iptrunk_ipv6_network: ipaddress.IPv6Network
- #: The two sides that the trunk is connected to.
iptrunk_sides: IptrunkSides[IptrunkSideBlock] # type: ignore[assignment]
diff --git a/gso/products/product_blocks/l3_core_service.py b/gso/products/product_blocks/l3_core_service.py
index 088dd5eea8dd696cb8b6b1f8cca2e6cfa05efd89..ce2db1782410311e8d37f34d4b92cd27abed8d01 100644
--- a/gso/products/product_blocks/l3_core_service.py
+++ b/gso/products/product_blocks/l3_core_service.py
@@ -33,6 +33,7 @@ class AccessPort(AccessPortProvisioning, lifecycle=[SubscriptionLifecycle.ACTIVE
ap_type: The type of Access Port
sbp: The corresponding SBP of this Access Port.
"""
+
ap_type: APType
sbp: ServiceBindingPort
@@ -57,4 +58,5 @@ class L3CoreServiceBlock(L3CoreServiceBlockProvisioning, lifecycle=[Subscription
Attributes:
ap_list: The list of Access Points where this service is present.
"""
+
ap_list: list[AccessPort] # type: ignore[assignment]
diff --git a/gso/products/product_blocks/layer_2_circuit.py b/gso/products/product_blocks/layer_2_circuit.py
index 40968dfea10be3dc5ab4204fe7dd258c3a8f2194..2e1a7c53b7a995efedc6c09377ef19f4d2ee158b 100644
--- a/gso/products/product_blocks/layer_2_circuit.py
+++ b/gso/products/product_blocks/layer_2_circuit.py
@@ -95,21 +95,24 @@ class Layer2CircuitBlockProvisioning(Layer2CircuitBlockInactive, lifecycle=[Subs
class Layer2CircuitBlock(Layer2CircuitBlockProvisioning, lifecycle=[SubscriptionLifecycle.ACTIVE]):
- """An active Layer 2 Circuit."""
+ """An active Layer 2 Circuit.
+
+ Attributes:
+ layer_2_circuit_sides: The two sides that the Layer 2 Circuit is connected to.
+ virtual_circuit_id: Virtual Circuit ID of this Layer 2 Circuit.
+ layer_2_circuit_type: The type of circuit, can be tagged or untagged.
+ vlan_range_lower_bound: If tagged, the lower and upper bounds will set the VLAN range.
+ vlan_range_upper_bound: Lower and Upper bounds are including.
+ policer_enabled: Whether this Layer 2 Circuit is policed.
+ policer_burst_rate: If policed, the burst rate of the policer.
+ bandwidth: If policed, the bandwidth of the policer is stored.
+ """
- #: The two sides that the Layer 2 Circuit is connected to.
layer_2_circuit_sides: Layer2CircuitSides[Layer2CircuitSideBlock]
- #: Virtual Circuit ID of this Layer 2 Circuit.
virtual_circuit_id: VC_ID
- #: The type of circuit, can be tagged or untagged.
layer_2_circuit_type: Layer2CircuitType
- #: If tagged, the lower and upper bounds will set the VLAN range.
vlan_range_lower_bound: VLAN_ID | None
- #: Lower and Upper bounds are including.
vlan_range_upper_bound: VLAN_ID | None
- #: Whether this Layer 2 Circuit is policed.
policer_enabled: bool
- #: If policed, the burst rate of the policer
policer_burst_rate: BandwidthString | None
- #: If policed, the bandwidth of the policer is stored.
bandwidth: BandwidthString | None
diff --git a/gso/products/product_blocks/office_router.py b/gso/products/product_blocks/office_router.py
index 0a16b4f43a27b385b9b3dc051feaf4fcf626ad78..8afb980971849a40619ac5a357e2e05f0bbf4673 100644
--- a/gso/products/product_blocks/office_router.py
+++ b/gso/products/product_blocks/office_router.py
@@ -17,39 +17,43 @@ class OfficeRouterBlockInactive(
lifecycle=[SubscriptionLifecycle.INITIAL],
product_block_name="OfficeRouterBlock",
):
- """An office router that's being currently inactive. See ``OfficeRouterBlock``."""
+ """An office router that's being currently inactive. See `OfficeRouterBlock`."""
office_router_fqdn: str | None = None
office_router_ts_port: PortNumber | None = None
office_router_lo_ipv4_address: IPv4AddressType | None = None
office_router_lo_ipv6_address: IPv6AddressType | None = None
office_router_site: SiteBlockInactive | None
- vendor: Vendor | None = None
+ vendor: Vendor | None = Vendor.JUNIPER
class OfficeRouterBlockProvisioning(OfficeRouterBlockInactive, lifecycle=[SubscriptionLifecycle.PROVISIONING]):
- """An office router that's being provisioned. See ``RouterBlock``."""
+ """An office router that's being provisioned. See `RouterBlock`."""
- office_router_fqdn: str | None = None
- office_router_ts_port: PortNumber | None = None
- office_router_lo_ipv4_address: IPv4AddressType | None = None
- office_router_lo_ipv6_address: IPv6AddressType | None = None
+ office_router_fqdn: str | None
+ office_router_ts_port: PortNumber | None
+ office_router_lo_ipv4_address: IPv4AddressType | None
+ office_router_lo_ipv6_address: IPv6AddressType | None
office_router_site: SiteBlockProvisioning | None
- vendor: Vendor | None = None
+ vendor: Vendor
class OfficeRouterBlock(OfficeRouterBlockProvisioning, lifecycle=[SubscriptionLifecycle.ACTIVE]):
- """An office router that's currently deployed in the network."""
+ """An office router that's currently deployed in the network.
+
+ Attributes:
+ office_router_fqdn: Office router FQDN.
+ office_router_ts_port: The port of the terminal server that this office router is connected to. Used to offer
+ out of band access.
+ office_router_lo_ipv4_address: The IPv4 loopback address of the office router.
+ office_router_lo_ipv6_address: The IPv6 loopback address of the office router.
+ office_router_site: The `Site` that this office router resides in. Both physically and computationally.
+ vendor: The vendor of an office router. Defaults to Juniper.
+ """
- #: Office router FQDN.
office_router_fqdn: str
- #: The port of the terminal server that this office router is connected to. Used to offer out of band access.
office_router_ts_port: PortNumber
- #: The IPv4 loopback address of the office router.
office_router_lo_ipv4_address: IPv4AddressType
- #: The IPv6 loopback address of the office router.
office_router_lo_ipv6_address: IPv6AddressType
- #: The ``Site`` that this office router resides in. Both physically and computationally.
office_router_site: SiteBlock
- #: The vendor of an office router. Defaults to Juniper.
- vendor: Vendor = Vendor.JUNIPER
+ vendor: Vendor
diff --git a/gso/products/product_blocks/opengear.py b/gso/products/product_blocks/opengear.py
index 8fd88b31718c5cf255462a3af45be586ca0e6497..9d1571f66afbaede69fedc0b653e3d25bf8acb28 100644
--- a/gso/products/product_blocks/opengear.py
+++ b/gso/products/product_blocks/opengear.py
@@ -1,4 +1,4 @@
-"""Product block for ``Opengear`` products."""
+"""Product block for `Opengear` products."""
import ipaddress
@@ -17,7 +17,7 @@ class OpengearBlockInactive(
lifecycle=[SubscriptionLifecycle.INITIAL],
product_block_name="OpengearBlock",
):
- """An Opengear that's being currently inactive. See ``OpengearBlock``."""
+ """An Opengear that's being currently inactive. See `OpengearBlock`."""
opengear_hostname: str | None = None
opengear_site: SiteBlockInactive | None = None
@@ -27,7 +27,7 @@ class OpengearBlockInactive(
class OpengearBlockProvisioning(OpengearBlockInactive, lifecycle=[SubscriptionLifecycle.PROVISIONING]):
- """An Opengear that's being provisioned. See ``OpengearBlock``."""
+ """An Opengear that's being provisioned. See `OpengearBlock`."""
opengear_hostname: str
opengear_site: SiteBlockProvisioning
diff --git a/gso/products/product_blocks/pop_vlan.py b/gso/products/product_blocks/pop_vlan.py
index f4ee9c4030171932fef89e2c1c0d7e2a3511de25..a883477de2a535f29f4f127d1805621a30afb4db 100644
--- a/gso/products/product_blocks/pop_vlan.py
+++ b/gso/products/product_blocks/pop_vlan.py
@@ -60,7 +60,7 @@ class PopVlanBlockInactive(
lifecycle=[SubscriptionLifecycle.INITIAL],
product_block_name="PopVlanBlock",
):
- """A PoP VLAN that's currently inactive, see ``PopVlanBlock``."""
+ """A PoP VLAN that's currently inactive, see `PopVlanBlock`."""
vlan_id: int
pop_vlan_description: str | None = None
@@ -72,7 +72,7 @@ class PopVlanBlockInactive(
class PopVlanBlockProvisioning(PopVlanBlockInactive, lifecycle=[SubscriptionLifecycle.PROVISIONING]):
- """A Pop VLAN that's currently being provisioned, see ``PopVlanBlock``."""
+ """A Pop VLAN that's currently being provisioned, see `PopVlanBlock`."""
vlan_id: int
pop_vlan_description: str | None
diff --git a/gso/products/product_blocks/router.py b/gso/products/product_blocks/router.py
index 5ffc2ef98cb1a10f22e27b9d52d61e941fb2715a..d31d2109aae8b2bc95c876777faa53c46c668d83 100644
--- a/gso/products/product_blocks/router.py
+++ b/gso/products/product_blocks/router.py
@@ -1,4 +1,4 @@
-"""Product block for ``Router`` products."""
+"""Product block for `Router` products."""
from orchestrator.domain.base import ProductBlockModel
from orchestrator.types import SubscriptionLifecycle, strEnum
@@ -25,7 +25,7 @@ class RouterBlockInactive(
lifecycle=[SubscriptionLifecycle.INITIAL],
product_block_name="RouterBlock",
):
- """A router that's being currently inactive. See ``RouterBlock``."""
+ """A router that's being currently inactive. See `RouterBlock`."""
router_fqdn: str | None = None
router_ts_port: PortNumber | None = None
@@ -39,7 +39,7 @@ class RouterBlockInactive(
class RouterBlockProvisioning(RouterBlockInactive, lifecycle=[SubscriptionLifecycle.PROVISIONING]):
- """A router that's being provisioned. See ``RouterBlock``."""
+ """A router that's being provisioned. See `RouterBlock`."""
router_fqdn: str
router_ts_port: PortNumber
@@ -53,23 +53,28 @@ class RouterBlockProvisioning(RouterBlockInactive, lifecycle=[SubscriptionLifecy
class RouterBlock(RouterBlockProvisioning, lifecycle=[SubscriptionLifecycle.ACTIVE]):
- """A router that's currently deployed in the network."""
+ """A router that's currently deployed in the network.
+
+ Attributes:
+ router_fqdn: FQDN of a router.
+ router_ts_port: The port of the terminal server that this router is connected to. Used to offer out of band
+ access.
+ router_access_via_ts: Whether this router should be accessed through the terminal server, or through its
+ loopback address.
+ router_lo_ipv4_address: The IPv4 loopback address of the router.
+ router_lo_ipv6_address: The IPv6 loopback address of the router.
+ router_lo_iso_address: The ISO NET of the router, used for ISIS support.
+ router_role: The role of the router, which can be any of the values defined in `RouterRole`.
+ router_site: The site that this router resides in. Both physically and computationally.
+ vendor: The vendor of a router.
+ """
- #: FQDN of a router.
router_fqdn: str
- #: The port of the terminal server that this router is connected to. Used to offer out of band access.
router_ts_port: PortNumber
- #: Whether this router should be accessed through the terminal server, or through its loopback address.
router_access_via_ts: bool
- #: The IPv4 loopback address of the router.
router_lo_ipv4_address: IPv4AddressType
- #: The IPv6 loopback address of the router.
router_lo_ipv6_address: IPv6AddressType
- #: The ISO NET of the router, used for ISIS support.
router_lo_iso_address: str
- #: The role of the router, which can be any of the values defined in ``RouterRole``.
router_role: RouterRole
- #: The ``Site`` that this router resides in. Both physically and computationally.
router_site: SiteBlock
- #: The vendor of a router.
vendor: Vendor
diff --git a/gso/products/product_blocks/service_binding_port.py b/gso/products/product_blocks/service_binding_port.py
index 33c8872069d69b0dfd7c8eb534bfe8c99996fb0c..5eaec9af013f851496d3c473a81cac5331013511 100644
--- a/gso/products/product_blocks/service_binding_port.py
+++ b/gso/products/product_blocks/service_binding_port.py
@@ -21,7 +21,7 @@ from gso.utils.types.virtual_identifiers import VLAN_ID
class BFDSettingsInactive(
ProductBlockModel, lifecycle=[SubscriptionLifecycle.INITIAL], product_block_name="BFDSettings"
):
- """Settings for BFD, see ``BFDSettings``."""
+ """Settings for BFD, see `BFDSettings`."""
bfd_enabled: bool = False
bfd_interval_rx: int | None = None
@@ -30,7 +30,7 @@ class BFDSettingsInactive(
class BFDSettingsProvisioning(BFDSettingsInactive, lifecycle=[SubscriptionLifecycle.PROVISIONING]):
- """Settings for BFD, see ``BFDSettings``."""
+ """Settings for BFD, see `BFDSettings`."""
bfd_enabled: bool
bfd_interval_rx: int | None = None
@@ -47,6 +47,7 @@ class BFDSettings(BFDSettingsProvisioning, lifecycle=[SubscriptionLifecycle.ACTI
bfd_interval_tx: The BFD interval TX, if enabled.
bfd_multiplier: The BFD multiplier, if enabled.
"""
+
bfd_enabled: bool
bfd_interval_rx: int | None
bfd_interval_tx: int | None
@@ -56,7 +57,7 @@ class BFDSettings(BFDSettingsProvisioning, lifecycle=[SubscriptionLifecycle.ACTI
class ServiceBindingPortInactive(
ProductBlockModel, lifecycle=[SubscriptionLifecycle.INITIAL], product_block_name="ServiceBindingPort"
):
- """A Service Binding Port that's currently inactive. See ``ServiceBindingPort``."""
+ """A Service Binding Port that's currently inactive. See `ServiceBindingPort`."""
is_tagged: bool | None = None
vlan_id: VLAN_ID | None = None
@@ -74,7 +75,7 @@ class ServiceBindingPortInactive(
class ServiceBindingPortProvisioning(ServiceBindingPortInactive, lifecycle=[SubscriptionLifecycle.PROVISIONING]):
- """A Service Binding Port that's currently being provisioned. See ``ServiceBindingPort``."""
+ """A Service Binding Port that's currently being provisioned. See `ServiceBindingPort`."""
is_tagged: bool
vlan_id: VLAN_ID | None = None
@@ -92,31 +93,34 @@ class ServiceBindingPortProvisioning(ServiceBindingPortInactive, lifecycle=[Subs
class ServiceBindingPort(ServiceBindingPortProvisioning, lifecycle=[SubscriptionLifecycle.ACTIVE]):
- """A service binding port that is actively used in the network."""
+ """A service binding port that is actively used in the network.
+
+ Attributes:
+ is_tagged: Whether this VLAN is tagged or not.
+ vlan_id: The VLAN ID.
+ sbp_type: Is this service binding port layer 2 or 3?
+ ipv4_address: If layer 3, IPv4 resources.
+ ipv4_mask: IPv4 subnet mask.
+ ipv6_address: If layer 3, IPv6 resources.
+ ipv6_mask: IPv6 subnet mask.
+ custom_firewall_filters: Any custom firewall filters that the partner may require.
+ gs_id: The GÉANT service ID of this binding port.
+ bgp_session_list: The BGP sessions associated with this service binding port.
+ edge_port: The Edge Port on which this SBP resides.
+ v4_bfd_settings: BFD settings for IPv4.
+ v6_bfd_settings: BFD settings for IPv6.
+ """
- #: Whether this VLAN is tagged or not.
is_tagged: bool
- #: The VLAN ID.
vlan_id: VLAN_ID | None = None
- #: Is this service binding port layer 2 or 3?
sbp_type: SBPType
- #: If layer 3, IPv4 resources.
ipv4_address: IPv4AddressType | None = None
- #: IPV4 subnet mask.
ipv4_mask: IPv4Netmask | None = None
- #: If layer 3, IPv6 resources.
ipv6_address: IPv6AddressType | None = None
- #: IPV6 subnet mask.
ipv6_mask: IPv6Netmask | None = None
- #: Any custom firewall filters that the partner may require.
custom_firewall_filters: bool
- #: The GÉANT service ID of this binding port.
gs_id: str
- #: The BGP sessions associated with this service binding port.
bgp_session_list: list[BGPSession] # type: ignore[assignment]
- #: The Edge Port on which this SBP resides.
edge_port: EdgePortBlock
- #: BFD settings for IPv4
v4_bfd_settings: BFDSettings
- #: BFD settings for IPv6
v6_bfd_settings: BFDSettings
diff --git a/gso/products/product_blocks/site.py b/gso/products/product_blocks/site.py
index 871707b4dc806b8a534fb003edd28e34946b79bc..4d5e479c1b41d9f307282a8e018bcbae1a93c3ed 100644
--- a/gso/products/product_blocks/site.py
+++ b/gso/products/product_blocks/site.py
@@ -26,7 +26,7 @@ class SiteBlockInactive(
lifecycle=[SubscriptionLifecycle.INITIAL],
product_block_name="SiteBlock",
):
- """A site that's currently inactive, see ``SiteBlock``."""
+ """A site that's currently inactive, see `SiteBlock`."""
site_name: SiteName | None = None
site_city: str | None = None
@@ -42,7 +42,7 @@ class SiteBlockInactive(
class SiteBlockProvisioning(SiteBlockInactive, lifecycle=[SubscriptionLifecycle.PROVISIONING]):
- """A site that's currently being provisioned, see ``SiteBlock``."""
+ """A site that's currently being provisioned, see `SiteBlock`."""
site_name: SiteName
site_city: str
@@ -61,7 +61,7 @@ class SiteBlock(SiteBlockProvisioning, lifecycle=[SubscriptionLifecycle.ACTIVE])
"""A site that's currently available for routers and services to be hosted at."""
#: The name of the site, that will dictate part of the FQDN of routers that are hosted at this site. For
- #: example: ``router.X.Y.geant.net``, where X denotes the name of the site.
+ #: example: `router.X.Y.geant.net`, where X denotes the name of the site.
site_name: SiteName
#: The city at which the site is located.
site_city: str
@@ -78,7 +78,7 @@ class SiteBlock(SiteBlockProvisioning, lifecycle=[SubscriptionLifecycle.ACTIVE])
site_internal_id: int
#: The BGP community ID of a site, used to advertise routes learned at this site.
site_bgp_community_id: int
- #: The tier of a site, as described in ``SiteTier``.
+ #: The tier of a site, as described in `SiteTier`.
site_tier: SiteTier
#: The address of the terminal server that this router is connected to. The terminal server provides out of band
#: access. This is required in case a link goes down, or when a router is initially added to the network and it
diff --git a/gso/products/product_blocks/super_pop_switch.py b/gso/products/product_blocks/super_pop_switch.py
index 63f161921a030a8787d881ac4a02b2032b9c342a..7c0b1c4a5ed358136d9e73168a7293753d7a1ddd 100644
--- a/gso/products/product_blocks/super_pop_switch.py
+++ b/gso/products/product_blocks/super_pop_switch.py
@@ -17,7 +17,7 @@ class SuperPopSwitchBlockInactive(
lifecycle=[SubscriptionLifecycle.INITIAL],
product_block_name="SuperPopSwitchBlock",
):
- """A Super PoP switch that's being currently inactive. See ``SuperPoPSwitchBlock``."""
+ """A Super PoP switch that's being currently inactive. See `SuperPoPSwitchBlock`."""
super_pop_switch_fqdn: str | None = None
super_pop_switch_ts_port: PortNumber | None = None
@@ -27,7 +27,7 @@ class SuperPopSwitchBlockInactive(
class SuperPopSwitchBlockProvisioning(SuperPopSwitchBlockInactive, lifecycle=[SubscriptionLifecycle.PROVISIONING]):
- """A Super PoP switch that's being provisioned. See ``SuperPoPSwitchBlock``."""
+ """A Super PoP switch that's being provisioned. See `SuperPoPSwitchBlock`."""
super_pop_switch_fqdn: str | None = None
super_pop_switch_ts_port: PortNumber | None = None
@@ -45,7 +45,7 @@ class SuperPopSwitchBlock(SuperPopSwitchBlockProvisioning, lifecycle=[Subscripti
super_pop_switch_ts_port: PortNumber
#: The IPv4 management address of the Super PoP switch.
super_pop_switch_mgmt_ipv4_address: IPv4AddressType
- #: The ``Site`` that this Super PoP switch resides in. Both physically and computationally.
+ #: The `Site` that this Super PoP switch resides in. Both physically and computationally.
super_pop_switch_site: SiteBlock
#: The vendor of a Super PoP switch. Defaults to Juniper.
vendor: Vendor = Vendor.JUNIPER
diff --git a/gso/products/product_blocks/switch.py b/gso/products/product_blocks/switch.py
index abf4a797dc83d83ae77a5237e5f713736aa25897..918773269954e9850c314fea88ff8efb2fa1b452 100644
--- a/gso/products/product_blocks/switch.py
+++ b/gso/products/product_blocks/switch.py
@@ -1,4 +1,4 @@
-"""Product block for ``Switch`` products."""
+"""Product block for `Switch` products."""
from orchestrator.domain.base import ProductBlockModel
from orchestrator.types import SubscriptionLifecycle
@@ -26,7 +26,7 @@ class SwitchBlockInactive(
lifecycle=[SubscriptionLifecycle.INITIAL],
product_block_name="SwitchBlock",
):
- """A switch that's being currently inactive. See ``SwitchBlock``."""
+ """A switch that's being currently inactive. See `SwitchBlock`."""
fqdn: str | None = None
ts_port: PortNumber | None = None
@@ -36,7 +36,7 @@ class SwitchBlockInactive(
class SwitchBlockProvisioning(SwitchBlockInactive, lifecycle=[SubscriptionLifecycle.PROVISIONING]):
- """A switch that's being provisioned. See ``SwitchBlock``."""
+ """A switch that's being provisioned. See `SwitchBlock`."""
fqdn: str
ts_port: PortNumber
@@ -46,15 +46,18 @@ class SwitchBlockProvisioning(SwitchBlockInactive, lifecycle=[SubscriptionLifecy
class SwitchBlock(SwitchBlockProvisioning, lifecycle=[SubscriptionLifecycle.ACTIVE]):
- """A switch that's currently deployed in the network."""
+ """A switch that's currently deployed in the network.
+
+ Attributes:
+ fqdn: The FQDN of the switch.
+ ts_port: The port of the terminal server that this switch is connected to. Used to offer out of band access.
+ site: The site that this switch resides in. Both physically and computationally.
+ switch_vendor: The vendor of the switch.
+ switch_model: The model of the switch.
+ """
- #: The FQDN of the switch.
fqdn: str
- #: The port of the terminal server that this switch is connected to. Used to offer out of band access.
ts_port: PortNumber
- #: The ``Site`` that this switch resides in. Both physically and computationally.
site: SiteBlock
- #: The vendor of the switch.
switch_vendor: Vendor
- #: The model of the switch.
switch_model: SwitchModel
diff --git a/gso/products/product_blocks/vrf.py b/gso/products/product_blocks/vrf.py
index 5070c48a2f0e5f35e0db64c8d4e47f8447aac19d..d53803af4960e07c006f80e65f4411c8767639c7 100644
--- a/gso/products/product_blocks/vrf.py
+++ b/gso/products/product_blocks/vrf.py
@@ -1,4 +1,4 @@
-"""Product blocks for :term:`VRF` Virtual Routing and Forwarding."""
+"""Product blocks for VRF Virtual Routing and Forwarding."""
from orchestrator.domain.base import ProductBlockModel
from orchestrator.types import SubscriptionLifecycle
@@ -7,7 +7,7 @@ from gso.products.product_blocks.router import RouterBlock, RouterBlockInactive,
class VRFBlockInactive(ProductBlockModel, lifecycle=[SubscriptionLifecycle.INITIAL], product_block_name="VRFBlock"):
- """An inactive :term:`VRF` subscription. See :class:`VRFBlock`."""
+ """An inactive VRF subscription. See `VRFBlock`."""
vrf_router_list: list[RouterBlockInactive]
vrf_name: str | None = None
@@ -17,7 +17,7 @@ class VRFBlockInactive(ProductBlockModel, lifecycle=[SubscriptionLifecycle.INITI
class VRFBlockProvisioning(VRFBlockInactive, lifecycle=[SubscriptionLifecycle.PROVISIONING]):
- """A provisioning :term:`VRF` subscription. See :class:`VRFBlock`."""
+ """A provisioning VRF subscription. See `VRFBlock`."""
vrf_router_list: list[RouterBlockProvisioning] # type: ignore[assignment]
vrf_name: str
@@ -27,15 +27,18 @@ class VRFBlockProvisioning(VRFBlockInactive, lifecycle=[SubscriptionLifecycle.PR
class VRFBlock(VRFBlockProvisioning, lifecycle=[SubscriptionLifecycle.ACTIVE]):
- """Represents an active :term:`VRF` subscription block."""
+ """Represents an active VRF subscription block.
+
+ Attributes:
+ vrf_router_list: List of VRF routers.
+ vrf_name: Unique name identifying this VRF.
+ route_distinguisher: Route Distinguisher ensuring unique route identification within this VRF.
+ route_target: Route Target defining routing policies for importing/exporting routes.
+ vrf_as_number: AS number of the VRF.
+ """
- #: List of VRF routers
vrf_router_list: list[RouterBlock] # type: ignore[assignment]
- #: Unique name identifying this VRF.
vrf_name: str
- #: Route Distinguisher (RD) ensuring unique route identification within this VRF.
route_distinguisher: str
- #: Route Target (RT) defining routing policies for importing/exporting routes.
route_target: str
- #: AS number of the VRF
vrf_as_number: int | None = None
diff --git a/gso/products/product_types/vrf.py b/gso/products/product_types/vrf.py
index 348d6b922aed7d4be9936bd3749b9b7be280ee6d..653e461a3cbd7a23b93645ed5c9f7f6206e4fbc2 100644
--- a/gso/products/product_types/vrf.py
+++ b/gso/products/product_types/vrf.py
@@ -1,4 +1,4 @@
-"""A :term:`VRF` product type."""
+"""A VRF product type."""
from orchestrator.domain.base import SubscriptionModel
from orchestrator.types import SubscriptionLifecycle
@@ -7,18 +7,18 @@ from gso.products.product_blocks.vrf import VRFBlock, VRFBlockInactive, VRFBlock
class VRFInactive(SubscriptionModel, is_base=True):
- """An inactive :term:`VRF`."""
+ """An inactive VRF."""
vrf: VRFBlockInactive
class VRFProvisioning(VRFInactive, lifecycle=[SubscriptionLifecycle.PROVISIONING]):
- """A provisioning :term:`VRF`."""
+ """A provisioning VRF."""
vrf: VRFBlockProvisioning
class VRF(VRFProvisioning, lifecycle=[SubscriptionLifecycle.ACTIVE]):
- """A :term:`VRF` that is currently active."""
+ """A VRF that is currently active."""
vrf: VRFBlock
diff --git a/gso/schedules/scheduling.py b/gso/schedules/scheduling.py
index 508af69ec81c7c53cbfd9abe09724b8eb154d837..1f99f582ffb7f80ad1f0d497a89fe4fa85f281fa 100644
--- a/gso/schedules/scheduling.py
+++ b/gso/schedules/scheduling.py
@@ -25,11 +25,11 @@ def scheduler(cron_scheduler_config: CronScheduleConfig) -> Callable[[Callable],
"""Schedule a Celery task using crontab-like timing.
Examples:
- - ``minute='*/15'``: Run every 15 minutes.
- - ``hour='*/3'``: Run every 3 hours.
- - ``day_of_week='mon-fri'``: Run on weekdays only.
- - ``day_of_month='1-7,15-21'``: Run on the first and third weeks of the month.
- - ``month_of_year='*/3'``: Run on the first month of each quarter.
+ - `minute='*/15'`: Run every 15 minutes.
+ - `hour='*/3'`: Run every 3 hours.
+ - `day_of_week='mon-fri'`: Run on weekdays only.
+ - `day_of_month='1-7,15-21'`: Run on the first and third weeks of the month.
+ - `month_of_year='*/3'`: Run on the first month of each quarter.
All time units can be specified with lists of numbers or crontab pattern strings for advanced scheduling.
All specified time parts (minute, hour, day, etc.) must align for a task to run.
diff --git a/gso/services/kentik_client.py b/gso/services/kentik_client.py
index cb9c30932c271489974d5facf795e09e362352e0..3e524ccb95f4c5e2e294817d1f915a62ef66b895 100644
--- a/gso/services/kentik_client.py
+++ b/gso/services/kentik_client.py
@@ -62,7 +62,7 @@ class KentikClient:
"""List all devices in Kentik.
Returns:
- a list of shape ``[{**device_1}, {**device_2}, ..., {**device_n}]}``.
+ a list of shape `[{**device_1}, {**device_2}, ..., {**device_n}]}`.
"""
return self._send_request("GET", "v5/devices")["devices"]
@@ -117,7 +117,7 @@ class KentikClient:
"""Get all Kentik plans available.
Returns:
- a list of ``plans`` that each have the following shape:
+ a list of `plans` that each have the following shape:
.. vale off
.. code-block:: json
diff --git a/gso/services/lso_client.py b/gso/services/lso_client.py
index 6f5d8599822c7bf1a94b5274db55ab09e102ac92..2557986095b9b4ef1391cdc97459d65a82fd077d 100644
--- a/gso/services/lso_client.py
+++ b/gso/services/lso_client.py
@@ -93,7 +93,7 @@ def _execute_playbook(
.. warning::
Note the fact that the collection of all hosts is a dictionary, and not a list of strings. Ansible expects each
- host to be a key-value pair. The key is the FQDN of a host, and the value always ``null``.
+ host to be a key-value pair. The key is the FQDN of a host, and the value always `null`.
The extra vars can be a simple dict consisting of key-value pairs, for example:
@@ -196,7 +196,7 @@ def lso_interaction(provisioning_step: Step) -> StepList:
to provision service subscriptions. If the playbook fails, this step will also fail, allowing for the user to retry
provisioning from the UI.
- Optionally, the keys ``lso_result_title`` and ``lso_result_extra_label`` can be added to the state before running
+ Optionally, the keys `lso_result_title` and `lso_result_extra_label` can be added to the state before running
this interaction. They will be used to customise the input step that shows the outcome of the LSO
interaction.
@@ -224,8 +224,8 @@ def lso_interaction(provisioning_step: Step) -> StepList:
def indifferent_lso_interaction(provisioning_step: Step) -> StepList:
"""Interact with the provisioning proxy LSO using a callback step.
- This interaction is identical from the one described in ``lso_interaction()``, with one functional difference.
- Whereas the ``lso_interaction()`` will make the workflow step fail on unsuccessful interaction, this step will not.
+ This interaction is identical from the one described in `lso_interaction()`, with one functional difference.
+ Whereas the `lso_interaction()` will make the workflow step fail on unsuccessful interaction, this step will not.
It is therefore indifferent about the outcome of the Ansible playbook that is executed.
.. warning::
@@ -258,7 +258,7 @@ def anonymous_lso_interaction(provisioning_step: Step, validation_step: Step = _
Similar to the indifferent LSO interaction, there also is the anonymous interaction. Output is not ignored
but no input step is created to display the results.
- A custom validation step may be given as input. This validation step should look inside the ``callback_result`` key
+ A custom validation step may be given as input. This validation step should look inside the `callback_result` key
in the current state. By default, only the return code of the playbook execution is evaluated.
Args:
diff --git a/gso/services/subscriptions.py b/gso/services/subscriptions.py
index 83d88751984a66a5eed4522b55077734ceda303f..c42b4a71fa2c0af63e0307ba791e2cba5db32dde 100644
--- a/gso/services/subscriptions.py
+++ b/gso/services/subscriptions.py
@@ -45,7 +45,7 @@ def get_subscriptions(
partner_id: The customer id of subscriptions.
Returns:
- A list of ``SubscriptionType`` objects that match the query.
+ A list of `SubscriptionType` objects that match the query.
"""
if not includes:
includes = [col.name for col in SubscriptionTable.__table__.columns]
@@ -161,9 +161,9 @@ def get_non_terminated_iptrunk_subscriptions(includes: list[str] | None = None)
def get_trunks_that_terminate_on_router(
subscription_id: UUIDstr, lifecycle_state: SubscriptionLifecycle
) -> list[SubscriptionTable]:
- """Get all IP trunk subscriptions that terminate on the given ``subscription_id`` of a Router.
+ """Get all IP trunk subscriptions that terminate on the given `subscription_id` of a Router.
- Given a ``subscription_id`` of a Router subscription, this method gives a list of all IP trunk subscriptions that
+ Given a `subscription_id` of a Router subscription, this method gives a list of all IP trunk subscriptions that
terminate on this Router. The given lifecycle state dictates the state of trunk subscriptions that are counted as
terminating on this router.
diff --git a/gso/utils/helpers.py b/gso/utils/helpers.py
index aca141073931b72c3c2831a7fefbd68160f7564d..20d66cab639db87252278ad1cc70310740c65812 100644
--- a/gso/utils/helpers.py
+++ b/gso/utils/helpers.py
@@ -74,7 +74,7 @@ def available_lags_choices(router_id: UUID) -> Choice | None:
"""Return a list of available lags for a given router.
For Nokia routers, return a list of available lags.
- For Juniper routers, return ``None``.
+ For Juniper routers, return `None`.
"""
if get_router_vendor(router_id) != Vendor.NOKIA:
return None
@@ -86,7 +86,7 @@ def available_service_lags_choices(router_id: UUID) -> Choice | None:
"""Return a list of available lags for a given router for services.
For Nokia routers, return a list of available lags.
- For Juniper routers, return ``None``.
+ For Juniper routers, return `None`.
"""
if get_router_vendor(router_id) != Vendor.NOKIA:
return None
@@ -164,7 +164,7 @@ def generate_inventory_for_routers(
router_role: The role of the routers to include in the inventory.
exclude_routers: List of routers to exclude from the inventory.
router_vendor: The vendor of the routers to include in the inventory.
- include_provisioning_routers: Include routers that are in a ``PROVISIONING`` state.
+ include_provisioning_routers: Include routers that are in a `PROVISIONING` state.
Returns:
A dictionary representing the inventory of active routers.
@@ -262,7 +262,7 @@ def active_edge_port_selector(*, partner_id: UUIDstr | None = None) -> Choice:
)
if partner_id:
- # ``partner_id`` is set, so we will filter accordingly.
+ # `partner_id` is set, so we will filter accordingly.
edge_port_subscriptions = list(
filter(lambda subscription: bool(subscription["customer_id"] == partner_id), edge_port_subscriptions)
)
diff --git a/gso/utils/types/interfaces.py b/gso/utils/types/interfaces.py
index f76cd8de373ac4eb916d67d3370193de0210db51..16f69f3aebcd75be9db7cbf9dde59114c6d86fce 100644
--- a/gso/utils/types/interfaces.py
+++ b/gso/utils/types/interfaces.py
@@ -25,7 +25,7 @@ class LAGMember(BaseModel):
def validate_interface_names_are_unique(interfaces: list[LAGMember]) -> list[LAGMember]:
"""Verify if interfaces are unique.
- Raises a ``ValueError`` if the interfaces are not unique.
+ Raises a `ValueError` if the interfaces are not unique.
Args:
interfaces: The list of interfaces.
diff --git a/gso/workflows/vrf/__init__.py b/gso/workflows/vrf/__init__.py
index 0fc8180f6bd9547693b518647a82b21fe636b1db..68a1b462970d258956f93a8b45e4823528928136 100644
--- a/gso/workflows/vrf/__init__.py
+++ b/gso/workflows/vrf/__init__.py
@@ -1 +1 @@
-""":term:`VRF` Virtual Routing and Forwarding."""
+"""VRF Virtual Routing and Forwarding."""
diff --git a/gso/workflows/vrf/create_vrf.py b/gso/workflows/vrf/create_vrf.py
index 9ca01d1e81b3f9babd27a024b827c26df41ba2cb..8da4f2d91a9584090a3d2b1fd5b53489a1dc1438 100644
--- a/gso/workflows/vrf/create_vrf.py
+++ b/gso/workflows/vrf/create_vrf.py
@@ -1,4 +1,4 @@
-"""A creation workflow for adding a new virtual routing and forwarding (:term:`VRF`) service."""
+"""A creation workflow for adding a new virtual routing and forwarding (VRF) service."""
from orchestrator.forms import FormPage
from orchestrator.targets import Target
@@ -39,7 +39,7 @@ def initial_input_form_generator(product_name: str) -> FormGenerator:
@step("Create subscription")
def create_subscription(product: UUIDstr, partner: str) -> State:
- """Create a new :term:`VRF` subscription."""
+ """Create a new VRF subscription."""
subscription = VRFInactive.from_product_id(product, get_partner_by_name(partner)["partner_id"])
return {
@@ -72,7 +72,7 @@ def initialize_subscription(
target=Target.CREATE,
)
def create_vrf() -> StepList:
- """Create a virtual routing and forwarding (:term:`VRF`) service."""
+ """Create a virtual routing and forwarding (VRF) service."""
return (
begin
>> create_subscription
diff --git a/gso/workflows/vrf/modify_vrf_router_list.py b/gso/workflows/vrf/modify_vrf_router_list.py
index b0618d95237be5ff3455953033edea3377fa0346..d198d8f9738d6e9ea9d0160c9af74a4e94676018 100644
--- a/gso/workflows/vrf/modify_vrf_router_list.py
+++ b/gso/workflows/vrf/modify_vrf_router_list.py
@@ -1,4 +1,4 @@
-"""Modify :term:`VRF` to add or remove routers."""
+"""Modify VRF to add or remove routers."""
from typing import Annotated
@@ -17,7 +17,7 @@ from gso.utils.helpers import active_router_selector
def initial_input_form_generator(subscription_id: UUIDstr) -> FormGenerator:
- """Modify :term:`VRF` to add or remove routers."""
+ """Modify VRF to add or remove routers."""
subscription = VRF.from_subscription(subscription_id)
class RouterSelection(BaseModel):
@@ -57,5 +57,5 @@ def update_subscription_model(subscription: VRF, router_list: list[dict[str, UUI
target=Target.MODIFY,
)
def modify_vrf_router_list() -> StepList:
- """Modify the :term:`VRF` router list."""
+ """Modify the VRF router list."""
return begin >> store_process_subscription(Target.MODIFY) >> unsync >> update_subscription_model >> resync >> done