localdex 0.2.44__py3-none-any.whl → 0.2.45__py3-none-any.whl

localdex/core.py

@@ -625,6 +625,10 @@ class LocalDex:
         """
         Calculate HP EV from total HP stat using the reverse of the Pokemon HP formula.
         
+        If the target HP is impossible to achieve with any EV value, returns the EV that
+        produces the closest possible HP value. For impossibly high HP values, returns 252 EVs.
+        For impossibly low HP values, returns 0 EVs.
+        
         Args:
             total_hp (int): Total HP stat value
             base_hp (int): Base HP stat
@@ -632,13 +636,22 @@ class LocalDex:
             level (int): Pokemon level (1-100)
         
         Returns:
-            int: Required EV value (0-252)
+            int: Required EV value (0-252) - closest possible value if target is impossible
         """
         if level <= 0:
             raise ValueError("Level must be greater than 0")
         
-        # Instead of trying to reverse the formula exactly (which is complex due to floor operations),
-        # we'll find the EV that gives us the closest HP value
+        # Calculate the minimum and maximum possible HP values
+        min_hp = self.calculate_hp(base_hp, iv, 0, level)
+        max_hp = self.calculate_hp(base_hp, iv, 252, level)
+        
+        # If target HP is impossible, return the closest boundary
+        if total_hp <= min_hp:
+            return 0  # Return 0 EVs for impossibly low HP
+        elif total_hp >= max_hp:
+            return 252  # Return 252 EVs for impossibly high HP
+        
+        # Find the EV that gives us the closest HP value
         best_ev = 0
         best_diff = float('inf')
         
@@ -659,6 +672,10 @@ class LocalDex:
         """
         Calculate EV for other stats (Attack, Defense, Sp. Attack, Sp. Defense, Speed) using the reverse of the Pokemon stat formula.
         
+        If the target stat is impossible to achieve with any EV value, returns the EV that
+        produces the closest possible stat value. For impossibly high stat values, returns 252 EVs.
+        For impossibly low stat values, returns 0 EVs.
+        
         Args:
             total_stat (int): Total stat value
             base_stat (int): Base stat value
@@ -667,15 +684,24 @@ class LocalDex:
             nature_modifier (float): Nature modifier (0.9 for hindering, 1.0 for neutral, 1.1 for beneficial)
         
         Returns:
-            int: Required EV value (0-252)
+            int: Required EV value (0-252) - closest possible value if target is impossible
         """
         if level <= 0:
             raise ValueError("Level must be greater than 0")
         if nature_modifier <= 0:
             raise ValueError("Nature modifier must be greater than 0")
         
-        # Instead of trying to reverse the formula exactly (which is complex due to floor operations),
-        # we'll find the EV that gives us the closest stat value
+        # Calculate the minimum and maximum possible stat values
+        min_stat = self.calculate_other_stat(base_stat, iv, 0, level, nature_modifier)
+        max_stat = self.calculate_other_stat(base_stat, iv, 252, level, nature_modifier)
+        
+        # If target stat is impossible, return the closest boundary
+        if total_stat <= min_stat:
+            return 0  # Return 0 EVs for impossibly low stat
+        elif total_stat >= max_stat:
+            return 252  # Return 252 EVs for impossibly high stat
+        
+        # Find the EV that gives us the closest stat value
         best_ev = 0
         best_diff = float('inf')
         
@@ -696,6 +722,10 @@ class LocalDex:
         """
         Calculate Attack EV from total Attack stat.
         
+        If the target Attack is impossible to achieve with any EV value, returns the EV that
+        produces the closest possible Attack value. For impossibly high Attack values, returns 252 EVs.
+        For impossibly low Attack values, returns 0 EVs.
+        
         Args:
             total_attack (int): Total Attack stat value
             base_attack (int): Base Attack stat
@@ -704,7 +734,7 @@ class LocalDex:
             nature_modifier (float): Nature modifier (0.9 for hindering, 1.0 for neutral, 1.1 for beneficial)
         
         Returns:
-            int: Required EV value (0-252)
+            int: Required EV value (0-252) - closest possible value if target is impossible
         """
         return self.calculate_other_stat_ev(total_attack, base_attack, iv, level, nature_modifier)
     
