anaplan-sdk 0.4.0a2__py3-none-any.whl → 0.4.1__py3-none-any.whl

anaplan_sdk/_async_clients/_bulk.py

@@ -56,6 +56,7 @@ class AsyncClient(_AsyncBaseClient):
         redirect_uri: str | None = None,
         refresh_token: str | None = None,
         oauth2_scope: str = "openid profile email offline_access",
+        on_auth_code: Callable[[str], str] | None = None,
         on_token_refresh: Callable[[dict[str, str]], None] | None = None,
         timeout: float | httpx.Timeout = 30,
         retry_count: int = 2,
@@ -91,6 +92,9 @@ class AsyncClient(_AsyncBaseClient):
         :param refresh_token: If you have a valid refresh token, you can pass it to skip the
                               interactive authentication code step.
         :param oauth2_scope: The scope of the Oauth2 token, if you want to narrow it.
+        :param on_auth_code: A callback that takes the redirect URI as a single argument and must
+                             return the entire response URI. This will substitute the interactive
+                             authentication code step in the terminal.
         :param on_token_refresh: A callback function that is called whenever the token is refreshed.
                                  With this you can for example securely store the token in your
                                  application or on your server for later reuse. The function
@@ -124,6 +128,7 @@ class AsyncClient(_AsyncBaseClient):
                     redirect_uri=redirect_uri,
                     refresh_token=refresh_token,
                     oauth2_scope=oauth2_scope,
+                    on_auth_code=on_auth_code,
                     on_token_refresh=on_token_refresh,
                 )
             ),

anaplan_sdk/_async_clients/_transactional.py

@@ -92,7 +92,15 @@ class _AsyncTransactionalClient(_AsyncBaseClient):
         """
         Insert new items to the given list. The items must be a list of dictionaries with at least
         the keys `code` and `name`. You can optionally pass further keys for parents, extra
-        properties etc.
+        properties etc. If you pass a long list, it will be split into chunks of 100,000 items, the
+        maximum allowed by the API.
+
+        **Warning**: If one or some of the requests timeout during large batch operations, the
+        operation may actually complete on the server. Retries for these chunks will then report
+        these items as "ignored" rather than "added", leading to misleading results. The results in
+        Anaplan will be correct, but this function may report otherwise. Be generous with your
+        timeouts and retries if you are using this function for large batch operations.
+
         :param list_id: The ID of the List.
         :param items: The items to insert into the List.
         :return: The result of the insertion, indicating how many items were added,
@@ -123,7 +131,16 @@ class _AsyncTransactionalClient(_AsyncBaseClient):
 
     async def delete_list_items(self, list_id: int, items: list[dict[str, str | int]]) -> int:
         """
-        Deletes items from a List.
+        Deletes items from a List. If you pass a long list, it will be split into chunks of 100,000
+        items, the maximum allowed by the API.
+
+        **Warning**: If one or some of the requests timeout during large batch operations, the
+        operation may actually complete on the server. Retries for these chunks will then report
+        none of these items as deleted, since on the retry none are removed, leading to misleading
+        results. The results in Anaplan will be correct, but this function may report otherwise.
+        Be generous with your timeouts and retries if you are using this function for large batch
+        operations.
+
         :param list_id: The ID of the List.
         :param items: The items to delete from the List. Must be a dict with either `code` or `id`
                       as the keys to identify the records to delete.
