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

{mc5_api_client-1.0.5 → 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.5 → mc5_api_client-1.0.8}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: mc5_api_client
-Version: 1.0.5
+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
@@ -28,9 +28,6 @@ License: MIT License
         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
         SOFTWARE.
         
-Project-URL: Documentation, https://mc5-api-client.readthedocs.io/
-Project-URL: Source, https://pypi.org/project/mc5-api-client/
-Project-URL: Tracker, https://pypi.org/project/mc5-api-client/
 Keywords: modern combat 5,mc5,gameloft,api,client,gaming,authentication,clan,messaging
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
@@ -51,11 +48,33 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Requires-Dist: urllib3>=1.26.0
 Provides-Extra: cli
+Requires-Dist: rich>=13.0.0; extra == "cli"
+Requires-Dist: colorama>=0.4.4; extra == "cli"
 Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: isort>=5.10.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: flake8>=5.0.0; extra == "dev"
+Requires-Dist: pre-commit>=2.20.0; extra == "dev"
+Requires-Dist: build>=0.8.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
 Provides-Extra: docs
+Requires-Dist: sphinx>=5.0.0; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=1.2.0; extra == "docs"
+Requires-Dist: myst-parser>=0.18.0; extra == "docs"
 Provides-Extra: all
-License-File: LICENSE
+Requires-Dist: mc5-api-client[cli,dev,docs]; extra == "all"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
 
 # 🎮 Modern Combat 5 API Client
 
@@ -83,16 +102,178 @@ 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
 
-### 🚀 Install from PyPI
+### 🎉 MC5 API Client v1.0.7 - Revolutionary User-Friendly Interface!
+
+### ✅ **Major Enhancements Completed!**
+
+**� 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
+- ✅ **Dogtag Kicking**: Kick members by 4-8 character dogtags with automatic conversion
+- ✅ **Settings Control**: Complete clan customization (name, logo, colors, limits)
+- ✅ **Real-time Data**: Live member status, XP, scores, and online presence
+
+**🎯 Enhanced Dogtag System:**
+- ✅ **4-8 Character Support**: Flexible dogtag lengths (f55f, 12345678, abcdefgh)
+- ✅ **Smart Conversion**: Automatic dogtag ↔ alias conversion with wraparound
+- ✅ **Player Search**: Find players by dogtag with complete statistics
+- ✅ **Error Handling**: Graceful handling of non-existent dogtags
+- ✅ **Real Examples**: Working with actual MC5 player data
+
+**📊 Verified Working Features:**
+- ✅ **Your Profile**: RxZ Saitama with clan "4"5""5"5"224"
+- ✅ **Dogtag Conversion**: f55f → d33d, 9gg9 → 7ee7, 78d7 → 56b5, 218f → 096d
+- ✅ **Player Lookup**: f55f (17,015 kills), 9gg9 (80 kills), 78d7 (14,648 kills), 218f (636,223 kills)
+- ✅ **Clan Data**: Real member stats, XP, scores, online status
+- ✅ **API Integration**: All endpoints working with proper authentication
+- ✅ **Elite Player Access**: Successfully retrieved stats for high-kill players (636K+ kills)
 
 ```bash
 pip install mc5_api_client
 ```
 
-✅ **Published and Available!** The MC5 API Client is now live on PyPI and ready for worldwide use!
+✅ **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
 
@@ -188,9 +369,37 @@ except:
 
 ### 🏰 Complete Clan Management
 
