etlplus 0.4.9__py3-none-any.whl → 0.5.1__py3-none-any.whl

etlplus/cli/app.py

@@ -25,6 +25,7 @@ Subcommands
 - ``validate``: validate data against rules
 - ``transform``: transform records
 - ``load``: load data to files, databases, or REST APIs
+- ``render``: render SQL DDL from table schema specs
 
 Notes
 -----
@@ -60,6 +61,7 @@ from .handlers import cmd_extract
 from .handlers import cmd_list
 from .handlers import cmd_load
 from .handlers import cmd_pipeline
+from .handlers import cmd_render
 from .handlers import cmd_run
 from .handlers import cmd_transform
 from .handlers import cmd_validate
@@ -258,6 +260,67 @@ PipelineConfigOption = Annotated[
     ),
 ]
 
+RenderConfigOption = Annotated[
+    str | None,
+    typer.Option(
+        '--config',
+        metavar='PATH',
+        help='Pipeline YAML that includes table_schemas for rendering.',
+        show_default=False,
+    ),
+]
+
+RenderOutputOption = Annotated[
+    str | None,
+    typer.Option(
+        '--output',
+        '-o',
+        metavar='PATH',
+        help='Write rendered SQL to PATH (default: stdout).',
+    ),
+]
+
+RenderSpecOption = Annotated[
+    str | None,
+    typer.Option(
+        '--spec',
+        metavar='PATH',
+        help='Standalone table spec file (.yml/.yaml/.json).',
+        show_default=False,
+    ),
+]
+
+RenderTableOption = Annotated[
+    str | None,
+    typer.Option(
+        '--table',
+        metavar='NAME',
+        help='Filter to a single table name from table_schemas.',
+    ),
+]
+
+RenderTemplateOption = Annotated[
+    str,
+    typer.Option(
+        '--template',
+        '-t',
+        metavar='KEY|PATH',
+        help='Template key (ddl/view) or path to a Jinja template file.',
+        show_default=True,
+    ),
+]
+
+RenderTemplatePathOption = Annotated[
+    str | None,
+    typer.Option(
+        '--template-path',
+        metavar='PATH',
+        help=(
+            'Explicit path to a Jinja template file (overrides template key).'
+        ),
+    ),
+]
+
 
 # SECTION: DATA CLASSES ===================================================== #
 
