Line 0
Link Here
|
0 |
- |
1 |
package t::lib::Selenium; |
|
|
2 |
|
3 |
# This file is part of Koha. |
4 |
# |
5 |
# Koha is free software; you can redistribute it and/or modify it |
6 |
# under the terms of the GNU General Public License as published by |
7 |
# the Free Software Foundation; either version 3 of the License, or |
8 |
# (at your option) any later version. |
9 |
# |
10 |
# Koha is distributed in the hope that it will be useful, but |
11 |
# WITHOUT ANY WARRANTY; without even the implied warranty of |
12 |
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
13 |
# GNU General Public License for more details. |
14 |
# |
15 |
# You should have received a copy of the GNU General Public License |
16 |
# along with Koha; if not, see <http://www.gnu.org/licenses>. |
17 |
|
18 |
|
19 |
use Modern::Perl; |
20 |
use C4::Context; |
21 |
|
22 |
use base qw(Class::Accessor); |
23 |
__PACKAGE__->mk_accessors(qw(login password base_url selenium_addr selenium_port driver)); |
24 |
|
25 |
sub new { |
26 |
my ( $class, $params ) = @_; |
27 |
my $self = {}; |
28 |
my $config = $class->config; |
29 |
$self->{login} = $params->{login} || $config->{login}; |
30 |
$self->{password} = $params->{password} || $config->{password}; |
31 |
$self->{base_url} = $params->{base_url} || $config->{base_url}; |
32 |
$self->{selenium_addr} = $params->{selenium_addr} || $config->{selenium_addr}; |
33 |
$self->{selenium_port} = $params->{selenium_port} || $config->{selenium_port}; |
34 |
$self->{driver} = Selenium::Remote::Driver->new( |
35 |
port => $self->{selenium_port}, |
36 |
remote_server_addr => $self->{selenium_addr}, |
37 |
); |
38 |
return bless $self, $class; |
39 |
} |
40 |
|
41 |
sub config { |
42 |
return { |
43 |
login => $ENV{KOHA_USER} || 'koha', |
44 |
password => $ENV{KOHA_PASS} || 'koha', |
45 |
base_url => ( $ENV{KOHA_INTRANET_URL} || C4::Context->preference("staffClientBaseURL") ) . "/cgi-bin/koha/", |
46 |
selenium_addr => $ENV{SELENIUM_ADDR} || 'localhost', |
47 |
selenium_port => $ENV{SELENIUM_PORT} || 4444, |
48 |
}; |
49 |
} |
50 |
|
51 |
sub auth { |
52 |
my ( $self, $login, $password ) = @_; |
53 |
|
54 |
$login ||= $self->login; |
55 |
$password ||= $self->password; |
56 |
my $mainpage = $self->base_url . 'mainpage.pl'; |
57 |
|
58 |
$self->driver->get($mainpage); |
59 |
$self->fill_form( { userid => $login, password => $password } ); |
60 |
my $login_button = $self->driver->find_element('//input[@id="submit"]'); |
61 |
$login_button->submit(); |
62 |
} |
63 |
|
64 |
sub fill_form { |
65 |
my ( $self, $values ) = @_; |
66 |
while ( my ( $id, $value ) = each %$values ) { |
67 |
my $element = $self->driver->find_element('//*[@id="'.$id.'"]'); |
68 |
my $tag = $element->get_tag_name(); |
69 |
if ( $tag eq 'input' ) { |
70 |
$self->driver->find_element('//input[@id="'.$id.'"]')->send_keys($value); |
71 |
} elsif ( $tag eq 'select' ) { |
72 |
$self->driver->find_element('//select[@id="'.$id.'"]/option[@value="'.$value.'"]')->click; |
73 |
} |
74 |
} |
75 |
} |
76 |
|
77 |
=head1 NAME |
78 |
|
79 |
t::lib::Selenium - Selenium helper module |
80 |
|
81 |
=head1 SYNOPSIS |
82 |
|
83 |
my $s = t::lib::Selenium->new; |
84 |
my $driver = $s->driver; |
85 |
my $base_url = $s->base_url; |
86 |
$s->auth; |
87 |
$driver->get($s->base_url . 'mainpage.pl'); |
88 |
$s->fill_form({ input_id => 'value' }); |
89 |
|
90 |
=head1 DESCRIPTION |
91 |
|
92 |
The goal of this module is to group the different actions we need |
93 |
when we use automation test using Selenium |
94 |
=head1 METHODS |
95 |
|
96 |
=head2 new |
97 |
|
98 |
my $s = t::lib::Selenium->new; |
99 |
|
100 |
Constructor - Returns the object Selenium |
101 |
You can pass login, password, base_url, selenium_addr, selenium_port |
102 |
If not passed, the environment variables will be used |
103 |
KOHA_USER, KOHA_PASS, KOHA_INTRANET_URL, SELENIUM_ADDR SELENIUM_PORT |
104 |
Or koha, koha, syspref staffClientBaseURL, localhost, 4444 |
105 |
|
106 |
=head2 auth |
107 |
|
108 |
$s->auth; |
109 |
|
110 |
Will login into Koha. |
111 |
|
112 |
=head2 fill_form |
113 |
|
114 |
$driver->get($url) |
115 |
$s->fill_form({ |
116 |
input_id => 'value', |
117 |
element_id => 'other_value', |
118 |
}); |
119 |
|
120 |
Will fill the different elements of a form. |
121 |
The keys must be element ids (input and select are supported so far) |
122 |
The values must a string. |
123 |
|
124 |
=head1 AUTHOR |
125 |
|
126 |
Jonathan Druart <jonathan.druart@bugs.koha-community.org> |
127 |
|
128 |
Koha Development Team |
129 |
|
130 |
=head1 COPYRIGHT |
131 |
|
132 |
Copyright 2017 - Koha Development Team |
133 |
|
134 |
=head1 LICENSE |
135 |
|
136 |
This file is part of Koha. |
137 |
|
138 |
Koha is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by |
139 |
the Free Software Foundation; either version 3 of the License, or (at your option) any later version. |
140 |
|
141 |
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. |
142 |
|
143 |
You should have received a copy of the GNU General Public License along with Koha; if not, see <http://www.gnu.org/licenses>. |
144 |
|
145 |
=cut |
146 |
|
147 |
1; |