2021-03-08 16:49:10 +00:00
|
|
|
""" testing book data connectors """
|
2020-12-31 20:22:00 +00:00
|
|
|
from django.test import TestCase
|
|
|
|
import responses
|
|
|
|
|
|
|
|
from bookwyrm import models
|
|
|
|
from bookwyrm.connectors import abstract_connector
|
|
|
|
from bookwyrm.connectors.abstract_connector import Mapping, SearchResult
|
|
|
|
|
|
|
|
|
|
|
|
class AbstractConnector(TestCase):
|
2021-03-08 16:49:10 +00:00
|
|
|
""" generic code for connecting to outside data sources """
|
|
|
|
|
2020-12-31 20:22:00 +00:00
|
|
|
def setUp(self):
|
2021-03-08 16:49:10 +00:00
|
|
|
""" we need an example connector """
|
2020-12-31 20:22:00 +00:00
|
|
|
self.connector_info = models.Connector.objects.create(
|
2021-03-08 16:49:10 +00:00
|
|
|
identifier="example.com",
|
|
|
|
connector_file="openlibrary",
|
|
|
|
base_url="https://example.com",
|
|
|
|
books_url="https://example.com/books",
|
|
|
|
covers_url="https://example.com/covers",
|
|
|
|
search_url="https://example.com/search?q=",
|
|
|
|
isbn_search_url="https://example.com/isbn",
|
2020-12-31 20:22:00 +00:00
|
|
|
)
|
|
|
|
|
|
|
|
class TestConnector(abstract_connector.AbstractMinimalConnector):
|
2021-03-08 16:49:10 +00:00
|
|
|
""" nothing added here """
|
|
|
|
|
2020-12-31 20:22:00 +00:00
|
|
|
def format_search_result(self, search_result):
|
|
|
|
return search_result
|
2021-03-08 16:49:10 +00:00
|
|
|
|
2020-12-31 20:22:00 +00:00
|
|
|
def get_or_create_book(self, remote_id):
|
|
|
|
pass
|
2021-03-08 16:49:10 +00:00
|
|
|
|
2020-12-31 20:22:00 +00:00
|
|
|
def parse_search_data(self, data):
|
|
|
|
return data
|
2021-03-08 16:49:10 +00:00
|
|
|
|
2021-03-01 20:09:21 +00:00
|
|
|
def format_isbn_search_result(self, search_result):
|
|
|
|
return search_result
|
2021-03-08 16:49:10 +00:00
|
|
|
|
2021-03-01 20:09:21 +00:00
|
|
|
def parse_isbn_search_data(self, data):
|
|
|
|
return data
|
2020-12-31 20:22:00 +00:00
|
|
|
|
2021-03-08 16:49:10 +00:00
|
|
|
self.test_connector = TestConnector("example.com")
|
2020-12-31 20:22:00 +00:00
|
|
|
|
|
|
|
def test_abstract_minimal_connector_init(self):
|
2021-03-08 16:49:10 +00:00
|
|
|
""" barebones connector for search with defaults """
|
2020-12-31 20:22:00 +00:00
|
|
|
connector = self.test_connector
|
|
|
|
self.assertEqual(connector.connector, self.connector_info)
|
2021-03-08 16:49:10 +00:00
|
|
|
self.assertEqual(connector.base_url, "https://example.com")
|
|
|
|
self.assertEqual(connector.books_url, "https://example.com/books")
|
|
|
|
self.assertEqual(connector.covers_url, "https://example.com/covers")
|
|
|
|
self.assertEqual(connector.search_url, "https://example.com/search?q=")
|
|
|
|
self.assertEqual(connector.isbn_search_url, "https://example.com/isbn")
|
2020-12-31 20:22:00 +00:00
|
|
|
self.assertIsNone(connector.name)
|
2021-03-08 16:49:10 +00:00
|
|
|
self.assertEqual(connector.identifier, "example.com")
|
2020-12-31 20:22:00 +00:00
|
|
|
self.assertIsNone(connector.max_query_count)
|
|
|
|
self.assertFalse(connector.local)
|
|
|
|
|
|
|
|
@responses.activate
|
|
|
|
def test_search(self):
|
2021-03-08 16:49:10 +00:00
|
|
|
""" makes an http request to the outside service """
|
2020-12-31 20:22:00 +00:00
|
|
|
responses.add(
|
|
|
|
responses.GET,
|
2021-03-08 16:49:10 +00:00
|
|
|
"https://example.com/search?q=a%20book%20title",
|
|
|
|
json=["a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", "l"],
|
|
|
|
status=200,
|
|
|
|
)
|
|
|
|
results = self.test_connector.search("a book title")
|
2020-12-31 20:22:00 +00:00
|
|
|
self.assertEqual(len(results), 10)
|
2021-03-08 16:49:10 +00:00
|
|
|
self.assertEqual(results[0], "a")
|
|
|
|
self.assertEqual(results[1], "b")
|
|
|
|
self.assertEqual(results[2], "c")
|
2020-12-31 20:22:00 +00:00
|
|
|
|
|
|
|
def test_search_result(self):
|
2021-03-08 16:49:10 +00:00
|
|
|
""" a class that stores info about a search result """
|
2020-12-31 20:22:00 +00:00
|
|
|
result = SearchResult(
|
2021-03-08 16:49:10 +00:00
|
|
|
title="Title",
|
|
|
|
key="https://example.com/book/1",
|
|
|
|
author="Author Name",
|
|
|
|
year="1850",
|
2020-12-31 20:22:00 +00:00
|
|
|
connector=self.test_connector,
|
|
|
|
)
|
|
|
|
# there's really not much to test here, it's just a dataclass
|
|
|
|
self.assertEqual(result.confidence, 1)
|
2021-03-08 16:49:10 +00:00
|
|
|
self.assertEqual(result.title, "Title")
|
2020-12-31 20:22:00 +00:00
|
|
|
|
|
|
|
def test_create_mapping(self):
|
2021-03-08 16:49:10 +00:00
|
|
|
""" maps remote fields for book data to bookwyrm activitypub fields """
|
|
|
|
mapping = Mapping("isbn")
|
|
|
|
self.assertEqual(mapping.local_field, "isbn")
|
|
|
|
self.assertEqual(mapping.remote_field, "isbn")
|
|
|
|
self.assertEqual(mapping.formatter("bb"), "bb")
|
2020-12-31 20:22:00 +00:00
|
|
|
|
|
|
|
def test_create_mapping_with_remote(self):
|
2021-03-08 16:49:10 +00:00
|
|
|
""" the remote field is different than the local field """
|
|
|
|
mapping = Mapping("isbn", remote_field="isbn13")
|
|
|
|
self.assertEqual(mapping.local_field, "isbn")
|
|
|
|
self.assertEqual(mapping.remote_field, "isbn13")
|
|
|
|
self.assertEqual(mapping.formatter("bb"), "bb")
|
2020-12-31 20:22:00 +00:00
|
|
|
|
|
|
|
def test_create_mapping_with_formatter(self):
|
2021-03-08 16:49:10 +00:00
|
|
|
""" a function is provided to modify the data """
|
|
|
|
formatter = lambda x: "aa" + x
|
|
|
|
mapping = Mapping("isbn", formatter=formatter)
|
|
|
|
self.assertEqual(mapping.local_field, "isbn")
|
|
|
|
self.assertEqual(mapping.remote_field, "isbn")
|
2020-12-31 20:22:00 +00:00
|
|
|
self.assertEqual(mapping.formatter, formatter)
|
2021-03-08 16:49:10 +00:00
|
|
|
self.assertEqual(mapping.formatter("bb"), "aabb")
|