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

{mc5_api_client-1.0.18 → mc5_api_client-1.0.20}/PKG-INFO

@@ -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 → 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.18 → 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.18"
+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.18 → 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.18",
+    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.18 → 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.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-1.0.18 → mc5_api_client-1.0.20}/src/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 → 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.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 → mc5_api_client-1.0.20}/src/mc5_api_client.egg-info/SOURCES.txt

@@ -1,11 +1,8 @@
 .gitignore
-CHANGELOG.md
 LICENSE
 MANIFEST.in
 README.md
 pyproject.toml
-pytest.ini
-requirements-dev.txt
 requirements.txt
 setup.py
 examples/admin_squad_management.py

mc5_api_client-1.0.18/CHANGELOG.md

@@ -1,332 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [1.0.8] - 2026-02-03
-
-### 🤖 Major Release - Advanced Automation & Loop-Based Operations
-
-#### 🔄 Revolutionary Loop-Based Operations
-- ✅ **Batch Search**: Search multiple players with automatic loops and conditional processing
-- ✅ **Smart Clan Cleanup**: Intelligent member management with safety checks and conditional logic
-- ✅ **Real-time Monitoring**: While loops for continuous clan activity tracking with alerts
-- ✅ **Automated Workflows**: Complete automation sequences with decision-making capabilities
-- ✅ **Conditional Processing**: Smart filtering based on player stats, level, and activity
-
-#### 🧠 Advanced Conditional Logic System
-- ✅ **Safety Checks**: Protect high-level members (configurable level thresholds)
-- ✅ **Role Protection**: Safeguard leaders, admins, and officers from automated actions
-- ✅ **Dynamic Decisions**: Make intelligent choices based on clan composition and statistics
-- ✅ **Error Recovery**: Graceful handling of failures with continue/break logic
-- ✅ **Smart Filtering**: Categorize members automatically (elite, active, veterans, newbies, inactive)
-
-#### 📊 New Advanced Functions
-- ✅ **batch_search_players()**: Search multiple dogtags with loop and conditional processing
-- ✅ **clan_cleanup()**: Comprehensive clan analysis with intelligent recommendations
-- ✅ **monitor_clan_activity()**: Real-time monitoring with while loops and conditional alerts
-- ✅ **get_inactive_members()**: Identify inactive members with configurable criteria
-- ✅ **auto_kick_inactive_members()**: Safe automated kicking with dry-run mode
-
-#### 🎯 Advanced Use Cases Enabled
-- ✅ **Elite Player Recruitment**: Batch search and filter for high-kill players
-- ✅ **Clan Health Analysis**: Calculate health scores and provide recommendations
-- ✅ **Activity Trend Monitoring**: Track clan activity patterns over time
-- ✅ **Automated Member Management**: Smart categorization and processing
-- ✅ **Performance Metrics**: Statistical analysis and reporting
-
-#### 🔧 Technical Improvements
-- ✅ **Enhanced Error Handling**: Robust try-catch blocks with graceful recovery
-- ✅ **Memory Management**: Automatic cleanup and resource management
-- ✅ **Performance Optimization**: Efficient batch processing and lazy loading
-- ✅ **Safety Features**: Dry-run modes and protection mechanisms
-- ✅ **Documentation**: Complete examples and advanced usage guides
-
-#### 📚 Comprehensive Documentation
-- ✅ **Advanced Examples**: Complete automation examples with loops and conditionals
-- ✅ **Use Case Scenarios**: Real-world applications for clan management
-- ✅ **Safety Guidelines**: Best practices for automated operations
-- ✅ **Technical Reference**: Detailed function documentation
-
-#### 🎮 Real-World Automation Examples
-```python
-# Batch search with conditional logic
-results = batch_search_players(['f55f', '9gg9', '218f'], username, password)
-for player in results['found']:
-    if player['kills'] > 10000:
-        print(f"🌟 Elite: {player['dogtag']} - {player['kills']:,} kills")
-
-# Smart clan cleanup with safety
-results = clan_cleanup(username, password, inactive_days=30, min_level=15, dry_run=True)
-if results['would_kick'] > 0:
-    print("⚠️ Consider removing inactive members")
-
-# Real-time monitoring with while loops
-monitor_clan_activity(username, password, check_interval=60, max_checks=10)
-```
-
-#### 🛡️ Safety & Protection Features
-- ✅ **Dry Run Mode**: Test operations without executing actual changes
-- ✅ **Level Thresholds**: Configurable minimum level protection
-- ✅ **Role Protection**: Automatic safeguarding of important clan roles
-- ✅ **Conditional Logic**: Smart decision-making to prevent mistakes
-- ✅ **Error Boundaries**: Isolated failure handling for individual operations
-
----
-
-### 🎮 Major Release - User-Friendly Interface for Non-Developers
-
-#### 🌟 SimpleMC5Client - Revolutionary Easy Interface
-- ✅ **New SimpleMC5Client**: Designed specifically for non-developers
-- ✅ **Auto-Clan Detection**: Automatically finds clan ID from user profile
-- ✅ **Simplified Method Names**: `search_player()` instead of `get_player_stats_by_dogtag()`
-- ✅ **One-Liner Functions**: `quick_search()` and `quick_kick()` for instant results
-- ✅ **Context Manager Support**: Automatic cleanup with `with` statements
-- ✅ **Lazy Authentication**: Only connects when needed, not on initialization
-- ✅ **User-Friendly Error Messages**: Clear, helpful explanations for beginners
-
-#### 📚 Comprehensive Documentation for Beginners
-- ✅ **User Friendly Guide**: Complete beginner's guide with step-by-step instructions
-- ✅ **Simple Usage Examples**: Copy-paste ready code for common tasks
-- ✅ **Syntax Comparison Table**: Simple vs Advanced methods side-by-side
-- ✅ **FAQ Section**: Common questions and answers for non-developers
-- ✅ **Real-World Examples**: Clan management, player search, messaging
-
-#### 🎯 Perfect for Non-Technical Users
-- ✅ **Clan Leaders**: Easy member management without technical knowledge
-- ✅ **Players**: Quick stats lookup with just a dogtag
-- ✅ **Beginners**: No programming experience required
-- ✅ **Quick Tasks**: One-liner functions for common operations
-
-#### 📊 Simple vs Advanced Comparison
-| Task | Simple Version | Advanced Version |
-|------|----------------|------------------|
-| Search Player | `client.search_player('f55f')` | `client.get_player_stats_by_dogtag('f55f')` |
-| Get Clan Members | `client.get_clan_members()` | `client.get_clan_members(clan_id)` |
-| Kick Member | `client.kick_member('9gg9')` | `client.kick_clan_member_by_dogtag('9gg9', clan_id)` |
-| Connect | `client.connect()` | Manual authentication |
-
-#### 🔧 Technical Improvements
-- ✅ **Backward Compatibility**: All existing advanced features still available
-- ✅ **Graceful Error Handling**: User-friendly error messages
-- ✅ **Memory Management**: Automatic connection cleanup
-- ✅ **Import Updates**: SimpleMC5Client added to main package exports
-
-#### 🎮 Real-World Usage Examples
-```python
-# Super simple - just 3 lines!
-from mc5_api_client import SimpleMC5Client
-client = SimpleMC5Client('YOUR_USERNAME', 'YOUR_PASSWORD')
-client.connect()
-player = client.search_player('f55f')
-
-# One-liner search
-from mc5_api_client import quick_search
-player = quick_search('218f', 'YOUR_USERNAME', 'YOUR_PASSWORD')
-
-# Easy clan management
-with SimpleMC5Client('YOUR_USERNAME', 'YOUR_PASSWORD') as client:
-    client.connect()  # Auto-finds your clan!
-    members = client.get_clan_members()
-    client.kick_member('9gg9', 'Inactive for 30 days')
-```
-
----
-
-## [1.0.5] - 2026-02-03
-
-### 🔧 Critical Bug Fix
-
-#### 🌐 Fixed Missing API Endpoint
-- ✅ Added missing `janus` URL to BASE_URLS configuration
-- ✅ Fixed player lookup by alias/dogtag functionality
-- ✅ Resolved `'janus'` KeyError in alias lookup methods
-- ✅ All batch profile functionality now working correctly
-
-#### 🧪 Verified Functionality
-- ✅ Dogtag to alias conversion: f55f → d33d ✅
-- ✅ Player lookup by alias: Working perfectly ✅
-- ✅ Batch profile retrieval: Successfully tested ✅
-- ✅ Dogtag search with stats: Rating 800, K/D 14.75 ✅
-- ✅ Statistics parsing: All data structured correctly ✅
-
-#### 📚 Updated Documentation
-- ✅ Added dogtag search example to quick start guide
-- ✅ Enhanced README with working batch profile examples
-- ✅ Updated feature list with verified functionality
-- ✅ Added real test results to documentation
-
-#### 🎯 Real-World Test Results
-- **Test Player**: Dogtag f55f → Alias d33d
-- **Rating**: 800
-- **K/D Ratio**: 14.75 (Excellent!)
-- **Total Kills**: 59
-- **Total Headshots**: 16
-- **XP**: 4,439
-- **Account ID**: 9f2905fe-d346-11ef-8471-b8ca3a67cd10
-
-## [1.0.4] - 2026-02-03
-
-### 🚀 Player Statistics & Batch Profiles Feature
-
-#### 📊 Batch Profile System (6+ Methods)
-- ✅ Get batch player profiles with detailed statistics and game save data
-- ✅ Search players by dogtag (in-game ID) with automatic alias conversion
-- ✅ Get detailed player statistics using credentials
-- ✅ Parse and structure player statistics for easy consumption
-- ✅ Combine alias lookup with stats retrieval
-- ✅ Support for multiple player batch operations
-- ✅ Access detailed game save data including progress, loadouts, weapons
-- ✅ Weapon statistics and performance analysis
-- ✅ Campaign progress tracking
-- ✅ Overall statistics calculation (K/D ratios, accuracy, etc.)
-- ✅ Player performance analysis tools
-
-#### 🏷️ Enhanced Alias/Dogtags Integration
-- ✅ Seamless integration between dogtag conversion and player lookup
-- ✅ Automatic dogtag to alias conversion for API calls
-- ✅ Combined dogtag search with detailed statistics retrieval
-- ✅ Enhanced error handling for invalid dogtags
-- ✅ Support for all dogtag formats with validation
-
-#### 📚 New Example Script
-- ✅ Added `examples/player_stats.py` with comprehensive demonstrations
-- ✅ Real-world usage scenarios for player analytics
-- ✅ Performance analysis and weapon statistics examples
-- ✅ Batch operations and multi-player lookup examples
-- ✅ Advanced usage patterns for player data analysis
-
-#### 📖 Enhanced Documentation
-- ✅ Added Player Statistics section to README
-- ✅ Detailed usage examples for batch profiles
-- ✅ Integration examples with alias/dogtag system
-- ✅ Performance analysis and statistics parsing examples
-- ✅ Updated feature list with new batch profile methods
-
-#### 🔧 Code Quality Improvements
-- ✅ Comprehensive error handling for batch operations
-- ✅ Robust data parsing and validation
-- ✅ Type hints for all new methods
-- ✅ Detailed docstrings with examples
-- ✅ Support for edge cases and malformed data
-
-#### 🧪 Testing & Validation
-- ✅ All new methods tested with real API endpoints
-- ✅ Error scenarios handled gracefully
-- ✅ Performance optimization for batch operations
-- ✅ Memory-efficient data parsing
-
-### 📋 Technical Details
-
-#### 🌐 New API Endpoint Integration
-- **Endpoint**: `https://app-468561b3-9ecd-4d21-8241-30ed288f4d8b.gold0009.gameloft.com/1875/windows/09/public/OfficialScripts/mc5Portal.wsgi`
-- **Method**: POST with form-encoded data
-- **Operation**: `get_batch_profiles`
-- **Fields**: `_game_save`, `inventory` (configurable)
-- **Authentication**: Uses existing client authentication
-
-#### 🔄 Dogtag to Alias Conversion
-- **Mathematical Algorithm**: Letters (ASCII -2), Digits (mod 10 arithmetic)
-- **Validation**: Automatic format detection and error handling
-- **Integration**: Seamless conversion for API compatibility
-- **Examples**: f55f → d33d, ff11 → dd99, g6765 → e4543
-
-#### 📊 Data Structure Parsing
-- **Game Save Data**: Rating, progress, loadouts, statistics
-- **Inventory Data**: XP, VIP points, weapon statistics
-- **Weapon Stats**: Kills, shots, hits, accuracy, time used
-- **Overall Stats**: K/D ratios, headshot percentages, time played
-
-## [1.0.3] - 2026-02-02
-
-### Added
-- Initial release of MC5 API Client by Chizoba
-- Comprehensive authentication system with token generation
-- Support for both user and admin authentication
-- Modern CLI interface with Rich formatting and debug capabilities
-- Full API coverage including:
-  - Profile management
-  - Clan operations
-  - Friend management
-  - Messaging system
-  - Events and tasks
-  - Leaderboard access
-  - Game objects
-  - Asset metadata
-  - Alias lookup
-- Automatic token refresh functionality
-- Comprehensive error handling with custom exceptions
-- Type hints throughout the codebase
-- Extensive documentation and examples
-- Unit test coverage
-- PyPI package configuration
-- Development environment setup
-- Python 3.11+ support (beta version)
-
-### Features
-- **Authentication**: Easy token generation and management
-- **CLI**: Rich command-line interface with progress indicators
-- **Auto-refresh**: Automatic token renewal
-- **Error Handling**: Comprehensive exception hierarchy
-- **Type Safety**: Full type annotation support
-- **Documentation**: Detailed README and examples
-- **Testing**: Unit tests with mocking
-- **Configuration**: Persistent config and token storage
-
-### CLI Commands
-- `generate-token` - Generate user access tokens
-- `generate-admin-token` - Generate admin access tokens
-- `validate-token` - Validate saved tokens
-- `show-config` - Display configuration
-- `clear-config` - Clear saved data
-
-### API Endpoints Supported
-- Authentication (Janus)
-- Profile management (Osiris)
-- Clan operations (Osiris)
-- Friend system (Osiris)
-- Messaging (Osiris)
-- Events (Osiris)
-- Leaderboards (Osiris/Olympus)
-- Game objects (Iris)
-- Asset metadata (Iris)
-- Alias lookup (Janus)
-
-### Installation
-```bash
-pip install mc5-api-client
-```
-
-### Development Installation
-```bash
-pip install mc5-api-client[dev]
-```
-
-### Example Usage
-```python
-from mc5_api_client import MC5Client
-
-with MC5Client(username="user", password="pass") as client:
-    profile = client.get_profile()
-    events = client.get_events()
-    client.send_private_message("target", "Hello!")
-```
-
-### CLI Usage
-```bash
-mc5 generate-token --username "user" --password "pass" --save
-mc5 validate-token
-mc5 show-config
-```
-
----
-
-## [Unreleased]
-
-### Planned
-- Additional API endpoints
-- Enhanced CLI features
-- Performance optimizations
-- More examples and tutorials

mc5_api_client-1.0.18/pytest.ini

@@ -1,16 +0,0 @@
-[tool:pytest]
-testpaths = tests
-python_files = test_*.py
-python_classes = Test*
-python_functions = test_*
-addopts = 
-    --verbose
-    --tb=short
-    --strict-markers
-    --disable-warnings
-    --color=yes
-markers =
-    slow: marks tests as slow (deselect with '-m "not slow"')
-    integration: marks tests as integration tests
-    unit: marks tests as unit tests
-    network: marks tests that require network access

mc5_api_client-1.0.18/requirements-dev.txt

@@ -1,25 +0,0 @@
-# Development dependencies
--r requirements.txt
-
-# Testing
-pytest>=7.0.0
-pytest-cov>=4.0.0
-pytest-mock>=3.10.0
-
-# Code quality
-black>=22.0.0
-isort>=5.10.0
-mypy>=1.0.0
-flake8>=5.0.0
-
-# Pre-commit hooks
-pre-commit>=2.20.0
-
-# Building and distribution
-build>=0.8.0
-twine>=4.0.0
-
-# Documentation
-sphinx>=5.0.0
-sphinx-rtd-theme>=1.2.0
-myst-parser>=0.18.0