@@ -1001,6 +1064,55 @@ def pipeline_cmd(
     return int(cmd_pipeline(ns))
 
 
+@app.command('render')
+def render_cmd(
+    ctx: typer.Context,
+    config: RenderConfigOption = None,
+    spec: RenderSpecOption = None,
+    table: RenderTableOption = None,
+    template: RenderTemplateOption = 'ddl',
+    template_path: RenderTemplatePathOption = None,
+    output: RenderOutputOption = None,
+) -> int:
+    """
+    Render SQL DDL from table schemas defined in YAML/JSON configs.
+
+    Parameters
+    ----------
+    ctx : typer.Context
+        Typer execution context provided to the command.
+    config : RenderConfigOption, optional
+        Pipeline YAML containing ``table_schemas`` entries.
+    spec : RenderSpecOption, optional
+        Standalone table spec file (.yml/.yaml/.json).
+    table : RenderTableOption, optional
+        Filter to a single table name within the available specs.
+    template : RenderTemplateOption, optional
+        Built-in template key or template file path.
+    template_path : RenderTemplatePathOption, optional
+        Explicit template file path to render with.
+    output : RenderOutputOption, optional
+        Path to write SQL to (stdout when omitted).
+
+    Returns
+    -------
+    int
+        Zero on success.
+    """
+    state = _ensure_state(ctx)
+    ns = _stateful_namespace(
+        state,
+        command='render',
+        config=config,
+        spec=spec,
+        table=table,
+        template=template,
+        template_path=template_path,
+        output=output,
+    )
+    return int(cmd_render(ns))
+
+
 @app.command('run')
 def run_cmd(
     ctx: typer.Context,

etlplus/cli/handlers.py

@@ -18,6 +18,8 @@ from typing import cast
 
 from ..config import PipelineConfig
 from ..config import load_pipeline_config
+from ..ddl import load_table_spec
+from ..ddl import render_tables
 from ..enums import FileFormat
 from ..extract import extract
 from ..file import File
@@ -38,6 +40,7 @@ __all__ = [
     'cmd_list',
     'cmd_load',
     'cmd_pipeline',
+    'cmd_render',
     'cmd_run',
     'cmd_transform',
     'cmd_validate',
@@ -47,6 +50,37 @@ __all__ = [
 # SECTION: INTERNAL FUNCTIONS =============================================== #
 
 
+def _collect_table_specs(
+    config_path: str | None,
+    spec_path: str | None,
+) -> list[dict[str, Any]]:
+    """
+    Load table schemas from a pipeline config and/or standalone spec.
+
+    Parameters
+    ----------
+    config_path : str | None
+        Path to a pipeline YAML config file.
+    spec_path : str | None
+        Path to a standalone table spec file.
+
+    Returns
+    -------
+    list[dict[str, Any]]
+        Collected table specification mappings.
+    """
+    specs: list[dict[str, Any]] = []
+
+    if spec_path:
+        specs.append(load_table_spec(Path(spec_path)))
+
+    if config_path:
+        cfg = load_pipeline_config(config_path, substitute=True)
+        specs.extend(getattr(cfg, 'table_schemas', []))
+
+    return specs
+
+
 def _emit_json(
     data: Any,
     *,
@@ -75,6 +109,23 @@ def _emit_json(
     print(dumped)
 
 
+def _explicit_cli_format(
+    args: argparse.Namespace,
+) -> str | None:
+    """Return the explicit CLI format hint when provided."""
+
+    if not getattr(args, '_format_explicit', False):
+        return None
+    for attr in ('format', 'target_format', 'source_format'):
+        value = getattr(args, attr, None)
+        if value is None:
+            continue
+        normalized = value.strip().lower()
+        if normalized:
+            return normalized
+    return None
+
+
 def _infer_payload_format(
     text: str,
 ) -> str:
@@ -134,23 +185,6 @@ def _list_sections(
     return sections
 
 
-def _explicit_cli_format(
-    args: argparse.Namespace,
-) -> str | None:
-    """Return the explicit CLI format hint when provided."""
-
-    if not getattr(args, '_format_explicit', False):
-        return None
-    for attr in ('format', 'target_format', 'source_format'):
-        value = getattr(args, attr, None)
-        if value is None:
-            continue
-        normalized = value.strip().lower()
-        if normalized:
-            return normalized
-    return None
-
-
 def _materialize_file_payload(
     source: object,
     *,
@@ -224,7 +258,6 @@ def _parse_text_payload(
     JSONData | str
         The parsed payload as JSON data or raw text.
     """
-
     effective = (fmt or '').strip().lower() or _infer_payload_format(text)
     if effective == 'json':
         return cast(JSONData, json_type(text))
@@ -265,7 +298,8 @@ def _pipeline_summary(
 def _presentation_flags(
     args: argparse.Namespace,
 ) -> tuple[bool, bool]:
-    """Return presentation toggles from the parsed namespace.
+    """
+    Return presentation toggles from the parsed namespace.
 
     Parameters
     ----------
@@ -342,7 +376,6 @@ def _resolve_cli_payload(
         Parsed payload or the original source value when hydration is
         disabled.
     """
-
     if isinstance(source, (os.PathLike, str)) and str(source) == '-':
         text = _read_stdin_text()
         return _parse_text_payload(text, format_hint)
@@ -628,6 +661,67 @@ def cmd_pipeline(
     return 0
 
 
+def cmd_render(
+    args: argparse.Namespace,
+) -> int:
+    """Render SQL DDL statements from table schema specs."""
+
+    _pretty, quiet = _presentation_flags(args)
+
+    template_value = getattr(args, 'template', 'ddl') or 'ddl'
+    template_path = getattr(args, 'template_path', None)
+    table_filter = getattr(args, 'table', None)
+    spec_path = getattr(args, 'spec', None)
+    config_path = getattr(args, 'config', None)
+
+    # If the provided template points to a file, treat it as a path override.
+    file_override = template_path
+    template_key = template_value
+    if template_path is None:
+        candidate_path = Path(template_value)
+        if candidate_path.exists():
+            file_override = str(candidate_path)
+            template_key = None
+
+    specs = _collect_table_specs(config_path, spec_path)
+    if table_filter:
+        specs = [
+            spec
+            for spec in specs
+            if str(spec.get('table')) == table_filter
+            or str(spec.get('name', '')) == table_filter
+        ]
+
+    if not specs:
+        target_desc = table_filter or 'table_schemas'
+        print(
+            'No table schemas found for '
+            f'{target_desc}. Provide --spec or a pipeline --config with '
+            'table_schemas.',
+            file=sys.stderr,
+        )
+        return 1
+
+    rendered_chunks = render_tables(
+        specs,
+        template=template_key,
+        template_path=file_override,
+    )
+    sql_text = (
+        '\n'.join(chunk.rstrip() for chunk in rendered_chunks).rstrip() + '\n'
+    )
+
+    output_path = getattr(args, 'output', None)
+    if output_path and output_path != '-':
+        Path(output_path).write_text(sql_text, encoding='utf-8')
+        if not quiet:
+            print(f'Rendered {len(specs)} schema(s) to {output_path}')
+        return 0
+
+    print(sql_text)
+    return 0
+
+
 def cmd_list(args: argparse.Namespace) -> int:
     """
     Print requested pipeline sections from a YAML configuration.

etlplus/cli/main.py

@@ -28,6 +28,7 @@ from .handlers import cmd_extract
 from .handlers import cmd_list
 from .handlers import cmd_load
 from .handlers import cmd_pipeline
+from .handlers import cmd_render
 from .handlers import cmd_run
 from .handlers import cmd_transform
 from .handlers import cmd_validate
@@ -441,6 +442,42 @@ def create_parser() -> argparse.ArgumentParser:
     )
     pipe_parser.set_defaults(func=cmd_pipeline)
 
+    render_parser = subparsers.add_parser(
+        'render',
+        help='Render SQL DDL from table schema specs',
+        formatter_class=argparse.ArgumentDefaultsHelpFormatter,
+    )
+    render_parser.add_argument(
+        '--config',
+        help='Pipeline YAML containing table_schemas',
+    )
+    render_parser.add_argument(
+        '-o',
+        '--output',
+        help='Write SQL to this path (stdout when omitted)',
+    )
+    render_parser.add_argument(
+        '--spec',
+        help='Standalone table spec file (.yml/.yaml/.json)',
+    )
+    render_parser.add_argument(
+        '--table',
+        help='Render only the table matching this name',
+    )
+    render_parser.add_argument(
+        '--template',
+        default='ddl',
+        help='Template key (ddl/view) or path to a Jinja template file',
+    )
+    render_parser.add_argument(
+        '--template-path',
+        dest='template_path',
+        help=(
+            'Explicit path to a Jinja template file (overrides template key).'
+        ),
+    )
+    render_parser.set_defaults(func=cmd_render)
+
     list_parser = subparsers.add_parser(
         'list',
         help='List ETL pipeline metadata',

etlplus/config/pipeline.py

@@ -190,6 +190,8 @@ class PipelineConfig:
         Target connectors, parsed tolerantly.
     jobs : list[JobConfig]
         Job orchestration definitions.
+    table_schemas : list[dict[str, Any]]
+        Optional DDL-style table specifications used by the render command.
     """
 
     # -- Attributes -- #
@@ -208,6 +210,7 @@ class PipelineConfig:
     transforms: dict[str, dict[str, Any]] = field(default_factory=dict)
     targets: list[Connector] = field(default_factory=list)
     jobs: list[JobConfig] = field(default_factory=list)
+    table_schemas: list[dict[str, Any]] = field(default_factory=list)
 
     # -- Class Methods -- #
 
@@ -312,6 +315,13 @@ class PipelineConfig:
         # Jobs
         jobs = _build_jobs(raw)
 
+        # Table schemas (optional, tolerant pass-through structures).
+        table_schemas: list[dict[str, Any]] = []
+        for entry in raw.get('table_schemas', []) or []:
+            spec = maybe_mapping(entry)
+            if spec is not None:
+                table_schemas.append(dict(spec))
+
         return cls(
             name=name,
             version=version,
@@ -325,4 +335,5 @@ class PipelineConfig:
             transforms=transforms,
             targets=targets,
             jobs=jobs,
+            table_schemas=table_schemas,
         )

etlplus/ddl.py

@@ -0,0 +1,197 @@
+"""
+:mod:`etlplus.ddl` module.
+
+DDL rendering utilities for pipeline table schemas.
+
+Exposes helpers to load YAML/JSON table specs and render them into SQL via
+Jinja templates. Mirrors the behavior of ``tools/render_ddl.py`` so the CLI
+can emit DDLs without shelling out to that script.
+"""
+
+from __future__ import annotations
+
+import importlib.resources
+import json
+import os
+from collections.abc import Iterable
+from collections.abc import Mapping
+from pathlib import Path
+from typing import Any
+
+from jinja2 import DictLoader
+from jinja2 import Environment
+from jinja2 import FileSystemLoader
+from jinja2 import StrictUndefined
+
+# SECTION: EXPORTS ========================================================== #
+
+
+__all__ = [
+    'TEMPLATES',
+    'load_table_spec',
+    'render_table_sql',
+    'render_tables',
+]
+
+
+# SECTION: CONSTANTS ======================================================== #
+
+
+TEMPLATES = {
+    'ddl': 'ddl.sql.j2',
+    'view': 'view.sql.j2',
+}
+
+
+# SECTION: INTERNAL FUNCTIONS =============================================== #
+
+
+def _build_env(
+    *,
+    template_key: str | None,
+    template_path: str | None,
+) -> Environment:
+    """Return a Jinja2 environment using a built-in or file template."""
+    file_override = template_path or os.environ.get('TEMPLATE_NAME')
+    if file_override:
+        path = Path(file_override)
+        if not path.exists():
+            raise FileNotFoundError(f'Template file not found: {path}')
+        loader = FileSystemLoader(str(path.parent))
+        env = Environment(
+            loader=loader,
+            undefined=StrictUndefined,
+            trim_blocks=True,
+            lstrip_blocks=True,
+        )
+        env.globals['TEMPLATE_NAME'] = path.name
+        return env
+
+    key = (template_key or 'ddl').strip()
+    if key not in TEMPLATES:
+        choices = ', '.join(sorted(TEMPLATES))
+        raise ValueError(
+            f'Unknown template key "{key}". Choose from: {choices}',
+        )
+
+    # Load template from package data
+    template_filename = TEMPLATES[key]
+    template_source = _load_template_text(template_filename)
+
+    env = Environment(
+        loader=DictLoader({key: template_source}),
+        undefined=StrictUndefined,
+        trim_blocks=True,
+        lstrip_blocks=True,
+    )
+    env.globals['TEMPLATE_NAME'] = key
+    return env
+
+
+def _load_template_text(filename: str) -> str:
+    """Return the raw template text bundled with the package."""
+
+    try:
+        return (
+            importlib.resources.files(
+                'etlplus.templates',
+            )
+            .joinpath(filename)
+            .read_text(encoding='utf-8')
+        )
+    except FileNotFoundError as exc:  # pragma: no cover - deployment guard
+        raise FileNotFoundError(
+            f'Could not load template {filename} '
+            f'from etlplus.templates package data.',
+        ) from exc
+
+
+# SECTION: FUNCTIONS ======================================================== #
+
+
+def load_table_spec(path: Path | str) -> dict[str, Any]:
+    """Load a table spec from JSON or YAML."""
+
+    spec_path = Path(path)
+    text = spec_path.read_text(encoding='utf-8')
+    suffix = spec_path.suffix.lower()
+
+    if suffix == '.json':
+        return json.loads(text)
+
+    if suffix in {'.yml', '.yaml'}:
+        try:
+            import yaml  # type: ignore
+        except Exception as exc:  # pragma: no cover
+            raise RuntimeError(
+                'Missing dependency: pyyaml is required for YAML specs.',
+            ) from exc
+        return yaml.safe_load(text)
+
+    raise ValueError('Spec must be .json, .yml, or .yaml')
+
+
+def render_table_sql(
+    spec: Mapping[str, Any],
+    *,
+    template: str | None = 'ddl',
+    template_path: str | None = None,
+) -> str:
+    """
+    Render a single table spec into SQL text.
+
+    Parameters
+    ----------
+    spec : Mapping[str, Any]
+        Table specification mapping.
+    template : str | None, optional
+        Template key to use (default: 'ddl').
+    template_path : str | None, optional
+        Path to a custom template file (overrides ``template``).
+
+    Returns
+    -------
+    str
+        Rendered SQL string.
+
+    Raises
+    ------
+    TypeError
+        If the loaded template name is not a string.
+    """
+    env = _build_env(template_key=template, template_path=template_path)
+    template_name = env.globals.get('TEMPLATE_NAME')
+    if not isinstance(template_name, str):
+        raise TypeError('TEMPLATE_NAME must be a string.')
+    tmpl = env.get_template(template_name)
+    return tmpl.render(spec=spec).rstrip() + '\n'
+
+
+def render_tables(
+    specs: Iterable[Mapping[str, Any]],
+    *,
+    template: str | None = 'ddl',
+    template_path: str | None = None,
+) -> list[str]:
+    """
+    Render multiple table specs into a list of SQL payloads.
+
+    Parameters
+    ----------
+    specs : Iterable[Mapping[str, Any]]
+        Table specification mappings.
+    template : str | None, optional
+        Template key to use (default: 'ddl').
+    template_path : str | None, optional
+        Path to a custom template file (overrides ``template``).
+
+    Returns
+    -------
+    list[str]
+        Rendered SQL strings for each table spec.
+    """
+
+    return [
+        render_table_sql(spec, template=template, template_path=template_path)
+        for spec in specs
+    ]

etlplus/templates/__init__.py

@@ -0,0 +1,5 @@
+"""
+:mod:`etlplus.templates` package.
+
+This package defines bundled Jinja2 templates for ``etlplus``.
+"""

etlplus/templates/ddl.sql.j2

@@ -0,0 +1,128 @@
+{# ---------- helpers ---------- #}
+{% macro qid(name) -%}[{{ name | replace(']', ']]') }}]{%- endmacro %}
+{% macro qname(schema, name) -%}{{ qid(schema) }}.{{ qid(name) }}{%- endmacro %}
+{% macro df_name(table, col) -%}DF_{{ table }}_{{ col }}{%- endmacro %}
+{% macro ck_name(table, col) -%}CK_{{ table }}_{{ col }}{%- endmacro %}
+
+{# ---------- create schema (optional) ---------- #}
+{% if spec.create_schema | default(true) %}
+IF
+    NOT EXISTS (
+        SELECT 1
+        FROM sys.schemas
+        WHERE name = N'{{ spec.schema }}'
+    )
+    EXEC ('CREATE SCHEMA {{ qid(spec.schema) }}');
+GO
+{% endif %}
+
+{# ---------- create table guarded ---------- #}
+{% set fqtn = qname(spec.schema, spec.table) %}
+IF OBJECT_ID(N'{{ spec.schema }}.{{ spec.table }}', N'U') IS NULL
+    BEGIN
+        CREATE TABLE {{ fqtn }} (
+        {% set ns = namespace(maxlen=0) %}
+        {% for c in spec.columns %}
+            {% set nlen = (c.name|string)|length %}
+            {% if nlen > ns.maxlen %}{% set ns.maxlen = nlen %}{% endif %}
+        {% endfor %}
+        {% set indent_cols = '            ' %}
+        {% for c in spec.columns %}
+            {# Map-safe lookups so StrictUndefined never bites on missing keys #}
+            {%- set ctype = c.get('type') -%}
+            {%- set ident = c.get('identity') -%}
+            {%- set computed = c.get('computed') -%}
+            {%- set nullable = c.get('nullable', true) -%}
+            {%- set defv = c.get('default') -%}
+            {%- set checkv = c.get('check') -%}
+            {{- indent_cols -}}{{ qid(c.name) }} {{ ctype }}
+            {%- if computed %} AS ({{ computed }}) PERSISTED{%- endif -%}
+            {%- if nullable %} NULL{%- else %} NOT NULL{%- endif -%}
+            {%- if ident %} IDENTITY({{ ident.get('seed', 1) }}, {{ ident.get('increment', 1) }}){%- endif -%}
+            {%- if defv %} CONSTRAINT {{ qid(df_name(spec.table, c.name)) }} DEFAULT ({{ defv }}){%- endif -%}
+            {%- if checkv %} CONSTRAINT {{ qid(ck_name(spec.table, c.name)) }} CHECK ({{ checkv }}){%- endif -%}
+            {{ "," if not loop.last }}
+        {% endfor %}
+
+        {%- if spec.primary_key is defined and spec.primary_key %}
+            , CONSTRAINT {{ qid(spec.primary_key.name
+                | default('PK_' ~ spec.table)) }}
+            PRIMARY KEY CLUSTERED (
+                {%- for col in spec.primary_key.columns -%}
+                    {{ qid(col) }}{{ ", " if not loop.last }}
+                {%- endfor -%}
+            )
+        {%- endif %}
+
+        {%- for uq in spec.unique_constraints | default([]) %}
+            , CONSTRAINT {{ qid(uq.name) }} UNIQUE (
+                {%- for col in uq.columns -%}
+                    {{ qid(col) }}{{ ", " if not loop.last }}
+                {%- endfor -%}
+            )
+        {%- endfor %}
+        );
+    END
+GO
+
+{# ---------- indexes ---------- #}
+{% for ix in spec.indexes | default([]) %}
+{%- set ix_unique = ix.get('unique', false) -%}
+{%- set ix_include = ix.get('include') -%}
+{%- set ix_where = ix.get('where') -%}
+IF
+    NOT EXISTS (
+        SELECT 1
+        FROM sys.indexes
+        WHERE name = N'{{ ix.name }}'
+        AND object_id = OBJECT_ID(N'{{ spec.schema }}.{{ spec.table }}')
+    )
+    BEGIN
+        CREATE{% if ix_unique %} UNIQUE{% endif %} INDEX {{ qid(ix.name) }}
+            ON {{ fqtn }} (
+                {%- for col in ix.columns -%}
+                    {{ qid(col) }}{{ ", " if not loop.last }}
+                {%- endfor -%}
+            )
+            {%- if ix_include %}
+            INCLUDE (
+                {%- for col in ix_include -%}
+                    {{ qid(col) }}{{ ", " if not loop.last }}
+                {%- endfor -%}
+            )
+            {%- endif -%}
+            {%- if ix_where %} WHERE {{ ix_where }}{% endif %};
+    END
+GO
+{% endfor %}
+
+{# ---------- foreign keys ---------- #}
+{% for fk in spec.foreign_keys | default([]) %}
+IF
+    NOT EXISTS (
+        SELECT 1
+        FROM sys.foreign_keys
+        WHERE
+            name = N'{{ fk.name }}'
+            AND parent_object_id = OBJECT_ID(N'{{ spec.schema }}.{{ spec.table }}'
+    )
+)
+BEGIN
+    ALTER TABLE {{ fqtn }} WITH CHECK
+    ADD CONSTRAINT {{ qid(fk.name) }} FOREIGN KEY (
+        {%- for col in fk.columns -%}
+            {{ qid(col) }}{{ ", " if not loop.last }}
+        {%- endfor -%}
+    ) REFERENCES
+    {{ qname(fk.ref_schema | default('dbo'), fk.ref_table) }} (
+        {%- for col in fk.ref_columns -%}
+            {{ qid(col) }}{{ ", " if not loop.last }}
+        {%- endfor -%}
+    )
+    {%- set on_upd = fk.get('on_update') -%}
+    {%- set on_del = fk.get('on_delete') -%}
+    {%- if on_upd %} ON UPDATE {{ on_upd }}{% endif -%}
+    {%- if on_del %} ON DELETE {{ on_del }}{% endif %};
+END
+GO
+{% endfor %}

etlplus/templates/view.sql.j2

@@ -0,0 +1,69 @@
+{# -- Helpers -- #}
+{% macro qid(name) -%}
+[{{ name | replace(']', ']]') }}]
+{%- endmacro %}
+
+{% macro qname(schema, name) -%}
+{{ qid(schema) }}.{{ qid(name) }}
+{%- endmacro %}
+
+{# Convert any expression to nvarchar(MAX) with N'' for NULLs #}
+{% macro to_str(expr) -%}
+ISNULL(CONVERT(NVARCHAR(MAX), {{ expr }}), N'')
+{%- endmacro %}
+
+{# Normalize truthy values to 'TRUE' / 'FALSE' #}
+{% macro truthy(expr) -%}
+IIF(CONVERT(VARCHAR(5), {{ expr }}) IN ('TRUE', '1', 'YES'), 'TRUE', 'FALSE')
+{%- endmacro %}
+
+{# -- Create schema (optional) -- #}
+{% if spec.create_schema | default(true) %}
+IF
+    NOT EXISTS (
+        SELECT 1
+        FROM sys.schemas
+        WHERE name = N'{{ spec.schema }}'
+    )
+    EXEC ('CREATE SCHEMA {{ qid(spec.schema) }}');
+GO
+{% endif %}
+
+{# -- SET options (match your source view) -- #}
+SET QUOTED_IDENTIFIER ON
+SET ANSI_NULLS ON
+GO
+
+{# -- Derive names with fallbacks so table-style specs also work -- #}
+{% set view_name = spec.view if spec.view is defined else ('vw_' ~ spec.table) %}
+{% set src_schema = (spec.from_schema if spec.from_schema is defined else (spec.schema if spec.schema is defined else 'dbo')) %}
+{% set src_table = (
+    spec.from_table if spec.from_table is defined else
+    (spec.source_table if spec.source_table is defined else spec.table)
+) %}
+{% set indent_cols = '    ' %}
+
+{# -- Create view -- #}
+CREATE VIEW {{ qname(spec.schema | default('dbo'), view_name) }} AS
+SELECT
+{% if spec.projections is defined and spec.projections %}
+    {% for p in spec.projections %}
+        {%- if p.type is defined and (p.type | lower)[:8] == 'nvarchar' -%}
+    {{- indent_cols -}}{{ to_str(p.expr) }} AS {{ qid(p.alias) }}
+        {%- else -%}
+    {{- indent_cols -}}{{ p.expr }}
+        {%- endif -%}
+    {{ "," if not loop.last }}
+    {% endfor %}
+{% else %}
+    {% for c in spec.columns | default([]) %}
+        {%- if c.type is defined and (c.type | lower)[:8] == 'nvarchar' -%}
+    {{- indent_cols -}}{{ to_str(qid(c.name)) }} AS {{ qid(c.name) }}
+        {%- else -%}
+    {{- indent_cols -}}{{ qid(c.name) }}
+        {%- endif -%}
+    {{ "," if not loop.last }}
+    {% endfor %}
+{%- endif %}
+FROM {{ qname(src_schema, src_table) }};
+GO

{etlplus-0.4.9.dist-info → etlplus-0.5.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: etlplus
-Version: 0.4.9
+Version: 0.5.1
 Summary: A Swiss Army knife for simple ETL operations
 Home-page: https://github.com/Dagitali/ETLPlus
 Author: ETLPlus Team

{etlplus-0.4.9.dist-info → etlplus-0.5.1.dist-info}/RECORD

@@ -1,6 +1,7 @@
 etlplus/__init__.py,sha256=M2gScnyir6WOMAh_EuoQIiAzdcTls0_5hbd_Q6of8I0,1021
 etlplus/__main__.py,sha256=btoROneNiigyfBU7BSzPKZ1R9gzBMpxcpsbPwmuHwTM,479
 etlplus/__version__.py,sha256=1E0GMK_yUWCMQFKxXjTvyMwofi0qT2k4CDNiHWiymWE,327
+etlplus/ddl.py,sha256=uYkiMTx1uDlUypnXCYy0K5ARnHRMHFVzzg8PizBQRLg,5306
 etlplus/enums.py,sha256=V_j18Ud2BCXpFsBk2pZGrvCVrvAMJ7uja1z9fppFGso,10175
 etlplus/extract.py,sha256=f44JdHhNTACxgn44USx05paKTwq7LQY-V4wANCW9hVM,6173
 etlplus/file.py,sha256=RxIAsGDN4f_vNA2B5-ct88JNd_ISAyYbooIRE5DstS8,17972
@@ -31,21 +32,24 @@ etlplus/api/rate_limiting/__init__.py,sha256=ZySB1dZettEDnWvI1EHf_TZ9L08M_kKsNR-
 etlplus/api/rate_limiting/config.py,sha256=2b4wIynblN-1EyMqI4aXa71SljzSjXYh5N1Nngr3jOg,9406
 etlplus/api/rate_limiting/rate_limiter.py,sha256=Uxozqd_Ej5Lsj-M-mLT2WexChgWh7x35_YP10yqYPQA,7159
 etlplus/cli/__init__.py,sha256=J97-Rv931IL1_b4AXnB7Fbbd7HKnHBpx18NQfC_kE6c,299
-etlplus/cli/app.py,sha256=A8MxgKpJs9_KeyAgkopLrdJnB0SH24Mlxituh9Uwmrw,32991
-etlplus/cli/handlers.py,sha256=mObms9k-3XoImECNW-CpOqQkJzlRtDlobU3sHMu4itM,16190
-etlplus/cli/main.py,sha256=rl0NmZdzWwlGQSVyzWYutbBwHWOmBFYJcEjl6fYhwm0,15395
+etlplus/cli/app.py,sha256=buGIIoSIu5cxbYTdPcA_iaxJaPG-eHj-LPD9OgZ0h9w,35824
+etlplus/cli/handlers.py,sha256=O7Mh9nowdMCzaV36KASWZVC4fNMEg9xnVZXE7NHW6P8,18873
+etlplus/cli/main.py,sha256=5qWAKqlRtnb4VEpBfGT45q-LBxi_2hSMnw23jNyYA_Q,16497
 etlplus/config/__init__.py,sha256=VZWzOg7d2YR9NT6UwKTv44yf2FRUMjTHynkm1Dl5Qzo,1486
 etlplus/config/connector.py,sha256=0-TIwevHbKRHVmucvyGpPd-3tB1dKHB-dj0yJ6kq5eY,9809
 etlplus/config/jobs.py,sha256=hmzRCqt0OvCEZZR4ONKrd3lvSv0OmayjLc4yOBk3ug8,7399
-etlplus/config/pipeline.py,sha256=7w0WWe21vvPJvTlJoRTZh2j92I1_GOcdwan6xyKfQII,8973
+etlplus/config/pipeline.py,sha256=Va4MQY6KEyKqHGMKPmh09ZcGpx95br-iNUjpkqtzVbw,9500
 etlplus/config/profile.py,sha256=Ss2zedQGjkaGSpvBLTD4SZaWViMJ7TJPLB8Q2_BTpPg,1898
 etlplus/config/types.py,sha256=a0epJ3z16HQ5bY3Ctf8s_cQPa3f0HHcwdOcjCP2xoG4,4954
 etlplus/config/utils.py,sha256=4SUHMkt5bKBhMhiJm-DrnmE2Q4TfOgdNCKz8PJDS27o,3443
+etlplus/templates/__init__.py,sha256=tsniN7XJYs3NwYxJ6c2HD5upHP3CDkLx-bQCMt97UOM,106
+etlplus/templates/ddl.sql.j2,sha256=s8fMWvcb4eaJVXkifuib1aQPljtZ8buuyB_uA-ZdU3Q,4734
+etlplus/templates/view.sql.j2,sha256=Iy8DHfhq5yyvrUKDxqp_aHIEXY4Tm6j4wT7YDEFWAhk,2180
 etlplus/validation/__init__.py,sha256=Pe5Xg1_EA4uiNZGYu5WTF3j7odjmyxnAJ8rcioaplSQ,1254
 etlplus/validation/utils.py,sha256=Mtqg449VIke0ziy_wd2r6yrwJzQkA1iulZC87FzXMjo,10201
-etlplus-0.4.9.dist-info/licenses/LICENSE,sha256=MuNO63i6kWmgnV2pbP2SLqP54mk1BGmu7CmbtxMmT-U,1069
-etlplus-0.4.9.dist-info/METADATA,sha256=hEyIXQ7XwoLu5Y3fJwslHtyfLhChIxHV_BaWCz22LT4,17635
-etlplus-0.4.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-etlplus-0.4.9.dist-info/entry_points.txt,sha256=6w-2-jzuPa55spzK34h-UKh2JTEShh38adFRONNP9QE,45
-etlplus-0.4.9.dist-info/top_level.txt,sha256=aWWF-udn_sLGuHTM6W6MLh99ArS9ROkUWO8Mi8y1_2U,8
-etlplus-0.4.9.dist-info/RECORD,,
+etlplus-0.5.1.dist-info/licenses/LICENSE,sha256=MuNO63i6kWmgnV2pbP2SLqP54mk1BGmu7CmbtxMmT-U,1069
+etlplus-0.5.1.dist-info/METADATA,sha256=_jyHbbKnTHnDCxcFjzKjUbPlgJVTHfonDBExSFPGzZU,17635
+etlplus-0.5.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+etlplus-0.5.1.dist-info/entry_points.txt,sha256=6w-2-jzuPa55spzK34h-UKh2JTEShh38adFRONNP9QE,45
+etlplus-0.5.1.dist-info/top_level.txt,sha256=aWWF-udn_sLGuHTM6W6MLh99ArS9ROkUWO8Mi8y1_2U,8
+etlplus-0.5.1.dist-info/RECORD,,