The Gramps XML version (1.7.2 as of Gramps 6.0.0) looks like it follows SemVer. Is that indeed the case?

No. It has a similar structure, but the use of the individual elements is different.

Ah, glad I asked. Is the format documented somewhere? Basically, somebody reported Betty does not work with Gramps XML 1.7.2 · Issue #2560 · bartfeenstra/betty · GitHub and I want to solve this by parsing the version from the XML and checking if it’s compatible with 1.7.1 (the version Betty’s Gramp…

Change in on eventref (Person, Family) with a citation support. [image] Example.gramps and 1.7.2 grampsxml.dtd Beta Testing On future Gramps 6.0, it seems that there is a minor schema update/upgrade around eventref and citationref. -<!DOCTYPE database PUBLIC "-//GRAMPS//…

Thanks for reminding us of this. I have updated the Gramps XML page in the wiki.

Thanks! As long as those are optional additions it should be BC with 1.7.1, but it’s helpful for me to be aware of these changes :slight_smile: @Nick-Hall What logic would I use to determine if two XML versions are compatible? Regular Python version comparison if not SemVer?

It looks like we use the “X.Y.Z” format for versions. If only new features are added the we increment Z. If features are removed we increment Y.

But they are intertwined a bit too, correct? So if you increment Y (removing features), then Z resets to zero but can still include new features. (Otherwise, the Y and Z seem to be reversed.)

Ta. Does that mean the 1 prefix is considered static and without meaning?

Yes. The version number increases in the usual way. Unfortunately there are inconsistencies. I think that there has been a tendency to link the XML version to the Gramps version, so Y might have been incremented when not strictly necessary. There were also cases where the XML export was reportin…

Okay, so basically: if X is increased, Y and Z become 0 if Y is increased, Z becomes 0 X.Y.Z+n is compatible with X.Y.Z X.Y+n.x is incompatible with X.Y.x

Gramps XML version format

Development

romjerome April 22, 2025, 3:35pm 4

Change in on eventref (Person, Family) with a citation support.

Topic		Replies	Views
Lowest common denominator: XML schema in .gramps files? Ideas	11	504	October 13, 2025
If there a chance of a version downgrade XML exporter? Development	6	142	May 7, 2025
Example.gramps and 1.7.2 grampsxml.dtd Beta Testing	21	445	April 24, 2025
Upgrade database [XML version 0.0.0 from Gramps v2.x] Help data-recovery	6	347	January 2, 2023
Error when importing a Gramps XML file Help data-import	26	340	June 2, 2024

Gramps XML version format

Related topics