|
1
|
|
|
# Licensed to the StackStorm, Inc ('StackStorm') under one or more |
|
2
|
|
|
# contributor license agreements. See the NOTICE file distributed with |
|
3
|
|
|
# this work for additional information regarding copyright ownership. |
|
4
|
|
|
# The ASF licenses this file to You under the Apache License, Version 2.0 |
|
5
|
|
|
# (the "License"); you may not use this file except in compliance with |
|
6
|
|
|
# the License. You may obtain a copy of the License at |
|
7
|
|
|
# |
|
8
|
|
|
# http://www.apache.org/licenses/LICENSE-2.0 |
|
9
|
|
|
# |
|
10
|
|
|
# Unless required by applicable law or agreed to in writing, software |
|
11
|
|
|
# distributed under the License is distributed on an "AS IS" BASIS, |
|
12
|
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
|
13
|
|
|
# See the License for the specific language governing permissions and |
|
14
|
|
|
# limitations under the License. |
|
15
|
|
|
|
|
16
|
|
|
import re |
|
17
|
|
|
from st2common.exceptions import content |
|
18
|
|
|
|
|
19
|
|
|
__all__ = [ |
|
20
|
|
|
'ActionAliasFormatParser' |
|
21
|
|
|
] |
|
22
|
|
|
|
|
23
|
|
|
|
|
24
|
|
|
class ActionAliasFormatParser(object): |
|
25
|
|
|
|
|
26
|
|
|
def __init__(self, alias_format=None, param_stream=None): |
|
27
|
|
|
self._format = alias_format or '' |
|
28
|
|
|
self._param_stream = param_stream or '' |
|
29
|
|
|
|
|
30
|
|
|
def get_extracted_param_value(self): |
|
31
|
|
|
|
|
32
|
|
|
result = {} |
|
33
|
|
|
|
|
34
|
|
|
# As there's a lot of questions about using regular expressions, |
|
35
|
|
|
# I'll try to be thorough when documenting this code. |
|
36
|
|
|
|
|
37
|
|
|
# We're parsing the arbitrary key-value pairs at the end of the stream |
|
38
|
|
|
# to support passing of parameters not specified in the format string, |
|
39
|
|
|
# and cutting them from the stream as they're no longer needed. |
|
40
|
|
|
# Possible values are quoted strings, a word, or anything inside "{}". |
|
41
|
|
|
pairs_match = r'(?:^|\s+)(\S+)=("(.*?)"|\'(.*?)\'|({.*?})|(\S+))' |
|
42
|
|
|
extra = re.match(r'.*?((' + pairs_match + r'\s*)*)$', |
|
43
|
|
|
self._param_stream, re.DOTALL) |
|
44
|
|
|
if extra: |
|
45
|
|
|
kv_pairs = re.findall(pairs_match, |
|
46
|
|
|
extra.group(1), re.DOTALL) |
|
47
|
|
|
self._param_stream = self._param_stream.replace(extra.group(1), '') |
|
48
|
|
|
self._param_stream = " %s " % self._param_stream |
|
49
|
|
|
|
|
50
|
|
|
# Now we'll match parameters with default values in form of |
|
51
|
|
|
# {{ value = parameter }} (and all possible permutations of spaces), |
|
52
|
|
|
# compiling them into a list. |
|
53
|
|
|
# "test {{ url = http://google.com }} {{ extra = Test }}" will become |
|
54
|
|
|
# [ ["url", "http://google.com"], ["extra", "Test"] ] |
|
55
|
|
|
params = re.findall(r'{{\s*(.+?)\s*(?:=\s*[\'"]?({.+?}|.+?)[\'"]?)?\s*}}', |
|
56
|
|
|
self._format, re.DOTALL) |
|
57
|
|
|
|
|
58
|
|
|
# Now we're transforming our format string into a regular expression, |
|
59
|
|
|
# substituting {{ ... }} with regex named groups, so that param_stream |
|
60
|
|
|
# matched against this expression yields a dict of params with values. |
|
61
|
|
|
param_match = r'["\']?(?P<\2>(?:(?<=\').+?(?=\')|(?<=").+?(?=")|{.+?}|.+?))["\']?' |
|
62
|
|
|
reg = re.sub(r'(\s*){{\s*([^=}]+?)\s*}}(?![\'"]?\s+}})', |
|
63
|
|
|
r'\1' + param_match, |
|
64
|
|
|
self._format) |
|
65
|
|
|
reg = re.sub(r'(\s*){{\s*(\S+)\s*=\s*(?:{.+?}|.+?)\s*}}', |
|
66
|
|
|
r'(?:\1' + param_match + r')?', |
|
67
|
|
|
reg) |
|
68
|
|
|
reg = re.sub(r'(\s*){{\s*(.+?)\s*}}', |
|
69
|
|
|
r'\1' + param_match, |
|
70
|
|
|
reg) |
|
71
|
|
|
reg = '^\s*' + reg + r'\s*$' |
|
|
|
|
|
|
72
|
|
|
|
|
73
|
|
|
# Now we're matching param_stream against our format string regex, |
|
74
|
|
|
# getting a dict of values. We'll also get default values from |
|
75
|
|
|
# "params" list if something is not present. |
|
76
|
|
|
# Priority, from lowest to highest: |
|
77
|
|
|
# 1. Default parameters |
|
78
|
|
|
# 2. Matched parameters |
|
79
|
|
|
# 3. Extra parameters |
|
80
|
|
|
matched_stream = re.match(reg, self._param_stream, re.DOTALL) |
|
81
|
|
|
if matched_stream: |
|
82
|
|
|
values = matched_stream.groupdict() |
|
83
|
|
|
for param in params: |
|
84
|
|
|
matched_value = values[param[0]] if matched_stream else None |
|
85
|
|
|
matched_result = matched_value or param[1] |
|
86
|
|
|
if matched_result: |
|
87
|
|
|
result[param[0]] = matched_result |
|
88
|
|
|
if extra: |
|
89
|
|
|
for pair in kv_pairs: |
|
90
|
|
|
result[pair[0]] = ''.join(pair[2:]) |
|
91
|
|
|
|
|
92
|
|
|
if self._format and not (self._param_stream.strip() or any(result.values())): |
|
93
|
|
|
raise content.ParseException('No value supplied and no default value found.') |
|
94
|
|
|
|
|
95
|
|
|
return result |
|
96
|
|
|
|
Escape sequences in Python are generally interpreted according to rules similar to standard C. Only if strings are prefixed with
rorRare they interpreted as regular expressions.The escape sequence that was used indicates that you might have intended to write a regular expression.
Learn more about the available escape sequences. in the Python documentation.