@@ -158,8 +175,13 @@ class _AsyncTransactionalClient(_AsyncBaseClient):
         """
         Write the passed items to the specified module. If successful, the number of cells changed
         is returned, if only partially successful or unsuccessful, the response with the according
-        details is returned instead. For more details,
-        see: https://anaplan.docs.apiary.io/#UpdateModuleCellData.
+        details is returned instead.
+
+        **You can update a maximum of 100,000 cells or 15 MB of data (whichever is lower) in a
+        single request.** You must chunk your data accordingly. This is not done by this SDK,
+        since it is discouraged. For larger imports, you should use the Bulk API instead.
+
+        For more details see: https://anaplan.docs.apiary.io/#UpdateModuleCellData.
         :param module_id: The ID of the Module.
         :param data: The data to write to the Module.
         :return: The number of cells changed or the response with the according error details.

anaplan_sdk/_auth.py

@@ -144,6 +144,7 @@ class AnaplanOauth2AuthCodeAuth(_AnaplanAuth):
         redirect_uri: str,
         refresh_token: str | None = None,
         scope: str = "openid profile email offline_access",
+        on_auth_code: Callable[[str], str] | None = None,
         on_token_refresh: Callable[[dict[str, str]], None] | None = None,
     ):
         try:
@@ -163,6 +164,7 @@ class AnaplanOauth2AuthCodeAuth(_AnaplanAuth):
         self._refresh_token = refresh_token
         self._scope = scope
         self._id_token = None
+        self._on_auth_code = on_auth_code
         self._on_token_refresh = on_token_refresh
         if not refresh_token:
             self.__auth_code_flow()
@@ -195,13 +197,17 @@ class AnaplanOauth2AuthCodeAuth(_AnaplanAuth):
         try:
             logger.info("Creating Authentication Token with OAuth2 Authorization Code Flow.")
             url, _, _ = self._oauth.prepare_authorization_request(
-                "https://us1a.app.anaplan.com/auth/authorize",
+                "https://us1a.app.anaplan.com/auth/prelogin",
                 redirect_url=self._redirect_uri,
                 scope=self._scope,
             )
-            authorization_response = input(
-                f"Please go to {url} and authorize the app.\n"
-                "Then paste the entire redirect URL here: "
+            authorization_response = (
+                self._on_auth_code(url)
+                if self._on_auth_code
+                else input(
+                    f"Please go to {url} and authorize the app.\n"
+                    "Then paste the entire redirect URL here: "
+                )
             )
             url, headers, body = self._oauth.prepare_token_request(
                 token_url=self._token_url,
@@ -211,7 +217,7 @@ class AnaplanOauth2AuthCodeAuth(_AnaplanAuth):
             )
             self._parse_auth_response(httpx.post(url=url, headers=headers, content=body))
         except (httpx.HTTPError, ValueError, TypeError, OAuth2Error) as error:
-            raise AnaplanException("Error during OAuth2 authorization flow.") from error
+            raise InvalidCredentialsException("Error during OAuth2 authorization flow.") from error
 
 
 def create_auth(
@@ -225,6 +231,7 @@ def create_auth(
     redirect_uri: str | None = None,
     refresh_token: str | None = None,
     oauth2_scope: str = "openid profile email offline_access",
+    on_auth_code: Callable[[str], str] | None = None,
     on_token_refresh: Callable[[dict[str, str]], None] | None = None,
 ) -> _AnaplanAuth:
     if certificate and private_key:
@@ -238,6 +245,7 @@ def create_auth(
             redirect_uri=redirect_uri,
             refresh_token=refresh_token,
             scope=oauth2_scope,
+            on_auth_code=on_auth_code,
             on_token_refresh=on_token_refresh,
         )
     raise ValueError(

anaplan_sdk/_base.py

@@ -12,11 +12,7 @@ from typing import Any, Callable, Coroutine, Iterator, Literal, Type, TypeVar
 import httpx
 from httpx import HTTPError, Response
 
-from .exceptions import (
-    AnaplanException,
-    AnaplanTimeoutException,
-    InvalidIdentifierException,
-)
+from .exceptions import AnaplanException, AnaplanTimeoutException, InvalidIdentifierException
 from .models import AnaplanModel
 from .models.cloud_works import (
     AmazonS3ConnectionInput,

anaplan_sdk/_clients/_bulk.py

@@ -58,6 +58,7 @@ class Client(_BaseClient):
         redirect_uri: str | None = None,
         refresh_token: str | None = None,
         oauth2_scope: str = "openid profile email offline_access",
+        on_auth_code: Callable[[str], str] | None = None,
         on_token_refresh: Callable[[dict[str, str]], None] | None = None,
         timeout: float | httpx.Timeout = 30,
         retry_count: int = 2,
@@ -94,6 +95,9 @@ class Client(_BaseClient):
         :param refresh_token: If you have a valid refresh token, you can pass it to skip the
                               interactive authentication code step.
         :param oauth2_scope: The scope of the Oauth2 token, if you want to narrow it.
+        :param on_auth_code: A callback that takes the redirect URI as a single argument and must
+                     return the entire response URI. This will substitute the interactive
+                     authentication code step in the terminal.
         :param on_token_refresh: A callback function that is called whenever the token is refreshed.
                                  With this you can for example securely store the token in your
                                  application or on your server for later reuse. The function
@@ -130,6 +134,7 @@ class Client(_BaseClient):
                     redirect_uri=redirect_uri,
                     refresh_token=refresh_token,
                     oauth2_scope=oauth2_scope,
+                    on_auth_code=on_auth_code,
                     on_token_refresh=on_token_refresh,
                 )
             ),
@@ -473,8 +478,7 @@ class Client(_BaseClient):
         :return: The identifier of the spawned Task.
         """
         response = self._post(
-            f"{self._url}/{action_url(action_id)}/{action_id}/tasks",
-            json={"localeName": "en_US"},
+            f"{self._url}/{action_url(action_id)}/{action_id}/tasks", json={"localeName": "en_US"}
         )
         task_id = response.get("task").get("taskId")
         logger.info(f"Invoked Action '{action_id}', spawned Task: '{task_id}'.")

