findly.unified-reporting-sdk 0.7.13__tar.gz → 0.7.15__tar.gz

{findly_unified_reporting_sdk-0.7.13 → findly_unified_reporting_sdk-0.7.15}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.3
 Name: findly.unified-reporting-sdk
-Version: 0.7.13
+Version: 0.7.15
 Summary: 
 License: GPL-3.0-only
 Requires-Python: >=3.9,<4.0
@@ -17,9 +17,8 @@ Requires-Dist: facebook-business (>=22.0.5,<23.0.0)
 Requires-Dist: google-analytics-admin (>=0.24.0,<0.25.0)
 Requires-Dist: google-analytics-data (>=0.18.18,<0.19.0)
 Requires-Dist: google-api-python-client (>=2.169.0,<3.0.0)
-Requires-Dist: oauth2client (>=4.1.3,<5.0.0)
 Requires-Dist: pandas (>=2.2.3,<3.0.0)
-Requires-Dist: protobuf (>=4.25.3,<5.0.0)
+Requires-Dist: protobuf (>=6.33.5,<7.0.0)
 Requires-Dist: sqlglot (>=26.17.1,<27.0.0)
 Description-Content-Type: text/markdown
 

{findly_unified_reporting_sdk-0.7.13 → findly_unified_reporting_sdk-0.7.15}/findly/unified_reporting_sdk/data_sources/common/common_parser.py

@@ -2,6 +2,7 @@ import re
 import pandas as pd
 from datetime import datetime
 from dateutil.relativedelta import relativedelta
