Migration guide v6.5.0

Breaking changes for all users

DataSources

New DataSources interfaces

Two types of DataSources based on files now exists:

• DirectoryDataSource (inherited by GzDirectoryDataSource, Bzip2DirectoryDataSource, ZstdDirectoryDataSource, XZDirectoryDataSource): considers files in a directory
• AbstractArchiveDataSource (only ZipArchiveDataSource for now but a TarArchiveDataSource could be added later): considers files in an archive.

Therefore, multiple classes have changed, please update your code if you used them directly:

Old classes	New classes
Bzip2FileDataSource	Bzip2DirectoryDataSource
FileDataSource	DirectoryDataSource
GzFileDataSource	GzDirectoryDataSource
XZFileDataSource	XZDirectoryDataSource
ZipFileDataSource	ZipArchiveDataSource
ZstdFileDataSource	ZstdDirectoryDataSource

Note: Their constructors are not the same so you will have to adapt your code to the new ones, depending on which DataSource you use.

CGMES

Clear metadata models supersedes

If you had define a custom CgmesMetadataModel implementation, you need to define a new method: CgmesMetadataModelImpl clearSupersedes().

Notice for custom IIDM implementations maintainers

Tap changer neutral position

This is not really a breaking change, but a TCK test was added and so, the maintainers of a custom IIDM implementation must make sure that the neutralPosition of the TapChanger is correctly updated when using a stepsReplacer on the TapChanger or this new test will fail.