mc5-api-client 1.0.3__py3-none-any.whl → 1.0.4__py3-none-any.whl

mc5_api_client/client.py

@@ -1724,6 +1724,183 @@ class MC5Client:
         
         return config_data
     
+    # Batch Operations
+    
+    def get_batch_profiles(self, credentials: List[str], include_fields: List[str] = None) -> Dict[str, Any]:
+        """
+        Get batch player profiles with detailed statistics and game save data.
+        
+        Args:
+            credentials: List of player credentials to fetch
+            include_fields: List of fields to include (default: ['_game_save', 'inventory'])
+            
+        Returns:
+            Dictionary with player profiles containing detailed statistics
+        """
+        if include_fields is None:
+            include_fields = ['_game_save', 'inventory']
+        
+        url = "https://app-468561b3-9ecd-4d21-8241-30ed288f4d8b.gold0009.gameloft.com/1875/windows/09/public/OfficialScripts/mc5Portal.wsgi"
+        
+        data = {
+            'op_code': 'get_batch_profiles',
+            'client_id': self.client_id,
+            'credentials': ','.join(credentials),
+            'pandora': f"https://vgold-eur.gameloft.com/{self.client_id}",
+            'include_fields': ','.join(include_fields)
+        }
+        
+        headers = {
+            'Accept': '*/*',
+            'Content-Type': 'application/x-www-form-urlencoded',
+            'accept-encoding': 'identity'
+        }
+        
+        return self._make_request("POST", url, data=data, headers=headers)
+    
+    def get_player_stats_by_dogtag(self, dogtag: str) -> Dict[str, Any]:
+        """
+        Get detailed player statistics using their dogtag (in-game ID).
+        
+        Args:
+            dogtag: Player's dogtag in XXXX format (hexadecimal)
+            
+        Returns:
+            Player statistics and profile information
+        """
+        # Convert dogtag to alias for API lookup
+        alias = self.convert_dogtag_to_alias(dogtag)
+        
+        # Get player info using alias
+        player_info = self.get_alias_info(alias)
+        if not player_info.get('credential'):
+            return {'error': f'Player not found for dogtag: {dogtag}', 'alias': alias}
+        
+        # Get detailed stats using the credential
+        try:
+            stats = self.get_batch_profiles([player_info['credential']])
+            
+            # Add dogtag and alias info to the response
+            if player_info['credential'] in stats:
+                stats[player_info['credential']]['dogtag'] = dogtag
+                stats[player_info['credential']]['alias'] = alias
+                stats[player_info['credential']]['player_info'] = player_info
+            
+            return stats
+            
+        except Exception as e:
+            return {
+                'error': f'Failed to get stats for dogtag {dogtag}: {e}',
+                'dogtag': dogtag,
+                'alias': alias,
+                'player_info': player_info
+            }
+    
+    def search_player_by_dogtag(self, dogtag: str) -> Dict[str, Any]:
+        """
+        Search for a player using their dogtag and return their profile information.
+        
+        Args:
+            dogtag: Player's dogtag in XXXX format (hexadecimal)
+            
+        Returns:
+            Complete player information including stats if found
+        """
+        return self.get_player_stats_by_dogtag(dogtag)
+    
+    def get_player_detailed_stats(self, credential: str) -> Dict[str, Any]:
+        """
+        Get detailed player statistics including game save and inventory.
+        
+        Args:
+            credential: Player's credential
+            
+        Returns:
+            Detailed player statistics and game data
+        """
+        return self.get_batch_profiles([credential])
+    
+    def parse_player_stats(self, stats_data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Parse and structure player statistics for easier consumption.
+        
+        Args:
+            stats_data: Raw stats data from get_batch_profiles
+            
+        Returns:
+            Structured player statistics
+        """
+        if not stats_data or not isinstance(stats_data, dict):
+            return {'error': 'Invalid stats data'}
+        
+        # Get the first (and likely only) player's data
+        player_credential = list(stats_data.keys())[0] if stats_data else None
+        if not player_credential or player_credential not in stats_data:
+            return {'error': 'No player data found'}
+        
+        player_data = stats_data[player_credential]
+        
+        # Extract game save data
+        game_save = player_data.get('_game_save', {})
+        inventory = player_data.get('inventory', {})
+        
+        # Parse statistics
+        parsed_stats = {
+            'credential': player_credential,
+            'rating': game_save.get('rating', 0),
+            'rating_duel': game_save.get('rating_duel', 0),
+            'rating_last': game_save.get('rating_last', 0),
+            'current_skill': game_save.get('current_skill', 'unknown'),
+            'current_weapon': game_save.get('current_weapon', 'unknown'),
+            'current_loadout': game_save.get('current_loadout', 0),
+            'kill_signature': game_save.get('killsig', {}),
+            'progress': game_save.get('progress', []),
+            'loadouts': game_save.get('loadouts', []),
+            'statistics': game_save.get('statistics', {}),
+            'inventory': inventory,
+            'xp': inventory.get('xp', 0),
+            'vip_points': inventory.get('vip_points', 0)
+        }
+        
+        # Parse weapon statistics
+        weapons = inventory.get('weapons', {})
+        weapon_stats = []
+        
+        for weapon_id, weapon_data in weapons.items():
+            if isinstance(weapon_data, dict):
+                weapon_stats.append({
+                    'id': weapon_id,
+                    'kills': weapon_data.get('kills', 0),
+                    'shots': weapon_data.get('shots', 0),
+                    'hits': weapon_data.get('hits', 0),
+                    'score': weapon_data.get('score', 0),
+                    'time_used': weapon_data.get('time_used', 0)
+                })
+        
+        # Sort by kills
+        weapon_stats.sort(key=lambda x: x['kills'], reverse=True)
+        parsed_stats['weapon_stats'] = weapon_stats
+        
+        # Parse overall statistics
+        stats = game_save.get('statistics', {})
+        if stats:
+            sp_stats = stats.get('sp', {})
+            mp_stats = stats.get('mp', {})
+            
+            parsed_stats['overall_stats'] = {
+                'total_kills': sp_stats.get('kill.total', 0) + mp_stats.get('kill.total', 0),
+                'total_deaths': sp_stats.get('death.total', 0) + mp_stats.get('death.total', 0),
+                'total_headshots': sp_stats.get('kill.headshots', 0) + mp_stats.get('kill.headshots', 0),
+                'total_assists': sp_stats.get('kill.assists', 0) + mp_stats.get('kill.assists', 0),
+                'total_time_played': sp_stats.get('time.played', 0) + mp_stats.get('time.played', 0),
+                'sp_kills': sp_stats.get('kill.total', 0),
+                'mp_kills': mp_stats.get('kill.total', 0),
+                'sp_headshots': sp_stats.get('kill.headshots', 0),
+                'mp_headshots': mp_stats.get('kill.headshots', 0)
+            }
+        
+        return parsed_stats
+    
     def __enter__(self):
         """Context manager entry."""
         return self

{mc5_api_client-1.0.3.dist-info → mc5_api_client-1.0.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: mc5-api-client
-Version: 1.0.3
+Version: 1.0.4
 Summary: A comprehensive Python library for interacting with the Modern Combat 5 API
 Home-page: https://pypi.org/project/mc5-api-client/
 Author: Chizoba
@@ -960,6 +960,7 @@ The library comes with comprehensive examples to get you started:
 - `examples/private_messaging.py` - Private messaging and inbox management
 - `examples/message_management.py` - Advanced message management and bulk deletion
 - `examples/advanced_features.py` - Events, account management, alias system, game config
+- `examples/player_stats.py` - Player statistics, batch profiles, dogtag search
 
 ### 🚀 Advanced Examples
 - Squad management bot with automated updates
@@ -1028,14 +1029,44 @@ The library comes with comprehensive examples to get you started:
 - ✅ Support for cross-platform data transfer
 - ✅ Account verification and validation
 
-### 🏷️ Alias/Dogtags System (4+ Methods)
-- ✅ Convert dogtags to alias format
-- ✅ Convert aliases back to dogtags
-- ✅ Get player information using alias/dogtag
-- ✅ Search for players by alias
-- ✅ Support for hexadecimal player IDs
-- ✅ Automatic format detection
-- ✅ Mathematical conversion algorithms
+### 📊 Player Statistics & Batch Profiles
+
+Get detailed player statistics using dogtags (in-game IDs) or credentials:
+
+```python
+# Search player by their in-game dogtag
+player_stats = client.get_player_stats_by_dogtag("f55f")
+print(f"Player found: {player_stats.get('player_info', {}).get('account', 'Unknown')}")
+
+# Parse and analyze statistics
+parsed = client.parse_player_stats(player_stats)
+print(f"Rating: {parsed.get('rating', 0)}")
+print(f"K/D Ratio: {parsed.get('overall_stats', {}).get('total_kills', 0) / max(parsed.get('overall_stats', {}).get('total_deaths', 1), 1):.2f}")
+
+# Get detailed stats for multiple players
+credentials = ["player1_cred", "player2_cred", "player3_cred"]
+batch_stats = client.get_batch_profiles(credentials)
+
+# Search players using dogtags
+for dogtag in ["f55f", "ff11", "g6765"]:
+    player = client.search_player_by_dogtag(dogtag)
+    if 'error' not in player:
+        print(f"Found: {player.get('player_info', {}).get('account')}")
+```
+
+### 📊 Player Statistics & Batch Profiles (6+ Methods)
+- ✅ Get batch player profiles with detailed statistics
+- ✅ Search players by dogtag (in-game ID)
+- ✅ Get detailed player statistics using credentials
+- ✅ Parse and structure player statistics
+- ✅ Convert dogtags to aliases for API lookup
+- ✅ Combine alias lookup with stats retrieval
+- ✅ Support for multiple player batch operations
+- ✅ Detailed game save and inventory data access
+- ✅ Weapon statistics and performance analysis
+- ✅ Campaign progress tracking
+- ✅ Overall statistics calculation (K/D, accuracy, etc.)
+- ✅ Player performance analysis tools
 
 ### ⚙️ Game Configuration (4+ Methods)
 - ✅ Get asset hash metadata

{mc5_api_client-1.0.3.dist-info → mc5_api_client-1.0.4.dist-info}/RECORD

@@ -1,12 +1,12 @@
 mc5_api_client/__init__.py,sha256=VtZ8P-CwnjHSq6VmSuBwVttNXIK3qoOrFuNxXMVeaMc,1021
 mc5_api_client/auth.py,sha256=Yj_6s8KmtbswWbR6q816d8soIirUF2aD_KWxg-jNqR0,9978
 mc5_api_client/cli.py,sha256=KegNTxwq28gu_vrffc_cXcALrHzUBDHd-5DqKyYp4p0,17284
-mc5_api_client/client.py,sha256=JJxXvPZMJh_Gfp_tO-X2cBmLlbWb-V3zp5RgDT71hsI,58264
+mc5_api_client/client.py,sha256=dHngiS2KgLBJ_WF2Xb0kMAOkWsLggH9jkM2Hz1W0m-w,65469
 mc5_api_client/exceptions.py,sha256=o7od4GrEIlgq6xSNUjZdh74xoDTytF3PLcMq5ewRiJw,2683
 mc5_api_client/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mc5_api_client-1.0.3.dist-info/LICENSE,sha256=M0UBQ4B3pB9XcV54_jhVP681xyauF8GB6YK_rKmuXzk,1064
-mc5_api_client-1.0.3.dist-info/METADATA,sha256=Z6-UrwQ13kJ4n0RmEkWIbbOb6aaZvkFDaY5E9VU_URo,35719
-mc5_api_client-1.0.3.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
-mc5_api_client-1.0.3.dist-info/entry_points.txt,sha256=2kruOpleFYK3Jl1MoQwGyqCd-Pj4kQWngXmIjnXx_gE,48
-mc5_api_client-1.0.3.dist-info/top_level.txt,sha256=eYJe4ue9j1ig_jFY5Z05mDqpizUEV7TYpk5lBXVd4kA,15
-mc5_api_client-1.0.3.dist-info/RECORD,,
+mc5_api_client-1.0.4.dist-info/LICENSE,sha256=M0UBQ4B3pB9XcV54_jhVP681xyauF8GB6YK_rKmuXzk,1064
+mc5_api_client-1.0.4.dist-info/METADATA,sha256=oyW9LIWxY9Ov5aAkzRD6JcxUHgEOu0DpcYtIPvNo3vE,37125
+mc5_api_client-1.0.4.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
+mc5_api_client-1.0.4.dist-info/entry_points.txt,sha256=2kruOpleFYK3Jl1MoQwGyqCd-Pj4kQWngXmIjnXx_gE,48
+mc5_api_client-1.0.4.dist-info/top_level.txt,sha256=eYJe4ue9j1ig_jFY5Z05mDqpizUEV7TYpk5lBXVd4kA,15
+mc5_api_client-1.0.4.dist-info/RECORD,,