mc5-api-client 1.0.6__tar.gz → 1.0.8__tar.gz

{mc5_api_client-1.0.6 → mc5_api_client-1.0.8}/CHANGELOG.md

@@ -5,6 +5,136 @@ 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

{mc5_api_client-1.0.6 → mc5_api_client-1.0.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mc5_api_client
-Version: 1.0.6
+Version: 1.0.8
 Summary: A comprehensive Python library for interacting with the Modern Combat 5 API
 Home-page: https://pypi.org/project/mc5-api-client/
 Author: Chizoba
@@ -102,14 +102,26 @@ Think of this as your remote control for Modern Combat 5! Here's what you can do
 - 🖥️ **Modern CLI**: A beautiful command-line tool with colors and emojis
 - 🔄 **Auto-Refresh**: Tokens refresh automatically - no interruptions!
 - 🛡️ **Error Handling**: Get helpful error messages when things go wrong
+- 🎮 **NEW: Simple Interface**: Perfect for non-developers with auto-clan detection!
+- ⚡ **NEW: One-Liner Functions**: Quick search and kick operations!
+- 🎯 **NEW: User-Friendly**: Designed for beginners and clan leaders!
 
 ## � Installation & Publishing
 
-### 🎉 MC5 API Client v1.0.5 - Enhanced Clan Management & Dogtag System!
+### 🎉 MC5 API Client v1.0.7 - Revolutionary User-Friendly Interface!
 
 ### ✅ **Major Enhancements Completed!**
 
-**🏰 Complete Clan Management Suite:**
+**� Revolutionary Simple Interface (NEW in v1.0.7):**
+- ✅ **SimpleMC5Client**: Designed specifically for non-developers
+- ✅ **Auto-Clan Detection**: Automatically finds clan ID from your profile
+- ✅ **One-Liner Functions**: `quick_search()` and `quick_kick()` for instant results
+- ✅ **Simplified Method Names**: `search_player()` instead of complex technical names
+- ✅ **Context Manager Support**: Automatic cleanup with `with` statements
+- ✅ **User-Friendly Documentation**: Complete beginner's guide with examples
+- ✅ **No Technical Knowledge Required**: Perfect for clan leaders and players
+
+**� Complete Clan Management Suite:**
 - ✅ **Profile Management**: Get/update player profiles with groups and credentials
 - ✅ **Clan Operations**: Get clan info, members, settings with full CRUD operations
 - ✅ **Member Management**: Invite, kick, promote, demote members with detailed stats
@@ -136,7 +148,132 @@ Think of this as your remote control for Modern Combat 5! Here's what you can do
 pip install mc5_api_client
 ```
 
-✅ **Published and Available!** The MC5 API Client v1.0.6 is now live on PyPI with enhanced clan management and dogtag features!
+✅ **Published and Available!** The MC5 API Client v1.0.7 is now live on PyPI with revolutionary user-friendly features for non-developers!
+
+## 🎮 **Simple Usage for Non-Developers**
+
+New in v1.0.7! We've added a revolutionary super-simple interface for non-developers:
+
+### **🚀 Quick Start - Just 3 Lines!**
+
+```python
+from mc5_api_client import SimpleMC5Client
+
+# Connect and auto-detect your clan
+client = SimpleMC5Client('YOUR_USERNAME', 'YOUR_PASSWORD')
+client.connect()
+
+# Search for any player by dogtag
+player = client.search_player('f55f')
+print(f"Found: {player['kills']:,} kills")
+```
+
+### **🎯 Super Simple Examples:**
+
+**Search Players:**
+```python
+# One-line search
+from mc5_api_client import quick_search
+player = quick_search('218f', 'YOUR_USERNAME', 'YOUR_PASSWORD')
+print(f"Elite player: {player['kills']:,} kills!")
+```
+
+**Batch Search with Loop:**
+```python
+from mc5_api_client.simple_client import batch_search_players
+
+dogtags = ['f55f', '9gg9', '78d7', '218f']
+results = batch_search_players(dogtags, 'YOUR_USERNAME', 'YOUR_PASSWORD')
+
+# Conditional processing
+for player in results['found']:
+    if player['kills'] > 10000:
+        print(f"🌟 Elite: {player['dogtag']} - {player['kills']:,} kills")
+    else:
+        print(f"👤 Player: {player['dogtag']} - {player['kills']:,} kills")
+```
+
+**Smart Clan Cleanup:**
+```python
+from mc5_api_client.simple_client import clan_cleanup
+
+# Intelligent cleanup with conditional logic
+results = clan_cleanup(
+    'YOUR_USERNAME', 'YOUR_PASSWORD',
+    inactive_days=30,
+    min_level=15,  # Protect high-level players
+    dry_run=True   # Simulation only
+)
+
+print(f"Would kick: {results['would_kick']} members")
+print(f"Protected: {results['protected']} members")
+
+if results['would_kick'] > 0:
+    print("⚠️ Consider removing inactive members")
+```
+
+**Real-time Monitoring:**
+```python
+from mc5_api_client.simple_client import monitor_clan_activity
+
+# Monitor clan activity every 60 seconds for 10 checks
+monitor_clan_activity(
+    'YOUR_USERNAME', 'YOUR_PASSWORD',
+    check_interval=60,
+    max_checks=10
+)
+```
+
+**Clan Management:**
+```python
+with SimpleMC5Client('YOUR_USERNAME', 'YOUR_PASSWORD') as client:
+    client.connect()  # Auto-detects your clan!
+    
+    # Get all clan members
+    members = client.get_clan_members()
+    print(f"Your clan has {len(members)} members")
+    
+    # Kick by dogtag (no clan ID needed!)
+    client.kick_member('9gg9', 'Inactive for 30 days')
+    
+    # Update clan settings
+    client.update_clan_settings(name="Elite Squad 2026")
+```
+
+**Send Messages:**
+```python
+with SimpleMC5Client('YOUR_USERNAME', 'YOUR_PASSWORD') as client:
+    client.connect()
+    
+    # Send message to any player by dogtag
+    client.send_message('f55f', 'Want to play together?')
+```
+
+### **✨ Key Benefits for Non-Developers:**
+
+- ✅ **No Clan ID Needed**: Auto-detects your clan from your profile
+- ✅ **Simple Method Names**: `search_player()` instead of `get_player_stats_by_dogtag()`
+- ✅ **Auto-Connection**: Just call `connect()` once
+- ✅ **Clear Error Messages**: User-friendly error descriptions
+- ✅ **Context Manager**: Automatic cleanup with `with` statement
+- ✅ **Quick Functions**: One-liners for common tasks
+
+### **📚 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 |
+
+### **🎯 Perfect For:**
+- **Clan Leaders**: Easy member management
+- **Players**: Quick stats lookup
+- **Beginners**: No programming experience needed
+- **Quick Tasks**: One-liner functions
+
+---
 
 ### 📦 Install from Local Package
 

{mc5_api_client-1.0.6 → mc5_api_client-1.0.8}/README.md

@@ -24,14 +24,26 @@ Think of this as your remote control for Modern Combat 5! Here's what you can do
 - 🖥️ **Modern CLI**: A beautiful command-line tool with colors and emojis
 - 🔄 **Auto-Refresh**: Tokens refresh automatically - no interruptions!
 - 🛡️ **Error Handling**: Get helpful error messages when things go wrong
+- 🎮 **NEW: Simple Interface**: Perfect for non-developers with auto-clan detection!
+- ⚡ **NEW: One-Liner Functions**: Quick search and kick operations!
+- 🎯 **NEW: User-Friendly**: Designed for beginners and clan leaders!
 
 ## � Installation & Publishing
 
-### 🎉 MC5 API Client v1.0.5 - Enhanced Clan Management & Dogtag System!
+### 🎉 MC5 API Client v1.0.7 - Revolutionary User-Friendly Interface!
 
 ### ✅ **Major Enhancements Completed!**
 
-**🏰 Complete Clan Management Suite:**
+**� Revolutionary Simple Interface (NEW in v1.0.7):**
+- ✅ **SimpleMC5Client**: Designed specifically for non-developers
+- ✅ **Auto-Clan Detection**: Automatically finds clan ID from your profile
+- ✅ **One-Liner Functions**: `quick_search()` and `quick_kick()` for instant results
+- ✅ **Simplified Method Names**: `search_player()` instead of complex technical names
+- ✅ **Context Manager Support**: Automatic cleanup with `with` statements
+- ✅ **User-Friendly Documentation**: Complete beginner's guide with examples
+- ✅ **No Technical Knowledge Required**: Perfect for clan leaders and players
+
+**� Complete Clan Management Suite:**
 - ✅ **Profile Management**: Get/update player profiles with groups and credentials
 - ✅ **Clan Operations**: Get clan info, members, settings with full CRUD operations
 - ✅ **Member Management**: Invite, kick, promote, demote members with detailed stats
@@ -58,7 +70,132 @@ Think of this as your remote control for Modern Combat 5! Here's what you can do
 pip install mc5_api_client
 ```
 
-✅ **Published and Available!** The MC5 API Client v1.0.6 is now live on PyPI with enhanced clan management and dogtag features!
+✅ **Published and Available!** The MC5 API Client v1.0.7 is now live on PyPI with revolutionary user-friendly features for non-developers!
+
+## 🎮 **Simple Usage for Non-Developers**
+
+New in v1.0.7! We've added a revolutionary super-simple interface for non-developers:
+
+### **🚀 Quick Start - Just 3 Lines!**
+
+```python
+from mc5_api_client import SimpleMC5Client
+
+# Connect and auto-detect your clan
+client = SimpleMC5Client('YOUR_USERNAME', 'YOUR_PASSWORD')
+client.connect()
+
+# Search for any player by dogtag
+player = client.search_player('f55f')
+print(f"Found: {player['kills']:,} kills")
+```
+
+### **🎯 Super Simple Examples:**
+
+**Search Players:**
+```python
+# One-line search
+from mc5_api_client import quick_search
+player = quick_search('218f', 'YOUR_USERNAME', 'YOUR_PASSWORD')
+print(f"Elite player: {player['kills']:,} kills!")
+```
+
+**Batch Search with Loop:**
+```python
+from mc5_api_client.simple_client import batch_search_players
+
+dogtags = ['f55f', '9gg9', '78d7', '218f']
+results = batch_search_players(dogtags, 'YOUR_USERNAME', 'YOUR_PASSWORD')
+
+# Conditional processing
+for player in results['found']:
+    if player['kills'] > 10000:
+        print(f"🌟 Elite: {player['dogtag']} - {player['kills']:,} kills")
+    else:
+        print(f"👤 Player: {player['dogtag']} - {player['kills']:,} kills")
+```
+
+**Smart Clan Cleanup:**
+```python
+from mc5_api_client.simple_client import clan_cleanup
+
+# Intelligent cleanup with conditional logic
+results = clan_cleanup(
+    'YOUR_USERNAME', 'YOUR_PASSWORD',
+    inactive_days=30,
+    min_level=15,  # Protect high-level players
+    dry_run=True   # Simulation only
+)
+
+print(f"Would kick: {results['would_kick']} members")
+print(f"Protected: {results['protected']} members")
+
+if results['would_kick'] > 0:
+    print("⚠️ Consider removing inactive members")
+```
+
+**Real-time Monitoring:**
+```python
+from mc5_api_client.simple_client import monitor_clan_activity
+
+# Monitor clan activity every 60 seconds for 10 checks
+monitor_clan_activity(
+    'YOUR_USERNAME', 'YOUR_PASSWORD',
+    check_interval=60,
+    max_checks=10
+)
+```
+
+**Clan Management:**
+```python
+with SimpleMC5Client('YOUR_USERNAME', 'YOUR_PASSWORD') as client:
+    client.connect()  # Auto-detects your clan!
+    
+    # Get all clan members
+    members = client.get_clan_members()
+    print(f"Your clan has {len(members)} members")
+    
+    # Kick by dogtag (no clan ID needed!)
+    client.kick_member('9gg9', 'Inactive for 30 days')
+    
+    # Update clan settings
+    client.update_clan_settings(name="Elite Squad 2026")
+```
+
+**Send Messages:**
+```python
+with SimpleMC5Client('YOUR_USERNAME', 'YOUR_PASSWORD') as client:
+    client.connect()
+    
+    # Send message to any player by dogtag
+    client.send_message('f55f', 'Want to play together?')
+```
+
+### **✨ Key Benefits for Non-Developers:**
+
+- ✅ **No Clan ID Needed**: Auto-detects your clan from your profile
+- ✅ **Simple Method Names**: `search_player()` instead of `get_player_stats_by_dogtag()`
+- ✅ **Auto-Connection**: Just call `connect()` once
+- ✅ **Clear Error Messages**: User-friendly error descriptions
+- ✅ **Context Manager**: Automatic cleanup with `with` statement
+- ✅ **Quick Functions**: One-liners for common tasks
+
+### **📚 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 |
+
+### **🎯 Perfect For:**
+- **Clan Leaders**: Easy member management
+- **Players**: Quick stats lookup
+- **Beginners**: No programming experience needed
+- **Quick Tasks**: One-liner functions
+
+---
 
 ### 📦 Install from Local Package