Contributing

Contributions are more than welcome using the fork and pull request approach 🙂 (if you are not familiar with this approach, please visit GitHub Docs PRs for an extended documentation about collaborating with pull request; also, looking at previous merged pull requests helps to get familiar with this).

Ground Rules

  • We use Black code formatting

  • We use Pylint

  • We document our code

Contribute to the software

  1. Work on your own fork of the main repo

  2. In the main repo execute:

    1. pip install -r dev-requirements.txt (this installs the dev-requirements.txt)

    2. pip install opm (this does not work in macOS, then follow the steps in source build in macOS)

    3. black src/ tests/ (this formats the code)

    4. pylint src/ tests/ (this analyses the code, and might rise issues that need to be fixed before the pull request)

    5. mypy –ignore-missing-imports src/ tests/ (this is a static checker, and might rise issues that need to be fixed before the pull request)

    6. pytest –cov=pycopm –cov-report term-missing tests/ (this runs locally the tests, and might rise issues that need to be fixed before the pull request)

    7. pycopm -i examples/decks/HELLO_WORLD.DATA -c 5,5,1 -m all -o output (this runs the hello world example, which succeeds if the file output/HELLO_WORLD_PYCOPM.EGRID is created)

    8. pushd docs & make html (this generates the documentation, and might rise issues that need to be fixed before the pull request; if the build succeeds and if the contribution changes the documentation, then copy all content from the docs/_build/html/ folder and replace the files in the docs folder)

    Tip

    See the ci_pycopm_ubuntu.yml script and the Actions for installation of pycopm, OPM Flow (binary packages), and dependencies, as well as the execution of the eight previous steps in Ubuntu 24.04 using Python 3.11. For macOS users, see the ci_pycopm_macos.yml script and the OPM-Flow_macOS Actions for installation of pycopm, OPM Flow (source build), and dependencies, as well as running the tests and the hello world example in macOS 26 using Python3.13. Note that if you do not add the directory containing the OPM Flow executable to your system’s PATH environment variable (e.g., export PATH=$PATH:/Users/yourname/pycopm/build/opm-simulators/bin), then you can pass this in the execution of the tests and pycopm using the flags -f/–flow (see this script).

  3. Squash your commits into a single commit (see this nice tutorial if you are not familiar with this)

  4. Push your commit and make a pull request

  5. The maintainers will review the pull request, and if the contribution is accepted, then it will be merge to the main repo

Report issues or problems

  1. Issues or problems can be raised by creating a new issue in the repository GitHub page (if you are not familiar with this approach, please visit GitHub Docs Issues)

  2. We will try to answer as soon as possible, but also any user is more than welcome to answer

Seek support

  1. The preferred approach to seek support is to raise an Issue as described in the previous lines

  2. We will try to answer as soon as possible, but also any user is more than welcome to answer

  • An alternative approach is to send an email to any of the mantainers.