mc5-api-client 1.0.19__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.19"
+__version__ = "1.0.20"
 __author__ = "Chizoba"
 __email__ = "chizoba2026@hotmail.com"
 __license__ = "MIT"

{mc5_api_client-1.0.19.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.19
+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.19.dist-info → mc5_api_client-1.0.20.dist-info}/RECORD

@@ -1,4 +1,4 @@
-mc5_api_client/__init__.py,sha256=dwst7ePR-608bLju9sGSZ5XE_5KkyUI3BJJITktpcsU,11942
+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
@@ -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.19.dist-info/licenses/LICENSE,sha256=M0UBQ4B3pB9XcV54_jhVP681xyauF8GB6YK_rKmuXzk,1064
-mc5_api_client-1.0.19.dist-info/METADATA,sha256=eTEmXuKWRw8Z6wtY4bVAtGljnBB_G667PT2wGfnuEuY,80598
-mc5_api_client-1.0.19.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-mc5_api_client-1.0.19.dist-info/entry_points.txt,sha256=2kruOpleFYK3Jl1MoQwGyqCd-Pj4kQWngXmIjnXx_gE,48
-mc5_api_client-1.0.19.dist-info/top_level.txt,sha256=eYJe4ue9j1ig_jFY5Z05mDqpizUEV7TYpk5lBXVd4kA,15
-mc5_api_client-1.0.19.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,,