mc5-api-client 1.0.18__py3-none-any.whl → 1.0.20__py3-none-any.whl

mc5_api_client/__init__.py

@@ -15,7 +15,7 @@ messaging, and more.
 
 from typing import Optional, Dict, Any
 
-__version__ = "1.0.18"
+__version__ = "1.0.20"
 __author__ = "Chizoba"
 __email__ = "chizoba2026@hotmail.com"
 __license__ = "MIT"
@@ -87,6 +87,9 @@ from .client import MC5Client
 from .auth import TokenGenerator
 from .exceptions import MC5APIError, AuthenticationError, RateLimitError
 from .help import help, examples, quick_reference
+
+# Add MC5ApiClient as an alias for backward compatibility
+MC5ApiClient = MC5Client
 from .admin_client import (
     AdminMC5Client,
     create_admin_client,
@@ -322,6 +325,7 @@ def encrypt_token(
 
 __all__ = [
     "MC5Client",
+    "MC5ApiClient",
     "SimpleMC5Client",
     "AdminMC5Client",
     "batch_search_players",

mc5_api_client/client.py

@@ -1573,31 +1573,84 @@ class MC5Client(SquadBattleMixin, FederationMixin, AlertsMixin, AccountMixin, Tr
     
     # Utility Methods
     
-    def get_token_info(self) -> Dict[str, Any]:
+    def close(self):
+        """Close the HTTP session and cleanup resources."""
+        if self.session:
+            self.session.close()
+        if self.token_generator:
+            self.token_generator.close()
+    
+    # Server Status Methods (for compatibility)
+    
+    def get_server_status(self) -> Dict[str, Any]:
         """
-        Get current token information.
+        Get server status information.
         
         Returns:
-            Token data
+            Dictionary with server status
         """
-        self._ensure_valid_token()
-        return self._token_data.copy()
+        try:
+            # Try to get events as a basic connectivity test
+            events = self.get_events()
+            return {
+                "status": "online",
+                "message": "MC5 servers are online",
+                "events_count": len(events),
+                "timestamp": time.time()
+            }
+        except Exception as e:
+            return {
+                "status": "offline",
+                "message": f"Server status check failed: {str(e)}",
+                "timestamp": time.time()
+            }
     
-    def is_authenticated(self) -> bool:
+    def get_online_players(self) -> Dict[str, Any]:
         """
-        Check if client is authenticated with valid token.
+        Get online players information (estimated).
         
         Returns:
-            True if authenticated, False otherwise
+            Dictionary with online player count
         """
-        return self._token_data is not None and self.token_generator.validate_token(self._token_data)
+        try:
+            # Get events as a proxy for activity
+            events = self.get_events()
+            # This is an estimate - actual player count isn't directly available
+            return {
+                "online_players": "Unknown",
+                "active_events": len(events),
+                "message": "Player count not directly available via API",
+                "timestamp": time.time()
+            }
+        except Exception as e:
+            return {
+                "online_players": 0,
+                "error": str(e),
+                "timestamp": time.time()
+            }
     
-    def close(self):
-        """Close the HTTP session and cleanup resources."""
-        if self.session:
-            self.session.close()
-        if self.token_generator:
-            self.token_generator.close()
+    def get_server_info(self) -> Dict[str, Any]:
+        """
+        Get general server information.
+        
+        Returns:
+            Dictionary with server information
+        """
+        try:
+            return {
+                "server": "Modern Combat 5",
+                "region": "Europe",
+                "api_version": "1.0.18",
+                "endpoints": list(self.BASE_URLS.keys()),
+                "client_id": self.client_id,
+                "authenticated": bool(self.access_token),
+                "timestamp": time.time()
+            }
+        except Exception as e:
+            return {
+                "error": str(e),
+                "timestamp": time.time()
+            }
     
     # Events API
     

{mc5_api_client-1.0.18.dist-info → mc5_api_client-1.0.20.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mc5_api_client
-Version: 1.0.18
+Version: 1.0.20
 Summary: A comprehensive Python library for interacting with the Modern Combat 5 API
 Home-page: https://pypi.org/project/mc5-api-client/
 Author: Chizoba
@@ -143,10 +143,109 @@ Think of this as your remote control for Modern Combat 5! Here's what you can do
 ### 🎉 MC5 API Client v1.0.18 - Super Easy Interface & Clean API!
 
 ```bash
-pip install mc5_api_client==1.0.18
+pip install mc5_api_client==1.0.20
 ```
 
-### ✅ **Major Features Completed!**
+## 🎯 **Usage Examples**
+
+### **🎮 Basic Usage (MC5Client)**
+```python
+from mc5_api_client import MC5Client
+
+# Initialize the client
+client = MC5Client(
+    client_id="1875:55979:6.0.0a:windows:windows",
+    username="your_credential",
+    password="your_password"
+)
+
+# Authenticate
+client.authenticate()
+
+# Get profile
+profile = client.get_profile()
+print(f"Profile: {profile}")
+
+# Get events
+events = client.get_events()
+print(f"Events: {len(events)} found")
+
+# Server status (NEW!)
+status = client.get_server_status()
+print(f"Server Status: {status['status']}")
+
+# Close connection
+client.close()
+```
+
+### **🎯 MC5ApiClient (Backward Compatible)**
+```python
+from mc5_api_client import MC5ApiClient
+
+# MC5ApiClient is an alias for MC5Client
+client = MC5ApiClient(
+    client_id="1875:55979:6.0.0a:windows:windows",
+    username="your_credential",
+    password="your_password"
+)
+
+# Use the same methods as MC5Client
+client.authenticate()
+status = client.get_server_status()
+info = client.get_server_info()
+```
+
+### **🔧 Quick Functions (Standalone)**
+```python
+from mc5_api_client import quick_get_account_info, quick_get_active_sessions
+
+# Quick functions are standalone, not client methods
+# They require credentials as parameters
+account_info = quick_get_account_info("your_credential", "your_password")
+sessions = quick_get_active_sessions("your_password")
+```
+
+### **🎮 Game Launch & Service Location (NEW!)**
+```python
+from mc5_api_client import MC5Easy, get_all_services, create_federation_session
+
+# Get all MC5 services dynamically
+services = get_all_services()
+print(f"Found {len(services)} services:")
+for service, endpoint in services.items():
+    print(f"  {service}: {endpoint}")
+
+# Create federation session for game launch
+session = create_federation_session(username, password)
+if session.get("success"):
+    print(f"Room ID: {session['room_id']}")
+    print(f"Controller: {session['controller_host']}")
+
+# Or use MC5Easy for complete game management
+with MC5Easy(username, password) as mc5:
+    launch_info = mc5.launch_game_session()
+    print(f"Game ready: {launch_info['launch_command']}")
+```
+
+### **🌐 Global ID & Device Management (NEW!)**
+```python
+from mc5_api_client import get_global_id, generate_device_id
+
+# Get global device ID
+global_id = get_global_id()
+print(f"Global ID: {global_id}")
+
+# Generate unique device ID
+device_id = generate_device_id()
+print(f"Device ID: {device_id}")
+
+# With MC5Easy
+with MC5Easy(username, password) as mc5:
+    device_info = mc5.get_device_info()
+    print(f"Device: {device_info}")
+```
+
+## 📱 **Run Examples:** Completed!
 
 **🎯 Super Easy Interface (NEW in v1.0.18):**
 - ✅ **MC5Easy Module** - One-line functions for everyday tasks
@@ -1348,8 +1447,6 @@ finally:
 **Security Benefits:**
 - ✅ **Additional Layer**: Tokens are encrypted before transmission
 - ✅ **Custom Nonce**: Support for custom nonce values
-- ✅ **Backward Compatible**: Works with existing authentication flow
-- ✅ **Error Handling**: Proper validation and error recovery
 
 ### 🏆 **Checking Leaderboards**
 
@@ -1369,7 +1466,6 @@ if hasattr(client, 'get_leaderboard'):
     # print(f"Top {len(leaderboard.get('players', []))} players")
 else:
     print("❌ get_leaderboard method not found")
-```
 
 ### 🖥️ CLI Commands - Currently Available
 

{mc5_api_client-1.0.18.dist-info → mc5_api_client-1.0.20.dist-info}/RECORD

@@ -1,4 +1,4 @@
-mc5_api_client/__init__.py,sha256=7wJM7SwHhMCIJ7SRwnN3tOkqPILAdzkkUJfVE01A8FY,11838
+mc5_api_client/__init__.py,sha256=lxGygRXrG6aUTZ_Em_TLyMzMxR7ylTXgXOhA5OEXfnM,11942
 mc5_api_client/account.py,sha256=EmydXCsCXaKqMw21oVttQfYuDl50pa2dwhcTeHtnxbQ,14396
 mc5_api_client/account_quick.py,sha256=t4ki4ujYENmcnd_004f0pO9SPxPyCllz4WHpBG9wNbo,10458
 mc5_api_client/admin_client.py,sha256=527aavolxVhY2M5ceFxVbbE5YTczU9Z86Fdt1UzdRZM,15220
@@ -6,7 +6,7 @@ mc5_api_client/alerts.py,sha256=zW-cEwSSShuHkGxTBQaS8Ynf1a0hh5RMQ0G3WC_ajI0,1322
 mc5_api_client/alerts_quick.py,sha256=D1j0RiHteYqoAgc4KYqTxYG1Hkud3b-xWRV_VOUEnY0,7946
 mc5_api_client/auth.py,sha256=z8vmyQIHUdAzk0pUyKCesT8gTv4jboLIFGBxAu1v_-8,13396
 mc5_api_client/cli.py,sha256=6xciRjWkUMOxgxlbDsoOiHRuirXPy7uc9WURXPKmgGc,17255
-mc5_api_client/client.py,sha256=MUAlgRJy3kcDSAW2uvsERqqCd0vEYNuml3w2gMDfHB4,110785
+mc5_api_client/client.py,sha256=EWL0IWiP9mwr9GTnnzWwTKHZUPe2LXaY7YxzjKTDjWM,112524
 mc5_api_client/debug.py,sha256=524vNCE7jM_KP5JM81-3eI2cmFBBA-Hf7Uy0cIL75W0,8240
 mc5_api_client/easy_mc5.py,sha256=kfjOJMW-VRAZcXEF1yHiGsACgjb-ZjXGuw1U_gepSQY,24202
 mc5_api_client/exceptions.py,sha256=o7od4GrEIlgq6xSNUjZdh74xoDTytF3PLcMq5ewRiJw,2683
@@ -24,9 +24,9 @@ mc5_api_client/storage_admin.py,sha256=l-nwskbpa3KpeIoWcwVRicgBSvrTvQ5aE2QU_e366
 mc5_api_client/telemetry.py,sha256=k8qOimPg-AKsnMclIgeqYCJ_97j2pWyiN7Lg80D4sKo,13246
 mc5_api_client/transfer.py,sha256=-pln70360mo4cKBQIUzp_wt9ce1Cr4YA6aJDFPKEjzQ,14381
 mc5_api_client/transfer_quick.py,sha256=HhRbp4FVzFwuzHDcqOyYiVjeVEIfgezlWd8SN6sh874,11310
-mc5_api_client-1.0.18.dist-info/licenses/LICENSE,sha256=M0UBQ4B3pB9XcV54_jhVP681xyauF8GB6YK_rKmuXzk,1064
-mc5_api_client-1.0.18.dist-info/METADATA,sha256=nXAbbhArh5dld974gzL1Za7d-TYuEmuqDLGwmg4s4JE,80598
-mc5_api_client-1.0.18.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-mc5_api_client-1.0.18.dist-info/entry_points.txt,sha256=2kruOpleFYK3Jl1MoQwGyqCd-Pj4kQWngXmIjnXx_gE,48
-mc5_api_client-1.0.18.dist-info/top_level.txt,sha256=eYJe4ue9j1ig_jFY5Z05mDqpizUEV7TYpk5lBXVd4kA,15
-mc5_api_client-1.0.18.dist-info/RECORD,,
+mc5_api_client-1.0.20.dist-info/licenses/LICENSE,sha256=M0UBQ4B3pB9XcV54_jhVP681xyauF8GB6YK_rKmuXzk,1064
+mc5_api_client-1.0.20.dist-info/METADATA,sha256=jcN6JTeojDPA5C_0U9l1_bCcwKNwkPNbf-1s17Uci3w,83121
+mc5_api_client-1.0.20.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+mc5_api_client-1.0.20.dist-info/entry_points.txt,sha256=2kruOpleFYK3Jl1MoQwGyqCd-Pj4kQWngXmIjnXx_gE,48
+mc5_api_client-1.0.20.dist-info/top_level.txt,sha256=eYJe4ue9j1ig_jFY5Z05mDqpizUEV7TYpk5lBXVd4kA,15
+mc5_api_client-1.0.20.dist-info/RECORD,,