+import sqlglot
 
 from typing import List, Optional, Callable, Tuple, Any, TypedDict
 from findly.unified_reporting_sdk.protos.findly_semantic_layer_pb2 import (
@@ -16,6 +17,60 @@ from findly.unified_reporting_sdk.data_sources.common.date_range_helper import (
 NONE_VALUE = "none"
 RESERVED_TOTAL = "RESERVED_TOTAL"
 
+# Regex pattern for valid SQL identifiers
+_IDENTIFIER_PATTERN = re.compile(r"^[a-zA-Z_][a-zA-Z0-9_]*$")
+# Regex pattern for ORDER BY column (identifier with optional ASC/DESC)
+_ORDER_BY_PATTERN = re.compile(r"^([a-zA-Z_][a-zA-Z0-9_]*)\s*(ASC|DESC)?$", re.IGNORECASE)
+# Regex pattern for YYYY-MM-DD date format
+_DATE_PATTERN = re.compile(r"^\d{4}-\d{2}-\d{2}$")
+
+
+def _validate_identifier(name: str) -> str:
+    """Validate that a string is a safe SQL identifier."""
+    if not _IDENTIFIER_PATTERN.match(name):
+        raise ValueError(f"Invalid SQL identifier: {name!r}")
+    return name
+
+
+def _validate_order_by_column(col: str) -> str:
+    """Validate an ORDER BY column (identifier with optional ASC/DESC)."""
+    if not _ORDER_BY_PATTERN.match(col):
+        raise ValueError(f"Invalid ORDER BY column: {col!r}")
+    return col
+
+
+def _validate_date(date_str: str) -> str:
+    """Validate that a string is a valid YYYY-MM-DD date."""
+    if not _DATE_PATTERN.match(date_str):
+        raise ValueError(f"Invalid date format (expected YYYY-MM-DD): {date_str!r}")
+    return date_str
+
+
+def _validate_positive_integer(value: Any) -> int:
+    """Validate that a value is a positive integer."""
+    try:
+        int_value = int(value)
+    except (TypeError, ValueError) as e:
+        raise ValueError(f"Invalid integer value: {value!r}") from e
+    if int_value <= 0:
+        raise ValueError(f"Value must be positive: {int_value}")
+    return int_value
+
+
+def _validate_sql_clause(clause: str, clause_type: str) -> str:
+    """Validate a SQL clause (WHERE/HAVING) using sqlglot parsing."""
+    if not clause or not clause.strip():
+        raise ValueError(f"Empty {clause_type} clause")
+    # Wrap in a minimal SELECT statement to validate the clause
+    test_query = f"SELECT 1 FROM t {clause_type} {clause}"
+    try:
+        parsed = sqlglot.parse(test_query)
+        if not parsed or parsed[0] is None:
+            raise ValueError(f"Failed to parse {clause_type} clause: {clause!r}")
+    except sqlglot.errors.ParseError as e:
+        raise ValueError(f"Invalid {clause_type} clause: {clause!r}") from e
+    return clause
+
 
 class DefaultFormattedDateRange(TypedDict):
     since: str
@@ -102,17 +157,24 @@ class CommonParser:
 
         Returns:
             str: The SQL query generated from the QueryArgs object.
+
+        Raises:
+            ValueError: If any input fails validation.
         """
         query_parts = []
 
         select_parts = []
         # Metrics and Metrics Expression
         if query.metrics:
-            select_parts.append(", ".join(query.metrics))
+            validated_metrics = [_validate_identifier(m) for m in query.metrics]
+            select_parts.append(", ".join(validated_metrics))
         elif query.metrics_expression:
             select_parts.append(", ".join(query.metrics_expression))
         if query.group_by_columns:
-            select_parts.append(", ".join(query.group_by_columns))
+            validated_group_cols = [
+                _validate_identifier(col) for col in query.group_by_columns
+            ]
+            select_parts.append(", ".join(validated_group_cols))
         if len(select_parts) > 0:
             select_str = "SELECT " + ", ".join(select_parts)
             query_parts.append(select_str)
@@ -123,13 +185,14 @@ class CommonParser:
             where_clause_modified = re.sub(
                 r"\bwhere\b", "", query.where_clause, flags=re.IGNORECASE
             ).strip()
+            _validate_sql_clause(where_clause_modified, "WHERE")
             conditions.append(f"WHERE {where_clause_modified}")
 
         # Date Where clause
         if query.date_ranges:
             for date_range in list(query.date_ranges):
-                start_date = date_range.start_date
-                end_date = date_range.end_date
+                start_date = _validate_date(date_range.start_date)
+                end_date = _validate_date(date_range.end_date)
                 # Check if start and end dates are the same
                 if start_date == end_date:
                     # Use equality condition when dates are the same
@@ -143,7 +206,10 @@ class CommonParser:
 
         # Group By
         if query.group_by_columns:
-            group_by_str = ", ".join(query.group_by_columns)
+            validated_group_cols = [
+                _validate_identifier(col) for col in query.group_by_columns
+            ]
+            group_by_str = ", ".join(validated_group_cols)
             query_parts.append(f"GROUP BY {group_by_str}")
 
         # Having
@@ -151,16 +217,21 @@ class CommonParser:
             having_clause_modified = re.sub(
                 r"\bhaving\b", "", query.having_clause, flags=re.IGNORECASE
             ).strip()
+            _validate_sql_clause(having_clause_modified, "HAVING")
             query_parts.append(f"HAVING {having_clause_modified}")
 
         # Order By
         if query.order_by:
-            order_by_str = ", ".join(query.order_by)
+            validated_order_cols = [
+                _validate_order_by_column(col) for col in query.order_by
+            ]
+            order_by_str = ", ".join(validated_order_cols)
             query_parts.append(f"ORDER BY {order_by_str}")
 
         # Limit
         if query.limit:
-            query_parts.append(f"LIMIT {query.limit}")
+            validated_limit = _validate_positive_integer(query.limit)
+            query_parts.append(f"LIMIT {validated_limit}")
 
         return "\n".join(query_parts)
 

{findly_unified_reporting_sdk-0.7.13 → findly_unified_reporting_sdk-0.7.15}/findly/unified_reporting_sdk/data_sources/fb_ads/fb_ads_query_args_parser.py

@@ -11,10 +11,6 @@ from findly.unified_reporting_sdk.data_sources.common.common_parser import (
     RESERVED_TOTAL,
 )
 
-from findly.unified_reporting_sdk.util.create_numeric_string_series import (
-    create_numeric_string_series,
-)
-
 from findly.unified_reporting_sdk.data_sources.common.where_string_comparison import (
     parse_where_column_condition,
     WhereClauseInformation,
@@ -333,8 +329,6 @@ class FbAdsQueryArgsParser(CommonParser):
 
             # remove duplicates from explosions and reset index
             df = df.drop_duplicates().reset_index(drop=True)
-            # Also cap float columns to 2 decimal places
-            df = df.apply(create_numeric_string_series)
 
             # At last, return that if there is only one date range,
             # else, we need to split the dataframe into multiple dataframes
@@ -555,9 +549,6 @@ class FbAdsQueryArgsParser(CommonParser):
         # Keep only the first row
         summary_df = summary_df.head(1)
 
-        # Also cap float columns to 2 decimal places
-        summary_df = summary_df.apply(create_numeric_string_series)
-
         return [summary_df]
 
     async def parse_query_args_to_request_params(

{findly_unified_reporting_sdk-0.7.13 → findly_unified_reporting_sdk-0.7.15}/findly/unified_reporting_sdk/data_sources/ga4/ga4_query_args_parser.py

@@ -83,14 +83,14 @@ class GA4QueryArgsParser(CommonParser):
                 # Check if the metric header ends with 'Rate'
                 if header.endswith("Rate"):
                     # Convert the value to a float and multiply by 100
-                    value_number = round(float(value) * 100, 2)
+                    value_number = float(value) * 100
                 else:
                     # Cap float values to 2 decimal places
                     value_number = float(value)
                     if value_number.is_integer():
                         value_number = int(value_number)
                     else:
-                        value_number = round(value_number, 2)
+                        value_number = value_number
                 row_dict[header] = value_number
 
             rows.append(row_dict)

{findly_unified_reporting_sdk-0.7.13 → findly_unified_reporting_sdk-0.7.15}/findly/unified_reporting_sdk/protos/findly_semantic_layer_pb2.pyi

@@ -36,7 +36,7 @@ DATA_SOURCE_LOCATION_UNKNOWN: DataSourceIntegration.ValueType  # 0
 SEMANTIC_LAYER: DataSourceIntegration.ValueType  # 1
 GA4: DataSourceIntegration.ValueType  # 2
 FB_ADS: DataSourceIntegration.ValueType  # 3
-global___DataSourceIntegration = DataSourceIntegration
+Global___DataSourceIntegration: typing_extensions.TypeAlias = DataSourceIntegration
 
 class _DateGranularity:
     ValueType = typing.NewType("ValueType", builtins.int)
@@ -59,7 +59,7 @@ WEEK: DateGranularity.ValueType  # 2
 MONTH: DateGranularity.ValueType  # 3
 QUARTER: DateGranularity.ValueType  # 4
 YEAR: DateGranularity.ValueType  # 5
-global___DateGranularity = DateGranularity
+Global___DateGranularity: typing_extensions.TypeAlias = DateGranularity
 
 class _Aggregation:
     ValueType = typing.NewType("ValueType", builtins.int)
@@ -86,7 +86,7 @@ MIN: Aggregation.ValueType  # 4
 MAX: Aggregation.ValueType  # 5
 AVERAGE: Aggregation.ValueType  # 6
 MEDIAN: Aggregation.ValueType  # 7
-global___Aggregation = Aggregation
+Global___Aggregation: typing_extensions.TypeAlias = Aggregation
 
 class _DimensionType:
     ValueType = typing.NewType("ValueType", builtins.int)
@@ -125,7 +125,7 @@ FB_ADS_FIELD: DimensionType.ValueType  # 3
 FB_ADS_BREAKDOWN: DimensionType.ValueType  # 4
 FB_ADS_ACTION_BREAKDOWN: DimensionType.ValueType  # 5
 FB_ADS_SUMMARY_ACTION_BREAKDOWN: DimensionType.ValueType  # 6
-global___DimensionType = DimensionType
+Global___DimensionType: typing_extensions.TypeAlias = DimensionType
 
 class _DimensionValueType:
     ValueType = typing.NewType("ValueType", builtins.int)
@@ -152,7 +152,7 @@ BOOLEAN: DimensionValueType.ValueType  # 4
 DATE: DimensionValueType.ValueType  # 5
 DATETIME: DimensionValueType.ValueType  # 6
 TIMESTAMP: DimensionValueType.ValueType  # 7
-global___DimensionValueType = DimensionValueType
+Global___DimensionValueType: typing_extensions.TypeAlias = DimensionValueType
 
 class _MetricType:
     ValueType = typing.NewType("ValueType", builtins.int)
@@ -204,7 +204,7 @@ Note that if an optional constraint string is applied, the constraint is applied
 DERIVED: MetricType.ValueType  # 4
 SQL_EXPRESSION: MetricType.ValueType  # 5
 """When you are building a metric that involves a SQL expression of multiple measures, you can use an expression metric."""
-global___MetricType = MetricType
+Global___MetricType: typing_extensions.TypeAlias = MetricType
 
 class _MetricValueType:
     ValueType = typing.NewType("ValueType", builtins.int)
@@ -285,7 +285,7 @@ METRIC_VALUE_TYPE_LIST_ADS_ACTION_STATS: MetricValueType.ValueType  # 15
 """A single action for a Statistics result -> https://github.com/facebook/facebook-python-business-sdk/blob/main/facebook_business/adobjects/adsactionstats.py"""
 METRIC_VALUE_TYPE_LIST_ADS_INSIGHTS_DDA_RESULT: MetricValueType.ValueType  # 16
 METRIC_VALUE_TYPE_LIST_ADS_HISTOGRAM_STATS: MetricValueType.ValueType  # 17
-global___MetricValueType = MetricValueType
+Global___MetricValueType: typing_extensions.TypeAlias = MetricValueType
 
 @typing.final
 class Dimension(google.protobuf.message.Message):
@@ -311,7 +311,7 @@ class Dimension(google.protobuf.message.Message):
     And we want to define a date range of interest for our queries
     Use DATE_TRUNC(CAST(dimension.name, DATETIME), DateGranularity) to ensure we can use WHERE date range correctly
     """
-    type: global___DimensionType.ValueType
+    type: Global___DimensionType.ValueType
     """The type of the dimension, e.g. CATEGORICAL or TIME."""
     value_type: builtins.str
     """The type of the values of the dimension, e.g. STRING, INTEGER, FLOAT, etc.
@@ -319,9 +319,9 @@ class Dimension(google.protobuf.message.Message):
     """
     display_name: builtins.str
     """The display name."""
-    value_type_enum: global___DimensionValueType.ValueType
+    value_type_enum: Global___DimensionValueType.ValueType
     @property
-    def type_params(self) -> global___DimensionTypeParams:
+    def type_params(self) -> Global___DimensionTypeParams:
         """The parameters of the dimension type."""
 
     @property
@@ -338,18 +338,18 @@ class Dimension(google.protobuf.message.Message):
         name: builtins.str = ...,
         description: builtins.str = ...,
         expr: builtins.str = ...,
-        type: global___DimensionType.ValueType = ...,
-        type_params: global___DimensionTypeParams | None = ...,
+        type: Global___DimensionType.ValueType = ...,
+        type_params: Global___DimensionTypeParams | None = ...,
         top_n_values: collections.abc.Iterable[builtins.str] | None = ...,
         value_type: builtins.str = ...,
         data_source_names: collections.abc.Iterable[builtins.str] | None = ...,
         display_name: builtins.str = ...,
-        value_type_enum: global___DimensionValueType.ValueType = ...,
+        value_type_enum: Global___DimensionValueType.ValueType = ...,
     ) -> None: ...
     def HasField(self, field_name: typing.Literal["type_params", b"type_params"]) -> builtins.bool: ...
     def ClearField(self, field_name: typing.Literal["data_source_names", b"data_source_names", "description", b"description", "display_name", b"display_name", "expr", b"expr", "name", b"name", "top_n_values", b"top_n_values", "type", b"type", "type_params", b"type_params", "value_type", b"value_type", "value_type_enum", b"value_type_enum"]) -> None: ...
 
-global___Dimension = Dimension
+Global___Dimension: typing_extensions.TypeAlias = Dimension
 
 @typing.final
 class DimensionTypeParams(google.protobuf.message.Message):
@@ -357,7 +357,7 @@ class DimensionTypeParams(google.protobuf.message.Message):
 
     TIME_GRANULARITY_FIELD_NUMBER: builtins.int
     IS_PRIMARY_FIELD_NUMBER: builtins.int
-    time_granularity: global___DateGranularity.ValueType
+    time_granularity: Global___DateGranularity.ValueType
     """The date granularity of the dimension if it is a time dimension."""
     is_primary: builtins.bool
     """Note for Time dimensions: For data sources with a measure involved, a primary time dimension is required (notice the is_primary: True parameter).
@@ -366,12 +366,12 @@ class DimensionTypeParams(google.protobuf.message.Message):
     def __init__(
         self,
         *,
-        time_granularity: global___DateGranularity.ValueType = ...,
+        time_granularity: Global___DateGranularity.ValueType = ...,
         is_primary: builtins.bool = ...,
     ) -> None: ...
     def ClearField(self, field_name: typing.Literal["is_primary", b"is_primary", "time_granularity", b"time_granularity"]) -> None: ...
 
-global___DimensionTypeParams = DimensionTypeParams
+Global___DimensionTypeParams: typing_extensions.TypeAlias = DimensionTypeParams
 
 @typing.final
 class Metric(google.protobuf.message.Message):
@@ -428,7 +428,7 @@ class Metric(google.protobuf.message.Message):
     """
     denominator: builtins.str
     """The denominator of the metric if it is a ratio metric. It should be a measure."""
-    type: global___MetricType.ValueType
+    type: Global___MetricType.ValueType
     """The type of the metric, e.g. MEASURE_PROXY, CUMULATIVE, RATIO, etc.
     If the type is MEASURE_PROXY, the name of the metric must match the measure name in the expression
     """
@@ -436,7 +436,7 @@ class Metric(google.protobuf.message.Message):
     """The window of the metric if it is a cumulative metric."""
     grain_to_date: builtins.str
     """The grain of the metric if it is a cumulative metric."""
-    value_type: global___MetricValueType.ValueType
+    value_type: Global___MetricValueType.ValueType
     """The value type of the metric, e.g. INTEGER, FLOAT, etc.
     Always set this field to METRIC_VALUE_TYPE_UNKNOWN = 0
     """
@@ -463,10 +463,10 @@ class Metric(google.protobuf.message.Message):
         measures: collections.abc.Iterable[builtins.str] | None = ...,
         numerator: builtins.str = ...,
         denominator: builtins.str = ...,
-        type: global___MetricType.ValueType = ...,
+        type: Global___MetricType.ValueType = ...,
         window: builtins.str = ...,
         grain_to_date: builtins.str = ...,
-        value_type: global___MetricValueType.ValueType = ...,
+        value_type: Global___MetricValueType.ValueType = ...,
         display_name: builtins.str = ...,
         is_numeric: builtins.bool = ...,
     ) -> None: ...
@@ -474,7 +474,7 @@ class Metric(google.protobuf.message.Message):
     def ClearField(self, field_name: typing.Literal["cumulative_process", b"cumulative_process", "denominator", b"denominator", "description", b"description", "display_name", b"display_name", "expression", b"expression", "grain_to_date", b"grain_to_date", "id", b"id", "is_numeric", b"is_numeric", "measures", b"measures", "name", b"name", "numerator", b"numerator", "table_name", b"table_name", "type", b"type", "value_type", b"value_type", "view_id_of_table", b"view_id_of_table", "window", b"window"]) -> None: ...
     def WhichOneof(self, oneof_group: typing.Literal["cumulative_process", b"cumulative_process"]) -> typing.Literal["window", "grain_to_date"] | None: ...
 
-global___Metric = Metric
+Global___Metric: typing_extensions.TypeAlias = Metric
 
 @typing.final
 class DateStrRange(google.protobuf.message.Message):
@@ -494,7 +494,7 @@ class DateStrRange(google.protobuf.message.Message):
     ) -> None: ...
     def ClearField(self, field_name: typing.Literal["end_date", b"end_date", "start_date", b"start_date"]) -> None: ...
 
-global___DateStrRange = DateStrRange
+Global___DateStrRange: typing_extensions.TypeAlias = DateStrRange
 
 @typing.final
 class QueryArgs(google.protobuf.message.Message):
@@ -554,7 +554,7 @@ class QueryArgs(google.protobuf.message.Message):
         """The list of dimensions selected by the pipeline, but are incompatible for the request."""
 
     @property
-    def date_ranges(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[global___DateStrRange]:
+    def date_ranges(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[Global___DateStrRange]:
         """The date ranges to be queried."""
 
     def __init__(
@@ -570,7 +570,7 @@ class QueryArgs(google.protobuf.message.Message):
         having_clause: builtins.str = ...,
         incompatible_metrics: collections.abc.Iterable[builtins.str] | None = ...,
         incompatible_dimensions: collections.abc.Iterable[builtins.str] | None = ...,
-        date_ranges: collections.abc.Iterable[global___DateStrRange] | None = ...,
+        date_ranges: collections.abc.Iterable[Global___DateStrRange] | None = ...,
         sql_explanation: builtins.str = ...,
         level: builtins.str = ...,
         time_increment: builtins.str = ...,
@@ -578,7 +578,7 @@ class QueryArgs(google.protobuf.message.Message):
     ) -> None: ...
     def ClearField(self, field_name: typing.Literal["date_ranges", b"date_ranges", "date_where_clause", b"date_where_clause", "group_by_columns", b"group_by_columns", "having_clause", b"having_clause", "incompatible_dimensions", b"incompatible_dimensions", "incompatible_metrics", b"incompatible_metrics", "level", b"level", "limit", b"limit", "main_data_source_name", b"main_data_source_name", "metrics", b"metrics", "metrics_expression", b"metrics_expression", "order_by", b"order_by", "sql_explanation", b"sql_explanation", "time_increment", b"time_increment", "where_clause", b"where_clause"]) -> None: ...
 
-global___QueryArgs = QueryArgs
+Global___QueryArgs: typing_extensions.TypeAlias = QueryArgs
 
 @typing.final
 class DatasourceMetadata(google.protobuf.message.Message):
@@ -587,16 +587,16 @@ class DatasourceMetadata(google.protobuf.message.Message):
     LOCATION_FIELD_NUMBER: builtins.int
     PROPERTY_ID_FIELD_NUMBER: builtins.int
     PROPERTY_NAME_FIELD_NUMBER: builtins.int
-    location: global___DataSourceIntegration.ValueType
+    location: Global___DataSourceIntegration.ValueType
     property_id: builtins.str
     property_name: builtins.str
     def __init__(
         self,
         *,
-        location: global___DataSourceIntegration.ValueType = ...,
+        location: Global___DataSourceIntegration.ValueType = ...,
         property_id: builtins.str = ...,
         property_name: builtins.str = ...,
     ) -> None: ...
     def ClearField(self, field_name: typing.Literal["location", b"location", "property_id", b"property_id", "property_name", b"property_name"]) -> None: ...
 
-global___DatasourceMetadata = DatasourceMetadata
+Global___DatasourceMetadata: typing_extensions.TypeAlias = DatasourceMetadata

{findly_unified_reporting_sdk-0.7.13 → findly_unified_reporting_sdk-0.7.15}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "findly.unified-reporting-sdk"
-version = "0.7.13"
+version = "0.7.15"
 license = "GPL-3.0-only"
 description = ""
 authors = []
@@ -15,7 +15,7 @@ include = [
 [tool.poetry.dependencies]
 python = "^3.9"
 pandas = "^2.2.3"
-protobuf = "^4.25.3"
+protobuf = "^6.33.5"
 backoff = "^2.2.1"
 aiocache = "^0.12.2"
 facebook-business = "^22.0.5"
@@ -23,7 +23,6 @@ sqlglot = "^26.17.1"
 google-analytics-admin = "^0.24.0"
 google-analytics-data = "^0.18.18"
 google-api-python-client = "^2.169.0"
-oauth2client = "^4.1.3"
 
 [tool.poetry.group.typing.dependencies]
 mypy = "^1.15.0"
@@ -33,7 +32,7 @@ types-protobuf = "^6.30.2.20250506"
 [tool.poetry.group.dev.dependencies]
 pytest = "^8.3.5"
 pytest-asyncio = "^0.26.0"
-mypy-protobuf = "^3.6.0"
+mypy-protobuf = "^3.7.0"
 python-dotenv = "^1.0.1"
 
 [build-system]

findly_unified_reporting_sdk-0.7.13/findly/unified_reporting_sdk/util/create_numeric_string_series.py

@@ -1,16 +0,0 @@
-import pandas as pd
-
-DEFAULT_FLOAT_PRECISION = 2
-
-
-def create_numeric_string_series(
-    col: pd.Series, precision: int = DEFAULT_FLOAT_PRECISION
-) -> pd.Series:
-    try:
-        numeric_col: pd.Series = pd.to_numeric(col)
-        if (numeric_col.dropna() % 1 == 0).all():
-            return numeric_col.astype(int).astype(str)
-        else:
-            return numeric_col.astype(float).round(precision).astype(str)
-    except Exception:
-        return col