class Verto(object):
'''A converter object for converting markdown with complex elements
to HTML.
'''
def __init__(self, processors=DEFAULT_PROCESSORS, html_templates={}, extensions=[], custom_argument_rules={}):
'''Creates a Verto object.
Args:
processors: A set of processor names given as strings for which
their processors are enabled. If given, all other
processors are skipped.
html_templates: A dictionary of HTML templates to override
existing HTML templates for processors. Dictionary contains
processor names given as a string as keys mapping HTML strings
as values.
eg: {'image': '<img src={{ source }}>'}
extensions: A list of extra extensions to run on the
markdown package.
custom_argument_rules: A dictionary of rules for the processors to
override default processor rules.
'''
self.processors = set(processors)
self.html_templates = dict(html_templates)
self.extensions = list(extensions)
self.custom_argument_rules = custom_argument_rules
self.create_converter()
def create_converter(self):
'''Create the Verto extension and converter for future use.'''
self.verto_extension = VertoExtension(
processors=self.processors,
html_templates=self.html_templates,
extensions=self.extensions,
custom_argument_rules=self.custom_argument_rules,
)
all_extensions = self.extensions + [self.verto_extension]
self.converter = markdown.Markdown(extensions=all_extensions)
def convert(self, text):
'''Return a VertoResult object after converting
the given markdown string.
Args:
text: A string of Markdown text to be converted.
Returns:
A VertoResult object.
'''
self.verto_extension.clear_document_data()
html_string = self.converter.convert(text)
result = VertoResult(
html_string=html_string,
title=self.verto_extension.title,
required_files=self.verto_extension.required_files,
heading_tree=self.verto_extension.get_heading_tree(),
required_glossary_terms=self.verto_extension.glossary_terms
)
return result
def clear_saved_data(self):
'''Clears data that is saved between documents. This should be
called between conversions on unrelated documents.
'''
self.verto_extension.clear_saved_data()
def update_templates(self, html_templates):
'''Update the template dictionary with the given dictionary
of templates, while leaving all other HTML templates (including
any custom set templates) untouched. The updated dictionary
will be used for converting from this point onwards.
Args:
html_templates: A dictionary of HTML templates to override
existing HTML templates for processors. Dictionary
contains processor names given as a string as keys
mapping HTML strings as values.
eg: {'image': '<img src={{ source }}>'}
'''
self.html_templates.update(html_templates)
self.create_converter()
def clear_templates(self):
'''Set the template dictionary to it's original values.
'''
self.html_templates = {}
self.create_converter()
@staticmethod
def processor_defaults():
'''Returns a copy of the default processor set.
Returns:
A set of default processor names as strings.
'''
return set(DEFAULT_PROCESSORS)
def update_processors(self, processors=DEFAULT_PROCESSORS):
'''Update the processors used for conversion with the given
set. The updated set will be used for converting from this
point onwards. If parameter is empty, default processors will
be used.
Args:
processors: A set of processor names given as strings for
which their processors are enabled. If given, all other
processors are skipped.
'''
self.processors = set(processors)
self.create_converter()
class ScratchTest(ProcessorTest):
'''Scratch blocks are unique in that they override behaviour in
markdown and behaviour in markdown extensions, while also retaining
compatiability.
'''
def __init__(self, *args, **kwargs):
'''Sets name for loading test assets.
'''
ProcessorTest.__init__(self, *args, **kwargs)
self.processor_name = 'scratch'
def setUp(self):
'''Overrides the generic setup to load the fenced_code
extension by default (as this is the desired usecase).
'''
self.verto_extension = VertoExtension(
[self.processor_name], {}, ['markdown.extensions.fenced_code'])
# ~
# Doc Tests
# ~
def test_doc_example_basic(self):
'''An example of common useage.
'''
test_string = self.read_test_file(self.processor_name,
'doc_example_basic_usage.md')
converted_test_string = markdown.markdown(
test_string,
extensions=[
'markdown.extensions.fenced_code', self.verto_extension
])
expected_string = self.read_test_file(
self.processor_name,
'doc_example_basic_usage_expected.html',
strip=True)
self.assertEqual(expected_string, converted_test_string)
actual_scratch_images = self.verto_extension.required_files[
'scratch_images']
expected_scratch_images = {
ScratchImageMetaData(
hash=
'a0f8fcad796864abfacac8bda6e0719813833fd1fca348700abbd040557c1576',
text=
'when flag clicked\nclear\nforever\npen down\nif <<mouse down?> and <touching [mouse-pointer v]?>> then\nswitch costume to [button v]\nelse\nadd (x position) to [list v]\nend\nmove (foo) steps\nturn ccw (9) degrees'
),
}
self.assertSetEqual(actual_scratch_images, expected_scratch_images)
def test_doc_example_override_html(self):
'''An example showing how to override the html-template.
'''
test_string = self.read_test_file(self.processor_name,
'doc_example_override_html.md')
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},
extensions=['markdown.extensions.fenced_code'])
converted_test_string = markdown.markdown(
test_string,
extensions=['markdown.extensions.fenced_code', verto_extension])
expected_string = self.read_test_file(
self.processor_name,
'doc_example_override_html_expected.html',
strip=True)
self.assertEqual(expected_string, converted_test_string)
actual_scratch_images = verto_extension.required_files[
'scratch_images']
expected_scratch_images = {
ScratchImageMetaData(
hash=
'a3b77ed3c3fa57e43c830e338dc39d292c7def676e0e8f7545972b7da20275da',
text='when flag clicked\nsay [Hi]'),
}
self.assertSetEqual(actual_scratch_images, expected_scratch_images)
#~
# Other Tests
#~
def test_example_standard_markdown_block(self):
'''Tests that even without extensions it behaves as expected.
'''
verto_extension = VertoExtension([self.processor_name], {}, [])
test_string = self.read_test_file(
self.processor_name, 'example_standard_markdown_block.md')
converted_test_string = markdown.markdown(test_string,
extensions=[verto_extension])
expected_string = self.read_test_file(
self.processor_name,
'example_standard_markdown_block_expected.html',
strip=True)
self.assertEqual(expected_string, converted_test_string)
actual_scratch_images = verto_extension.required_files[
'scratch_images']
expected_scratch_images = {
ScratchImageMetaData(
hash=
'a0f8fcad796864abfacac8bda6e0719813833fd1fca348700abbd040557c1576',
text=
'when flag clicked\nclear\nforever\npen down\nif <<mouse down?> and <touching [mouse-pointer v]?>> then\nswitch costume to [button v]\nelse\nadd (x position) to [list v]\nend\nmove (foo) steps\nturn ccw (9) degrees'
),
}
self.assertSetEqual(actual_scratch_images, expected_scratch_images)
def test_example_separate_blocks(self):
'''Tests that code separated by whitespace is still processed.
'''
test_string = self.read_test_file(self.processor_name,
'example_separate_blocks.md')
converted_test_string = markdown.markdown(
test_string,
extensions=[
'markdown.extensions.fenced_code', self.verto_extension
])
expected_string = self.read_test_file(
self.processor_name,
'example_separate_blocks_expected.html',
strip=True)
self.assertEqual(expected_string, converted_test_string)
actual_scratch_images = self.verto_extension.required_files[
'scratch_images']
expected_scratch_images = {
ScratchImageMetaData(
hash=
'8e8a2129c3cecf32101248439961735fc1d45793fadc56e2575673f63d42b9fb',
text=
'when flag clicked\nclear\nforever\npen down\n\nif <<mouse down?> and <touching [mouse-pointer v]?>> then\nswitch costume to [button v]\nelse\nadd (x position) to [list v]\nend\n\nmove (foo) steps\nturn ccw (9) degrees'
),
}
self.assertSetEqual(actual_scratch_images, expected_scratch_images)
def test_example_multiple_codeblocks(self):
'''Tests that multiple codeblocks are processed independently.
'''
test_string = self.read_test_file(self.processor_name,
'example_multiple_codeblocks.md')
converted_test_string = markdown.markdown(
test_string,
extensions=[
'markdown.extensions.fenced_code', self.verto_extension
])
expected_string = self.read_test_file(
self.processor_name,
'example_multiple_codeblocks_expected.html',
strip=True)
self.assertEqual(expected_string, converted_test_string)
actual_scratch_images = self.verto_extension.required_files[
'scratch_images']
expected_scratch_images = {
ScratchImageMetaData(
hash=
'a3b77ed3c3fa57e43c830e338dc39d292c7def676e0e8f7545972b7da20275da',
text='when flag clicked\nsay [Hi]'),
ScratchImageMetaData(
hash=
'cd6d9a0d464bb8f5eec1e6fc9a4e33378a64ebfce7c6198794ead614962f38e5',
text=
'when flag clicked\nsay [Hi]\nmove (foo) steps\nturn ccw (9) degrees'
),
ScratchImageMetaData(
hash=
'8e8a2129c3cecf32101248439961735fc1d45793fadc56e2575673f63d42b9fb',
text=
'when flag clicked\nclear\nforever\npen down\n\nif <<mouse down?> and <touching [mouse-pointer v]?>> then\nswitch costume to [button v]\nelse\nadd (x position) to [list v]\nend\n\nmove (foo) steps\nturn ccw (9) degrees'
),
}
self.assertSetEqual(actual_scratch_images, expected_scratch_images)
def test_example_multiple_codeblocks_2(self):
'''Tests that enabling the codehilite extension does not effect
the functionality. (Loads the compatiability processor).
'''
extensions = [
'markdown.extensions.codehilite', 'markdown.extensions.fenced_code'
]
verto_extension = VertoExtension([self.processor_name], {}, extensions)
test_string = self.read_test_file(self.processor_name,
'example_multiple_codeblocks_2.md')
converted_test_string = markdown.markdown(test_string,
extensions=extensions +
[verto_extension])
expected_string = self.read_test_file(
self.processor_name,
'example_multiple_codeblocks_expected_2.html',
strip=True)
self.assertEqual(expected_string, converted_test_string)
actual_scratch_images = verto_extension.required_files[
'scratch_images']
expected_scratch_images = {
ScratchImageMetaData(
hash=
'a3b77ed3c3fa57e43c830e338dc39d292c7def676e0e8f7545972b7da20275da',
text='when flag clicked\nsay [Hi]'),
ScratchImageMetaData(
hash=
'cd6d9a0d464bb8f5eec1e6fc9a4e33378a64ebfce7c6198794ead614962f38e5',
text=
'when flag clicked\nsay [Hi]\nmove (foo) steps\nturn ccw (9) degrees'
),
ScratchImageMetaData(
hash=
'8e8a2129c3cecf32101248439961735fc1d45793fadc56e2575673f63d42b9fb',
text=
'when flag clicked\nclear\nforever\npen down\n\nif <<mouse down?> and <touching [mouse-pointer v]?>> then\nswitch costume to [button v]\nelse\nadd (x position) to [list v]\nend\n\nmove (foo) steps\nturn ccw (9) degrees'
),
}
self.assertSetEqual(actual_scratch_images, expected_scratch_images)
def test_example_split_codeblocks(self):
'''Tests that scratch images are split if the split option is
given on the language.
'''
test_string = self.read_test_file(self.processor_name,
'example_split_codeblocks.md')
converted_test_string = markdown.markdown(
test_string,
extensions=[
'markdown.extensions.fenced_code', self.verto_extension
])
expected_string = self.read_test_file(
self.processor_name,
'example_split_codeblocks_expected.html',
strip=True)
self.assertEqual(expected_string, converted_test_string)
actual_scratch_images = self.verto_extension.required_files[
'scratch_images']
expected_scratch_images = {
ScratchImageMetaData(
hash=
'a3b77ed3c3fa57e43c830e338dc39d292c7def676e0e8f7545972b7da20275da',
text='when flag clicked\nsay [Hi]'),
ScratchImageMetaData(
hash=
'cd6d9a0d464bb8f5eec1e6fc9a4e33378a64ebfce7c6198794ead614962f38e5',
text=
'when flag clicked\nsay [Hi]\nmove (foo) steps\nturn ccw (9) degrees'
),
ScratchImageMetaData(
hash=
'a0f8fcad796864abfacac8bda6e0719813833fd1fca348700abbd040557c1576',
text=
'when flag clicked\nclear\nforever\npen down\nif <<mouse down?> and <touching [mouse-pointer v]?>> then\nswitch costume to [button v]\nelse\nadd (x position) to [list v]\nend\nmove (foo) steps\nturn ccw (9) degrees'
),
}
self.assertSetEqual(actual_scratch_images, expected_scratch_images)
def test_example_split_codeblocks_default(self):
'''Tests that scratch images are split if the split option is
given on the language.
'''
verto_extension = VertoExtension([self.processor_name], {}, [])
test_string = self.read_test_file(
self.processor_name, 'example_split_codeblocks_default.md')
converted_test_string = markdown.markdown(test_string,
extensions=[verto_extension])
expected_string = self.read_test_file(
self.processor_name,
'example_split_codeblocks_expected.html',
strip=True)
self.assertEqual(expected_string, converted_test_string)
actual_scratch_images = verto_extension.required_files[
'scratch_images']
expected_scratch_images = {
ScratchImageMetaData(
hash=
'a3b77ed3c3fa57e43c830e338dc39d292c7def676e0e8f7545972b7da20275da',
text='when flag clicked\nsay [Hi]'),
ScratchImageMetaData(
hash=
'cd6d9a0d464bb8f5eec1e6fc9a4e33378a64ebfce7c6198794ead614962f38e5',
text=
'when flag clicked\nsay [Hi]\nmove (foo) steps\nturn ccw (9) degrees'
),
ScratchImageMetaData(
hash=
'a0f8fcad796864abfacac8bda6e0719813833fd1fca348700abbd040557c1576',
text=
'when flag clicked\nclear\nforever\npen down\nif <<mouse down?> and <touching [mouse-pointer v]?>> then\nswitch costume to [button v]\nelse\nadd (x position) to [list v]\nend\nmove (foo) steps\nturn ccw (9) degrees'
),
}
self.assertSetEqual(actual_scratch_images, expected_scratch_images)
def test_example_split_codeblocks_compatibility(self):
'''Tests that options are compatible with codehilite.
'''
extensions = [
'markdown.extensions.codehilite', 'markdown.extensions.fenced_code'
]
verto_extension = VertoExtension([self.processor_name], {}, extensions)
test_string = self.read_test_file(self.processor_name,
'example_split_codeblocks.md')
converted_test_string = markdown.markdown(test_string,
extensions=extensions +
[verto_extension])
expected_string = self.read_test_file(
self.processor_name,
'example_split_codeblocks_expected.html',
strip=True)
self.assertEqual(expected_string, converted_test_string)
actual_scratch_images = verto_extension.required_files[
'scratch_images']
expected_scratch_images = {
ScratchImageMetaData(
hash=
'a3b77ed3c3fa57e43c830e338dc39d292c7def676e0e8f7545972b7da20275da',
text='when flag clicked\nsay [Hi]'),
ScratchImageMetaData(
hash=
'cd6d9a0d464bb8f5eec1e6fc9a4e33378a64ebfce7c6198794ead614962f38e5',
text=
'when flag clicked\nsay [Hi]\nmove (foo) steps\nturn ccw (9) degrees'
),
ScratchImageMetaData(
hash=
'a0f8fcad796864abfacac8bda6e0719813833fd1fca348700abbd040557c1576',
text=
'when flag clicked\nclear\nforever\npen down\nif <<mouse down?> and <touching [mouse-pointer v]?>> then\nswitch costume to [button v]\nelse\nadd (x position) to [list v]\nend\nmove (foo) steps\nturn ccw (9) degrees'
),
}
self.assertSetEqual(actual_scratch_images, expected_scratch_images)
def test_example_random_codeblocks(self):
'''Tests that scratch images are arranged randomly given
the random option is given.
'''
test_string = self.read_test_file(self.processor_name,
'example_random_codeblocks.md')
outputs = set()
for i in range(6): #P(Outputs the Same) < 0.99 [3 Blocks]
converted_test_string = markdown.markdown(
test_string,
extensions=[
'markdown.extensions.fenced_code', self.verto_extension
])
outputs.add(converted_test_string)
self.assertEqual(
len(self.verto_extension.required_files['scratch_images']), 1)
self.verto_extension.clear_saved_data()
self.assertFalse(len(outputs) == 1)
def test_example_random_split_codeblocks(self):
'''Tests that scratch images are arranged randomly given
the random and split option is given.
'''
test_string = self.read_test_file(
self.processor_name, 'example_random_split_codeblocks.md')
outputs = set()
for i in range(6): #P(Outputs the Same) < 0.99 [3 Blocks]
converted_test_string = markdown.markdown(
test_string,
extensions=[
'markdown.extensions.fenced_code', self.verto_extension
])
outputs.add(converted_test_string)
self.assertEqual(
len(self.verto_extension.required_files['scratch_images']), 3)
self.verto_extension.clear_saved_data()
self.assertFalse(len(outputs) == 1)
def test_example_other_code(self):
'''Tests that other codeblocks that are not scratch codeblocks
are not erroneously matched.
'''
test_string = self.read_test_file(self.processor_name,
'example_other_code.md')
converted_test_string = markdown.markdown(
test_string,
extensions=[
'markdown.extensions.fenced_code', self.verto_extension
])
expected_string = self.read_test_file(
self.processor_name,
'example_other_code_expected.html',
strip=True)
self.assertEqual(expected_string, converted_test_string)
actual_scratch_images = self.verto_extension.required_files[
'scratch_images']
expected_scratch_images = {
ScratchImageMetaData(
hash=
'a0f8fcad796864abfacac8bda6e0719813833fd1fca348700abbd040557c1576',
text=
'when flag clicked\nclear\nforever\npen down\nif <<mouse down?> and <touching [mouse-pointer v]?>> then\nswitch costume to [button v]\nelse\nadd (x position) to [list v]\nend\nmove (foo) steps\nturn ccw (9) degrees'
),
}
self.assertSetEqual(actual_scratch_images, expected_scratch_images)
class Verto(object):
'''A converter object for converting markdown with complex elements
to HTML.
'''
def __init__(self,
processors=DEFAULT_PROCESSORS,
html_templates={},
extensions=[],
custom_argument_rules={}):
'''Creates a Verto object.
Args:
processors: A set of processor names given as strings for which
their processors are enabled. If given, all other
processors are skipped.
html_templates: A dictionary of HTML templates to override
existing HTML templates for processors. Dictionary contains
processor names given as a string as keys mapping HTML strings
as values.
eg: {'image': '<img src={{ source }}>'}
extensions: A list of extra extensions to run on the
markdown package.
custom_argument_rules: A dictionary of rules for the processors to
override default processor rules.
'''
self.processors = set(processors)
self.html_templates = dict(html_templates)
self.extensions = list(extensions)
self.custom_argument_rules = custom_argument_rules
self.create_converter()
def create_converter(self):
'''Create the Verto extension and converter for future use.'''
self.verto_extension = VertoExtension(
processors=self.processors,
html_templates=self.html_templates,
extensions=self.extensions,
custom_argument_rules=self.custom_argument_rules,
)
all_extensions = self.extensions + [self.verto_extension]
self.converter = markdown.Markdown(extensions=all_extensions)
def convert(self, text):
'''Return a VertoResult object after converting
the given markdown string.
Args:
text: A string of Markdown text to be converted.
Returns:
A VertoResult object.
'''
self.verto_extension.clear_document_data()
html_string = self.converter.convert(text)
result = VertoResult(
html_string=html_string,
title=self.verto_extension.title,
required_files=self.verto_extension.required_files,
heading_tree=self.verto_extension.get_heading_tree(),
required_glossary_terms=self.verto_extension.glossary_terms)
return result
def clear_saved_data(self):
'''Clears data that is saved between documents. This should be
called between conversions on unrelated documents.
'''
self.verto_extension.clear_saved_data()
def update_templates(self, html_templates):
'''Update the template dictionary with the given dictionary
of templates, while leaving all other HTML templates (including
any custom set templates) untouched. The updated dictionary
will be used for converting from this point onwards.
Args:
html_templates: A dictionary of HTML templates to override
existing HTML templates for processors. Dictionary
contains processor names given as a string as keys
mapping HTML strings as values.
eg: {'image': '<img src={{ source }}>'}
'''
self.html_templates.update(html_templates)
self.create_converter()
def clear_templates(self):
'''Set the template dictionary to it's original values.
'''
self.html_templates = {}
self.create_converter()
@staticmethod
def processor_defaults():
'''Returns a copy of the default processor set.
Returns:
A set of default processor names as strings.
'''
return set(DEFAULT_PROCESSORS)
def update_processors(self, processors=DEFAULT_PROCESSORS):
'''Update the processors used for conversion with the given
set. The updated set will be used for converting from this
point onwards. If parameter is empty, default processors will
be used.
Args:
processors: A set of processor names given as strings for
which their processors are enabled. If given, all other
processors are skipped.
'''
self.processors = set(processors)
self.create_converter()
class ScratchTest(ProcessorTest):
'''Scratch blocks are unique in that they override behaviour in
markdown and behaviour in markdown extensions, while also retaining
compatiability.
'''
def __init__(self, *args, **kwargs):
'''Sets name for loading test assets.
'''
ProcessorTest.__init__(self, *args, **kwargs)
self.processor_name = 'scratch'
def setUp(self):
'''Overrides the generic setup to load the fenced_code
extension by default (as this is the desired usecase).
'''
self.verto_extension = VertoExtension([self.processor_name], {}, ['markdown.extensions.fenced_code'])
# ~
# Doc Tests
# ~
def test_doc_example_basic(self):
'''An example of common useage.
'''
test_string = self.read_test_file(self.processor_name, 'doc_example_basic_usage.md')
converted_test_string = markdown.markdown(test_string, extensions=['markdown.extensions.fenced_code', self.verto_extension])
expected_string = self.read_test_file(self.processor_name, 'doc_example_basic_usage_expected.html', strip=True)
self.assertEqual(expected_string, converted_test_string)
actual_scratch_images = self.verto_extension.required_files['scratch_images']
expected_scratch_images = {
ScratchImageMetaData(
hash='a0f8fcad796864abfacac8bda6e0719813833fd1fca348700abbd040557c1576',
text='when flag clicked\nclear\nforever\npen down\nif <<mouse down?> and <touching [mouse-pointer v]?>> then\nswitch costume to [button v]\nelse\nadd (x position) to [list v]\nend\nmove (foo) steps\nturn ccw (9) degrees'
),
}
self.assertSetEqual(actual_scratch_images, expected_scratch_images)
def test_doc_example_override_html(self):
'''An example showing how to override the html-template.
'''
test_string = self.read_test_file(self.processor_name, 'doc_example_override_html.md')
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}, extensions=['markdown.extensions.fenced_code'])
converted_test_string = markdown.markdown(test_string, extensions=['markdown.extensions.fenced_code', verto_extension])
expected_string = self.read_test_file(self.processor_name, 'doc_example_override_html_expected.html', strip=True)
self.assertEqual(expected_string, converted_test_string)
actual_scratch_images = verto_extension.required_files['scratch_images']
expected_scratch_images = {
ScratchImageMetaData(
hash='a3b77ed3c3fa57e43c830e338dc39d292c7def676e0e8f7545972b7da20275da',
text='when flag clicked\nsay [Hi]'
),
}
self.assertSetEqual(actual_scratch_images, expected_scratch_images)
#~
# Other Tests
#~
def test_example_standard_markdown_block(self):
'''Tests that even without extensions it behaves as expected.
'''
verto_extension = VertoExtension([self.processor_name], {}, [])
test_string = self.read_test_file(self.processor_name, 'example_standard_markdown_block.md')
converted_test_string = markdown.markdown(test_string, extensions=[verto_extension])
expected_string = self.read_test_file(self.processor_name, 'example_standard_markdown_block_expected.html', strip=True)
self.assertEqual(expected_string, converted_test_string)
actual_scratch_images = verto_extension.required_files['scratch_images']
expected_scratch_images = {
ScratchImageMetaData(
hash='a0f8fcad796864abfacac8bda6e0719813833fd1fca348700abbd040557c1576',
text='when flag clicked\nclear\nforever\npen down\nif <<mouse down?> and <touching [mouse-pointer v]?>> then\nswitch costume to [button v]\nelse\nadd (x position) to [list v]\nend\nmove (foo) steps\nturn ccw (9) degrees'
),
}
self.assertSetEqual(actual_scratch_images, expected_scratch_images)
def test_example_separate_blocks(self):
'''Tests that code separated by whitespace is still processed.
'''
test_string = self.read_test_file(self.processor_name, 'example_separate_blocks.md')
converted_test_string = markdown.markdown(test_string, extensions=['markdown.extensions.fenced_code', self.verto_extension])
expected_string = self.read_test_file(self.processor_name, 'example_separate_blocks_expected.html', strip=True)
self.assertEqual(expected_string, converted_test_string)
actual_scratch_images = self.verto_extension.required_files['scratch_images']
expected_scratch_images = {
ScratchImageMetaData(
hash='8e8a2129c3cecf32101248439961735fc1d45793fadc56e2575673f63d42b9fb',
text='when flag clicked\nclear\nforever\npen down\n\nif <<mouse down?> and <touching [mouse-pointer v]?>> then\nswitch costume to [button v]\nelse\nadd (x position) to [list v]\nend\n\nmove (foo) steps\nturn ccw (9) degrees'
),
}
self.assertSetEqual(actual_scratch_images, expected_scratch_images)
def test_example_multiple_codeblocks(self):
'''Tests that multiple codeblocks are processed independently.
'''
test_string = self.read_test_file(self.processor_name, 'example_multiple_codeblocks.md')
converted_test_string = markdown.markdown(test_string, extensions=['markdown.extensions.fenced_code', self.verto_extension])
expected_string = self.read_test_file(self.processor_name, 'example_multiple_codeblocks_expected.html', strip=True)
self.assertEqual(expected_string, converted_test_string)
actual_scratch_images = self.verto_extension.required_files['scratch_images']
expected_scratch_images = {
ScratchImageMetaData(
hash='a3b77ed3c3fa57e43c830e338dc39d292c7def676e0e8f7545972b7da20275da',
text='when flag clicked\nsay [Hi]'
),
ScratchImageMetaData(
hash='cd6d9a0d464bb8f5eec1e6fc9a4e33378a64ebfce7c6198794ead614962f38e5',
text='when flag clicked\nsay [Hi]\nmove (foo) steps\nturn ccw (9) degrees'
),
ScratchImageMetaData(
hash='8e8a2129c3cecf32101248439961735fc1d45793fadc56e2575673f63d42b9fb',
text='when flag clicked\nclear\nforever\npen down\n\nif <<mouse down?> and <touching [mouse-pointer v]?>> then\nswitch costume to [button v]\nelse\nadd (x position) to [list v]\nend\n\nmove (foo) steps\nturn ccw (9) degrees'
),
}
self.assertSetEqual(actual_scratch_images, expected_scratch_images)
def test_example_multiple_codeblocks_2(self):
'''Tests that enabling the codehilite extension does not effect
the functionality. (Loads the compatiability processor).
'''
extensions = ['markdown.extensions.codehilite', 'markdown.extensions.fenced_code']
verto_extension = VertoExtension([self.processor_name], {}, extensions)
test_string = self.read_test_file(self.processor_name, 'example_multiple_codeblocks_2.md')
converted_test_string = markdown.markdown(test_string, extensions=extensions + [verto_extension])
expected_string = self.read_test_file(self.processor_name, 'example_multiple_codeblocks_expected_2.html', strip=True)
self.assertEqual(expected_string, converted_test_string)
actual_scratch_images = verto_extension.required_files['scratch_images']
expected_scratch_images = {
ScratchImageMetaData(
hash='a3b77ed3c3fa57e43c830e338dc39d292c7def676e0e8f7545972b7da20275da',
text='when flag clicked\nsay [Hi]'
),
ScratchImageMetaData(
hash='cd6d9a0d464bb8f5eec1e6fc9a4e33378a64ebfce7c6198794ead614962f38e5',
text='when flag clicked\nsay [Hi]\nmove (foo) steps\nturn ccw (9) degrees'
),
ScratchImageMetaData(
hash='8e8a2129c3cecf32101248439961735fc1d45793fadc56e2575673f63d42b9fb',
text='when flag clicked\nclear\nforever\npen down\n\nif <<mouse down?> and <touching [mouse-pointer v]?>> then\nswitch costume to [button v]\nelse\nadd (x position) to [list v]\nend\n\nmove (foo) steps\nturn ccw (9) degrees'
),
}
self.assertSetEqual(actual_scratch_images, expected_scratch_images)
def test_example_split_codeblocks(self):
'''Tests that scratch images are split if the split option is
given on the language.
'''
test_string = self.read_test_file(self.processor_name, 'example_split_codeblocks.md')
converted_test_string = markdown.markdown(test_string, extensions=['markdown.extensions.fenced_code', self.verto_extension])
expected_string = self.read_test_file(self.processor_name, 'example_split_codeblocks_expected.html', strip=True)
self.assertEqual(expected_string, converted_test_string)
actual_scratch_images = self.verto_extension.required_files['scratch_images']
expected_scratch_images = {
ScratchImageMetaData(
hash='a3b77ed3c3fa57e43c830e338dc39d292c7def676e0e8f7545972b7da20275da',
text='when flag clicked\nsay [Hi]'
),
ScratchImageMetaData(
hash='cd6d9a0d464bb8f5eec1e6fc9a4e33378a64ebfce7c6198794ead614962f38e5',
text='when flag clicked\nsay [Hi]\nmove (foo) steps\nturn ccw (9) degrees'
),
ScratchImageMetaData(
hash='a0f8fcad796864abfacac8bda6e0719813833fd1fca348700abbd040557c1576',
text='when flag clicked\nclear\nforever\npen down\nif <<mouse down?> and <touching [mouse-pointer v]?>> then\nswitch costume to [button v]\nelse\nadd (x position) to [list v]\nend\nmove (foo) steps\nturn ccw (9) degrees'
),
}
self.assertSetEqual(actual_scratch_images, expected_scratch_images)
def test_example_split_codeblocks_default(self):
'''Tests that scratch images are split if the split option is
given on the language.
'''
verto_extension = VertoExtension([self.processor_name], {}, [])
test_string = self.read_test_file(self.processor_name, 'example_split_codeblocks_default.md')
converted_test_string = markdown.markdown(test_string, extensions=[verto_extension])
expected_string = self.read_test_file(self.processor_name, 'example_split_codeblocks_expected.html', strip=True)
self.assertEqual(expected_string, converted_test_string)
actual_scratch_images = verto_extension.required_files['scratch_images']
expected_scratch_images = {
ScratchImageMetaData(
hash='a3b77ed3c3fa57e43c830e338dc39d292c7def676e0e8f7545972b7da20275da',
text='when flag clicked\nsay [Hi]'
),
ScratchImageMetaData(
hash='cd6d9a0d464bb8f5eec1e6fc9a4e33378a64ebfce7c6198794ead614962f38e5',
text='when flag clicked\nsay [Hi]\nmove (foo) steps\nturn ccw (9) degrees'
),
ScratchImageMetaData(
hash='a0f8fcad796864abfacac8bda6e0719813833fd1fca348700abbd040557c1576',
text='when flag clicked\nclear\nforever\npen down\nif <<mouse down?> and <touching [mouse-pointer v]?>> then\nswitch costume to [button v]\nelse\nadd (x position) to [list v]\nend\nmove (foo) steps\nturn ccw (9) degrees'
),
}
self.assertSetEqual(actual_scratch_images, expected_scratch_images)
def test_example_split_codeblocks_compatibility(self):
'''Tests that options are compatible with codehilite.
'''
extensions = ['markdown.extensions.codehilite', 'markdown.extensions.fenced_code']
verto_extension = VertoExtension([self.processor_name], {}, extensions)
test_string = self.read_test_file(self.processor_name, 'example_split_codeblocks.md')
converted_test_string = markdown.markdown(test_string, extensions=extensions + [verto_extension])
expected_string = self.read_test_file(self.processor_name, 'example_split_codeblocks_expected.html', strip=True)
self.assertEqual(expected_string, converted_test_string)
actual_scratch_images = verto_extension.required_files['scratch_images']
expected_scratch_images = {
ScratchImageMetaData(
hash='a3b77ed3c3fa57e43c830e338dc39d292c7def676e0e8f7545972b7da20275da',
text='when flag clicked\nsay [Hi]'
),
ScratchImageMetaData(
hash='cd6d9a0d464bb8f5eec1e6fc9a4e33378a64ebfce7c6198794ead614962f38e5',
text='when flag clicked\nsay [Hi]\nmove (foo) steps\nturn ccw (9) degrees'
),
ScratchImageMetaData(
hash='a0f8fcad796864abfacac8bda6e0719813833fd1fca348700abbd040557c1576',
text='when flag clicked\nclear\nforever\npen down\nif <<mouse down?> and <touching [mouse-pointer v]?>> then\nswitch costume to [button v]\nelse\nadd (x position) to [list v]\nend\nmove (foo) steps\nturn ccw (9) degrees'
),
}
self.assertSetEqual(actual_scratch_images, expected_scratch_images)
def test_example_random_codeblocks(self):
'''Tests that scratch images are arranged randomly given
the random option is given.
'''
test_string = self.read_test_file(self.processor_name, 'example_random_codeblocks.md')
outputs = set()
for i in range(6): #P(Outputs the Same) < 0.99 [3 Blocks]
converted_test_string = markdown.markdown(test_string, extensions=['markdown.extensions.fenced_code', self.verto_extension])
outputs.add(converted_test_string)
self.assertEqual(len(self.verto_extension.required_files['scratch_images']), 1)
self.verto_extension.clear_saved_data()
self.assertFalse(len(outputs) == 1)
def test_example_random_split_codeblocks(self):
'''Tests that scratch images are arranged randomly given
the random and split option is given.
'''
test_string = self.read_test_file(self.processor_name, 'example_random_split_codeblocks.md')
outputs = set()
for i in range(6): #P(Outputs the Same) < 0.99 [3 Blocks]
converted_test_string = markdown.markdown(test_string, extensions=['markdown.extensions.fenced_code', self.verto_extension])
outputs.add(converted_test_string)
self.assertEqual(len(self.verto_extension.required_files['scratch_images']), 3)
self.verto_extension.clear_saved_data()
self.assertFalse(len(outputs) == 1)
def test_example_other_code(self):
'''Tests that other codeblocks that are not scratch codeblocks
are not erroneously matched.
'''
test_string = self.read_test_file(self.processor_name, 'example_other_code.md')
converted_test_string = markdown.markdown(test_string, extensions=['markdown.extensions.fenced_code', self.verto_extension])
expected_string = self.read_test_file(self.processor_name, 'example_other_code_expected.html', strip=True)
self.assertEqual(expected_string, converted_test_string)
actual_scratch_images = self.verto_extension.required_files['scratch_images']
expected_scratch_images = {
ScratchImageMetaData(
hash='a0f8fcad796864abfacac8bda6e0719813833fd1fca348700abbd040557c1576',
text='when flag clicked\nclear\nforever\npen down\nif <<mouse down?> and <touching [mouse-pointer v]?>> then\nswitch costume to [button v]\nelse\nadd (x position) to [list v]\nend\nmove (foo) steps\nturn ccw (9) degrees'
),
}
self.assertSetEqual(actual_scratch_images, expected_scratch_images)