pyixapi 0.2.6__tar.gz → 0.2.8__tar.gz

{pyixapi-0.2.6 → pyixapi-0.2.8}/PKG-INFO

@@ -1,23 +1,20 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: pyixapi
-Version: 0.2.6
+Version: 0.2.8
 Summary: Python API client library for IX-API
-License: Apache-2.0
 Author: Guillaume Mazoyer
-Author-email: oss@mazoyer.eu
-Requires-Python: >=3.9
+Author-email: Guillaume Mazoyer <oss@mazoyer.eu>
+License-Expression: Apache-2.0
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Provides-Extra: dev
-Requires-Dist: PyJWT (>=2.4.0,<2.11)
-Requires-Dist: pytest ; extra == "dev"
-Requires-Dist: requests (>=2.20.0,<3.0)
-Requires-Dist: ruff (>=0.9,<0.10) ; extra == "dev"
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: pyjwt>=2.4.0,<2.13
+Requires-Dist: requests>=2.32.4,<3.0
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 
 # pyixapi
@@ -26,7 +23,7 @@ Python API client library for [IX-API](https://ix-api.net/).
 
 Supported versions are:
 
-* [version 1](https://docs.ix-api.net/v1/)
+* [version 1](https://docs.ix-api.net/v1/) -- deprecated, providers cease date is 2026-07-01
 * [version 2](https://docs.ix-api.net/v2/)
 
 ## Installation
@@ -40,7 +37,7 @@ To begin, import pyixapi and instantiate the API.
 ```python
 import pyixapi
 ixapi = pyixapi.api(
-    "https://api.de-cix.net/api/v1/",
+    "https://api.de-cix.net/api/v2/",
     "3LH3G72VH7H1SGogEsFeQOPsGjOQotMUZQRt2pK7YbH",
     "cEtrt8s0vR0CsG0vpAmcaxtnolzZj7DEG0B7izvwPlV",
 )
@@ -78,4 +75,3 @@ DXDB:PAS:00008
 ```
 
 Write queries are not implemented yet.
-

{pyixapi-0.2.6 → pyixapi-0.2.8}/README.md

@@ -4,7 +4,7 @@ Python API client library for [IX-API](https://ix-api.net/).
 
 Supported versions are:
 
-* [version 1](https://docs.ix-api.net/v1/)
+* [version 1](https://docs.ix-api.net/v1/) -- deprecated, providers cease date is 2026-07-01
 * [version 2](https://docs.ix-api.net/v2/)
 
 ## Installation
@@ -18,7 +18,7 @@ To begin, import pyixapi and instantiate the API.
 ```python
 import pyixapi
 ixapi = pyixapi.api(
-    "https://api.de-cix.net/api/v1/",
+    "https://api.de-cix.net/api/v2/",
     "3LH3G72VH7H1SGogEsFeQOPsGjOQotMUZQRt2pK7YbH",
     "cEtrt8s0vR0CsG0vpAmcaxtnolzZj7DEG0B7izvwPlV",
 )

{pyixapi-0.2.6 → pyixapi-0.2.8}/pyixapi/core/api.py

@@ -1,3 +1,6 @@
+import warnings
+from typing import Any
+
 import requests
 
 from pyixapi.core.endpoint import Endpoint
@@ -29,7 +32,7 @@ from pyixapi.models import (
     RoleAssignment,
 )
 
-__version__ = "0.2.6"
+__version__ = "0.2.8"
 
 
 class API(object):
@@ -42,14 +45,14 @@ class API(object):
 
     def __init__(
         self,
-        url,
-        key,
-        secret,
-        access_token="",
-        refresh_token="",
-        user_agent=f"pyixapi/{__version__}",
-        proxies=None,
-    ):
+        url: str,
+        key: str,
+        secret: str,
+        access_token: str = "",
+        refresh_token: str = "",
+        user_agent: str = f"pyixapi/{__version__}",
+        proxies: dict[str, str] | None = None,
+    ) -> None:
         self.url = url.rstrip("/")
         self.key = key
         self.secret = secret
@@ -67,36 +70,26 @@ class API(object):
         self.facilities = Endpoint(self, "facilities", model=Facility)
         self.ips = Endpoint(self, "ips", model=IP)
         self.macs = Endpoint(self, "macs", model=MAC)
-        self.network_feature_configs = Endpoint(
-            self, "network-feature-configs", model=NetworkFeatureConfig
-        )
+        self.network_feature_configs = Endpoint(self, "network-feature-configs", model=NetworkFeatureConfig)
         self.network_features = Endpoint(self, "network-features", model=NetworkFeature)
-        self.network_service_configs = Endpoint(
-            self, "network-service-configs", model=NetworkServiceConfig
-        )
+        self.network_service_configs = Endpoint(self, "network-service-configs", model=NetworkServiceConfig)
         self.network_services = Endpoint(self, "network-services", model=NetworkService)
         self.pops = Endpoint(self, "pops", model=PoP)
         # Version 2+
-        self.member_joining_rules = Endpoint(
-            self, "member-joining-rules", model=MemberJoiningRule
-        )
+        self.member_joining_rules = Endpoint(self, "member-joining-rules", model=MemberJoiningRule)
         self.metro_areas = Endpoint(self, "metro-areas", model=MetroArea)
-        self.metro_area_networks = Endpoint(
-            self, "metro-area-networks", model=MetroAreaNetwork
-        )
+        self.metro_area_networks = Endpoint(self, "metro-area-networks", model=MetroAreaNetwork)
         self.ports = Endpoint(self, "ports", model=Port)
-        self.port_reservations = Endpoint(
-            self, "port-reservations", model=PortReservation
-        )
+        self.port_reservations = Endpoint(self, "port-reservations", model=PortReservation)
         self.roles = Endpoint(self, "roles", model=Role)
         self.role_assignments = Endpoint(self, "role-assignments", model=RoleAssignment)
 
     @property
-    def version(self):
+    def version(self) -> int:
         """
         Get the API version of IX-API.
         """
-        return Request(
+        version = Request(
             base=self.url,
             token=self.access_token,
             http_session=self.http_session,
@@ -104,21 +97,28 @@ class API(object):
             proxies=self.proxies,
         ).get_version()
 
+        if version == 1:
+            warnings.warn(
+                "IX-API version 1 is deprecated and will not be supported in future releases of pyixapi.",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+
+        return version
+
     @property
-    def accounts(self):
-        return Endpoint(
-            self, "customers" if self.version == 1 else "accounts", model=Account
-        )
+    def accounts(self) -> Endpoint:
+        return Endpoint(self, "customers" if self.version == 1 else "accounts", model=Account)
 
     @property
-    def product_offerings(self):
+    def product_offerings(self) -> Endpoint:
         return Endpoint(
             self,
             "products" if self.version == 1 else "product-offerings",
             model=ProductOffering,
         )
 
-    def authenticate(self):
+    def authenticate(self) -> Record | None:
         """
         Authenticate and generate a pair of tokens.
 
@@ -148,13 +148,16 @@ class API(object):
 
         return Record(r, self, self.auth)
 
-    def refresh_authentication(self):
+    def refresh_authentication(self) -> Record:
         """
         Prolong authentication by refreshing the tokens pair.
         """
+        if not self.refresh_token:
+            raise ValueError("No refresh token available to refresh authentication")
+
         r = Request(
             cat(self.url, "auth", "refresh"),
-            token=self.refresh_token.encoded,
+            token=self.refresh_token,
             http_session=self.http_session,
             user_agent=self.user_agent,
             proxies=self.proxies,
@@ -165,7 +168,7 @@ class API(object):
 
         return Record(r, self, self.auth)
 
-    def health(self):
+    def health(self) -> dict[str, Any]:
         """
         Get the health information from IX-API.
 

{pyixapi-0.2.6 → pyixapi-0.2.8}/pyixapi/core/endpoint.py

@@ -1,7 +1,14 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
 from pyixapi.core.query import Request, RequestError
 from pyixapi.core.response import Record, RecordSet
 from pyixapi.core.util import cat
 
+if TYPE_CHECKING:
+    from pyixapi.core.api import API
+
 
 class Endpoint(object):
     """
@@ -11,16 +18,16 @@ class Endpoint(object):
     object.
     """
 
-    def __init__(self, api, name, model=None):
-        self.return_obj = model if model else Record
+    def __init__(self, api: API, name: str, model: type[Record] | None = None) -> None:
+        self.return_obj: type[Record] = model if model else Record
         self.api = api
         self.url = cat(api.url, name)
         self.name = name
 
-    def __str__(self):
+    def __str__(self) -> str:
         return self.url
 
-    def all(self):
+    def all(self) -> RecordSet:
         """
         Return all objects from an endpoint.
         """
@@ -33,7 +40,7 @@ class Endpoint(object):
         )
         return RecordSet(self, r)
 
-    def filter(self, *args, **kwargs):
+    def filter(self, *args: Any, **kwargs: Any) -> RecordSet:
         """
         Query the list of a given endpoint. Also take named arguments that match the
         usable filters on a given endpoint.
@@ -48,7 +55,7 @@ class Endpoint(object):
         )
         return RecordSet(self, r)
 
-    def get(self, *args, **kwargs):
+    def get(self, *args: Any, **kwargs: Any) -> Record | None:
         """
         Return a single object from an endpoint.
         """
@@ -89,7 +96,7 @@ class Endpoint(object):
             else:
                 raise e
 
-    def create(self, *args, **kwargs):
+    def create(self, *args: Any, **kwargs: Any) -> Record:
         """
         Creates an object on an endpoint.
 

{pyixapi-0.2.6 → pyixapi-0.2.8}/pyixapi/core/query.py

@@ -1,5 +1,9 @@
 import json
+from typing import Any, Generator
 
+import requests
+
+from pyixapi.core.token import Token
 from pyixapi.core.util import cat
 
 
@@ -10,7 +14,7 @@ class RequestError(Exception):
     return is JSON we decode and add it to the message.
     """
 
-    def __init__(self, r):
+    def __init__(self, r: requests.Response) -> None:
         if r.status_code == 404:
             self.message = f"The requested url: {r.url} could not be found."
         elif r.status_code == 401:
@@ -27,7 +31,7 @@ class RequestError(Exception):
         self.req = r
         self.error = r.text
 
-    def __str__(self):
+    def __str__(self) -> str:
         return self.message
 
 
@@ -38,13 +42,13 @@ class ContentError(Exception):
     those cases.
     """
 
-    def __init__(self, req):
+    def __init__(self, req: requests.Response) -> None:
         super(ContentError, self).__init__(req)
 
         self.req = req
         self.error = "The server returned invalid (non-JSON) data. Maybe not an IX-API server?"
 
-    def __str__(self):
+    def __str__(self) -> str:
         return self.error
 
 
@@ -63,14 +67,14 @@ class Request(object):
 
     def __init__(
         self,
-        base,
-        http_session,
-        filters=None,
-        key=None,
-        token=None,
-        user_agent=None,
-        proxies=None,
-    ):
+        base: str,
+        http_session: requests.Session,
+        filters: dict[str, Any] | None = None,
+        key: str | None = None,
+        token: Token | None = None,
+        user_agent: str | None = None,
+        proxies: dict[str, str] | None = None,
+    ) -> None:
         self.base = base
         self.filters = filters or None
         self.key = key
@@ -80,7 +84,7 @@ class Request(object):
         self.user_agent = user_agent
         self.proxies = proxies
 
-    def get_openapi(self):
+    def get_openapi(self) -> dict[str, Any]:
         """
         Get the OpenAPI Spec.
         """
@@ -91,13 +95,13 @@ class Request(object):
         else:
             raise RequestError(req)
 
-    def get_version(self):
+    def get_version(self) -> int:
         """
         Get the API version of IX-API.
 
         Issue a GET request to the health endpoint to read the API version.
 
-        If a RequestError is raised, it is catched and the version is considered as
+        If a RequestError is raised, it is caught and the version is considered as
         equal to 1 (IX-API v1 does not have a health endpoint).
         """
         try:
@@ -105,32 +109,38 @@ class Request(object):
         except RequestError:
             return 1
 
-    def get_health(self):
+    def get_health(self) -> dict[str, Any]:
         """
         Get the health from /api/health endpoint in IX-API.
         """
-        headers = {"Content-Type": "application/json;"}
+        headers: dict[str, str] = {"Content-Type": "application/json;"}
         if self.token:
-            headers["Authorization"] = f"Bearer {self.token}"
+            headers["Authorization"] = f"Bearer {self.token.encoded}"
         r = self.http_session.get(cat(self.base, "health"), headers=headers)
         if r.ok:
             return r.json()
         else:
             raise RequestError(r)
 
-    def _make_call(self, verb="get", url_override=None, add_params=None, data=None):
+    def _make_call(
+        self,
+        verb: str = "get",
+        url_override: str | None = None,
+        add_params: dict[str, Any] | None = None,
+        data: dict[str, Any] | None = None,
+    ) -> Any:
         if verb in ("post", "put") or verb == "delete" and data:
-            headers = {"Content-Type": "application/json;"}
+            headers: dict[str, str] = {"Content-Type": "application/json;"}
         else:
             headers = {"accept": "application/json;"}
 
         if self.token:
-            headers["Authorization"] = f"Bearer {self.token}"
+            headers["Authorization"] = f"Bearer {self.token.encoded}"
 
         if self.user_agent:
             headers["User-Agent"] = self.user_agent
 
-        params = {}
+        params: dict[str, Any] = {}
         if not url_override:
             if self.filters:
                 params.update(self.filters)
@@ -158,7 +168,7 @@ class Request(object):
         else:
             raise RequestError(r)
 
-    def get(self, add_params=None):
+    def get(self, add_params: dict[str, Any] | None = None) -> Generator[dict[str, Any], None, None]:
         """
         Make a GET request to IX-API.
 
@@ -177,7 +187,7 @@ class Request(object):
             self.count = len(req)
             yield req
 
-    def put(self, data):
+    def put(self, data: dict[str, Any]) -> dict[str, Any]:
         """
         Make a PUT request to IX-API.
 
@@ -189,7 +199,7 @@ class Request(object):
         """
         return self._make_call(verb="put", data=data)
 
-    def post(self, data):
+    def post(self, data: dict[str, Any]) -> dict[str, Any]:
         """
         Make a POST request to IX-API.
 
@@ -201,7 +211,7 @@ class Request(object):
         """
         return self._make_call(verb="post", data=data)
 
-    def delete(self, data=None):
+    def delete(self, data: dict[str, Any] | None = None) -> bool:
         """
         Make a DELETE request to IX-API.
 
@@ -215,7 +225,7 @@ class Request(object):
         """
         return self._make_call(verb="delete", data=data)
 
-    def patch(self, data):
+    def patch(self, data: dict[str, Any]) -> dict[str, Any]:
         """
         Make a PATCH request to IX-API.
 
@@ -227,7 +237,7 @@ class Request(object):
         """
         return self._make_call(verb="patch", data=data)
 
-    def options(self):
+    def options(self) -> dict[str, Any]:
         """
         Make an OPTIONS request to IX-API.
 

{pyixapi-0.2.6 → pyixapi-0.2.8}/pyixapi/core/response.py

@@ -1,8 +1,16 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Iterator
+
 from pyixapi.core.query import Request
 from pyixapi.core.util import Hashabledict
 
+if TYPE_CHECKING:
+    from pyixapi.core.api import API
+    from pyixapi.core.endpoint import Endpoint
+
 
-def get_return(lookup):
+def get_return(lookup: Any) -> Any:
     """
     Return simple representations for items passed to lookup.
 
@@ -52,21 +60,21 @@ class RecordSet(object):
     >>>
     """
 
-    def __init__(self, endpoint, request, **kwargs):
+    def __init__(self, endpoint: Endpoint, request: Request, **kwargs: Any) -> None:
         self.endpoint = endpoint
         self.request = request
         self.response = self.request.get()
-        self._response_cache = []
+        self._response_cache: list[dict[str, Any]] = []
 
-    def __iter__(self):
+    def __iter__(self) -> Iterator[Record]:
         return self
 
-    def __next__(self):
+    def __next__(self) -> Record:
         if self._response_cache:
             return self.endpoint.return_obj(self._response_cache.pop(), self.endpoint.api, self.endpoint)
         return self.endpoint.return_obj(next(self.response), self.endpoint.api, self.endpoint)
 
-    def __len__(self):
+    def __len__(self) -> int:
         try:
             return self.request.count
         except AttributeError:
@@ -138,18 +146,18 @@ class Record(object):
     >>>
     """
 
-    url = None
+    url: str | None = None
 
-    def __init__(self, values, api, endpoint):
-        self._full_cache = []
-        self._init_cache = []
+    def __init__(self, values: dict[str, Any], api: API, endpoint: Endpoint) -> None:
+        self._full_cache: list[Any] = []
+        self._init_cache: list[tuple[str, Any]] = []
         self.api = api
-        self.default_ret = Record
+        self.default_ret: type[Record] = Record
         self.endpoint = endpoint
         if values:
             self._parse_values(values)
 
-    def __iter__(self):
+    def __iter__(self) -> Iterator[tuple[str, Any]]:
         for i in dict(self._init_cache):
             a = getattr(self, i)
             if isinstance(a, Record):
@@ -159,48 +167,48 @@ class Record(object):
             else:
                 yield i, a
 
-    def __getitem__(self, k):
+    def __getitem__(self, k: str) -> Any:
         return dict(self)[k]
 
-    def __str__(self):
+    def __str__(self) -> str:
         if hasattr(self, "id"):
             return self.id
         else:
             return str(self.endpoint)
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return str(dict(self))
 
-    def __getstate__(self):
+    def __getstate__(self) -> dict[str, Any]:
         return self.__dict__
 
-    def __setstate__(self, d):
+    def __setstate__(self, d: dict[str, Any]) -> None:
         self.__dict__.update(d)
 
-    def __key__(self):
+    def __key__(self) -> tuple[str, ...] | tuple[str]:
         if hasattr(self, "id"):
             return (self.endpoint.name, self.id)
         else:
-            return self.endpoint.name
+            return (self.endpoint.name,)
 
-    def __hash__(self):
+    def __hash__(self) -> int:
         return hash(self.__key__())
 
-    def __eq__(self, other):
+    def __eq__(self, other: object) -> bool:
         if isinstance(other, Record):
             return self.__key__() == other.__key__()
         return NotImplemented
 
-    def _add_cache(self, item):
+    def _add_cache(self, item: tuple[str, Any]) -> None:
         key, value = item
         self._init_cache.append((key, get_return(value)))
 
-    def _parse_values(self, values):
+    def _parse_values(self, values: dict[str, Any]) -> None:
         """
         Parse values dict at init and sets object attributes with the values within.
         """
 
-        def list_parser(key_name, list_item):
+        def list_parser(key_name: str, list_item: Any) -> Any:
             if isinstance(list_item, dict):
                 lookup = getattr(self.__class__, key_name, None)
                 if not isinstance(lookup, list):
@@ -226,7 +234,7 @@ class Record(object):
                 self._add_cache((k, v))
             setattr(self, k, v)
 
-    def serialize(self, nested=False, init=False):
+    def serialize(self, nested: bool = False, init: bool = False) -> Any:
         """
         Pull all the attributes in an object and create a dict that can be turned into
         the JSON that IX-API is expecting.
@@ -240,7 +248,7 @@ class Record(object):
         if init:
             init_vals = dict(self._init_cache)
 
-        r = {}
+        r: dict[str, Any] = {}
         for i in dict(self):
             current_val = getattr(self, i) if not init else init_vals.get(i)
             if isinstance(current_val, Record):
@@ -250,8 +258,8 @@ class Record(object):
             r[i] = current_val
         return r
 
-    def _diff(self):
-        def fmt_dict(k, v):
+    def _diff(self) -> set[str]:
+        def fmt_dict(k: str, v: Any) -> tuple[str, Any]:
             if isinstance(v, dict):
                 return k, Hashabledict(v)
             if isinstance(v, list):
@@ -262,7 +270,7 @@ class Record(object):
         init = Hashabledict({fmt_dict(k, v) for k, v in self.serialize(init=True).items()})
         return set([i[0] for i in set(current.items()) ^ set(init.items())])
 
-    def updates(self):
+    def updates(self) -> dict[str, Any]:
         """
         Compile changes for an existing object into a dict.
 
@@ -276,7 +284,7 @@ class Record(object):
                 return {i: serialized[i] for i in diff}
         return {}
 
-    def save(self):
+    def save(self) -> bool:
         """
         Save changes to an existing object.
 
@@ -297,7 +305,7 @@ class Record(object):
                 return True
         return False
 
-    def update(self, data):
+    def update(self, data: dict[str, Any]) -> bool:
         """
         Update an object with a dictionary.
 
@@ -309,7 +317,7 @@ class Record(object):
             setattr(self, k, v)
         return self.save()
 
-    def delete(self):
+    def delete(self) -> bool:
         """
         Delete an existing object.
         """

{pyixapi-0.2.6 → pyixapi-0.2.8}/pyixapi/core/token.py

@@ -49,7 +49,7 @@ class Token:
         TTL is the number of seconds, from now, before the token expires.
         """
         seconds = (self.expires_at - datetime.now(timezone.utc)).total_seconds()
-        return max(0, seconds)
+        return max(0, int(seconds))
 
     @property
     def is_expired(self) -> bool:

{pyixapi-0.2.6 → pyixapi-0.2.8}/pyixapi/core/util.py

@@ -1,8 +1,8 @@
 from typing import Any
 
 
-class Hashabledict(dict):
-    def __hash__(self):
+class Hashabledict(dict):  # type: ignore[type-arg]
+    def __hash__(self) -> int:
         return hash(frozenset(self))
 
 

{pyixapi-0.2.6 → pyixapi-0.2.8}/pyixapi/models.py

@@ -12,7 +12,7 @@ class Account(Record):
     It is also referenced as "customer" in IX-API v1.
     """
 
-    def __str__(self):
+    def __str__(self) -> str:
         return f"{self.id}: {self.name}"
 
 
@@ -21,7 +21,7 @@ class Connection(Record):
     A Connection is a group of physical ports collected together into a LAG.
     """
 
-    def __str__(self):
+    def __str__(self) -> str:
         return f"{self.id}: {self.name}"
 
 
@@ -30,7 +30,7 @@ class Contact(Record):
     A Contact is a role undertaking a specific responsibility within an account.
     """
 
-    def __str__(self):
+    def __str__(self) -> str:
         r = []
 
         legal_company_name = getattr(self, "legal_company_name", None)
@@ -51,7 +51,7 @@ class Demarc(Record):
     eg a physical port / socket, generally with a specified bandwidth.
     """
 
-    def __str__(self):
+    def __str__(self) -> str:
         return self.id
 
 
@@ -61,7 +61,7 @@ class Device(Record):
     specified facility and inside a PoP.
     """
 
-    def __str__(self):
+    def __str__(self) -> str:
         return self.name
 
 
@@ -71,7 +71,7 @@ class Facility(Record):
     defined set of PoPs can be accessed.
     """
 
-    def __str__(self):
+    def __str__(self) -> str:
         return self.name
 
 
@@ -81,18 +81,18 @@ class IP(Record):
     """
 
     @property
-    def cidr(self):
+    def cidr(self) -> ipaddress.IPv4Interface | ipaddress.IPv6Interface:
         return ipaddress.ip_interface(f"{self.address}/{self.prefix_length}")
 
     @property
-    def ip(self):
+    def ip(self) -> ipaddress.IPv4Address | ipaddress.IPv6Address:
         return self.cidr.ip
 
     @property
-    def network(self):
+    def network(self) -> ipaddress.IPv4Network | ipaddress.IPv6Network:
         return self.cidr.network
 
-    def __str__(self):
+    def __str__(self) -> str:
         return str(self.cidr)
 
 
@@ -101,7 +101,7 @@ class MAC(Record):
     A MAC is a MAC address with a given validity period.
     """
 
-    def __str__(self):
+    def __str__(self) -> str:
         return self.address.lower()
 
 
@@ -110,7 +110,7 @@ class NetworkFeatureConfig(Record):
     A NetworkFeatureConfig is a customer's configuration to use a NetworkFeature.
     """
 
-    def __str__(self):
+    def __str__(self) -> str:
         return self.id
 
 
@@ -120,7 +120,7 @@ class NetworkFeature(Record):
     NetworkService.
     """
 
-    def __str__(self):
+    def __str__(self) -> str:
         return self.id
 
 
@@ -130,7 +130,7 @@ class NetworkServiceConfig(Record):
     the configuration of a (subset of a) connection for that customer's traffic.
     """
 
-    def __str__(self):
+    def __str__(self) -> str:
         return self.id
 
 
@@ -140,7 +140,7 @@ class NetworkService(Record):
     depending on the type of product.
     """
 
-    def __str__(self):
+    def __str__(self) -> str:
         return self.id
 
 
@@ -150,7 +150,7 @@ class PoP(Record):
     infrastructure and has defined reachability of other facilities.
     """
 
-    def __str__(self):
+    def __str__(self) -> str:
         return self.name
 
 
@@ -161,7 +161,7 @@ class ProductOffering(Record):
     It is also referenced as "product" in IX-API v1.
     """
 
-    def __str__(self):
+    def __str__(self) -> str:
         return self.name
 
 
@@ -177,7 +177,7 @@ class MemberJoiningRule(Record):
     listed in an allow rule.
     """
 
-    def __str__(self):
+    def __str__(self) -> str:
         return self.id
 
 
@@ -186,7 +186,7 @@ class MetroArea(Record):
     A MetroArea exists if a MetroAreaNetwork or Facility is present in it.
     """
 
-    def __str__(self):
+    def __str__(self) -> str:
         return self.display_name
 
 
@@ -199,7 +199,7 @@ class MetroAreaNetwork(Record):
     list of IDs.
     """
 
-    def __str__(self):
+    def __str__(self) -> str:
         return self.name
 
 
@@ -209,7 +209,7 @@ class Port(Record):
     associated with a device and pop, has a speed and a media_type.
     """
 
-    def __str__(self):
+    def __str__(self) -> str:
         return self.name
 
 
@@ -223,7 +223,7 @@ class PortReservation(Record):
     Please note that individual cancellation policies might apply.
     """
 
-    def __str__(self):
+    def __str__(self) -> str:
         return self.id
 
 
@@ -232,7 +232,7 @@ class Role(Record):
     A Role enables a Contact to act for a specific purpose.
     """
 
-    def __str__(self):
+    def __str__(self) -> str:
         return self.name
 
 
@@ -241,5 +241,5 @@ class RoleAssignment(Record):
     A Contact can be assigned to many Roles.
     """
 
-    def __str__(self):
+    def __str__(self) -> str:
         return self.id

{pyixapi-0.2.6 → pyixapi-0.2.8}/pyproject.toml

@@ -1,24 +1,24 @@
 [project]
 name = "pyixapi"
-version = "0.2.6"
+version = "0.2.8"
 description = "Python API client library for IX-API"
 authors = [{ name = "Guillaume Mazoyer", email = "oss@mazoyer.eu" }]
 readme = "README.md"
 license = "Apache-2.0"
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 classifiers = [
     "Intended Audience :: Developers",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
 ]
-dependencies = ["PyJWT>=2.4.0,<2.11", "requests>=2.20.0,<3.0"]
+dependencies = ["PyJWT>=2.4.0,<2.13", "requests>=2.32.4,<3.0"]
 
-[project.optional-dependencies]
-dev = ["pytest", "ruff>=0.9,<0.10"]
+[dependency-groups]
+dev = ["pytest", "pytest-cov", "ruff", "ty"]
 
 [tool.poetry]
 requires-poetry = ">=2.0"
@@ -57,6 +57,24 @@ known-first-party = ["pyixapi"]
 [tool.ruff.lint.mccabe]
 max-complexity = 31
 
+[tool.ty.rules]
+unresolved-attribute = "ignore"
+invalid-return-type = "ignore"
+unresolved-import = "ignore"
+
+[tool.pytest.ini_options]
+addopts = "--cov=pyixapi --cov-report=term-missing --cov-report=xml"
+
+[tool.coverage.run]
+source = ["pyixapi"]
+omit = ["pyixapi/__main__.py"]
+
+[tool.coverage.report]
+exclude_lines = ["if TYPE_CHECKING:"]
+
 [build-system]
-requires = ["poetry-core>=2.0"]
-build-backend = "poetry.core.masonry.api"
+requires = ["uv_build>=0.9.21,<0.10.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-root = "."

pyixapi-0.2.6/LICENSE

@@ -1,178 +0,0 @@
-
-                             Apache License
-                       Version 2.0, January 2004
-                    http://www.apache.org/licenses/
-
-TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-1. Definitions.
-
-  "License" shall mean the terms and conditions for use, reproduction,
-  and distribution as defined by Sections 1 through 9 of this document.
-
-  "Licensor" shall mean the copyright owner or entity authorized by
-  the copyright owner that is granting the License.
-
-  "Legal Entity" shall mean the union of the acting entity and all
-  other entities that control, are controlled by, or are under common
-  control with that entity. For the purposes of this definition,
-  "control" means (i) the power, direct or indirect, to cause the
-  direction or management of such entity, whether by contract or
-  otherwise, or (ii) ownership of fifty percent (50%) or more of the
-  outstanding shares, or (iii) beneficial ownership of such entity.
-
-  "You" (or "Your") shall mean an individual or Legal Entity
-  exercising permissions granted by this License.
-
-  "Source" form shall mean the preferred form for making modifications,
-  including but not limited to software source code, documentation
-  source, and configuration files.
-
-  "Object" form shall mean any form resulting from mechanical
-  transformation or translation of a Source form, including but
-  not limited to compiled object code, generated documentation,
-  and conversions to other media types.
-
-  "Work" shall mean the work of authorship, whether in Source or
-  Object form, made available under the License, as indicated by a
-  copyright notice that is included in or attached to the work
-  (an example is provided in the Appendix below).
-
-  "Derivative Works" shall mean any work, whether in Source or Object
-  form, that is based on (or derived from) the Work and for which the
-  editorial revisions, annotations, elaborations, or other modifications
-  represent, as a whole, an original work of authorship. For the purposes
-  of this License, Derivative Works shall not include works that remain
-  separable from, or merely link (or bind by name) to the interfaces of,
-  the Work and Derivative Works thereof.
-
-  "Contribution" shall mean any work of authorship, including
-  the original version of the Work and any modifications or additions
-  to that Work or Derivative Works thereof, that is intentionally
-  submitted to Licensor for inclusion in the Work by the copyright owner
-  or by an individual or Legal Entity authorized to submit on behalf of
-  the copyright owner. For the purposes of this definition, "submitted"
-  means any form of electronic, verbal, or written communication sent
-  to the Licensor or its representatives, including but not limited to
-  communication on electronic mailing lists, source code control systems,
-  and issue tracking systems that are managed by, or on behalf of, the
-  Licensor for the purpose of discussing and improving the Work, but
-  excluding communication that is conspicuously marked or otherwise
-  designated in writing by the copyright owner as "Not a Contribution."
-
-  "Contributor" shall mean Licensor and any individual or Legal Entity
-  on behalf of whom a Contribution has been received by Licensor and
-  subsequently incorporated within the Work.
-
-2. Grant of Copyright License. Subject to the terms and conditions of
-  this License, each Contributor hereby grants to You a perpetual,
-  worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-  copyright license to reproduce, prepare Derivative Works of,
-  publicly display, publicly perform, sublicense, and distribute the
-  Work and such Derivative Works in Source or Object form.
-
-3. Grant of Patent License. Subject to the terms and conditions of
-  this License, each Contributor hereby grants to You a perpetual,
-  worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-  (except as stated in this section) patent license to make, have made,
-  use, offer to sell, sell, import, and otherwise transfer the Work,
-  where such license applies only to those patent claims licensable
-  by such Contributor that are necessarily infringed by their
-  Contribution(s) alone or by combination of their Contribution(s)
-  with the Work to which such Contribution(s) was submitted. If You
-  institute patent litigation against any entity (including a
-  cross-claim or counterclaim in a lawsuit) alleging that the Work
-  or a Contribution incorporated within the Work constitutes direct
-  or contributory patent infringement, then any patent licenses
-  granted to You under this License for that Work shall terminate
-  as of the date such litigation is filed.
-
-4. Redistribution. You may reproduce and distribute copies of the
-  Work or Derivative Works thereof in any medium, with or without
-  modifications, and in Source or Object form, provided that You
-  meet the following conditions:
-
-  (a) You must give any other recipients of the Work or
-      Derivative Works a copy of this License; and
-
-  (b) You must cause any modified files to carry prominent notices
-      stating that You changed the files; and
-
-  (c) You must retain, in the Source form of any Derivative Works
-      that You distribute, all copyright, patent, trademark, and
-      attribution notices from the Source form of the Work,
-      excluding those notices that do not pertain to any part of
-      the Derivative Works; and
-
-  (d) If the Work includes a "NOTICE" text file as part of its
-      distribution, then any Derivative Works that You distribute must
-      include a readable copy of the attribution notices contained
-      within such NOTICE file, excluding those notices that do not
-      pertain to any part of the Derivative Works, in at least one
-      of the following places: within a NOTICE text file distributed
-      as part of the Derivative Works; within the Source form or
-      documentation, if provided along with the Derivative Works; or,
-      within a display generated by the Derivative Works, if and
-      wherever such third-party notices normally appear. The contents
-      of the NOTICE file are for informational purposes only and
-      do not modify the License. You may add Your own attribution
-      notices within Derivative Works that You distribute, alongside
-      or as an addendum to the NOTICE text from the Work, provided
-      that such additional attribution notices cannot be construed
-      as modifying the License.
-
-  You may add Your own copyright statement to Your modifications and
-  may provide additional or different license terms and conditions
-  for use, reproduction, or distribution of Your modifications, or
-  for any such Derivative Works as a whole, provided Your use,
-  reproduction, and distribution of the Work otherwise complies with
-  the conditions stated in this License.
-
-5. Submission of Contributions. Unless You explicitly state otherwise,
-  any Contribution intentionally submitted for inclusion in the Work
-  by You to the Licensor shall be under the terms and conditions of
-  this License, without any additional terms or conditions.
-  Notwithstanding the above, nothing herein shall supersede or modify
-  the terms of any separate license agreement you may have executed
-  with Licensor regarding such Contributions.
-
-6. Trademarks. This License does not grant permission to use the trade
-  names, trademarks, service marks, or product names of the Licensor,
-  except as required for reasonable and customary use in describing the
-  origin of the Work and reproducing the content of the NOTICE file.
-
-7. Disclaimer of Warranty. Unless required by applicable law or
-  agreed to in writing, Licensor provides the Work (and each
-  Contributor provides its Contributions) on an "AS IS" BASIS,
-  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-  implied, including, without limitation, any warranties or conditions
-  of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-  PARTICULAR PURPOSE. You are solely responsible for determining the
-  appropriateness of using or redistributing the Work and assume any
-  risks associated with Your exercise of permissions under this License.
-
-8. Limitation of Liability. In no event and under no legal theory,
-  whether in tort (including negligence), contract, or otherwise,
-  unless required by applicable law (such as deliberate and grossly
-  negligent acts) or agreed to in writing, shall any Contributor be
-  liable to You for damages, including any direct, indirect, special,
-  incidental, or consequential damages of any character arising as a
-  result of this License or out of the use or inability to use the
-  Work (including but not limited to damages for loss of goodwill,
-  work stoppage, computer failure or malfunction, or any and all
-  other commercial damages or losses), even if such Contributor
-  has been advised of the possibility of such damages.
-
-9. Accepting Warranty or Additional Liability. While redistributing
-  the Work or Derivative Works thereof, You may choose to offer,
-  and charge a fee for, acceptance of support, warranty, indemnity,
-  or other liability obligations and/or rights consistent with this
-  License. However, in accepting such obligations, You may act only
-  on Your own behalf and on Your sole responsibility, not on behalf
-  of any other Contributor, and only if You agree to indemnify,
-  defend, and hold each Contributor harmless for any liability
-  incurred by, or claims asserted against, such Contributor by reason
-  of your accepting any such warranty or additional liability.
-
-END OF TERMS AND CONDITIONS
-Copyright 2017 DigitalOcean