python3-core-api-client 0.1__py3-none-any.whl → 0.2__py3-none-any.whl

cyberfusion/CoreApiClient/connector.py

@@ -1,6 +1,5 @@
 import json
 from typing import Optional, Tuple
-from urllib.parse import urlparse
 
 from cyberfusion.CoreApiClient._encoders import DatetimeEncoder
 from cyberfusion.CoreApiClient.exceptions import CallException, AuthenticationException
@@ -17,7 +16,7 @@ import importlib.metadata
 from cyberfusion.CoreApiClient.http import Response
 
 
-class CoreApiConnector:
+class CoreApiClient:
     def __init__(
         self,
         base_url: str = "https://core-api.cyberfusion.io",
@@ -50,10 +49,6 @@ class CoreApiConnector:
 
         self.requests_session = requests_session or self.get_default_requests_session()
 
-    @property
-    def root_url(self) -> str:
-        return urlparse(self.base_url)._replace(path="").geturl()
-
     @property
     def authentication_headers(self) -> Dict[str, str]:
         headers = {}
@@ -73,7 +68,7 @@ class CoreApiConnector:
 
             if login:
                 response = self.requests_session.post(
-                    "".join([self.root_url, "/api/v1/login/access-token"]),
+                    "".join([self.base_url, "/api/v1/login/access-token"]),
                     data={"username": self.username, "password": self.password},
                     verify=certifi.where(),
                     timeout=60,
@@ -181,6 +176,8 @@ class CoreApiConnector:
 
         return session
 
+
+class CoreApiConnector(CoreApiClient):
     @cached_property
     def login(self) -> resources.login.Login:
         return resources.login.Login(self)

{python3_core_api_client-0.1.dist-info → python3_core_api_client-0.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python3-core-api-client
-Version: 0.1
+Version: 0.2
 Summary: Python client for Core API.
 Author-email: Cyberfusion <support@cyberfusion.io>
 Project-URL: Source, https://github.com/CyberfusionIO/python3-core-api-client
@@ -52,7 +52,7 @@ Refer to the [API documentation](https://core-api.cyberfusion.io/) for informati
 
 Initialise the `CoreApiConnector` with your username and password **or** API key.
 
-The connector takes care of authentication, and offers several resources (such as `virtual_hosts`) and endpoints (i.e. `list_virtual_hosts`).
+The connector takes care of authentication, and offers several resources (e.g. `virtual_hosts`) and endpoints (e.g. `list_virtual_hosts`).
 
 ```python
 from cyberfusion.CoreApiClient.connector import CoreApiConnector
@@ -78,7 +78,7 @@ This client takes care of authentication.
 
 If authentication using username and password fails, `cyberfusion.CoreApiClient.exceptions.AuthenticationException` is thrown.
 
-If authentication using API key fails, the regular `CallException` exception fis raised.
+If authentication using API key fails, the regular `CallException` exception is raised.
 
 Don't have an API user? Contact Cyberfusion.
 
@@ -86,8 +86,6 @@ Don't have an API user? Contact Cyberfusion.
 
 The client uses a fluent interface to build requests.
 
-To view all possible requests:
-
 - Start with the connector
 - Go to the desired resource
 - Call the desired endpoint
@@ -115,7 +113,7 @@ connector.mail_domains.create_mail_domain(
 
 Models are validated before sending the request (using [Pydantic](https://docs.pydantic.dev/latest/)). If invalid data is provided, `pydantic.ValidationError` is thrown.
 
-For example:
+Code example:
 
 ```python
 from cyberfusion.CoreApiClient.connector import CoreApiConnector
@@ -135,15 +133,44 @@ connector.mail_aliases.create_mail_alias(
 # throw pydantic.ValidationError
 ```
 
-The exception will provide more details about the validation errors.
+The exception has an `errors()` method to get all validation errors.
+
+Code example:
+
+```python
+from cyberfusion.CoreApiClient.connector import CoreApiConnector
+
+from cyberfusion.CoreApiClient.models import MailAliasCreateRequest
+
+import pydantic
+
+connector = CoreApiConnector(
+    username='username', password='password'
+)
+
+try:
+    connector.mail_aliases.create_mail_alias(
+        MailAliasCreateRequest(
+            local_part='&^@$#^&@$#^&',
+            mail_domain_id=1,
+        )
+    )
+except pydantic.ValidationError as e:
+    errors = e.errors()
+
+for error in errors:
+    print(error['loc'])
+    print(error['msg'])
+    print(error['type'])
+```
 
 ## Responses
 
 ### Get model from response
 
-Calling a n endpoint returns the resource model.
+Calling an endpoint returns the resource model.
 
-For example:
+Code example:
 
 ```python
 from cyberfusion.CoreApiClient.connector import CoreApiConnector
@@ -169,6 +196,8 @@ mail_domain_resource = connector.mail_domains.create_mail_domain(
 
 If a request returns an unexpected HTTP status code, `cyberfusion.CoreApiClient.exceptions.CallException` is thrown.
 
+The exception includes the response, and the HTTP status code.
+
 ## Enums
 
 Some properties only accept certain values (enums).
@@ -191,7 +220,7 @@ connector = CoreApiConnector(
 )
 ```
 
-Don't pass a custom session? A default one is created, including retries.
+Don't pass a custom session? A default one is created, with retries enabled.
 
 ### Manual requests
 
@@ -215,7 +244,7 @@ response.headers
 response.failed
 ```
 
-To raise `cyberfusion.CoreApiClient.exceptions.CallException` in case of an unexpected HTTP status code, use `send_or_fail`.
+To raise `cyberfusion.CoreApiClient.exceptions.CallException` in case of an unexpected HTTP status code, use `send_or_fail` instead of `send`. It takes the same parameters.
 
 ### Generating models
 

{python3_core_api_client-0.1.dist-info → python3_core_api_client-0.2.dist-info}/RECORD

@@ -1,6 +1,6 @@
 cyberfusion/CoreApiClient/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 cyberfusion/CoreApiClient/_encoders.py,sha256=wyYUK_82h_hOPRvdxIzYta7Ek1TSSYMORR1QF1XfcRA,186
-cyberfusion/CoreApiClient/connector.py,sha256=uOUHYxJOnWlyrucneHGWeaPgdcDK6cHzuqK4Wqgau80,12813
+cyberfusion/CoreApiClient/connector.py,sha256=ifnlovR-HiMfGXwIAoibFutXPV_iDWN-oGanu4GkhW4,12704
 cyberfusion/CoreApiClient/exceptions.py,sha256=fNxPtzVL4SzPiVNZmBTu1l8D57dkCxMxflyIXDPLE4Q,204
 cyberfusion/CoreApiClient/http.py,sha256=z6ZyfQyUnA3QDCmej2BEIw9BOlTYoCE8zvTZ0-u_VoQ,429
 cyberfusion/CoreApiClient/interfaces.py,sha256=P0wCbmSNEpB-eF49PHudc_qXM4blIXm4TsD2AB0z_7Q,269
@@ -53,7 +53,7 @@ cyberfusion/CoreApiClient/resources/tombstones.py,sha256=AH7G23dD_I-qqmr98AmzsFD
 cyberfusion/CoreApiClient/resources/unix_users.py,sha256=moqa5CjNSzueccMGms9mNhtUSDFw1UapWlB8QM6Agjk,3636
 cyberfusion/CoreApiClient/resources/url_redirects.py,sha256=1Y386s9Bge8gBaXucSUBi1npNPPQpMLLVGXqVxA2YFM,2368
 cyberfusion/CoreApiClient/resources/virtual_hosts.py,sha256=SAo6QPQGO-IJJCwW71zEEdA5FGdAn-6ADdn1iuA03wg,3716
-python3_core_api_client-0.1.dist-info/METADATA,sha256=H4bMR1aXuOD6OBz2Vj6fHwzFsmyGtvuGYIBNdrAoEGg,6357
-python3_core_api_client-0.1.dist-info/WHEEL,sha256=SmOxYU7pzNKBqASvQJ7DjX3XGUF92lrGhMb3R6_iiqI,91
-python3_core_api_client-0.1.dist-info/top_level.txt,sha256=ss011q9S6SL_KIIyq7iujFmIYa0grSjlnInO7cDkeag,12
-python3_core_api_client-0.1.dist-info/RECORD,,
+python3_core_api_client-0.2.dist-info/METADATA,sha256=GiVOnEZmhURfOt4VbSlncbahgqS_u0XMrgEwGrgViJs,7022
+python3_core_api_client-0.2.dist-info/WHEEL,sha256=ck4Vq1_RXyvS4Jt6SI0Vz6fyVs4GWg7AINwpsaGEgPE,91
+python3_core_api_client-0.2.dist-info/top_level.txt,sha256=ss011q9S6SL_KIIyq7iujFmIYa0grSjlnInO7cDkeag,12
+python3_core_api_client-0.2.dist-info/RECORD,,

{python3_core_api_client-0.1.dist-info → python3_core_api_client-0.2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (79.0.1)
+Generator: setuptools (80.0.0)
 Root-Is-Purelib: true
 Tag: py3-none-any