Release Notes

High-level descriptions of point releases

0.0.581 - 11 Jan 2026

Major changes

When/do changes:

• When/do operator right-hand sides now contribute to matching

• When/do right-hand side now respects nocontrib

Custom functions changes:

• External functions can be loaded from a file anywhere visible to the Python process

• Functions loaded from different function.imports files within the same Python process do not collide

• Multiple functions.imports will be loaded

• FunctionFactory supports reloadeding imports files

Three new functions:

• Added line_before() to compare current line header value to last line header value

• Added remove() to drop one or more headers

• Set headers manually using rename(@stack) or rename(“a”, “b”, “c”…)

Three qualifier changes:

• Support for name qualifiers in error() that are visibile in error events. E.g. error.myname(“this is a msg”) outputs: 2025-12-08 00h42m40s-886915:temps.txt:1:Ⓜ️myname[1]: this is a msg

• Added skipnone qualifier primarily for push(). With notnone on push() None is flagged as an error; whereas, in some cases we just want to not push Nones.

• Support for the distinct qualifier in string(), integer(), decimal(), date(), datetime()

Other functions changes:

• New markdown docs generated from/by the functions. E.g. https://github.com/csvpath/csvpath/blob/main/docs/func_gen/advance.md. These docs are barebones, but always 100% up to date. The original function docs .md pages will be maintained but should not be considered the most current and/or correct.

• blank(name|header) and wildcard() support Any in actuals, including None

• put() support added for dict, list, date, date time, and None

Added project and project_context args to the CsvPath __init__ in order to populate logger name fields.

0.0.576 - 7 dec 2025

Major changes

• JSONL now available with all backends

• External custom functions are found before internals, allowing overriding

• 13 new CsvPath Validation Language functions. See the CLI functions look up for usage.

  • headers_stack(): returns the names of the current headers

  • clear(var|var-name): removes a variable

  • index_of(stack-var|stack-name, value): returns the int position of the value

  • track_any(): tracks typed values, optionally collecting values in a stack or summing them

  • roll(date|datetime, number, unit-name): returns a date/datetime that is N-units in the future or past

  • day(date): returns the date of the month as an int

  • month(date): returns the month of the year as an int

  • year(date): returns the year as an int

  • format_date(date|datetime, str): formats a date/datetime as a string

  • fingerprint(Optional[Header], ...): returns the hash of the line or the indicated header values

  • format(str-value, str-format): formats a value according to a Python string template

  • interpolate(str-value, str-format): formats a value within a longer string using Python formatting

  • xpath(xml-str, xpath-str): extracts a value from an XML document using an XPath expression

Fixes and Updates

• 15 function updates:

  • Number of times reset_headers() has been called and on what lines tracked in variables

  • Wildcard max length in string() using none()

  • track(): added 3rd arg add or collect, essentially the same function as for track_any()

  • push() and get() now able to take both stack vars and stack var names.

  • get(x) creates and returns a dict var if the variable named x is not found

  • Added an optional default arg to get()

  • concat() able to take a stack var of values to concatinate

  • Apply regex() to all headers using the headers() function like: regex( headers(), /…/ )

  • size() now takes the notnone qualifier and either a stack var or name of a stack var

  • eq() accepts None-valued vars, as well as none()

• Other minor user-facing changes

  • Removed function name limitations disallowing numbers, '_', and '.' after an inital alpha char.

  • Made an alias to header_names_mismatch for clarity.

  • Added ability for transfer mode to append, rather than overwrite, using a target path ending in +