metricflow 0.206.0.dev2__tar.gz → 0.206.0.dev3__tar.gz

{metricflow-0.206.0.dev2 → metricflow-0.206.0.dev3}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.1
 Name: metricflow
-Version: 0.206.0.dev2
+Version: 0.206.0.dev3
 Summary: Translates a simple metric definition into reusable SQL and executes it against the SQL engine of your choice.
-Project-URL: Documentation, https://transform.co/metricflow
-Project-URL: Source Code, https://github.com/transform-data/metricflow
+Project-URL: Documentation, https://docs.getdbt.com/docs/build/about-metricflow
+Project-URL: Source Code, https://github.com/dbt-labs/metricflow
 Author: dbt Labs
 License-Expression: BUSL-1.1
 License-File: LICENSE
@@ -13,14 +13,14 @@ Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
-Requires-Python: <3.12,>=3.8
+Requires-Python: <3.13,>=3.8
 Requires-Dist: dbt-semantic-interfaces<0.6.0,>=0.5.1
 Requires-Dist: graphviz<0.21,>=0.18.2
 Requires-Dist: jinja2>=3.1.3
 Requires-Dist: more-itertools<10.2.0,>=8.10.0
-Requires-Dist: pandas<1.6.0,>=1.5.0
 Requires-Dist: pydantic<1.11.0,>=1.10.0
 Requires-Dist: python-dateutil<2.9.0,>=2.8.2
 Requires-Dist: pyyaml<7.0.0,>=6.0

metricflow-0.206.0.dev3/metricflow/data_table/column_types.py

@@ -0,0 +1,22 @@
+from __future__ import annotations
+
+import datetime
+import decimal
+from typing import Sequence, Tuple, Type, Union
+
+# Types supported by `MetricFlowDataTable`.
+CellValue = Union[float, str, datetime.datetime, bool, None]
+# Types supported as inputs when building a `MetricFlowDataTable`. These inputs will get converted into
+# one of the `CellValue` types.
+InputCellValue = Union[int, float, str, datetime.datetime, bool, None, decimal.Decimal, datetime.date]
+MetricflowNoneType = type(None)
+
+
+def row_cell_types(row: Sequence[CellValue]) -> Tuple[Type[CellValue], ...]:
+    """Return the cell type / column type for the objects in the row."""
+    return tuple(cell_type(cell) for cell in row)
+
+
+def cell_type(cell_value: CellValue) -> Type[CellValue]:
+    """Return the cell type / column type for the object in the cell."""
+    return type(cell_value)

metricflow-0.206.0.dev3/metricflow/data_table/mf_column.py

@@ -0,0 +1,39 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from functools import cached_property
+from typing import Iterator, Sequence, Tuple, Type
+
+from metricflow.data_table.column_types import CellValue
+
+
+@dataclass(frozen=True)
+class ColumnDescription:
+    """Describes a single column in a data table."""
+
+    column_name: str
+    column_type: Type[CellValue]
+
+    def with_lower_case_column_name(self) -> ColumnDescription:  # noqa: D102
+        return ColumnDescription(
+            column_name=self.column_name.lower(),
+            column_type=self.column_type,
+        )
+
+
+@dataclass(frozen=True)
+class ColumnDescriptionSet:
+    """Describes a collection of columns in a data table."""
+
+    column_descriptions: Tuple[ColumnDescription, ...]
+
+    def __iter__(self) -> Iterator[ColumnDescription]:  # noqa: D105
+        return iter(self.column_descriptions)
+
+    @cached_property
+    def column_names(self) -> Sequence[str]:  # noqa: D102
+        return tuple(column_description.column_name for column_description in self.column_descriptions)
+
+    @cached_property
+    def column_types(self) -> Sequence[Type]:  # noqa: D102
+        return tuple(column_description.column_type for column_description in self.column_descriptions)

metricflow-0.206.0.dev3/metricflow/data_table/mf_table.py

