mc5-api-client 1.0.22__py3-none-any.whl → 1.0.23__py3-none-any.whl

mc5_api_client/__init__.py

@@ -15,7 +15,7 @@ messaging, and more.
 
 from typing import Optional, Dict, Any
 
-__version__ = "1.0.22"
+__version__ = "1.0.23"
 __author__ = "Chizoba"
 __email__ = "chizoba2026@hotmail.com"
 __license__ = "MIT"
@@ -442,6 +442,15 @@ __all__ = [
     "customize_squad_theme",
     "set_squad_level",
     "customize_squad_complete",
+    "quick_set_name",
+    "quick_set_rating",
+    "quick_set_member_limit",
+    "quick_set_colors",
+    "quick_set_level",
+    "quick_set_currency",
+    "quick_setup_professional_squad",
+    "quick_setup_gaming_squad",
+    "quick_reset_to_defaults",
     "generate_device_id",
     "create_federation_session",
     "locate_service",

mc5_api_client/client.py

@@ -2038,6 +2038,161 @@ class MC5Client(SquadBattleMixin, FederationMixin, AlertsMixin, AccountMixin, Tr
         # Apply updates
         return self.update_my_squad_info(**kwargs)
     
+    # Quick Squad Customization Functions (NEW!)
+    
+    def quick_set_name(self, name: str) -> Dict[str, Any]:
+        """
+        Quickly set squad name.
+        
+        Args:
+            name: New squad name
+            
+        Returns:
+            Dictionary with update result or error details
+        """
+        return self.update_my_squad_info(name=name)
+    
+    def quick_set_rating(self, rating: int) -> Dict[str, Any]:
+        """
+        Quickly set squad rating.
+        
+        Args:
+            rating: New squad rating (0-99999)
+            
+        Returns:
+            Dictionary with update result or error details
+        """
+        return self.update_my_squad_info(rating=rating)
+    
+    def quick_set_member_limit(self, limit: int) -> Dict[str, Any]:
+        """
+        Quickly set member limit.
+        
+        Args:
+            limit: New member limit (1-300)
+            
+        Returns:
+            Dictionary with update result or error details
+        """
+        return self.update_my_squad_info(member_limit=limit)
+    
+    def quick_set_colors(self, primary_color: str, secondary_color: str = None) -> Dict[str, Any]:
+        """
+        Quickly set squad colors using color names.
+        
+        Args:
+            primary_color: Primary color name
+            secondary_color: Secondary color name (optional)
+            
+        Returns:
+            Dictionary with update result or error details
+        """
+        updates = {
+            "_logo_clr_prim": self.get_color_value(primary_color)
+        }
+        
+        if secondary_color:
+            updates["_logo_clr_sec"] = self.get_color_value(secondary_color)
+        
+        return self.update_my_squad_info(**updates)
+    
+    def quick_set_level(self, level: int, name: str = None) -> Dict[str, Any]:
+        """
+        Quickly set squad to specific level.
+        
+        Args:
+            level: Desired level (1-10)
+            name: Optional custom squad name
+            
+        Returns:
+            Dictionary with update result or error details
+        """
+        return self.set_squad_level(level, name)
+    
+    def quick_set_currency(self, amount: int) -> Dict[str, Any]:
+        """
+        Quickly set squad currency.
+        
+        Args:
+            amount: Currency amount
+            
+        Returns:
+            Dictionary with update result or error details
+        """
+        return self.update_my_squad_info(currency=str(amount))
+    
+    def quick_setup_professional_squad(self, name: str, level: int = 8) -> Dict[str, Any]:
+        """
+        Quick setup for professional squad with optimal settings.
+        
+        Args:
+            name: Squad name
+            level: Squad level (1-10)
+            
+        Returns:
+            Dictionary with update result or error details
+        """
+        return self.customize_squad_complete(
+            name=name,
+            _xp=self.calculate_xp_for_level(level),
+            rating=level * 1000,
+            member_limit=50 + (level * 10),
+            membership="owner_approved",
+            _min_join_value=level * 200,
+            description=f"Professional squad at Level {level}!",
+            currency=str(level * 5000),
+            active_clan_label="true"
+        )
+    
+    def quick_setup_gaming_squad(self, name: str, theme: str = "fire") -> Dict[str, Any]:
+        """
+        Quick setup for gaming squad with theme.
+        
+        Args:
+            name: Squad name
+            theme: Color theme ('fire', 'ice', 'dark', 'nature')
+            
+        Returns:
+            Dictionary with update result or error details
+        """
+        # Apply theme first
+        theme_result = self.customize_squad_theme(theme, name)
+        
+        if theme_result and 'error' not in theme_result:
+            # Add gaming-specific settings
+            gaming_updates = {
+                membership="owner_approved",
+                _min_join_value=1000,
+                currency="10000",
+                active_clan_label="true"
+            }
+            
+            return self.update_my_squad_info(**gaming_updates)
+        
+        return theme_result
+    
+    def quick_reset_to_defaults(self) -> Dict[str, Any]:
+        """
+        Quick reset squad to default settings.
+        
+        Returns:
+            Dictionary with update result or error details
+        """
+        return self.customize_squad_complete(
+            name="Default Squad",
+            description="Default squad description",
+            rating=1000,
+            member_limit=30,
+            membership="open",
+            _logo="1",
+            _logo_clr_prim=self.get_color_value("blue"),
+            _logo_clr_sec=self.get_color_value("white"),
+            _min_join_value=500,
+            _xp=self.calculate_xp_for_level(1),
+            currency="0",
+            active_clan_label="false"
+        )
+    
     # Events API
     
     def get_events(self, event_type: str = None, status: str = None) -> List[Dict[str, Any]]:

{mc5_api_client-1.0.22.dist-info → mc5_api_client-1.0.23.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mc5_api_client
-Version: 1.0.22
+Version: 1.0.23
 Summary: A comprehensive Python library for interacting with the Modern Combat 5 API
 Home-page: https://pypi.org/project/mc5-api-client/
 Author: Chizoba
@@ -409,38 +409,37 @@ from mc5_api_client import MC5Client
 
 client = MC5Client(username, password)
 
-# 🎯 Set squad to specific level (1-10)
-client.set_squad_level(8, "Level 8 Elite")
-# Automatically sets XP, rating, member limit, etc.
+# 🚀 SUPER SIMPLE - One-line customizations!
+client.quick_set_name("My Awesome Squad")           # Change name
+client.quick_set_level(5)                              # Set to Level 5
+client.quick_set_colors("red", "white")               # Red/White colors
+client.quick_set_member_limit(50)                     # Set member limit
+client.quick_set_currency(10000)                       # Set currency
 
-# 🎨 Apply color themes
-client.customize_squad_theme('fire', 'Fire Warriors')  # Red/Orange theme
-client.customize_squad_theme('ice', 'Ice Legion')       # Blue/Cyan theme
-client.customize_squad_theme('dark', 'Dark Knights')   # Black/White theme
-client.customize_squad_theme('nature', 'Nature Guardians') # Green/Lime theme
+# 🎯 QUICK SETUPS - Professional results in one line!
+client.quick_setup_professional_squad("Elite Squad", level=8)  # Professional squad
+client.quick_setup_gaming_squad("Gaming Legends", "fire")       # Gaming squad with theme
 
-# 🔧 Complete customization with validation
+# 🎨 THEMES - Beautiful colors instantly
+client.customize_squad_theme('fire')                    # Fire theme
+client.customize_squad_theme('ice')                     # Ice theme
+client.customize_squad_theme('dark')                    # Dark theme
+client.customize_squad_theme('nature')                  # Nature theme
+
+# ⭐ LEVEL SYSTEM - Automatic XP calculation
+client.set_squad_level(10, "Max Level Squad")          # Level 10 (max)
+# Level 1: 1000 XP, Level 5: 5000 XP, Level 10: 10000 XP
+
+# 🔧 COMPLETE CUSTOMIZATION - Full control with validation
 client.customize_squad_complete(
     name="452e55e84897+",
-    description="Professional squad with active members!",
     rating=3573,
     score=5200,
     member_limit=300,
-    membership="owner_approved",
-    _logo="1",
-    _logo_clr_prim=client.get_color_value("red"),     # Red color
-    _logo_clr_sec=client.get_color_value("white"),    # White color
-    _min_join_value=996699,
-    _xp=client.calculate_xp_for_level(9),             # Level 9 = 9000 XP
-    _killsig_id="default_killsig_01",
-    currency="10000",
-    active_clan_label="true",
-    active_clan_threshold="50"
+    _logo_clr_prim=client.get_color_value("red"),
+    _xp=client.calculate_xp_for_level(9),
+    currency="10000"
 )
-
-# 🎯 Helper functions
-xp = client.calculate_xp_for_level(5)  # Returns 5000
-color = client.get_color_value('blue')  # Returns '255'
 ```
 
 ### **📊 Squad Parameters You Can Customize:**
@@ -475,11 +474,36 @@ active_clan_label: "true"
 active_clan_threshold: "50"
 ```
 
-### **🎮 Quick Customization Examples:**
+### **🚀 Quick Functions - EASIEST WAY TO CUSTOMIZE!**
+```python
+# 📝 BASIC QUICK FUNCTIONS
+client.quick_set_name("My Squad")              # Change name
+client.quick_set_rating(5000)                    # Set rating
+client.quick_set_member_limit(50)               # Set member limit
+client.quick_set_currency(10000)                  # Set currency
+
+# � COLOR QUICK FUNCTIONS
+client.quick_set_colors("red")                    # Red theme
+client.quick_set_colors("blue", "white")           # Blue/White theme
+client.quick_set_colors("black", "gold")           # Black/Gold theme
+
+# ⭐ LEVEL QUICK FUNCTIONS
+client.quick_set_level(5)                         # Set to Level 5
+client.quick_set_level(10, "Max Level")           # Set to Level 10
+
+# 🏆 PROFESSIONAL QUICK SETUPS
+client.quick_setup_professional_squad("Elite Squad", level=8)  # Professional setup
+client.quick_setup_gaming_squad("Gaming Squad", "fire")       # Gaming setup
+
+# 🔄 RESET QUICK FUNCTION
+client.quick_reset_to_defaults()                    # Reset to defaults
+```
+
+### **�🎮 Quick Customization Examples:**
 ```python
 # 🚀 One-line level upgrades
-client.set_squad_level(10)                    # Max level squad
-client.set_squad_level(5, "Level 5 Warriors")  # Custom name
+client.quick_set_level(10)                    # Max level squad
+client.quick_set_level(5, "Level 5 Warriors")  # Custom name
 
 # 🎨 One-line theme applications
 client.customize_squad_theme('fire')            # Fire theme
@@ -585,6 +609,12 @@ python examples/automatic_squad_management.py
 # Complete squad customization:
 python examples/complete_squad_customization.py
 
+# Quick squad customization:
+python examples/squad_customization_quick.py
+
+# Squad quick start (super simple):
+python examples/squad_quick_start.py
+
 # Authentication examples:
 python examples/authentication_example.py
 

{mc5_api_client-1.0.22.dist-info → mc5_api_client-1.0.23.dist-info}/RECORD

@@ -1,4 +1,4 @@
-mc5_api_client/__init__.py,sha256=izYE-Hb3sfF08lXzwZ8LwphUFJveyiQoLbU_k0yBGiI,13363
+mc5_api_client/__init__.py,sha256=edDAYE4uY6borS9d1ROx3bUkNP3SUvh15maqdXT7aJY,13613
 mc5_api_client/account.py,sha256=EmydXCsCXaKqMw21oVttQfYuDl50pa2dwhcTeHtnxbQ,14396
 mc5_api_client/account_quick.py,sha256=t4ki4ujYENmcnd_004f0pO9SPxPyCllz4WHpBG9wNbo,10458
 mc5_api_client/admin_client.py,sha256=527aavolxVhY2M5ceFxVbbE5YTczU9Z86Fdt1UzdRZM,15220
@@ -6,7 +6,7 @@ mc5_api_client/alerts.py,sha256=zW-cEwSSShuHkGxTBQaS8Ynf1a0hh5RMQ0G3WC_ajI0,1322
 mc5_api_client/alerts_quick.py,sha256=D1j0RiHteYqoAgc4KYqTxYG1Hkud3b-xWRV_VOUEnY0,7946
 mc5_api_client/auth.py,sha256=z8vmyQIHUdAzk0pUyKCesT8gTv4jboLIFGBxAu1v_-8,13396
 mc5_api_client/cli.py,sha256=6xciRjWkUMOxgxlbDsoOiHRuirXPy7uc9WURXPKmgGc,17255
-mc5_api_client/client.py,sha256=IDP8c14f0u0k1rvUNqh7_3VmGBltv64GClLBkusNSJI,126182
+mc5_api_client/client.py,sha256=Ual-DEU_PptvQbM6FkTzQbP0CUToqqXbepwUj__vS00,131067
 mc5_api_client/debug.py,sha256=524vNCE7jM_KP5JM81-3eI2cmFBBA-Hf7Uy0cIL75W0,8240
 mc5_api_client/easy_mc5.py,sha256=kfjOJMW-VRAZcXEF1yHiGsACgjb-ZjXGuw1U_gepSQY,24202
 mc5_api_client/exceptions.py,sha256=o7od4GrEIlgq6xSNUjZdh74xoDTytF3PLcMq5ewRiJw,2683
@@ -24,9 +24,9 @@ mc5_api_client/storage_admin.py,sha256=l-nwskbpa3KpeIoWcwVRicgBSvrTvQ5aE2QU_e366
 mc5_api_client/telemetry.py,sha256=k8qOimPg-AKsnMclIgeqYCJ_97j2pWyiN7Lg80D4sKo,13246
 mc5_api_client/transfer.py,sha256=-pln70360mo4cKBQIUzp_wt9ce1Cr4YA6aJDFPKEjzQ,14381
 mc5_api_client/transfer_quick.py,sha256=HhRbp4FVzFwuzHDcqOyYiVjeVEIfgezlWd8SN6sh874,11310
-mc5_api_client-1.0.22.dist-info/licenses/LICENSE,sha256=M0UBQ4B3pB9XcV54_jhVP681xyauF8GB6YK_rKmuXzk,1064
-mc5_api_client-1.0.22.dist-info/METADATA,sha256=Twytv04RCN7zec91J7x0SgLbAlUL9WpYkGBbJF0LJFY,91487
-mc5_api_client-1.0.22.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-mc5_api_client-1.0.22.dist-info/entry_points.txt,sha256=2kruOpleFYK3Jl1MoQwGyqCd-Pj4kQWngXmIjnXx_gE,48
-mc5_api_client-1.0.22.dist-info/top_level.txt,sha256=eYJe4ue9j1ig_jFY5Z05mDqpizUEV7TYpk5lBXVd4kA,15
-mc5_api_client-1.0.22.dist-info/RECORD,,
+mc5_api_client-1.0.23.dist-info/licenses/LICENSE,sha256=M0UBQ4B3pB9XcV54_jhVP681xyauF8GB6YK_rKmuXzk,1064
+mc5_api_client-1.0.23.dist-info/METADATA,sha256=eGCRDEU5dYcTQQ573Kz1ZfpSYUNUJktOdXBkNfS_Z8o,92909
+mc5_api_client-1.0.23.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+mc5_api_client-1.0.23.dist-info/entry_points.txt,sha256=2kruOpleFYK3Jl1MoQwGyqCd-Pj4kQWngXmIjnXx_gE,48
+mc5_api_client-1.0.23.dist-info/top_level.txt,sha256=eYJe4ue9j1ig_jFY5Z05mDqpizUEV7TYpk5lBXVd4kA,15
+mc5_api_client-1.0.23.dist-info/RECORD,,