File: test_operation.py

package info (click to toggle)
gromacs 2026~rc-1
  • links: PTS, VCS
  • area: main
  • in suites: experimental
  • size: 274,216 kB
  • sloc: xml: 3,831,143; cpp: 686,111; ansic: 75,300; python: 21,171; sh: 3,553; perl: 2,246; yacc: 644; fortran: 397; lisp: 265; makefile: 174; lex: 125; awk: 68; csh: 39
file content (168 lines) | stat: -rw-r--r-- 6,540 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
#
# This file is part of the GROMACS molecular simulation package.
#
# Copyright 2019- The GROMACS Authors
# and the project initiators Erik Lindahl, Berk Hess and David van der Spoel.
# Consult the AUTHORS/COPYING files and https://www.gromacs.org for details.
#
# GROMACS is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public License
# as published by the Free Software Foundation; either version 2.1
# of the License, or (at your option) any later version.
#
# GROMACS is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with GROMACS; if not, see
# https://www.gnu.org/licenses, or write to the Free Software Foundation,
# Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA.
#
# If you want to redistribute modifications to GROMACS, please
# consider that scientific software is very special. Version
# control is crucial - bugs must be traceable. We will be happy to
# consider code for inclusion in the official distribution, but
# derived work must not be called official GROMACS. Details are found
# in the README & COPYING files - if they are missing, get the
# official version at https://www.gromacs.org.
#
# To help us fund GROMACS development, we humbly ask that you cite
# the research papers on the package. Check out https://www.gromacs.org.

"""Tests the interfaces defined in operation.py and behavior of simple operations.

See also test_commandline.py for integration tests.
"""

import os
import shutil
import stat
import tempfile
from typing import NamedTuple

import gmxapi as gmx
from gmxapi import commandline_operation
from gmxapi.operation import ResultDescription


def test_comparison():
    int_array_description = ResultDescription(dtype=int, width=3)
    same_description = ResultDescription(dtype=int, width=3)
    different_type_description = ResultDescription(dtype=float, width=3)
    different_width_description = ResultDescription(dtype=int, width=1)
    assert int_array_description == same_description
    assert int_array_description != different_width_description
    assert int_array_description != different_type_description

    class CompatibleRepresentation(NamedTuple):
        dtype: type
        width: int

    equivalent_description = CompatibleRepresentation(dtype=int, width=3)
    assert int_array_description == equivalent_description
    assert equivalent_description == int_array_description
    assert equivalent_description != different_type_description
    assert different_type_description != equivalent_description
    assert equivalent_description != different_width_description
    assert different_width_description != equivalent_description


def test_scalar():
    operation = gmx.make_constant(42)
    assert isinstance(operation.dtype, type)
    assert operation.dtype == int
    assert operation.result() == 42


def test_list():
    list_a = [1, 2, 3]

    # TODO: test input validation
    list_result = gmx.concatenate_lists(sublists=[list_a])
    assert list_result.dtype == gmx.datamodel.NDArray
    # Note: this is specifically for the built-in tuple type.
    # Equality comparison may work differently for different sequence types.
    assert tuple(list_result.result()) == tuple(list_a)
    assert len(list_result.result()) == len(list_a)

    list_result = gmx.concatenate_lists([list_a, list_a])
    assert len(list_result.result()) == len(list_a) * 2
    assert tuple(list_result.result()) == tuple(list_a + list_a)

    list_b = gmx.ndarray([42])

    list_result = gmx.concatenate_lists(sublists=[list_b])
    assert list_result.result()[0] == 42

    list_result = gmx.join_arrays(front=list_a, back=list_b)
    assert len(list_result.result()) == len(list_a) + 1
    assert tuple(list_result.result()) == tuple(list(list_a) + [42])


def test_data_dependence(cleandir):
    """Test dependent sequence of operations.

    Confirm that data dependencies correctly establish resolvable execution dependencies.

    In a sequence of two operations, write a two-line file one line at a time.
    Use the output of one operation as the input of another.
    """
    with tempfile.TemporaryDirectory() as directory:
        file1 = os.path.join(directory, "input")
        file2 = os.path.join(directory, "output")

        # Make a shell script that acts like the type of tool we are wrapping.
        scriptname = os.path.join(directory, "clicommand.sh")
        with open(scriptname, "w") as fh:
            fh.write(
                "\n".join(
                    [
                        "#!" + shutil.which("bash"),
                        "# Concatenate an input file and a string argument to an output file.",
                        "# Mock a utility with the tested syntax.",
                        '#     clicommand.sh "some words" -i inputfile -o outputfile',
                        "echo $1 | cat $3 - > $5\n",
                    ]
                )
            )
        os.chmod(scriptname, stat.S_IRWXU)

        line1 = "first line"
        filewriter1 = commandline_operation(
            scriptname,
            arguments=[line1],
            input_files={"-i": os.devnull},
            output_files={"-o": file1},
        )

        line2 = "second line"
        filewriter2 = commandline_operation(
            scriptname,
            arguments=[line2],
            input_files={"-i": filewriter1.output.file["-o"]},
            output_files={"-o": file2},
        )

        filewriter2.run()
        # Check that the files have the expected lines
        with open(filewriter1.output.file["-o"].result(), "r") as fh:
            lines = [text.rstrip() for text in fh]
        assert len(lines) == 1
        assert lines[0] == line1
        with open(filewriter2.output.file["-o"].result(), "r") as fh:
            lines = [text.rstrip() for text in fh]
        assert len(lines) == 2
        assert lines[0] == line1
        assert lines[1] == line2

        try:
            # If we're running with MPI, check that the file is accessible
            # on all ranks, but make sure that we don't delete the temporary
            # directory before all ranks have looked for it.
            from mpi4py import MPI

            MPI.COMM_WORLD.barrier()
        except ImportError:
            pass