Koha-clms/t/Koha/SearchEngine/Elasticsearch/QueryBuilder.t

307 lines
13 KiB
Perl
Executable File

#!/usr/bin/perl
#
# This file is part of Koha.
#
# Koha 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.
#
# Koha 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 Koha; if not, see <http://www.gnu.org/licenses>.
use Modern::Perl;
use Test::More tests => 6;
use t::lib::Mocks;
use_ok('Koha::SearchEngine::Elasticsearch::QueryBuilder');
subtest 'query_regex_escape_options' => sub {
plan tests => 12;
t::lib::Mocks::mock_preference('QueryRegexEscapeOptions', 'dont_escape');
my $query_with_regexp = "query /with regexp/";
my $processed_query = Koha::SearchEngine::Elasticsearch::QueryBuilder->_query_regex_escape_process($query_with_regexp);
is(
$processed_query,
$query_with_regexp,
"Unescaped query regexp has not been escaped when escaping is disabled"
);
t::lib::Mocks::mock_preference('QueryRegexEscapeOptions', 'escape');
$processed_query = Koha::SearchEngine::Elasticsearch::QueryBuilder->_query_regex_escape_process($query_with_regexp);
is(
$processed_query,
"query \\/with regexp\\/",
"Unescaped query regexp has been escaped when escaping is enabled"
);
my $query_with_escaped_regex = "query \\/with regexp\\/";
$processed_query = Koha::SearchEngine::Elasticsearch::QueryBuilder->_query_regex_escape_process($query_with_escaped_regex);
is(
$processed_query,
$query_with_escaped_regex,
"Escaped query regexp has been left unmodified when escaping is enabled"
);
my $query_with_even_preceding_escapes_regex = "query \\\\/with regexp\\\\/";
$processed_query = Koha::SearchEngine::Elasticsearch::QueryBuilder->_query_regex_escape_process($query_with_even_preceding_escapes_regex);
is(
$processed_query,
"query \\\\\\/with regexp\\\\\\/",
"Query regexp with even preceding escapes, thus unescaped, has been escaped when escaping is enabled"
);
my $query_with_odd_preceding_escapes_regex = 'query \\\\\\/with regexp\\\\\\/';
$processed_query = Koha::SearchEngine::Elasticsearch::QueryBuilder->_query_regex_escape_process($query_with_odd_preceding_escapes_regex);
is(
$processed_query,
$query_with_odd_preceding_escapes_regex,
"Query regexp with odd preceding escapes, thus escaped, has been left unmodified when escaping is enabled"
);
my $query_with_quoted_slash = "query with / and \"/ within quotes\"";
$processed_query = Koha::SearchEngine::Elasticsearch::QueryBuilder->_query_regex_escape_process($query_with_quoted_slash);
is(
$processed_query,
"query with \\/ and \"/ within quotes\"",
"Unescaped slash outside of quotes has been escaped while unescaped slash within quotes is left as is when escaping is enabled."
);
t::lib::Mocks::mock_preference('QueryRegexEscapeOptions', 'unescape_escaped');
$processed_query = Koha::SearchEngine::Elasticsearch::QueryBuilder->_query_regex_escape_process($query_with_regexp);
is(
$processed_query,
"query \\/with regexp\\/",
"Unescaped query regexp has been escaped when unescape escaping is enabled"
);
$processed_query = Koha::SearchEngine::Elasticsearch::QueryBuilder->_query_regex_escape_process($query_with_escaped_regex);
is(
$processed_query,
"query /with regexp/",
"Escaped query regexp has been unescaped when unescape escaping is enabled"
);
$processed_query = Koha::SearchEngine::Elasticsearch::QueryBuilder->_query_regex_escape_process($query_with_even_preceding_escapes_regex);
is(
$processed_query,
"query \\\\\\/with regexp\\\\\\/",
"Query regexp with even preceding escapes, thus unescaped, has been escaped when unescape escaping is enabled"
);
$processed_query = Koha::SearchEngine::Elasticsearch::QueryBuilder->_query_regex_escape_process($query_with_odd_preceding_escapes_regex);
is(
$processed_query,
"query \\\\/with regexp\\\\/",
"Query regexp with odd preceding escapes, thus escaped, has been unescaped when unescape escaping is enabled"
);
my $regexp_at_start_of_string_with_odd_preceding_escapes_regex = '\\\\\\/regexp\\\\\\/';
$processed_query = Koha::SearchEngine::Elasticsearch::QueryBuilder->_query_regex_escape_process($regexp_at_start_of_string_with_odd_preceding_escapes_regex);
is(
$processed_query,
"\\\\/regexp\\\\/",
"Regexp at start of string with odd preceding escapes, thus escaped, has been unescaped when unescape escaping is enabled"
);
my $query_with_quoted_escaped_slash = "query with \\/ and \"\\/ within quotes\"";
$processed_query = Koha::SearchEngine::Elasticsearch::QueryBuilder->_query_regex_escape_process($query_with_quoted_escaped_slash);
is(
$processed_query,
"query with / and \"\\/ within quotes\"",
"Escaped slash outside of quotes has been unescaped while escaped slash within quotes is left as is when unescape escaping is enabled."
);
};
subtest '_truncate_terms() tests' => sub {
plan tests => 7;
my $qb;
ok(
$qb = Koha::SearchEngine::Elasticsearch::QueryBuilder->new({ 'index' => $Koha::SearchEngine::Elasticsearch::BIBLIOS_INDEX }),
'Creating a new QueryBuilder object'
);
my $res = $qb->_truncate_terms('donald');
is_deeply($res, 'donald*', 'single search term returned correctly');
$res = $qb->_truncate_terms('donald duck');
is_deeply($res, 'donald* duck*', 'two search terms returned correctly');
$res = $qb->_truncate_terms(' donald duck ');
is_deeply($res, 'donald* duck*', 'two search terms surrounded by spaces returned correctly');
$res = $qb->_truncate_terms('"donald duck"');
is_deeply($res, '"donald duck"', 'quoted search term returned correctly');
$res = $qb->_truncate_terms('"donald, duck"');
is_deeply($res, '"donald, duck"', 'quoted search term with comma returned correctly');
$res = $qb->_truncate_terms(' "donald duck" ');
is_deeply($res, '"donald duck"', 'quoted search terms surrounded by spaces correctly');
};
subtest '_split_query() tests' => sub {
plan tests => 7;
my $qb;
ok(
$qb = Koha::SearchEngine::Elasticsearch::QueryBuilder->new({ 'index' => $Koha::SearchEngine::Elasticsearch::BIBLIOS_INDEX }),
'Creating a new QueryBuilder object'
);
my @res = $qb->_split_query('donald');
my @exp = 'donald';
is_deeply(\@res, \@exp, 'single search term returned correctly');
@res = $qb->_split_query('donald duck');
@exp = ('donald', 'duck');
is_deeply(\@res, \@exp, 'two search terms returned correctly');
@res = $qb->_split_query(' donald duck ');
@exp = ('donald', 'duck');
is_deeply(\@res, \@exp, 'two search terms surrounded by spaces returned correctly');
@res = $qb->_split_query('"donald duck"');
@exp = ( '"donald duck"' );
is_deeply(\@res, \@exp, 'quoted search term returned correctly');
@res = $qb->_split_query('"donald, duck"');
@exp = ( '"donald, duck"' );
is_deeply(\@res, \@exp, 'quoted search term with comma returned correctly');
@res = $qb->_split_query(' "donald duck" ');
@exp = ( '"donald duck"' );
is_deeply(\@res, \@exp, 'quoted search terms surrounded by spaces correctly');
};
subtest 'clean_search_term() tests' => sub {
plan tests => 25;
my $qb;
ok(
$qb = Koha::SearchEngine::Elasticsearch::QueryBuilder->new({ 'index' => $Koha::SearchEngine::Elasticsearch::BIBLIOS_INDEX }),
'Creating a new QueryBuilder object'
);
t::lib::Mocks::mock_preference('QueryAutoTruncate', 0);
my $res = $qb->clean_search_term('an=123');
is($res, 'koha-auth-number:123', 'equals sign replaced with colon');
$res = $qb->clean_search_term('"balanced quotes"');
is($res, '"balanced quotes"', 'balanced quotes returned correctly');
$res = $qb->clean_search_term('unbalanced quotes"');
is($res, 'unbalanced quotes ', 'unbalanced quotes removed');
$res = $qb->clean_search_term('"unbalanced "quotes"');
is($res, ' unbalanced quotes ', 'unbalanced quotes removed');
$res = $qb->clean_search_term(':test query');
is($res, 'test query', 'remove colon at the start');
$res = $qb->clean_search_term('test query\:');
is($res, 'test query', 'remove colon at the end');
$res = $qb->clean_search_term('test : query');
is($res, 'test query', 'dangling colon removed');
$res = $qb->clean_search_term('test :: query');
is($res, 'test query', 'dangling double colon removed');
$res = $qb->clean_search_term('test "another : query"');
is($res, 'test "another : query"', 'quoted dangling colon not removed');
$res = $qb->clean_search_term('host-item:test:n');
is($res, 'host-item:test\:n', 'screen colons properly');
$res = $qb->clean_search_term('host-item:test:n:test:and more');
is($res, 'host-item:test\:n\:test\:and more', 'screen multiple colons properly');
$res = $qb->clean_search_term('host-item:te st:n');
is($res, 'host-item:te st:n', 'leave colons as they are');
$res = $qb->clean_search_term('test!');
is($res, 'test', 'remove exclamation sign at the end of the line');
$res = $qb->clean_search_term('test! and more');
is($res, 'test and more', 'remove exclamation sign at with space after it');
$res = $qb->clean_search_term('test! and more (and more!)');
is($res, 'test and more (and more)', 'remove exclamation sign followed by close parentheses');
$res = $qb->clean_search_term('!test');
is($res, '!test', 'exclamation sign left untouched');
$res = $qb->clean_search_term('test [123 TO 345]');
is($res, 'test [123 TO 345]', 'keep inculsive range untouched');
$res = $qb->clean_search_term('test [test TO TEST} [and] {123 TO 456]');
is($res, 'test [test TO TEST} \[and\] {123 TO 456]', 'keep exclusive range untouched');
$res = $qb->clean_search_term('test [test TO TEST} ["[and] {123 TO 456]" "[balanced]"]');
is($res, 'test [test TO TEST} \["[and] {123 TO 456]" "[balanced]"\]', 'keep exclusive range untouched');
$res = $qb->clean_search_term('test[]test TO TEST] [ {123 to 345}}');
is($res, 'test\[\]test TO TEST\] \[ \{123 to 345\}\}', 'screen all square and curly brackets');
t::lib::Mocks::mock_preference('QueryRegexEscapeOptions', 'escape');
$res = $qb->clean_search_term('test inside regexps /this [a-z]/ and \/not [a-z]\/ and that [a-z] [a TO z]');
is($res, 'test inside regexps \/this \[a-z\]\/ and \/not \[a-z\]\/ and that \[a-z\] [a TO z]', 'behaviour with QueryRegexEscapeOptions set to "escape"');
t::lib::Mocks::mock_preference('QueryRegexEscapeOptions', 'dont_escape');
$res = $qb->clean_search_term('test inside regexps /this [a-z]/ /this2 [a-z]/ [but] /this3 [a-z]/ and \/not [a-z]\/ and that [a-z] [a TO z]');
is($res, 'test inside regexps /this [a-z]/ /this2 [a-z]/ \[but\] /this3 [a-z]/ and \/not \[a-z\]\/ and that \[a-z\] [a TO z]', 'behaviour with QueryRegexEscapeOptions set to "dont_escape"');
$res = $qb->clean_search_term('ti:test AND kw:test');
is($res, 'title:test AND test', 'ti converted to title, kw converted to empty string, dangling colon removed with space preserved');
$res = $qb->clean_search_term('kw:test');
is($res, 'test', 'kw converted to empty string, dangling colon is removed');
};
subtest '_join_queries' => sub {
plan tests => 6;
my $params = {
index => $Koha::SearchEngine::Elasticsearch::BIBLIOS_INDEX,
};
my $qb = Koha::SearchEngine::Elasticsearch::QueryBuilder->new($params);
my $query;
$query = $qb->_join_queries('foo');
is($query, 'foo', 'should work with a single param');
$query = $qb->_join_queries(undef, '', 'foo', '', undef);
is($query, 'foo', 'should ignore undef or empty queries');
$query = $qb->_join_queries('foo', 'bar');
is($query, '(foo) AND (bar)', 'should join queries with an AND');
$query = $qb->_join_queries('homebranch:foo', 'onloan:false');
is($query, '(homebranch:foo) AND (onloan:false)', 'should also work when field is specified');
$query = $qb->_join_queries('homebranch:foo', 'mc-itype:BOOK', 'mc-itype:EBOOK');
is($query, '(homebranch:foo) AND itype:(BOOK OR EBOOK)', 'should join with OR when using an "mc-" field');
$query = $qb->_join_queries('homebranch:foo', 'mc-itype:BOOK', 'mc-itype:EBOOK', 'mc-location:SHELF');
is($query, '(homebranch:foo) AND itype:(BOOK OR EBOOK) AND location:(SHELF)', 'should join "mc-" parts with AND if not the same field');
};
1;