mc5-api-client 1.0.19__tar.gz → 1.0.20__tar.gz

{mc5_api_client-1.0.19/src/mc5_api_client.egg-info → mc5_api_client-1.0.20}/PKG-INFO

@@ -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 → mc5_api_client-1.0.20}/README.md

@@ -65,10 +65,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
@@ -1270,8 +1369,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**
 
@@ -1291,7 +1388,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 → mc5_api_client-1.0.20}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mc5_api_client"
-version = "1.0.19"
+version = "1.0.20"
 description = "A comprehensive Python library for interacting with the Modern Combat 5 API"
 readme = "README.md"
 license = {file = "LICENSE"}

{mc5_api_client-1.0.19 → mc5_api_client-1.0.20}/setup.py

@@ -33,7 +33,7 @@ def read_requirements():
 setup(
     name="mc5_api_client",
     use_scm_version=False,
-    version="1.0.19",
+    version="1.0.20",
     description="A comprehensive Python library for interacting with the Modern Combat 5 API",
     long_description=read_readme(),
     long_description_content_type="text/markdown",

{mc5_api_client-1.0.19 → mc5_api_client-1.0.20}/src/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 → mc5_api_client-1.0.20/src/mc5_api_client.egg-info}/PKG-INFO

@@ -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