@@ -712,6 +742,10 @@ class LocalDex:
         """
         Calculate Defense EV from total Defense stat.
         
+        If the target Defense is impossible to achieve with any EV value, returns the EV that
+        produces the closest possible Defense value. For impossibly high Defense values, returns 252 EVs.
+        For impossibly low Defense values, returns 0 EVs.
+        
         Args:
             total_defense (int): Total Defense stat value
             base_defense (int): Base Defense stat
@@ -720,7 +754,7 @@ class LocalDex:
             nature_modifier (float): Nature modifier (0.9 for hindering, 1.0 for neutral, 1.1 for beneficial)
         
         Returns:
-            int: Required EV value (0-252)
+            int: Required EV value (0-252) - closest possible value if target is impossible
         """
         return self.calculate_other_stat_ev(total_defense, base_defense, iv, level, nature_modifier)
     
@@ -728,6 +762,10 @@ class LocalDex:
         """
         Calculate Special Attack EV from total Special Attack stat.
         
+        If the target Special Attack is impossible to achieve with any EV value, returns the EV that
+        produces the closest possible Special Attack value. For impossibly high Special Attack values, returns 252 EVs.
+        For impossibly low Special Attack values, returns 0 EVs.
+        
         Args:
             total_special_attack (int): Total Special Attack stat value
             base_special_attack (int): Base Special Attack stat
@@ -736,7 +774,7 @@ class LocalDex:
             nature_modifier (float): Nature modifier (0.9 for hindering, 1.0 for neutral, 1.1 for beneficial)
         
         Returns:
-            int: Required EV value (0-252)
+            int: Required EV value (0-252) - closest possible value if target is impossible
         """
         return self.calculate_other_stat_ev(total_special_attack, base_special_attack, iv, level, nature_modifier)
     
@@ -744,6 +782,10 @@ class LocalDex:
         """
         Calculate Special Defense EV from total Special Defense stat.
         
+        If the target Special Defense is impossible to achieve with any EV value, returns the EV that
+        produces the closest possible Special Defense value. For impossibly high Special Defense values, returns 252 EVs.
+        For impossibly low Special Defense values, returns 0 EVs.
+        
         Args:
             total_special_defense (int): Total Special Defense stat value
             base_special_defense (int): Base Special Defense stat
@@ -752,7 +794,7 @@ class LocalDex:
             nature_modifier (float): Nature modifier (0.9 for hindering, 1.0 for neutral, 1.1 for beneficial)
         
         Returns:
-            int: Required EV value (0-252)
+            int: Required EV value (0-252) - closest possible value if target is impossible
         """
         return self.calculate_other_stat_ev(total_special_defense, base_special_defense, iv, level, nature_modifier)
     
@@ -760,6 +802,10 @@ class LocalDex:
         """
         Calculate Speed EV from total Speed stat.
         
+        If the target Speed is impossible to achieve with any EV value, returns the EV that
+        produces the closest possible Speed value. For impossibly high Speed values, returns 252 EVs.
+        For impossibly low Speed values, returns 0 EVs.
+        
         Args:
             total_speed (int): Total Speed stat value
             base_speed (int): Base Speed stat
@@ -768,7 +814,7 @@ class LocalDex:
             nature_modifier (float): Nature modifier (0.9 for hindering, 1.0 for neutral, 1.1 for beneficial)
         
         Returns:
-            int: Required EV value (0-252)
+            int: Required EV value (0-252) - closest possible value if target is impossible
         """
         return self.calculate_other_stat_ev(total_speed, base_speed, iv, level, nature_modifier)
 
@@ -776,6 +822,10 @@ class LocalDex:
         """
         Calculate HP EV from total HP stat using species name.
         
+        If the target HP is impossible to achieve with any EV value, returns the EV that
+        produces the closest possible HP value. For impossibly high HP values, returns 252 EVs.
+        For impossibly low HP values, returns 0 EVs.
+        
         Args:
             species (str): Pokemon species name
             total_hp (int): Total HP stat value
@@ -783,7 +833,7 @@ class LocalDex:
             level (int): Pokemon level (1-100)
         
         Returns:
-            int: Required EV value (0-252)
+            int: Required EV value (0-252) - closest possible value if target is impossible
         """
         base_stats = self.get_base_stats_from_species(species)
         return self.calculate_hp_ev(total_hp, base_stats.hp, iv, level)
