funcguard 0.2.41__tar.gz → 0.2.42__tar.gz

{funcguard-0.2.41 → funcguard-0.2.42}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: funcguard
-Version: 0.2.41
+Version: 0.2.42
 Summary: FuncGuard是一个Python库，提供函数执行超时控制、重试机制、HTTP请求封装和格式化打印工具。
 Home-page: https://github.com/tinycen/funcguard
 Author: tinycen

{funcguard-0.2.41 → funcguard-0.2.42}/funcguard/pd_utils/statistics/agg_utils.py

@@ -20,7 +20,8 @@ def group_agg(
     conditions: Optional[Union[Tuple, List[Tuple]]] = None,
     logic: str = "and",
     true_mask: Optional[pd.Series] = None,
-    false_mask: Optional[pd.Series] = None
+    false_mask: Optional[pd.Series] = None,
+    to_dict: bool = True
 ) -> Dict[Any, Union[int, float]]:
     """
     按指定列分组，对另一列进行聚合统计。
@@ -38,6 +39,7 @@ def group_agg(
     - logic (str)：逻辑操作类型，"and" 或 "or"，默认为 "and"。
     - true_mask (pd.Series)：初始True掩码，默认为None。
     - false_mask (pd.Series)：初始False掩码，默认为None。
+    - to_dict (bool)：是否将结果转换为字典，默认为True。
 
     返回：
     - Dict[Any, Union[int, float]]：以分组值为键，聚合结果为值的字典。
@@ -78,6 +80,9 @@ def group_agg(
         result_series = result_series.sort_values(ascending=True)
     elif sort == "desc":
         result_series = result_series.sort_values(ascending=False)
-
+    
     # 转换为字典返回
-    return result_series.to_dict()
+    if to_dict:
+        return result_series.to_dict()
+    else:
+        return result_series

{funcguard-0.2.41 → funcguard-0.2.42}/funcguard/pd_utils/statistics/count_utils.py

@@ -12,7 +12,8 @@ def value_counts(
     conditions: Optional[Union[Tuple, List[Tuple]]] = None,
     logic: str = "and",
     true_mask: Optional[pd.Series] = None,
-    false_mask: Optional[pd.Series] = None
+    false_mask: Optional[pd.Series] = None,
+    to_dict: bool = True
 ) -> Mapping[Any, Union[int, float]]:
     """
     统计DataFrame指定列中不同值的计数数据。
@@ -29,6 +30,7 @@ def value_counts(
     - logic (str)：逻辑操作类型，"and" 或 "or"，默认为 "and"。
     - true_mask (pd.Series)：初始True掩码，默认为None。
     - false_mask (pd.Series)：初始False掩码，默认为None。
+    - to_dict (bool)：是否将结果转换为字典，默认为True。
 
     返回：
     - Mapping[Any, Union[int, float]]：以值为键，计数/百分比为值的字典。
@@ -75,7 +77,10 @@ def value_counts(
     )
 
     # 转换为字典返回
-    return result_series.to_dict()
+    if to_dict:
+        return result_series.to_dict()
+    else:
+        return result_series
 
 
 def count(

{funcguard-0.2.41 → funcguard-0.2.42}/funcguard/pd_utils/statistics/df_statistics.py

@@ -113,7 +113,8 @@ class DataFrameStatistics:
         conditions: Optional[Union[Tuple, List[Tuple]]] = None,
         logic: str = "and",
         true_mask: Optional[pd.Series] = None,
-        false_mask: Optional[pd.Series] = None
+        false_mask: Optional[pd.Series] = None,
+        to_dict: bool = True
     ) -> Mapping[Any, Union[int, float]]:
         """
         统计指定列中不同值的计数数据，自动使用内部掩码参数
@@ -128,7 +129,9 @@ class DataFrameStatistics:
         - logic (str)：逻辑操作类型，"and" 或 "or"，默认为 "and"
         - true_mask (pd.Series)：初始True掩码，默认为None（使用内部缓存）
         - false_mask (pd.Series)：初始False掩码，默认为None（使用内部缓存）
+        - to_dict (bool)：是否将结果转换为字典，默认为True。
 
+        
         返回：
         - Mapping[Any, Union[int, float]]：以值为键，计数/百分比为值的字典
 
@@ -151,7 +154,7 @@ class DataFrameStatistics:
             false_mask = self._false_mask
         return _original_value_counts(
             self._df, column, mode, sort, dropna,
-            conditions, logic, true_mask, false_mask
+            conditions, logic, true_mask, false_mask, to_dict
         )
 
 
@@ -164,7 +167,8 @@ class DataFrameStatistics:
         conditions: Optional[Union[Tuple, List[Tuple]]] = None,
         logic: str = "and",
         true_mask: Optional[pd.Series] = None,
-        false_mask: Optional[pd.Series] = None
+        false_mask: Optional[pd.Series] = None,
+        to_dict: bool = True
     ) -> Dict[Any, Union[int, float]]:
         """
         按指定列分组，对另一列进行聚合统计，自动使用内部掩码参数
@@ -180,7 +184,9 @@ class DataFrameStatistics:
         - logic (str)：逻辑操作类型，"and" 或 "or"，默认为 "and"
         - true_mask (pd.Series)：初始True掩码，默认为None（使用内部缓存）
         - false_mask (pd.Series)：初始False掩码，默认为None（使用内部缓存）
+        - to_dict (bool)：是否将结果转换为字典，默认为True。
 
+        
         返回：
         - Dict[Any, Union[int, float]]：以分组值为键，聚合结果为值的字典
 
@@ -199,7 +205,7 @@ class DataFrameStatistics:
             false_mask = self._false_mask
         return _original_group_agg(
             self._df, group_col, agg_col, agg_func, sort,
-            conditions, logic, true_mask, false_mask
+            conditions, logic, true_mask, false_mask, to_dict
         )
 
 

{funcguard-0.2.41 → funcguard-0.2.42}/funcguard.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: funcguard
-Version: 0.2.41
+Version: 0.2.42
 Summary: FuncGuard是一个Python库，提供函数执行超时控制、重试机制、HTTP请求封装和格式化打印工具。
 Home-page: https://github.com/tinycen/funcguard
 Author: tinycen

{funcguard-0.2.41 → funcguard-0.2.42}/setup.py

@@ -9,7 +9,7 @@ except FileNotFoundError:
 
 setup(
     name='funcguard',
-    version='0.2.41',
+    version='0.2.42',
     packages=find_packages(),
     install_requires=[
         'requests',