openlp/tests/openlp_plugins/songs/test_ewimport.py

506 lines
26 KiB
Python
Raw Normal View History

2013-08-31 18:17:38 +00:00
# -*- coding: utf-8 -*-
2019-04-13 13:00:22 +00:00
##########################################################################
# OpenLP - Open Source Lyrics Projection #
# ---------------------------------------------------------------------- #
2020-12-30 21:42:49 +00:00
# Copyright (c) 2008-2021 OpenLP Developers #
2019-04-13 13:00:22 +00:00
# ---------------------------------------------------------------------- #
# This program 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 3 of the License, or #
# (at your option) any later version. #
# #
# This program 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 this program. If not, see <https://www.gnu.org/licenses/>. #
##########################################################################
2013-08-31 18:17:38 +00:00
"""
This module contains tests for the EasyWorship song importer.
"""
import os
from unittest import TestCase
from unittest.mock import MagicMock, patch
2013-08-31 18:17:38 +00:00
2017-10-07 07:05:07 +00:00
from openlp.core.common.registry import Registry
2014-07-04 09:31:06 +00:00
from openlp.plugins.songs.lib.importers.easyworship import EasyWorshipSongImport, FieldDescEntry, FieldType
2017-12-22 21:20:49 +00:00
from tests.utils.constants import RESOURCE_PATH
2018-10-02 04:39:42 +00:00
TEST_PATH = RESOURCE_PATH / 'songs' / 'easyworship'
2013-08-31 18:17:38 +00:00
SONG_TEST_DATA = [
{'title': 'Amazing Grace',
2014-04-02 19:35:09 +00:00
'authors': ['John Newton'],
'copyright': 'Public Domain',
'ccli_number': 0,
'verses':
[('Amazing grace how sweet the sound,\nThat saved a wretch like me;\n'
'I once was lost, but now am found\nWas blind, but now I see.', 'v1'),
('T\'was grace that taught my heart to fear,\nAnd grace my fears relieved;\n'
'How precious did that grace appear\nThe hour I first believed.', 'v2'),
('Through many dangers, toil and snares,\nI have already come;\n'
'\'Tis grace has brought me safe thus far,\nAnd grace will lead me home.', 'v3'),
('When we\'ve been there ten thousand years\nBright shining as the sun,\n'
'We\'ve no less days to sing God\'s praise\nThan when we\'ve first begun.', 'v4')],
'verse_order_list': []},
2013-08-31 18:17:38 +00:00
{'title': 'Beautiful Garden Of Prayer',
2014-04-02 19:35:09 +00:00
'authors': ['Eleanor Allen Schroll James H. Fillmore'],
'copyright': 'Public Domain',
'ccli_number': 0,
'verses':
[('O the beautiful garden, the garden of prayer,\nO the beautiful garden of prayer.\n'
'There my Savior awaits, and He opens the gates\nTo the beautiful garden of prayer.', 'c1'),
('There\'s a garden where Jesus is waiting,\nThere\'s a place that is wondrously fair.\n'
'For it glows with the light of His presence,\n\'Tis the beautiful garden of prayer.', 'v1'),
('There\'s a garden where Jesus is waiting,\nAnd I go with my burden and care.\n'
'Just to learn from His lips, words of comfort,\nIn the beautiful garden of prayer.', 'v2'),
('There\'s a garden where Jesus is waiting,\nAnd He bids you to come meet Him there,\n'
'Just to bow and receive a new blessing,\nIn the beautiful garden of prayer.', 'v3')],
'verse_order_list': []},
{'title': 'Vi pløjed og vi så\'de',
'authors': ['Matthias Claudius'],
'copyright': 'Public Domain',
'ccli_number': 0,
'verses':
[('Vi pløjed og vi så\'de\nvor sæd i sorten jord,\nså bad vi ham os hjælpe,\nsom højt i Himlen bor,\n'
'og han lod snefald hegne\nmod frosten barsk og hård,\nhan lod det tø og regne\nog varme mildt i vår.',
'v1'),
('Alle gode gaver\nde kommer ovenned,\nså tak da Gud, ja, pris dog Gud\nfor al hans kærlighed!', 'c1'),
('Han er jo den, hvis vilje\nopholder alle ting,\nhan klæder markens lilje\nog runder himlens ring,\n'
'ham lyder vind og vove,\nham rører ravnes nød,\nhvi skulle ej hans småbørn\nda og få dagligt brød?', 'v2'),
('Ja, tak, du kære Fader,\nså mild, så rig, så rund,\nfor korn i hæs og lader,\nfor godt i allen stund!\n'
'Vi kan jo intet give,\nsom nogen ting er værd,\nmen tag vort stakkels hjerte,\nså ringe som det er!', 'v3')],
'verse_order_list': []}]
2013-08-31 18:17:38 +00:00
2014-04-04 17:57:03 +00:00
EWS_SONG_TEST_DATA =\
2014-04-05 07:22:24 +00:00
{'title': 'Vi pløjed og vi så\'de',
'authors': ['Matthias Claudius'],
'verses':
2014-04-04 17:57:03 +00:00
[('Vi pløjed og vi så\'de\nvor sæd i sorten jord,\nså bad vi ham os hjælpe,\nsom højt i Himlen bor,\n'
2014-04-05 07:22:24 +00:00
'og han lod snefald hegne\nmod frosten barsk og hård,\nhan lod det tø og regne\nog varme mildt i vår.',
2014-04-04 17:57:03 +00:00
'v1'),
('Alle gode gaver\nde kommer ovenned,\nså tak da Gud, ja, pris dog Gud\nfor al hans kærlighed!', 'c1'),
('Han er jo den, hvis vilje\nopholder alle ting,\nhan klæder markens lilje\nog runder himlens ring,\n'
'ham lyder vind og vove,\nham rører ravnes nød,\nhvi skulle ej hans småbørn\nda og få dagligt brød?', 'v2'),
('Ja, tak, du kære Fader,\nså mild, så rig, så rund,\nfor korn i hæs og lader,\nfor godt i allen stund!\n'
'Vi kan jo intet give,\nsom nogen ting er værd,\nmen tag vort stakkels hjerte,\nså ringe som det er!',
2014-04-05 07:22:24 +00:00
'v3')]}
2014-04-04 17:57:03 +00:00
2013-08-31 18:17:38 +00:00
class EasyWorshipSongImportLogger(EasyWorshipSongImport):
"""
This class logs changes in the title instance variable
"""
_title_assignment_list = []
def __init__(self, manager):
2017-09-30 20:16:30 +00:00
EasyWorshipSongImport.__init__(self, manager, file_paths=[])
2013-08-31 18:17:38 +00:00
@property
def title(self):
return self._title_assignment_list[-1]
@title.setter
def title(self, title):
self._title_assignment_list.append(title)
2017-12-22 10:45:39 +00:00
class DataTestFieldDesc:
2013-08-31 18:17:38 +00:00
def __init__(self, name, field_type, size):
self.name = name
self.field_type = field_type
self.size = size
2016-11-15 21:13:52 +00:00
2013-08-31 18:17:38 +00:00
TEST_DATA_ENCODING = 'cp1252'
2014-04-02 19:35:09 +00:00
CODE_PAGE_MAPPINGS = [
(852, 'cp1250'), (737, 'cp1253'), (775, 'cp1257'), (855, 'cp1251'), (857, 'cp1254'),
2015-12-17 21:43:49 +00:00
(866, 'cp1251'), (869, 'cp1253'), (862, 'cp1255'), (874, 'cp874')]
2014-04-02 19:35:09 +00:00
TEST_FIELD_DESCS = [
2017-12-22 10:45:39 +00:00
DataTestFieldDesc('Title', FieldType.String, 50),
DataTestFieldDesc('Text Percentage Bottom', FieldType.Int16, 2), DataTestFieldDesc('RecID', FieldType.Int32, 4),
DataTestFieldDesc('Default Background', FieldType.Logical, 1), DataTestFieldDesc('Words', FieldType.Memo, 250),
DataTestFieldDesc('Words', FieldType.Memo, 250), DataTestFieldDesc('BK Bitmap', FieldType.Blob, 10),
DataTestFieldDesc('Last Modified', FieldType.Timestamp, 10)]
2014-04-02 19:35:09 +00:00
TEST_FIELDS = [
b'A Heart Like Thine\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0', 32868, 2147483750,
129, b'{\\rtf1\\ansi\\deff0\\deftab254{\\fonttbl{\\f0\\fnil\\fcharset0 Arial;}{\\f1\\fnil\\fcharset0 Verdana;}}'
2014-04-02 19:35:09 +00:00
b'{\\colortbl\\red0\\green0\\blue0;\\red255\\green0\\blue0;\\red0\\green128\\blue0;\\red0\\green0\\blue255;'
b'\\red255\\green255\\blue0;\\red255\\green0\\blue255;\\red128\\g\xBF\xBD\7\0f\r\0\0\1\0',
b'{\\rtf1\\ansi\\deff0\\deftab254{\\fonttbl{\\f0\\fnil\\fcharset0 Arial;}{\\f1\\fnil\\fcharset0 Verdana;}}'
b'{\\colortbl\\red0\\green0\\blue0;\\red255\\green0\\blue0;\\red0\\green128\\blue0;\\red0\\green0'
b'\\blue255;\\red255'
b'\\green255\\blue0;\\red255\\green0\\blue255;\\red128\\g\6\0\xEF\xBF\xBD\6\0\0\1\0',
b'\0\0\0\0\0\0\0\0\0\0', 0]
2013-08-31 18:17:38 +00:00
GET_MEMO_FIELD_TEST_RESULTS = [
2014-04-02 19:35:09 +00:00
(4, b'\2', {'return': b'\2', 'read': (1, 3430), 'seek': (507136, (8, os.SEEK_CUR))}),
(4, b'\3', {'return': b'', 'read': (1, ), 'seek': (507136, )}),
(5, b'\3', {'return': b'\3', 'read': (1, 1725), 'seek': (3220111360, (41, os.SEEK_CUR), 3220111408)}),
(5, b'\4', {'return': b'', 'read': (), 'seek': ()})]
2013-08-31 18:17:38 +00:00
2014-04-02 19:35:09 +00:00
2013-08-31 18:17:38 +00:00
class TestEasyWorshipSongImport(TestCase):
"""
Test the functions in the :mod:`ewimport` module.
"""
def setUp(self):
"""
Create the registry
"""
Registry.create()
2016-05-31 21:40:13 +00:00
def test_create_field_desc_entry(self):
2013-08-31 18:17:38 +00:00
"""
Test creating an instance of the :class`FieldDescEntry` class.
"""
# GIVEN: Set arguments
name = 'Title'
field_type = FieldType.String
size = 50
# WHEN: A FieldDescEntry object is created.
field_desc_entry = FieldDescEntry(name, field_type, size)
# THEN:
2017-12-22 22:20:04 +00:00
assert field_desc_entry is not None, 'Import should not be none'
2017-12-24 07:11:30 +00:00
assert field_desc_entry.name == name, 'FieldDescEntry.name should be the same as the name argument'
2017-12-22 22:20:04 +00:00
assert field_desc_entry.field_type == field_type, 'FieldDescEntry.type should be the same as the type argument'
assert field_desc_entry.size == size, 'FieldDescEntry.size should be the same as the size argument'
2013-08-31 18:17:38 +00:00
2016-05-31 21:40:13 +00:00
def test_create_importer(self):
2013-08-31 18:17:38 +00:00
"""
Test creating an instance of the EasyWorship file importer
"""
# GIVEN: A mocked out SongImport class, and a mocked out "manager"
2014-07-04 09:31:06 +00:00
with patch('openlp.plugins.songs.lib.importers.easyworship.SongImport'):
2013-08-31 18:17:38 +00:00
mocked_manager = MagicMock()
# WHEN: An importer object is created
2017-09-30 20:16:30 +00:00
importer = EasyWorshipSongImport(mocked_manager, file_paths=[])
2013-08-31 18:17:38 +00:00
# THEN: The importer object should not be None
2017-12-22 22:20:04 +00:00
assert importer is not None, 'Import should not be none'
2013-08-31 18:17:38 +00:00
2016-05-31 21:40:13 +00:00
def test_find_field_exists(self):
2013-08-31 18:17:38 +00:00
"""
Test finding an existing field in a given list using the :mod:`db_find_field`
2013-08-31 18:17:38 +00:00
"""
# GIVEN: A mocked out SongImport class, a mocked out "manager" and a list of field descriptions.
2014-07-04 09:31:06 +00:00
with patch('openlp.plugins.songs.lib.importers.easyworship.SongImport'):
2013-08-31 18:17:38 +00:00
mocked_manager = MagicMock()
2017-09-30 20:16:30 +00:00
importer = EasyWorshipSongImport(mocked_manager, file_paths=[])
2014-03-06 20:40:08 +00:00
importer.field_descriptions = TEST_FIELD_DESCS
2013-08-31 18:17:38 +00:00
# WHEN: Called with a field name that exists
existing_fields = ['Title', 'Text Percentage Bottom', 'RecID', 'Default Background', 'Words',
2014-04-02 19:35:09 +00:00
'BK Bitmap', 'Last Modified']
2013-08-31 18:17:38 +00:00
for field_name in existing_fields:
# THEN: The item corresponding the index returned should have the same name attribute
2017-12-22 22:20:04 +00:00
assert importer.field_descriptions[importer.db_find_field(field_name)].name == field_name
2013-08-31 18:17:38 +00:00
2016-05-31 21:40:13 +00:00
def test_find_non_existing_field(self):
2013-08-31 18:17:38 +00:00
"""
Test finding an non-existing field in a given list using the :mod:`db_find_field`
2013-08-31 18:17:38 +00:00
"""
# GIVEN: A mocked out SongImport class, a mocked out "manager" and a list of field descriptions
2014-07-04 09:31:06 +00:00
with patch('openlp.plugins.songs.lib.importers.easyworship.SongImport'):
2013-08-31 18:17:38 +00:00
mocked_manager = MagicMock()
2017-09-30 20:16:30 +00:00
importer = EasyWorshipSongImport(mocked_manager, file_paths=[])
2014-03-06 20:40:08 +00:00
importer.field_descriptions = TEST_FIELD_DESCS
2013-08-31 18:17:38 +00:00
# WHEN: Called with a field name that does not exist
non_existing_fields = ['BK Gradient Shading', 'BK Gradient Variant', 'Favorite', 'Copyright']
for field_name in non_existing_fields:
# THEN: The importer object should not be None
self.assertRaises(IndexError, importer.db_find_field, field_name)
2013-08-31 18:17:38 +00:00
2016-05-31 21:40:13 +00:00
def test_set_record_struct(self):
2013-08-31 18:17:38 +00:00
"""
Test the :mod:`db_set_record_struct` module
2013-08-31 18:17:38 +00:00
"""
# GIVEN: A mocked out SongImport class, a mocked out struct class, and a mocked out "manager" and a list of
# field descriptions
2014-07-04 09:31:06 +00:00
with patch('openlp.plugins.songs.lib.importers.easyworship.SongImport'), \
patch('openlp.plugins.songs.lib.importers.easyworship.struct') as mocked_struct:
2013-08-31 18:17:38 +00:00
mocked_manager = MagicMock()
2017-09-30 20:16:30 +00:00
importer = EasyWorshipSongImport(mocked_manager, file_paths=[])
2013-08-31 18:17:38 +00:00
# WHEN: db_set_record_struct is called with a list of field descriptions
return_value = importer.db_set_record_struct(TEST_FIELD_DESCS)
2013-08-31 18:17:38 +00:00
# THEN: db_set_record_struct should return None and Struct should be called with a value representing
2013-08-31 18:17:38 +00:00
# the list of field descriptions
2017-12-22 22:20:04 +00:00
assert return_value is None, 'db_set_record_struct should return None'
2013-08-31 18:17:38 +00:00
mocked_struct.Struct.assert_called_with('>50sHIB250s250s10sQ')
@patch('openlp.plugins.songs.lib.importers.easyworship.SongImport')
def test_get_field(self, MockSongImport):
2013-08-31 18:17:38 +00:00
"""
Test the :mod:`db_get_field` module
2013-08-31 18:17:38 +00:00
"""
# GIVEN: A mocked out SongImport class, a mocked out "manager", an encoding and some test data and known results
mocked_manager = MagicMock()
importer = EasyWorshipSongImport(mocked_manager, file_paths=[])
importer.encoding = TEST_DATA_ENCODING
importer.fields = TEST_FIELDS
importer.field_descriptions = TEST_FIELD_DESCS
field_results = [(0, b'A Heart Like Thine'), (1, 100), (2, 102), (3, True), (6, None), (7, None)]
# WHEN: Called with test data
for field_index, result in field_results:
return_value = importer.db_get_field(field_index)
# THEN: db_get_field should return the known results
2017-12-22 22:20:04 +00:00
assert return_value == result, 'db_get_field should return "%s" when called with "%s"' % \
(result, TEST_FIELDS[field_index])
@patch('openlp.plugins.songs.lib.importers.easyworship.SongImport')
def test_get_memo_field(self, MockSongImport):
2013-08-31 18:17:38 +00:00
"""
Test the :mod:`db_get_field` module
2013-08-31 18:17:38 +00:00
"""
for test_results in GET_MEMO_FIELD_TEST_RESULTS:
# GIVEN: A mocked out SongImport class, a mocked out "manager", a mocked out memo_file and an encoding
mocked_manager = MagicMock()
mocked_memo_file = MagicMock()
importer = EasyWorshipSongImport(mocked_manager, file_paths=[])
importer.memo_file = mocked_memo_file
importer.encoding = TEST_DATA_ENCODING
# WHEN: Supplied with test fields and test field descriptions
importer.fields = TEST_FIELDS
importer.field_descriptions = TEST_FIELD_DESCS
field_index = test_results[0]
mocked_memo_file.read.return_value = test_results[1]
get_field_result = test_results[2]['return']
get_field_read_calls = test_results[2]['read']
get_field_seek_calls = test_results[2]['seek']
# THEN: db_get_field should return the appropriate value with the appropriate mocked objects being
# called
2017-12-22 22:20:04 +00:00
assert importer.db_get_field(field_index) == get_field_result
for call in get_field_read_calls:
mocked_memo_file.read.assert_any_call(call)
for call in get_field_seek_calls:
if isinstance(call, int):
mocked_memo_file.seek.assert_any_call(call)
else:
mocked_memo_file.seek.assert_any_call(call[0], call[1])
@patch('openlp.plugins.songs.lib.importers.easyworship.SongImport')
@patch('openlp.plugins.songs.lib.importers.easyworship.Path.is_file', side_effect=[True, False])
def test_do_import_source_invalid(self, mocked_is_file, MockSongImport):
2014-06-09 07:55:48 +00:00
"""
Test the :mod:`do_import` module produces an error when Songs.MB not found.
"""
# GIVEN: A mocked out SongImport class, a mocked out "manager"
mocked_manager = MagicMock()
importer = EasyWorshipSongImport(mocked_manager, file_paths=[])
with patch.object(importer, 'log_error') as mocked_log_error:
2014-06-09 07:55:48 +00:00
# WHEN: do_import is supplied with an import source (Songs.MB missing)
importer.import_source = 'Songs.DB'
importer.do_import()
2014-06-09 07:55:48 +00:00
# THEN: do_import should have logged an error that the Songs.MB file could not be found.
mocked_log_error.assert_any_call(importer.import_source,
'Could not find the "Songs.MB" file. It must be in the same folder as '
'the "Songs.DB" file.')
2014-06-09 07:55:48 +00:00
@patch('openlp.plugins.songs.lib.importers.easyworship.SongImport')
@patch('openlp.plugins.songs.lib.importers.easyworship.Path.is_file', return_value=True)
@patch('openlp.plugins.songs.lib.importers.easyworship.Path.stat')
def test_do_import_database_validity(self, mocked_stat, mocked_is_file, MockSongImport):
2013-08-31 18:17:38 +00:00
"""
2014-03-06 20:40:08 +00:00
Test the :mod:`do_import` module handles invalid database files correctly
2013-08-31 18:17:38 +00:00
"""
# GIVEN: A mocked out SongImport class, os.path and a mocked out "manager"
mocked_manager = MagicMock()
importer = EasyWorshipSongImport(mocked_manager, file_paths=[])
importer.import_source = 'Songs.DB'
# WHEN: DB file size is less than 0x800
mocked_stat.return_value.st_size = 0x7FF
# THEN: do_import should return None having called Path.stat()
2017-12-22 22:20:04 +00:00
assert importer.do_import() is None, 'do_import should return None when db_size is less than 0x800'
mocked_stat.assert_called_once_with()
@patch('openlp.plugins.songs.lib.importers.easyworship.SongImport')
@patch('openlp.plugins.songs.lib.importers.easyworship.Path.is_file', return_value=True)
@patch('openlp.plugins.songs.lib.importers.easyworship.Path.stat', **{'return_value.st_size': 0x800})
@patch('openlp.plugins.songs.lib.importers.easyworship.Path.open')
@patch('openlp.plugins.songs.lib.importers.easyworship.struct')
def test_do_import_memo_validty(self, mocked_struct, mocked_open, mocked_stat, mocked_is_file, MockSongImport):
2013-08-31 18:17:38 +00:00
"""
2014-03-06 20:40:08 +00:00
Test the :mod:`do_import` module handles invalid memo files correctly
2013-08-31 18:17:38 +00:00
"""
# GIVEN: A mocked out SongImport class, a mocked out "manager"
mocked_manager = MagicMock()
importer = EasyWorshipSongImport(mocked_manager, file_paths=[])
importer.import_source = 'Songs.DB'
2013-08-31 18:17:38 +00:00
# WHEN: Unpacking first 35 bytes of Memo file
struct_unpack_return_values = [(0, 0x700, 2, 0, 0), (0, 0x800, 0, 0, 0), (0, 0x800, 5, 0, 0)]
mocked_struct.unpack.side_effect = struct_unpack_return_values
2013-08-31 18:17:38 +00:00
# THEN: do_import should return None having called closed the open files db and memo files.
for effect in struct_unpack_return_values:
2017-12-22 22:20:04 +00:00
assert importer.do_import() is None, 'do_import should return None when db_size is less than 0x800'
assert mocked_open().close.call_count == 2, 'The open db and memo files should have been closed'
mocked_open().close.reset_mock()
2017-12-22 22:20:04 +00:00
assert mocked_open().seek.called is False, 'db_file.seek should not have been called.'
@patch('openlp.plugins.songs.lib.importers.easyworship.SongImport')
@patch('openlp.plugins.songs.lib.importers.easyworship.Path.is_file', return_value=True)
@patch('openlp.plugins.songs.lib.importers.easyworship.Path.stat', **{'return_value.st_size': 0x800})
@patch('openlp.plugins.songs.lib.importers.easyworship.Path.open')
@patch('builtins.open')
@patch('openlp.plugins.songs.lib.importers.easyworship.struct')
@patch('openlp.plugins.songs.lib.importers.easyworship.retrieve_windows_encoding')
def test_code_page_to_encoding(self, mocked_retrieve_windows_encoding, mocked_struct, mocked_open, mocked_path_open,
mocked_path_stat, mocked_path_is_file, MockSongImport):
2013-08-31 18:17:38 +00:00
"""
2014-03-06 20:40:08 +00:00
Test the :mod:`do_import` converts the code page to the encoding correctly
2013-08-31 18:17:38 +00:00
"""
# GIVEN: A mocked out SongImport class, a mocked out "manager"
mocked_manager = MagicMock()
importer = EasyWorshipSongImport(mocked_manager, file_paths=[])
importer.import_source = 'Songs.DB'
2013-08-31 18:17:38 +00:00
# WHEN: Unpacking the code page
for code_page, encoding in CODE_PAGE_MAPPINGS:
struct_unpack_return_values = [(0, 0x800, 2, 0, 0), (code_page, )]
mocked_struct.unpack.side_effect = struct_unpack_return_values
mocked_retrieve_windows_encoding.return_value = False
2013-08-31 18:17:38 +00:00
# THEN: do_import should return None having called retrieve_windows_encoding with the correct encoding.
2017-12-22 22:20:04 +00:00
assert importer.do_import() is None, 'do_import should return None when db_size is less than 0x800'
mocked_retrieve_windows_encoding.assert_any_call(encoding)
2013-08-31 18:17:38 +00:00
2016-05-31 21:40:13 +00:00
def test_db_file_import(self):
2017-12-22 21:20:49 +00:00
return self._run_db_file_import(TEST_PATH / 'Songs.DB')
2016-09-17 04:39:40 +00:00
def test_sqlite_db_file_import(self):
2017-12-22 21:20:49 +00:00
return self._run_db_file_import(TEST_PATH / 'ew6')
2016-09-17 04:39:40 +00:00
def _run_db_file_import(self, source_path):
2013-08-31 18:17:38 +00:00
"""
2014-04-04 17:57:03 +00:00
Test the actual import of real song database files and check that the imported data is correct.
2013-08-31 18:17:38 +00:00
"""
# GIVEN: Test files with a mocked out SongImport class, a mocked out "manager", a mocked out "import_wizard",
# and mocked out "author", "add_copyright", "add_verse", "finish" methods.
2014-07-04 09:31:06 +00:00
with patch('openlp.plugins.songs.lib.importers.easyworship.SongImport'), \
patch('openlp.plugins.songs.lib.importers.easyworship.retrieve_windows_encoding') as \
2014-04-02 19:35:09 +00:00
mocked_retrieve_windows_encoding:
2013-08-31 18:17:38 +00:00
mocked_retrieve_windows_encoding.return_value = 'cp1252'
mocked_manager = MagicMock()
mocked_import_wizard = MagicMock()
mocked_add_author = MagicMock()
mocked_add_verse = MagicMock()
mocked_finish = MagicMock()
mocked_title = MagicMock()
mocked_finish.return_value = True
importer = EasyWorshipSongImportLogger(mocked_manager)
importer.import_wizard = mocked_import_wizard
importer.stop_import_flag = False
2014-03-05 18:58:22 +00:00
importer.add_author = mocked_add_author
importer.add_verse = mocked_add_verse
2013-08-31 18:17:38 +00:00
importer.title = mocked_title
importer.finish = mocked_finish
importer.topics = []
# WHEN: Importing each file
2017-12-22 21:20:49 +00:00
# TODO: To Path object
importer.import_source = str(source_path)
2014-04-26 19:47:11 +00:00
import_result = importer.do_import()
2013-08-31 18:17:38 +00:00
2014-03-06 20:40:08 +00:00
# THEN: do_import should return none, the song data should be as expected, and finish should have been
2013-08-31 18:17:38 +00:00
# called.
2017-12-22 22:20:04 +00:00
assert import_result is None, 'do_import should return None when it has completed'
2013-08-31 18:17:38 +00:00
for song_data in SONG_TEST_DATA:
title = song_data['title']
author_calls = song_data['authors']
song_copyright = song_data['copyright']
ccli_number = song_data['ccli_number']
add_verse_calls = song_data['verses']
verse_order_list = song_data['verse_order_list']
2017-12-22 22:20:04 +00:00
assert title in importer._title_assignment_list, 'title for %s should be "%s"' % (title, title)
2013-08-31 18:17:38 +00:00
for author in author_calls:
mocked_add_author.assert_any_call(author)
if song_copyright:
2017-12-22 22:20:04 +00:00
assert importer.copyright == song_copyright
2013-08-31 18:17:38 +00:00
if ccli_number:
2017-12-22 22:20:04 +00:00
assert importer.ccli_number == ccli_number, 'ccli_number for %s should be %s' % (title, ccli_number)
2013-08-31 18:17:38 +00:00
for verse_text, verse_tag in add_verse_calls:
mocked_add_verse.assert_any_call(verse_text, verse_tag)
if verse_order_list:
2017-12-22 22:20:04 +00:00
assert importer.verse_order_list == verse_order_list, \
'verse_order_list for %s should be %s' % (title, verse_order_list)
2013-08-31 18:17:38 +00:00
mocked_finish.assert_called_with()
2014-04-04 17:57:03 +00:00
@patch('openlp.plugins.songs.lib.importers.easyworship.SongImport')
@patch('openlp.plugins.songs.lib.importers.easyworship.retrieve_windows_encoding')
def test_ews_file_import(self, mocked_retrieve_windows_encoding, MockSongImport):
2014-04-04 17:57:03 +00:00
"""
Test the actual import of song from ews file and check that the imported data is correct.
"""
# GIVEN: Test files with a mocked out SongImport class, a mocked out "manager", a mocked out "import_wizard",
# and mocked out "author", "add_copyright", "add_verse", "finish" methods.
mocked_retrieve_windows_encoding.return_value = 'cp1252'
mocked_manager = MagicMock()
mocked_import_wizard = MagicMock()
mocked_add_author = MagicMock()
mocked_add_verse = MagicMock()
mocked_finish = MagicMock()
mocked_title = MagicMock()
mocked_finish.return_value = True
importer = EasyWorshipSongImportLogger(mocked_manager)
importer.import_wizard = mocked_import_wizard
importer.stop_import_flag = False
importer.add_author = mocked_add_author
importer.add_verse = mocked_add_verse
importer.title = mocked_title
importer.finish = mocked_finish
importer.topics = []
# WHEN: Importing ews file
2017-12-22 21:20:49 +00:00
importer.import_source = str(TEST_PATH / 'test1.ews')
import_result = importer.do_import()
# THEN: do_import should return none, the song data should be as expected, and finish should have been
# called.
title = EWS_SONG_TEST_DATA['title']
2017-12-22 22:20:04 +00:00
assert import_result is None, 'do_import should return None when it has completed'
assert title in importer._title_assignment_list, 'title for should be "%s"' % title
mocked_add_author.assert_any_call(EWS_SONG_TEST_DATA['authors'][0])
for verse_text, verse_tag in EWS_SONG_TEST_DATA['verses']:
mocked_add_verse.assert_any_call(verse_text, verse_tag)
mocked_finish.assert_called_with()
@patch('openlp.plugins.songs.lib.importers.easyworship.SongImport')
def test_import_rtf_unescaped_unicode(self, MockSongImport):
2014-05-02 21:48:59 +00:00
"""
Test import of rtf without the expected escaping of unicode
"""
# GIVEN: A mocked out SongImport class, a mocked out "manager" and mocked out "author" method.
mocked_manager = MagicMock()
mocked_add_author = MagicMock()
importer = EasyWorshipSongImportLogger(mocked_manager)
importer.add_author = mocked_add_author
importer.encoding = 'cp1252'
2014-05-02 21:48:59 +00:00
# WHEN: running set_song_import_object on a verse string without the needed escaping
importer.set_song_import_object('Test Author', b'Det som var fr\x86n begynnelsen')
2014-05-02 21:48:59 +00:00
# THEN: The import should fail
2017-12-22 22:20:04 +00:00
assert importer.entry_error_log == 'Unexpected data formatting.', 'Import should fail'