Export migrations tests for AiiDA
Testing of AiiDA export file migrations
Test modules for migration of AiiDA export files.
Can be installed by adding
testing package, when installing AiiDA:
pip install aiida-core[testing]
Note: This only works for AiiDA v1.0.0 and newer.
Historical table of version comparisons between releases of this module and AiiDA, including when tests for the different export versions are first included.
|This module||AiiDA||Export versions (when first included)|
|0.5.0||1.0.0b3||0.4 -> 0.5|
|0.1.0||1.0.0b2||0.1 -> 0.2 ; 0.2 -> 0.3 ; 0.3 -> 0.4|
Q: Why not include these tests in the core of AiiDA?
A: These tests demand fixed AiiDA export files. In order to not take up unneccesary disk space, when installing AiiDA, these tests have been separated out of aiida-core. Furthermore, the legacy export versions will never change, i.e., the incremental migration functions need only be thoroughly tested once, and will therefore not be affected by changes to the core of the AiiDA code in any way.
Q: What happens when the export version is upped?
A: A new export file will be added to this repo as well as a new test-filled file.
Q: What if the import system changes in AiiDA core?
A: Tests relying on importing exported files into the AiiDA database will still be found in aiida-core. This repo is only for testing the incremental migration functions for different export versions.
0.5.0 (June 2019)
AiiDA version: 1.0.0b3
Update version number of this repository to reflect the current
The version number is now as follows:
Implement initial change related to the update of
EXPORT_VERSION from 0.4 to 0.5:
- Migration 0034: Remove fields/columns
- Migration 0036: Remove field/column
Note: The newly created
/aiida-export-migration-tests/archives is not actually created from an AiiDA workflow, but instead a migration of
This is because the changes between the versions are insignificant for the outcome of the workflow, and that only very minor changes have occurred.
0.1.1 (May 2019)
AiiDA version: 1.0.0b2
Minor fixes due to changes in aiida-core.
fixtures changes name to
archives to match the same change happening for aiida-core.
The simple AiiDA export archives in aiida-core representing the different export versions have changed names:
A change in the conversion message included in
metadata.json files, when a migration has been successfully performed, introduces the version of AiiDA into the message. In order to have the tests be version-agnostic, the
conversion_info key has to be handled specially in the relevant tests.
When migrating an archive, it is asserted that the correct conversion message appears in the migrated archive, and the
conversion_info item is then popped from both the migrated archive and the archive imported for comparison.
0.1.0 (April 2019)
AiiDA version: 1.0.0b2
Tests for step-wise export migrations from versions 0.1, 0.2, and 0.3.
Representative export files created in specialized Quantum Mobile virtual machines by @yakutovicha to test currently known migrations from the basis of what could be exported at the time of the different export versions.
|Export version||AiiDA version||AiiDA version release date||Found changed in commit|
*Due to the following reasons, we decided not to invest an effort in making the representative archive migration for 0.1:
- The earliest version released on PyPi is 0.8.0rc1 (22.03.2017).
- The previous stable version (AiiDA 0.5.0) was not working in a virtual environment.
- The migration from v0.1 to v0.2 is small and quite simple. If an export file should be found that cannot be properly migrated, due to this step, it can be migrated manually with little effort.
Representative export files creation
To create the representative export files, a simple workflow was developed by @yakutovicha that runs two consequtive QuantumESPRESSO PW calculations. First an SCF calculation, followed by an MD calculation.
The workflows can be found in the repository's folder
.qm, and correspond to the following export versions and Quantum Mobile editions:
|Export version||Workflow||Run workflow script||Quantum Mobile|
*See section Release notes#0.1.0 (April 2019).
They contain the following AiiDA node types (according to AiiDA 1.0.0):
|Node type||Parent-type tree, up to
|Float||NumericType -> BaseType/Data -> Node|
|Int||NumericType -> BaseType/Data -> Node|
|Dict||Data -> Node|
|FolderData||Data -> Node|
|RemoteData||Data -> Node|
|StructureData||Data -> Node|
|UpfData||SinglefileData -> Data -> Node|
|KpointsData||ArrayData -> Data -> Node|
|BandsData||KpointsData -> ArrayData -> Data -> Node|
|TrajectoryData||ArrayData -> Data -> Node|
|Code||Data -> Node|
|WorkChainNode||WorkflowNode -> ProcessNode -> Node|
|CalcJobNode||CalculationNode -> ProcessNode -> Node|
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size aiida_export_migration_tests-0.5.0-py3-none-any.whl (4.7 MB)||File type Wheel||Python version py3||Upload date||Hashes View|
|Filename, size aiida-export-migration-tests-0.5.0.tar.gz (4.7 MB)||File type Source||Python version None||Upload date||Hashes View|
Hashes for aiida_export_migration_tests-0.5.0-py3-none-any.whl
Hashes for aiida-export-migration-tests-0.5.0.tar.gz