Changelog • qryflow

qryflow (development version)

The source argument has been removed from qryflow_execute(). Source information is now stored automatically in chunk metadata during parsing.
qryflow_default_type() has been removed as a standalone exported function. Default type is now controlled directly via the default_type argument in qryflow(), qryflow_run(), and qryflow_parse(), or through the global option options(qryflow.default_type = "query"). Note: the option key has changed from qryflow.default.type to qryflow.default_type.

on_error argument added to qryflow(), qryflow_run(), and qryflow_execute(). Controls behavior when a chunk fails during execution. Accepts "stop" (default, halts immediately), "warn" (signals a warning and continues), or "collect" (runs all chunks and reports all errors together at the end). (#11 and #12
verbose argument added to qryflow(), qryflow_run(), and qryflow_execute(). When TRUE, emits a progress message before each chunk and a summary upon completion showing total runtime, successes, errors, and skipped chunks. Defaults to FALSE. Can be enabled globally with options(qryflow.verbose = TRUE). ([#8])
default_type argument added to qryflow(), qryflow_run(), and qryflow_parse(). Determines the chunk type assigned to untagged chunks. Defaults to "query". Can be set globally with options(qryflow.default_type = "query").
qryflow_meta() is now an exported function for accessing execution metadata (status, duration, start/end times, error messages) from both qryflow workflow objects and individual qryflow_chunk objects.
validate_con_arg() is now called internally by qryflow_execute() to provide clear, actionable error messages when the connection argument is missing, invalid, or disconnected.
Workflow-level execution status is now tracked and stored in metadata. A completed workflow is assigned a status of "success" if all chunks succeeded, or "partial" if any chunk encountered an error.

Combined qryflow_workflow and qryflow_results into single object. ([#14])
Added cli.R with verbose helpers (report_workflow_start(), report_chunk_start(), report_chunk_end(), report_workflow_end()).
Added on-error.R consolidating error dispatch logic (validate_on_error(), dispatch_on_error(), dispatch_collected_errors()) supporting the new on_error argument.
Metadata handling has been refactored into meta.R, centralizing time tracking and duration formatting used across workflow and chunk objects.
Updated documentation, vignettes, and README to reflect new arguments and removed functions.

The type-specific parser system has been removed (#13) . register_qryflow_parser(), ls_qryflow_parsers() validate_qryflow_parser(), and qryflow_parser_exists() are no longer available. Custom chunk behaviour should now be implemented entirely through handlers. See register_qryflow_type() for details.
ls_qryflow_handlers() and register_qryflow_handler() were removed. Use ls_qryflow_types() and register_qryflow_type() instead.

Parsing is now handled by a single unified parser that produces a consistent qryflow_chunk structure regardless of chunk type. This replaces the previous system where each chunk type could define its own parsing logic.
User provided duplicate names now generates an error via refactored approach to fix_chunk_names() (Now, resolve_chunk_names())
Updated documentation, README, and vignettes to accomodate unified parsing.

CRAN release: 2026-02-05

Breaking change: qryflow(), qryflow_run(), qryflow_execute() and internal functions now accept con argument first, before the sql/workflow arguments. This makes the API consistent with DBI and other DB packages, improves ergonomics, and enables method dispatch on connection classes. (#5)
Minor documentation updates (#2)
Update License Year (#6)

CRAN release: 2025-07-18