etlplus 0.5.3__py3-none-any.whl → 0.5.5__py3-none-any.whl

etlplus/cli/app.py

@@ -57,14 +57,14 @@ from .. import __version__
 from ..enums import DataConnectorType
 from ..enums import FileFormat
 from ..utils import json_type
-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
+from .handlers import check_handler
+from .handlers import extract_handler
+from .handlers import load_handler
+from .handlers import pipeline_handler
+from .handlers import render_handler
+from .handlers import run_handler
+from .handlers import transform_handler
+from .handlers import validate_handler
 
 # SECTION: EXPORTS ========================================================== #
 
@@ -127,109 +127,82 @@ PROJECT_URL: Final[str] = 'https://github.com/Dagitali/ETLPlus'
 # SECTION: TYPE ALIASES ==================================================== #
 
 
-SourceInputArg = Annotated[
-    str,
-    typer.Argument(
-        ...,
-        metavar='SOURCE',
-        help=(
-            'Extract from SOURCE. Use --from/--source-type to override the '
-            'inferred connector when needed.'
-        ),
-    ),
-]
-
-StreamingSourceArg = Annotated[
+OperationsJSONOption = Annotated[
     str,
-    typer.Argument(
-        ...,
-        metavar='SOURCE',
-        help=(
-            'Data source to transform or validate (path, JSON payload, or '
-            '- for stdin).'
-        ),
+    typer.Option(
+        '--operations',
+        help='Transformation operations as JSON string.',
     ),
 ]
 
-TargetInputArg = Annotated[
+PipelineConfigOption = Annotated[
     str,
-    typer.Argument(
+    typer.Option(
         ...,
-        metavar='TARGET',
-        help=(
-            'Load JSON data from stdin into TARGET. Use --to/--target-type '
-            'to override connector inference when needed. Source data must '
-            'be piped into stdin.'
-        ),
+        '--config',
+        metavar='PATH',
+        help='Path to pipeline YAML configuration file.',
     ),
 ]
 
-SourceOverrideOption = Annotated[
+RenderConfigOption = Annotated[
     str | None,
     typer.Option(
-        '--source-type',
-        metavar='CONNECTOR',
+        '--config',
+        metavar='PATH',
+        help='Pipeline YAML that includes table_schemas for rendering.',
         show_default=False,
-        rich_help_panel='I/O overrides',
-        help='Override the inferred source type (file, database, api).',
     ),
 ]
 
-TargetOverrideOption = Annotated[
+RenderOutputOption = Annotated[
     str | None,
     typer.Option(
-        '--target-type',
-        metavar='CONNECTOR',
-        show_default=False,
-        rich_help_panel='I/O overrides',
-        help='Override the inferred target type (file, database, api).',
+        '--output',
+        '-o',
+        metavar='PATH',
+        help='Write rendered SQL to PATH (default: stdout).',
     ),
 ]
 
-SourceFormatOption = Annotated[
+RenderSpecOption = Annotated[
     str | None,
     typer.Option(
-        '--source-format',
-        metavar='FORMAT',
+        '--spec',
+        metavar='PATH',
+        help='Standalone table spec file (.yml/.yaml/.json).',
         show_default=False,
-        rich_help_panel='Format overrides',
-        help=(
-            'Input payload format when SOURCE is - or an inline payload. '
-            'File sources infer format from the extension.'
-        ),
     ),
 ]
 
-StdinFormatOption = Annotated[
+RenderTableOption = Annotated[
     str | None,
     typer.Option(
-        '--source-format',
-        metavar='FORMAT',
-        show_default=False,
-        rich_help_panel='Format overrides',
-        help='Input payload format when reading from stdin (default: json).',
+        '--table',
+        metavar='NAME',
+        help='Filter to a single table name from table_schemas.',
     ),
 ]
 
-TargetFormatOption = Annotated[
-    str | None,
+RenderTemplateOption = Annotated[
+    str,
     typer.Option(
-        '--target-format',
-        metavar='FORMAT',
-        show_default=False,
-        rich_help_panel='Format overrides',
-        help=(
-            'Payload format when TARGET is - or a non-file connector. File '
-            'targets infer format from the extension.'
-        ),
+        '--template',
+        '-t',
+        metavar='KEY|PATH',
+        help='Template key (ddl/view) or path to a Jinja template file.',
+        show_default=True,
     ),
 ]
 
-OperationsJSONOption = Annotated[
-    str,
+RenderTemplatePathOption = Annotated[
+    str | None,
     typer.Option(
-        '--operations',
-        help='Transformation operations as JSON string.',
+        '--template-path',
+        metavar='PATH',
+        help=(
+            'Explicit path to a Jinja template file (overrides template key).'
+        ),
     ),
 ]
 
@@ -241,83 +214,110 @@ RulesJSONOption = Annotated[
     ),
 ]
 
-TargetPathOption = Annotated[
+SourceFormatOption = Annotated[
     str | None,
     typer.Option(
-        '--target',
-        metavar='PATH',
-        help='Target file for transformed or validated output (- for stdout).',
+        '--source-format',
+        metavar='FORMAT',
+        show_default=False,
+        rich_help_panel='Format overrides',
+        help=(
+            'Input payload format when SOURCE is - or an inline payload. '
+            'File sources infer format from the extension.'
+        ),
     ),
 ]
 
-PipelineConfigOption = Annotated[
+SourceInputArg = Annotated[
     str,
-    typer.Option(
+    typer.Argument(
         ...,
-        '--config',
-        metavar='PATH',
-        help='Path to pipeline YAML configuration file.',
+        metavar='SOURCE',
+        help=(
+            'Extract from SOURCE. Use --from/--source-type to override the '
+            'inferred connector when needed.'
+        ),
     ),
 ]
 
-RenderConfigOption = Annotated[
+SourceOverrideOption = Annotated[
     str | None,
     typer.Option(
-        '--config',
-        metavar='PATH',
-        help='Pipeline YAML that includes table_schemas for rendering.',
+        '--source-type',
+        metavar='CONNECTOR',
         show_default=False,
+        rich_help_panel='I/O overrides',
+        help='Override the inferred source type (file, database, api).',
     ),
 ]
 
-RenderOutputOption = Annotated[
+StdinFormatOption = Annotated[
     str | None,
     typer.Option(
-        '--output',
-        '-o',
-        metavar='PATH',
-        help='Write rendered SQL to PATH (default: stdout).',
+        '--source-format',
+        metavar='FORMAT',
+        show_default=False,
+        rich_help_panel='Format overrides',
+        help='Input payload format when reading from stdin (default: json).',
     ),
 ]
 
-RenderSpecOption = Annotated[
-    str | None,
-    typer.Option(
-        '--spec',
-        metavar='PATH',
-        help='Standalone table spec file (.yml/.yaml/.json).',
-        show_default=False,
+StreamingSourceArg = Annotated[
+    str,
+    typer.Argument(
+        ...,
+        metavar='SOURCE',
+        help=(
+            'Data source to transform or validate (path, JSON payload, or '
+            '- for stdin).'
+        ),
     ),
 ]
 
-RenderTableOption = Annotated[
+TargetFormatOption = Annotated[
     str | None,
     typer.Option(
-        '--table',
-        metavar='NAME',
-        help='Filter to a single table name from table_schemas.',
+        '--target-format',
+        metavar='FORMAT',
+        show_default=False,
+        rich_help_panel='Format overrides',
+        help=(
+            'Payload format when TARGET is - or a non-file connector. File '
+            'targets infer format from the extension.'
+        ),
     ),
 ]
 
-RenderTemplateOption = Annotated[
+TargetInputArg = Annotated[
     str,
+    typer.Argument(
+        ...,
+        metavar='TARGET',
+        help=(
+            'Load JSON data from stdin into TARGET. Use --to/--target-type '
+            'to override connector inference when needed. Source data must '
+            'be piped into stdin.'
+        ),
+    ),
+]
+
+TargetOverrideOption = Annotated[
+    str | None,
     typer.Option(
-        '--template',
-        '-t',
-        metavar='KEY|PATH',
-        help='Template key (ddl/view) or path to a Jinja template file.',
-        show_default=True,
+        '--target-type',
+        metavar='CONNECTOR',
+        show_default=False,
+        rich_help_panel='I/O overrides',
+        help='Override the inferred target type (file, database, api).',
     ),
 ]
 
-RenderTemplatePathOption = Annotated[
+TargetPathOption = Annotated[
     str | None,
     typer.Option(
-        '--template-path',
+        '--target',
         metavar='PATH',
-        help=(
-            'Explicit path to a Jinja template file (overrides template key).'
-        ),
+        help='Target file for transformed or validated output (- for stdout).',
     ),
 ]
 
@@ -745,6 +745,83 @@ def _root(
         raise typer.Exit(0)
 
 
+@app.command('check')
+def check_cmd(
+    ctx: typer.Context,
+    config: PipelineConfigOption,
+    jobs: bool = typer.Option(
+        False,
+        '--jobs',
+        help='List available job names and exit',
+    ),
+    pipelines: bool = typer.Option(
+        False,
+        '--pipelines',
+        help='List ETL pipelines',
+    ),
+    sources: bool = typer.Option(
+        False,
+        '--sources',
+        help='List data sources',
+    ),
+    summary: bool = typer.Option(
+        False,
+        '--summary',
+        help='Show pipeline summary (name, version, sources, targets, jobs)',
+    ),
+    targets: bool = typer.Option(
+        False,
+        '--targets',
+        help='List data targets',
+    ),
+    transforms: bool = typer.Option(
+        False,
+        '--transforms',
+        help='List data transforms',
+    ),
+) -> int:
+    """
+    Print ETL entities from a pipeline YAML configuration.
+
+    Parameters
+    ----------
+    ctx : typer.Context
+        Typer execution context provided to the command.
+    config : PipelineConfigOption
+        Path to pipeline YAML configuration file.
+    jobs : bool, optional
+        If True, list available job names and exit.
+    pipelines : bool, optional
+        If True, list ETL pipelines.
+    sources : bool, optional
+        If True, list data sources.
+    summary : bool, optional
+        If True, show pipeline summary (name, version, sources, targets, jobs).
+    targets : bool, optional
+        If True, list data targets.
+    transforms : bool, optional
+        If True, list data transforms.
+
+    Returns
+    -------
+    int
+        Zero on success.
+    """
+    state = _ensure_state(ctx)
+    ns = _stateful_namespace(
+        state,
+        command='check',
+        config=config,
+        summary=summary,
+        pipelines=pipelines,
+        jobs=jobs,
+        sources=sources,
+        targets=targets,
+        transforms=transforms,
+    )
+    return int(check_handler(ns))
+
+
 @app.command('extract')
 def extract_cmd(
     ctx: typer.Context,
@@ -828,84 +905,7 @@ def extract_cmd(
         source=resolved_source,
         **format_kwargs,
     )
-    return int(cmd_extract(ns))
-
-
-@app.command('list')
-def list_cmd(
-    ctx: typer.Context,
-    config: PipelineConfigOption,
-    jobs: bool = typer.Option(
-        False,
-        '--jobs',
-        help='List available job names and exit',
-    ),
-    pipelines: bool = typer.Option(
-        False,
-        '--pipelines',
-        help='List ETL pipelines',
-    ),
-    sources: bool = typer.Option(
-        False,
-        '--sources',
-        help='List data sources',
-    ),
-    summary: bool = typer.Option(
-        False,
-        '--summary',
-        help='Show pipeline summary (name, version, sources, targets, jobs)',
-    ),
-    targets: bool = typer.Option(
-        False,
-        '--targets',
-        help='List data targets',
-    ),
-    transforms: bool = typer.Option(
-        False,
-        '--transforms',
-        help='List data transforms',
-    ),
-) -> int:
-    """
-    Print ETL entities from a pipeline YAML configuration.
-
-    Parameters
-    ----------
-    ctx : typer.Context
-        Typer execution context provided to the command.
-    config : PipelineConfigOption
-        Path to pipeline YAML configuration file.
-    jobs : bool, optional
-        If True, list available job names and exit.
-    pipelines : bool, optional
-        If True, list ETL pipelines.
-    sources : bool, optional
-        If True, list data sources.
-    summary : bool, optional
-        If True, show pipeline summary (name, version, sources, targets, jobs).
-    targets : bool, optional
-        If True, list data targets.
-    transforms : bool, optional
-        If True, list data transforms.
-
-    Returns
-    -------
-    int
-        Zero on success.
-    """
-    state = _ensure_state(ctx)
-    ns = _stateful_namespace(
-        state,
-        command='list',
-        config=config,
-        summary=summary,
-        pipelines=pipelines,
-        jobs=jobs,
-        sources=sources,
-        targets=targets,
-        transforms=transforms,
-    )
-    return int(cmd_list(ns))
+    return int(extract_handler(ns))
 
 
 @app.command('load')
@@ -1007,7 +1007,7 @@ def load_cmd(
         target=resolved_target,
         **format_kwargs,
     )
-    return int(cmd_load(ns))
+    return int(load_handler(ns))
 
 
 @app.command('pipeline')
@@ -1061,7 +1061,7 @@ def pipeline_cmd(
         list=jobs,
         run=run_target,
     )
-    return int(cmd_pipeline(ns))
+    return int(pipeline_handler(ns))
 
 
 @app.command('render')
@@ -1110,7 +1110,7 @@ def render_cmd(
         template_path=template_path,
         output=output,
     )
-    return int(cmd_render(ns))
+    return int(render_handler(ns))
 
 
 @app.command('run')
@@ -1157,7 +1157,7 @@ def run_cmd(
         job=job,
         pipeline=pipeline,
     )
-    return int(cmd_run(ns))
+    return int(run_handler(ns))
 
 
 @app.command('transform')
@@ -1294,7 +1294,7 @@ def transform_cmd(
         target_format=target_format_kwargs['format'],
         **target_format_kwargs,
     )
-    return int(cmd_transform(ns))
+    return int(transform_handler(ns))
 
 
 @app.command('validate')
@@ -1364,4 +1364,4 @@ def validate_cmd(
         source_format=source_format,
         **source_format_kwargs,
     )
-    return int(cmd_validate(ns))
+    return int(validate_handler(ns))

etlplus/cli/handlers.py

@@ -36,14 +36,14 @@ from ..validate import validate
 
 __all__ = [
     # Functions
-    'cmd_extract',
-    'cmd_list',
-    'cmd_load',
-    'cmd_pipeline',
-    'cmd_render',
-    'cmd_run',
-    'cmd_transform',
-    'cmd_validate',
+    'extract_handler',
+    'check_handler',
+    'load_handler',
+    'pipeline_handler',
+    'render_handler',
+    'run_handler',
+    'transform_handler',
+    'validate_handler',
 ]
 
 
@@ -148,12 +148,12 @@ def _infer_payload_format(
     return 'csv'
 
 
-def _list_sections(
+def _check_sections(
     cfg: PipelineConfig,
     args: argparse.Namespace,
 ) -> dict[str, Any]:
     """
-    Build sectioned metadata output for the list command.
+    Build sectioned metadata output for the check command.
 
     Parameters
     ----------
@@ -165,7 +165,7 @@ def _list_sections(
     Returns
     -------
     dict[str, Any]
-        Metadata output for the list command.
+        Metadata output for the check command.
     """
     sections: dict[str, Any] = {}
     if getattr(args, 'jobs', False):
@@ -423,11 +423,11 @@ def _write_json_output(
 # SECTION: FUNCTIONS ======================================================== #
 
 
-def cmd_extract(
+def check_handler(
     args: argparse.Namespace,
 ) -> int:
     """
-    Extract data from a source.
+    Print requested pipeline sections from a YAML configuration.
 
     Parameters
     ----------
@@ -439,40 +439,20 @@ def cmd_extract(
     int
         Zero on success.
     """
-    pretty, _ = _presentation_flags(args)
-    explicit_format = _explicit_cli_format(args)
-
-    if args.source == '-':
-        text = _read_stdin_text()
-        payload = _parse_text_payload(text, getattr(args, 'format', None))
-        _emit_json(payload, pretty=pretty)
-
+    cfg = load_pipeline_config(args.config, substitute=True)
+    if getattr(args, 'summary', False):
+        print_json(_pipeline_summary(cfg))
         return 0
 
-    result = extract(
-        args.source_type,
-        args.source,
-        file_format=explicit_format,
-    )
-    output_path = getattr(args, 'target', None)
-    if output_path is None:
-        output_path = getattr(args, 'output', None)
-
-    if not _write_json_output(
-        result,
-        output_path,
-        success_message='Data extracted and saved to',
-    ):
-        _emit_json(result, pretty=pretty)
-
+    print_json(_check_sections(cfg, args))
     return 0
 
 
-def cmd_validate(
+def extract_handler(
     args: argparse.Namespace,
 ) -> int:
     """
-    Validate data from a source.
+    Extract data from a source.
 
     Parameters
     ----------
@@ -484,81 +464,36 @@ def cmd_validate(
     int
         Zero on success.
     """
-    pretty, _quiet = _presentation_flags(args)
-    format_explicit: bool = getattr(args, '_format_explicit', False)
-    format_hint: str | None = getattr(args, 'source_format', None)
-    payload = cast(
-        JSONData | str,
-        _resolve_cli_payload(
-            args.source,
-            format_hint=format_hint,
-            format_explicit=format_explicit,
-        ),
-    )
-    result = validate(payload, args.rules)
-
-    target_path = getattr(args, 'target', None)
-    if target_path:
-        validated_data = result.get('data')
-        if validated_data is not None:
-            _write_json_output(
-                validated_data,
-                target_path,
-                success_message='Validation result saved to',
-            )
-        else:
-            print(
-                f'Validation failed, no data to save for {target_path}',
-                file=sys.stderr,
-            )
-    else:
-        _emit_json(result, pretty=pretty)
-
-    return 0
-
-
-def cmd_transform(
-    args: argparse.Namespace,
-) -> int:
-    """
-    Transform data from a source.
+    pretty, _ = _presentation_flags(args)
+    explicit_format = _explicit_cli_format(args)
 
-    Parameters
-    ----------
-    args : argparse.Namespace
-        Parsed command-line arguments.
+    if args.source == '-':
+        text = _read_stdin_text()
+        payload = _parse_text_payload(text, getattr(args, 'format', None))
+        _emit_json(payload, pretty=pretty)
 
-    Returns
-    -------
-    int
-        Zero on success.
-    """
-    pretty, _quiet = _presentation_flags(args)
-    format_hint: str | None = getattr(args, 'source_format', None)
-    format_explicit: bool = format_hint is not None
+        return 0
 
-    payload = cast(
-        JSONData | str,
-        _resolve_cli_payload(
-            args.source,
-            format_hint=format_hint,
-            format_explicit=format_explicit,
-        ),
+    result = extract(
+        args.source_type,
+        args.source,
+        file_format=explicit_format,
     )
-
-    data = transform(payload, args.operations)
+    output_path = getattr(args, 'target', None)
+    if output_path is None:
+        output_path = getattr(args, 'output', None)
 
     if not _write_json_output(
-        data,
-        getattr(args, 'target', None),
-        success_message='Data transformed and saved to',
+        result,
+        output_path,
+        success_message='Data extracted and saved to',
     ):
-        _emit_json(data, pretty=pretty)
+        _emit_json(result, pretty=pretty)
 
     return 0
 
 
-def cmd_load(
+def load_handler(
     args: argparse.Namespace,
 ) -> int:
     """
@@ -617,7 +552,7 @@ def cmd_load(
     return 0
 
 
-def cmd_pipeline(
+def pipeline_handler(
     args: argparse.Namespace,
 ) -> int:
     """
@@ -634,7 +569,7 @@ def cmd_pipeline(
         Zero on success.
     """
     print(
-        'DEPRECATED: use "etlplus list --summary|--jobs" or '
+        'DEPRECATED: use "etlplus check --summary|--jobs" or '
         '"etlplus run --job/--pipeline" instead of "etlplus pipeline".',
         file=sys.stderr,
     )
@@ -661,12 +596,11 @@ def cmd_pipeline(
     return 0
 
 
-def cmd_render(
+def render_handler(
     args: argparse.Namespace,
 ) -> int:
     """Render SQL DDL statements from table schema specs."""
-
-    _pretty, quiet = _presentation_flags(args)
+    _, quiet = _presentation_flags(args)
 
     template_value = getattr(args, 'template', 'ddl') or 'ddl'
     template_path = getattr(args, 'template_path', None)
@@ -722,9 +656,11 @@ def cmd_render(
     return 0
 
 
-def cmd_list(args: argparse.Namespace) -> int:
+def run_handler(
+    args: argparse.Namespace,
+) -> int:
     """
-    Print requested pipeline sections from a YAML configuration.
+    Execute an ETL job end-to-end from a pipeline YAML configuration.
 
     Parameters
     ----------
@@ -737,17 +673,22 @@ def cmd_list(args: argparse.Namespace) -> int:
         Zero on success.
     """
     cfg = load_pipeline_config(args.config, substitute=True)
-    if getattr(args, 'summary', False):
-        print_json(_pipeline_summary(cfg))
+
+    job_name = getattr(args, 'job', None) or getattr(args, 'pipeline', None)
+    if job_name:
+        result = run(job=job_name, config_path=args.config)
+        print_json({'status': 'ok', 'result': result})
         return 0
 
-    print_json(_list_sections(cfg, args))
+    print_json(_pipeline_summary(cfg))
     return 0
 
 
-def cmd_run(args: argparse.Namespace) -> int:
+def transform_handler(
+    args: argparse.Namespace,
+) -> int:
     """
-    Execute an ETL job end-to-end from a pipeline YAML configuration.
+    Transform data from a source.
 
     Parameters
     ----------
@@ -759,13 +700,75 @@ def cmd_run(args: argparse.Namespace) -> int:
     int
         Zero on success.
     """
-    cfg = load_pipeline_config(args.config, substitute=True)
+    pretty, _ = _presentation_flags(args)
+    format_hint: str | None = getattr(args, 'source_format', None)
+    format_explicit: bool = format_hint is not None
 
-    job_name = getattr(args, 'job', None) or getattr(args, 'pipeline', None)
-    if job_name:
-        result = run(job=job_name, config_path=args.config)
-        print_json({'status': 'ok', 'result': result})
-        return 0
+    payload = cast(
+        JSONData | str,
+        _resolve_cli_payload(
+            args.source,
+            format_hint=format_hint,
+            format_explicit=format_explicit,
+        ),
+    )
+
+    data = transform(payload, args.operations)
+
+    if not _write_json_output(
+        data,
+        getattr(args, 'target', None),
+        success_message='Data transformed and saved to',
+    ):
+        _emit_json(data, pretty=pretty)
+
+    return 0
+
+
+def validate_handler(
+    args: argparse.Namespace,
+) -> int:
+    """
+    Validate data from a source.
+
+    Parameters
+    ----------
+    args : argparse.Namespace
+        Parsed command-line arguments.
+
+    Returns
+    -------
+    int
+        Zero on success.
+    """
+    pretty, _ = _presentation_flags(args)
+    format_explicit: bool = getattr(args, '_format_explicit', False)
+    format_hint: str | None = getattr(args, 'source_format', None)
+    payload = cast(
+        JSONData | str,
+        _resolve_cli_payload(
+            args.source,
+            format_hint=format_hint,
+            format_explicit=format_explicit,
+        ),
+    )
+    result = validate(payload, args.rules)
+
+    target_path = getattr(args, 'target', None)
+    if target_path:
+        validated_data = result.get('data')
+        if validated_data is not None:
+            _write_json_output(
+                validated_data,
+                target_path,
+                success_message='Validation result saved to',
+            )
+        else:
+            print(
+                f'Validation failed, no data to save for {target_path}',
+                file=sys.stderr,
+            )
+    else:
+        _emit_json(result, pretty=pretty)
 
-    print_json(_pipeline_summary(cfg))
     return 0

etlplus/cli/main.py

@@ -24,14 +24,14 @@ from ..enums import FileFormat
 from ..utils import json_type
 from .app import PROJECT_URL
 from .app import app
-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
+from .handlers import check_handler
+from .handlers import extract_handler
+from .handlers import load_handler
+from .handlers import pipeline_handler
+from .handlers import render_handler
+from .handlers import run_handler
+from .handlers import transform_handler
+from .handlers import validate_handler
 
 # SECTION: EXPORTS ========================================================== #
 
@@ -329,7 +329,7 @@ def create_parser() -> argparse.ArgumentParser:
         ),
     )
     _add_format_options(extract_parser, context='source')
-    extract_parser.set_defaults(func=cmd_extract)
+    extract_parser.set_defaults(func=extract_handler)
 
     validate_parser = subparsers.add_parser(
         'validate',
@@ -346,7 +346,7 @@ def create_parser() -> argparse.ArgumentParser:
         default={},
         help='Validation rules as JSON string',
     )
-    validate_parser.set_defaults(func=cmd_validate)
+    validate_parser.set_defaults(func=validate_handler)
 
     transform_parser = subparsers.add_parser(
         'transform',
@@ -394,7 +394,7 @@ def create_parser() -> argparse.ArgumentParser:
             'File targets infer format from the extension.'
         ),
     )
-    transform_parser.set_defaults(func=cmd_transform)
+    transform_parser.set_defaults(func=transform_handler)
 
     load_parser = subparsers.add_parser(
         'load',
@@ -418,7 +418,7 @@ def create_parser() -> argparse.ArgumentParser:
         ),
     )
     _add_format_options(load_parser, context='target')
-    load_parser.set_defaults(func=cmd_load)
+    load_parser.set_defaults(func=load_handler)
 
     pipe_parser = subparsers.add_parser(
         'pipeline',
@@ -440,7 +440,7 @@ def create_parser() -> argparse.ArgumentParser:
         metavar='JOB',
         help='Run a specific job by name',
     )
-    pipe_parser.set_defaults(func=cmd_pipeline)
+    pipe_parser.set_defaults(func=pipeline_handler)
 
     render_parser = subparsers.add_parser(
         'render',
@@ -476,47 +476,47 @@ def create_parser() -> argparse.ArgumentParser:
             'Explicit path to a Jinja template file (overrides template key).'
         ),
     )
-    render_parser.set_defaults(func=cmd_render)
+    render_parser.set_defaults(func=render_handler)
 
-    list_parser = subparsers.add_parser(
-        'list',
-        help='List ETL pipeline metadata',
+    check_parser = subparsers.add_parser(
+        'check',
+        help='Inspect ETL pipeline metadata',
         formatter_class=argparse.ArgumentDefaultsHelpFormatter,
     )
-    _add_config_option(list_parser)
+    _add_config_option(check_parser)
     _add_boolean_flag(
-        list_parser,
+        check_parser,
         name='jobs',
         help_text='List ETL jobs',
     )
     _add_boolean_flag(
-        list_parser,
+        check_parser,
         name='pipelines',
         help_text='List ETL pipelines',
     )
     _add_boolean_flag(
-        list_parser,
+        check_parser,
         name='sources',
         help_text='List data sources',
     )
     _add_boolean_flag(
-        list_parser,
+        check_parser,
         name='summary',
         help_text=(
             'Show pipeline summary (name, version, sources, targets, jobs)'
         ),
     )
     _add_boolean_flag(
-        list_parser,
+        check_parser,
         name='targets',
         help_text='List data targets',
     )
     _add_boolean_flag(
-        list_parser,
+        check_parser,
         name='transforms',
         help_text='List data transforms',
     )
-    list_parser.set_defaults(func=cmd_list)
+    check_parser.set_defaults(func=check_handler)
 
     run_parser = subparsers.add_parser(
         'run',
@@ -537,7 +537,7 @@ def create_parser() -> argparse.ArgumentParser:
         '--pipeline',
         help='Name of the pipeline to run',
     )
-    run_parser.set_defaults(func=cmd_run)
+    run_parser.set_defaults(func=run_handler)
 
     return parser
 

etlplus/run.py

@@ -142,10 +142,8 @@ def run(
     """
     Run a pipeline job defined in a YAML configuration.
 
-    This mirrors the run-mode logic from ``etlplus.cli.cmd_pipeline``
-    (without the list/summary modes). By default it reads the configuration
-    from ``in/pipeline.yml``, but callers can provide an explicit
-    ``config_path`` to override this.
+    By default it reads the configuration from ``in/pipeline.yml``, but callers
+    can provide an explicit ``config_path`` to override this.
 
     Parameters
     ----------

{etlplus-0.5.3.dist-info → etlplus-0.5.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: etlplus
-Version: 0.5.3
+Version: 0.5.5
 Summary: A Swiss Army knife for simple ETL operations
 Home-page: https://github.com/Dagitali/ETLPlus
 Author: ETLPlus Team
@@ -90,7 +90,7 @@ package and command-line interface for data extraction, validation, transformati
 
 ## Features
 
-- **Inspect** data pipeline definitions before running them:
+- **Check** data pipeline definitions before running them:
   - Summarize jobs, sources, targets, and transforms
   - Confirm configuration changes by printing focused sections on demand
 
@@ -179,21 +179,21 @@ etlplus --help
 etlplus --version
 ```
 
-#### Inspect Pipelines
+#### Check Pipelines
 
-Use `etlplus list` to explore pipeline YAML definitions without running them. The command can print
+Use `etlplus check` to explore pipeline YAML definitions without running them. The command can print
 job names, summarize configured sources and targets, or drill into specific sections.
 
 List jobs and show a pipeline summary:
 ```bash
-etlplus list --config examples/configs/pipeline.yml --jobs
-etlplus list --config examples/configs/pipeline.yml --summary
+etlplus check --config examples/configs/pipeline.yml --jobs
+etlplus check --config examples/configs/pipeline.yml --summary
 ```
 
 Show sources or transforms for troubleshooting:
 ```bash
-etlplus list --config examples/configs/pipeline.yml --sources
-etlplus list --config examples/configs/pipeline.yml --transforms
+etlplus check --config examples/configs/pipeline.yml --sources
+etlplus check --config examples/configs/pipeline.yml --transforms
 ```
 
 #### Render SQL DDL
@@ -358,8 +358,8 @@ CLI quick reference for pipelines:
 
 ```bash
 # List jobs or show a pipeline summary
-etlplus list --config examples/configs/pipeline.yml --jobs
-etlplus list --config examples/configs/pipeline.yml --summary
+etlplus check --config examples/configs/pipeline.yml --jobs
+etlplus check --config examples/configs/pipeline.yml --summary
 
 # Run a job
 etlplus run --config examples/configs/pipeline.yml --job file_to_file_customers

{etlplus-0.5.3.dist-info → etlplus-0.5.5.dist-info}/RECORD

@@ -8,7 +8,7 @@ etlplus/file.py,sha256=RxIAsGDN4f_vNA2B5-ct88JNd_ISAyYbooIRE5DstS8,17972
 etlplus/load.py,sha256=BwF3gT4gIr-5CvNMz_aLTCl-w2ihWSTxNVd4X92XFwI,8737
 etlplus/mixins.py,sha256=ifGpHwWv7U00yqGf-kN93vJax2IiK4jaGtTsPsO3Oak,1350
 etlplus/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-etlplus/run.py,sha256=zl_Yx35spcgaa9Xx7-kcJEb1CAYyMIiqtPlsSrYxRfs,12448
+etlplus/run.py,sha256=X4kp5FQlIWVf1_d9oSrchKau7BFDCE1Zkscvu7WPaWw,12340
 etlplus/run_helpers.py,sha256=bj6MkaeFxjl3CeKG1HoXKx5DwAlXNERVW-GX-z1P_qQ,24373
 etlplus/transform.py,sha256=uAUVDDHYCgx7GpVez9IK3OAZM-CnCuMa9iox3vwGGJA,25296
 etlplus/types.py,sha256=SJiZ7wJiSnV4CEvF-9E5nSFLBo4DT9OqHQqj1GSHkv8,6042
@@ -32,9 +32,9 @@ 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=buGIIoSIu5cxbYTdPcA_iaxJaPG-eHj-LPD9OgZ0h9w,35824
-etlplus/cli/handlers.py,sha256=O7Mh9nowdMCzaV36KASWZVC4fNMEg9xnVZXE7NHW6P8,18873
-etlplus/cli/main.py,sha256=5qWAKqlRtnb4VEpBfGT45q-LBxi_2hSMnw23jNyYA_Q,16497
+etlplus/cli/app.py,sha256=SYPO-NDwXgymJrACw39jZ_NJrSKAs0O8anuWR5o42WM,35893
+etlplus/cli/handlers.py,sha256=ZPoV9N48mtpUMf4S_czAKpo4ZqLFVb4tcTq0B36v-84,18941
+etlplus/cli/main.py,sha256=ijYOy72SEsxrTEBan5yADW8CZyr0yddVF8HeMgFw6Zg,16576
 etlplus/config/__init__.py,sha256=VZWzOg7d2YR9NT6UwKTv44yf2FRUMjTHynkm1Dl5Qzo,1486
 etlplus/config/connector.py,sha256=0-TIwevHbKRHVmucvyGpPd-3tB1dKHB-dj0yJ6kq5eY,9809
 etlplus/config/jobs.py,sha256=hmzRCqt0OvCEZZR4ONKrd3lvSv0OmayjLc4yOBk3ug8,7399
@@ -47,9 +47,9 @@ etlplus/templates/ddl.sql.j2,sha256=s8fMWvcb4eaJVXkifuib1aQPljtZ8buuyB_uA-ZdU3Q,
 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.5.3.dist-info/licenses/LICENSE,sha256=MuNO63i6kWmgnV2pbP2SLqP54mk1BGmu7CmbtxMmT-U,1069
-etlplus-0.5.3.dist-info/METADATA,sha256=yaJ4G8RA4EjaQwWoCabTSrylNu55kjkDFHFYNIaVabE,19285
-etlplus-0.5.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-etlplus-0.5.3.dist-info/entry_points.txt,sha256=6w-2-jzuPa55spzK34h-UKh2JTEShh38adFRONNP9QE,45
-etlplus-0.5.3.dist-info/top_level.txt,sha256=aWWF-udn_sLGuHTM6W6MLh99ArS9ROkUWO8Mi8y1_2U,8
-etlplus-0.5.3.dist-info/RECORD,,
+etlplus-0.5.5.dist-info/licenses/LICENSE,sha256=MuNO63i6kWmgnV2pbP2SLqP54mk1BGmu7CmbtxMmT-U,1069
+etlplus-0.5.5.dist-info/METADATA,sha256=I6_4VqX4PBWV2T5KYctjcoL9aCwp6Iixc9IZhgLUKFQ,19288
+etlplus-0.5.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+etlplus-0.5.5.dist-info/entry_points.txt,sha256=6w-2-jzuPa55spzK34h-UKh2JTEShh38adFRONNP9QE,45
+etlplus-0.5.5.dist-info/top_level.txt,sha256=aWWF-udn_sLGuHTM6W6MLh99ArS9ROkUWO8Mi8y1_2U,8
+etlplus-0.5.5.dist-info/RECORD,,