package t::lib::Selenium; # 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 . use Modern::Perl; use Carp qw( croak ); use C4::Context; use base qw(Class::Accessor); __PACKAGE__->mk_accessors(qw(login password base_url opac_base_url selenium_addr selenium_port driver)); sub new { my ( $class, $params ) = @_; my $self = {}; my $config = $class->config; $self->{login} = $params->{login} || $config->{login}; $self->{password} = $params->{password} || $config->{password}; $self->{base_url} = $params->{base_url} || $config->{base_url}; $self->{opac_base_url} = $params->{opac_base_url} || $config->{opac_base_url}; $self->{selenium_addr} = $params->{selenium_addr} || $config->{selenium_addr}; $self->{selenium_port} = $params->{selenium_port} || $config->{selenium_port}; $self->{driver} = Selenium::Remote::Driver->new( port => $self->{selenium_port}, remote_server_addr => $self->{selenium_addr}, error_handler => sub { my $selenium_error = $_[1]; print STDERR "\nSTRACE:"; my $i = 1; while ( (my @call_details = (caller($i++))) ){ print STDERR "\t" . $call_details[1]. ":" . $call_details[2] . " in " . $call_details[3]."\n"; } print STDERR "\n"; croak $selenium_error; } ); return bless $self, $class; } sub config { return { login => $ENV{KOHA_USER} || 'koha', password => $ENV{KOHA_PASS} || 'koha', base_url => ( $ENV{KOHA_INTRANET_URL} || C4::Context->preference("staffClientBaseURL") ) . "/cgi-bin/koha/", opac_base_url => ( $ENV{KOHA_OPAC_URL} || C4::Context->preference("OPACBaseURL") ) . "/cgi-bin/koha/", selenium_addr => $ENV{SELENIUM_ADDR} || 'localhost', selenium_port => $ENV{SELENIUM_PORT} || 4444, }; } sub auth { my ( $self, $login, $password ) = @_; $login ||= $self->login; $password ||= $self->password; my $mainpage = $self->base_url . 'mainpage.pl'; $self->driver->get($mainpage); $self->fill_form( { userid => $login, password => $password } ); my $login_button = $self->driver->find_element('//input[@id="submit"]'); $login_button->submit(); } sub fill_form { my ( $self, $values ) = @_; while ( my ( $id, $value ) = each %$values ) { my $element = $self->driver->find_element('//*[@id="'.$id.'"]'); my $tag = $element->get_tag_name(); if ( $tag eq 'input' ) { $self->driver->find_element('//input[@id="'.$id.'"]')->send_keys($value); } elsif ( $tag eq 'select' ) { $self->driver->find_element('//select[@id="'.$id.'"]/option[@value="'.$value.'"]')->click; } } } =head1 NAME t::lib::Selenium - Selenium helper module =head1 SYNOPSIS my $s = t::lib::Selenium->new; my $driver = $s->driver; my $base_url = $s->base_url; $s->auth; $driver->get($s->base_url . 'mainpage.pl'); $s->fill_form({ input_id => 'value' }); =head1 DESCRIPTION The goal of this module is to group the different actions we need when we use automation test using Selenium =head1 METHODS =head2 new my $s = t::lib::Selenium->new; Constructor - Returns the object Selenium You can pass login, password, base_url, selenium_addr, selenium_port If not passed, the environment variables will be used KOHA_USER, KOHA_PASS, KOHA_INTRANET_URL, SELENIUM_ADDR SELENIUM_PORT Or koha, koha, syspref staffClientBaseURL, localhost, 4444 =head2 auth $s->auth; Will login into Koha. =head2 fill_form $driver->get($url) $s->fill_form({ input_id => 'value', element_id => 'other_value', }); Will fill the different elements of a form. The keys must be element ids (input and select are supported so far) The values must a string. =head1 AUTHOR Jonathan Druart Koha Development Team =head1 COPYRIGHT Copyright 2017 - Koha Development Team =head1 LICENSE 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 . =cut 1;