def test_custom_arguments_alt_false_source_true(self):
'''Tests to ensure that image tag is rendered correctly when alt argument is not required and source argument is required and expected images are updated.
'''
custom_argument_rules = {
"image-inline": {
"alt": False,
"source": True
}
}
verto_extension_custom_rules = VertoExtension(
processors=[self.processor_name],
custom_argument_rules=custom_argument_rules)
test_string = self.read_test_file(self.processor_name,
'alt_false_source_true.md')
processor = ImageInlinePattern(self.ext, self.md.parser)
self.assertIsNotNone(re.search(processor.compiled_re, test_string))
converted_test_string = markdown.markdown(
test_string, extensions=[verto_extension_custom_rules])
expected_string = self.read_test_file(
self.processor_name,
'alt_false_source_true_expected.html',
strip=True)
self.assertEqual(expected_string, converted_test_string)
images = verto_extension_custom_rules.required_files['images']
expected_images = {'img/example.png'}
self.assertSetEqual(expected_images, images)
def test_doc_example_override_html(self):
'''Basic example showing how to override the html-template.'''
test_string = self.read_test_file(self.processor_name,
'doc_example_override_html.md')
processor = ImageInlinePattern(self.ext, self.md.parser)
self.assertIsNotNone(re.search(processor.compiled_re, test_string))
html_template = self.read_test_file(
self.processor_name,
'doc_example_override_html_template.html',
strip=True)
verto_extension = VertoExtension(
[self.processor_name],
html_templates={self.processor_name: html_template})
converted_test_string = markdown.markdown(test_string,
extensions=[verto_extension])
expected_string = self.read_test_file(
self.processor_name,
'doc_example_override_html_expected.html',
strip=True).strip()
self.assertEqual(expected_string, converted_test_string)
images = verto_extension.required_files['images']
expected_images = set()
self.assertSetEqual(expected_images, images)
def test_image_width_value_no_units(self):
'''Test image rendered correctly with width value with no units.
'''
test_string = self.read_test_file(self.processor_name,
'file_width_value_no_units.md')
processor = ImageInlinePattern(self.ext, self.md.parser)
self.assertIsNotNone(re.search(processor.compiled_re, test_string))
html_template = self.read_test_file(
self.processor_name,
'file_width_value_no_units_html_template.html',
strip=True)
verto_extension = VertoExtension(
[self.processor_name],
html_templates={self.processor_name: html_template})
converted_test_string = markdown.markdown(test_string,
extensions=[verto_extension])
expected_string = self.read_test_file(
self.processor_name,
'file_width_value_no_units_expected.html',
strip=True).strip()
self.assertEqual(expected_string, converted_test_string)
images = verto_extension.required_files['images']
expected_images = {'path/to/[email protected]'}
self.assertSetEqual(expected_images, images)
def test_missing_argument_alt(self):
'''Test that ArgumentMissingError is thrown when alt argument is missing'''
test_string = self.read_test_file(self.processor_name,
'missing_argument_alt.md')
processor = ImageInlinePattern(self.ext, self.md.parser)
self.assertIsNotNone(re.search(processor.compiled_re, test_string))
self.assertRaises(
ArgumentMissingError,
lambda x: markdown.markdown(x, extensions=[self.verto_extension]),
test_string)
def test_custom_arguments_hover_true_not_provided(self):
'''Tests to ensure that correct error is raised when hover text is required and not provided.
'''
custom_argument_rules = {"image-inline": {"hover-text": True}}
verto_extension_custom_rules = VertoExtension(
processors=[self.processor_name],
custom_argument_rules=custom_argument_rules)
test_string = self.read_test_file(self.processor_name,
'hover_true_not_provided.md')
processor = ImageInlinePattern(self.ext, self.md.parser)
self.assertIsNotNone(re.search(processor.compiled_re, test_string))
self.assertRaises(
ArgumentMissingError, lambda x: markdown.markdown(
x, extensions=[verto_extension_custom_rules]), test_string)
def test_numbered_list(self):
'''Test that image-inline functions within a numbered list.'''
test_string = self.read_test_file(self.processor_name,
'numbered_list.md')
processor = ImageInlinePattern(self.ext, self.md.parser)
self.assertIsNotNone(re.search(processor.compiled_re, test_string))
converted_test_string = markdown.markdown(
test_string, extensions=[self.verto_extension])
expected_string = self.read_test_file(self.processor_name,
'numbered_list_expected.html',
strip=True).strip()
self.assertEqual(expected_string, converted_test_string)
images = self.verto_extension.required_files['images']
expected_images = set()
self.assertSetEqual(expected_images, images)
def test_argument_caption(self):
'''Test that the caption argument is correctly rendered.'''
test_string = self.read_test_file(self.processor_name,
'argument_caption.md')
processor = ImageInlinePattern(self.ext, self.md.parser)
self.assertIsNotNone(re.search(processor.compiled_re, test_string))
converted_test_string = markdown.markdown(
test_string, extensions=[self.verto_extension])
expected_string = self.read_test_file(self.processor_name,
'argument_caption_expected.html',
strip=True).strip()
self.assertEqual(expected_string, converted_test_string)
images = self.verto_extension.required_files['images']
expected_images = set()
self.assertSetEqual(expected_images, images)
def test_table_embed(self):
'''Test that image-inline functions within a table.'''
test_string = self.read_test_file(self.processor_name,
'table_embed.md')
processor = ImageInlinePattern(self.ext, self.md.parser)
self.assertIsNotNone(re.search(processor.compiled_re, test_string))
converted_test_string = markdown.markdown(
test_string,
extensions=[self.verto_extension, 'markdown.extensions.tables'])
expected_string = self.read_test_file(self.processor_name,
'table_embed_expected.html',
strip=True).strip()
self.assertEqual(expected_string, converted_test_string)
images = self.verto_extension.required_files['images']
expected_images = {'img/example1.png', 'img/example2.png'}
self.assertSetEqual(expected_images, images)
def test_basic_usage(self):
'''Test common usage case.'''
test_string = self.read_test_file(self.processor_name,
'doc_example_basic_usage.md')
processor = ImageInlinePattern(self.ext, self.md.parser)
self.assertIsNotNone(re.search(processor.compiled_re, test_string))
converted_test_string = markdown.markdown(
test_string, extensions=[self.verto_extension])
expected_string = self.read_test_file(
self.processor_name,
'doc_example_basic_usage_expected.html',
strip=True).strip()
self.assertEqual(expected_string, converted_test_string)
images = self.verto_extension.required_files['images']
expected_images = {'img/example.png'}
self.assertSetEqual(expected_images, images)
def test_image_width_value_external_image(self):
'''Test image rendered correctly with width value.
'''
test_string = self.read_test_file(
self.processor_name, 'file_width_value_external_image.md')
processor = ImageInlinePattern(self.ext, self.md.parser)
self.assertIsNotNone(re.search(processor.compiled_re, test_string))
converted_test_string = markdown.markdown(
test_string, extensions=[self.verto_extension])
expected_string = self.read_test_file(
self.processor_name,
'file_width_value_external_image_expected.html',
strip=True).strip()
self.assertEqual(expected_string, converted_test_string)
images = self.verto_extension.required_files['images']
expected_images = set()
self.assertSetEqual(expected_images, images)
def test_external_image(self):
'''Test that external images are processed and that the
expected images are unchanged.
'''
test_string = self.read_test_file(self.processor_name,
'external_image.md')
processor = ImageInlinePattern(self.ext, self.md.parser)
self.assertIsNotNone(re.search(processor.compiled_re, test_string))
converted_test_string = markdown.markdown(
test_string, extensions=[self.verto_extension])
expected_string = self.read_test_file(self.processor_name,
'external_image_expected.html',
strip=True).strip()
self.assertEqual(expected_string, converted_test_string)
images = self.verto_extension.required_files['images']
expected_images = set()
self.assertSetEqual(expected_images, images)
def test_internal_image(self):
'''Test to ensure that an internally reference image produces
the desired output, including changing the expected images of
the verto extension.
'''
test_string = self.read_test_file(self.processor_name,
'internal_image.md')
processor = ImageInlinePattern(self.ext, self.md.parser)
self.assertIsNotNone(re.search(processor.compiled_re, test_string))
converted_test_string = markdown.markdown(
test_string, extensions=[self.verto_extension])
expected_string = self.read_test_file(self.processor_name,
'internal_image_expected.html',
strip=True).strip()
self.assertEqual(expected_string, converted_test_string)
images = self.verto_extension.required_files['images']
expected_images = {'img/example.png'}
self.assertSetEqual(expected_images, images)
def buildProcessors(self, md, md_globals):
'''
Populates internal variables for processors. This should not be
called externally, this is used by the extendMarkdown method.
Args:
md: An instance of the markdown object being extended.
md_globals: Global variables in the markdown module namespace.
'''
self.preprocessors = [
['comment', CommentPreprocessor(self, md), '_begin'],
['save-title',
SaveTitlePreprocessor(self, md), '_end'],
['remove-title',
RemoveTitlePreprocessor(self, md), '_end'],
]
self.blockprocessors = [
# Markdown overrides
['heading',
HeadingBlockProcessor(self, md.parser), '<hashheader'],
# Single line (in increasing complexity)
[
'interactive-tag',
InteractiveTagBlockProcessor(self, md.parser), '<paragraph'
],
[
'interactive-container',
InteractiveContainerBlockProcessor(self, md.parser),
'<paragraph'
],
[
'image-container',
ImageContainerBlockProcessor(self, md.parser), '<paragraph'
],
[
'image-tag',
ImageTagBlockProcessor(self, md.parser), '<paragraph'
],
['video',
VideoBlockProcessor(self, md.parser), '<paragraph'],
[
'conditional',
ConditionalProcessor(self, md.parser), '<paragraph'
],
['panel',
PanelBlockProcessor(self, md.parser), '<paragraph'],
[
'blockquote',
BlockquoteBlockProcessor(self, md.parser), '<paragraph'
],
# Multiline
]
self.inlinepatterns = [ # A special treeprocessor
['relative-link',
RelativeLinkPattern(self, md), '_begin'],
['glossary-link',
GlossaryLinkPattern(self, md), '_begin'],
['image-inline',
ImageInlinePattern(self, md), '_begin']
]
scratch_ordering = '>inline' if 'hilite' not in self.compatibility else '<hilite'
self.treeprocessors = [
['scratch',
ScratchTreeprocessor(self, md), scratch_ordering],
[
'scratch-inline',
ScratchInlineTreeprocessor(self, md), '>inline'
],
]
self.postprocessors = []
self.buildGenericProcessors(md, md_globals)