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
|
"""
Helper functions.
"""
from __future__ import absolute_import
from __future__ import print_function
import contextlib
import os.path
import sys
import yaml
from . import archival
@contextlib.contextmanager
def open_or_use_stdout(filename):
"""
Opens the specified file for writing, or returns sys.stdout if filename is "-".
"""
if filename == "-":
yield sys.stdout
return
line_buffered = 1
try:
fp = open(filename, "w", line_buffered)
except IOError:
print("Could not open file {}".format(filename), file=sys.stderr)
sys.exit(1)
try:
yield fp
finally:
fp.close()
def default_if_none(value, default):
return value if value is not None else default
def is_string_list(lst):
"""
Returns true if 'lst' is a list of strings, and false otherwise.
"""
return isinstance(lst, list) and all(isinstance(x, basestring) for x in lst)
def is_string_set(value):
"""
Returns true if 'value' is a set of strings, and false otherwise.
"""
return isinstance(value, set) and all(isinstance(x, basestring) for x in value)
def is_js_file(filename):
"""
Returns true if 'filename' ends in .js, and false otherwise.
"""
return os.path.splitext(filename)[1] == ".js"
def is_yaml_file(filename):
"""
Returns true if 'filename' ends in .yml or .yaml, and false
otherwise.
"""
return os.path.splitext(filename)[1] in (".yaml", ".yml")
def load_yaml_file(filename):
"""
Attempts to read 'filename' as YAML.
"""
try:
with open(filename, "r") as fp:
return yaml.safe_load(fp)
except yaml.YAMLError as err:
raise ValueError("File '%s' contained invalid YAML: %s" % (filename, err))
def dump_yaml(value):
"""
Returns 'value' formatted as YAML.
"""
# Use block (indented) style for formatting YAML.
return yaml.safe_dump(value, default_flow_style=False).rstrip()
def load_yaml(value):
"""
Attempts to parse 'value' as YAML.
"""
try:
return yaml.safe_load(value)
except yaml.YAMLError as err:
raise ValueError("Attempted to parse invalid YAML value '%s': %s" % (value, err))
|