mc5-api-client 1.0.5__py3-none-any.whl → 1.0.8__py3-none-any.whl

{mc5_api_client-1.0.5.dist-info → mc5_api_client-1.0.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
-Name: mc5-api-client
-Version: 1.0.5
+Metadata-Version: 2.4
+Name: mc5_api_client
+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
@@ -54,8 +51,6 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: requests>=2.28.0
 Requires-Dist: urllib3>=1.26.0
-Provides-Extra: all
-Requires-Dist: mc5-api-client[cli,dev,docs]; extra == "all"
 Provides-Extra: cli
 Requires-Dist: rich>=13.0.0; extra == "cli"
 Requires-Dist: colorama>=0.4.4; extra == "cli"
@@ -74,6 +69,12 @@ 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
+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
 
@@ -101,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
 
@@ -206,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:
@@ -227,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")
@@ -921,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
@@ -967,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)

mc5_api_client-1.0.8.dist-info/RECORD

@@ -0,0 +1,13 @@
+mc5_api_client/__init__.py,sha256=S6NeWp0J02LoCdUh0vqmgOmY-G0QLDR-1-z9_onBu9k,1435
+mc5_api_client/auth.py,sha256=Yj_6s8KmtbswWbR6q816d8soIirUF2aD_KWxg-jNqR0,9978
+mc5_api_client/cli.py,sha256=KegNTxwq28gu_vrffc_cXcALrHzUBDHd-5DqKyYp4p0,17284
+mc5_api_client/client.py,sha256=q5PkdpTXjWCXdLFiK1-zqa7fThJGE4Z99A3ccMfwJIY,79239
+mc5_api_client/exceptions.py,sha256=o7od4GrEIlgq6xSNUjZdh74xoDTytF3PLcMq5ewRiJw,2683
+mc5_api_client/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mc5_api_client/simple_client.py,sha256=31JI2rURHIXKcnDXQYJNpr-gypweO56ANFdhD-Z4Ft0,20241
+mc5_api_client-1.0.8.dist-info/licenses/LICENSE,sha256=M0UBQ4B3pB9XcV54_jhVP681xyauF8GB6YK_rKmuXzk,1064
+mc5_api_client-1.0.8.dist-info/METADATA,sha256=VzsdMhgnwtLnbQJUBOPElbBIPJeOLN97inFTsN18vIo,46848
+mc5_api_client-1.0.8.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+mc5_api_client-1.0.8.dist-info/entry_points.txt,sha256=2kruOpleFYK3Jl1MoQwGyqCd-Pj4kQWngXmIjnXx_gE,48
+mc5_api_client-1.0.8.dist-info/top_level.txt,sha256=eYJe4ue9j1ig_jFY5Z05mDqpizUEV7TYpk5lBXVd4kA,15
+mc5_api_client-1.0.8.dist-info/RECORD,,

{mc5_api_client-1.0.5.dist-info → mc5_api_client-1.0.8.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.45.1)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

mc5_api_client-1.0.5.dist-info/RECORD

@@ -1,12 +0,0 @@
-mc5_api_client/__init__.py,sha256=VtZ8P-CwnjHSq6VmSuBwVttNXIK3qoOrFuNxXMVeaMc,1021
-mc5_api_client/auth.py,sha256=Yj_6s8KmtbswWbR6q816d8soIirUF2aD_KWxg-jNqR0,9978
-mc5_api_client/cli.py,sha256=KegNTxwq28gu_vrffc_cXcALrHzUBDHd-5DqKyYp4p0,17284
-mc5_api_client/client.py,sha256=Ha9BMIsNpabd7-SPCqcIl5beeuyQnLPEJB8AVCg472k,65520
-mc5_api_client/exceptions.py,sha256=o7od4GrEIlgq6xSNUjZdh74xoDTytF3PLcMq5ewRiJw,2683
-mc5_api_client/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mc5_api_client-1.0.5.dist-info/LICENSE,sha256=M0UBQ4B3pB9XcV54_jhVP681xyauF8GB6YK_rKmuXzk,1064
-mc5_api_client-1.0.5.dist-info/METADATA,sha256=KMtXbEbXHSuGOIfPTigMVZdRdGvLXT9GZGLsun6sJos,35725
-mc5_api_client-1.0.5.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
-mc5_api_client-1.0.5.dist-info/entry_points.txt,sha256=2kruOpleFYK3Jl1MoQwGyqCd-Pj4kQWngXmIjnXx_gE,48
-mc5_api_client-1.0.5.dist-info/top_level.txt,sha256=eYJe4ue9j1ig_jFY5Z05mDqpizUEV7TYpk5lBXVd4kA,15
-mc5_api_client-1.0.5.dist-info/RECORD,,