-If you run a clan, you can manage it programmatically with 20+ methods:
+If you run a clan, you can manage it programmatically with comprehensive features:
 
 ```python
+# Get your profile and clan info
+profile = client.get_profile()
+clan_id = profile['groups'][0]  # Your clan ID
+
+# Get clan members
+members = client.get_clan_members(clan_id)
+for member in members:
+    print(f"{member['name']} - XP: {member['_xp']} - Status: {member['status']}")
+
+# Update clan settings
+client.update_clan_settings(
+    clan_id=clan_id,
+    name="Elite Squad",
+    description="Best clan ever!",
+    member_limit="50",
+    logo="1",
+    logo_primary_color="12722475",
+    membership="owner_approved"
+)
+
+# Kick member by dogtag
+result = client.kick_clan_member_by_dogtag(
+    dogtag="9gg9",
+    clan_id=clan_id,
+    from_name="CLAN_ADMIN",
+    kill_sign_name="default_killsig_42"
+)
+
 # Search for clans
 clans = client.search_clans("Elite", limit=10)
 for clan in clans:
@@ -209,12 +418,6 @@ clan_id = new_clan.get('id')
 clan_info = client.get_clan_settings(clan_id)
 print(f"Clan: {clan_info['name']}")
 
-# Update clan settings
-client.update_clan_settings(clan_id, {
-    "description": "Welcome to our awesome squad!",
-    "membership_type": "invite_only"
-})
-
 # Manage members
 members = client.get_clan_members(clan_id)
 print(f"Found {len(members)} members")
@@ -903,20 +1106,24 @@ The library comes with comprehensive examples to get you started:
 - ✅ Update profile information
 - ✅ Profile statistics
 
-### 🏰 Clan Management (20+ Methods)
+### 🏰 Clan Management & Profile Operations (15+ Methods)
+- ✅ Get user profile with groups and credentials
+- ✅ Update player profile (name, groups, games data)
+- ✅ Get clan information and settings
+- ✅ Get clan members with detailed stats
+- ✅ Update clan settings (name, description, logo, colors, limits)
 - ✅ Search for clans
 - ✅ Create new clans
-- ✅ Get clan information
-- ✅ Update clan settings
-- ✅ Manage clan members
-- ✅ Invite/kick members
-- ✅ Promote/demote members
-- ✅ Handle applications
+- ✅ Manage clan members (invite, kick, promote, demote)
+- ✅ Handle clan applications
 - ✅ Join/leave clans
-- ✅ Get clan statistics
-- ✅ Internal leaderboards
-- ✅ Transfer ownership
+- ✅ Get clan statistics and leaderboards
+- ✅ Transfer clan ownership
 - ✅ Disband clans
+- ✅ Kick members by dogtag (4-8 characters)
+- ✅ Kick members by credential/fed_id
+- ✅ Customizable kick messages and kill signs
+- ✅ Real-time member status monitoring
 
 ### 👥 Squad/Group Management (10+ Methods)
 - ✅ Get squad members with stats
@@ -949,29 +1156,148 @@ The library comes with comprehensive examples to get you started:
 - ✅ Support for cross-platform data transfer
 - ✅ Account verification and validation
 
-### 📊 Player Statistics & Batch Profiles
+### 🎯 Enhanced Player Search & Dogtag System
 
-Get detailed player statistics using dogtags (in-game IDs) or credentials:
+Search players using their in-game dogtags (4-8 characters) with automatic conversion:
 
 ```python
-# Search player by their in-game dogtag
+# Search player by their in-game dogtag (4-8 characters supported)
 player_stats = client.get_player_stats_by_dogtag("f55f")
-print(f"Player found: {player_stats.get('player_info', {}).get('account', 'Unknown')}")
-
-# Parse and analyze statistics
-parsed = client.parse_player_stats(player_stats)
-print(f"Rating: {parsed.get('rating', 0)}")
-print(f"K/D Ratio: {parsed.get('overall_stats', {}).get('total_kills', 0) / max(parsed.get('overall_stats', {}).get('total_deaths', 1), 1):.2f}")
+if 'error' not in player_stats:
+    player_credential = list(player_stats.keys())[0]
+    player_data = player_stats[player_credential]
+    print(f"Player found: {player_data.get('player_info', {}).get('account', 'Unknown')}")
+    
+    # Parse and analyze statistics
+    parsed = client.parse_player_stats(player_stats)
+    overall = parsed.get('overall_stats', {})
+    print(f"Rating: {parsed.get('rating', 0)}")
+    print(f"Total Kills: {overall.get('total_kills', 0):,}")
+    print(f"K/D Ratio: {overall.get('kd_ratio', 0):.2f}")
+    print(f"Headshot %: {overall.get('headshot_percentage', 0):.1f}%")
+else:
+    print(f"Player not found: {player_stats['error']}")
+
+# Test different dogtag formats
+test_dogtags = ["f55f", "1234", "5678", "12345678", "abcdefgh", "9gg9"]
+
+for dogtag in test_dogtags:
+    try:
+        # Convert dogtag to alias
+        alias = client.convert_dogtag_to_alias(dogtag)
+        print(f"Dogtag: {dogtag} → Alias: {alias}")
+        
+        # Convert back to verify
+        back_to_dogtag = client.convert_alias_to_dogtag(alias)
+        print(f"Alias: {alias} → Dogtag: {back_to_dogtag}")
+        
+        # Search for player
+        player = client.get_player_stats_by_dogtag(dogtag)
+        if 'error' not in player:
+            parsed = client.parse_player_stats(player)
+            kills = parsed.get('overall_stats', {}).get('total_kills', 0)
+            print(f"✅ Found: {kills:,} kills")
+        else:
+            print(f"❌ Not found")
+            
+    except Exception as e:
+        print(f"❌ Error with {dogtag}: {e}")
 
 # Get detailed stats for multiple players
 credentials = ["player1_cred", "player2_cred", "player3_cred"]
 batch_stats = client.get_batch_profiles(credentials)
 
