/usr/share/pyshared/checkbox/parsers/description.py is in checkbox 0.13.7.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | #
# This file is part of Checkbox.
#
# Copyright 2011 Canonical Ltd.
#
# Checkbox is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# Checkbox 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 General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with Checkbox. If not, see <http://www.gnu.org/licenses/>.
#
from checkbox.lib.enum import Enum
DescriptionState = Enum(
"INIT",
"PURPOSE",
"STEPS",
"INFO",
"VERIFICATION",
"OTHER")
TransitionStates = {
DescriptionState.INIT: DescriptionState.PURPOSE,
DescriptionState.PURPOSE: DescriptionState.STEPS,
DescriptionState.STEPS: DescriptionState.VERIFICATION,
DescriptionState.INFO: DescriptionState.VERIFICATION,
DescriptionState.VERIFICATION: DescriptionState.OTHER,
DescriptionState.OTHER: DescriptionState.OTHER,
}
class DescriptionParser:
"""Parser for the description field in jobs."""
def __init__(self, stream):
self.stream = stream
def run(self, result):
parts = {}
state = DescriptionState.INIT
for line in self.stream.readlines():
# Check for upper case characters without leading spaces.
if not line[0].isspace() \
and line.isupper():
state = TransitionStates[state]
# Append to description parts between INIT and OTHER states.
elif state > DescriptionState.INIT \
and state < DescriptionState.OTHER:
# Handle optional INFO state and translations of $output.
if state == DescriptionState.VERIFICATION \
and "$" in line:
state = DescriptionState.INFO
line = "$output\n"
parts.setdefault(state, "")
parts[state] += line.lstrip()
# Only set the description if the last state is still VERIFICATION.
if state == DescriptionState.VERIFICATION:
result.setDescription(
parts[DescriptionState.PURPOSE],
parts[DescriptionState.STEPS],
parts[DescriptionState.VERIFICATION],
parts.get(DescriptionState.INFO))
|