anaplan_sdk/_clients/_transactional.py

@@ -86,7 +86,15 @@ class _TransactionalClient(_BaseClient):
         """
         Insert new items to the given list. The items must be a list of dictionaries with at least
         the keys `code` and `name`. You can optionally pass further keys for parents, extra
-        properties etc.
+        properties etc. If you pass a long list, it will be split into chunks of 100,000 items, the
+        maximum allowed by the API.
+
+        **Warning**: If one or some of the requests timeout during large batch operations, the
+        operation may actually complete on the server. Retries for these chunks will then report
+        these items as "ignored" rather than "added", leading to misleading results. The results in
+        Anaplan will be correct, but this function may report otherwise. Be generous with your
+        timeouts and retries if you are using this function for large batch operations.
+
         :param list_id: The ID of the List.
         :param items: The items to insert into the List.
         :return: The result of the insertion, indicating how many items were added,
@@ -120,7 +128,16 @@ class _TransactionalClient(_BaseClient):
 
     def delete_list_items(self, list_id: int, items: list[dict[str, str | int]]) -> int:
         """
-        Deletes items from a List.
+        Deletes items from a List. If you pass a long list, it will be split into chunks of 100,000
+        items, the maximum allowed by the API.
+
+        **Warning**: If one or some of the requests timeout during large batch operations, the
+        operation may actually complete on the server. Retries for these chunks will then report
+        none of these items as deleted, since on the retry none are removed, leading to misleading
+        results. The results in Anaplan will be correct, but this function may report otherwise.
+        Be generous with your timeouts and retries if you are using this function for large batch
+        operations.
+
         :param list_id: The ID of the List.
         :param items: The items to delete from the List. Must be a dict with either `code` or `id`
                       as the keys to identify the records to delete.
