def report_bad_links(fail_if_exist='+', flush_bad_links='+'):
"""
>> report_bad_links [<fail-if-exist> [<flush-bad-links>]]
Report all of the links collected across check_links runs (collected
if and only if the config option check_links.only_collect_bad_links
is set).
If <fail-if-exist> is false (true by default) then the command will
fail after reporting any bad links.
If <flush-bad-links> is false (true by default) then the list of
bad links will be retained across the function call.
"""
global bad_links_dict
from twill import utils
fail_if_exist = utils.make_boolean(fail_if_exist)
flush_bad_links = utils.make_boolean(flush_bad_links)
if not bad_links_dict:
print('No bad links to report.')
else:
print('Could not follow %d links' % len(bad_links_dict))
for page, referers in bad_links_dict.items():
err_msg = "\t link '%s' (occurs on: " % (page,)\
+ ",".join(referers) + ')'
print(err_msg)
if flush_bad_links:
bad_links_dict = {}
if fail_if_exist:
raise TwillAssertionError("broken links encountered")
def report_bad_links(fail_if_exist='+', flush_bad_links='+'):
"""
>> report_bad_links [<fail-if-exist> [<flush-bad-links>]]
Report all of the links collected across check_links runs (collected
if and only if the config option check_links.only_collect_bad_links
is set).
If <fail-if-exist> is false (true by default) then the command will
fail after reporting any bad links.
If <flush-bad-links> is false (true by default) then the list of
bad links will be retained across the function call.
"""
global bad_links_dict
from twill import utils
fail_if_exist = utils.make_boolean(fail_if_exist)
flush_bad_links = utils.make_boolean(flush_bad_links)
from twill import commands
OUT = commands.OUT
if not bad_links_dict:
print('\nNo bad links to report.\n', file=OUT)
else:
print('\nCould not follow %d links' % (len(bad_links_dict),), file=OUT)
for page, referers in list(bad_links_dict.items()):
err_msg = "\t link '%s' (occurs on: " % (page,)\
+ ",".join(referers) + ')'
print(err_msg, file=OUT)
if flush_bad_links:
bad_links_dict = {}
if fail_if_exist:
raise TwillAssertionError("broken links encountered")
def test_twill_exception(self):
utils.make_boolean('no')
