def setUp(self):
here = os.path.dirname(__file__)
self.__test_dir = os.path.abspath(os.path.join(here, 'testdir'))
self.__md_dir = os.path.join(self.__test_dir, 'tmp-markdown-files')
self.private_folder = os.path.join(self.__test_dir, 'tmp-private')
self.__src_dir = os.path.join(self.__test_dir, 'tmp-src-files')
self.__output_dir = os.path.join(self.__test_dir, 'tmp-output')
self.__remove_tmp_dirs()
os.mkdir(self.__test_dir)
os.mkdir(self.__md_dir)
os.mkdir(self.private_folder)
os.mkdir(self.__src_dir)
self.app = Application((TestExtension, ))
Logger.fatal_warnings = True
Logger.silent = True
def create_application():
ext_classes = get_installed_extension_classes(sort=True)
return Application(ext_classes)
class TestTree(unittest.TestCase):
def setUp(self):
here = os.path.dirname(__file__)
self.__test_dir = os.path.abspath(os.path.join(here, 'testdir'))
self.__md_dir = os.path.join(self.__test_dir, 'tmp-markdown-files')
self.private_folder = os.path.join(self.__test_dir, 'tmp-private')
self.__src_dir = os.path.join(self.__test_dir, 'tmp-src-files')
self.__output_dir = os.path.join(self.__test_dir, 'tmp-output')
self.__remove_tmp_dirs()
os.mkdir(self.__test_dir)
os.mkdir(self.__md_dir)
os.mkdir(self.private_folder)
os.mkdir(self.__src_dir)
self.app = Application((TestExtension,))
Logger.fatal_warnings = True
Logger.raise_on_fatal_warnings = True
Logger.silent = True
def tearDown(self):
self.__remove_tmp_dirs()
TestExtension.symbols = []
TestExtension.comments = []
Logger.fatal_warnings = False
Logger.silent = False
Logger.reset()
def __write_sitemap(self, text):
path = os.path.join(self.__md_dir, 'sitemap.txt')
with io.open(path, 'w', encoding='utf-8') as _:
_.write(text)
return path
def __create_md_file(self, name, contents):
path = os.path.join(self.__md_dir, name)
if not os.path.exists(os.path.dirname(path)):
os.makedirs(os.path.dirname(path))
with open(path, 'w') as _:
_.write(contents)
return path
def __create_src_file(self, name, symbols):
path = os.path.join(self.__src_dir, name)
if os.path.dirname(name):
os.makedirs(os.path.join(self.__src_dir, os.path.dirname(name)))
with open(path, 'w') as _:
for symbol in symbols:
_.write('%s\n' % symbol)
return path
def __remove_tmp_dirs(self):
shutil.rmtree(self.__test_dir, ignore_errors=True)
def __make_config(self, conf):
return Config(conf_file=os.path.join(self.__test_dir, 'hotdoc.json'),
json_conf=conf)
def __make_project(self, sitemap, index_path, symbols=None, comments=None, output=None):
conf = {'project_name': 'test',
'project_version': '1.0'}
conf['sitemap'] = self.__write_sitemap(sitemap)
if output is not None:
conf['output'] = output
if symbols is not None:
TestExtension.symbols = symbols
conf['test_sources'] = []
all_src_files = set()
for _, kwargs in TestExtension.symbols:
fname = kwargs.get('filename')
if fname is not None:
if fname not in all_src_files:
conf['test_sources'].append(self.__create_src_file(fname, []))
all_src_files.add(fname)
kwargs['filename'] = os.path.join(self.__src_dir, fname)
if comments is not None:
TestExtension.comments = comments
conf['index'] = index_path
conf = self.__make_config(conf)
self.app.parse_config(conf)
self.app.run()
# pylint: disable=too-many-arguments
def __create_test_layout(self, with_ext_index=True, sitemap=None,
symbols=None, source_roots=None, comments=None,
output=None):
conf = {'project_name': 'test',
'project_version': '1.0'}
if not sitemap:
inp = (u'index.markdown\n'
'\ttest-index\n'
'\t\ttest-section.markdown\n'
'\t\t\tsource_a.test\n'
'\t\tpage_y.markdown\n'
'\tcore_page.markdown\n')
else:
inp = sitemap
if symbols is None:
TestExtension.symbols = [
(
[FunctionSymbol],
{
'unique_name': 'symbol_1',
'filename': 'source_a.test'
}
),
(
[FunctionSymbol],
{
'unique_name': 'symbol_2',
'filename': 'source_a.test'
}
),
(
[FunctionSymbol],
{
'unique_name': 'symbol_3',
'filename': 'source_b.test'
}
),
(
[FunctionSymbol],
{
'unique_name': 'symbol_4',
'filename': 'source_b.test'
}
),
]
else:
TestExtension.symbols = symbols
if comments is not None:
TestExtension.comments = comments
conf['test_sources'] = []
all_src_files = set()
for _, kwargs in TestExtension.symbols:
fname = kwargs.get('filename')
if fname is not None:
if fname not in all_src_files:
conf['test_sources'].append(self.__create_src_file(fname, []))
all_src_files.add(fname)
kwargs['filename'] = os.path.join(self.__src_dir, fname)
if source_roots:
conf['test_source_roots'] = source_roots
if output:
conf['output'] = output
conf['index'] = self.__create_md_file(
'index.markdown',
(u'# My documentation\n'))
self.__create_md_file(
'core_page.markdown',
(u'# My non-extension page\n'))
self.__create_md_file(
'test-section.markdown',
(u'# My test section\n'
'\n'
'Linking to [a generated page](source_a.test)\n'))
self.__create_md_file(
'page_y.markdown',
(u'# Page Y\n'))
if with_ext_index:
conf['test-index'] = self.__create_md_file(
'test-index.markdown',
(u'# My test index\n'))
conf['sitemap'] = self.__write_sitemap(inp)
conf = self.__make_config(conf)
self.app.parse_config(conf)
self.app.run()
def test_basic(self):
conf = {'project_name': 'test',
'project_version': '1.0'}
conf['index'] = self.__create_md_file(
'index.markdown',
(u'# My documentation\n'))
self.__create_md_file(
'section.markdown',
(u'# My section\n'))
inp = (u'index.markdown\n'
'\tsection.markdown')
conf['sitemap'] = self.__write_sitemap(inp)
conf = self.__make_config(conf)
self.app.parse_config(conf)
self.app.run()
pages = self.app.project.tree.get_pages()
self.assertSetEqual(
set(pages.keys()),
set([u'index.markdown',
u'section.markdown']))
index = pages.get('index.markdown')
self.assertEqual(index.title, u'My documentation')
def test_page_output_path(self):
conf = {'project_name': 'test',
'project_version': '1.0'}
conf['index'] = self.__create_md_file(
'index.markdown',
(u'# My documentation\n'))
subfolder_page_path = os.path.join('subfolder', 'page.markdown')
self.__create_md_file(
subfolder_page_path,
(u'# Page in a subfolder\n'))
inp = (u'index.markdown\n'
'\tsubfolder/page.markdown')
conf['sitemap'] = self.__write_sitemap(inp)
conf = self.__make_config(conf)
self.app.parse_config(conf)
self.app.run()
pages = self.app.project.tree.get_pages()
self.assertIn(subfolder_page_path, pages)
subfolder_page = pages[subfolder_page_path]
self.assertEqual(subfolder_page.link.ref, os.path.join('subfolder', 'page.html'))
def test_generated_page_output_path(self):
sitemap = (u'index.markdown\n'
'\ttest-index\n')
index_path = self.__create_md_file(
'index.markdown',
(u'# My documentation\n'))
a_source_path = os.path.join('a', 'source1.test')
b_source_path = os.path.join('b', 'source1.test')
symbols = [
(
[FunctionSymbol],
{
'unique_name': 'symbol_a',
'filename': a_source_path,
}
),
(
[FunctionSymbol],
{
'unique_name': 'symbol_b',
'filename': b_source_path,
}
),
]
self.__make_project(sitemap, index_path, symbols=symbols)
pages = self.app.project.tree.get_pages()
self.assertEqual(len(pages), 4)
a_page = pages[a_source_path]
b_page = pages[b_source_path]
self.assertEqual(a_page.link.ref, os.path.join('a', 'source1.html'))
self.assertEqual(b_page.link.ref, os.path.join('b', 'source1.html'))
def test_section_and_path_conflict(self):
sitemap = (u'index.markdown\n'
'\ttest-index\n')
index_path = self.__create_md_file(
'index.markdown',
(u'# My documentation\n'))
a_source_path = 'source1.test'
b_source_path = 'source2.test'
symbols = [
(
[FunctionSymbol],
{
'unique_name': 'symbol_a',
'filename': a_source_path,
}
),
]
comments = [
Comment(name='source1',
filename=b_source_path,
meta={'auto-sort': True}, toplevel=True),
]
with self.assertRaises(InvalidOutputException):
self.__make_project(sitemap, index_path, symbols=symbols, comments=comments,
output=self.__output_dir)
def test_symbol_listed_twice(self):
sitemap = (u'index.markdown\n'
'\ttest-index\n')
index_path = self.__create_md_file(
'index.markdown',
(u'# My documentation\n'))
a_source_path = 'source_a.test'
b_source_path = 'source_b.test'
c_source_path = 'source_c.test'
symbols = [
(
[FunctionSymbol],
{
'unique_name': 'symbol_a',
'filename': a_source_path,
}
),
]
comments = [
Comment(name='page_1',
meta={'symbols': ['symbol_a']},
filename=b_source_path,
toplevel=True),
Comment(name='page_2',
meta={'symbols': ['symbol_a']},
filename=c_source_path,
toplevel=True),
]
with self.assertRaises(SymbolListedTwiceException):
self.__make_project(sitemap, index_path, symbols=symbols, comments=comments,
output=self.__output_dir)
def test_private_symbol_listed(self):
sitemap = (u'index.markdown\n'
'\ttest-index\n')
index_path = self.__create_md_file(
'index.markdown',
(u'# My documentation\n'))
a_source_path = 'source_a.test'
b_source_path = 'source_b.test'
c_source_path = 'source_c.test'
symbols = [
(
[FunctionSymbol],
{
'unique_name': 'symbol_a',
'filename': a_source_path,
}
),
]
comments = [
Comment(name='page_1',
meta={'private-symbols': ['symbol_a']},
filename=b_source_path,
toplevel=True),
Comment(name='page_2',
meta={'symbols': ['symbol_a']},
filename=c_source_path,
toplevel=True),
]
with self.assertRaises(SymbolListedTwiceException):
self.__make_project(sitemap, index_path, symbols=symbols, comments=comments,
output=self.__output_dir)
def test_relocated_symbol_marked_private(self):
sitemap = (u'index.markdown\n'
'\ttest-index\n')
index_path = self.__create_md_file(
'index.markdown',
(u'# My documentation\n'))
a_source_path = 'source_a.test'
b_source_path = 'source_b.test'
c_source_path = 'source_c.test'
symbols = [
(
[FunctionSymbol],
{
'unique_name': 'symbol_a',
'filename': a_source_path,
}
),
]
comments = [
Comment(name='page_1',
meta={'symbols': ['symbol_a']},
filename=b_source_path,
toplevel=True),
Comment(name='page_2',
meta={'private-symbols': ['symbol_a']},
filename=c_source_path,
toplevel=True),
]
with self.assertRaises(SymbolListedTwiceException):
self.__make_project(sitemap, index_path, symbols=symbols, comments=comments,
output=self.__output_dir)
def test_symbol_marked_private_twice(self):
sitemap = (u'index.markdown\n'
'\ttest-index\n')
index_path = self.__create_md_file(
'index.markdown',
(u'# My documentation\n'))
a_source_path = 'source_a.test'
b_source_path = 'source_b.test'
c_source_path = 'source_c.test'
symbols = [
(
[FunctionSymbol],
{
'unique_name': 'symbol_a',
'filename': a_source_path,
}
),
]
comments = [
Comment(name='page_1',
meta={'private-symbols': ['symbol_a']},
filename=b_source_path,
toplevel=True),
Comment(name='page_2',
meta={'private-symbols': ['symbol_a']},
filename=c_source_path,
toplevel=True),
]
with self.assertRaises(SymbolListedTwiceException):
self.__make_project(sitemap, index_path, symbols=symbols, comments=comments,
output=self.__output_dir)
def test_sitemap_page_not_found(self):
sitemap = (u'index.markdown\n'
'\n'
'\tmissing-page.markdown\n')
index_path = self.__create_md_file(
'index.markdown',
(u'# My documentation\n'))
with self.assertRaises(PageNotFoundException) as cm:
self.__make_project(sitemap, index_path)
self.assertEqual(cm.exception.lineno, 2)
self.assertEqual(cm.exception.column, 9)
def test_sitemap_index_extension_not_found(self):
sitemap = (u'index.markdown\n'
'\tdoes-not-exist-index\n')
index_path = self.__create_md_file(
'index.markdown',
(u'# My documentation\n'))
with self.assertRaises(IndexExtensionNotFoundException) as cm:
self.__make_project(sitemap, index_path)
self.assertEqual(cm.exception.lineno, 1)
self.assertEqual(cm.exception.column, 9)
def __assert_extension_names(self, tree, name_map):
pages = tree.get_pages()
for name, ext_name in list(name_map.items()):
page = pages[name]
self.assertEqual(ext_name, page.extension_name)
def test_extension_basic(self):
self.__create_test_layout()
self.__assert_extension_names(
self.app.project.tree,
{u'index.markdown': 'core',
u'test-index': 'test-extension',
u'test-section.markdown': 'test-extension',
u'source_a.test': 'test-extension',
u'source_b.test': 'test-extension',
u'page_y.markdown': 'test-extension',
u'core_page.markdown': 'core'})
all_pages = self.app.project.tree.get_pages()
self.assertEqual(len(all_pages), 7)
self.assertNotIn('source_a.test', all_pages['test-index'].subpages)
self.assertIn('source_a.test',
all_pages['test-section.markdown'].subpages)
def test_no_extension_index_override(self):
self.__create_test_layout(with_ext_index=False)
ext_index = self.app.project.tree.get_pages()['test-index']
self.assertEqual(ext_index.generated, True)
self.assertEqual(len(ext_index.subpages), 3)
def test_parse_yaml(self):
conf = {'project_name': 'test',
'project_version': '1.0'}
inp = (u'index.markdown\n')
conf['sitemap'] = self.__write_sitemap(inp)
conf['index'] = self.__create_md_file(
'index.markdown',
(u'---\n'
'title: A random title\n'
'...\n'
'# My documentation\n'))
conf = self.__make_config(conf)
self.app.parse_config(conf)
self.app.run()
pages = self.app.project.tree.get_pages()
page = pages.get('index.markdown')
out, _ = cmark.ast_to_html(page.ast, None)
self.assertEqual(
out,
u'<h1>My documentation</h1>\n')
self.assertEqual(page.title, u'A random title')
def test_empty_link_resolution(self):
conf = {'project_name': 'test',
'project_version': '1.0',
'output': self.__output_dir}
inp = (u'index.markdown\n'
'\tsection.markdown')
conf['sitemap'] = self.__write_sitemap(inp)
conf['index'] = self.__create_md_file(
'index.markdown',
(u'# My documentation\n'))
self.__create_md_file(
'section.markdown',
(u'# My section\n'
'\n'
'[](index.markdown)\n'))
conf = self.__make_config(conf)
self.app.parse_config(conf)
self.app.run()
pages = self.app.project.tree.get_pages()
page = pages.get('section.markdown')
self.assertEqual(
page.formatted_contents,
u'<h1>My section</h1>\n'
'<p><a href="index.html">My documentation</a></p>\n')
def test_labeled_link_resolution(self):
conf = {'project_name': 'test',
'project_version': '1.0',
'output': self.__output_dir}
inp = (u'index.markdown\n'
'\tsection.markdown')
conf['sitemap'] = self.__write_sitemap(inp)
conf['index'] = self.__create_md_file(
'index.markdown',
(u'# My documentation\n'))
self.__create_md_file(
'section.markdown',
(u'# My section\n'
'\n'
'[a label](index.markdown)\n'))
conf = self.__make_config(conf)
self.app.parse_config(conf)
self.app.run()
pages = self.app.project.tree.get_pages()
page = pages.get('section.markdown')
self.assertEqual(
page.formatted_contents,
u'<h1>My section</h1>\n'
'<p><a href="index.html">a label</a></p>\n')
def test_anchored_link_resolution(self):
conf = {'project_name': 'test',
'project_version': '1.0',
'output': self.__output_dir}
inp = (u'index.markdown\n'
'\tsection.markdown')
conf['sitemap'] = self.__write_sitemap(inp)
conf['index'] = self.__create_md_file(
'index.markdown',
(u'# My documentation\n'))
self.__create_md_file(
'section.markdown',
(u'# My section\n'
'\n'
'[](index.markdown#subsection)\n'))
conf = self.__make_config(conf)
self.app.parse_config(conf)
self.app.run()
pages = self.app.project.tree.get_pages()
page = pages.get('section.markdown')
self.assertEqual(
page.formatted_contents,
u'<h1>My section</h1>\n'
'<p><a href="index.html#subsection">My documentation</a></p>\n')
def test_extension_index_only(self):
conf = {'project_name': 'test',
'project_version': '1.0',
'include_paths': [self.__md_dir]}
inp = (u'test-index\n'
'\ttest-section.markdown\n')
conf['sitemap'] = self.__write_sitemap(inp)
self.__create_md_file(
'test-section.markdown',
u'# My test section\n')
conf = self.__make_config(conf)
self.app.parse_config(conf)
self.app.run()
self.__assert_extension_names(
self.app.project.tree,
{u'test-index': 'test-extension',
u'test-section.markdown': 'test-extension'})
def test_extension_auto_sorted_override(self):
sitemap = (u'index.markdown\n'
'\ttest-index\n'
'\t\ttest-section.markdown\n'
'\t\t\tsource_b.test\n'
'\t\t\tsource_a.test\n'
'\t\tpage_y.markdown\n'
'\tcore_page.markdown\n')
comments = [
Comment(name='source_b.test',
filename=os.path.join(self.__src_dir, 'source_b.test'),
meta={'auto-sort': True}, toplevel=True),
]
self.__create_test_layout(sitemap=sitemap, comments=comments)
pages = self.app.project.tree.get_pages()
self.assertTrue(pages['source_a.test'].pre_sorted)
self.assertFalse(pages['source_b.test'].pre_sorted)
def test_extension_file_include_dirs(self):
sitemap = ('index.markdown\n'
'\ttest-index\n'
'\t\ttest-section.markdown\n'
'\t\t\tsource1.test\n'
'\t\t\tsource2.test\n')
symbols = [
(
[FunctionSymbol],
{
'unique_name': 'symbol_a',
'filename': 'a/source1.test'
}
),
(
[FunctionSymbol],
{
'unique_name': 'symbol_b',
'filename': 'b/source2.test'
}
),
]
self.__create_test_layout(
sitemap=sitemap, symbols=symbols,
source_roots=[os.path.join(self.__src_dir, 'a'),
os.path.join(self.__src_dir, 'b')])
source1 = self.app.project.tree.get_pages()['source1.test']
self.assertEqual(source1.symbol_names, ['symbol_a'])
source2 = self.app.project.tree.get_pages()['source2.test']
self.assertEqual(source2.symbol_names, ['symbol_b'])
def test_multiple_toplevel_comments(self):
sitemap = ('index.markdown\n'
'\ttest-index\n')
symbols = [
(
[FunctionSymbol],
{
'unique_name': 'symbol_a',
'filename': 'source1.test'
}
),
(
[FunctionSymbol],
{
'unique_name': 'symbol_b',
'filename': 'source1.test'
}
),
(
[FunctionSymbol],
{
'unique_name': 'symbol_c',
'filename': 'source1.test'
}
),
]
comments = [
Comment(name='foo',
filename=os.path.join(self.__src_dir, 'source1.test'),
meta={'symbols': ['symbol_a']}, toplevel=True),
Comment(name='bar',
filename=os.path.join(self.__src_dir, 'source1.test'),
meta={'symbols': ['symbol_b']}, toplevel=True),
]
self.__create_test_layout(
sitemap=sitemap, symbols=symbols, comments=comments,
output=self.__output_dir)
pages = self.app.project.tree.get_pages()
self.assertEqual(len(pages), 4)
self.assertIn('foo', pages)
foo = pages['foo']
self.assertEqual(foo.symbol_names, ['symbol_a', 'symbol_c'])
self.assertIn('bar', pages)
foo = pages['bar']
self.assertEqual(foo.symbol_names, ['symbol_b'])
def test_comment_relocation_basic(self):
sitemap = ('index.markdown\n'
'\ttest-index\n')
symbols = [
(
[FunctionSymbol],
{
'unique_name': 'symbol_a',
'filename': 'source1.test'
}
),
(
[FunctionSymbol],
{
'unique_name': 'symbol_b',
'filename': 'source2.test'
}
),
]
# symbol_b should be documented in source1
comments = [
Comment(name='source1.test',
filename=os.path.join(self.__src_dir, 'source1.test'),
meta={'symbols': ['symbol_b']}, toplevel=True),
]
self.__create_test_layout(
sitemap=sitemap, symbols=symbols, comments=comments,
output=self.__output_dir,
source_roots=[os.path.join(self.__src_dir, 'a'),
os.path.join(self.__src_dir, 'b')])
pages = self.app.project.tree.get_pages()
self.assertEqual(len(pages), 3)
self.assertIn('source1.test', pages)
source1 = self.app.project.tree.get_pages()['source1.test']
self.assertEqual(source1.symbol_names, ['symbol_a', 'symbol_b'])
# source2 should not appear in the sitemap
self.assertNotIn('source2.test', pages)
def test_parented_symbols(self):
sitemap = ('index.markdown\n'
'\ttest-index\n'
'\t\ttest-section.markdown\n')
symbols = [
(
[ClassSymbol],
{
'unique_name': 'symbol_a',
'filename': 'source1.test'
}
),
(
[FunctionSymbol],
{
'unique_name': 'symbol_b',
'filename': 'source2.test',
'parent_name': 'symbol_a',
}
),
]
self.__create_test_layout(
sitemap=sitemap, symbols=symbols,
source_roots=[os.path.join(self.__src_dir, 'a'),
os.path.join(self.__src_dir, 'b')])
pages = self.app.project.tree.get_pages()
self.assertIn('source1.test', pages)
source1 = self.app.project.tree.get_pages()['source1.test']
self.assertEqual(source1.symbol_names, ['symbol_a', 'symbol_b'])
# source2 should not appear in the sitemap
self.assertNotIn('source2.test', pages)
def test_relocation_from_source(self):
sitemap = ('index.markdown\n'
'\ttest-index\n')
symbols = [
(
[FunctionSymbol],
{
'unique_name': 'symbol_a',
'filename': os.path.join('a', 'source1.test')
}
),
(
[FunctionSymbol],
{
'unique_name': 'symbol_b',
'filename': os.path.join('b', 'source2.test')
}
),
]
# symbol_b should be documented in page_1
comments = [
Comment(name='page_1',
filename=os.path.join(self.__src_dir, 'a', 'source1.test'),
meta={'sources': [os.path.join(os.pardir, 'b', 'source2.test')]}, toplevel=True),
]
self.__create_test_layout(
sitemap=sitemap, symbols=symbols, comments=comments,
output=self.__output_dir)
pages = self.app.project.tree.get_pages()
self.assertIn('page_1', pages)
source1 = self.app.project.tree.get_pages()['page_1']
self.assertEqual(source1.symbol_names, ['symbol_a', 'symbol_b'])
# source2 should not appear in the with only its section
self.assertNotIn(os.path.join('b', 'source2.test'), pages)
self.assertEqual(len(pages), 3)
def test_invalid_relocated_source(self):
sitemap = (u'index.markdown\n'
'\ttest-index\n')
index_path = self.__create_md_file(
'index.markdown',
(u'# My documentation\n'))
a_source_path = 'source_a.test'
b_source_path = 'source_b.test'
symbols = [
(
[FunctionSymbol],
{
'unique_name': 'symbol_a',
'filename': a_source_path,
}
),
]
comments = [
Comment(name='page_1',
meta={'sources': ['does-not-exist.test']},
filename=os.path.join(self.__src_dir, b_source_path),
toplevel=True),
]
with self.assertRaises(InvalidRelocatedSourceException):
self.__make_project(sitemap, index_path, symbols=symbols, comments=comments,
output=self.__output_dir)
def test_source_relocated_twice(self):
sitemap = (u'index.markdown\n'
'\ttest-index\n')
index_path = self.__create_md_file(
'index.markdown',
(u'# My documentation\n'))
a_source_path = 'source_a.test'
b_source_path = 'source_b.test'
c_source_path = 'source_c.test'
symbols = [
(
[FunctionSymbol],
{
'unique_name': 'symbol_a',
'filename': a_source_path,
}
),
]
comments = [
Comment(name='page_1',
meta={'sources': ['source_a.test']},
filename=os.path.join(self.__src_dir, b_source_path),
toplevel=True),
Comment(name='page_1',
meta={'sources': ['source_a.test']},
filename=os.path.join(self.__src_dir, c_source_path),
toplevel=True),
]
with self.assertRaises(InvalidRelocatedSourceException):
self.__make_project(sitemap, index_path, symbols=symbols, comments=comments,
output=self.__output_dir)