@@ -0,0 +1,274 @@
+from __future__ import annotations
+
+import datetime
+import itertools
+import logging
+from dataclasses import dataclass
+from decimal import Decimal
+from typing import Iterable, Iterator, List, Optional, Sequence, Tuple, Type
+
+import tabulate
+from metricflow_semantics.mf_logging.formatting import indent
+from metricflow_semantics.mf_logging.pretty_print import mf_pformat, mf_pformat_many
+from typing_extensions import Self
+
+from metricflow.data_table.column_types import CellValue, InputCellValue, row_cell_types
+from metricflow.data_table.mf_column import ColumnDescription
+
+logger = logging.getLogger(__name__)
+
+
+@dataclass(frozen=True, eq=False)
+class MetricFlowDataTable:
+    """Container for tabular data stored in memory.
+
+    This is feature-limited and is used to pass tabular data for tests and the CLI. The only data types that are
+    supported are described by `CellValue`.
+
+    When constructing the table, additional input types (as described by `InputCellValue`) can be used, but those
+    additional types will be converted into one of the `CellValue` types.
+
+    Don't use `=` to compare tables as there many be NaNs. Instead, use `check_data_tables_are_equal`.
+    """
+
+    column_descriptions: Tuple[ColumnDescription, ...]
+    rows: Tuple[Tuple[CellValue, ...], ...]
+
+    def __post_init__(self) -> None:  # noqa: D105
+        expected_column_count = self.column_count
+        for row_index, row in enumerate(self.rows):
+            # Check that the number of columns in the rows match.
+            row_column_count = len(row)
+            assert row_column_count == expected_column_count, (
+                f"Row at index {row_index} has {row_column_count} columns instead of {expected_column_count}. "
+                f"Row is:"
+                f"\n{indent(mf_pformat(row))}"
+            )
+            # Check that the type of the object in the rows match.
+            for column_index, cell_value in enumerate(row):
+                expected_cell_value_type = self.column_descriptions[column_index].column_type
+                assert cell_value is None or isinstance(cell_value, expected_cell_value_type), mf_pformat_many(
+                    "Cell value type mismatch.",
+                    {
+                        "row_index": row_index,
+                        "column_index": column_index,
+                        "expected_cell_value_type": expected_cell_value_type,
+                        "actual_cell_value_type": type(cell_value),
+                        "cell_value": cell_value,
+                    },
+                )
+                # Check that datetimes don't have a timezone set.
+                if isinstance(cell_value, datetime.datetime):
+                    assert cell_value.tzinfo is None, mf_pformat_many(
+                        "Time zone provided for datetime.",
+                        {
+                            "row_index": row_index,
+                            "column_index": column_index,
+                            "cell_value": cell_value,
+                        },
+                    )
+
+    @property
+    def column_count(self) -> int:  # noqa: D102
+        return len(self.column_descriptions)
+
+    @property
+    def row_count(self) -> int:  # noqa: D102
+        return len(self.rows)
+
+    def column_name_index(self, column_name: str) -> int:
+        """Return the index of the column that matches the given name. Raises `ValueError` if the name is invalid."""
+        for i, column_description in enumerate(self.column_descriptions):
+            if column_description.column_name == column_name:
+                return i
+        raise ValueError(
+            f"Unknown column name {repr(column_name)}. Known column names are:"
+            f"\n{indent(mf_pformat([column_name for column_name in self.column_descriptions]))}"
+        )
+
+    @property
+    def column_names(self) -> Sequence[str]:  # noqa: D102
+        return tuple(column_description.column_name for column_description in self.column_descriptions)
+
+    def column_values_iterator(self, column_index: int) -> Iterator[CellValue]:
+        """Returns an iterator for values of the column at the tiven index."""
+        return (row[column_index] for row in self.rows)
+
+    def _sorted_by_column_name(self) -> MetricFlowDataTable:  # noqa: D102
+        new_rows: List[List[CellValue]] = [[] for _ in range(self.row_count)]
+        sorted_column_names = sorted(self.column_names)
+        for column_name in sorted_column_names:
+            old_column_index = self.column_name_index(column_name)
+            for row_index, cell_value in enumerate(self.column_values_iterator(old_column_index)):
+                new_rows[row_index].append(cell_value)
+
+        return MetricFlowDataTable(
+            column_descriptions=tuple(
+                self.column_descriptions[self.column_name_index(column_name)] for column_name in sorted_column_names
+            ),
+            rows=tuple(
+                tuple(row_dict[column_index] for column_index in range(self.column_count)) for row_dict in new_rows
+            ),
+        )
+
+    def _sorted_by_row(self) -> MetricFlowDataTable:  # noqa: D102
+        def _cell_sort_key(cell: CellValue) -> str:
+            if isinstance(cell, datetime.datetime):
+                return cell.isoformat()
+            return str(cell)
+
+        def _row_sort_key(row: Tuple[CellValue, ...]) -> Tuple[str, ...]:
+            return tuple(_cell_sort_key(cell) for cell in row)
+
+        return MetricFlowDataTable(
+            column_descriptions=self.column_descriptions,
+            rows=tuple(sorted((row for row in self.rows), key=_row_sort_key)),
+        )
+
+    def sorted(self) -> MetricFlowDataTable:
+        """Returns this but with the columns in order by name, and the rows in order by values."""
+        return self._sorted_by_column_name()._sorted_by_row()
+
+    def text_format(self, float_decimals: int = 2) -> str:
+        """Return a text version of this table that is suitable for printing."""
+        str_rows: List[List[str]] = []
+        for row in self.rows:
+            str_row: List[str] = []
+            for cell_value in row:
+                if isinstance(cell_value, float):
+                    str_row.append(f"{cell_value:.{float_decimals}f}")
+                    continue
+
+                if isinstance(cell_value, datetime.datetime):
+                    str_row.append(cell_value.isoformat())
+                    continue
+
+                str_row.append(str(cell_value))
+            str_rows.append(str_row)
+        return tabulate.tabulate(
+            tabular_data=tuple(tuple(str_row) for str_row in str_rows),
+            headers=tuple(column_description.column_name for column_description in self.column_descriptions),
+        )
+
+    def with_lower_case_column_names(self) -> MetricFlowDataTable:
+        """Return this but with columns names in lowercase."""
+        return MetricFlowDataTable(
+            column_descriptions=tuple(
+                column_description.with_lower_case_column_name() for column_description in self.column_descriptions
+            ),
+            rows=self.rows,
+        )
+
+    def get_cell_value(self, row_index: int, column_index: int) -> CellValue:  # noqa: D102
+        return self.rows[row_index][column_index]
+
+    @staticmethod
+    def create_from_rows(  # noqa: D102
+        column_names: Sequence[str], rows: Iterable[Sequence[InputCellValue]]
+    ) -> MetricFlowDataTable:
+        builder = _MetricFlowDataTableBuilder(column_names)
+        for row in rows:
+            builder.add_row(row)
+        return builder.build()
+
+
+class _MetricFlowDataTableBuilder:
+    """Helps build `MetricFlowDataTable`, one row at a time.
+
+    This validates each row as it is input to give better error messages.
+    """
+
+    def __init__(self, column_names: Sequence[str]) -> None:  # noqa: D107
+        self._rows: List[Tuple[CellValue, ...]] = []
+        self._column_names = tuple(column_names)
+
+    def _build_table_from_rows(self) -> MetricFlowDataTable:  # noqa: D102
+        # Figure out the type of the column based on the types of the values in the rows.
+        # Can't use the type of the columns in the first row because it might contain None, so iterate through the rows
+        # and use the first non-None type.
+        column_types_so_far: Optional[Tuple[Type[CellValue], ...]] = None
+        cell_value: CellValue
+        for row in self._rows:
+            if column_types_so_far is None:
+                column_types_so_far = row_cell_types(row)
+                continue
+
+            # If the types of the objects in the row are the same, no need for updates.
+            row_column_types = row_cell_types(row)
+            if row_column_types == column_types_so_far:
+                continue
+
+            # Types of objects in the row are different from what's known so far.
+            # They can only be different in that one can be None and other can be not None.
+            updated_column_types: List[Type[CellValue]] = []
+            for column_type_so_far, cell_type, cell_value in itertools.zip_longest(
+                column_types_so_far, row_column_types, row
+            ):
+                if column_type_so_far is cell_type:
+                    updated_column_types.append(column_type_so_far)
+                elif column_type_so_far is type(None) and cell_type is not None:
+                    updated_column_types.append(cell_type)
+                elif column_type_so_far is not None and cell_type is type(None):
+                    updated_column_types.append(column_type_so_far)
+                else:
+                    raise ValueError(f"Expected cell type {column_type_so_far} but got: {cell_type}")
+
+            column_types_so_far = tuple(updated_column_types)
+
+        # Empty table case.
+        if column_types_so_far is None:
+            column_types_so_far = tuple(type(None) for _ in range(len(self._column_names)))
+
+        final_column_types = column_types_so_far
+
+        return MetricFlowDataTable(
+            column_descriptions=tuple(
+                ColumnDescription(column_name=column_name, column_type=column_type)
+                for column_name, column_type in itertools.zip_longest(self._column_names, final_column_types)
+            ),
+            rows=tuple(self._rows),
+        )
+
+    def _convert_row_to_supported_types(self, row: Sequence[InputCellValue]) -> Sequence[CellValue]:
+        """Since only a limited set of types are supported, convert the input type to the supported type."""
+        updated_row: List[CellValue] = []
+        for cell_value in row:
+            if (
+                cell_value is None
+                or isinstance(cell_value, float)
+                or isinstance(cell_value, bool)
+                or isinstance(cell_value, int)
+                or isinstance(cell_value, str)
+            ):
+                updated_row.append(cell_value)
+                continue
+
+            if isinstance(cell_value, datetime.datetime):
+                updated_row.append(cell_value.replace(tzinfo=None))
+                continue
+
+            if isinstance(cell_value, Decimal):
+                updated_row.append(float(cell_value))
+                continue
+
+            if isinstance(cell_value, datetime.date):
+                updated_row.append(datetime.datetime.combine(cell_value, datetime.datetime.min.time()))
+                continue
+
+            raise ValueError(f"Row cell has unexpected type: {repr(cell_value)}")
+        return updated_row
+
+    def add_row(self, row: Sequence[InputCellValue], parse_strings: bool = False) -> Self:  # noqa: D102
+        row = tuple(row)
+        expected_column_count = len(self._column_names)
+        actual_column_count = len(row)
+        if actual_column_count != expected_column_count:
+            raise ValueError(
+                f"Input row has {actual_column_count} columns, but expected {expected_column_count} columns. Row is:"
+                f"\n{indent(mf_pformat(row))}"
+            )
+        self._rows.append(tuple(self._convert_row_to_supported_types(row)))
+        return self
+
+    def build(self) -> MetricFlowDataTable:  # noqa: D102
+        return self._build_table_from_rows()