@@ -155,8 +172,13 @@ class _TransactionalClient(_BaseClient):
         """
         Write the passed items to the specified module. If successful, the number of cells changed
         is returned, if only partially successful or unsuccessful, the response with the according
-        details is returned instead. For more details,
-        see: https://anaplan.docs.apiary.io/#UpdateModuleCellData.
+        details is returned instead.
+
+        **You can update a maximum of 100,000 cells or 15 MB of data (whichever is lower) in a
+        single request.** You must chunk your data accordingly. This is not done by this SDK,
+        since it is discouraged. For larger imports, you should use the Bulk API instead.
+
+        For more details see: https://anaplan.docs.apiary.io/#UpdateModuleCellData.
         :param module_id: The ID of the Module.
         :param data: The data to write to the Module.
         :return: The number of cells changed or the response with the according error details.

anaplan_sdk/models/_base.py

@@ -6,12 +6,7 @@ class AnaplanModel(BaseModel):
     model_config = ConfigDict(alias_generator=to_camel, populate_by_name=True)
 
     @field_serializer(
-        "action_id",
-        "file_id",
-        "process_id",
-        "id",
-        when_used="unless-none",
-        check_fields=False,
+        "action_id", "file_id", "process_id", "id", when_used="unless-none", check_fields=False
     )  # While these are of type int, they are serialized as strings in the API payloads
     def str_serializer(self, v: int) -> str:
         return str(v)

anaplan_sdk/models/cloud_works.py

@@ -262,8 +262,7 @@ class SingleIntegration(Integration):
 
 class AnaplanSource(AnaplanModel):
     type: Literal["Anaplan"] = Field(
-        default="Anaplan",
-        description="Literal signifying this is an Anaplan source.",
+        default="Anaplan", description="Literal signifying this is an Anaplan source."
     )
     action_id: int = Field(
         description=(
@@ -294,20 +293,18 @@ class TableSource(AnaplanModel):
 
 class TableTarget(TableSource):
     overwrite: bool = Field(
-        default=False,
-        description="Whether to overwrite the table if it exists.",
+        default=False, description="Whether to overwrite the table if it exists."
     )
 
 
 class AnaplanTarget(AnaplanModel):
     type: Literal["Anaplan"] = Field(
-        default="Anaplan",
-        description="Literal signifying this is an Anaplan target.",
+        default="Anaplan", description="Literal signifying this is an Anaplan target."
     )
     action_id: int = Field(
         description=(
             "The ID of the action to be used as a target. This can be a process, or import."
-        ),
+        )
     )
     file_id: int = Field(description="The ID of the file to be used as a target.")
 
@@ -342,8 +339,7 @@ class IntegrationInput(AnaplanModel):
         ),
     )
     nux_visible: bool = Field(
-        default=False,
-        description="Whether this integration is visible in the UI.",
+        default=False, description="Whether this integration is visible in the UI."
     )
     jobs: list[IntegrationJobInput] = Field(
         description="The jobs in this integration.", min_length=1

{anaplan_sdk-0.4.0a2.dist-info → anaplan_sdk-0.4.1.dist-info}/METADATA

@@ -1,19 +1,19 @@
 Metadata-Version: 2.4
 Name: anaplan-sdk
-Version: 0.4.0a2
-Summary: Provides pythonic access to the Anaplan API
+Version: 0.4.1
+Summary: Streamlined Python Interface for Anaplan
 Project-URL: Homepage, https://vinzenzklass.github.io/anaplan-sdk/
 Project-URL: Repository, https://github.com/VinzenzKlass/anaplan-sdk
 Project-URL: Documentation, https://vinzenzklass.github.io/anaplan-sdk/
 Author-email: Vinzenz Klass <vinzenz.klass@valantic.com>
 License-Expression: Apache-2.0
 License-File: LICENSE
-Keywords: anaplan,anaplan alm api,anaplan api,anaplan audit api,anaplan bulk api,anaplan integration
+Keywords: anaplan,anaplan alm api,anaplan api,anaplan audit api,anaplan bulk api,anaplan cloudworks api,anaplan integration,anaplan integration api,anaplan sdk,anaplan transactional api
 Requires-Python: >=3.10.4
 Requires-Dist: httpx<1.0.0,>=0.27.0
 Requires-Dist: pydantic<3.0.0,>=2.7.2
 Provides-Extra: cert
-Requires-Dist: cryptography<45.0.0,>=42.0.7; extra == 'cert'
+Requires-Dist: cryptography<46.0.0,>=42.0.7; extra == 'cert'
 Provides-Extra: oauth
 Requires-Dist: oauthlib<4.0.0,>=3.0.0; extra == 'oauth'
 Description-Content-Type: text/markdown

{anaplan_sdk-0.4.0a2.dist-info → anaplan_sdk-0.4.1.dist-info}/RECORD

@@ -1,29 +1,29 @@
 anaplan_sdk/__init__.py,sha256=5fr-SZSsH6f3vkRUTDoK6xdAN31cCpe9Mwz2VNu47Uw,134
-anaplan_sdk/_auth.py,sha256=wqlyrZwaJSEXW5J2-GV4UIw7KxDkfQ-loWdePVy2lWg,10231
-anaplan_sdk/_base.py,sha256=lKwtDSi1KRGDxd60Vv0prS_XhB7fsJkvtNWxI23njOA,12319
+anaplan_sdk/_auth.py,sha256=LjPKGoM7qqiFmr9qC4_ZnV9sTHPbvhrnf6iSq_w1tNI,10569
+anaplan_sdk/_base.py,sha256=9CdLshORWsLixOyoFa3A0Bka5lhLwlZrQI5sEdBcGFI,12298
 anaplan_sdk/exceptions.py,sha256=ALkA9fBF0NQ7dufFxV6AivjmHyuJk9DOQ9jtJV2n7f0,1809
 anaplan_sdk/_async_clients/__init__.py,sha256=pZXgMMg4S9Aj_pxQCaSiPuNG-sePVGBtNJ0133VjqW4,364
 anaplan_sdk/_async_clients/_alm.py,sha256=O1_r-O1tNDq7vXRwE2UEFE5S2bPmPh4IAQPQ8bmZfQE,3297
 anaplan_sdk/_async_clients/_audit.py,sha256=a92RY0B3bWxp2CCAWjzqKfvBjG1LJGlai0Hn5qmwgF8,2312
-anaplan_sdk/_async_clients/_bulk.py,sha256=pvx0ux5tAAtCsNJrJorC_SDRxvDUSWu5aKPolE1_nuo,25297
+anaplan_sdk/_async_clients/_bulk.py,sha256=YLttQd9oVHrvafXZ_J0QD8EQ3QCtmcT9YRZQ8_X71AI,25674
 anaplan_sdk/_async_clients/_cloud_works.py,sha256=KPX9W55SF6h8fJd4Rx-HLq6eaRA-Vo3rFu343UiiaGQ,16642
 anaplan_sdk/_async_clients/_cw_flow.py,sha256=ZTNAbKDwb59Wg3u68hbtt1kpd-LNz9K0sftT-gvYzJQ,3651
-anaplan_sdk/_async_clients/_transactional.py,sha256=zEM-wWxX-mCkk9H_nIl3WDZ6X3bo6LQxWLpfLCG5BDw,6524
+anaplan_sdk/_async_clients/_transactional.py,sha256=Mvr7OyBPjQRpBtzkJNfRzV4aNCzUiaYmm0zQubo62Wo,8035
 anaplan_sdk/_clients/__init__.py,sha256=FsbwvZC1FHrxuRXwbPxUzbhz_lO1DpXIxEOjx6-3QuA,219
 anaplan_sdk/_clients/_alm.py,sha256=UAdQxgHfax-VquC0YtbqrRBku2Rn35tVgwJdxYFScps,3202
 anaplan_sdk/_clients/_audit.py,sha256=xQQiwWIb4QQefolPvxNwBFE-pkRzzi8fYPyewjF63lc,2181
-anaplan_sdk/_clients/_bulk.py,sha256=CaDFD5j5nZtvCPKwyVYBBpf1qr-OWMuPFXojF-fEM1k,25119
+anaplan_sdk/_clients/_bulk.py,sha256=TVinTtTYnlcoTrOX0ldpW11qui5rSUXm_PE1L7JgST8,25466
 anaplan_sdk/_clients/_cloud_works.py,sha256=KAMnLoeMJ2iwMXlDSbKynCE57BtkCfOgM5O8wT1kkSs,16291
 anaplan_sdk/_clients/_cw_flow.py,sha256=5IFWFT-qbyGvaSOOtaFOjHnOlyYbj4Rj3xiavfTlm8c,3527
-anaplan_sdk/_clients/_transactional.py,sha256=o1wcAgVyIn2EdJL8Ivw6cW7KZ9OEFwv-PpbhvQAqCfo,6465
+anaplan_sdk/_clients/_transactional.py,sha256=YUVbA54uhMloQcahwMtmZO3YooO6qQzwZN3ZRSu_z_c,7976
 anaplan_sdk/models/__init__.py,sha256=nSplwPG_74CG9CKbv1PzP9bsA9v5-daS4azpTCvCQTI,925
 anaplan_sdk/models/_alm.py,sha256=IqsTPvkx_ujLpaqZgIrTcr44KHJyKc4dyeRs9rkDjms,2307
-anaplan_sdk/models/_base.py,sha256=k2hGE0NmnNwLNJsPUuSjSYSUG9W2orZmMiCGYer7Zuk,554
+anaplan_sdk/models/_base.py,sha256=6AZc9CfireUKgpZfMxYKu4MbwiyHQOsGLjKrxGXBLic,508
 anaplan_sdk/models/_bulk.py,sha256=dHP3kMvsKONCZS6mHB271-wp2S4P3rM874Ita8TzABU,8256
 anaplan_sdk/models/_transactional.py,sha256=_0UbVR9D5QABI29yloYrJTSgL-K0EU7PzPeJu5LdhnY,4854
-anaplan_sdk/models/cloud_works.py,sha256=AWSwyVhAqOGYgWTbCTrfVQuqEY0_LW3ct5zxSZ7UKWs,19466
+anaplan_sdk/models/cloud_works.py,sha256=nfn_LHPR-KmW7Tpvz-5qNCzmR8SYgvsVV-lx5iDlyqI,19425
 anaplan_sdk/models/flows.py,sha256=SuLgNj5-2SeE3U1i8iY8cq2IkjuUgd_3M1n2ENructk,3625
-anaplan_sdk-0.4.0a2.dist-info/METADATA,sha256=-hZsuCu5si1jen5pTxo307hfKXMTGYulIxFrsg_tsUw,3463
-anaplan_sdk-0.4.0a2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-anaplan_sdk-0.4.0a2.dist-info/licenses/LICENSE,sha256=HrhfyXIkWY2tGFK11kg7vPCqhgh5DcxleloqdhrpyMY,11558
-anaplan_sdk-0.4.0a2.dist-info/RECORD,,
+anaplan_sdk-0.4.1.dist-info/METADATA,sha256=BBxu0ztPLPPxIJtueo3P3cfs1webd9Fxu60hFdHi0p8,3543
+anaplan_sdk-0.4.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+anaplan_sdk-0.4.1.dist-info/licenses/LICENSE,sha256=HrhfyXIkWY2tGFK11kg7vPCqhgh5DcxleloqdhrpyMY,11558
+anaplan_sdk-0.4.1.dist-info/RECORD,,