WorkspaceFile

laktory.models.resources.databricks.WorkspaceFile

Bases: RenderableFileMixin, WorkspaceFileBase

Databricks Workspace File

Examples:

import io

from laktory import models

file_yaml = '''
source: ./notebooks/dlt/dlt_laktory_pl.py
dirpath: notebooks/dlt/
'''
file = models.resources.databricks.WorkspaceFile.model_validate_yaml(
    io.StringIO(file_yaml)
)
print(file.path)
# > /.laktory/notebooks/dlt/dlt_laktory_pl.py

References

• Databricks Workspace File

BASE	DESCRIPTION
content_base64	The base64-encoded file content. Conflicts with source. Use of content_base64 is discouraged, as it's increasing memory footprint of Terraform state and should only be used in exceptional circumstances, like creating a workspace file with configuration properties for a data pipeline TYPE: str | None | VariableType DEFAULT: None
md5	TYPE: str | None | VariableType DEFAULT: None
object_id	Unique identifier for a workspace file TYPE: int | None | VariableType DEFAULT: None

LAKTORY	DESCRIPTION
access_controls	Access controls list TYPE: list[AccessControl | VariableType] | VariableType DEFAULT: []
dirpath	Workspace directory inside rootpath in which the workspace file is deployed. Used only if path is not specified. TYPE: str | VariableType DEFAULT: None
path_	Workspace filepath for the file. Overwrite dirpath. TYPE: str | VariableType DEFAULT: None
render_vars	If True, resolve ${vars.x} / ${{ expr }} placeholders in this file's content before upload. Resolved content is staged under settings.build_root; the staged copy is (re)written whenever Stack.build() runs (which preview, deploy, destroy and build all trigger). TYPE: bool DEFAULT: False
source_	Path to file on local filesystem. TYPE: str | VariableType DEFAULT: None

METHOD	DESCRIPTION
build	Render ${vars.x}/${{ expr }} placeholders in the file content
check_staged	Raise a clear error if this resource is configured for variable

ATTRIBUTE	DESCRIPTION
filename	File filename TYPE: str | None

filename property

File filename

build(vars=None)

Render ${vars.x}/${{ expr }} placeholders in the file content and stage the result under settings.build_root, if render_vars is True. No-op otherwise.

Source code in laktory/models/resources/databricks/workspacefile.py

def build(self, vars: dict = None):
    """
    Render `${vars.x}`/`${{ expr }}` placeholders in the file content
    and stage the result under `settings.build_root`, if `render_vars`
    is `True`. No-op otherwise.
    """
    if self.render_vars:
        self._render_to_staged_path(self.source_, self.source, vars=vars)

check_staged()

Raise a clear error if this resource is configured for variable rendering but its staged copy hasn't been written yet (i.e. .build() hasn't run). Guards against programmatic use that bypasses Stack.build() (the normal CLI flow always calls it before dumping resources).

Source code in laktory/models/resources/databricks/_renderablefile.py

def check_staged(self):
    """
    Raise a clear error if this resource is configured for variable
    rendering but its staged copy hasn't been written yet (i.e.
    `.build()` hasn't run). Guards against programmatic use that
    bypasses `Stack.build()` (the normal CLI flow always calls it
    before dumping resources).
    """
    if not self.render_vars:
        return
    staged = self._rendered_field_value
    if staged and not Path(staged).exists():
        raise RuntimeError(
            f"'{staged}' has not been rendered yet. Run `laktory build` "
            "(or `preview`/`deploy`, which trigger it automatically) "
            "before this resource is used."
        )