@@ -792,6 +842,10 @@ class LocalDex:
         """
         Calculate Attack EV from total Attack stat using species name.
         
+        If the target Attack is impossible to achieve with any EV value, returns the EV that
+        produces the closest possible Attack value. For impossibly high Attack values, returns 252 EVs.
+        For impossibly low Attack values, returns 0 EVs.
+        
         Args:
             species (str): Pokemon species name
             total_attack (int): Total Attack stat value
@@ -800,7 +854,7 @@ class LocalDex:
             nature_modifier (float): Nature modifier (0.9 for hindering, 1.0 for neutral, 1.1 for beneficial)
         
         Returns:
-            int: Required EV value (0-252)
+            int: Required EV value (0-252) - closest possible value if target is impossible
         """
         base_stats = self.get_base_stats_from_species(species)
         return self.calculate_attack_ev(total_attack, base_stats.attack, iv, level, nature_modifier)
@@ -809,6 +863,10 @@ class LocalDex:
         """
         Calculate Defense EV from total Defense stat using species name.
         
+        If the target Defense is impossible to achieve with any EV value, returns the EV that
+        produces the closest possible Defense value. For impossibly high Defense values, returns 252 EVs.
+        For impossibly low Defense values, returns 0 EVs.
+        
         Args:
             species (str): Pokemon species name
             total_defense (int): Total Defense stat value
@@ -817,7 +875,7 @@ class LocalDex:
             nature_modifier (float): Nature modifier (0.9 for hindering, 1.0 for neutral, 1.1 for beneficial)
         
         Returns:
-            int: Required EV value (0-252)
+            int: Required EV value (0-252) - closest possible value if target is impossible
         """
         base_stats = self.get_base_stats_from_species(species)
         return self.calculate_defense_ev(total_defense, base_stats.defense, iv, level, nature_modifier)
@@ -826,6 +884,10 @@ class LocalDex:
         """
         Calculate Special Attack EV from total Special Attack stat using species name.
         
+        If the target Special Attack is impossible to achieve with any EV value, returns the EV that
+        produces the closest possible Special Attack value. For impossibly high Special Attack values, returns 252 EVs.
+        For impossibly low Special Attack values, returns 0 EVs.
+        
         Args:
             species (str): Pokemon species name
             total_special_attack (int): Total Special Attack stat value
@@ -834,7 +896,7 @@ class LocalDex:
             nature_modifier (float): Nature modifier (0.9 for hindering, 1.0 for neutral, 1.1 for beneficial)
         
         Returns:
-            int: Required EV value (0-252)
+            int: Required EV value (0-252) - closest possible value if target is impossible
         """
         base_stats = self.get_base_stats_from_species(species)
         return self.calculate_special_attack_ev(total_special_attack, base_stats.special_attack, iv, level, nature_modifier)
@@ -843,6 +905,10 @@ class LocalDex:
         """
         Calculate Special Defense EV from total Special Defense stat using species name.
         
+        If the target Special Defense is impossible to achieve with any EV value, returns the EV that
+        produces the closest possible Special Defense value. For impossibly high Special Defense values, returns 252 EVs.
+        For impossibly low Special Defense values, returns 0 EVs.
+        
         Args:
             species (str): Pokemon species name
             total_special_defense (int): Total Special Defense stat value
@@ -851,7 +917,7 @@ class LocalDex:
             nature_modifier (float): Nature modifier (0.9 for hindering, 1.0 for neutral, 1.1 for beneficial)
         
         Returns:
-            int: Required EV value (0-252)
+            int: Required EV value (0-252) - closest possible value if target is impossible
         """
         base_stats = self.get_base_stats_from_species(species)
         return self.calculate_special_defense_ev(total_special_defense, base_stats.special_defense, iv, level, nature_modifier)
@@ -860,6 +926,10 @@ class LocalDex:
         """
         Calculate Speed EV from total Speed stat using species name.
         
+        If the target Speed is impossible to achieve with any EV value, returns the EV that
+        produces the closest possible Speed value. For impossibly high Speed values, returns 252 EVs.
+        For impossibly low Speed values, returns 0 EVs.
+        
         Args:
             species (str): Pokemon species name
             total_speed (int): Total Speed stat value
@@ -868,7 +938,7 @@ class LocalDex:
             nature_modifier (float): Nature modifier (0.9 for hindering, 1.0 for neutral, 1.1 for beneficial)
         
         Returns:
-            int: Required EV value (0-252)
+            int: Required EV value (0-252) - closest possible value if target is impossible
         """
         base_stats = self.get_base_stats_from_species(species)
         return self.calculate_speed_ev(total_speed, base_stats.speed, iv, level, nature_modifier)
