/usr/lib/python2.7/dist-packages/cylc/graphnode.py is in python-cylc 7.6.0-1.
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 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 | #!/usr/bin/env python
# THIS FILE IS PART OF THE CYLC SUITE ENGINE.
# Copyright (C) 2008-2017 NIWA
#
# This program 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.
#
# This program 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 this program. If not, see <http://www.gnu.org/licenses/>.
"""Provide graph node parsing and caching service"""
from cylc.cycling.loader import get_interval, get_interval_cls
from cylc.task_id import TaskID
import re
class GraphNodeError(Exception):
"""Graph node parsing error."""
pass
class GraphNodeParser(object):
"""Provide graph node parsing and caching service"""
# Match a graph node string.
REC_NODE = re.compile(
r"^" +
r"(" + TaskID.NAME_RE + r")" +
r"""(?:\[ # Begin optional [offset] syntax
(?!T[+-]) # Do not match a 'T-' or 'T+'
# (this is the old format)
(\^?) # Initial cycle point offset marker
([^\]]*) # Continue until next ']'
\] # Stop at next ']'
)? # End optional [offset] syntax]
(?::([\w-]+))? # Optional type (e.g. :succeed)
$
""", re.X)
# A potentially non-regular offset, such as foo[01T+P1W].
REC_IRREGULAR_OFFSET = re.compile(
r"""^ # Start of string
( # Begin group
..+ # EITHER: Two or more characters
[+-]P # Then either +P or -P for start of duration
.* # Then anything for the rest of the duration
| # OR:
[^P]+ # No 'P' characters anywhere (e.g. T00).
) # End group
$ # End of string
""", re.X)
_INSTANCE = None
@classmethod
def get_inst(cls):
"""Return the singleton instance."""
if cls._INSTANCE is None:
cls._INSTANCE = cls()
return cls._INSTANCE
def __init__(self):
self._offsets = {}
self._nodes = {}
def clear(self):
"""Clear caches."""
self._offsets.clear()
self._nodes.clear()
def _get_offset(self, offset=None):
"""Return and cache the standardised offset string."""
if offset not in self._offsets:
if offset:
res = get_interval(offset).standardise()
else:
res = get_interval_cls().get_null_offset()
self._offsets[offset] = str(res)
return self._offsets[offset]
def parse(self, node):
"""Parse graph node, and cache the result.
Args:
node (str): node to parse
Return:
tuple:
(name, offset_is_from_icp, offset_is_irregular, offset, output)
Raise:
GraphNodeError: on illegal syntax.
"""
if node not in self._nodes:
match = self.REC_NODE.match(node)
if not match:
raise GraphNodeError('Illegal graph node: %s' % node)
name, offset_is_from_icp, offset, output = match.groups()
if offset_is_from_icp and not offset:
offset = self._get_offset()
offset_is_irregular = False
if offset:
if self.REC_IRREGULAR_OFFSET.search(offset):
offset_is_irregular = True
else:
offset = self._get_offset(offset)
self._nodes[node] = (
name, offset_is_from_icp, offset_is_irregular, offset, output)
return self._nodes[node]
|