-
v0.3.0
Stablereleased this
2026-10-14 09:31:53 +02:00 | 50 commits to main since this releaseFeatures
- Validation of the input and the output: a
validations:section in the functional file with the
JSON Schema check of each side (off by default; Oracle 23aiDBMS_JSON_SCHEMA, Python
jsonschema; best effort:formatis not checked) and extra checks (expecton$,code,
message,rejectorwarn). Arejectruns no rule and gives no output; every failed check is
reported (p_reportofmap_<id>_safe/ a third result,MappingRejected/ the reserved error
withrejected). Golden cases:<case>.expected_rejected.json,.expected_warnings.json. New
built-inis_digits. The import turns "reject if..." statements into validations. Desktop: the
Validations (I: n, O: m) tab, and the golden cases' expected rejected / warnings files. mapper import extract | assemble | test | apply: read a functional document (xlsx, docx, pdf,
txt, md) into a normalized form, build and check a.fn.yamlfrom an import plan, run the plan's
cases against it, and write it to the project (pip installextraimportfor the readers).- Desktop: Import a document… in the start wizard, full screen: pick a functional document and an
installed assistant (Claude Code or Codex), follow and cancel the run, answer its questions, review
the plan (rules with their evidence, confidence and check; validations; lookups; cases;
discrepancies; coverage) and apply it.mapper import providers | runand theimport_*ops of
the worker are the same thing from the command line. - More built-ins, so that patterns are the last resort and not the first:
upper,lower,trim,
length,substring,left,right,pad_left,pad_right,contains,starts_with,
ends_with,abs,floor,ceilandformat_date(a date written in a format). Python and
PL/SQL backends, golden mappingbuiltins_more. Library 1.1.0. - A lookup table can be empty (
entriesmay be left out): the import writes a table the document does
not give, named and empty, so the rules that read it already run. It finds nothing until filled in. - Groups: an
objectwithoutput: $and aguardwrites its rules into the output root when
the guard holds. It is how a mapping produces one of several shapes (oneOf): a group per shape,
guards written by the author; the check asks of the root only what every shape requires. The
import asks which shape each part of the document is and in which order the guards apply. - Loops:
source: $runs over the document itself (one element: a list with a single element
built from the message, or, with afilter, a block written only when a condition holds), and
several loops can add to one output list in order. A list missing from the document has no
elements on PL/SQL too (the loop raised ORA-30625). Golden mappingdocument_loop. - More built-ins:
parse_timestamp(a date and time with a month name or AM/PM),days_between,
add_days,split_lastandjoin(a list, or a comprehension, in one text);to_utcand
rfc3339_normalizetake the number of fraction digits (milliseconds). Python and PL/SQL,
golden mappingbuiltins_dates. - Aggregates over some elements or a computed value:
count(i for i in $.items if i.ok),
sum(abs(i.qty) for i in $.items), likewisemax,min,avg. One loop on both backends,
the element's fields are checked against the schema. An aggregate may now be part of a larger
expression on PL/SQL too (round(sum(...), 2)). Golden mappingaggregate_by. - The check suggests the closest name ("did you mean 'x'?") for a field, reference, alias or
function that does not exist. - Expression syntax errors say what to write instead (
&&→and,cond ? a : b→a if cond else b, …) and where the expression stopped. - The check reports an unknown function in an expression (it was found only by the build) and
a barereturnon a required field.
Changed
- A value that is
None(a missing source, a lookup that finds nothing,maxof an empty set) is
no longer written asnull: the field is left out, as a barereturndoes.Null, the explicit
null, still writesnull. Both backends, in a rule, a direct assignment, a field of an object and
an element of a list. Golden cases that expectednullfor a missing value now expect no field.
Fixes
- Groups (
objectwithoutput: $and aguard): a list written inside a group exists only when
the group's guard holds (a DELETE message no longer gets the POST group's emptyrows: []), on
both backends; loops with afilter,sortorenumerateinside a group are lowered like the
ones at the top (the PL/SQL build stopped oncontinue); an output schema that is aoneOfat
the root now builds (the mapping writes the union of the shapes' fields). mapper import assemblereports a rule that is its own parent (or part of a ring of parents) in
skipped, instead of writing a file without it; the import plan accepts the lookup status
partial, and the skill says how to number rules, write a target that is a path, get a whole
number from a rounded one, and leave out an empty list.- A mapping whose output schema is one of several shapes (
oneOf) was refused by the compiler
(KeyError): the root is now the union of the shapes (a field only some have is optional). - Several loops inside an
objectcan add to one list (the transpiler refused it: "duplicate
output field").countof a missing list is 0, andsum,max,min,avgover(list, "field")follow the rules of the comprehension form on Oracle too (a missing value is skipped, a
missing list is empty). - The compiler's type check: a property the schema does not require may be left out (a rule that
can omit it was refused); aconstorenumwithout atypeis typed by its values (it was an
opaque object);absof a whole number is a whole number andfloor/ceilgive whole numbers
(an integer field refused them); a field named like a keyword is typed through the schema. - Sums and products of decimal numbers on the Python backend are the database's
(0.1 + 0.2is0.3,130.83not130.82999999999998). mapper import assembletreats a required output field that no rule writes yet (a function gap,
a missing lookup) as a gap, not a failure: the cases still run;applyasks for--force.
The Word reader no longer marks the cells of a table without merged cells as continuations.- A field named like a Python keyword (
$.return.number,i.from) can be read, in a path, an
expression and a loop source, on both backends (it was a syntax error in the generated code). parse_dateof a missing text gives nothing on the Python backend (it failed; Oracle gave null).mapper import testno longer ends in a traceback when the working copy checks but does not
compile: the cases are reported as not run, with the cause.max,min,sum,avgskip a missing value (as SQL does) instead of failing on the Python
backend, andmax,min,avgof nothing are null on both;round,trunc,abs,floor,
ceilof a missing value are null on the Python backend too (they were an error there).- The check no longer rejects
@indexas a source or in an expression, and a loop that numbers
its elements (index_start) now runs on the Python backend.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
- Validation of the input and the output: a
-
v0.2.0
Stablereleased this
2026-10-07 17:14:08 +02:00 | 71 commits to main since this releaseFeatures
- Desktop tool: adding a field, object or loop opens a dialog asking its name and, for a field,
its type and whether it is required; the grid scrolls to the new rule. - Desktop tool: rules can be reordered by dragging, among the rules of their own level (the root, an
object or a loop). A gap opens where the rule will land and the rule lights up once dropped. - Desktop tool: Description and Notes open in a text area (Shift+Enter breaks a line) and are read in
full, line breaks included, in a scrollable bubble over the cell. mapper serveadd_ruleaccepts an optional name, type and required.- The software is licensed under the GPLv3, with an exception for generated output; the licence is
shown in the README, the CLI and the desktop tool's help.
Changed
- Desktop tool: Transpile, Build and Check are one Check… button; in Developer mode its caret
lists Transpile, Build, Check… and Publish. - Desktop tool: Publish folder, Build folder and Generated files moved from the toolbar to
Project properties, under This machine and repository, with their current values.
Fixed
- Desktop tool: the last rows of the grid were covered by the horizontal scrollbar on systems with
overlay scrollbars.
Documentation
- The README explains how to get past the Windows SmartScreen warning.
- The in-app guide, the tour and the docs follow the new toolbar.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
- Desktop tool: adding a field, object or loop opens a dialog asking its name and, for a field,
-
v0.1.0
Stablereleased this
2026-10-06 15:48:43 +02:00 | 78 commits to main since this releaseFirst release. Work in progress: the engine and the desktop tool are usable, but not complete.
Features
- The mapping engine and the desktop tool, with packages for Linux (AppImage), Windows (installer
and portable zip) and macOS (dmg). - Version control in the tool, with merging by rule.
- A portable
mapperCLI for CI jobs.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
- The mapping engine and the desktop tool, with packages for Linux (AppImage), Windows (installer