-# Search players using dogtags
-for dogtag in ["f55f", "ff11", "g6765"]:
-    player = client.search_player_by_dogtag(dogtag)
-    if 'error' not in player:
-        print(f"Found: {player.get('player_info', {}).get('account')}")
+# Parse multiple players at once
+for credential, stats in batch_stats.items():
+    parsed = client.parse_player_stats({credential: stats})
+    print(f"Player: {parsed.get('rating', 0)} rating")
+```
+
+### 🔨 Advanced Clan Member Management
+
+Complete clan management with dogtag-based member operations:
+
+```python
+# Complete clan management workflow
+from mc5_api_client import MC5Client
+
+client = MC5Client('YOUR_USERNAME', 'YOUR_PASSWORD')
+
+# Get your profile and clan info
+profile = client.get_profile()
+clan_id = profile['groups'][0]  # Your clan ID
+
+# Get clan members with detailed stats
+members = client.get_clan_members(clan_id)
+print(f"Found {len(members)} members:")
+
+for member in members:
+    print(f"  {member['name']}")
+    print(f"    Status: {member.get('status', 'Unknown')}")
+    print(f"    XP: {member.get('_xp', 'Unknown')}")
+    print(f"    Score: {member.get('_score', 'Unknown')}")
+    print(f"    Kill Sign: {member.get('_killsig_id', 'Unknown')}")
+    print(f"    Online: {'🟢' if member.get('online') else '🔴'}")
+
+# Update clan settings with all options
+client.update_clan_settings(
+    clan_id=clan_id,
+    name="Elite Squad",
+    description="Best clan ever!",
+    rating="3573",
+    score="5200",
+    member_limit="300",
+    membership="owner_approved",  # open, owner_approved, member_approved, closed
+    logo="1",
+    logo_primary_color="12722475",  # 0-16777215
+    logo_secondary_color="16777215",  # 0-16777215
+    min_join_value="996699",
+    xp="9999",  # Max 10000
+    currency="10000",
+    killsig_id="default_killsig_01",
+    active_clan_label="true",
+    active_member_count="2",
+    active_clan_threshold="50"
+)
+
+# Kick member by dogtag (4-8 characters)
+result = client.kick_clan_member_by_dogtag(
+    dogtag="9gg9",
+    clan_id=clan_id,
+    from_name="CLAN_ADMIN",
+    kill_sign_name="default_killsig_42",
+    kill_sign_color="-974646126"
+)
+
+if 'error' in result:
+    print(f"Kick failed: {result['error']}")
+else:
+    print(f"Kick successful: {result}")
+
+# Kick member directly using credential
+result = client.kick_clan_member(
+    target_fed_id="anonymous:player_credential",
+    clan_id=clan_id,
+    from_name="SQUAD_LEADER",
+    kill_sign_name="default_killsig_80",
+    kill_sign_color="-123456789"
+)
+
+# Get clan information
+clan_info = client.get_clan_info(clan_id)
+print(f"Clan: {clan_info.get('name', 'Unknown')}")
+print(f"Description: {clan_info.get('description', 'Unknown')}")
+print(f"Rating: {clan_info.get('_rating', 'Unknown')}")
+print(f"Member Count: {clan_info.get('member_count', 'Unknown')}")
+
+# Update your own profile
+client.update_profile(
+    name="Elite Player",
+    groups=clan_id,  # Update clan membership
+    games='{"1875": {"last_time_played": 1758644983}}'
+)
+
+client.close()
 ```
 
 ### 📊 Player Statistics & Batch Profiles (6+ Methods)