openlineage-python 1.26.0__tar.gz → 1.27.0__tar.gz

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openlineage-python
-Version: 1.26.0
+Version: 1.27.0
 Summary: OpenLineage Python Client
 Author-email: OpenLineage <info@openlineage.io>
 Keywords: openlineage

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/docs/conf.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 # Configuration file for the Sphinx documentation builder.

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/docs/convert.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 import json

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/__init__.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/client.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/constants.py

@@ -1,8 +1,8 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 
-__version__ = "1.26.0"
+__version__ = "1.27.0"
 
 DEFAULT_TIMEOUT_MS = 5000
 DEFAULT_NAMESPACE_NAME = "default"

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/event_v2.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/facet.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 import warnings
 from enum import Enum

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/facet_v2.py

@@ -1,10 +1,11 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from openlineage.client.generated import (
     column_lineage_dataset,
     data_quality_assertions_dataset,
     data_quality_metrics_input_dataset,
+    dataset_type_dataset,
     dataset_version_dataset,
     datasource_dataset,
     documentation_dataset,
@@ -28,6 +29,9 @@ from openlineage.client.generated import (
     sql_job,
     storage_dataset,
     symlinks_dataset,
+    tags_dataset,
+    tags_job,
+    tags_run,
 )
 from openlineage.client.generated.base import (
     PRODUCER,
@@ -52,6 +56,7 @@ __all__ = [
     "column_lineage_dataset",
     "data_quality_assertions_dataset",
     "data_quality_metrics_input_dataset",
+    "dataset_type_dataset",
     "dataset_version_dataset",
     "datasource_dataset",
     "documentation_dataset",
@@ -75,4 +80,7 @@ __all__ = [
     "sql_job",
     "storage_dataset",
     "symlinks_dataset",
+    "tags_dataset",
+    "tags_job",
+    "tags_run",
 ]

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/facets.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/filter.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/base.py

@@ -1,10 +1,10 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations
 
 from enum import Enum
-from typing import ClassVar
+from typing import Any, ClassVar, cast
 
 import attr
 from openlineage.client.constants import DEFAULT_PRODUCER
@@ -86,6 +86,26 @@ class BaseFacet(RedactMixin):
     def skip_redact(self) -> list[str]:
         return self._base_skip_redact + self._additional_skip_redact
 
+    def with_additional_properties(self, **kwargs: dict[str, Any]) -> BaseFacet:
+        """Add additional properties to updated class instance."""
+        current_attrs = [a.name for a in attr.fields(self.__class__)]
+
+        new_class = attr.make_class(
+            self.__class__.__name__,
+            {k: attr.field() for k in kwargs if k not in current_attrs},
+            bases=(self.__class__,),
+        )
+        new_class.__module__ = self.__class__.__module__
+        attrs = attr.fields(self.__class__)
+        for a in attrs:
+            if not a.init:
+                continue
+            attr_name = a.name  # To deal with private attributes.
+            init_name = a.alias
+            if init_name not in kwargs:
+                kwargs[init_name] = getattr(self, attr_name)
+        return cast(BaseFacet, new_class(**kwargs))
+
     @staticmethod
     def _get_schema() -> str:
         return "https://openlineage.io/spec/2-0-2/OpenLineage.json#/$defs/BaseFacet"

openlineage_python-1.27.0/openlineage/client/generated/column_lineage_dataset.py

@@ -0,0 +1,137 @@
+# Copyright 2018-2025 contributors to the OpenLineage project
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from typing import Any, ClassVar, cast
+
+import attr
+from openlineage.client.generated.base import DatasetFacet
+from openlineage.client.utils import RedactMixin
+
+
+@attr.define
+class ColumnLineageDatasetFacet(DatasetFacet):
+    fields: dict[str, Fields]
+    """Column level lineage that maps output fields into input fields used to evaluate them."""
+
+    dataset: list[InputField] | None = attr.field(factory=list)
+    """
+    Column level lineage that affects the whole dataset. This includes filtering, sorting, grouping
+    (aggregates), joining, window functions, etc.
+    """
+
+    @staticmethod
+    def _get_schema() -> str:
+        return "https://openlineage.io/spec/facets/1-2-0/ColumnLineageDatasetFacet.json#/$defs/ColumnLineageDatasetFacet"
+
+
+@attr.define
+class Fields(RedactMixin):
+    inputFields: list[InputField]  # noqa: N815
+    transformationDescription: str | None = attr.field(default=None)  # noqa: N815
+    """a string representation of the transformation applied"""
+
+    transformationType: str | None = attr.field(default=None)  # noqa: N815
+    """
+    IDENTITY|MASKED reflects a clearly defined behavior. IDENTITY: exact same as input; MASKED: no
+    original data available (like a hash of PII for example)
+    """
+
+    def with_additional_properties(self, **kwargs: dict[str, Any]) -> Fields:
+        """Add additional properties to updated class instance."""
+        current_attrs = [a.name for a in attr.fields(self.__class__)]
+
+        new_class = attr.make_class(
+            self.__class__.__name__,
+            {k: attr.field() for k in kwargs if k not in current_attrs},
+            bases=(self.__class__,),
+        )
+        new_class.__module__ = self.__class__.__module__
+        attrs = attr.fields(self.__class__)
+        for a in attrs:
+            if not a.init:
+                continue
+            attr_name = a.name  # To deal with private attributes.
+            init_name = a.alias
+            if init_name not in kwargs:
+                kwargs[init_name] = getattr(self, attr_name)
+        return cast(Fields, new_class(**kwargs))
+
+
+@attr.define
+class InputField(RedactMixin):
+    """Represents a single dependency on some field (column)."""
+
+    namespace: str
+    """The input dataset namespace"""
+
+    name: str
+    """The input dataset name"""
+
+    field: str
+    """The input field"""
+
+    transformations: list[Transformation] | None = attr.field(factory=list)
+    _skip_redact: ClassVar[list[str]] = ["namespace", "name", "field"]
+
+    def with_additional_properties(self, **kwargs: dict[str, Any]) -> InputField:
+        """Add additional properties to updated class instance."""
+        current_attrs = [a.name for a in attr.fields(self.__class__)]
+
+        new_class = attr.make_class(
+            self.__class__.__name__,
+            {k: attr.field() for k in kwargs if k not in current_attrs},
+            bases=(self.__class__,),
+        )
+        new_class.__module__ = self.__class__.__module__
+        attrs = attr.fields(self.__class__)
+        for a in attrs:
+            if not a.init:
+                continue
+            attr_name = a.name  # To deal with private attributes.
+            init_name = a.alias
+            if init_name not in kwargs:
+                kwargs[init_name] = getattr(self, attr_name)
+        return cast(InputField, new_class(**kwargs))
+
+    @staticmethod
+    def _get_schema() -> str:
+        return "https://openlineage.io/spec/facets/1-2-0/ColumnLineageDatasetFacet.json#/$defs/InputField"
+
+
+@attr.define
+class Transformation(RedactMixin):
+    type: str
+    """The type of the transformation. Allowed values are: DIRECT, INDIRECT"""
+
+    subtype: str | None = attr.field(default=None)
+    """The subtype of the transformation"""
+
+    description: str | None = attr.field(default=None)
+    """a string representation of the transformation applied"""
+
+    masking: bool | None = attr.field(default=None)
+    """is transformation masking the data or not"""
+
+    _skip_redact: ClassVar[list[str]] = ["type", "subtype", "masking"]
+
+    def with_additional_properties(self, **kwargs: dict[str, Any]) -> Transformation:
+        """Add additional properties to updated class instance."""
+        current_attrs = [a.name for a in attr.fields(self.__class__)]
+
+        new_class = attr.make_class(
+            self.__class__.__name__,
+            {k: attr.field() for k in kwargs if k not in current_attrs},
+            bases=(self.__class__,),
+        )
+        new_class.__module__ = self.__class__.__module__
+        attrs = attr.fields(self.__class__)
+        for a in attrs:
+            if not a.init:
+                continue
+            attr_name = a.name  # To deal with private attributes.
+            init_name = a.alias
+            if init_name not in kwargs:
+                kwargs[init_name] = getattr(self, attr_name)
+        return cast(Transformation, new_class(**kwargs))

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/data_quality_assertions_dataset.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/data_quality_metrics_input_dataset.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

openlineage_python-1.27.0/openlineage/client/generated/dataset_type_dataset.py

@@ -0,0 +1,24 @@
+# Copyright 2018-2025 contributors to the OpenLineage project
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from typing import ClassVar
+
+import attr
+from openlineage.client.generated.base import DatasetFacet
+
+
+@attr.define
+class DatasetTypeDatasetFacet(DatasetFacet):
+    datasetType: str  # noqa: N815
+    """Dataset type, for example: FILE|STREAM|MODEL|TABLE|VIEW."""
+
+    subType: str | None = attr.field(default=None)  # noqa: N815
+    """Optional sub-type within the dataset type (e.g., BEST VALIDATION under MODEL CHECKPOINT)."""
+
+    _additional_skip_redact: ClassVar[list[str]] = ["datasetType", "subType"]
+
+    @staticmethod
+    def _get_schema() -> str:
+        return "https://openlineage.io/spec/facets/1-0-0/DatasetTypeDatasetFacet.json#/$defs/DatasetTypeDatasetFacet"

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/dataset_version_dataset.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/datasource_dataset.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/documentation_dataset.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/documentation_job.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/environment_variables_run.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/error_message_run.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/external_query_run.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/extraction_error_run.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/input_statistics_input_dataset.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/job_type_job.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/lifecycle_state_change_dataset.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/nominal_time_run.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/output_statistics_output_dataset.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/ownership_dataset.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/ownership_job.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/parent_run.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/processing_engine_run.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/schema_dataset.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/source_code_job.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/source_code_location_job.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/sql_job.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/storage_dataset.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/generated/symlinks_dataset.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

openlineage_python-1.27.0/openlineage/client/generated/tags_dataset.py

@@ -0,0 +1,37 @@
+# Copyright 2018-2025 contributors to the OpenLineage project
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+import attr
+from openlineage.client.generated.base import DatasetFacet
+from openlineage.client.utils import RedactMixin
+
+
+@attr.define
+class TagsDatasetFacet(DatasetFacet):
+    tags: list[TagsDatasetFacetFields] | None = attr.field(factory=list)
+    """The tags applied to the dataset facet"""
+
+    @staticmethod
+    def _get_schema() -> str:
+        return "https://openlineage.io/spec/facets/1-0-0/TagsDatasetFacet.json#/$defs/TagsDatasetFacet"
+
+
+@attr.define
+class TagsDatasetFacetFields(RedactMixin):
+    key: str
+    """Key that identifies the tag"""
+
+    value: str
+    """The value of the field"""
+
+    source: str | None = attr.field(default=None)
+    """The source of the tag. INTEGRATION|USER|DBT CORE|SPARK|etc."""
+
+    field: str | None = attr.field(default=None)
+    """Identifies the field in a dataset if a tag applies to one"""
+
+    @staticmethod
+    def _get_schema() -> str:
+        return "https://openlineage.io/spec/facets/1-0-0/TagsDatasetFacet.json#/$defs/TagsDatasetFacetFields"

openlineage_python-1.27.0/openlineage/client/generated/tags_job.py

@@ -0,0 +1,34 @@
+# Copyright 2018-2025 contributors to the OpenLineage project
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+import attr
+from openlineage.client.generated.base import JobFacet
+from openlineage.client.utils import RedactMixin
+
+
+@attr.define
+class TagsJobFacet(JobFacet):
+    tags: list[TagsJobFacetFields] | None = attr.field(factory=list)
+    """The tags applied to the job facet"""
+
+    @staticmethod
+    def _get_schema() -> str:
+        return "https://openlineage.io/spec/facets/1-0-0/TagsJobFacet.json#/$defs/TagsJobFacet"
+
+
+@attr.define
+class TagsJobFacetFields(RedactMixin):
+    key: str
+    """Key that identifies the tag"""
+
+    value: str
+    """The value of the field"""
+
+    source: str | None = attr.field(default=None)
+    """The source of the tag. INTEGRATION|USER|DBT CORE|SPARK|etc."""
+
+    @staticmethod
+    def _get_schema() -> str:
+        return "https://openlineage.io/spec/facets/1-0-0/TagsJobFacet.json#/$defs/TagsJobFacetFields"

openlineage_python-1.27.0/openlineage/client/generated/tags_run.py

@@ -0,0 +1,34 @@
+# Copyright 2018-2025 contributors to the OpenLineage project
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+import attr
+from openlineage.client.generated.base import RunFacet
+from openlineage.client.utils import RedactMixin
+
+
+@attr.define
+class TagsRunFacet(RunFacet):
+    tags: list[TagsRunFacetFields] | None = attr.field(factory=list)
+    """The tags applied to the run facet"""
+
+    @staticmethod
+    def _get_schema() -> str:
+        return "https://openlineage.io/spec/facets/1-0-0/TagsRunFacet.json#/$defs/TagsRunFacet"
+
+
+@attr.define
+class TagsRunFacetFields(RedactMixin):
+    key: str
+    """Key that identifies the tag"""
+
+    value: str
+    """The value of the field"""
+
+    source: str | None = attr.field(default=None)
+    """The source of the tag. INTEGRATION|USER|DBT CORE|SPARK|etc."""
+
+    @staticmethod
+    def _get_schema() -> str:
+        return "https://openlineage.io/spec/facets/1-0-0/TagsRunFacet.json#/$defs/TagsRunFacetFields"

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/run.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 import uuid
 import warnings

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/serde.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/transport/__init__.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/transport/composite.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/transport/console.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/transport/factory.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/transport/file.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 
 from __future__ import annotations
@@ -49,7 +49,7 @@ class FileTransport(Transport):
             log_file_path = self.config.log_file_path
         else:
             time_str = datetime.now().strftime("%Y%m%d-%H%M%S.%f")
-            log_file_path = f"{self.config.log_file_path}-{time_str}"
+            log_file_path = f"{self.config.log_file_path}-{time_str}.json"
 
         log.debug("Openlineage event will be emitted to file: `%s`", log_file_path)
         try:

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/transport/http.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/transport/kafka.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/transport/msk_iam.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/transport/noop.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/transport/transport.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 """
 To implement custom Transport implement Config and Transport classes.

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/utils.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/openlineage/client/uuid.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/pyproject.toml

@@ -6,7 +6,7 @@ requires = [
 
 [project]
 name = "openlineage-python"
-version = "1.26.0"
+version = "1.27.0"
 description = "OpenLineage Python Client"
 readme = "README.md"
 keywords = [
@@ -66,9 +66,11 @@ run.plugins = ["covdefaults"]
 
 [tool.mypy]
 disable_error_code = "no-redef"
+warn_redundant_casts = true
 show_error_codes = true
 overrides = [
   { ignore_missing_imports = true, module = [
   "confluent_kafka.*",
 ] } ]
 strict = true
+pretty = true

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/redact_fields.yml

@@ -74,6 +74,12 @@
       redact_fields: []
     - class_name: DataQualityMetricsInputDatasetFacet
       redact_fields: []
+- module: dataset_type_dataset
+  classes:
+    - class_name: DatasetTypeDatasetFacet
+      redact_fields:
+        - datasetType
+        - subType
 - module: dataset_version_dataset
   classes:
     - class_name: DatasetVersionDatasetFacet
@@ -204,3 +210,21 @@
       redact_fields: []
     - class_name: SymlinksDatasetFacet
       redact_fields: []
+- module: tags_dataset
+  classes:
+    - class_name: TagsDatasetFacetFields
+      redact_fields: []
+    - class_name: TagsDatasetFacet
+      redact_fields: []
+- module: tags_job
+  classes:
+    - class_name: TagsJobFacetFields
+      redact_fields: []
+    - class_name: TagsJobFacet
+      redact_fields: []
+- module: tags_run
+  classes:
+    - class_name: TagsRunFacetFields
+      redact_fields: []
+    - class_name: TagsRunFacet
+      redact_fields: []

openlineage_python-1.27.0/tests/__init__.py

@@ -0,0 +1,2 @@
+# Copyright 2018-2025 contributors to the OpenLineage project
+# SPDX-License-Identifier: Apache-2.0

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/tests/conftest.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/tests/test_client.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/tests/test_composite.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/tests/test_events.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/tests/test_facet.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/tests/test_facet_v2.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 
@@ -6,7 +6,7 @@ import json
 import os
 from unittest import mock
 
-from attr import define
+from attr import asdict, define
 from openlineage.client.client import OpenLineageClient
 from openlineage.client.event_v2 import (
     BaseEvent,
@@ -202,3 +202,47 @@ def test_full_core_event_serializes_properly() -> None:
             expected_event = json.load(f)
 
         assert expected_event == event_sent
+
+
+def test_with_additional_properties_adds_new_properties():
+    base_facet = BaseFacet()
+    changed_facet = base_facet.with_additional_properties(new_prop="new_value")
+
+    assert hasattr(changed_facet, "new_prop")
+    assert changed_facet.new_prop == "new_value"
+
+
+def test_with_additional_properties_updates_existing_properties():
+    documentation_facet = documentation_job.DocumentationJobFacet(description="desc")
+    changed_facet = documentation_facet.with_additional_properties(description="new_value")
+
+    assert changed_facet.description == "new_value"
+
+
+def test_with_additional_properties_does_not_overwrite_class_level_attributes():
+    base_facet = BaseFacet()
+    original_attrs = base_facet.__class__.__attrs_attrs__
+    base_facet.with_additional_properties(new_prop="new_value")
+
+    assert base_facet.__class__.__attrs_attrs__ == original_attrs
+
+
+def test_with_additional_properties_works_with_attr_asdict():
+    documentation_facet = documentation_job.DocumentationJobFacet(description="desc")
+    changed_facet = documentation_facet.with_additional_properties(new_prop="new_value")
+
+    assert asdict(changed_facet) == {
+        "_producer": "https://github.com/OpenLineage/OpenLineage/blob/v1-0-0/client",
+        "_schemaURL": "https://openlineage.io/spec/facets/1-0-1/DocumentationJobFacet.json#/$defs/DocumentationJobFacet",
+        "_deleted": None,
+        "description": "desc",
+        "new_prop": "new_value",
+    }
+
+
+def test_with_additional_properties_isinstance_works():
+    documentation_facet = documentation_job.DocumentationJobFacet(description="desc")
+    changed_facet = documentation_facet.with_additional_properties(new_prop="new_value")
+
+    assert isinstance(changed_facet, documentation_job.DocumentationJobFacet)
+    assert isinstance(changed_facet, BaseFacet)

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/tests/test_factory.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/tests/test_file.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 import datetime
 import json
@@ -119,7 +119,7 @@ def test_file_transport_raises_error_with_non_writeable_file(mock_dt, append) ->
         config = FileConfig(log_file_path=log_base_file_path, append=append)
         transport = FileTransport(config)
 
-        log_file_path = log_base_file_path if append else f"{log_base_file_path}-timestr"
+        log_file_path = log_base_file_path if append else f"{log_base_file_path}-timestr.json"
 
         # Create the file and make it read-only
         with open(log_file_path, "w") as f:
@@ -132,6 +132,32 @@ def test_file_transport_raises_error_with_non_writeable_file(mock_dt, append) ->
         os.remove(log_file_path)
 
 
+@mock.patch("openlineage.client.transport.file.datetime")
+def test_file_transport_file_path_has_valid_extension_when_not_in_append_mode(mock_dt) -> None:
+    event = RunEvent(
+        eventType=RunState.START,
+        eventTime=datetime.datetime.now().isoformat(),
+        run=Run(runId=str(generate_new_uuid())),
+        job=Job(namespace="file", name="test"),
+        producer="prod",
+    )
+    mock_dt.now().strftime.return_value = "timestr"
+
+    with tempfile.TemporaryDirectory() as log_dir:
+        log_base_file_path = join(log_dir, "logtest")
+
+        config = FileConfig(log_file_path=log_base_file_path, append=False)
+        transport = FileTransport(config)
+
+        log_file_path = f"{log_base_file_path}-timestr.json"
+
+        assert not os.path.exists(log_file_path)
+        transport.emit(event)
+        assert os.path.exists(log_file_path)
+
+        os.remove(log_file_path)
+
+
 @pytest.mark.parametrize(
     "append",
     [

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/tests/test_http.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/tests/test_kafka.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/tests/test_msk_iam.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/tests/test_utils.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/tests/test_uuid.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

{openlineage_python-1.26.0 → openlineage_python-1.27.0}/tests/transport.py

@@ -1,4 +1,4 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
+# Copyright 2018-2025 contributors to the OpenLineage project
 # SPDX-License-Identifier: Apache-2.0
 from __future__ import annotations
 

openlineage_python-1.26.0/openlineage/client/generated/column_lineage_dataset.py

@@ -1,77 +0,0 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
-# SPDX-License-Identifier: Apache-2.0
-
-from __future__ import annotations
-
-from typing import ClassVar
-
-import attr
-from openlineage.client.generated.base import DatasetFacet
-from openlineage.client.utils import RedactMixin
-
-
-@attr.define
-class ColumnLineageDatasetFacet(DatasetFacet):
-    fields: dict[str, Fields]
-    """Column level lineage that maps output fields into input fields used to evaluate them."""
-
-    dataset: list[InputField] | None = attr.field(factory=list)
-    """
-    Column level lineage that affects the whole dataset. This includes filtering, sorting, grouping
-    (aggregates), joining, window functions, etc.
-    """
-
-    @staticmethod
-    def _get_schema() -> str:
-        return "https://openlineage.io/spec/facets/1-2-0/ColumnLineageDatasetFacet.json#/$defs/ColumnLineageDatasetFacet"
-
-
-@attr.define
-class Fields(RedactMixin):
-    inputFields: list[InputField]  # noqa: N815
-    transformationDescription: str | None = attr.field(default=None)  # noqa: N815
-    """a string representation of the transformation applied"""
-
-    transformationType: str | None = attr.field(default=None)  # noqa: N815
-    """
-    IDENTITY|MASKED reflects a clearly defined behavior. IDENTITY: exact same as input; MASKED: no
-    original data available (like a hash of PII for example)
-    """
-
-
-@attr.define
-class InputField(RedactMixin):
-    """Represents a single dependency on some field (column)."""
-
-    namespace: str
-    """The input dataset namespace"""
-
-    name: str
-    """The input dataset name"""
-
-    field: str
-    """The input field"""
-
-    transformations: list[Transformation] | None = attr.field(factory=list)
-    _skip_redact: ClassVar[list[str]] = ["namespace", "name", "field"]
-
-    @staticmethod
-    def _get_schema() -> str:
-        return "https://openlineage.io/spec/facets/1-2-0/ColumnLineageDatasetFacet.json#/$defs/InputField"
-
-
-@attr.define
-class Transformation(RedactMixin):
-    type: str
-    """The type of the transformation. Allowed values are: DIRECT, INDIRECT"""
-
-    subtype: str | None = attr.field(default=None)
-    """The subtype of the transformation"""
-
-    description: str | None = attr.field(default=None)
-    """a string representation of the transformation applied"""
-
-    masking: bool | None = attr.field(default=None)
-    """is transformation masking the data or not"""
-
-    _skip_redact: ClassVar[list[str]] = ["type", "subtype", "masking"]

openlineage_python-1.26.0/tests/__init__.py

@@ -1,2 +0,0 @@
-# Copyright 2018-2024 contributors to the OpenLineage project
-# SPDX-License-Identifier: Apache-2.0