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
|
# Copyright 2019 Openstack Foundation
# 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.
"""
The view sectioned module handles creating Jenkins Sectioned views.
To create a sectioned view specify ``sectioned`` in the ``view-type`` attribute
to the :ref:`view_sectioned` definition.
:View Parameters:
* **name** (`str`): The name of the view.
* **view-type** (`str`): The type of view.
* **description** (`str`): A description of the view. (default '')
* **filter-executors** (`bool`): Show only executors that can
execute the included views. (default false)
* **filter-queue** (`bool`): Show only included jobs in builder
queue. (default false)
* **sections** (`list`): The views to show in sections.
Example:
.. literalinclude::
/../../tests/views/fixtures/view_sectioned.yaml
"""
import xml.etree.ElementTree as XML
import jenkins_jobs.modules.base
import jenkins_jobs.modules.helpers as helpers
from jenkins_jobs.modules import view_list
class Sectioned(jenkins_jobs.modules.base.Base):
def root_xml(self, data):
root = XML.Element("hudson.plugins.sectioned__view.SectionedView")
mapping = [
("name", "name", None),
("description", "description", ""),
("filter-executors", "filterExecutors", False),
("filter-queue", "filterQueue", False),
]
helpers.convert_mapping_to_xml(root, data, mapping, fail_required=True)
XML.SubElement(root, "properties", {"class": "hudson.model.View$PropertyList"})
s_xml = XML.SubElement(root, "sections")
sections = data.get("sections", [])
for section in sections:
if "view-type" not in section:
raise KeyError("This sectioned view is missing a view-type.", section)
if section["view-type"] == "list":
project = view_list.List(self.registry)
elif section["view-type"] == "text":
project = SectionedText(self.registry)
else:
raise ValueError(
"Nested view-type %s is not known. Supported types: list, text."
% section["view-type"]
)
xml_project = project.root_xml(section, sectioned=True)
s_xml.append(xml_project)
return root
class SectionedText(jenkins_jobs.modules.base.Base):
def root_xml(self, data, sectioned=False):
assert sectioned
root = XML.Element("hudson.plugins.sectioned__view.TextSection")
# these are in the XML and look like from view_list,
# but the UI has no controls for them
jn_xml = XML.SubElement(root, "jobNames")
XML.SubElement(
jn_xml, "comparator", {"class": "hudson.util.CaseInsensitiveComparator"}
)
XML.SubElement(root, "jobFilters")
mapping = [
("name", "name", ""),
("width", "width", "FULL", ["FULL", "HALF", "THIRD", "TWO_THIRDS"]),
("alignment", "alignment", "CENTER", ["CENTER", "LEFT", "RIGHT"]),
("text", "text", None),
("style", "style", "NONE", ["NONE", "NOTE", "INFO", "WARNING", "TIP"]),
]
helpers.convert_mapping_to_xml(root, data, mapping, fail_required=True)
return root
|