aiidateam / aiida-cp2k

The CP2K plugin for the AiiDA workflow and provenance engine.
https://aiida-cp2k.readthedocs.io/en/latest/
MIT License
23 stars 28 forks source link

PyPI version PyPI pyversions Test CI Coverage Status Documentation

AiiDA CP2K

AiiDA plugin for CP2K.

Installation

If you use pip, you can install it as:

pip install aiida-cp2k

To install the plugin in an editable mode, run:

git clone https://github.com/aiidateam/aiida-cp2k
cd aiida-cp2k
pip install -e .  # Also installs aiida, if missing (but not postgres/rabbitmq).

Links

For maintainers

Release

To create a new release, clone the repository, install development dependencies with pip install '.[dev]', and then execute bumpver update --major/--minor/--patch. This will:

  1. Create a tagged release with bumped version and push it to the repository.
  2. Trigger a GitHub actions workflow that creates a GitHub release.

Additional notes:

Testing

To run the tests, you need to have Docker installed in your system. Once this is done, you can build the Docker image with the following command:

docker build -t aiida_cp2k_test .

To test against another version of aiida-core, you can specify the build agrument AIIDA_VERSION:

docker build -t aiida_cp2k_test --build-arg AIIDA_VERSION=2.4.3 .

Then, you can launch the container:

DOCKERID=`docker run -d aiida_cp2k_test`

This will remeber the container ID in the variable DOKERID. You can then run the tests with the following command:

docker exec --tty --user aiida $DOCKERID /bin/bash -l -c 'cd /home/aiida/aiida-cp2k/ && pytest'

To enter the container for manual testing do:

docker exec -it --user aiida $DOCKERID bash

License

MIT

Contact

yakutovicha@gmail.com

Acknowledgements

This work is supported by:

MARVEL MaX swissuniversities