impectPy 2.5.0__tar.gz → 2.5.1__tar.gz

{impectPy-2.5.0 → impectPy-2.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: impectPy
-Version: 2.5.0
+Version: 2.5.1
 Summary: A Python package to facilitate interaction with the Impect customer API
 Home-page: https://github.com/ImpectAPI/impectPy
 Author: Impect
@@ -16,9 +16,9 @@ Requires-Dist: numpy<2.0,>=1.24.2
 
 A package provided by: Impect GmbH
 
-Version: v2.5.0
+Version: v2.5.1
 
-**Updated: October 15th 2025**
+**Updated: October 17th 2025**
 
 ---
 
@@ -49,7 +49,7 @@ pip install impectPy
 You can also install it from [GitHub](https://github.com/) with:
 
 ```cmd
-pip install git+https://github.com/ImpectAPI/impectPy.git@v2.5.0
+pip install git+https://github.com/ImpectAPI/impectPy.git@v2.5.1
 ```
 
 ## Usage

{impectPy-2.5.0 → impectPy-2.5.1}/README.md

@@ -2,9 +2,9 @@
 
 A package provided by: Impect GmbH
 
-Version: v2.5.0
+Version: v2.5.1
 
-**Updated: October 15th 2025**
+**Updated: October 17th 2025**
 
 ---
 
@@ -35,7 +35,7 @@ pip install impectPy
 You can also install it from [GitHub](https://github.com/) with:
 
 ```cmd
-pip install git+https://github.com/ImpectAPI/impectPy.git@v2.5.0
+pip install git+https://github.com/ImpectAPI/impectPy.git@v2.5.1
 ```
 
 ## Usage

{impectPy-2.5.0 → impectPy-2.5.1}/impectPy/__init__.py

@@ -1,5 +1,5 @@
 # define version attribute
-__version__ = "2.5.0"
+__version__ = "2.5.1"
 
 # import modules
 from .access_token import getAccessToken

{impectPy-2.5.0 → impectPy-2.5.1}/impectPy/events.py

@@ -2,10 +2,10 @@
 import numpy as np
 import pandas as pd
 import requests
-from impectPy.helpers import RateLimitedAPI
+import re
+from impectPy.helpers import RateLimitedAPI, ForbiddenError
 from .matches import getMatchesFromHost
 from .iterations import getIterationsFromHost
-import re
 
 ######
 #
@@ -119,16 +119,23 @@ def getEventsFromHost(
         ignore_index=True)[["id", "name"]].drop_duplicates()
 
     # get coaches
-    coaches = pd.concat(
-        map(lambda iteration: connection.make_api_request_limited(
-            url=f"{host}/v5/customerapi/iterations/{iteration}/coaches",
-            method="GET"
-        ).process_response(
-            endpoint="Coaches",
-            raise_exception=False
-        ),
-            iterations),
-        ignore_index=True)[["id", "name"]].drop_duplicates()
+    coaches_blacklisted = False
+    try:
+        coaches = pd.concat(
+            map(lambda iteration: connection.make_api_request_limited(
+                url=f"{host}/v5/customerapi/iterations/{iteration}/coaches",
+                method="GET"
+            ).process_response(
+                endpoint="Coaches",
+                raise_exception=False
+            ),
+                iterations),
+            ignore_index=True)[["id", "name"]].drop_duplicates()
+    except KeyError:
+        # no coaches found, create empty df
+        coaches = pd.DataFrame(columns=["id", "name"])
+    except ForbiddenError:
+        coaches_blacklisted = True
 
     # get matches
     matchplan = pd.concat(
@@ -265,18 +272,6 @@ def getEventsFromHost(
         right_on="id",
         how="left",
         suffixes=("", "_right")
-    ).merge(
-        coaches[["id", "name"]].rename(columns={"id": "homeCoachId", "name": "homeCoachName"}),
-        left_on="homeSquadCoachId",
-        right_on="homeCoachId",
-        how="left",
-        suffixes=("", "_right")
-    ).merge(
-        coaches[["id", "name"]].rename(columns={"id": "awayCoachId", "name": "awayCoachName"}),
-        left_on="awaySquadCoachId",
-        right_on="awayCoachId",
-        how="left",
-        suffixes=("", "_right")
     ).merge(
         iterations,
         left_on="iterationId",
@@ -285,6 +280,21 @@ def getEventsFromHost(
         suffixes=("", "_right")
     )
 
+    if not coaches_blacklisted:
+        events = events.merge(
+            coaches[["id", "name"]].rename(columns={"id": "homeCoachId", "name": "homeCoachName"}),
+            left_on="homeSquadCoachId",
+            right_on="homeCoachId",
+            how="left",
+            suffixes=("", "_right")
+        ).merge(
+            coaches[["id", "name"]].rename(columns={"id": "awayCoachId", "name": "awayCoachName"}),
+            left_on="awaySquadCoachId",
+            right_on="awayCoachId",
+            how="left",
+            suffixes=("", "_right")
+        )
+
     if include_kpis:
         # unnest scorings and full join with kpi list to ensure all kpis are present
         scorings = scorings.merge(kpis, left_on="kpiId", right_on="id", how="outer") \
@@ -532,6 +542,9 @@ def getEventsFromHost(
         # add kpis
         order = order + kpi_cols
 
+    if coaches_blacklisted:
+        order = [col for col in order if col not in ["homeCoachId", "homeCoachName", "awayCoachId", "awayCoachName"]]
+
     # reorder data
     events = events[order]
 

{impectPy-2.5.0 → impectPy-2.5.1}/impectPy/helpers.py

@@ -15,6 +15,11 @@ import math
 ######
 
 
+class ForbiddenError(Exception):
+    """Raised when the API returns a 403 Forbidden response."""
+    pass
+
+
 class RateLimitedAPI:
     def __init__(self, session: Optional[requests.Session] = None):
         """
@@ -115,10 +120,10 @@ class RateLimitedAPI:
                                 f"Request-ID: {response.headers['x-request-id']} "
                                 f"(Make sure to include this in any support request.)")
             elif response.status_code == 403:
-                raise Exception(f"Received status code {response.status_code} "
-                                f"(You do not have access to this resource.)\n"
-                                f"Request-ID: {response.headers['x-request-id']} "
-                                f"(Make sure to include this in any support request.)")
+                raise ForbiddenError(f"Received status code {response.status_code} "
+                                     f"(You do not have access to this resource.)\n"
+                                     f"Request-ID: {response.headers['x-request-id']} "
+                                     f"(Make sure to include this in any support request.)")
             # check status code and terminate if other error
             else:
                 raise Exception(f"Received status code {response.status_code} "

{impectPy-2.5.0 → impectPy-2.5.1}/impectPy/iteration_averages.py

@@ -118,13 +118,16 @@ def getPlayerIterationAveragesFromHost(
         if len(averages_raw["name"][averages_raw["name"].isnull()]) > 0:
             averages_raw["name"] = averages_raw["name"].fillna("-1")
 
-        # downcast numerics and category types
-        averages_raw["iterationId"] = averages_raw["iterationId"].astype("Int16")
-        averages_raw["squadId"] = averages_raw["squadId"].astype("Int16")
-        averages_raw["playerId"] = averages_raw["playerId"].astype("Int32")
-        averages_raw["position"] = averages_raw["position"].astype("category")
-        averages_raw["name"] = averages_raw["name"].astype("category")
-        averages_raw["value"] = averages_raw["value"].astype("Float32")
+        # get KPIs without a scoring
+        mask = (
+                averages_raw.iterationId.isnull()
+                & averages_raw.squadId.isnull()
+                & averages_raw.playerId.isnull()
+                & averages_raw.position.isnull()
+        )
+
+        # fill join cols with placeholder
+        averages_raw.loc[mask] = averages_raw.loc[mask].fillna(-1)
 
         # get matchShares
         match_shares_raw = averages_raw[
@@ -146,6 +149,14 @@ def getPlayerIterationAveragesFromHost(
         if "-1" in averages_raw.columns:
             averages_raw.drop(["-1"], inplace=True, axis=1)
 
+        # drop -1 rows
+        averages_raw = averages_raw[
+            ~(averages_raw.iterationId == -1)
+            & ~(averages_raw.squadId == -1)
+            & ~(averages_raw.playerId == -1)
+            & ~(averages_raw.position == -1)
+        ]
+
         # merge with playDuration and matchShare
         averages_raw = averages_raw.merge(
             match_shares_raw,

{impectPy-2.5.0 → impectPy-2.5.1}/impectPy/matchsums.py

@@ -1,7 +1,7 @@
 # load packages
 import pandas as pd
 import requests
-from impectPy.helpers import RateLimitedAPI, unnest_mappings_df
+from impectPy.helpers import RateLimitedAPI, unnest_mappings_df, ForbiddenError
 from .matches import getMatchesFromHost
 from .iterations import getIterationsFromHost
 
@@ -102,16 +102,23 @@ def getPlayerMatchsumsFromHost(matches: list, connection: RateLimitedAPI, host:
         ignore_index=True)[["id", "name"]].drop_duplicates()
 
     # get coaches
-    coaches = pd.concat(
-        map(lambda iteration: connection.make_api_request_limited(
-            url=f"{host}/v5/customerapi/iterations/{iteration}/coaches",
-            method="GET"
-        ).process_response(
-            endpoint="Coaches",
-            raise_exception=False
-        ),
-            iterations),
-        ignore_index=True)[["id", "name"]].drop_duplicates()
+    coaches_blacklisted = False
+    try:
+        coaches = pd.concat(
+            map(lambda iteration: connection.make_api_request_limited(
+                url=f"{host}/v5/customerapi/iterations/{iteration}/coaches",
+                method="GET"
+            ).process_response(
+                endpoint="Coaches",
+                raise_exception=False
+            ),
+                iterations),
+            ignore_index=True)[["id", "name"]].drop_duplicates()
+    except KeyError:
+        # no coaches found, create empty df
+        coaches = pd.DataFrame(columns=["id", "name"])
+    except ForbiddenError:
+        coaches_blacklisted = True
 
     # get kpis
     kpis = connection.make_api_request_limited(
@@ -248,14 +255,6 @@ def getPlayerMatchsumsFromHost(matches: list, connection: RateLimitedAPI, host:
         right_on="id",
         how="left",
         suffixes=("", "_right")
-    ).merge(
-        coaches[["id", "name"]].rename(
-            columns={"id": "coachId", "name": "coachName"}
-        ),
-        left_on="coachId",
-        right_on="coachId",
-        how="left",
-        suffixes=("", "_right")
     ).merge(
         countries.rename(columns={"fifaName": "playerCountry"}),
         left_on="countryId",
@@ -264,6 +263,17 @@ def getPlayerMatchsumsFromHost(matches: list, connection: RateLimitedAPI, host:
         suffixes=("", "_right")
     )
 
+    if not coaches_blacklisted:
+        matchsums = matchsums.merge(
+            coaches[["id", "name"]].rename(
+                columns={"id": "coachId", "name": "coachName"}
+            ),
+            left_on="coachId",
+            right_on="coachId",
+            how="left",
+            suffixes=("", "_right")
+        )
+
     # rename some columns
     matchsums = matchsums.rename(columns={
         "scheduledDate": "dateTime",
@@ -304,6 +314,10 @@ def getPlayerMatchsumsFromHost(matches: list, connection: RateLimitedAPI, host:
     # add kpiNames to order
     order += kpis['name'].to_list()
 
+    # check if coaches are blacklisted
+    if coaches_blacklisted:
+        order = [col for col in order if col not in ["coachId", "coachName"]]
+
     # select columns
     matchsums = matchsums[order]
 
@@ -395,16 +409,23 @@ def getSquadMatchsumsFromHost(matches: list, connection: RateLimitedAPI, host: s
         ignore_index=True)[["id", "name", "idMappings"]]
 
     # get coaches
-    coaches = pd.concat(
-        map(lambda iteration: connection.make_api_request_limited(
-            url=f"{host}/v5/customerapi/iterations/{iteration}/coaches",
-            method="GET"
-        ).process_response(
-            endpoint="Coaches",
-            raise_exception=False
-        ),
-            iterations),
-        ignore_index=True)[["id", "name"]].drop_duplicates()
+    coaches_blacklisted = False
+    try:
+        coaches = pd.concat(
+            map(lambda iteration: connection.make_api_request_limited(
+                url=f"{host}/v5/customerapi/iterations/{iteration}/coaches",
+                method="GET"
+            ).process_response(
+                endpoint="Coaches",
+                raise_exception=False
+            ),
+                iterations),
+            ignore_index=True)[["id", "name"]].drop_duplicates()
+    except KeyError:
+        # no coaches found, create empty df
+        coaches = pd.DataFrame(columns=["id", "name"])
+    except ForbiddenError:
+        coaches_blacklisted = True
 
     # unnest mappings
     squads = unnest_mappings_df(squads, "idMappings").drop(["idMappings"], axis=1).drop_duplicates()
@@ -502,16 +523,19 @@ def getSquadMatchsumsFromHost(matches: list, connection: RateLimitedAPI, host: s
         right_on="squadId",
         how="left",
         suffixes=("", "_home")
-    ).merge(
-        coaches[["id", "name"]].rename(
-            columns={"id": "coachId", "name": "coachName"}
-        ),
-        left_on="coachId",
-        right_on="coachId",
-        how="left",
-        suffixes=("", "_right")
     )
 
+    if not coaches_blacklisted:
+        matchsums = matchsums.merge(
+            coaches[["id", "name"]].rename(
+                columns={"id": "coachId", "name": "coachName"}
+            ),
+            left_on="coachId",
+            right_on="coachId",
+            how="left",
+            suffixes=("", "_right")
+        )
+
     # rename some columns
     matchsums = matchsums.rename(columns={
         "scheduledDate": "dateTime"
@@ -549,6 +573,10 @@ def getSquadMatchsumsFromHost(matches: list, connection: RateLimitedAPI, host: s
     # reset index
     matchsums = matchsums.reset_index()
 
+    # check if coaches are blacklisted
+    if coaches_blacklisted:
+        order = [col for col in order if col not in ["coachId", "coachName"]]
+
     # select & order columns
     matchsums = matchsums[order]
 

{impectPy-2.5.0 → impectPy-2.5.1}/impectPy/player_scores.py

@@ -1,7 +1,7 @@
 # load packages
 import pandas as pd
 import requests
-from impectPy.helpers import RateLimitedAPI, unnest_mappings_df
+from impectPy.helpers import RateLimitedAPI, unnest_mappings_df, ForbiddenError
 from .matches import getMatchesFromHost
 from .iterations import getIterationsFromHost
 
@@ -151,16 +151,23 @@ def getPlayerMatchScoresFromHost(matches: list, connection: RateLimitedAPI, host
         ignore_index=True)[["id", "name"]].drop_duplicates()
 
     # get coaches
-    coaches = pd.concat(
-        map(lambda iteration: connection.make_api_request_limited(
-            url=f"{host}/v5/customerapi/iterations/{iteration}/coaches",
-            method="GET"
-        ).process_response(
-            endpoint="Coaches",
-            raise_exception=False
-        ),
-            iterations),
-        ignore_index=True)[["id", "name"]].drop_duplicates()
+    coaches_blacklisted = False
+    try:
+        coaches = pd.concat(
+            map(lambda iteration: connection.make_api_request_limited(
+                url=f"{host}/v5/customerapi/iterations/{iteration}/coaches",
+                method="GET"
+            ).process_response(
+                endpoint="Coaches",
+                raise_exception=False
+            ),
+                iterations),
+            ignore_index=True)[["id", "name"]].drop_duplicates()
+    except KeyError:
+        # no coaches found, create empty df
+        coaches = pd.DataFrame(columns=["id", "name"])
+    except ForbiddenError:
+        coaches_blacklisted = True
 
     # get player scores
     scores = connection.make_api_request_limited(
@@ -350,14 +357,6 @@ def getPlayerMatchScoresFromHost(matches: list, connection: RateLimitedAPI, host
         right_on="id",
         how="left",
         suffixes=("", "_right")
-    ).merge(
-        coaches[["id", "name"]].rename(
-            columns={"id": "coachId", "name": "coachName"}
-        ),
-        left_on="coachId",
-        right_on="coachId",
-        how="left",
-        suffixes=("", "_right")
     ).merge(
         countries.rename(columns={"fifaName": "playerCountry"}),
         left_on="countryId",
@@ -366,6 +365,17 @@ def getPlayerMatchScoresFromHost(matches: list, connection: RateLimitedAPI, host
         suffixes=("", "_right")
     )
 
+    if not coaches_blacklisted:
+        player_scores = player_scores.merge(
+            coaches[["id", "name"]].rename(
+                columns={"id": "coachId", "name": "coachName"}
+            ),
+            left_on="coachId",
+            right_on="coachId",
+            how="left",
+            suffixes=("", "_right")
+        )
+
     # rename some columns
     player_scores = player_scores.rename(columns={
         "scheduledDate": "dateTime",
@@ -406,6 +416,10 @@ def getPlayerMatchScoresFromHost(matches: list, connection: RateLimitedAPI, host
     # add kpiNames to order
     order += scores["name"].to_list()
 
+    # check if coaches are blacklisted
+    if coaches_blacklisted:
+        order = [col for col in order if col not in ["coachId", "coachName"]]
+
     # select columns
     player_scores = player_scores[order]
 

{impectPy-2.5.0 → impectPy-2.5.1}/impectPy/squad_scores.py

@@ -1,7 +1,7 @@
 # load packages
 import pandas as pd
 import requests
-from impectPy.helpers import RateLimitedAPI, unnest_mappings_df
+from impectPy.helpers import RateLimitedAPI, unnest_mappings_df, ForbiddenError
 from .matches import getMatchesFromHost
 from .iterations import getIterationsFromHost
 
@@ -81,16 +81,23 @@ def getSquadMatchScoresFromHost(matches: list, connection: RateLimitedAPI, host:
         ignore_index=True)[["id", "name", "idMappings"]]
 
     # get coaches
-    coaches = pd.concat(
-        map(lambda iteration: connection.make_api_request_limited(
-            url=f"{host}/v5/customerapi/iterations/{iteration}/coaches",
-            method="GET"
-        ).process_response(
-            endpoint="Coaches",
-            raise_exception=False
-        ),
-            iterations),
-        ignore_index=True)[["id", "name"]].drop_duplicates()
+    coaches_blacklisted = False
+    try:
+        coaches = pd.concat(
+            map(lambda iteration: connection.make_api_request_limited(
+                url=f"{host}/v5/customerapi/iterations/{iteration}/coaches",
+                method="GET"
+            ).process_response(
+                endpoint="Coaches",
+                raise_exception=False
+            ),
+                iterations),
+            ignore_index=True)[["id", "name"]].drop_duplicates()
+    except KeyError:
+        # no coaches found, create empty df
+        coaches = pd.DataFrame(columns=["id", "name"])
+    except ForbiddenError:
+        coaches_blacklisted = True
 
     # unnest mappings
     squads = unnest_mappings_df(squads, "idMappings").drop(["idMappings"], axis=1).drop_duplicates()
@@ -189,16 +196,19 @@ def getSquadMatchScoresFromHost(matches: list, connection: RateLimitedAPI, host:
         right_on="squadId",
         how="left",
         suffixes=("", "_right")
-    ).merge(
-        coaches[["id", "name"]].rename(
-            columns={"id": "coachId", "name": "coachName"}
-        ),
-        left_on="coachId",
-        right_on="coachId",
-        how="left",
-        suffixes=("", "_right")
     )
 
+    if not coaches_blacklisted:
+        squad_scores = squad_scores.merge(
+            coaches[["id", "name"]].rename(
+                columns={"id": "coachId", "name": "coachName"}
+            ),
+            left_on="coachId",
+            right_on="coachId",
+            how="left",
+            suffixes=("", "_right")
+        )
+
     # rename some columns
     squad_scores = squad_scores.rename(columns={
         "scheduledDate": "dateTime"
@@ -224,6 +234,10 @@ def getSquadMatchScoresFromHost(matches: list, connection: RateLimitedAPI, host:
         "coachName"
     ]
 
+    # check if coaches are blacklisted
+    if coaches_blacklisted:
+        order = [col for col in order if col not in ["coachId", "coachName"]]
+
     # add scoreNames to order
     order += scores["name"].to_list()
 

{impectPy-2.5.0 → impectPy-2.5.1}/impectPy.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: impectPy
-Version: 2.5.0
+Version: 2.5.1
 Summary: A Python package to facilitate interaction with the Impect customer API
 Home-page: https://github.com/ImpectAPI/impectPy
 Author: Impect
@@ -16,9 +16,9 @@ Requires-Dist: numpy<2.0,>=1.24.2
 
 A package provided by: Impect GmbH
 
-Version: v2.5.0
+Version: v2.5.1
 
-**Updated: October 15th 2025**
+**Updated: October 17th 2025**
 
 ---
 
@@ -49,7 +49,7 @@ pip install impectPy
 You can also install it from [GitHub](https://github.com/) with:
 
 ```cmd
-pip install git+https://github.com/ImpectAPI/impectPy.git@v2.5.0
+pip install git+https://github.com/ImpectAPI/impectPy.git@v2.5.1
 ```
 
 ## Usage

{impectPy-2.5.0 → impectPy-2.5.1}/setup.py

@@ -17,7 +17,7 @@ setup(
                       "pandas>=2.0.0",
                       "numpy>=1.24.2,<2.0"],
     # *strongly* suggested for sharing
-    version="2.5.0",
+    version="2.5.1",
     # The license can be anything you like
     license="MIT",
     description="A Python package to facilitate interaction with the Impect customer API",