impectPy 2.5.8__tar.gz → 2.5.9__tar.gz

{impectpy-2.5.8 → impectpy-2.5.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: impectPy
-Version: 2.5.8
+Version: 2.5.9
 Summary: A Python package to facilitate interaction with the Impect customer API
 Home-page: https://github.com/ImpectAPI/impectPy
 Author: Impect
@@ -25,9 +25,9 @@ Dynamic: summary
 
 A package provided by: Impect GmbH
 
-Version: v2.5.8
+Version: v2.5.9
 
-**Updated: March 19th 2026**
+**Updated: April 9th 2026**
 
 ---
 
@@ -58,7 +58,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.8
+pip install git+https://github.com/ImpectAPI/impectPy.git@v2.5.9
 ```
 
 ## Usage

{impectpy-2.5.8 → impectpy-2.5.9}/README.md

@@ -2,9 +2,9 @@
 
 A package provided by: Impect GmbH
 
-Version: v2.5.8
+Version: v2.5.9
 
-**Updated: March 19th 2026**
+**Updated: April 9th 2026**
 
 ---
 
@@ -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.8
+pip install git+https://github.com/ImpectAPI/impectPy.git@v2.5.9
 ```
 
 ## Usage
@@ -431,4 +431,4 @@ playerProfileScores = api.getPlayerProfileScores(iteration=iteration, positions=
 ## Final Notes
 
 Further documentation on the data and explanations of variables can be
-found in our [Glossary](https://glossary.impect.com/).
+found in our [Glossary](https://glossary.impect.com/).

{impectpy-2.5.8 → impectpy-2.5.9}/impectPy/formations.py

@@ -134,7 +134,7 @@ def getFormationsFromHost(matches: list, connection: RateLimitedAPI, host: str)
     # merge with matches info
     formations = formations.merge(
         matchplan[[
-            "id", "skillCornerId", "heimSpielId", "wyscoutId", "matchDayIndex",
+            "id", "skillCornerId", "heimSpielId", "wyscoutId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "matchDayIndex",
             "matchDayName", "scheduledDate", "lastCalculationDate", "iterationId"
         ]],
         left_on="id",

{impectpy-2.5.8 → impectpy-2.5.9}/impectPy/helpers.py

@@ -278,7 +278,7 @@ def unnest_mappings_dict(mapping_dict: dict) -> dict:
 
 def unnest_mappings_df(df: pd.DataFrame, mapping_col: str) -> pd.DataFrame:
     # create empty df to store mappings
-    df_mappings = pd.DataFrame(columns=["wyscoutId", "heimSpielId", "skillCornerId"])
+    df_mappings = pd.DataFrame(columns=["wyscoutId", "heimSpielId", "skillCornerId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId"])
 
     # iterate over entry and unnest idMappings
     for index, entry in df.iterrows():
@@ -291,7 +291,9 @@ def unnest_mappings_df(df: pd.DataFrame, mapping_col: str) -> pd.DataFrame:
                     provider = "heimSpiel"
                 elif provider == "skill_corner":
                     provider = "skillCorner"
-                elif provider == "wyscout":
+                elif provider == "stats_perform":
+                    provider = "statsPerform"
+                elif provider in ("wyscout", "opta", "transfermarkt", "soccerdonna"):
                     pass
                 else:
                     raise Exception(f"Unknown provider: {provider}")

{impectpy-2.5.8 → impectpy-2.5.9}/impectPy/iterations.py

@@ -49,6 +49,10 @@ def getIterationsFromHost(connection: RateLimitedAPI, host: str) -> pd.DataFrame
     df.skillCornerId = df.skillCornerId.apply(lambda x: x[0] if x else None)
     df.heimSpielId = df.heimSpielId.apply(lambda x: x[0] if x else None)
     df.wyscoutId = df.wyscoutId.apply(lambda x: x[0] if x else None)
+    df.optaId = df.optaId.apply(lambda x: x[0] if x else None)
+    df.statsPerformId = df.statsPerformId.apply(lambda x: x[0] if x else None)
+    df.transfermarktId = df.transfermarktId.apply(lambda x: x[0] if x else None)
+    df.soccerdonnaId = df.soccerdonnaId.apply(lambda x: x[0] if x else None)
 
     # get country data
     countries = connection.make_api_request_limited(
@@ -84,6 +88,10 @@ def getIterationsFromHost(connection: RateLimitedAPI, host: str) -> pd.DataFrame
         "wyscoutId",
         "heimSpielId",
         "skillCornerId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
     ]
 
     # select columns

{impectpy-2.5.8 → impectpy-2.5.9}/impectPy/matches.py

@@ -69,6 +69,10 @@ def getMatchesFromHost(iteration: int, connection: RateLimitedAPI, host: str) ->
         "skillCornerId_home": "homeSquadSkillCornerId",
         "heimSpielId_home": "homeSquadHeimSpielId",
         "wyscoutId_home": "homeSquadWyscoutId",
+        "optaId_home": "homeSquadOptaId",
+        "statsPerformId_home": "homeSquadStatsPerformId",
+        "transfermarktId_home": "homeSquadTransfermarktId",
+        "soccerdonnaId_home": "homeSquadSoccerdonnaId",
         "countryId": "homeSquadCountryId"
     })
     matches = matches.merge(squads,
@@ -81,6 +85,10 @@ def getMatchesFromHost(iteration: int, connection: RateLimitedAPI, host: str) ->
         "skillCornerId_away": "awaySquadSkillCornerId",
         "heimSpielId_away": "awaySquadHeimSpielId",
         "wyscoutId_away": "awaySquadWyscoutId",
+        "optaId_away": "awaySquadOptaId",
+        "statsPerformId_away": "awaySquadStatsPerformId",
+        "transfermarktId_away": "awaySquadTransfermarktId",
+        "soccerdonnaId_away": "awaySquadSoccerdonnaId",
         "countryId": "awaySquadCountryId"
     })
 
@@ -107,6 +115,10 @@ def getMatchesFromHost(iteration: int, connection: RateLimitedAPI, host: str) ->
         "skillCornerId",
         "heimSpielId",
         "wyscoutId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
         "iterationId",
         "matchDayIndex",
         "matchDayName",
@@ -118,6 +130,10 @@ def getMatchesFromHost(iteration: int, connection: RateLimitedAPI, host: str) ->
         "homeSquadSkillCornerId",
         "homeSquadHeimSpielId",
         "homeSquadWyscoutId",
+        "homeSquadOptaId",
+        "homeSquadStatsPerformId",
+        "homeSquadTransfermarktId",
+        "homeSquadSoccerdonnaId",
         "awaySquadId",
         "awaySquadName",
         "awaySquadType",
@@ -126,6 +142,10 @@ def getMatchesFromHost(iteration: int, connection: RateLimitedAPI, host: str) ->
         "awaySquadSkillCornerId",
         "awaySquadHeimSpielId",
         "awaySquadWyscoutId",
+        "awaySquadOptaId",
+        "awaySquadStatsPerformId",
+        "awaySquadTransfermarktId",
+        "awaySquadSoccerdonnaId",
         "scheduledDate",
         "lastCalculationDate",
         "available"
@@ -156,9 +176,13 @@ def clean_df(data: dict) -> pd.DataFrame:
     # drop idMappings column
     df = df.drop("idMappings", axis=1)
 
-    # keep first entry for skillcorner and heimspiel data
+    # keep first entry for skillcorner, heimspiel, wyscout, opta, statsperform, transfermarkt and soccerdonna data
     df.skillCornerId = df.skillCornerId.apply(lambda x: x[0] if x else None)
     df.heimSpielId = df.heimSpielId.apply(lambda x: x[0] if x else None)
     df.wyscoutId = df.wyscoutId.apply(lambda x: x[0] if x else None)
+    df.optaId = df.optaId.apply(lambda x: x[0] if x else None)
+    df.statsPerformId = df.statsPerformId.apply(lambda x: x[0] if x else None)
+    df.transfermarktId = df.transfermarktId.apply(lambda x: x[0] if x else None)
+    df.soccerdonnaId = df.soccerdonnaId.apply(lambda x: x[0] if x else None)
 
     return df

{impectpy-2.5.8 → impectpy-2.5.9}/impectPy/player_iteration_averages.py

@@ -198,7 +198,7 @@ def getPlayerIterationAveragesFromHost(
         suffixes=("", "_squads")
     ).merge(
         players[[
-            "id", "wyscoutId", "heimSpielId", "skillCornerId", "commonname",
+            "id", "wyscoutId", "heimSpielId", "skillCornerId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "commonname",
             "firstname", "lastname", "birthdate", "birthplace", "countryId", "leg"
         ]].rename(
             columns={"commonname": "playerName"}
@@ -225,6 +225,10 @@ def getPlayerIterationAveragesFromHost(
     averages["wyscoutId"] = averages["wyscoutId"].astype("Int64")
     averages["heimSpielId"] = averages["heimSpielId"].astype("Int64")
     averages["skillCornerId"] = averages["skillCornerId"].astype("Int64")
+    averages["optaId"] = averages["optaId"].astype("string")
+    averages["statsPerformId"] = averages["statsPerformId"].astype("string")
+    averages["transfermarktId"] = averages["transfermarktId"].astype("string")
+    averages["soccerdonnaId"] = averages["soccerdonnaId"].astype("string")
 
     # define column order
     order = [
@@ -237,6 +241,10 @@ def getPlayerIterationAveragesFromHost(
         "wyscoutId",
         "heimSpielId",
         "skillCornerId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
         "playerName",
         "firstname",
         "lastname",

{impectpy-2.5.8 → impectpy-2.5.9}/impectPy/player_iteration_scores.py

@@ -271,7 +271,7 @@ def getPlayerIterationScoresFromHost(
         suffixes=("", "_iterations")
     ).merge(
         players[[
-            "id", "wyscoutId", "heimSpielId", "skillCornerId", "commonname",
+            "id", "wyscoutId", "heimSpielId", "skillCornerId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "commonname",
             "firstname", "lastname", "birthdate", "birthplace", "countryId", "leg"
         ]].rename(
             columns={"commonname": "playerName"}
@@ -302,6 +302,10 @@ def getPlayerIterationScoresFromHost(
         "wyscoutId",
         "heimSpielId",
         "skillCornerId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
         "playerName",
         "firstname",
         "lastname",
@@ -326,6 +330,10 @@ def getPlayerIterationScoresFromHost(
     averages["wyscoutId"] = averages["wyscoutId"].astype("Int64")
     averages["heimSpielId"] = averages["heimSpielId"].astype("Int64")
     averages["skillCornerId"] = averages["skillCornerId"].astype("Int64")
+    averages["optaId"] = averages["optaId"].astype("string")
+    averages["statsPerformId"] = averages["statsPerformId"].astype("string")
+    averages["transfermarktId"] = averages["transfermarktId"].astype("string")
+    averages["soccerdonnaId"] = averages["soccerdonnaId"].astype("string")
 
     # return result
     return averages

{impectpy-2.5.8 → impectpy-2.5.9}/impectPy/player_match_scores.py

@@ -378,7 +378,7 @@ def getPlayerMatchScoresFromHost(matches: list, connection: RateLimitedAPI, host
         suffixes=("", "_iterations")
     ).merge(
         players[[
-            "id", "wyscoutId", "heimSpielId", "skillCornerId", "commonname",
+            "id", "wyscoutId", "heimSpielId", "skillCornerId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "commonname",
             "firstname", "lastname", "birthdate", "birthplace", "countryId", "leg"
         ]].rename(
             columns={"commonname": "playerName"}
@@ -424,6 +424,10 @@ def getPlayerMatchScoresFromHost(matches: list, connection: RateLimitedAPI, host
         "wyscoutId",
         "heimSpielId",
         "skillCornerId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
         "playerName",
         "firstname",
         "lastname",
@@ -453,6 +457,10 @@ def getPlayerMatchScoresFromHost(matches: list, connection: RateLimitedAPI, host
     player_scores["wyscoutId"] = player_scores["wyscoutId"].astype("Int64")
     player_scores["heimSpielId"] = player_scores["heimSpielId"].astype("Int64")
     player_scores["skillCornerId"] = player_scores["skillCornerId"].astype("Int64")
+    player_scores["optaId"] = player_scores["optaId"].astype("string")
+    player_scores["statsPerformId"] = player_scores["statsPerformId"].astype("string")
+    player_scores["transfermarktId"] = player_scores["transfermarktId"].astype("string")
+    player_scores["soccerdonnaId"] = player_scores["soccerdonnaId"].astype("string")
 
     # return data
     return player_scores

{impectpy-2.5.8 → impectpy-2.5.9}/impectPy/player_matchsums.py

@@ -272,7 +272,7 @@ def getPlayerMatchsumsFromHost(matches: list, connection: RateLimitedAPI, host:
         suffixes=("", "_iterations")
     ).merge(
         players[[
-            "id", "wyscoutId", "heimSpielId", "skillCornerId", "commonname",
+            "id", "wyscoutId", "heimSpielId", "skillCornerId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "commonname",
             "firstname", "lastname", "birthdate", "birthplace", "countryId", "leg"
         ]].rename(
             columns={"commonname": "playerName"}
@@ -318,6 +318,10 @@ def getPlayerMatchsumsFromHost(matches: list, connection: RateLimitedAPI, host:
         "wyscoutId",
         "heimSpielId",
         "skillCornerId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
         "playerName",
         "firstname",
         "lastname",
@@ -347,6 +351,10 @@ def getPlayerMatchsumsFromHost(matches: list, connection: RateLimitedAPI, host:
     matchsums["wyscoutId"] = matchsums["wyscoutId"].astype("Int64")
     matchsums["heimSpielId"] = matchsums["heimSpielId"].astype("Int64")
     matchsums["skillCornerId"] = matchsums["skillCornerId"].astype("Int64")
+    matchsums["optaId"] = matchsums["optaId"].astype("string")
+    matchsums["statsPerformId"] = matchsums["statsPerformId"].astype("string")
+    matchsums["transfermarktId"] = matchsums["transfermarktId"].astype("string")
+    matchsums["soccerdonnaId"] = matchsums["soccerdonnaId"].astype("string")
 
     # return data
     return matchsums

{impectpy-2.5.8 → impectpy-2.5.9}/impectPy/player_profile_scores.py

@@ -211,7 +211,7 @@ def getPlayerProfileScoresFromHost(
         suffixes=("", "_squads")
     ).merge(
         players[[
-            "id", "wyscoutId", "heimSpielId", "skillCornerId", "commonname",
+            "id", "wyscoutId", "heimSpielId", "skillCornerId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "commonname",
             "firstname", "lastname", "birthdate", "birthplace", "countryId", "leg"
         ]].rename(
             columns={"commonname": "playerName"}
@@ -233,6 +233,10 @@ def getPlayerProfileScoresFromHost(
     profile_scores["wyscoutId"] = profile_scores["wyscoutId"].astype("Int64")
     profile_scores["heimSpielId"] = profile_scores["heimSpielId"].astype("Int64")
     profile_scores["skillCornerId"] = profile_scores["skillCornerId"].astype("Int64")
+    profile_scores["optaId"] = profile_scores["optaId"].astype("string")
+    profile_scores["statsPerformId"] = profile_scores["statsPerformId"].astype("string")
+    profile_scores["transfermarktId"] = profile_scores["transfermarktId"].astype("string")
+    profile_scores["soccerdonnaId"] = profile_scores["soccerdonnaId"].astype("string")
 
     # define column order
     order = [
@@ -245,6 +249,10 @@ def getPlayerProfileScoresFromHost(
         "wyscoutId",
         "heimSpielId",
         "skillCornerId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
         "playerName",
         "firstname",
         "lastname",

{impectpy-2.5.8 → impectpy-2.5.9}/impectPy/squad_coefficients.py

@@ -87,7 +87,7 @@ def getSquadCoefficientsFromHost(iteration: int, connection: RateLimitedAPI, hos
 
     # merge events with squads
     coefficients = coefficients.merge(
-        squads[["id", "wyscoutId", "heimSpielId", "skillCornerId", "name"]].rename(
+        squads[["id", "wyscoutId", "heimSpielId", "skillCornerId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "name"]].rename(
             columns={"id": "squadId", "name": "squadName"}
         ),
         left_on="squadId",
@@ -103,6 +103,10 @@ def getSquadCoefficientsFromHost(iteration: int, connection: RateLimitedAPI, hos
     coefficients["wyscoutId"] = coefficients["wyscoutId"].astype("Int64")
     coefficients["heimSpielId"] = coefficients["heimSpielId"].astype("Int64")
     coefficients["skillCornerId"] = coefficients["skillCornerId"].astype("Int64")
+    coefficients["optaId"] = coefficients["optaId"].astype("string")
+    coefficients["statsPerformId"] = coefficients["statsPerformId"].astype("string")
+    coefficients["transfermarktId"] = coefficients["transfermarktId"].astype("string")
+    coefficients["soccerdonnaId"] = coefficients["soccerdonnaId"].astype("string")
 
     # define desired column order
     order = [
@@ -120,6 +124,10 @@ def getSquadCoefficientsFromHost(iteration: int, connection: RateLimitedAPI, hos
         "wyscoutId",
         "heimSpielId",
         "skillCornerId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
         "squadName",
         "attackCoefficient",
         "defenseCoefficient",

{impectpy-2.5.8 → impectpy-2.5.9}/impectPy/squad_iteration_averages.py

@@ -110,7 +110,7 @@ def getSquadIterationAveragesFromHost(iteration: int, connection: RateLimitedAPI
         how="left",
         suffixes=("", "_iterations")
     ).merge(
-        squads[["id", "wyscoutId", "heimSpielId", "skillCornerId", "name"]].rename(
+        squads[["id", "wyscoutId", "heimSpielId", "skillCornerId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "name"]].rename(
             columns={"id": "squadId", "name": "squadName"}
         ),
         left_on="squadId",
@@ -129,6 +129,10 @@ def getSquadIterationAveragesFromHost(iteration: int, connection: RateLimitedAPI
     averages["wyscoutId"] = averages["wyscoutId"].astype("Int64")
     averages["heimSpielId"] = averages["heimSpielId"].astype("Int64")
     averages["skillCornerId"] = averages["skillCornerId"].astype("Int64")
+    averages["optaId"] = averages["optaId"].astype("string")
+    averages["statsPerformId"] = averages["statsPerformId"].astype("string")
+    averages["transfermarktId"] = averages["transfermarktId"].astype("string")
+    averages["soccerdonnaId"] = averages["soccerdonnaId"].astype("string")
 
     # define column order
     order = [
@@ -139,6 +143,10 @@ def getSquadIterationAveragesFromHost(iteration: int, connection: RateLimitedAPI
         "wyscoutId",
         "heimSpielId",
         "skillCornerId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
         "squadName",
         "matches"
     ]

{impectpy-2.5.8 → impectpy-2.5.9}/impectPy/squad_iteration_scores.py

@@ -110,7 +110,7 @@ def getSquadIterationScoresFromHost(iteration: int, connection: RateLimitedAPI,
         how="left",
         suffixes=("", "_iterations")
     ).merge(
-        squads[["id", "wyscoutId", "heimSpielId", "skillCornerId", "name"]].rename(
+        squads[["id", "wyscoutId", "heimSpielId", "skillCornerId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "name"]].rename(
             columns={"id": "squadId", "name": "squadName"}
         ),
         left_on="squadId",
@@ -129,6 +129,10 @@ def getSquadIterationScoresFromHost(iteration: int, connection: RateLimitedAPI,
     averages["wyscoutId"] = averages["wyscoutId"].astype("Int64")
     averages["heimSpielId"] = averages["heimSpielId"].astype("Int64")
     averages["skillCornerId"] = averages["skillCornerId"].astype("Int64")
+    averages["optaId"] = averages["optaId"].astype("string")
+    averages["statsPerformId"] = averages["statsPerformId"].astype("string")
+    averages["transfermarktId"] = averages["transfermarktId"].astype("string")
+    averages["soccerdonnaId"] = averages["soccerdonnaId"].astype("string")
 
     # define column order
     order = [
@@ -139,6 +143,10 @@ def getSquadIterationScoresFromHost(iteration: int, connection: RateLimitedAPI,
         "wyscoutId",
         "heimSpielId",
         "skillCornerId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
         "squadName",
         "matches"
     ]

{impectpy-2.5.8 → impectpy-2.5.9}/impectPy/squad_match_scores.py

@@ -221,7 +221,7 @@ def getSquadMatchScoresFromHost(matches: list, connection: RateLimitedAPI, host:
         how="left",
         suffixes=("", "_iterations")
     ).merge(
-        squads[["id", "wyscoutId", "heimSpielId", "skillCornerId", "name"]].rename(
+        squads[["id", "wyscoutId", "heimSpielId", "skillCornerId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "name"]].rename(
             columns={"id": "squadId", "name": "squadName"}
         ),
         left_on="squadId",
@@ -259,6 +259,10 @@ def getSquadMatchScoresFromHost(matches: list, connection: RateLimitedAPI, host:
         "wyscoutId",
         "heimSpielId",
         "skillCornerId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
         "squadName",
         "coachId",
         "coachName"
@@ -283,6 +287,10 @@ def getSquadMatchScoresFromHost(matches: list, connection: RateLimitedAPI, host:
     squad_scores["wyscoutId"] = squad_scores["wyscoutId"].astype("Int64")
     squad_scores["heimSpielId"] = squad_scores["heimSpielId"].astype("Int64")
     squad_scores["skillCornerId"] = squad_scores["skillCornerId"].astype("Int64")
+    squad_scores["optaId"] = squad_scores["optaId"].astype("string")
+    squad_scores["statsPerformId"] = squad_scores["statsPerformId"].astype("string")
+    squad_scores["transfermarktId"] = squad_scores["transfermarktId"].astype("string")
+    squad_scores["soccerdonnaId"] = squad_scores["soccerdonnaId"].astype("string")
 
     # return data
     return squad_scores

{impectpy-2.5.8 → impectpy-2.5.9}/impectPy/squad_matchsums.py

@@ -221,7 +221,7 @@ def getSquadMatchsumsFromHost(matches: list, connection: RateLimitedAPI, host: s
         how="left",
         suffixes=("", "_iterations")
     ).merge(
-        squads[["id", "wyscoutId", "heimSpielId", "skillCornerId", "name"]].rename(
+        squads[["id", "wyscoutId", "heimSpielId", "skillCornerId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "name"]].rename(
             columns={"id": "squadId", "name": "squadName"}
         ),
         left_on="squadId",
@@ -259,6 +259,10 @@ def getSquadMatchsumsFromHost(matches: list, connection: RateLimitedAPI, host: s
         "wyscoutId",
         "heimSpielId",
         "skillCornerId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
         "squadName",
         "coachId",
         "coachName"
@@ -292,6 +296,10 @@ def getSquadMatchsumsFromHost(matches: list, connection: RateLimitedAPI, host: s
     matchsums["wyscoutId"] = matchsums["wyscoutId"].astype("Int64")
     matchsums["heimSpielId"] = matchsums["heimSpielId"].astype("Int64")
     matchsums["skillCornerId"] = matchsums["skillCornerId"].astype("Int64")
+    matchsums["optaId"] = matchsums["optaId"].astype("string")
+    matchsums["statsPerformId"] = matchsums["statsPerformId"].astype("string")
+    matchsums["transfermarktId"] = matchsums["transfermarktId"].astype("string")
+    matchsums["soccerdonnaId"] = matchsums["soccerdonnaId"].astype("string")
 
     # return data
     return matchsums

{impectpy-2.5.8 → impectpy-2.5.9}/impectPy/squad_ratings.py

@@ -85,7 +85,7 @@ def getSquadRatingsFromHost(iteration: int, connection: RateLimitedAPI, host: st
 
     # merge events with squads
     ratings = ratings.merge(
-        squads[["id", "wyscoutId", "heimSpielId", "skillCornerId", "name"]].rename(
+        squads[["id", "wyscoutId", "heimSpielId", "skillCornerId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "name"]].rename(
             columns={"id": "squadId", "name": "squadName"}
         ),
         left_on="squadId",
@@ -101,6 +101,10 @@ def getSquadRatingsFromHost(iteration: int, connection: RateLimitedAPI, host: st
     ratings["wyscoutId"] = ratings["wyscoutId"].astype("Int64")
     ratings["heimSpielId"] = ratings["heimSpielId"].astype("Int64")
     ratings["skillCornerId"] = ratings["skillCornerId"].astype("Int64")
+    ratings["optaId"] = ratings["optaId"].astype("string")
+    ratings["statsPerformId"] = ratings["statsPerformId"].astype("string")
+    ratings["transfermarktId"] = ratings["transfermarktId"].astype("string")
+    ratings["soccerdonnaId"] = ratings["soccerdonnaId"].astype("string")
 
     # define desired column order
     order = [
@@ -115,6 +119,10 @@ def getSquadRatingsFromHost(iteration: int, connection: RateLimitedAPI, host: st
         "wyscoutId",
         "heimSpielId",
         "skillCornerId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
         "squadName",
         "value"
     ]

{impectpy-2.5.8 → impectpy-2.5.9}/impectPy/starting_positions.py

@@ -179,7 +179,7 @@ def getStartingPositionsFromHost(matches: list, connection: RateLimitedAPI, host
     # merge with matches info
     starting_positions = starting_positions.merge(
         matchplan[[
-            "id", "skillCornerId", "heimSpielId", "wyscoutId", "matchDayIndex",
+            "id", "skillCornerId", "heimSpielId", "wyscoutId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "matchDayIndex",
             "matchDayName", "scheduledDate", "lastCalculationDate", "iterationId"
         ]],
         left_on="id",

{impectpy-2.5.8 → impectpy-2.5.9}/impectPy/substitutions.py

@@ -194,7 +194,7 @@ def getSubstitutionsFromHost(matches: list, connection: RateLimitedAPI, host: st
     # merge with matches info
     substitutions = substitutions.merge(
         matchplan[[
-            "id", "skillCornerId", "heimSpielId", "wyscoutId", "matchDayIndex",
+            "id", "skillCornerId", "heimSpielId", "wyscoutId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "matchDayIndex",
             "matchDayName", "scheduledDate", "lastCalculationDate", "iterationId"
         ]],
         left_on="id",

{impectpy-2.5.8 → impectpy-2.5.9}/impectPy.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: impectPy
-Version: 2.5.8
+Version: 2.5.9
 Summary: A Python package to facilitate interaction with the Impect customer API
 Home-page: https://github.com/ImpectAPI/impectPy
 Author: Impect
@@ -25,9 +25,9 @@ Dynamic: summary
 
 A package provided by: Impect GmbH
 
-Version: v2.5.8
+Version: v2.5.9
 
-**Updated: March 19th 2026**
+**Updated: April 9th 2026**
 
 ---
 
@@ -58,7 +58,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.8
+pip install git+https://github.com/ImpectAPI/impectPy.git@v2.5.9
 ```
 
 ## Usage

{impectpy-2.5.8 → impectpy-2.5.9}/impectPy.egg-info/SOURCES.txt

@@ -29,5 +29,4 @@ impectPy.egg-info/PKG-INFO
 impectPy.egg-info/SOURCES.txt
 impectPy.egg-info/dependency_links.txt
 impectPy.egg-info/requires.txt
-impectPy.egg-info/top_level.txt
-tests/test_package.py
+impectPy.egg-info/top_level.txt

{impectpy-2.5.8 → impectpy-2.5.9}/setup.py

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

impectpy-2.5.8/tests/test_package.py

@@ -1,286 +0,0 @@
-# load packages
-import sys
-import importlib
-import logging
-import os
-import re
-import subprocess
-from pathlib import Path
-from tqdm import tqdm
-from dotenv import load_dotenv
-import pandas as pd
-
-execute_functions = False
-
-# branch comparison configuration
-BRANCH_A_NAME = "main"
-BRANCH_B_NAME = "release"
-
-REPO_ROOT = Path(__file__).resolve().parents[1]
-BRANCH_PATHS = {
-    BRANCH_A_NAME: REPO_ROOT,
-    BRANCH_B_NAME: REPO_ROOT,
-}
-
-
-def checkout_branch(branch_name: str):
-    repo_path = BRANCH_PATHS.get(branch_name)
-    if repo_path is None or not repo_path.exists():
-        raise ValueError(f"Unknown branch or missing repo path: '{branch_name}'")
-
-    try:
-        subprocess.run(
-            ["git", "-C", str(repo_path), "fetch"],
-            check=True,
-            stdout=subprocess.DEVNULL
-        )
-        subprocess.run(
-            ["git", "-C", str(repo_path), "checkout", branch_name],
-            check=True,
-            stdout=subprocess.DEVNULL
-        )
-    except subprocess.CalledProcessError as e:
-        print(f"Error checking out branch '{branch_name}' in {repo_path}: {e}")
-
-
-def load_impect(env: str):
-    modules_to_remove = [m for m in sys.modules if m.startswith("impectPy")]
-
-    for module_name in modules_to_remove:
-        del sys.modules[module_name]
-
-    sys.path = [p for p in sys.path if "impectPy" not in p]
-
-    importlib.invalidate_caches()
-
-    repo_root = BRANCH_PATHS.get(env)
-    if repo_root is None:
-        raise ValueError(f"Unknown environment '{env}'. Check BRANCH_PATHS.")
-
-    sys.path.insert(0, str(repo_root))
-    return importlib.import_module("impectPy")
-
-if execute_functions:
-
-    # define login credentials
-    load_dotenv()
-    username = os.getenv("USERNAME")
-    password = os.getenv("PASSWORD")
-
-    # define logger
-    logging.basicConfig(
-        level=logging.ERROR,
-        format="%(asctime)s - %(name)s - %(levelname)s - ID=%(id)s - URL=%(url)s - %(message)s"
-    )
-
-    # define object to be passed onto functions
-    iteration = 1385
-
-    matches = [
-        232434,
-        202485
-    ]
-
-    positions = [
-        "GOALKEEPER",
-        "LEFT_WINGBACK_DEFENDER",
-        "RIGHT_WINGBACK_DEFENDER",
-        "CENTRAL_DEFENDER",
-        "DEFENSE_MIDFIELD",
-        "CENTRAL_MIDFIELD",
-        "ATTACKING_MIDFIELD",
-        "LEFT_WINGER",
-        "RIGHT_WINGER",
-        "CENTER_FORWARD"
-    ]
-
-    # define branches
-    branches = [BRANCH_A_NAME, BRANCH_B_NAME]
-
-    # iterate over envs
-    for branch in branches:
-
-        os.makedirs(f"files/{branch}", exist_ok=True)
-
-        checkout_branch(branch)
-        impectPy = load_impect(branch)
-        print(f"impectPy Version: {impectPy.__version__}")
-
-        config = impectPy.Config()
-        api = impectPy.Impect(config=config)
-        api.login(username, password)
-
-        with tqdm(total=20, desc=f"{branch}: Executing functions...", unit="chunk") as pbar:
-
-            # get iterations
-            iterations = api.getIterations()
-            iterations.to_csv(f"files/{branch}/iterations.csv")
-            pbar.update()
-
-            # get squad ratings
-            ratings = api.getSquadRatings(iteration)
-            ratings.to_csv(f"files/{branch}/ratings.csv")
-            pbar.update()
-
-            # get squad coefficients
-            coefficients = api.getSquadCoefficients(iteration)
-            coefficients.to_csv(f"files/{branch}/coefficients.csv")
-            pbar.update()
-
-            # get matches
-            matchplan = api.getMatches(iteration)
-            matchplan.to_csv(f"files/{branch}/matchplan.csv")
-            pbar.update()
-
-            # get match info
-            formations = api.getFormations(matches)
-            formations.to_csv(f"files/{branch}/formations.csv")
-            pbar.update()
-            substitutions = api.getSubstitutions(matches)
-            substitutions.to_csv(f"files/{branch}/substitutions.csv")
-            pbar.update()
-            startingPositions = api.getStartingPositions(matches)
-            startingPositions.to_csv(f"files/{branch}/startingPositions.csv")
-            pbar.update()
-
-            # get match events
-            events = api.getEvents(matches, include_kpis=True, include_set_pieces=True)
-            events.to_csv(f"files/{branch}/events.csv")
-            pbar.update()
-
-            # get set pieces
-            set_pieces = api.getSetPieces(matches)
-            set_pieces.to_csv(f"files/{branch}/set_pieces.csv")
-            pbar.update()
-
-            # get player iteration averages
-            playerIterationAverages = api.getPlayerIterationAverages(iteration)
-            playerIterationAverages.to_csv(f"files/{branch}/playerIterationAverages.csv")
-            pbar.update()
-
-            # get player matchsums
-            playerMatchsums = api.getPlayerMatchsums(matches)
-            playerMatchsums.to_csv(f"files/{branch}/playerMatchsums.csv")
-            pbar.update()
-
-            # get squad iteration averages
-            squadIterationAverages = api.getSquadIterationAverages(iteration)
-            squadIterationAverages.to_csv(f"files/{branch}/squadIterationAverages.csv")
-            pbar.update()
-
-            # get squad matchsums
-            squadMatchsums = api.getSquadMatchsums(matches)
-            squadMatchsums.to_csv(f"files/{branch}/squadMatchsums.csv")
-            pbar.update()
-
-            # get player match scores
-            playerMatchScores = api.getPlayerMatchScores(matches)
-            playerMatchScores.to_csv(f"files/{branch}/playerMatchScores.csv")
-            pbar.update()
-            playerMatchScores_2 = api.getPlayerMatchScores(matches, positions)
-            playerMatchScores_2.to_csv(f"files/{branch}/playerMatchScores_2.csv")
-            pbar.update()
-
-            # get squad match scores
-            squadMatchScores = api.getSquadMatchScores(matches)
-            squadMatchScores.to_csv(f"files/{branch}/squadMatchScores.csv")
-            pbar.update()
-
-            # get player iteration scores
-            playerIterationScores = api.getPlayerIterationScores(iteration)
-            playerIterationScores.to_csv(f"files/{branch}/playerIterationScores.csv")
-            pbar.update()
-            playerIterationScores_2 = api.getPlayerIterationScores(iteration, positions)
-            playerIterationScores_2.to_csv(f"files/{branch}/playerIterationScores_2.csv")
-            pbar.update()
-
-            # get squad iteration scores
-            squadIterationScores = api.getSquadIterationScores(iteration)
-            squadIterationScores.to_csv(f"files/{branch}/squadIterationScores.csv")
-            pbar.update()
-
-            # get player profile scores
-            playerProfileScores = api.getPlayerProfileScores(iteration, positions)
-            playerProfileScores.to_csv(f"files/{branch}/playerProfileScores.csv")
-            pbar.update()
-
-print("\nRunning auto-diff between source and test outputs...\n")
-
-base_path = Path(__file__).parent / "files"
-source_path = base_path / BRANCH_A_NAME
-test_path = base_path / BRANCH_B_NAME
-
-excluded_columns = [
-    # "playerCountry"
-]
-
-failed = False
-assertion_error_patterns = {
-    "column": re.compile(r'column name="([^"]+)"'),
-    "percentage": re.compile(r'values are different \(([\d.]+)\s*%\)'),
-    "first_diff": re.compile(
-        r'At positional index (\d+), first diff:\s*(.*?)\s*!=\s*(.*)'
-    ),
-}
-
-for src_file in source_path.glob("*.csv"):
-    test_file = test_path / src_file.name
-
-    if not test_file.exists():
-        print(f"[MISSING] {src_file.name} not found in test/")
-        failed = True
-        continue
-
-    src_df = pd.read_csv(src_file, low_memory=False)
-    test_df = pd.read_csv(test_file, low_memory=False)
-
-    src_df = src_df[[col for col in src_df.columns if col not in excluded_columns]]
-    test_df = test_df[[col for col in test_df.columns if col not in excluded_columns]]
-
-    try:
-        pd.testing.assert_frame_equal(
-            src_df,
-            test_df,
-            check_dtype=False,
-            check_like=True
-        )
-        print(f"[OK] {src_file.name}")
-    except AssertionError as e:
-        parsed_error = str(e)
-
-        column = assertion_error_patterns["column"].search(parsed_error).group(1)
-        percentage = float(assertion_error_patterns["percentage"].search(parsed_error).group(1))
-
-        first_diff_match = assertion_error_patterns["first_diff"].search(parsed_error)
-        if first_diff_match:
-            first_diff = {
-                "index": int(first_diff_match.group(1)),
-                "left": first_diff_match.group(2),
-                "right": first_diff_match.group(3),
-            }
-        else:
-            # pandas uses [index]/[left]/[right] array format when all values differ
-            idx_match = re.search(r'\[index\]:\s*\[([^]]+)', parsed_error)
-            left_match = re.search(r'\[left\]:\s*\[([^]]+)', parsed_error)
-            right_match = re.search(r'\[right\]:\s*\[([^]]+)', parsed_error)
-            first_diff = {
-                "index": idx_match.group(1).split(",")[0].strip() if idx_match else "?",
-                "left": left_match.group(1).split(",")[0].strip() if left_match else "?",
-                "right": right_match.group(1).split(",")[0].strip() if right_match else "?",
-            }
-
-        result = {
-            "column": column,
-            "percentage_diff": percentage,
-            "first_diff": first_diff,
-        }
-
-        print(f"[DIFF] {src_file.name} : Column '{result['column']}‘ (Delta: {result['percentage_diff']:.2f}%)') : "
-              f"First Diff at index {result['first_diff']['index']} "
-              f"({result['first_diff']['left']} != {result['first_diff']['right']})")
-        failed = True
-
-if failed:
-    raise AssertionError("Auto-diff failed: source and test outputs differ")
-
-print("\nAll source vs test outputs are identical ✅")