textutils_tests.py
No OneTemporary
Actions

Subscribers

None

File Metadata

Created: Fri, Nov 29, 00:46

textutils_tests.py
View Options

	# -- coding: utf-8 --
	##
	## This file is part of Invenio.
	## Copyright (C) 2008, 2009, 2010, 2011 CERN.
	##
	## Invenio is free software; you can redistribute it and/or
	## modify it under the terms of the GNU General Public License as
	## published by the Free Software Foundation; either version 2 of the
	## License, or (at your option) any later version.
	##
	## Invenio is distributed in the hope that it will be useful, but
	## WITHOUT ANY WARRANTY; without even the implied warranty of
	## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	## General Public License for more details.
	##
	## You should have received a copy of the GNU General Public License
	## along with Invenio; if not, write to the Free Software Foundation, Inc.,
	## 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.

	"""Unit tests for the textutils library."""

	__revision__ = "$Id$"

	import unittest

	try:
	import chardet
	CHARDET_AVAILABLE = True
	except ImportError:
	CHARDET_AVAILABLE = False

	try:
	from unidecode import unidecode
	UNIDECODE_AVAILABLE = True
	except ImportError:
	UNIDECODE_AVAILABLE = False

	from invenio.textutils import \
	wrap_text_in_a_box, \
	guess_minimum_encoding, \
	wash_for_xml, \
	wash_for_utf8, \
	decode_to_unicode, \
	translate_latex2unicode, \
	translate_to_ascii, \
	strip_accents

	from invenio.testutils import make_test_suite, run_test_suite

	class GuessMinimumEncodingTest(unittest.TestCase):
	"""Test functions related to guess_minimum_encoding function."""
	def test_guess_minimum_encoding(self):
	"""textutils - guess_minimum_encoding."""
	self.assertEqual(guess_minimum_encoding('patata'), ('patata', 'ascii'))
	self.assertEqual(guess_minimum_encoding('àèéìòù'), ('\xe0\xe8\xe9\xec\xf2\xf9', 'latin1'))
	self.assertEqual(guess_minimum_encoding('Ιθάκη'), ('Ιθάκη', 'utf8'))

	class WashForXMLTest(unittest.TestCase):
	"""Test functions related to wash_for_xml function."""

	def test_latin_characters_washing_1_0(self):
	"""textutils - washing latin characters for XML 1.0."""
	self.assertEqual(wash_for_xml('àèéìòùÀ'), 'àèéìòùÀ')

	def test_latin_characters_washing_1_1(self):
	"""textutils - washing latin characters for XML 1.1."""
	self.assertEqual(wash_for_xml('àèéìòùÀ', xml_version='1.1'), 'àèéìòùÀ')

	def test_chinese_characters_washing_1_0(self):
	"""textutils - washing chinese characters for XML 1.0."""
	self.assertEqual(wash_for_xml('''
	春眠暁を覚えず
	処処に啼鳥と聞く
	夜来風雨の声
	花落つること
	知んぬ多少ぞ'''), '''
	春眠暁を覚えず
	処処に啼鳥と聞く
	夜来風雨の声
	花落つること
	知んぬ多少ぞ''')

	def test_chinese_characters_washing_1_1(self):
	"""textutils - washing chinese characters for XML 1.1."""
	self.assertEqual(wash_for_xml('''
	春眠暁を覚えず
	処処に啼鳥と聞く
	夜来風雨の声
	花落つること
	知んぬ多少ぞ''', xml_version='1.1'), '''
	春眠暁を覚えず
	処処に啼鳥と聞く
	夜来風雨の声
	花落つること
	知んぬ多少ぞ''')

	def test_greek_characters_washing_1_0(self):
	"""textutils - washing greek characters for XML 1.0."""
	self.assertEqual(wash_for_xml('''
	ἄνδρα μοι ἔννεπε, μου̂σα, πολύτροπον, ὃς μάλα πολλὰ
	πλάγχθη, ἐπεὶ Τροίης ἱερὸν πτολίεθρον ἔπερσεν:
	πολλω̂ν δ' ἀνθρώπων ἴδεν ἄστεα καὶ νόον ἔγνω,
	πολλὰ δ' ὅ γ' ἐν πόντῳ πάθεν ἄλγεα ὃν κατὰ θυμόν,
	ἀρνύμενος ἥν τε ψυχὴν καὶ νόστον ἑταίρων.
	ἀλλ' οὐδ' ὣς ἑτάρους ἐρρύσατο, ἱέμενός περ:
	αὐτω̂ν γὰρ σφετέρῃσιν ἀτασθαλίῃσιν ὄλοντο,
	νήπιοι, οἳ κατὰ βου̂ς ̔Υπερίονος ̓Ηελίοιο
	ἤσθιον: αὐτὰρ ὁ τοι̂σιν ἀφείλετο νόστιμον ἠ̂μαρ.
	τω̂ν ἁμόθεν γε, θεά, θύγατερ Διός, εἰπὲ καὶ ἡμι̂ν.'''), '''
	ἄνδρα μοι ἔννεπε, μου̂σα, πολύτροπον, ὃς μάλα πολλὰ
	πλάγχθη, ἐπεὶ Τροίης ἱερὸν πτολίεθρον ἔπερσεν:
	πολλω̂ν δ' ἀνθρώπων ἴδεν ἄστεα καὶ νόον ἔγνω,
	πολλὰ δ' ὅ γ' ἐν πόντῳ πάθεν ἄλγεα ὃν κατὰ θυμόν,
	ἀρνύμενος ἥν τε ψυχὴν καὶ νόστον ἑταίρων.
	ἀλλ' οὐδ' ὣς ἑτάρους ἐρρύσατο, ἱέμενός περ:
	αὐτω̂ν γὰρ σφετέρῃσιν ἀτασθαλίῃσιν ὄλοντο,
	νήπιοι, οἳ κατὰ βου̂ς ̔Υπερίονος ̓Ηελίοιο
	ἤσθιον: αὐτὰρ ὁ τοι̂σιν ἀφείλετο νόστιμον ἠ̂μαρ.
	τω̂ν ἁμόθεν γε, θεά, θύγατερ Διός, εἰπὲ καὶ ἡμι̂ν.''')

	def test_greek_characters_washing_1_1(self):
	"""textutils - washing greek characters for XML 1.1."""
	self.assertEqual(wash_for_xml('''
	ἄνδρα μοι ἔννεπε, μου̂σα, πολύτροπον, ὃς μάλα πολλὰ
	πλάγχθη, ἐπεὶ Τροίης ἱερὸν πτολίεθρον ἔπερσεν:
	πολλω̂ν δ' ἀνθρώπων ἴδεν ἄστεα καὶ νόον ἔγνω,
	πολλὰ δ' ὅ γ' ἐν πόντῳ πάθεν ἄλγεα ὃν κατὰ θυμόν,
	ἀρνύμενος ἥν τε ψυχὴν καὶ νόστον ἑταίρων.
	ἀλλ' οὐδ' ὣς ἑτάρους ἐρρύσατο, ἱέμενός περ:
	αὐτω̂ν γὰρ σφετέρῃσιν ἀτασθαλίῃσιν ὄλοντο,
	νήπιοι, οἳ κατὰ βου̂ς ̔Υπερίονος ̓Ηελίοιο
	ἤσθιον: αὐτὰρ ὁ τοι̂σιν ἀφείλετο νόστιμον ἠ̂μαρ.
	τω̂ν ἁμόθεν γε, θεά, θύγατερ Διός, εἰπὲ καὶ ἡμι̂ν.''',
	xml_version='1.1'), '''
	ἄνδρα μοι ἔννεπε, μου̂σα, πολύτροπον, ὃς μάλα πολλὰ
	πλάγχθη, ἐπεὶ Τροίης ἱερὸν πτολίεθρον ἔπερσεν:
	πολλω̂ν δ' ἀνθρώπων ἴδεν ἄστεα καὶ νόον ἔγνω,
	πολλὰ δ' ὅ γ' ἐν πόντῳ πάθεν ἄλγεα ὃν κατὰ θυμόν,
	ἀρνύμενος ἥν τε ψυχὴν καὶ νόστον ἑταίρων.
	ἀλλ' οὐδ' ὣς ἑτάρους ἐρρύσατο, ἱέμενός περ:
	αὐτω̂ν γὰρ σφετέρῃσιν ἀτασθαλίῃσιν ὄλοντο,
	νήπιοι, οἳ κατὰ βου̂ς ̔Υπερίονος ̓Ηελίοιο
	ἤσθιον: αὐτὰρ ὁ τοι̂σιν ἀφείλετο νόστιμον ἠ̂μαρ.
	τω̂ν ἁμόθεν γε, θεά, θύγατερ Διός, εἰπὲ καὶ ἡμι̂ν.''')

	def test_russian_characters_washing_1_0(self):
	"""textutils - washing greek characters for XML 1.0."""
	self.assertEqual(wash_for_xml('''
	В тени дерев, над чистыми водами
	Дерновый холм вы видите ль, друзья?
	Чуть слышно там плескает в брег струя;
	Чуть ветерок там дышит меж листами;
	На ветвях лира и венец...
	Увы! друзья, сей холм - могила;
	Здесь прах певца земля сокрыла;
	Бедный певец!''', xml_version='1.1'), '''
	В тени дерев, над чистыми водами
	Дерновый холм вы видите ль, друзья?
	Чуть слышно там плескает в брег струя;
	Чуть ветерок там дышит меж листами;
	На ветвях лира и венец...
	Увы! друзья, сей холм - могила;
	Здесь прах певца земля сокрыла;
	Бедный певец!''')

	def test_russian_characters_washing_1_1(self):
	"""textutils - washing greek characters for XML 1.1."""
	self.assertEqual(wash_for_xml('''
	В тени дерев, над чистыми водами
	Дерновый холм вы видите ль, друзья?
	Чуть слышно там плескает в брег струя;
	Чуть ветерок там дышит меж листами;
	На ветвях лира и венец...
	Увы! друзья, сей холм - могила;
	Здесь прах певца земля сокрыла;
	Бедный певец!''', xml_version='1.1'), '''
	В тени дерев, над чистыми водами
	Дерновый холм вы видите ль, друзья?
	Чуть слышно там плескает в брег струя;
	Чуть ветерок там дышит меж листами;
	На ветвях лира и венец...
	Увы! друзья, сей холм - могила;
	Здесь прах певца земля сокрыла;
	Бедный певец!''')

	def test_illegal_characters_washing_1_0(self):
	"""textutils - washing illegal characters for XML 1.0."""
	self.assertEqual(wash_for_xml(chr(8) + chr(9) + 'some chars'), '\tsome chars')
	self.assertEqual(wash_for_xml('$b\bar{b}$'), '$bar{b}$')

	def test_illegal_characters_washing_1_1(self):
	"""textutils - washing illegal characters for XML 1.1."""
	self.assertEqual(wash_for_xml(chr(8) + chr(9) + 'some chars',
	xml_version='1.1'), '\x08\tsome chars')
	self.assertEqual(wash_for_xml('$b\bar{b}$', xml_version='1.1'), '$b\x08ar{b}$')

	class WashForUTF8Test(unittest.TestCase):
	def test_normal_legal_string_washing(self):
	"""textutils - testing UTF-8 washing on a perfectly normal string"""
	some_str = "This is an example string"
	self.assertEqual(some_str, wash_for_utf8(some_str))

	def test_chinese_string_washing(self):
	"""textutils - testing washing functions on chinese script"""
	some_str = """春眠暁を覚えず
	処処に啼鳥と聞く
	夜来風雨の声
	花落つること
	知んぬ多少ぞ"""
	self.assertEqual(some_str, wash_for_utf8(some_str))

	def test_russian_characters_washing(self):
	"""textutils - washing Russian characters for UTF-8"""
	self.assertEqual(wash_for_utf8('''
	В тени дерев, над чистыми водами
	Дерновый холм вы видите ль, друзья?
	Чуть слышно там плескает в брег струя;
	Чуть ветерок там дышит меж листами;
	На ветвях лира и венец...
	Увы! друзья, сей холм - могила;
	Здесь прах певца земля сокрыла;
	Бедный певец!'''), '''
	В тени дерев, над чистыми водами
	Дерновый холм вы видите ль, друзья?
	Чуть слышно там плескает в брег струя;
	Чуть ветерок там дышит меж листами;
	На ветвях лира и венец...
	Увы! друзья, сей холм - могила;
	Здесь прах певца земля сокрыла;
	Бедный певец!''')

	def test_remove_incorrect_unicode_characters(self):
	"""textutils - washing out the incorrect characters"""
	self.assertEqual(wash_for_utf8("Ź\206dź\204bło żół\203wia \202"), "Źdźbło żółwia ")

	def test_empty_string_wash(self):
	"""textutils - washing an empty string"""
	self.assertEqual(wash_for_utf8(""), "")

	def test_only_incorrect_unicode_wash(self):
	"""textutils - washing an empty string"""
	self.assertEqual(wash_for_utf8("\202\203\204\205"), "")

	def test_raising_exception_on_incorrect(self):
	"""textutils - assuring an exception on incorrect input"""
	self.assertRaises(UnicodeDecodeError, wash_for_utf8, "\202\203\204\205", correct=False)

	def test_already_utf8_input(self):
	"""textutils - washing a Unicode string into UTF-8 binary string"""
	self.assertEqual('Göppert', wash_for_utf8(u'G\xf6ppert', True))

	class WrapTextInABoxTest(unittest.TestCase):
	"""Test functions related to wrap_text_in_a_box function."""

	def test_plain_wrap_text_in_a_box(self):
	"""textutils - wrap_text_in_a_box plain."""
	result = """
	**********************************************
	foo bar
	**********************************************
	"""
	self.assertEqual(wrap_text_in_a_box('foo bar'), result)

	def test_empty_wrap_text_in_a_box(self):
	"""textutils - wrap_text_in_a_box empty."""
	result = """
	**********************************************
	**********************************************
	"""
	self.assertEqual(wrap_text_in_a_box(), result)

	def test_with_title_wrap_text_in_a_box(self):
	"""textutils - wrap_text_in_a_box with title."""
	result = """
	**********************************************
	a Title!
	************************************
	foo bar
	**********************************************
	"""
	self.assertEqual(wrap_text_in_a_box('foo bar', title='a Title!'), result)

	def test_multiline_wrap_text_in_a_box(self):
	"""textutils - wrap_text_in_a_box multiline."""
	result = """
	**********************************************
	foo bar
	**********************************************
	"""
	self.assertEqual(wrap_text_in_a_box('foo\n bar'), result)

	def test_real_multiline_wrap_text_in_a_box(self):
	"""textutils - wrap_text_in_a_box real multiline."""
	result = """
	**********************************************
	foo
	bar
	**********************************************
	"""
	self.assertEqual(wrap_text_in_a_box('foo\n\nbar'), result)

	def test_real_no_width_wrap_text_in_a_box(self):
	"""textutils - wrap_text_in_a_box no width."""
	result = """
	************
	foobar
	************
	"""
	self.assertEqual(wrap_text_in_a_box('foobar', min_col=0), result)

	def test_real_nothing_at_all_wrap_text_in_a_box(self):
	"""textutils - wrap_text_in_a_box nothing at all."""
	result = """
	******
	******
	"""
	self.assertEqual(wrap_text_in_a_box(min_col=0), result)

	def test_real_squared_wrap_text_in_a_box(self):
	"""textutils - wrap_text_in_a_box squared style."""
	result = """
	+--------+
	\| foobar \|
	+--------+
	"""
	self.assertEqual(wrap_text_in_a_box('foobar', style='squared', min_col=0), result)

	def test_indented_text_wrap_text_in_a_box(self):
	"""textutils - wrap_text_in_a_box indented text."""
	text = """
	def test_real_squared_wrap_text_in_a_box(self):\n
	\"""wrap_text_in_a_box - squared style.\"""\n
	result = \"""\n
	+--------+\n
	\| foobar \|\n
	+--------+
	\"""
	"""
	result = """
	******************************
	def test_real_square
	d_wrap_text_in_a_box
	(self):
	\"""wrap_text_in_
	a_box - squared
	style.\"""
	result = \"""
	+--------+
	\| foobar \|
	+--------+\"""
	******************************
	"""
	self.assertEqual(wrap_text_in_a_box(text, min_col=0, max_col=30, break_long=True), result)

	def test_single_new_line_wrap_text_in_a_box(self):
	"""textutils - wrap_text_in_a_box single new line."""
	result = """
	**********************************************
	ciao come và?
	**********************************************
	"""
	self.assertEqual(wrap_text_in_a_box("ciao\ncome và?"), result)


	def test_indented_box_wrap_text_in_a_box(self):
	"""textutils - wrap_text_in_a_box indented box."""
	result = """
	**********************************************
	foobar
	**********************************************
	"""
	self.assertEqual(wrap_text_in_a_box('foobar', tab_num=1), result)

	def test_real_conclusion_wrap_text_in_a_box(self):
	"""textutils - wrap_text_in_a_box conclusion."""
	result = """----------------------------------------
	foobar \n"""
	self.assertEqual(wrap_text_in_a_box('foobar', style='conclusion'), result)

	def test_real_longtext_wrap_text_in_a_box(self):
	"""textutils - wrap_text_in_a_box long text."""
	text = """Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

	At vero eos et accusamus et iusto odio dignissimos ducimus qui blanditiis praesentium voluptatum deleniti atque corrupti quos dolores et quas molestias excepturi sint occaecati cupiditate non provident, similique sunt in culpa qui officia deserunt mollitia animi, id est laborum et dolorum fuga. Et harum quidem rerum facilis est et expedita distinctio. Nam libero tempore, cum soluta nobis est eligendi optio cumque nihil impedit quo minus id quod maxime placeat facere possimus, omnis voluptas assumenda est, omnis dolor repellendus. Temporibus autem quibusdam et aut officiis debitis aut rerum necessitatibus saepe eveniet ut et voluptates repudiandae sint et molestiae non recusandae. Itaque earum rerum hic tenetur a sapiente delectus, ut aut reiciendis voluptatibus maiores alias consequatur aut perferendis doloribus asperiores repellat."""

	result = """
	************************************************************************
	Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do
	eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut
	enim ad minim veniam, quis nostrud exercitation ullamco laboris
	nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in
	reprehenderit in voluptate velit esse cillum dolore eu fugiat
	nulla pariatur. Excepteur sint occaecat cupidatat non proident,
	sunt in culpa qui officia deserunt mollit anim id est laborum.
	At vero eos et accusamus et iusto odio dignissimos ducimus qui
	blanditiis praesentium voluptatum deleniti atque corrupti quos
	dolores et quas molestias excepturi sint occaecati cupiditate non
	provident, similique sunt in culpa qui officia deserunt mollitia
	animi, id est laborum et dolorum fuga. Et harum quidem rerum
	facilis est et expedita distinctio. Nam libero tempore, cum soluta
	nobis est eligendi optio cumque nihil impedit quo minus id quod
	maxime placeat facere possimus, omnis voluptas assumenda est,
	omnis dolor repellendus. Temporibus autem quibusdam et aut
	officiis debitis aut rerum necessitatibus saepe eveniet ut et
	voluptates repudiandae sint et molestiae non recusandae. Itaque
	earum rerum hic tenetur a sapiente delectus, ut aut reiciendis
	voluptatibus maiores alias consequatur aut perferendis doloribus
	asperiores repellat.
	************************************************************************
	"""
	self.assertEqual(wrap_text_in_a_box(text), result)

	class DecodeToUnicodeTest(unittest.TestCase):
	"""Test functions related to decode_to_unicode function."""

	if CHARDET_AVAILABLE:
	def test_decode_to_unicode(self):
	"""textutils - decode_to_unicode."""
	self.assertEqual(decode_to_unicode('\202\203\204\205', failover_encoding='latin1'), u'\x82\x83\x84\x85')
	self.assertEqual(decode_to_unicode('àèéìòù'), u'\xe0\xe8\xe9\xec\xf2\xf9')
	self.assertEqual(decode_to_unicode('Ιθάκη'), u'\u0399\u03b8\u03ac\u03ba\u03b7')

	class Latex2UnicodeTest(unittest.TestCase):
	"""Test functions related to translating LaTeX symbols to Unicode."""

	def test_latex_to_unicode(self):
	"""textutils - latex_to_unicode"""
	self.assertEqual(translate_latex2unicode("\\'a \\'i \\'U").encode('utf-8'), "á í Ú")
	self.assertEqual(translate_latex2unicode("\\'N \\k{i}"), u'\u0143 \u012f')
	self.assertEqual(translate_latex2unicode("\\AAkeson"), u'\u212bkeson')
	self.assertEqual(translate_latex2unicode("$\\mathsl{\\Zeta}$"), u'\U0001d6e7')

	class TranslateToAsciiTest(unittest.TestCase):
	"""Test functions related to transliterating text to ascii."""

	def test_text_to_ascii(self):
	"""textutils - translate_to_ascii"""
	self.assertEqual(translate_to_ascii(["á í Ú", "H\xc3\xb6hne", "Åge Øst Vær", "normal"]), \
	["a i U", "Hohne", "Age Ost Vaer", "normal"])
	self.assertEqual(translate_to_ascii("àèéìòù"), ["aeeiou"])
	self.assertEqual(translate_to_ascii(None), None)
	self.assertEqual(translate_to_ascii([]), [])
	self.assertEqual(translate_to_ascii([None]), [None])

	class TestStripAccents(unittest.TestCase):
	"""Test for handling of UTF-8 accents."""

	def test_strip_accents(self):
	"""textutils - stripping of accented letters"""
	self.assertEqual("memememe",
	strip_accents('mémêmëmè'))
	self.assertEqual("MEMEMEME",
	strip_accents('MÉMÊMËMÈ'))

	TEST_SUITE = make_test_suite(WrapTextInABoxTest, GuessMinimumEncodingTest,
	WashForXMLTest, WashForUTF8Test, DecodeToUnicodeTest,
	Latex2UnicodeTest, TranslateToAsciiTest, TestStripAccents)

	if __name__ == "__main__":
	run_test_suite(TEST_SUITE)

textutils_tests.pyNo OneTemporaryActions

File Metadata

textutils_tests.pyView Options

Event Timeline

textutils_tests.py
No OneTemporary
Actions

textutils_tests.py
View Options