@@ -877,6 +947,10 @@ class LocalDex:
         """
         Calculate all EV values for a Pokemon using species name and target stats.
         
+        If any target stat is impossible to achieve with any EV value, returns the EV that
+        produces the closest possible stat value. For impossibly high stat values, returns 252 EVs.
+        For impossibly low stat values, returns 0 EVs.
+        
         Args:
             species (str): Pokemon species name
             stats (Dict[str, int]): Dictionary of target stat values with keys: 'hp', 'attack', 'defense', 'special_attack', 'special_defense', 'speed'
@@ -885,7 +959,7 @@ class LocalDex:
             nature_modifier (float): Nature modifier (0.9 for hindering, 1.0 for neutral, 1.1 for beneficial)
         
         Returns:
-            Dict[str, int]: Dictionary of required EV values for each stat
+            Dict[str, int]: Dictionary of required EV values for each stat - closest possible values if targets are impossible
         """
         base_stats = self.get_base_stats_from_species(species)
         

{localdex-0.2.44.dist-info → localdex-0.2.45.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: localdex
-Version: 0.2.44
+Version: 0.2.45
 Summary: A local Pokemon data repository/Pokedex with fast offline access
 Author-email: LocalDex Team <localdex@example.com>
 License: MIT

{localdex-0.2.44.dist-info → localdex-0.2.45.dist-info}/RECORD

@@ -1,6 +1,6 @@
 localdex/__init__.py,sha256=TTeh9Eys8nLtcw7Dg2equDqnouthIUyfsqvABtzR2vA,403
 localdex/cli.py,sha256=WqBCyA0akAFJNrYa8jCA3zoZgYEptDYDMGfAGkvKyZc,19317
-localdex/core.py,sha256=xjqXVjXcsyo1_FL-IM9e1YJPqCBRSbReKd_wwC2w8h8,49276
+localdex/core.py,sha256=fXalY6GyZ94QhD_M0KW_l9tdhq-bb785O14sMmvzenI,54495
 localdex/data_loader.py,sha256=hi9aSTto5Ti-OBGOgrQ-XwD5hmivsUwS1uC4rulhwQI,11366
 localdex/download_data.py,sha256=T4A3OliGe2RsrRV1glyCqRcFhQIRt29KcY1K1-IqTuU,21597
 localdex/exceptions.py,sha256=Z02-8Kci6jFDk2nnGdVSHZJMDDWE9vuwuASs4VM3To8,2777
@@ -4826,9 +4826,9 @@ localdex/models/ability.py,sha256=AQzv3XUHHl4sustMJjPDDjJOjXu2GMLTfcM3-tqQ_1w,30
 localdex/models/item.py,sha256=zXao8F-jBPUGq_YLeGeYeK_dZVI7aZMXtWOPwR3qusY,4677
 localdex/models/move.py,sha256=hfgcWI4ziz5MMvc9ddmkotxzYYdrSUqZZQ72IU5tucs,7629
 localdex/models/pokemon.py,sha256=glnOiEhkFc25U54hJHwUkT-okUgtL2prg3269YXI3w0,5422
-localdex-0.2.44.dist-info/licenses/LICENSE,sha256=i6DyIs1YqXBAxAIiGBS6vp2iQP9tiMd47S8dvaeFmDQ,1065
-localdex-0.2.44.dist-info/METADATA,sha256=GhTRATcy1SVpiW8UvOk8eFK2NVpFb8_56B5HAEXReWE,5886
-localdex-0.2.44.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-localdex-0.2.44.dist-info/entry_points.txt,sha256=n5GxSeQo-MRuvrT2wVk7hOzEFFsWf6tkBjkzmGIYJe4,47
-localdex-0.2.44.dist-info/top_level.txt,sha256=vtupDMH-IaxVCoEZrmE0QzdTwhaKzngVJbTA1NkR_MY,9
-localdex-0.2.44.dist-info/RECORD,,
+localdex-0.2.45.dist-info/licenses/LICENSE,sha256=i6DyIs1YqXBAxAIiGBS6vp2iQP9tiMd47S8dvaeFmDQ,1065
+localdex-0.2.45.dist-info/METADATA,sha256=lbBlCaUAPBxN35SyxWC_Z9sIk-ScqhQEtGwT4JRJGOI,5886
+localdex-0.2.45.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+localdex-0.2.45.dist-info/entry_points.txt,sha256=n5GxSeQo-MRuvrT2wVk7hOzEFFsWf6tkBjkzmGIYJe4,47
+localdex-0.2.45.dist-info/top_level.txt,sha256=vtupDMH-IaxVCoEZrmE0QzdTwhaKzngVJbTA1NkR_MY,9
+localdex-0.2.45.dist-info/RECORD,,