145 lines
5.3 KiB
Python
145 lines
5.3 KiB
Python
# Copyright 2020 The Matrix.org Foundation C.I.C.
|
|
#
|
|
# 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.
|
|
|
|
import os.path
|
|
import tempfile
|
|
from unittest.mock import Mock
|
|
|
|
from synapse.config import ConfigError
|
|
from synapse.config._base import Config
|
|
from synapse.util.stringutils import random_string
|
|
|
|
from tests import unittest
|
|
|
|
|
|
class BaseConfigTestCase(unittest.TestCase):
|
|
def setUp(self) -> None:
|
|
# The root object needs a server property with a public_baseurl.
|
|
root = Mock()
|
|
root.server.public_baseurl = "http://test"
|
|
self.config = Config(root)
|
|
|
|
def test_loading_missing_templates(self) -> None:
|
|
# Use a temporary directory that exists on the system, but that isn't likely to
|
|
# contain template files
|
|
with tempfile.TemporaryDirectory() as tmp_dir:
|
|
# Attempt to load an HTML template from our custom template directory
|
|
template = self.config.read_templates(["sso_error.html"], (tmp_dir,))[0]
|
|
|
|
# If no errors, we should've gotten the default template instead
|
|
|
|
# Render the template
|
|
a_random_string = random_string(5)
|
|
html_content = template.render({"error_description": a_random_string})
|
|
|
|
# Check that our string exists in the template
|
|
self.assertIn(
|
|
a_random_string,
|
|
html_content,
|
|
"Template file did not contain our test string",
|
|
)
|
|
|
|
def test_loading_custom_templates(self) -> None:
|
|
# Use a temporary directory that exists on the system
|
|
with tempfile.TemporaryDirectory() as tmp_dir:
|
|
# Create a temporary bogus template file
|
|
with tempfile.NamedTemporaryFile(dir=tmp_dir) as tmp_template:
|
|
# Get temporary file's filename
|
|
template_filename = os.path.basename(tmp_template.name)
|
|
|
|
# Write a custom HTML template
|
|
contents = b"{{ test_variable }}"
|
|
tmp_template.write(contents)
|
|
tmp_template.flush()
|
|
|
|
# Attempt to load the template from our custom template directory
|
|
template = (
|
|
self.config.read_templates([template_filename], (tmp_dir,))
|
|
)[0]
|
|
|
|
# Render the template
|
|
a_random_string = random_string(5)
|
|
html_content = template.render({"test_variable": a_random_string})
|
|
|
|
# Check that our string exists in the template
|
|
self.assertIn(
|
|
a_random_string,
|
|
html_content,
|
|
"Template file did not contain our test string",
|
|
)
|
|
|
|
def test_multiple_custom_template_directories(self) -> None:
|
|
"""Tests that directories are searched in the right order if multiple custom
|
|
template directories are provided.
|
|
"""
|
|
# Create two temporary directories on the filesystem.
|
|
tempdirs = [
|
|
tempfile.TemporaryDirectory(),
|
|
tempfile.TemporaryDirectory(),
|
|
]
|
|
|
|
# Create one template in each directory, whose content is the index of the
|
|
# directory in the list.
|
|
template_filename = "my_template.html.j2"
|
|
for i in range(len(tempdirs)):
|
|
tempdir = tempdirs[i]
|
|
template_path = os.path.join(tempdir.name, template_filename)
|
|
|
|
with open(template_path, "w") as fp:
|
|
fp.write(str(i))
|
|
fp.flush()
|
|
|
|
# Retrieve the template.
|
|
template = (
|
|
self.config.read_templates(
|
|
[template_filename],
|
|
(td.name for td in tempdirs),
|
|
)
|
|
)[0]
|
|
|
|
# Test that we got the template we dropped in the first directory in the list.
|
|
self.assertEqual(template.render(), "0")
|
|
|
|
# Add another template, this one only in the second directory in the list, so we
|
|
# can test that the second directory is still searched into when no matching file
|
|
# could be found in the first one.
|
|
other_template_name = "my_other_template.html.j2"
|
|
other_template_path = os.path.join(tempdirs[1].name, other_template_name)
|
|
|
|
with open(other_template_path, "w") as fp:
|
|
fp.write("hello world")
|
|
fp.flush()
|
|
|
|
# Retrieve the template.
|
|
template = (
|
|
self.config.read_templates(
|
|
[other_template_name],
|
|
(td.name for td in tempdirs),
|
|
)
|
|
)[0]
|
|
|
|
# Test that the file has the expected content.
|
|
self.assertEqual(template.render(), "hello world")
|
|
|
|
# Cleanup the temporary directories manually since we're not using a context
|
|
# manager.
|
|
for td in tempdirs:
|
|
td.cleanup()
|
|
|
|
def test_loading_template_from_nonexistent_custom_directory(self) -> None:
|
|
with self.assertRaises(ConfigError):
|
|
self.config.read_templates(
|
|
["some_filename.html"], ("a_nonexistent_directory",)
|
|
)
|