Source code for armi.cli.checkInputs

# Copyright 2019 TerraPower, LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

"""
Entry point into ARMI to check inputs of a case or a whole folder of cases.
"""

import sys
import traceback

import armi
from armi import runLog
from armi.cli.entryPoint import EntryPoint


def _runInspectorOnSettings(cs):
    from armi import operators

    operator_class = operators.getOperatorClassFromSettings(cs)
    inspector = operator_class.inspector(cs)
    issues = [
        query
        for query in inspector.queries
        if query and query.correction is not None and query._passed != True
    ]  # pylint: disable=protected-access
    return issues


class CheckInputEntryPoint(EntryPoint):
    """
    Check ARMI inputs for errors, inconsistencies, and the ability to initialize a reactor.
    Also has functionality to generate a summary report of the input design.
    This can be run on multiple cases and creates a table detailing the results of the input check.
    """

    name = "check-input"
    settingsArgument = "optional"

    def addOptions(self):
        self.parser.add_argument(
            "--generate-design-summary",
            "-s",
            action="store_true",
            default=False,
            help="Generate a report to summarize the inputs",
        )
        self.parser.add_argument(
            "--full-core-map",
            "-m",
            action="store_true",
            default=False,
            help="Generate the full core reactor map in the design report",
        )
        self.parser.add_argument(
            "--disable-block-axial-mesh",
            action="store_true",
            default=False,
            help="Remove the additional block axial mesh points on the assembly type figure(s)",
        )
        self.parser.add_argument(
            "--recursive",
            "-r",
            action="store_true",
            default=False,
            help="Recursively check directory structure for valid settings files",
        )
        self.parser.add_argument(
            "--skip-checks",
            "-C",
            action="store_true",
            default=False,
            help="Skip checking inputs (might be useful if you only want to generate a report).",
        )
        self.parser.add_argument(
            "patterns",
            type=str,
            nargs="*",
            default=["*.yaml"],
            help="File names or patterns",
        )

    def invoke(self):
        import tabulate
        from armi import cases

        suite = cases.CaseSuite(self.cs)
        suite.discover(patterns=self.args.patterns, recursive=self.args.recursive)

        table = []  # tuples (case, hasIssues, hasErrors)
        for case in suite:
            hasIssues = "UNKNOWN"
            if not self.args.skip_checks:
                hasIssues = "PASSED" if case.checkInputs() else "HAS ISSUES"
            try:
                if self.args.generate_design_summary:
                    case.summarizeDesign(
                        self.args.full_core_map, not self.args.disable_block_axial_mesh
                    )
                    canStart = "PASSED"
                else:
                    canStart = "UNKNOWN"
            except Exception as ee:
                runLog.error("Failed to initialize/summarize {}".format(case))
                runLog.error(traceback.format_exc())
                canStart = "FAILED"

            table.append((case.cs.path, case.title, canStart, hasIssues))

        runLog.important(
            tabulate.tabulate(
                table,
                headers=["case", "can start", "input is self consistent"],
                tablefmt="armi",
            )
        )

        if any(t[2] != "PASSED" or t[3] != "PASSED" for t in table):
            sys.exit(-1)