The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

WWW::Webrobot::pod::Config - How to configure Webrobot

SYNOPSIS

 names=server=google.de
 names=port=4321
 names=application=http://${server}:${port}/app

 # alternate forms
 auth_basic=,site-authentification,mylogin,secretpassword
 auth_basic=|site-authentification|mylogin|secretpassword
 auth_basic=/site-authentification/mylogin/secretpassword

 #output=WWW::Webrobot::Print::MakeTestplan
 #output=WWW::Webrobot::Print::Text
 output=WWW::Webrobot::Print::Test
 output.1=WWW::Webrobot::Print::Html
 #output=WWW::Webrobot::Print::File 'dir' => 'diff_new', 'diff_mode' => 'diff_orig'
 #output=WWW::Webrobot::Print::File 'dir' => 'diff_orig'

 timeout=500
 client_302_bug=1
 #delay=1
 referrer_bug=1

 http_header=Accept-Language=de
 http_header=new-header-element=something else

 proxy=http=http://httpproxy.server.org:8888
 proxy=https=http://httpproxy.server.org:8888

 no_proxy=localhost
 no_proxy=127.0.0.1
 no_proxy=subnet.server.org

 load.number_of_clients=2
 load.base=1.77827941003892
 load.scale=40
 load.output_file=WEBROBOT_OUT

 mail.condition=never
 mail.server=mailserver.server.org
 mail.timeout=60
 mail.Return-Path=me@mail.org
 mail.From=webrobot
 mail.To=me@mail.org
 mail.Reply-To=me@mail.org
 mail.Cc=some@other.com, some@more.com
 mail.Bcc=some@other.com, some@more.com
 mail.Subject=Webrobot: Perl test mail Ümläüte
 mail.Type=text/plain
 mail.Encoding=quoted-printable
 mail.Data=blabla\n\
 This is the body of the test mail\n\
 umlauts are äöü\n
 mail.Attach=|text/plain|filename.txt

DESCRIPTION

You must spend Webrobot a config file. The config file may define proxies, HTTP header, names for a testplan and much more. It's just like configuring your WWW browser.

CONFIGURATION FILE FORMAT

All properties obey the syntax

        property_name=property_value
        property_name: property_value

There may be blanks or tabs around the delimiters = and :. Lines ending in '\' are joined with the next line. Lines containing white space are ignored. Lines starting in '#' are comments.

The property_value itself is typed. The types are:

value

a plain string (see timout)

key-value

a key=value pair (see names)

multivalue

a list: The first character is the delimiter (see auth_basic).

All property_names that are marked @ accept listmode (see auth_basic, proxy). This means you can define multiple property_names. Non-listmode property_names should be defined only once.

CONFIGURATION ATTRIBUTES

names (@key-value)

The key defines a name, the value its value. The key can be used within a testplan as ${key} and will be substituted as value.

Names can be used immediately in the names section.

        names = host=google.de
        application: http://${host}:9999/app
auth_basic (@multivalue)

Define authorization data. Webrobot can authorize at a webserver.

Select an authorized page in any browser. Then a popup window will appear, saying something like site-authentification and showing a form with login and password fields. Thats the date to put into the configuration file.

        auth_basic=|site-authentification|mylogin|secretpassword
output (@value)

Define output listeners. Each listener will be called for any http request. The most popular listeners are WWW::Webrobot::Print::Test for Test::Harness output and WWW::Webrobot::Print::Html for HTML output.

        output=WWW::Webrobot::Print::Test
        output=WWW::Webrobot::Print::Html

See WWW::Webrobot::pod::OutputListeners

timeout (value)

A request will be tried timeout seconds. Any request will fail, if timed out. Default as in LWP::UserAgent.

        timeout=500
client_302_bug (value)

This option emulates a very common bug of popular www browsers concerning http response 302. This bug is so common that even many servers rely on it. If you do not set this value you are HTTP compliant, if you set it you are compliant to popular browsers.

        client_302_bug=1

see "client_302_bug" in WWW::Webrobot::MyUserAgent

delay (value)

Webrobot will sleep between request for delay seconds. If this option is missing Webrobot won't sleep at all.

        delay=1
referrer_bug (value)

When sending http referrers the url to be sent must be normalized according to the HTTP spec, see the HTTP::Headers::referer. However - many clients (e.g. Firefox) don't do that right but send the unnormalized url. Set this option if you want Webrobot to behave in the same way.

        referrer_bug=1
http_header (@value)

Set additional HTTP headers. You may write '_' instead of '-' as in user_agent instead of user-agent.

        http_header=Accept-Language=de
        user_agent=Webrobot 9.7 Platin limited
proxy (@value)

Define your proxy servers.

        proxy=http=http://httpproxy.server.org:8888
no_proxy (@value)

Define servers or domains that mustn't be requested via proxies.

        no_proxy=localhost
        no_proxy=localnet.com
load.number (value)

The load.* properties are evaluated in webrobot-load only. load.number is the number of emulated clients. Each client is one process and processes the same test plan.

        load.number_of_clients=2
load.base (value)

Logarithmic base for x-axis for histogram. Load tests show an ASCII art histogram. All response times are categorized into an intervall. The intervalls are logarithmic and increase by a factor load.base. Popular values of load.base are 2, sqrt(2), sqrt(sqrt(10)) (Float numbers only, no expressions).

        load.base=1.77827941003892
load.scale (value)

Y-axis scale of the histogram, should be smaller than your xterm width

        load.scale=40
load.output (value)

If you specify load.output than any output will additionally written to the named file

        load.output_file=WEBROBOT_OUT
mail.condition (value)

The condition that triggers writing mail. Values are

 fail (default)
 success
 ever
 never (default if no mail.* attribute is given)

        mail.condition=never
mail.server (value)

The name of the mail server

        mail.server=my.mail.server.org
mail.timeout (value)

Timeout in seconds when sending mail

        mail.timeout=60

No attempt is made to resend the mail if sending mail fails.

mail.Attach (@multivalue)

Attach files to the mail, multiple attachments are ok.

        mail.Attach=|text/plain|filename.txt
        mail.Attach=|text/html|anotherfilename.html
mail.*

Additional parameters for sending mail. All parameters are of type (value) See "SYNOPSIS" or MIME::Lite if you feel it is not self explanatory.

 # fields for MIME::Lite, ignores case on left hand side
 mail.Return-Path
 mail.From
 mail.To
 mail.Reply-To
 mail.Cc
 mail.Bcc
 mail.Subject
 mail.Type
 mail.Encoding
 mail.Data
max_errors (value)

The maximum number of errors (originated from assertions) where Webrobot should exit. No effekt if "0", "" or missing.

SEE ALSO

WWW::Webrobot::pod::Testplan

WWW::Webrobot::pod::OutputListeners

WWW::Webrobot

AUTHOR

Stefan Trcek

COPYRIGHT

Copyright(c) 2004 ABAS Software AG

This software is licensed under the perl license, see LICENSE file.

1 POD Error

The following errors were encountered while parsing the POD:

Around line 52:

Non-ASCII character seen before =encoding in 'Ümläüte'. Assuming CP1252