/usr/lib/python2.7/dist-packages/cobbler/templar.py is in python-cobbler 2.4.1-0ubuntu2.
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 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 | """
Cobbler uses Cheetah templates for lots of stuff, but there's
some additional magic around that to deal with snippets/etc.
(And it's not spelled wrong!)
Copyright 2008-2009, Red Hat, Inc and Others
Michael DeHaan <michael.dehaan AT gmail>
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 2 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, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
02110-1301 USA
"""
import os
import os.path
import glob
import pprint
from cexceptions import *
from template_api import Template
from utils import *
import utils
import clogger
import Cheetah
major, minor, release = Cheetah.Version.split('.')[0:3]
fix_cheetah_class = int(major) >= 2 and int(minor) >=4 and int(release) >= 2
jinja2_available = False
try:
import jinja2
jinja2_available = True
except:
""" FIXME: log a message here """
pass
try:
import functools
except:
functools = None
class Templar:
def __init__(self,config,logger=None):
"""
Constructor
"""
self.config = None
self.settings = None
if config:
self.config = config
self.settings = config.settings()
self.last_errors = []
if logger is None:
logger = clogger.Logger()
self.logger = logger
def check_for_invalid_imports(self,data):
"""
Ensure that Cheetah code is not importing Python modules
that may allow for advanced priveledges by ensuring we whitelist
the imports that we allow
"""
lines = data.split("\n")
for line in lines:
if line.find("#import") != -1:
rest=line.replace("#import","").replace(" ","").strip()
if self.settings and rest not in self.settings.cheetah_import_whitelist:
raise CX("potentially insecure import in template: %s" % rest)
def render(self, data_input, search_table, out_path, subject=None, template_type=None):
"""
Render data_input back into a file.
data_input is either a string or a filename
search_table is a hash of metadata keys and values
out_path if not-none writes the results to a file
(though results are always returned)
subject is a profile or system object, if available (for snippet eval)
"""
if not isinstance(data_input, basestring):
raw_data = data_input.read()
else:
raw_data = data_input
lines = raw_data.split('\n')
if not template_type:
# Assume we're using the default template type, if set in
# the settinigs file or use cheetah as the last resort
if self.settings and self.settings.default_template_type:
template_type = self.settings.default_template_type
else:
template_type = "cheetah"
if len(lines) > 0 and lines[0].find("#template=") == 0:
# pull the template type out of the first line and then drop
# it and rejoin them to pass to the template language
template_type = lines[0].split("=")[1].strip().lower()
del lines[0]
raw_data = string.join(lines,"\n")
if template_type == "cheetah":
data_out = self.render_cheetah(raw_data, search_table, subject)
elif template_type == "jinja2":
if jinja2_available:
data_out = self.render_jinja2(raw_data, search_table, subject)
else:
return "# ERROR: JINJA2 NOT AVAILABLE. Maybe you need to install python-jinja2?\n"
else:
return "# ERROR: UNSUPPORTED TEMPLATE TYPE (%s)" % str(template_type)
# now apply some magic post-filtering that is used by cobbler import and some
# other places. Forcing folks to double escape things would be very unwelcome.
hp = search_table.get("http_port","80")
server = search_table.get("server","server.example.org")
if hp not in (80, '80'):
repstr = "%s:%s" % (server, hp)
else:
repstr = server
search_table["http_server"] = repstr
for x in search_table.keys():
if type(x) == str:
data_out = data_out.replace("@@%s@@" % str(x), str(search_table[str(x)]))
# remove leading newlines which apparently breaks AutoYAST ?
if data_out.startswith("\n"):
data_out = data_out.lstrip()
# if requested, write the data out to a file
if out_path is not None:
utils.mkdir(os.path.dirname(out_path))
fd = open(out_path, "w+")
fd.write(data_out)
fd.close()
return data_out
def render_cheetah(self, raw_data, search_table, subject=None):
"""
Render data_input back into a file.
data_input is either a string or a filename
search_table is a hash of metadata keys and values
(though results are always returned)
subject is a profile or system object, if available (for snippet eval)
"""
self.check_for_invalid_imports(raw_data)
# backward support for Cobbler's legacy (and slightly more readable)
# template syntax.
raw_data = raw_data.replace("TEMPLATE::","$")
# HACK: the ksmeta field may contain nfs://server:/mount in which
# case this is likely WRONG for kickstart, which needs the NFS
# directive instead. Do this to make the templates work.
newdata = ""
if search_table.has_key("tree") and search_table["tree"].startswith("nfs://"):
for line in raw_data.split("\n"):
if line.find("--url") != -1 and line.find("url ") != -1:
rest = search_table["tree"][6:] # strip off "nfs://" part
try:
(server, dir) = rest.split(":",2)
except:
raise CX("Invalid syntax for NFS path given during import: %s" % search_table["tree"])
line = "nfs --server %s --dir %s" % (server,dir)
# but put the URL part back in so koan can still see
# what the original value was
line = line + "\n" + "#url --url=%s" % search_table["tree"]
newdata = newdata + line + "\n"
raw_data = newdata
# tell Cheetah not to blow up if it can't find a symbol for something
raw_data = "#errorCatcher ListErrors\n" + raw_data
table_copy = search_table.copy()
# for various reasons we may want to call a module inside a template and pass
# it all of the template variables. The variable "template_universe" serves
# this purpose to make it easier to iterate through all of the variables without
# using internal Cheetah variables
search_table.update({
"template_universe" : table_copy
})
# now do full templating scan, where we will also templatify the snippet insertions
t = Template(source=raw_data, searchList=[search_table], compilerSettings={'useStackFrame':False})
if fix_cheetah_class and functools is not None:
t.SNIPPET = functools.partial(t.SNIPPET, t)
t.read_snippet = functools.partial(t.read_snippet, t)
try:
data_out = t.respond()
self.last_errors = t.errorCatcher().listErrors()
if self.last_errors:
self.logger.warning("errors were encountered rendering the template")
self.logger.warning("\n" + pprint.pformat(self.last_errors))
except Exception, e:
self.logger.error(utils.cheetah_exc(e))
raise CX("Error templating file, check cobbler.log for more details")
return data_out
def render_jinja2(self, raw_data, search_table, subject=None):
"""
Render data_input back into a file.
data_input is either a string or a filename
search_table is a hash of metadata keys and values
out_path if not-none writes the results to a file
(though results are always returned)
subject is a profile or system object, if available (for snippet eval)
"""
try:
template = jinja2.Template(raw_data)
data_out = template.render(search_table)
except:
data_out = "# EXCEPTION OCCURRED DURING JINJA2 TEMPLATE PROCESSING\n"
return data_out
|